User's Guide

MRLC2CD

Utility to copy MRLC tapes to CD-R.

Function:

Copy a MRLC archive image and corresponding Digital Elevation Model (DEM), or corresponding cluster data sets, to CD-R.

Parameters:

SCENEID
Input sceneid. The input sceneid is entered from the archive 3480 tape label. There is no SCENEID on cluster image tapes, so any number with a minimum of six digits may be used.

TAPEID
Tape identification. Library storage locations of input 3480 archive tapes. See User Note 1.

DATTYPE("D","I","I","I")
Input data types. The data type for each input tape. See User Note 1.

	= D: DEM
	= I: IMAGE
	= C: CLUSTER

CDID
CD identification. Output CD-R library storage location.

PATH
WRS Path. The WRS path of the data.

ROW
WRS Row. The WRS row of the data.

DATE
Acquisition date. The acquisition date of the input image data. Enter in MM/DD/YY format.

CDATE(--)
Cluster scene generation date. The date of the images the cluster data sets were generated from. Enter in MM/DD/YY format for six band clusters. Twelve band cluster should have the dates of both input scenes, seperated by a dash, MM/DD/YY-MM/DD/YY.

NCOPIES(1)
Number of copies. The total number of CDs to generate. One copy will always be generated for addition to the library. Additional copies may be generated for delivery to customers. The library copy will have a library label generated, and customer copies will have customer labels.

Examples:

  1. mrlc2cd sceneid=y5300814373x0 tapeid=(006322,006288,006321,006343) dattype=(d,i,i,i) cdid=cd0001 path=010 row=029 date="05/26/92"

    The library tapes specified in TAPEID, with the data types specified in DATTYPE are read to disk. This data was acquired on DATE, and is geographically located at WRS path/row 010/029. The output CDwith a storage location of cd0001 will be created with image and DEM data. Both a library CD-R and a customer deliverable CD-R will be created.

  2. mrlc2cd scenid=123456 tapeid=005454 dattype=c cdid=cd0002 path=010 row=029 date="05/26/92" cdate="05/26/92" ncopies=1

    The library tapes specified in TAPEID, with the data type specified in DATTYPE are read to disk. This data is geographically located at WRS path/row 010/029. The output CD-R with a storage location of cd0002 will be created with cluster data. Only a library CD-R will be created.

Description/Algorithm:

The MRLC CCT archive is stored on 3480 tapes. Each image is stored on three 3480 cartridges, each tape containing two ASCII data desciptor records (DDR) and two image bands. Each DEM tape is stored with one ASCII DDR and one image file. Each cluster image is stored on an individual 3480 tape, and contains one ASCII DDR and one image file (See User Note 2).

This program will copy specified DEM and image or cluster data from archive 3480 media to CD-R. Readme and indexing summary files will be added to the CD-R. Only those tapes required for either the IMAGE or CLUSTER volumes will be listed in the summary file.

An IMAGE volume will be generated for each WRS Path/Row/Date scene in the MRLC inventory. Each output CD-R will contain a specific Path/Row image, and its corresponding Digital Elevation Model (DEM) file.

A single CLUST volume will be generated for each WRS Path/Row. All cluster images will be placed on this CD, each being placed in a unique directory.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [mrlc2cd-data] Cannot process specified path/row/dtype"

    The specified combination of PATH, ROW, DATE, and DATTYPE cannot be processed. Either corresponding archive CD-WO has already been generated, of the specified input data does not exist in the mrlc.meta file.

  2. [mrlc2cd-fatal] Fatal error encountered

    The error message that is displayed immediately preceding this message is the specific error that was encountered. Processing is terminated.

  3. [mrlc2cd-parm] Invalid <xxx> parameter

    An invalid value was entered for the specified parameter. Re-run program with an appropriate parameter value.

  4. [mrlc2cd-prod] Volume requires multiple CDs

    The amount data for this MRLC path/row output CD exceeds 650Mb. This data will have to be converted to CD-R with a manual process. Contact the MRLC Project Leader for resolution.

  5. [mrlc2cd-tape] No tapes found

    No tapes were located that correspond to the input parameters. Check all parameters to ensure they are correct and re-run.

User Notes:

  1. For the IMAGE volume, the DEM tape should be listed first, with image tapes following in sequence.
  2. For a description of cluster type data, review the documentation for the CLUSTER procedure.
  3. GETMRLCMETA is automatically tutored for operations when this program is run. GETMRLCMETA prompts for parameters, then searches the mrlc.meta file for the library storage locations, image dates, and if needed, cluster dates.