Help for GTGENUP

PURPOSE
     GTGENUP is a VICAR applications program which updates a GeoTIFF
     label.  The new values can be specified in one of three methods:
     (1) In another VICAR image (GeoTIFF label is copied/replaced).
     (2) In parameter GEOTIFF using the same format as is used in
     the VICAR application GTGEN.
     (3) In an ASCII file named by parameter PARMFILE.

     Specify the PROPERTY parameter to use a property label other then
     the default GEOTIFF.
     
CALL
     gtgenup (INP1,INP2)
  WHERE:
     INP1           is the input VICARGT image file to be updated.
     INP2           is the input VICARGT image file used as a source
                    of update values.
OR
     gtgenup INP GEOTIFF
  WHERE:
     INP            is the input VICARGT image file to be updated.
     GEOTIFF        are tag-value pairs that replace geotiff parms in
                    the label; each is formatted tag=value.
OR
     gtgenup INP GTFILE
  WHERE:
     INP            is the input VICARGT image file to be updated.
                    GEOTIFF parameter is formatted.
     
For more information on the GEOTIFF parameter format, see GTGEN.

RESTRICTIONS
------------

Only 100 parameter pairs can be input in GEOTIFF.  For more, use repeated
calls to GTGENUP, or use the GTFILE parameter.

REFERENCES

     Ritter, N., Ruth, M. "GeoTIFF Format Specification, Revision 1.0",
     JPL Cartographic Applications Group.
     
WRITTEN BY:            W. L. Bunch

COGNIZANT PROGRAMMER:  W. L. Bunch

REVISIONS: 
  2005-03-07 WLB Initial version
  2005-03-07 WLB Added support for VICAR file as source of replacement label values
  2005-04-11 WLB Added check for INP2 values being FORMAT STRING
  2005-07-13 WLB Added support for arbitrary property label (not just GEOTIFF).
  2008-01-02 WLB Switched to USES_ANSI_C AND LIB_CARTO; misc cleanup  
  2015-10-15 WLB Migrated to mipl


PARAMETERS:


INP

Input file to be modified.

GEOTIFF

Key-value pairs expressed as one string per pair. See GTGEN for details. See tstgtgenup.pdf for example call.

GTFILE

Name of file containing key-value pairs used instead of GEOTIFF parameter. See gtgenup.tstdat for example file. .END

See Examples:


Cognizant Programmer: