User's Guide

EDITTIE

Edit a tie point selection file, tie point location file, or a Merged Tie Point file.

Function:

Edits or creates tie point files. EDITTIE provides two different methods for editing--an interactive screen mode using the -SCREEN subcommand and a parameter mode using the -RMDUPS, -TPS, -TPL, or the -MTP subcommand.

Parameters:

Subcommand -SCREEN:

Screen mode. In this mode the values of a tie point selection file, tie point location file, or merged tie point file are displayed on the screen and the user may interactively edit the fields. NOTE: This subcommand cannot be used for BATCH processing.

OUTTIE

Output tie point file. The updated tie point file. It will be the same type of file as INTIE.

INTIE(--)

Input tie point file. The tie point file to be edited. INTIE may be a tie point selection file, tie point location file, or a merged tie point file. If more than one file is entered, the tie point files will be combined to create one output tie point file.

FTYPE(TPS)

File type. The type of tie point file to be edited.

  = TPS:  Tie point selection
  = TPL:  Tie point location
  = MTP:  Merged tie point

Subcommand -TPS:

Tie point selection parameter mode. In this mode the user can enter values for any of the fields in a tie point selection file using TAE parameters.

OUTTS

Output tie point selection file. The updated tie point selection file.

INTS(--)

Input tie point selection file. The tie point selection file to be edited. If more than one file is entered, the tie point files will be combined to create one output tie point file.

PPVAL(-- )

Projection validity. The validity of the projection fields.

  = IN:   Invalid.  The values are known to be invalid.
  = VAL:  Valid.  The values are known to be valid.

UPLEFT(--)

Upper-left corner coordinates. The location of the upper-left corner. The coordinates are entered in latitude/longitude or northing/easting order.

LOLEFT(--)

Lower-left corner coordinates. The location of the lower-left corner. The coordinates are entered in latitude/longitude or northing/easting order.

UPRIGHT(--)

Upper-right corner coordinates. The location of the upper-right corner. The coordinates are entered in latitude/longitude or northing/easting order.

LORIGHT(--)

Lower-right corner coordinates. The location of the lower-right corner. The coordinates are entered in latitude/longitude or northing/easting order.

PDLINE(--)

Projection distance in the line direction. The distance on the ground (in the line direction) that one sample represents in projection units.

PDSAMP(--)

Projection distance in the sample direction. The distance on the ground (in the sample direction) that one sample represents in projection units.

PROJPARM(--)

Projection parameters. These parameters are required to define each map projection. Refer to the LAS Projection Transformation Package for further details.

PROJTYPE(--)

Projection type. The types used by the LAS Projection Transformation Package to indicate map projection systems. Refer to the Geometric Manipulation Package Overview Document for further details. Valid projection system types are:

  = GEO(0):	 Geographic
  = UTM(1):	 Universal Transverse Mercator
  = SPCS(2):	 State Plane Coordinate System 
  = ALBERS(3):	 Albers Conical Equal Area
  = LAMCC(4):	 Lambert Conformal Conic
  = MERCAT(5):	 Mercator
  = PS(6):	 Polar Stereographic
  = POLYC(7):	 Polyconic
  = EQUIDC(8):	 Equidistant Conic
  = TM(9):	 Transverse Mercator
  = STEREO(10):  Stereographic
  = LAMAZ(11):	 Lambert Azimuthal Equal-Area
  = AZMEQD(12):	 Azimuthal Equidistant 
  = GNOMON(13):	 Gnomonic
  = ORTHO(14):	 Orthographic
  = GVNSP(15):	 General Vertical Near-Side Perspective
  = SNSOID(16):	 Sinusoidal
  = EQRECT(17):	 Equirectangular
  = MILLER(18):	 Miller Cylindrical
  = VGRINT(19):	 Van der Grinten
  = HOM(20):	 Hotine Oblique Mercator
  = ROBIN(21):	 Robinson
  = SOM(22):	 Space Oblique Mercator
  = ALASKA(23):	 Alaska Conformal
  = GOOD(24):	 Interrupted Goode Homolosine
  = MOLL(25):	 Mollweide
  = IMOLL(26):	 Interrupted Mollweide
  = HAMMER(27):	 Hammer
  = WAGIV(28):	 Wagner IV
  = WAGVII(29):	 Wagner VII
  = OBEQA(30):	 Oblated Equal Area
  = USERDEF:	 User defined

ZONENUM(--)

Zone number. The zone to use for UTM and State Plane projection systems. Refer to the Geometric Manipulation Package Overview Document (GEOMPOD) for further details.

DCODE(--)

Datum code. The datum can be used for setting the semi-major axis and eccentricity squared for a particular projection. Refer to the LAS Projection Transformation Package for further details. The supported datum codes are:

   0 = Clarke 1866
   1 = Clarke 1880
   2 = Bessel
   3 = International 1967
   4 = International 1909
   5 = WGS 72
   6 = Everest
   7 = WGS 66
   8 = GRS 1980
   9 = Airy
  10 = Modified Everest
  11 = Modified Airy
  12 = Walbeck
  13 = Southeast Asia
  14 = Australian National
  15 = Krassovsky
  16 = Hough
  17 = Mercury 1960
  18 = Modified Mercury 1968
  19 = Sphere of Radius 6370997 meters

COORTYPE(--)

Coordinate type. The type of coordinates in the tie point file.

  = GEO:  Geographic Coordinates
  = REF:  Reference Image Coordinates
  = SEA:  Search Image Coordinates
  = PRO:  Projection Coordinates
  = USR:  User-Defined Coordinates

PUNITS(--)

Projection measurement units. The measurement system used for the projection dimensions. The current standard projection units include the following (all others are user-defined):

  radians
  degrees
  seconds
  dms
  feet
  meters

NAME(--)

Image name. The LAS name of the image from which points were obtained.

PTID(--)

Tie point id. The tie point identification field describing each point. It must be unique among points in this file.

COORS(--)

Coordinates. Coordinates of the tie point. These are geographic coordinates, projection coordinates, or user-defined coordinates. This field is valid when COORTYPE is set to "GEO," "PRO," or "USR."

LSCOORS(--)

Line/sample coordinates. Location of the tie point in the image coordinates. This field is used when COORTYPE is set to "REF" or "SEA," but it may also contain data with other types of registrations.

ELEV(--)

Elevation. Elevation of the tie point.

SCALFACT(--)

Scale factor. The enlargement factor used when selecting the tie point. This gives an indication as to the possible subpixel accuracy of the tie point.

REFSIZE(--)

Reference size. Desired subimage width and height as used by the CORRELATE application.

SRCHOFF(--)

Search offsets. Desired horizontal and vertical search offsets as used by the CORRELATE application.

CHIPNAME(--)

Subimage chip name. The LAS image name of the file containing the subimage chip. If COORTYPE = "GEO," this is the map identifier describing the map used to obtain the geographic coordinates.

Subcommand -TPL:

Tie point location parameter mode. In this mode the user can enter values for any of the fields in a tie point location file using TAE parameters.

OUTTL

Output tie point location file. The updated tie point location file.

INTL(--)

Input tie point location file. The tie point location file to be edited. If more than one file is entered, the tie point files will be combined to create one output tie point file.

PPVAL(--)

Projection validity. The validity of the projection fields.

  = IN:   Invalid.  The values are known to be invalid.
  = VAL:  Valid.  The values are known to be valid.

UPLEFT(--)

Upper-left corner coordinates. The location of the upper-left corner. The coordinates are entered in latitude/longitude or northing/easting order.

LOLEFT(--)

Lower-left corner coordinates. The location of the lower-left corner. The coordinates are entered in latitude/longitude or northing/easting order.

UPRIGHT(--)

Upper-right corner coordinates. The location of the upper-right corner. The coordinates are entered in latitude/longitude or northing/easting order.

LORIGHT(--)

Lower-right corner coordinates. The location of the lower-right corner. The coordinates are entered in latitude/longitude or northing/easting order.

PDLINE(--)

Projection distance in the line direction. The distance on the ground (in the line direction) that one sample represents in projection units.

PDSAMP(--)

Projection distance in the sample direction. The distance on the ground (in the sample direction) that one sample represents in projection units.

PROJPARM(--)

Projection parameters. These parameters are required to define each map projection. Refer to the LAS Projection Transformation Package for further details.

PROJTYPE(--)

Projection type. The types used by the LAS Projection Transformation Package to indicate map projection systems. Refer to the Geometric Manipulation Package Overview Document for further details. Valid projection system types are:

  = GEO(0):	 Geographic
  = UTM(1):	 Universal Transverse Mercator
  = SPCS(2):	 State Plane Coordinate System 
  = ALBERS(3):	 Albers Conical Equal Area
  = LAMCC(4):	 Lambert Conformal Conic
  = MERCAT(5):	 Mercator
  = PS(6):	 Polar Stereographic
  = POLYC(7):	 Polyconic
  = EQUIDC(8):	 Equidistant Conic
  = TM(9):	 Transverse Mercator
  = STEREO(10):  Stereographic
  = LAMAZ(11):	 Lambert Azimuthal Equal-Area
  = AZMEQD(12):	 Azimuthal Equidistant 
  = GNOMON(13):	 Gnomonic
  = ORTHO(14):	 Orthographic
  = GVNSP(15):	 General Vertical Near-Side Perspective
  = SNSOID(16):	 Sinusoidal
  = EQRECT(17):	 Equirectangular
  = MILLER(18):	 Miller Cylindrical
  = VGRINT(19):	 Van der Grinten
  = HOM(20):	 Hotine Oblique Mercator
  = ROBIN(21):	 Robinson
  = SOM(22):	 Space Oblique Mercator
  = ALASKA(23):	 Alaska Conformal
  = GOOD(24):	 Interrupted Goode Homolosine
  = MOLL(25):	 Mollweide
  = IMOLL(26):	 Interrupted Mollweide
  = HAMMER(27):	 Hammer
  = WAGIV(28):	 Wagner IV
  = WAGVII(29):	 Wagner VII
  = OBEQA(30):	 Oblated Equal Area
  = USERDEF:	 User defined

ZONENUM(--)

Zone number. The zone to use for UTM and State Plane projection systems. Refer to the Geometric Manipulation Package Overview Document (GEOMPOD) for further details.

DCODE(--)

Datum code. The datum can be used for setting the semi-major axis and eccentricity squared for a particular projection. Refer to the LAS Projection Transformation Package for further details. The supported datum codes are:

   0 = Clarke 1866
   1 = Clarke 1880
   2 = Bessel
   3 = International 1967
   4 = International 1909
   5 = WGS 72
   6 = Everest
   7 = WGS 66
   8 = GRS 1980
   9 = Airy
  10 = Modified Everest
  11 = Modified Airy
  12 = Walbeck
  13 = Southeast Asia
  14 = Australian National
  15 = Krassovsky
  16 = Hough
  17 = Mercury 1960
  18 = Modified Mercury 1968
  19 = Sphere of Radius 6370997 meters

REFTYPE(--)

Reference coordinate type. The type of reference coordinates in the tie point location file.

  = IMAGE: Full image.  The reference scene is a full 
           image.
  = MAP:   Area is a map.  The reference area is a map.
  = TEMP:  Temporal registration.  Reference chips used 
           to establish temporal registration.
  = FULL:  Extract from full input image.  Reference 
           chips used to establish geographic 
           registration--extract from full input image. 
  = PRE:   Search subimages prescaled or rotated.  
           Reference chips used to establish geographic 
           registration--search subimages prescaled or 
           rotated. 

PUNITS(--)

Projection measurement units. The measurement system used for the projection dimensions. The current standard projection units include the following (all others are user-defined):

  radians
  degrees
  seconds
  dms
  feet
  meters

CORRMODE(--)

Correlation mode. The type of correlation that was preformed.

  = EDGE:   Edge correlation
  = GREY:   Grey correlation
  = PHASE:  Phase correlation
  = MANUAL: Manually correlated--automatic correlation 
            not performed. 

EDGEVAL(--)

Edge value. The fraction of pixels to be classified as edges.

MINCORR(--)

Minimum correlation. The minimum acceptable correlation strength.

MAXDIFF(--)

Maximum difference. The maximum acceptable difference between the nominal tie point location and that given by correlation.

FITMETH(--)

Fitting method. The correlation peak fitting method.

  = PARAB:   Elliptic paraboloid 
  = GAUSS:   Elliptic Gaussian
  = RECIP:   Elliptic paraboloid fit to reciprocal 
             of correlation values
  = INTEGER: No surface fit.  Tie point is assigned 
             the integer coordinate which gave the 
             largest correlation value.
  = NOCORR:  No correlation.  Auto correlation not 
             performed.

SRCHNAME(--)

Search image. The LAS name of the search image from which points were obtained.

REFNAME(--)

Reference image. The LAS name of the reference image from which points were obtained.

PTID(--)

Tie point id. The tie point identification field describing each point. It must be unique among points in this file.

COORS(--)

Coordinates. Geographic, projection, or user defined coordinates of the tie point.

LSCOORS(--)

Line/sample coordinates. The line/sample coordinate values relative to the full image of the upper-left corner of the input subimage.

ELEV(--)

Elevation. Elevation of the tie point.

SCALFACT(--)

Scale factor. The enlargement factor used when selecting the tie point. This gives an indication as to the possible subpixel accuracy of the tie point.

REFSIZE(--)

Reference size. Actual width and height of the reference subimage.

SRCHOFF(--)

Search offsets. Desired horizontal and vertical search offsets.

REFCOORS(--)

Reference coordinates. Image location of the tie point in the line/sample direction in the reference image or subimage. This defines the center of the reference chip extracted during the correlation process.

NOMCOORS(--)

Nominal coordinates. Nominal search image location of the tie point in the line/sample direction in the full search image.

SRCHCOOR(--)

Search coordinates. Refined search image location of the tie point in the line/sample direction in the full search image.

RMSERROR(--)

RMS error. Estimated horizontal and vertical RMS errors.

STRENGTH(--)

Correlation strength. Strength of correlation.

DISPLACE(--)

Displacement. Displacement, measured diagonally, from the nominal input image location of the tie point to the location obtained by correlation.

SRCHSIZE(--)

Search size. Actual width and height of the input search subimage.

CHIPCOOR(--)

Chip coordinates. The line/sample coordinates of the tie point relative to the reference chip image.

REQSIZE(--)

Requested subimage size. Requested width and height of the reference subimage.

CORNVALS(--)

Corner coordinates. The line/sample coordinates of the upper-left corner of the reference subimage relative to the reference image or reference chip.

ACTFLG(--)

Active flag. Tie point active flag containing accept/reject codes. Valid values are:

  = ACCEPT:   Accept.  Accept manually extracted tie 
              point.
  = REJECT:   Reject.  Tie point rejected manually by 
              user.
  = REACCEPT: Re-accept.  Previously rejected tie 
              point re-accepted manually by user. 

REFCHIP(--)

Reference chip. The image name of the file containing the subimage reference chip.

Subcommand -MTP:

Merged tie point parameter mode. In this mode the user can enter values for any of the fields in a merged tie point file using TAE parameters.

OUTMT

Output merged tie point file. The updated merged tie point file.

INMT(-- )

Input merged tie point file. The merged tie point file to be edited. If more than one file is entered, the tie point files will be combined to create one output tie point file.

PPVAL(--)

Projection validity. The validity of the projection fields.

  = IN:   Invalid.  The values are known to be invalid.
  = VAL:  Valid.  The values are known to be valid.

UPLEFT(--)

Upper-left corner coordinates. The location of the upper-left corner. The coordinates are entered in latitude/longitude or northing/easting order.

LOLEFT(--)

Lower-left corner coordinates. The location of the lower-left corner. The coordinates are entered in latitude/longitude or northing/easting order.

UPRIGHT(--)

Upper-right corner coordinates. The location of the upper-right corner. The coordinates are entered in latitude/longitude or northing/easting order.

LORIGHT(--)

Lower-right corner coordinates. The location of the lower-right corner. The coordinates are entered in latitude/longitude or northing/easting order.

PDLINE(--)

Projection distance in the line direction. The distance on the ground (in the line direction) that one sample represents in projection units.

PDSAMP(--)

Projection distance in the sample direction. The distance on the ground (in the sample direction) that one sample represents in projection units.

PROJPARM(--)

Projection parameters. These parameters are required to define each map projection. Refer to the LAS Projection Transformation Package for further details.

PROJTYPE(--)

Projection type. The types used by the LAS Projection Transformation Package to indicate map projection systems. Refer to the Geometric Manipulation Package Overview Document for further details. Valid projection system types are:

  = GEO(0):	 Geographic
  = UTM(1):	 Universal Transverse Mercator
  = SPCS(2):	 State Plane Coordinate System 
  = ALBERS(3):	 Albers Conical Equal Area
  = LAMCC(4):	 Lambert Conformal Conic
  = MERCAT(5):	 Mercator
  = PS(6):	 Polar Stereographic
  = POLYC(7):	 Polyconic
  = EQUIDC(8):	 Equidistant Conic
  = TM(9):	 Transverse Mercator
  = STEREO(10):  Stereographic
  = LAMAZ(11):	 Lambert Azimuthal Equal-Area
  = AZMEQD(12):	 Azimuthal Equidistant 
  = GNOMON(13):	 Gnomonic
  = ORTHO(14):	 Orthographic
  = GVNSP(15):	 General Vertical Near-Side Perspective
  = SNSOID(16):	 Sinusoidal
  = EQRECT(17):	 Equirectangular
  = MILLER(18):	 Miller Cylindrical
  = VGRINT(19):	 Van der Grinten
  = HOM(20):	 Hotine Oblique Mercator
  = ROBIN(21):	 Robinson
  = SOM(22):	 Space Oblique Mercator
  = ALASKA(23):	 Alaska Conformal
  = GOOD(24):	 Interrupted Goode Homolosine
  = MOLL(25):	 Mollweide
  = IMOLL(26):	 Interrupted Mollweide
  = HAMMER(27):	 Hammer
  = WAGIV(28):	 Wagner IV
  = WAGVII(29):	 Wagner VII
  = OBEQA(30):	 Oblated Equal Area
  = USERDEF:	 User defined

ZONENUM(--)

Zone number. The zone to use for UTM and State Plane projection systems. Refer to the Geometric Manipulation Package Overview Document (GEOMPOD) for further details.

DCODE(--)

Datum code. The datum can be used for setting the semi-major axis and eccentricity squared for a particular projection. Refer to the LAS Projection Transformation Package for further details. The supported datum codes are:

   0 = Clarke 1866
   1 = Clarke 1880
   2 = Bessel
   3 = International 1967
   4 = International 1909
   5 = WGS 72
   6 = Everest
   7 = WGS 66
   8 = GRS 1980
   9 = Airy
  10 = Modified Everest
  11 = Modified Airy
  12 = Walbeck
  13 = Southeast Asia
  14 = Australian National
  15 = Krassovsky
  16 = Hough
  17 = Mercury 1960
  18 = Modified Mercury 1968
  19 = Sphere of Radius 6370997 meters

PUNITS(--)

Projection measurement units. The measurement system used for the projection dimensions. The current standard projection units include the following (all others are user-defined):

  radians
  degrees
  seconds
  dms
  feet
  meters

SRCHNAME(--)

Search image. The LAS name of the search image from which points were obtained.

REFNAME(--)

Reference image. The LAS name of the reference image from which points were obtained.

CHIPTYPE(--)

Chip type. The type of subimage chip used.

  = NO:    Chips not used.  Reference chips images 
           not used. 
  = TEMP:  Temporal registration.  Reference chips 
           used to establish temporal registration.
  = FULL:  Extract from full input image.  Reference 
           chips used to establish geographic 
           registration--extract from full input image. 
  = PRE:   Search subimages prescaled or rotated. 
           Reference chips used to establish 
           geographic registration--search subimages 
           prescaled or rotated. 

PTID(--)

Tie point id. The tie point identification field describing each point. It must be unique among points in this file.

COORS(--)

Coordinates. Geographic, projection, or user-defined coordinates of the tie point.

ELEV(--)

Elevation. Elevation of the tie point.

SCALFACT(--)

Scale factor. The enlargement factor used when selecting the tie point. This gives an indication as to the possible subpixel accuracy of the tie point.

REFSIZE(--)

Reference size. Desired subimage width and height.

SRCHOFF(--)

Search offsets. Desired horizontal and vertical search offsets.

REFCOORS(--)

Reference coordinates. Image location of the tie point in the line/sample direction in the reference image or subimage. This defines the center of the reference chip extracted during the correlation process.

NOMCOORS(--)

Nominal coordinates. Nominal search image location of the tie point in the line/sample direction in the full search image.

SRCHCHIP(-- )

Search chip. The image name of the file containing the prescaled or rotated subimage search chip.

REFCHIP(--)

Reference chip. The image name of the file containing the subimage reference chip.

Subcommand -RMDUPS:

Remove coincident tie points. In this mode coincident and nearly coincident tie points are marked as inactive.

INTL

Input tie point location file. The tie point location file to be edited. If more than one file is entered, the tie point files will be combined to create one output tie point file.

OUTTL

Output tie point location file. The updated tie point location file.

MINDIST(10.0)

Minimum distance. The minimum pixel seperation to allow between tie points.

PRINT(TERM)

Output destination. The output destination of the report containing points which were marked as inactive. The available output destinations are:

  = TERM:      Terminal.  Output is sent to the user's
               terminal.
  = LP:        Line printer.  Output is sent to the
               printer defined by $PRINTER.
  = Filename:  User-supplied filename.  Output is sent
               to the user-supplied file with the
               extension "prt".

Examples:

1. LAS> edittie-screen intie=temp outtie=newtie ftype=tps

   EDITTIE will read the contents of the tie point selection file and display each of the values of the header record to the terminal. The user then interactively edits any of the values of the header or data records. These changes will only be written to NEWTIE when the (W)rite command is invoked.

2. LAS> edittie-tpl intp=tp4 outtl=tp4out ptid=tp_1 actflg=reject

   EDITTIE will read the contents of the tie point location file TP4 and change the active flag for TP_1 to specify that the tie point is being rejected manually by the user. The parameters that were defaulted by the user will not be changed. All the values of the fields will be written to TP4OUT.

3. LAS> edittie-rmdups intl=s08 outtl=s08out mindist=20.5 print=(term,result)

   EDITTIE will read the contents of the tie point location file S08;TPL and change the active flag to signify which tie points are being rejected manually by the user (tie points that are within 20.5 pixels). The output will be written to S08OUT;TPL and the rejected tiepoints will be reported to the user on the screen and in the file RESULT;PRT.

Description/Algorithm:

EDITTIE edits a tie point file header and data records and creates a new file with this information. EDITTIE provides two different methods for editing; a screen mode and a parameter mode.

EDITTIE-SCREEN reads the contents of the input tie point selection, tie point location, or merged tie point file and prints each of the fields of the header record to the terminal screen. If more than one input file is entered, the header records are compared first to see if the two files can be combined. If the header records match, the data records are combined and the user is prompted to enter new tie point ids if duplicates occur. The user can interactively edit any of the fields on the screen. The updated file is only written to OUTTIE when the (W)rite command is invoked. To create a new tie point file, INTIE must be set to NULL (--) and at least one tie point must be entered.

Valid commands of the -SCREEN subcommand:

   (H)elp     -- retrieve help for any of the tie point fields or 
                 retrieve general help 
   (P)age     -- go to the next screen of information
   (Q)uit     -- end the session without creating the tie point 
                 file
   (W)rite    -- write the changes to the tie point file and end 
                 the session
   (S)witch   -- switch between displaying the header and data 
                 records
   (A)dd      -- add a new tie point 
   (R)emove   -- remove a tie point 
   PT_ID      -- display a specific point id

A specific tie point name must be specified with the (A)dd and (R)emove commands.

Subcommands -TPS, -TPL, and -MTP read the contents of IN__ and change the contents of the fields for which the user enters values. The parameters that were defaulted by the user are not changed. All the values of the fields are written to the tie point file specified by OUT__. To create a new tie point file, IN__ must be set to NULL (--) and at least one tie point must be entered. Tie points can be added to an existing tie point file by specifying a unique point id. Tie points cannot be removed or renamed with these subcommands. Only two tie points may be edited at one time.

EDITTIE-RMDUPS reads the contents of the input tie point location file and determines which points are within the minimum distance specified. Out of each pair of points that are within the minimum specified distance, the most centrally located point is rejected (deactivated) and the results are saved in a new tie point location file.

NOTE:  All but the -SCREEN subcommand can be used for batch 
       processing.

Nonfatal Error Messages:

1. [edittie-input] Input is larger than buffer size

   The string that was input is larger than the size of the input buffer. Since the input string is larger than the buffer size, the string is probably invalid. Re-enter a shorter string.

2. [edittie-code] Invalid <XXXX> command code

   An invalid <XXXX> command code was entered. Retype the command with the correct code. The upper-case letters or a combination of the upper-case letters should be used as the edit command code. The (A)dd and (R)emove commands need a point id specified on the command line.

3. [edittie-length] String length is too long

   The length of the input string is too long for the width of the field within the tie point file. Shorten the input string.

4. [edittie-remove] Error removing the tie point

   The tie point to be removed was not found. Verify that the tie point exists.

5. [edittie-type] Invalid tie point coordinate type

   An invalid tie point coordinate mode was entered. Re-enter a valid coordinate type. Use the (H)elp command or refer to COORTYPE for valid entries.

6. [edittie-zone] Invalid zone code

   An invalid zone code was specified. Re-enter a valid zone code. Valid zone codes range from 0 through 5400. Refer to the Geometric Manipulation Package Overview Document (GEOMPOD) for more information.

7. [edittie-datum] Invalid datum code

   An invalid datum code was specified. Re-enter valid datum code. Valid datum codes range from 0 through 19.

8. [edittie-value] Unacceptable valid value

   An unacceptable value was entered for the projection validity field. Retype the command with a correct value. Use the (H)elp command or refer to PPVAL for valid entries.

9. [edittie-reference] Invalid reference mode flag

   An invalid reference mode flag was entered. Re-enter a valid reference mode. Use the (H)elp command or refer to REFTYPE for the valid entries.

10. [edittie-peak] Invalid peak fitting method

    An invalid correlation peak fitting method was entered. Re-enter a valid fitting method. Use the (H)elp command or refer to FITMETH for the valid entries.

11. [edittie-corr] Invalid correlation type

    An invalid type of correlation was entered. Re-enter a valid correlation type. Use the (H)elp command or refer to CORR-MODE with the -TPL subcommand for valid entries.

12. [edittie-active] Invalid tie point active flag

    An invalid tie point active flag was entered. Re-enter a valid flag value. Use the (H)elp command or refer to ACTFLG for a description of the values.

13. [edittie-chip] Invalid chip mode flag

    An invalid chip mode flag was entered. Re-enter a valid chip type flag. Use the (H)elp command or refer to CHIPTYPE for a list of valid entries.

14. [edittie-add] Tie point already exists

    The tie point id to be entered already exists. Re-enter a unique tie point id.

15. [edittie-head] <XXXX> should be the same

    A difference was found in the header record of the two tie point files. The data records will be combined, but the record of the first file will be used.

Fatal Error Messages:

1. [edittie-alloc] Unable to allocate dynamic memory

   An error occurred allocating memory for the output tie point file. Rerun the function, and if the error reoccurs, contact the system manager.

2. [edittie-head] <XXXX> must be the same

   The two tie point files cannot be combined due to a difference in the header records. Verify the integrity of each tie point file, or run EDITTIE on each file separately be fore trying to combine the two files.

3. [edittie-fatal] Fatal error encountered

   A fatal error was encountered during processing. The output file is deleted if $DELFLG="YES," and processing is terminated. The message that is displayed immediately preceding this error message is the specific error that was encountered.

4. [edittie-terminal] Terminal is not supported by TAE I/O

   The terminal from which this module was initiated is not supported by TAE terminal I/O. Initiate this module on a terminal that is supported by TAE terminal I/O. Consult the TAE Users' Manual for a list of valid terminal types.

5. [edittie-device] Device is not a terminal

   The device from which this module was initiated is not a terminal. To use this module with the subcommand -SCREEN, this module must be initiated on a terminal and not in batch.

6. [edittie-display] Terminal has too few lines of display area

   The terminal from which this module was initiated does not have enough lines in which to display the contents of the tie point file correctly. Initiate this module using one of the parameter subcommands or initiate this module from a terminal that has at least 24 lines of display.

7. [edittie-combine] Error combining tie points

   A duplicate tie point id name was found when trying to combine the tie point files. Rerun the function with -SCREEN subcommand.

8. [edittie-new] Error creating new tie point file

   When creating a new tie point file, at least one tie point must be entered.

9. [edittie-max] Error adding the tie point

   The tie point file already contains MAX_TIE_POINTS. A tie point must be removed before retrying.

10. [edittie-projcode] Invalid projection code

    An invalid projection code was entered. Retype the command with a valid projection code. Refer to PROJTYPE for valid projection codes.

User Notes:

1. For more information on the geometric registration process, refer to the Geometric Manipulation Package Overview Document, GEOMPOD.

2. Display tie point files to standard output destinations with DSPTIE.

3. Some fatal error messages are actually informational error messages for the SCREEN mode because the user is able to correct the error interactively before creating the tie point file.

4. TAB2TIE can be used to create a tie point selection file from a labeled table file.