Reads LTWG full-scene formatted images.
Reads LTWG (Landsat Technical Working Group) full scene images and SAR (Synthetic Aperture Radar) 8-bit imagery from tape, CD or disk and creates LAS images. All of the bands are written to one image or each band may be written to its own image. The existing image may be windowed or subbanded when copied. Ancillary files may also be written to disk.
- COMMENT(-- )
- Description of tape(s) or CD(s). A text string sent to the operator's terminal describing the tape(s) or CD(s) to be mounted. COMMENT should contain the tape/CD library identification number and a short description of the media. This will allow the operator to ensure the correct media is mounted. If the source media is disk, leave this field blank. See User Notes 2 and 3.
- INFILE(-- )
- The full host pathname of the input image on disk. If the source media is tape or CD, leave this field blank. If COMMENT is specified as well as INFILE, the mounting comment will take precedence and be used to ingest from tape and INFILE will be ignored. Depending on the ground station and/or image format, this may be either a directory or a root filename.
- DIRNUM(--)
- Number of the scene to ingest (directory number). This should only be used when processing from CD. If COMMENT is specified as well as DIRNUM, the mounting comment will take precedence and be used to ingest from tape and DIRNUM will be ignored. If there is only one scene on the CD, it is not necessary to provide a value for this parameter. If multiple scenes are on the CD, the user may use this parameter to specify the number of the directory which contains the file they wish to ingest (which scene). See User Note 9.
- OUT
- Output image(s). OUT defines up to seven LAS images. The number of images specified in OUT must either be one or equal to the number of bands specified in BANDS. If only one output image is specified, all of the bands will be written to that image. The size of the output image(s) is determined by information from the leader file or the values specified in WINDOW and BANDS. The output data type is BYTE.
- WINDOW(--)
- Window specification. Specifies the starting line, starting sample, number of lines, and number of samples to be processed. The default indicates that the entire image will be processed.
- BANDS(--)
- Band number(s). The image bands to be processed. The default indicates that all bands present are processed. See User Note 4.
- WRTDSK(LEAD)
- Write to disk. Specifies which associated files/or records are to be copied from the media. These files are associated with the output image with the specified extensions. Any combination of these files may be specified.
= VDF: Volume Directory file. The volume directory file is written to "<xxxxx>;vdf". = LEAD: Leader file. The leader file is written to "<xxxxx>;lead". = TRAI: Trailer file. The trailer file is written to "<xxxxx>;trai". See User Note 3. = SUPP: Supplemental file. The supplemental file is written to "<xxxxx>;supp". See User Note 3. = IDR: Image Data Records. The image file descriptor record and the prefix and suffix data from each image line are written to "<xxxxx>;idr".
The tape bb0707 is mounted on a drive. The user has specified that a 1024x1024 window be copied from tape starting at line 100, sample 100. Only bands 2 and 4 will be copied to TAI.IMAGE. By default, the leader file will be copied to the disk. Because the trailer and supplemental files are not being copied, only those tapes that contain bands 2 and 4 (bb0707 and bb0705) need to be specified.
LTWGIN reads image data from the directory /sg2@cd1/scene11 and creates a LAS image in the current directory. Since no window or band specifications are provided, the entire image will be copied. LTWGIN will also copy the image leader, trailer, supplemental, and volume directory files.
The tape 119567 is mounted on a drive. Band 1 will be copied to band1 and band 3 will be copied to band3. Since no window or band specifications are provided, the entire image will be copied. By default, the leader file will be copied to the disk.
CD3825 will be mounted on a drive. The imagery contained in the fourth directory (Scene4) will be ingested. Since no window or band specifications are provided, the entire image will be copied to the output image "IMG1.img". By default, the leader file will be copied to the disk.
CD3825 will be mounted on a drive. Since no directory number was specified for which scene to ingest, scene 1 will be ingested. Since no window or band specifications are provided, the entire image will be copied to the output image "IMG2.img". By default, the leader file will be copied to the disk.
LTWGIN begins by opening the media if the image is to be ingested from tape or CD. If the image data is in a CD or standard disk directory, the filenames in that directory are scanned so that LTWGIN can determine which file naming convention is being used. The volume directory file (VDF) and the leader file are read to obtain necessary processing information, i.e., band format, record size, etc.. These files are written to disk if requested, will be associated with the first output LAS image, and will have the extensions ";VDF" and ";LEAD".The image file descriptor record is then read to obtain image size, band count, data type, blocking factor, and the number of prefix and suffix bytes within each image line. This record is written to disk if requested, will be associated with the first output LAS image, and have the extension ";IDR".
The output LAS image(s) are created and opened for writing. For each line and band to be read, the image data is extracted from the physical tape record or CD/disk file and written to disk. If specified, the image data suffix and prefix data for each image line is written to disk in the ";IDR" file.
Once all the requested image data is read, the trailer and supplemental files are copied to disk if they were requested. These files will be associated with the first output LAS image and will have the extensions ";TRAI" and ";SUPP". If the image is being read from tape, the third tape is mounted if necessary to read these files.
The band entered in BANDS does not exist in the image. Processing will continue with the remaining bands being copied from the image.
SPOT scenes created by the Sweden receiving station only have three bands instead of the seven expected for LGSOWG data.
South Africa CDs and Canadian and Japanese MSS data only have four bands instead of the seven expected for LGSOWG data.
The image did not contain map projection information. The corners of the image will be approximated. See User Note 5.
A nonfatal error was encountered during processing. The error message displayed immediately preceding this message is the specific error encountered. Processing continues.
The image did not contain projection information or the projection is not currently handled by LTWGIN. The image will be created with an invalid DDR. Contact the LAS system administrator.
The specified media did not contain a supplemental file and WRTDSK specified that one should be written to disk. Processing continues.
LTWG data created by the Thailand receiving station is missing the supplementary data file. Unable to write the requested file to disk.
The specified window is larger than the image data on the media. The window has been reset to be the intersection of the window specification and the actual image.
The Station ID was not recognized, CANADA was assumed.
There was an error reading the imagery data from tape. The tape format does not agree with the format expected by ltwgin.
An error occurred while attempting to use sscanf to retrieve the indicated value from the leader file. Certain DDR fields may not be able to be filled in due to this value being unavailable.
The indicated leader file record was not present. Certain DDR fields will not be able to be filled in due to the missing record.
The user did not specify which scene to ingest from the given CD, which contains multiple scenes. Defaulting to scene 1. More information can be found in User Note 9.
An error occurred allocating memory. Re-run, and if the error persists, contact the LAS system administrator.
The next tape in the volume is needed to continue processing. Enter all the tape IDs of the tape set in COMMENT and re-run.
An error was encountered reading from disk, either while trying to open an expected input file or while reading data from one of those files. Verify that the disk or CD is good and conforms to one of the supported directory formats.
The data type of the image is not currently handled by LTWGIN. Only BYTE is currently handled. Contact the LAS system administrator.
A fatal error was encountered during processing. Processing is terminated. The error message displayed preceding this message is the specific error encountered.
Certain data from Sweden receiving station, with "Sweden" (vs "Kiruna" which has also been encountered, but is not SPOT data) in the generating country identification string, and from France, with "France" in the id string, in the VDF file is assumed to be SPOT data, since this is true for the data encountered. Assumptions are made throughout the code that all data matching these criteria is SPOT data. If data with one of those id strings who's satellite name is not SPOT is encountered, it cannot be processed.
An error was encountered reading from tape. Verify that the tape is good and conforms to the LTWG tape format.
An error was encountered skipping to the correct location on the tape. Verify that the tape is good and conforms to the LTWG tape format or re-run and do specify a window.
No bands specified in BANDS were available in the input image. Respecify BANDS and re-run.
If more than one output image is specified, the number of output images must equal the number of bands specified. Respecify OUT and/or BANDS so that the number of output images is equal to the number of bands specified if one band per image is desired, otherwise specify only one OUT image.
The map projection used for the image is not currently supported by LAS. The image cannot be ingested using ltwgin.
The number of leader file records reported by the leader file descriptor record does not match the number of leader file records reported by the VDF file. The data is invalid and cannot be ingested by ltwgin.
The number of trailer file records reported by the trailer file descriptor record does not match the number of trailer file records reported by the VDF file. The data is invalid and cannot be ingested by ltwgin.
There was an error encountered when using c_getfiles to retrieve the filenames on disk or CD. Verify the filenames follow the expected format.
There was an error encountered when writing to the trailer file. Verify all files are present and follow the expected format.
The Radarsat data products are not fully supported yet. If the user sees this error message, the code erroneously determined that Radarsat data is being ingested. Contact the LAS system administrator.
There was an error encounted when mounting the media. Try again and, if the problem persists, contact the LAS system administrator.
The directory name of the scene selected, or the directory name for the default of scene 1 was not able to be identified on the CD. Refer to the previous error message for more details of what caused the error.
The specified scene or, if user did not specify which scene to ingest, the default scene 1 was not found on CD. Verify the CD follows the expected format for the scene directories. If the CD contains NLAPS Level 0 data as produced by PDS, this data is not supported yet; contact the LAS administrator.
The CD drive returned from the mount was a local drive. In order to read from the drive, the host name of the machine the drive is on must be determined. The host name could not be retrieved and processing cannot continue. Try running again on another drive and contact the LAS administrator if the problem persists.
The CD was searched for scene directories and none were found. Verify the directory layout on the CD follows the expected format.
Documents of the LANDSAT-D CCT Standards Committee Presented to the LANDSAT Ground Station Operators Working Group, Draft, August 15, 1978.
LANDSAT Technical Working Group, Format for the Thematic Mapper CCT, EOSAT, January 1, 1990.
SPOT Image Corporation, Abbreviated CCT Document, February 9, 1990.
Synthetic Aperture Radar (SAR) Data Products Format Standard, CEOS-SAR-CCT, March 10, 1989.
RADARSAT Data Products Specifications, RSI-GS-026, November 7, 1997.