User's Guide

Copy one LTWG (Landsat Technical Working Group) tape to a three-tape set and extract needed metadata from the header files.

Function:

Copy one LTWG (Landsat Technical Working Group) 8mm tape to a three-tape 3480 set and extract needed metadata from the header files. The metadata, which is split into the .scene and .archv files, will be copied to the directory /dg3/work/dsb/data/lsceosnldc/ for database population.

Parameters:

PROJECT
Project. The project for which the tapes are being copied.

CODE
Associated project code. This corresponds to the entry for PROJECT.

Example:

  1. LAS> ltwg123 project="htfptm" code=051

    The operators are prompted to mount an 8mm LGSOWG/CEOS formatted tape. Image data is read from the tape and is copied to three output 3480s. The metadata will reflect the project name and code given, as will the generated tape labels for the output 3480s.

The operator is prompted to mount an 8mm LGSOWG/CEOS tape, and image data is

read off of it. This data consists of a Volume Descriptor File, a leader file for each band, image data for each band, a trailer file, and a supplementary Volume Descriptor file. Once the entire 8mm tape has been read, it is unmounted and the function prompts the operators to mount three scratch 3480 tapes, in succession.

The image data is spread across the 3480 tapes as described by the format document "LTWG Format for Thematic Mapper CCT - Full Scene", where the first physical volume holds the first three bands, the second physical volume holds the next three bands, and the third volume holds the last band. The output tape locations as given by the operators are stored as part of the metadata (the .archv file.)

Once the output tapes have been written, the function extracts metadata from the image's Volume Descriptor and leader files and writes out standard metadata .scene and .archv files, which are then copied to the remote directory for use by Data Management.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [ltwg123-alloc] Error allocating dynamic memory

    An error occurred allocating memory. Re-run, and if the error persists, contact the LAS system administrator.

  2. [ltwg123-file] Error opening <xxxxx> file for <xxxxx>

    An error occurred trying to open a disk file. Ensure that the disk device is not full and re-run. If the error persists, contact the LAS system adminsistrator.

  3. [ltwg123-pass] Error passing variables to TAE.

    An error occurred while trying to pass information back to TAE. This error should not occur. Re-run, and if the problem persists, contact the LAS system administrator.

  4. [ltwg123-read] Error reading data from <xxxxx>

    An error occurred while trying to read data from an input file. Re-run, and if the error persists, contact the LAS system administrator.

  5. [ltwg123-write] Error writing data to <xxxxx>

    An error occurred while trying to write data to an output file. Ensure that the disk device is not full and re-run. If the error persists, contact the LAS system administrator.

User Notes:

  1. LTWG123 uses DITTO functions for processing. Refer to these User Guides for more information.

  2. The PROJECT and CODE fields do not have a list of valid entries; rather, they have been made mandatory and free-form to allow for future project names/associated codes without requiring modification to this function.

  3. LTWG123 does not support BIL-format LGSOWG 8mm tapes. Currently, only BSQ data is supported.

  4. The user running this function must have have an account on the dg3 machine; otherwise, the function will be unable to remote-copy the metadata files to the proper directory. It may be necessary to run the function from under a release account.