User's Guide

ORBSTART

Initiate stitching of appropriate scenes into half orbits

Function:

Given an orbital stitch list, submit batch jobs to accomplish the orbital stitching process.

Parameters:

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

STRSCENE(--)
Starting scene ID. The scene ID within INFILE at which processing should begin. If STRSCENE is not found within INFILE, no scenes will be processed. If unspecified, processing will begin at the first scene ID in INFILE.

ENDSCENE(--)
Ending scene ID. The scene ID within INFILE at which processing should end. If ENDSCENE is not specified or the specified ID is not found within INFILE, processing will continue to the end of INFILE.

QLPFLG(NO)
Quick-look print flag. Flag indicating if quick-look prints of the input images and resulting stitched orbits are desired.

  = YES:       Generate quick-look prints
  = NO:        Don't generate quick-look prints

LOGFILE(--)
Log file. Name of the log file that the processing messages will be appended to. The default is orbstart.log in ADAPSLOG. This log file will not contain messages from the jobs submitted by ORBSTART.

Examples:

  1. LAS> orbstart infile=scenes.dat strscene=al11063092130017 qlpflg=yes logfile=mylog

    Batch jobs are submitted to accomplish orbital stitching. The input file "scenes.dat" starting at scene ID AL11063092130017 is used to determine which scenes to stitch. Since QLPFLG has been set to YES, quick-look prints of the input images as well as the stitched orbits will be generated. Messages are logged in "mylog.log" in the present working directory.

  2. LAS> orbstart infile=scenes.dat endscene=al11052293130017

    Batch jobs are submitted to accomplish orbital stitching. The input file "scenes.dat" starting with the first scene in the file and ending with scene ID AL11052293130017 is used to determine which scenes to stitch. Since the log file name has not been specified, the file "orbstart.log" residing in the ADAPSLOG directory will be used.

Description/Algorithm:

Given an orbital stitch list, submit batch jobs to accomplish orbital stitching. A job is submitted to read the input scenes onto disk (ORBREAD), another job is submitted to line detect the input scenes (ORBLN), and another job is submitted to stitch the input scenes (ORBSTITCH). The specified input file is read to determine which scenes are to be stitched into half orbits. If a starting and ending scene ID are not specified, all of the scenes within the input file will be processed.

Nonfatal Error messages:

    None.

Fatal Error messages:

  1. [orbstart-fatal] Fatal error encountered

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

  2. [orbstart-sysd] Error getting the system date and time

    An error was encountered getting the system date and time. Contact the system administrator.

  3. [orbstart-read] Error starting the read procedure

    An error was encountered while submitting a batch job to read the input scenes onto disk. Verify that ORBREAD is operational.

  4. [orbstart-lndet] Error starting the line detect procedure

    An error was encountered while submitting a batch job to line detect the input scenes. Verify that ORBLN is operational.

  5. [orbstart-stitch] Error starting the stitch procedure

    An error was encountered while submitting a batch job to stitch the input scenes. Verify that ORBSTITCH is operational.

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.