User's Guide

MEDIT

Allows for the addition or deletion of tie points

Function:

Allows for the addition or deletion of tie points based on either point numbers or residual values.

Parameters:

Subcommand -POINTS:
Edit based on point numbers. Allows the user to delete or reinstate points based on point numbers.

FROMFRAM
From frame number. The "from frame" number of the image whose tie points are being edited.

TOFRAM(--)
To frame numbers. The "to frame" numbers of the images whose tie points are also updated to match what was edited for the "from frame." The default value indicates that there are no "to frames" to be updated.

PNTNUM
Point numbers. The point numbers to be edited.

PNTOPT(DELETE)
Point option. Specifies whether the given points are being deleted (by turning the active flag off) or reinstated (by turning the active flag on).


  = DELETE:     Delete points. 
  = REINSTATE:  Reinstate points.

DELFLG(YES)
Delete flag. Specifies whether or not the temporary files should be deleted upon completing the procedure.


  = YES:  Delete temporary files.
  = NO:   Do not delete temporary files.
Subcommand -RESIDUALS:
Edit based on residual values. Allows the user to delete or reinstate points based on residual values.

FROMFRAM
From frame number. The "from frame" number of the image whose tie points are being edited.

TOFRAM(--)
To frame numbers. The "to frame" numbers of the images whose tie points are also updated to match what was edited for the "from frame." The default value indicates that there are no "to frames" to be updated.

PNTOPT(DELETE)
Point option. Specifies whether the given points are being deleted (by turning the active flag off) or reinstated (by turning the active flag on).


  = DELETE:     Delete points. 
  = REINSTATE:  Reinstate points.

LINERR(-3.0,3.0)
Line residual range. The range of acceptable values for the line residuals. The first value is the lower limit of the range and the second value is the upper limit.

SAMPRR(-3.0,3.0)
Sample residual range. The range of acceptable values for the sample residuals. The first value is the lower limit of the range and the second value is the upper limit.

LINECOL(19)
Line residual column. The column number where the line residual values are located.

SAMPCOL(20)
Sample residual column. The column number where the sample residual values are located.

DELFLG(YES)
Delete flag. Specifies whether or not the temporary files should be deleted upon completing the procedure.


  = YES:  Delete temporary files.
  = NO:   Do not delete temporary files.

Examples:

  1. LAS> medit-points fromfram=1 tofram=2 pntnum=(2,7,9) pntopt=delete

    Assuming that the LAMS global $IMAGE=("US1","US2"), the point numbers 2, 7, and 9 are deleted from US1.GCP and US2.GCP by setting their active flags to inactive. The temporary files are deleted.

  2. LAS> medit-residuals fromfram=1 pntopt=delete delflg=no

    Assuming that the LAMS global $IMAGE=("US1","US2"), the points whose line residuals are not in the range of -3 to 3 or sample residuals are not in the range of -3 to 3 are deleted from US1.GCP by setting their active flags to inactive. The temporary files are not deleted.

Description/Algorithm:

If the specified subcommand indicates that editing should be based on point numbers, an IBIS tabular file is created. This file contains the specified point numbers and either an active or inactive flag as specified by the PNTOPT parameter. This temporary points file and the ground control point (GCP) file for the "from frame" are sorted on point number. The two files are then merged so that when point numbers match, the active flag in the GCP file is updated as indicated. The corresponding points in the GCP files of the specified "to frames" are also updated.

If the specified subcommand indicates that editing should be based on residual values, IBIS tabular files are created. These files contain those points whose line and sample residuals are outside the acceptable range and either active or inactive flags as specified by the PNTOPT parameter. These temporary files and the GCP file for the "from frame" are sorted on point number. These files are then merged so that when point numbers match, the active flag in the GCP file is updated as indicated. The corresponding points in the GCP files of the specified "to frames" are then updated.

Finally, if specified, the temporary files are deleted. Error Messages: Error messages are displayed from the called routines.

User Notes:

  1. Any changes made to the routines CMRENAME, CMCOPY, CMDEL, MF, MTBGEN, MTBSORT, MERGE, and ROWOP may affect the operation of this routine.

  2. Related Large Area Mosaicking System (LAMS) procedure functions include MCTP, MCUT, MTIE, MCRN, MAVE, MGRID, MGMAP, and MRAD.