llgrid - Creates an overlay metafile with a latitude/longitude grid

SYNOPSIS

llgrid  [ parameter=value ... ]  [ outputfile ]

Parameters are: master_file, grid_type, delta_lat, delta_lon, label, label_clearance.

DESCRIPTION

llgrid generates a TeraScan metafile dataset containing a latitude/longitude grid for a geographical region specified by a master dataset. This metafile can be overlayed with the TeraScan display function xvu (see xvu).

The grid consists of either intersecting grid lines or symbols marking the intersection points. Latitude and longitude spacing can be different and the spacing can be fractional (e.g., 2.5 degrees), but the spacing must divide evenly into 90 degrees.

There are no input TeraScan datasets. There is exactly one output TeraScan dataset.

PARAMETERS

master_file

This is the filename of the master dataset. The earth location transform of the master dataset is used to convert latitude and longitude coordinates to line and sample coordinates during the metafile-generation process. See master for more information on the generation and use of master datasets.

Valid responses are any TeraScan dataset containing an earth transform. The default is Master.

grid_type

Either intersecting lines or symbols marking the intersections of the latitude and longitude grid lines can be used to represent the grid.

Valid responses are [lines, markers]. The default is lines.

delta_lat

This is the spacing in degrees between the horizontal grid lines. This number must divide evenly into 90. For example: 0.5, 1, 2.5, 10, etc.

Valid responses are [1, 90]. The default is 1.

delta_lon

This is the spacing in degrees between the vertical grid lines. This number must divide evenly into 90. For example 0.5, 1, 2.5, 10, etc.

Valid responses are [1, 90]. The default is 1.

label

OPTIONAL. Whether or not and how to label latitude and longitude values when grid_types=lines. This parameter must be specified on the command line.

Valid responses are [yes, no, left, right, top, bottom]. yes=left+right+top+bottom. The default is no.

label_clearance

OPTIONAL. Specifies factor by which to adjust default latitude/longitude label clearances. Values greater than 1.0 increase clearances, values less than 1.0 decrease clearances. This parameter must be specified on the command line.

Valid responses are [0.0, 10.0]. The default is 1.0.

EXAMPLES

Display a latitude/longitude grid for the Hawaiian islands. The islands have been superposed on the grid to provide a point of reference.

[1] % const2d
output file    : char(75) ? back
master_file    : char(16) ? [ ] Master
var_type       : char( 6) ? byte
var_value      : real     ? [0]

[2] % llgrid
output file    : char(75) ? [Grid]
master_file    : char(75) ? [Master]
grid_type      : char( 7) ? [lines]
line_type      : char( 7) ? [solid]
delta_lat      : real     ? [1]
delta_lon      : real     ? [1]

SEE ALSO

coast


Last Update: $Date: 1998/05/29 18:35:04 $