User's Guide

L1BLABEL

Create labels for Level 1b tapes

Function:

Creates labels for Level 1b tapes. One label is printed for each tape volume. If multiple images are written to tape, a tape directory is also printed which shows the location and name of each scene on the tape.

Parameters:

Subcommand -SINGLE:
One scene. One scene was placed on the tape, so a label with information about the scene and the tape itself will be printed.

NVOLS
Number of volumes. A label will be printed for each tape volume in the set.

ORDERNUM
Order number. The order number for which the tapes were created.
Subcommand -MULTI:
Multiple scenes. Multiple scenes were placed on the tape, so a label with general information about the order and the tape itself will be printed. Also, a tape directory will be created to show the file number and scene ID's of all scenes on the tape.

NVOLS
Number of volumes. A label will be printed for each tape volume in the set.

ORDERNUM
Order number. The order number for which the tapes were created.

SCENEID
Scene ID. This is a list of the scene ID's for each scene on the tape(s). It is used to create the tape directory.
Subcommand -SPEC:
Multiple scenes with filename specification. Rather than entering the name for each scene manually, a filename specification such as "[images.avhrr]*;arch" is used instead. Multiple scenes were placed on the tape, so a label with general information about the order and the tape itself will be printed. Also, a tape directory will be created to show the file number and scene ID's of all scenes on the tape.

NVOLS
Number of volumes. A label will be printed for each tape volume in the set.

ORDERNUM
Order number. The order number for which the tapes were created.

INFILE
Filename specification. This specification is used to build a list of scene ID's for each scene on the tape rather than entering them manually.

Examples:

  1. LAS> l1blabel-single nvols=2 ordernum=92011300005

    Two labels will be printed for order number 92011300005. Each label will include information about the one scene contained on the two tapes.

  2. LAS> l1blabel-multi sceneid=(al11050692174705, ah12051492062837) nvols=1 ordernum=92031300432

    One label will be created for order number 92031300432. Since two scenes are on the tape, the label includes only general information about the order and the tape. A tape directory is created, showing scene AL11050692174705 is the first file on tape, and scene AH12051492062837 is the second file on tape.

  3. LAS> l1blabel-spec infile=ah*;arch nvols=1 ordernum=94020800432

    One label will be created for order number 94020800432. It is assumed that all files in the current directory that match the specification "ah*;arch" are scenes that are present on the tape. A tape directory is created, showing the scenes on the tape in the order which they are found in the current directory.

Description/Algorithm:

Information about the label is read from the lab.dat file created by MKLEVEL1B or STACK1B. For the -MULTI subcommand, only general information about the tape and order are formatted and written to a label file. This information includes the creation date, order number, number of images on the tape (or set of tapes), the bpi of the tape, the drive on which it was created, and the data format. One label file is created and sent to the label printer for each of the NVOLS tapes. A tape directory is then printed which reports each scene ID and its location on the tape. For the -SINGLE subcommand, only one scene is written to tape. Consequently, the general tape and order information on the label are combined with specific information about that scene. This information includes the scene ID, acquisition date, latitude and longitude of the upper left and lower right corners, and the number of lines and samples. For each of the tapes specified by NVOLS, this information is formatted and written to a label file.

Nonfatal Error Messages:

  1. [l1blabel-info] Error occurred printing the label Label is saved as <XXX>

    An error occurred printing the label file. The label was saved in the given file. It may be manually printed by typing "lp -c -s -dlabels <XXX>".

  2. [l1blabel-fnam] Label file is <xxx>

    This message informs the user of the name of the label file if it was not printed on a label printer. This user is responsible for sending the label file to the printer.

  3. [l1blabel-noprint] Labels will not be sent to the printer

    The label printing utility is set up to work with the EROS Data Center's network printing facility. If this program is not being run at the EROS Data Center, label files will not be printed out, but will be saved in the file names indicated by Message 2 above.

Fatal Error Messages:

  1. [l1blabel-noopen] Could not open file -- <XXX> not created

    The specified file could not be opened for output. Ensure that you have write permission in the working directory.

  2. [l1blabel-nodata] Label data file not found

    The lab.dat file was not found. This file provides the information to place on the label. See Users Note 1 to find a format for creating such a file.

User Note:

  1. If the required lab.dat file is not available, one can be recreated by simply creating a text file with the following information:

        scene ID
        acquisition date (numeric mmddyy; no separators)
        latitude of upper left corner (decimal degrees)
        longitude of upper left corner (decimal degrees)
        latitude of lower right corner (decimal degrees)
        longitude of lower right corner (decimal degrees)
        tape density
        number of lines
        number of samples
        order number
        unit number
        drive name