User's Guide

ORBEDIT

Edit the status flags within an orbital stitch list file

Function:

Read an orbital stitch list file and update the status flag values for a specified scene ID.

Parameters:

INFILE
Input file. The file containing the list of orbital stitch information. Refer to User Note 1 for the input file format.

SCENEID
Scene identifier. The status flags for this scene identifier will be updated.

LOCFLG(--)
Location flag. The location of the scene:


  = "D":	Scene is located on disk
  = "S":	Scene is located on the silo (Unitree Central
		File Manager)
  = " ":	Scene location is unknown

If defaulted, the current value will remain unchanged.

LNDFLG(--)
Line detect flag. Flag indicating whether the scene has been line detected:


  = "L":	Scene has been line detected
  = " ":	Line detection status unknown

If defaulted, the current value will remain unchanged.

ORBFLG(--)
Orbital stitch flag. Flag indicating whether the scene has been stitched:


  = "O":        Scene has been stitched
  = " ":        Stitch status is unknown

If defaulted, the current value will remain unchanged.

Examples:

  1. LAS> orbedit infile=ss050110;txt sceneid=ah11061293021213 locflg="d" lndflg="l"

    The input stitch list "ss050110;txt" is read and the line pertaining to scene ah11061293021213 is located. The location flag is set to "D" meaning the scene is located on disk. The line detect flag is set to "L" meaning the scene has been line detected.

  2. LAS> orbedit infile=ss050110;txt sceneid=ah11061293021213 orbflg=" "

    The input stitch list "ss050110;txt" is read and the line pertaining to scene ah11061293021213 is located. The orbital stitch flag is set to " " meaning the stitch status of the scene is undetermined. The location and line detect flags will remain unchanged.

Description/Algorithm:

The specified input orbital stitch list is read and the line pertaining to the input scene ID is located. The status flags on the line are updated based on the user specified flags.

Nonfatal Error messages:

  1. [orbedit-warn] Nonfatal error encountered

    A nonfatal error was encountered during processing. The error message that is displayed immediately preceding this message is the specific error that was encountered. Processing will continue.

  2. [orbedit-clos] Error closing <XXXXXX> file

    An error was encountered while trying to close the specified file. If this error continues to occur, contact the system administrator.

Fatal Error messages:

  1. [orbedit-fatal] Fatal error encountered

    A fatal error was encountered. The message displayed preceding this message is the error that was encountered. Processing terminates.

  2. [orbedit-open] Error opening <XXXXXX> file

    The specified file does not exist or does not have the proper file permissions set.

  3. [orbedit-read] Error reading line in input file

    An error occurred while trying to read a line in the input stitch list. Verify the file permissions and make certain the file has not been corrupted.

  4. [orbedit-sloc] Scene ID not found

    An error occurred while reading the input stitch list and locating the proper scene ID. Verify that the input scene ID is correct.

  5. [orbedit-seek] Error seeking in the file

    An error occurred while trying to seek within the input stitch list. Verify the file permissions and make certain the file has not been corrupted.

  6. [orbedit-writ] Error writing to the file

    An error occurred while trying to update the status flags within the stitch list. Verify the file permissions and make certain the file has not been corrupted.

  7. [orbedit-flre] No flag modifications requested

    No updates to the status flags were requested. A non-default value must be specified for LOCFLG, LNDFLG, or ORBFLG.

User Notes:

  1. The expected format of the input file is as follows:

    
    tapeid mth acqdate  start  stop ceos st d a source flg
    031185 AH 04/01/92   5332  10408 NGC 11 D A  31376
    019990 AH 04/01/92  34636  35718 HBT 11 D A  37446
    020403 AH 04/01/92  35703  40438 TSV 11 D A  38496
    031272 AL 04/01/92  41800  42906 NOA 11 D A  31435
    019990 AH 04/01/92  52626  54118 HBT 11 D A  37447
    020403 AH 04/01/92  53416  54728 TSV 11 D A  38497
             .                            .
             .                            .
             .                            .
    
    
    The header is read until the line beginning with "tapeid" has been encountered. Valid lines of data are expected following this line.

  2. The input file is generated by LISTITCH or is a data base listing of scenes on archive tape.

  3. Refer to the orbital stitching overview for more detailed information.