Help for PLAB2TCL
PURPOSE:
plab2tcl gets a value (int, double, or string) and puts it into
a TAE TCL variable. The value is a GeoTIFF parameter in the
VICAR label. These are always found in the VICAR state label
under the property "GEOTIFF".
If the selection is not found, or wrong type, etc., a special value
of -999 (int) -999.0 (real) or "-999" (character string) is output
to the TAE TCL variable.
Multiple occurrences of the GeoTIFF keyword are selected by the
parameter element (since VICAR calls these elements) and which
item in a vector is handled by the parameter sequence.
EXECUTION:
Examples
plab2tcl AUSTRALIA val=s1 keyword=GTRASTERTYPEGEOKEY vtype=0
gets the rastertype from the file AUSTRALIA and puts
into the TCL variable s1 as a string
plab2tcl AUSTRALIA val=n1 keyword=GTRASTERTYPEGEOKEY vtype=4
gets the rastertype from the file AUSTRALIA and puts
into the TCL variable n1 as an integer (converts
the string to an integer)
OPERATION:
plab2tcl reads the part of the VICAR label that contains the
GeoTIFF information and tries to find the keyword (case
insensitive). When found, the value is placed in the output
parameter. Type conversion is performed according to the user
request in the parameter vtype.
Any errors cause -999 (int), -999.0 (real), or "-999" (string)
to be placed in the output parameter.
TIMING:
Less than one second.
ORIGINAL PROGRAMMER: A. Zobrist 02 Feb 2004
COGNIZANT PROGRAMMER: A. Zobrist 02 Feb 2004
REVISION HISTORY
2008-01-02 WLB Switched to USES_ANSI_C AND LIB_CARTO; misc cleanup.
2015-12-14 WLB Migrated to MIPL.
PARAMETERS:
INP
VICAR input file name
PROPERTY
The property name;
is case insensitive
KEYWORD
The property keyword; is
case insensitive
VAL
TAE TCL name without &, gets
the found value or -999
VTYPE
0 - string
2 - integer
4 - integer
7 - double
8 - double
ELEMENT
for selecting when there are
multiple of same GeoTIFF kwd
SEQUENCE
for selecting when there is
a vector of values
See Examples:
Cognizant Programmer: