Ingest an ASTER HDF image and output it in LAS format.
ASTERHDF2LAS ingests an ASTER HDF image from disk and converts it to a LAS image(s). This routine supports Level 1A, Level 1B, Level 2 and Level 3 DEM data.
- INFILE
- Input ASTER HDF file. The LAS or host (UNIX) file and pathname of the HDF file.
- OUT
- Output image(s). The output LAS image. The number of images specified in OUT must either be one, equal to the number of bands specified in BANDS, or equal the number of entries in NBANDS. See User Note 1 and User Note 2.
- BANDS(-- VALID=(1,2,3N,3B,4,5,6,7,8,9,10,11,12,13,14)
- Band number(s). The image bands to be processed. The default indicates that all bands present in the HDF file are processed. See User Note 1.
- NBANDS(--)
- Defines the number of bands to be placed in each output file. If NBANDS is specified, BANDS must be also specified. Also the number of entries must match the number of entries in OUT. See User Note 1.
- WINDOW(--)
- Window specification. If UNITS is LS, the window specifies the start line, start sample, number of lines, and number of samples for the window. If only the start line and sample are entered, the number of lines and number of samples will default to the end of the image. NOTE: If the HDF file has multiple resolutions, then the same line and sample values are applied to each resolution. Therefore the output windows for each resolution are the same size but not the same image area. If UNITS is not LS, the window specifies the upper left Y, upper left X, lower right Y, and lower right X coordinates. If the WINDOW is not specified, it defaults to the entire image. If a window is specified, it is applied to all of the bands.
- UNITS(LS)
- Units used for WINDOW parameter.
= LS: Line/Sample = DEG: Degrees (Lat & Long) = DMS: Degrees Minutes Seconds (Lat & Long) (+DDDMMMSSS.SS) = PRO: Projection coordinates (Y & X in meters)
The input ASTER HDF image file is pg-PR1B0000-2000070302_190_001 and is located in directory [sg1.csb.las.asterhdf]. All bands that are available for this image are processed, and the entire image is processed. Since this a multi-resolution product, the Visible and Near Infrared bands appears in out_image_vnir.img, the Shortwave Infrared bands appears in out_image_swir.img, and Thermal Infrared bands in out_image_tir.img.
The input ASTER HDF image file is pg-PR1B0000-2000070302_190_001 and is located in directory /sg1/csb/las/asterhdf/. Since this is a multi-resolution product, bands 1 and 2 are processed and output to out_image_vnir.img and band 7 is processed and output to out_image_swir.img
The input ASTER HDF image file pg-PR1B0000-2000070302_190_001 located in directory /sg1/csb/las/asterhdf/ outputs bands 1 and 2 to the LAS image file out_image1.img. Band 7 is processed and output to out_image2.img.
The input ASTER HDF image file pg-PR1B0000-2000070302_190_001 located in directory /sg1/csb/las/asterhdf/ is output to the LAS image file out_image.img. All bands in the input image are processed and all bands are windowed in projection units of upper left corner (line/sample) = 6200017.604/652244.230 and lower right corner (line/sample) = 6179607.414/667882.103
The input ASTER HDF image file pg-PR1B0000-2000070302_190_001 located in directory /sg1/csb/las/asterhdf/ is output to the LAS image file out_image.img. All bands that are available for this image are processed according to the lines and samples for each bands resolution. The Visible and Near Infrared bands appears in out_image_vnir.img, the Shortwave Infrared bands appear in out_image_swir.img, and the Thermal Infrared bands in out_image_tir.img. Each output image has a 1000 x 2000 window starting at its starting line of 100 and starting sample of 200.
ASTERHDF2LAS ingests an ASTER HDF image and output this image in the LAS format. This system supports Level 1A, Level 1B, Level 2 and the DEM Level 3 ASTER HDF formats.
File <xxxxx> is not deleted. The user needs to delete that file manually.
History file <xxxxx> was not created. Check the preceding error message for the specific error that occurred.
An error occurred while converting <xxxxx> (either standard parallel 1, longitude or latitude), from degrees to DMS. Check the preceding error message for the specific error that occurred.
The DATASYS environment variable is set to "UNKNOWN".
The starting line from the input WINDOW parameter is invalid. It is reset to 1 and processing continues.
The starting sample from the input WINDOW parameter is invalid. It is reset to 1 and processing continues.
The number of lines is invalid so the lower right corner is reset and processing continues.
The number of samples is invalid so the lower right corner is reset and processing continues.
The tag <xxxxx> (values are either UPPERLEFT, LOWERLEFT, UPPERRIGHT or LOWERRIGHT) was not retrieved. The corner coordinates are set to invalid. Check the metadata and verify that these tags are listed.
The corner coordinates are set to invalid. Check the preceding error message for the specific error that occurred.
The SENSOR TYPE field is not updated with the sensor name in the DDR.
The tag <xxxxx> (values are either projectionparameters, product_metadata or mpmethod) could not be retrieved. Check the metadata information and verify that these tags are listed.
Existing output file names were not checked. Check the preceding error message for the specific error that occurred.
The acquisition date is not updated in the DDR. Check the metadata information and verify if this tag is listed.
The capture date is not updated in the DDR. Check the metadata information and verify if this tag is listed.
An unsupported projection was retrieved from the metadata. The LAS projection is set to geographic.
The user requested to process a band that does not exist in the HDF file.
There was a problem terminating access to the HDF Scientific Data Set
(SD) interface in file <xxxxx>.
Unable to close <xxxxx>.
The DDR was not updated and does not contain the metadata information. Check the preceding error message for the specific error that occurred.
The SENSOR TYPE field is not updated with the sensor name in the DDR.
The acquisition month is not added to the DDR.
The subdirectory <xxxxx> created by this application was not deleted. The user needs to delete that subdirectory manually.
The error message that is displayed immediately preceding this message is the specific error that occurred. Processing is terminated.
An error occurred while writing the BDDR to disk. Check disk space. If the error persists, contact the system administrator.
An error occurred while converting the window coordinates to line/sample. Check the preceding error message for the specific error that occurred.
The user specified invalid window values in the WINDOW parameter. Re-specify the WINDOW values and re-run.
Check to see if the output file exists and its file permissions.
The band numbers are used to assign the output extension. Check the metadata for the PROCESSEDBANDS tag and verify the band numbers.
The intermediate filetable.temp file was not created. Check the preceding error message for the specific error that occurred.
Check the filetable.temp file and verify that the HDF logical id's 10100, 10252, 10308 are listed.
Check the filetable.temp file and verify if the file id 10308 is listed.
Check the metadata information and verify that the tag SHORTNAME is correct and exists.
Check the metadata information and verify that the tag PROCESSEDBANDS is valid and exists.
An error occurred from the routine nonexisting_bands. Check the preceding error message for the specific error that occurred
The tag SHORTNAME is used to generate the data set name. Check the metadata information and verify if this tag is correct and exists.
The projection distance is set by the band numbers. Check the metadata information for the tag PROCESSEDBANDS and verify that it exists and is valid.
An error occurred in the routine final_output_names. Check the preceding message for a specific error that occurred.
Check the file permissions for the HDF file <xxxxx>.
The output file <xxxxx> already exists. Either delete the file or re-specify the OUT parameter name.
This data type is not supported.
An error occurred while retrieving the <xxxxx> metadata. Check the preceding for a specific error that occurred. The values of <xxxxx> are either Level 1, Level 3 DEM or Level 2.
The user entered the same band more than once. Re-specify the BANDS parameter.
Double check the NBANDS and BANDS. Since NBANDS groups the specified BANDS into groups, the sum of all the groupings in NBANDS must equal the total number of BANDS.
Double check the OUT and NBANDS parameters. There must be an output file specified for each of the values in NBANDS.
If the UNITS field is either DEG, DMS or PRO then the WINDOW parameter must have 4 values.
If the UNITS field is LS then the WINDOW parameter must have either 2 or 4 values.
An error occurred while converting the window parameters. Check the preceding message for a specific error.
There was an error allocating memory for the data buffers. If the error persists contact the system administrator.
An error occurred while opening the output file <xxxxx>. Check the output file name and the file permissions.
An error occurred while writing the DDR to disk. Check disk space. If the error persists, contact the system administrator.
An error occurred while retrieving the DDR file. Check if the DDR file exists on disk and check the file permissions.
An error occurred while opening the HDF file <xxxxx>. Check the input HDF file name and the file permissions.
An error occurred while deleting the output file <xxxxx> which was created by this application. Check the output file permissions.
Check the projection code in the HDF metadata The supported projections are either GEO, UTM, LAMCC, PS, EQRECT or SOM.
The DELFLG was set to "YES" and this application was unable to delete the output .img file. The file need to be deleted manually. Check the permissions of the .img file.
An error occurred while trying to retrieve the file attribute name which is used to retrieve projection information. Contact the LAS administrator.
An error occurred while trying to create the subdirectory <xxxxx> which is used to store the temporary files created by this application. Check disk space and permissions.