Automate stitching of appropriate scenes into a half orbit
Read an orbital stitch list and stitch appropriate scenes into half orbits. Each input scene within a half orbit is stitched into that half orbit and the appropriate products are generated.
- INFILE
- Input file. The file containing the list of orbital stitching information. Refer to User Note 1 for the input file format.
- CEOSID
- CEOS identifier. The alphanumeric code which identifies the station that stitched the raw AVHRR data. The first two characters of this identifier must be "KM". For example, "KM1" signifies orbits stitched at EDC, "KME" signifies orbits stitched at ESA.
- 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 orbit 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 orbstitch.log in ADAPSLOG.
The input stitch list "scenes.dat" is read and all of
the scenes within the file starting at AL11063092130017
are read and grouped into orbits. All scenes within
an orbit are stitched together and the resulting image
is archived. The generated log file "mylog.log"
resides in the present working directory. Since
QLPFLG has been set to YES, quick-look prints of the
input scenes as well as the stitched orbits will be
generated.
Processing will begin with the first scene in the input stitch list "scenes.dat" and will continue until the scene "AL11052293130017" has been processed, or until the end of the input file is encountered. All of the scenes are grouped into orbits, and then stitched together. Since the log file name has not been specified, it will be named "orbstitch.log" and will reside in the ADAPSLOG directory.
The specified input orbital stitch list 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 stitch list will be processed. Each scene is grouped into its respective orbit. Processing of the half orbit does not begin until all of the scenes within the half orbit reside within the ADAPSORB/process directory and have been line detected (resulting output of ORBLN). The scenes are stitched together to form an image containing a half orbit of data (the other half of the earth is dark for each satellite revolution). A database record is generated for the stitched orbit and placed in the ADAPSDB directory. A browse image is generated for the stitched orbit and placed in the ADAPSBRW directory. The stitched image is copied to the silo, and then moved to the ADAPSARC/esa/km1 directory. AUTOESAL1B will find the stitched image in this directory, generate an archive tape, and then move the image into the ADAPSARC/bjg/km1 directory. AUTOBJGL1B will find the stitched image in this directory, generate an archive tape, and then move the image into the ADAPSARC/prodgen directory. The individual scenes used to generate the half orbit are deleted from the ADAPSORB/process directory as well as from the UCFM. For each half orbit stitched, a list containing scene ID's and production data base source links is generated in the ADAPDB directory. This list enables the production data base to be updated to reflect which scenes have been stitched into a half orbit. A history file named "stitchistory" is updated in the ADAPSLOG directory. This history file contains the names of the stitched input images, the names of the respective output stitched orbits, and the GOODES projection regions found within each stitched orbit.
A fatal error was encountered. The message displayed preceding this message is the error that was encountered. Processing terminates.
An error was encountered reading the input file and determining which scenes are part of a half orbit. Verify that the specified input file has not been corrupted (see User Note 1 for input file format).
If the scenes to be stitched are read from the UCFM, each scene has a unique time stamp appended to it. An error occurred determining the time stamp for an image; contact the system administrator if this problem persists.
An error occurred while attempting to stitch the scenes into a half orbit. Refer to MAKORB for a further explanation of the error.
An error occurred while attempting to write the stitched orbit to the UCFM. Refer to SILO for a further explanation of the error.
An error occurred while attempting to create the browse image or the data base record. Refer to the specific REFAID error preceding this error message.
An error occurred while renaming the stitched image from ADAPSORB into ADAPSARC. Make sure that these environment variables have been properly set, that the stitched image exists, and that file permissions are correct.
The scenes needed to form the orbital stitch could not be removed from disk once the stitched image was created. Make sure the images exist with the proper file permissions.
An error occurred while determining the value of the orbital stitching directory. Verify that ADAPSORB has been defined.
An error occurred while renaming the data base file to the ADAPSDB directory. Verify that the files exists with sufficient permissions.
The AVHRR archive header file contains discrepancies which were being fixed when an error occurred. Verify that the header file exists in the ADAPSORB/process directory with write permission.
An error occurred while writing to the history log file. Verify that the file exists in the ADAPSLOG directory with sufficient permissions.
An error occurred while determining the regions that lie within the orbital stitched image. Verify that the orbital stitched image is a valid AVHRR archive image.
An error occurred while attempting to archive a stitched image. Verify that the files exist with sufficient permissions.
An error occurred while attempting to generate a data base file. Verify the permissions of the ADAPSDBTMP directory.
An error occurred while attempting to update the orbital stitch list. Verify that the list has not been corrupted.
An error occurred while trying to determine if a stop file exists in the ADAPSTABLES directory. Verify that the environmental variable ADAPSTABLES has been defined.
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.
ah11040192052626 | 37447 ah11040192053416 | 38497 ah11040192054506 | 48171 ah11040192054847 | 38498 al11040192060008 | 31436 . . . .
The first field within the file contains the scene ID, the second field contains the data base source link. These files reside in the ADAPSDB directory. Their names are derived from the current date and time stamp and have a suffix of "orb". Backup copies of these files are kept in the ADAPSDBTMP directory and have a suffix of "done". Files in the ADAPSDBTMP directory with a suffix of "tmp" contain a list of scenes in which orbital stitching began, but did not successfully complete. The "orb" files in the ADAPSDB directory are used to update the production data base records to signify which scenes have been stitched into a half orbit.