dumpmeta - ascii dump of metafile variables in TeraScan datasets

dumpmeta - Performs an ascii dump of metafile variables in TeraScan datasets

SYNOPSIS

dumpmeta  [ parameter=value ... ]  [ inputfile ... ]

Parameters are: include_vars, use_coords, printout.

DESCRIPTION

dumpmeta prints the contents of metafile variables. Each metafile primitive is printed on a separate line, along with any data associated with that primitive. dumpmeta can be used as a debugging tool when writing metafile generating programs. It also can be used to export metafile data to other packages, e.g., coastline points.

PARAMETERS

include_vars: List of variables to include in the report. If the list is prefixed with a minus sign, the listed variables are excluded from the report. Wildcards * and ? are allowed. The default is to report all variables. Note that there is usually only one metafile variable in a given dataset.

use_coords: Choice of report coordinates, either stored, image, or latlon. stored coordinates are really earth transform coordinates, either sensor or projection. Projection coordinates are measured in kilometers from the center of the projection. The default is stored.

printout: Indicates whether or not to direct the report to the printer. Choices are yes and no. The default is no.

EXAMPLES

The following example dumps a metafile created by llgrid using latitude-longitude coordinates. These points could be piped into egrep 'polyline|draw next' to strip out the report header and any non-coordinate primitives.

% llgrid
output file    : char(255) ? [Grid]
master_file    : char(255) ? [Master]
grid_type      : char(  7) ? [lines]
delta_lat      : real      ? [1]
delta_lon      : real      ? [1]
%
% dumpmeta Grid
include_vars   : char(255) ? []
use_coords     : char(  6) ? [stored] latlon
printout       : char(  3) ? [no]
Grid latlon_grid  Metafile Dump  Page 1
polyline 	-123.000	31.445
draw next	-123.000	32.000
draw next	-123.000	33.000
draw next	-123.000	34.000
draw next	-123.000	35.000
draw next	-123.000	36.000
draw next	-123.000	36.555
polyline 	-122.000	31.445
draw next	-122.000	32.000
draw next	-122.000	33.000
:

The next example dumps a test metafile generated by legend using image coordinates. The input dataset to legend is a 377-by-628 image.

% legend ~/new7 Legend
line_1         : char(255) ? Test line 1
line_2         : char(255) ? [] Second line
line_3         : char(255) ? [] Last but not least
line_4         : char(255) ? []
text_height    : int       ? [18]
text_type      : char(  6) ? [plain]
line_offset    : int       ? [0]
sample_offset  : int       ? [0]
full_width     : char(  3) ? [no] y
center_text    : char(  3) ? [no] y
outline        : char(  3) ? [no]
solid_bg       : char(  3) ? [yes] y
%
% dumpmeta Legend
include_vars   : char(255) ? []
use_coords     : char(  6) ? [stored] image
printout       : char(  3) ? [no]
Legend legend  Metafile Dump  Page 1
fill color	1
polygon  	1.000	1.000
draw next	1.000	62.000
draw next	628.000	62.000
draw next	628.000	1.000
draw next	1.000	1.000
text height	18
text type	0
text vertical	4
text horiz	2
text start	314.500	19.000
text data	11	'Test line 1'
text start	314.500	37.000
text data	11	'Second line'
text start	314.500	55.000
text data	18	'Last but not least'
etmeta end

NOTES

The codes for vertical and horizontal text alignment, text types, line types, and marker types are printed numerically. This should be corrected.