User's Guide

Convert SPOT Vegetation HDF file(s) to LAS image(s).

Function:

SPOTHDF2LAS receives SPOT Vegetation HDF image file(s) from disk and converts them to LAS image(s). SPOTHDF2LAS uses the logfile to obtain the information needed to update the DDR(s).

Parameters:

INFILE

Input HDF file(s). The host file and pathname of the HDF single band SPOT HDF filename(s). Windowing is not supported. If multiple HDF files are requested in INFILE, and if the user requests one output LAS image, the HDF files must be the same data type.

OUT

Output image(s). The output LAS image. The number of images specified in OUT must either be one or equal to the number of input file names specified in INFILE.

LOGFILE

Input LOG file. The file that contains the information needed to update the DDR.

Example:

1. LAS> infile="/sg1/csb/na070199_b3.hdf" out="[sg1.csb.lasimage]out_b3" logfile="/sg1/csb/na070199_log"

   The input HDF image file na070199_b3.hdf located in directory /sg1/csb/ will be output to the LAS image file out_b3 located in directory [sg1.csb.lasimage]. The logfile na070199_log located in /sg1/csb/ will be used to obtain the information which will update the DDR.

2. LAS> infile=(na070199_b0.hdf na070199_b2.hdf na070199_b3.hdf) out=(out_b0 out_b2 out_b3) logfile=na070199_log

   The input HDF image files na070199_b3.hdf, na070199_b2.hdf and na070199_b3.hdf will be output to the LAS image files out_b0, out_b2 and out_b3. The logfile na070199_log will be used to obtain the information to update the DDR.

3. LAS> infile=(na070199_b0.hdf na070199_b2.hdf na070199_b3.hdf) out=out_all logfile=na070199_log

   The input HDF image files na070199_b3.hdf, na070199_b2.hdf and na070199_b3.hdf will be output to the LAS image file out_all. The logfile na070199_log will be used to obtain the information to update the DDR.

Description/algorithm

The specified input HDF file(s) will be read from disk. The number of lines, number of samples and data type will be read from the HDF image(s). If the user specified multiple HDF image files and requests one output LAS file and the data types are not the same, then processing will terminate with a fatal error. The HDF file(s) will be converted to LAS format. Finally, the geographic information will be obtained from the LOGFILE and the DDR(s) will be updated.

Nonfatal Error Messages:

1. [spothdf2las-xxxxx] <xxxxx> does not exist in logfile

   The <xxxxx> information normally stored in the logfile does not exist and will not be updated. Double check the logfile. It may not be vaild.

2. [spothdf2las-warn] Datum code was not found in LASTABLES

   Check the logfile for a valid datum and verify it with datum.txt in LASTABLES.

3. [spothdf2las-warn] Spheroid code was not found in LASTABLES

   Check the logfile for a valid spheroid and verify it with spheroid.txt in LASTABLES.

4. [spothdf2las-warn] Error terminating access to SD data set in file <xxxxx>

   There was a problem terminating access to SD interface.

5. [spothdf2las-warn] Error closing file <xxxxx>

   There was a problem closing file <xxxxx>.

6. [spothdf2las-warn] Unable to detach from vdata in file <xxxxx>.

   There was an error detaching from vdata in file <xxxxx>.

7. [spothdf2las-warn] Unable to end access to vdata in file <xxxxx>.

   An error occurred while trying to teminate access to vdata in file <xxxxx>.

8. [spothdf2las-VSwarn] Error closing file <xxxxx>.

   An error was encountered while closing file <xxxxx>.

Fatal Error Messages:

1. [spothdf2las-fatal] Fatal error encountered

   The error message that is displayed immediately preceding this message is the specific error that occured.

2. [spothdf2las-SDstart] Error opening file <xxxxx>

   The input file <xxxxx> could not be opened. Check the file name and file permissions.

3. [spothdf2las-SDinfo] Error reading image information from file <xxxxx>

   The input image file <xxxxx> could not be read. Check the file name and file permissions.

4. [spothdf2las-rank] SPOTHDF2LAS cannot handle SD of a rank other than 2

   SPOTHDF2LAS is required to read an image file containing 1 band only. Multiple bands per image file is not supported.

5. [spothdf2las-dtype] Input data types must be the same if only one output image is specified

   The HDF image files requested must be the same data type if only one output LAS image is requested.

6. [spothdf2las-dtype] HDF contains a data type not supported by LAS

   The HDF image file must be either 8 bit, 16 bit or 32 bit int, or 8 bit, 16 bit or 32 bit unsigned int, or 32 bit floating point.

7. [spothdf2las-Vstart] Error opening file <xxxxx>

   There was an error opening file <xxxxx>. Check file name and file permissions.

8. [spothdf2las-vdata] Error retrieving a vdata reference number for file <xxxxx>

   There was an error reading file <xxxxx>. Check file name and file permissions.

9. [spothdf2las-vdata] Error attaching to vdata in file <xxxxx>

   There was an error reading file <xxxxx>. Check file name and file permissions.

10. [spothdf2las-vdata] Error reading vdata in file <xxxxx>.

    There was an error reading file <xxxxx>. Check file name and file permissions.

11. [spothdf2las-SDopen] Error opening file <xxxxx>.

    There was an error opening file <xxxxx>. Check file name and permissions.

12. [spothdf2las-SDread] Error reading image data from file <xxxxx>.

    There was an error reading file <xxxxx>. Check file name and permissions.

13. [spothdf2las-file] Total number of OUTS must equal total number of INPUTS or specify only one OUT.

    Respecify INPUT and OUT and re-run.

14. [spothdf2las-alloc] Error allocating dynamic memory

    An error was detected while trying to allocate dynamic memory. If the error persists contact the system administrator.

15. [spothdf2las-open] Error opening output image <xxxxx>.

    There was an error opening output image file <xxxxx>. Check file permissions and disk space.

16. [spothdf2las-read] Error reading input image <xxxxx>.

    There was an error reading file <xxxxx>. Check file permissions and disk space.

User Notes:

None