User's Guide

LAS2NDF

Convert LAS image(s) to NLAPS Data Format (NDF) files

Function:

Convert a LAS image on disk to National LANDSAT Archive Production System (NLAPS) Data Format. The input image(s) may be subwindowed and subbanded.

Parameters:

IN

Input image(s). The name of the input LAS image(s).

OUTFILE(--)

Output file. The name of the NDF files to be created.

BFORM("BSQ")

Band format. The format of the image data on tape. If there is more than one band in the image, the data may be stored in band sequential (BSQ) or band interleaved by line (BIL) format.

  = BSQ: Band sequential
  = BIL: Band interleaved by line

Example:

1. LAS> las2ndf in=[user.mydir]valddr

   The LAS image VALDDR will be converted to NDF BSQ format files with a root name of VALDDR. (See User Note #1 for NDF naming conventions)

2. LAS> las2ndf in="image1(:1,2)+image2" outfile=newimage bform=bil

   Bands 1 and 2 of IMAGE1 together with IMAGE2 will be combined and converted into a NDF BIL format with the file name NEWIMAGE. (See User Note #1 form NDF naming conventions)

Description/Algorithm

The information in the LAS image DDR file is used to create a NDF header file. Only the NDF fields that can be filled from the DDR will be created. Also, the values MUST be VALID before they can be used. A project parameter file (.ppf) will be created to hold the filenames that TRANSLAS-OUT will use. If the value in BFORM is BSQ, then TRANSLAS-OUT will separate each band into its own file. If the value in BFORM is BIL, then TRANSLAS-OUT will convert the entire image to BIL format.

Non-fatal Error Messages:

1. [las2ndf-conv] Could not convert to DMS

   The program could not convert the coordinate to DMS.

2. [las2ndf-month] Error determining the month

   Could not determine the month of the year.

3. [las2ndf-nonfatal] Nonfatal error encountered

   This message is displayed when an error occurs retrieving some information.

4. [las2ndf-pcode] Error determining DDR projection code

   The projection code in the DDR record could not be determined.

5. [las2ndf-writ] Error writing the <XXXXX> to header file

   Could not write the <XXXXX> information to the NDF header file.

Fatal Error Messages:

1. [las2ndf-open] Error creating the NDF header file

   The program could not create the NDF header file. Check that there is room for the file and that you have permission to create a file.

2. [las2ndf-dtype] Invalid data type

   The data type value found in the DDR file is invalid. If this happens, the DDR file is corrupt.

3. [las2ndf-fatal] Fatal error encountered

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

4. [las2ndf-read] Error reading DDR file

   Could not read the specified DDR file. Check and make sure that the file exists and that you have permission to read it.

User Notes:

1. Naming conventions are as follows for NDF formatted files generated by this function:

   	<out>.i<file#>       Image data files
           <out>.hd             Image NDF header file
   
       <file#> always begins with 1 and increments through the number of
       bands included with this NDF product, up to a maximum of 7.
   

2. Related functions are NDFIN, NDF2LAS, and NDFOUT.

3. A description of the NDF header format can be found in the National Landsat Archive Production System (NLAPS) Data Format Specification, Ver 1.0, 28 July 1995.