Utility to read Fast Format tapes, CDs, and diskfiles. File formats supported by this routine include EOSAT Fast-A, EOSAT Fast-B, EROS Data Center Fast-C, Space Imaging Fast-C, and Fast-L7A. The Space Imaging Fast-C and Fast-L7A formats are not supported on tape.
Reads Thematic Mapper (TM) images from Fast Format tapes, CD, or disk and writes them to LAS image files. File formats supported by this routine include EOSAT Fast-A, EOSAT Fast-B, EROS Data Center Fast-C, Space Imaging Fast-C, and Fast-L7A. The Space Imaging Fast-C and Fast-L7A formats are not supported on tape. If the user does not specify separate output files, then all bands are written to the same output file.
- COMMENT(--)
- Description of tape(s) or CD(s). A text string sent to the operator's terminal. The operator uses this text to find the tape(s) or CD(s) to be mounted. Therefore, COMMENT should be as descriptive as possible. It should include both the ID number and a short description which allows the operator to ensure the correct media is mounted. If multiple media are specified the user must specify them so that the image data is in band sequential order. These comments should be comma-separated and one comment for each tape or CD to mount. For example, COMMENT=("Please mount CD1/4", "Please mount CD2/4", "Please mount CD3/4", "Please mount CD4/4") If the source media is disk, leave this field blank.
- INFILE(--)
- The full host pathname of the input image on disk. If the source MEDIA is CD, this field may be left blank or it may be used to specify the basename of the imagery desired. If the source MEDIA is tape, leave this field blank.
- OUT
- Output image(s). 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.
- MEDIA(--)
- Indicates the type of source media when not processing from disk.
= CD = TAPE
- BANDS(--)
- Band numbers. List of band numbers to be placed into the LAS image(s). The default indicates that all available bands will be processed. For Fast-ABC on tape, the bands should be stored in ascending order on tape. If this is not the case, then FSTFMTIN cannot guarantee the correct output.
- NBANDS(--)
- NBANDS specifies how the bands in the BANDS parameter should be grouped together when creating the output files. For example, if BANDS=(1,3,2,4) and NBANDS=(2,1,1), three output files will be created with the first output file containing bands 1 and 3, the second containing band 2, and the third containing band 4. If NBANDS is specified, BANDS must be specified and the number of bands in BANDS must equal the sum of the bands in NBANDS. Also the number of NBANDS entries must match the number of entries in OUT. When processing data on tape, the bands MUST be processed in ascending order when using NBANDS. For example, BANDS=(1,2,3,4) with NBANDS=(2,2) or BANDS=(1,3,5,6) with NBANDS=(3,1) are both valid, but BANDS=(1,3,2,5) with NBANDS=(2,2) or BANDS=(1,5,3,2) with NBANDS=(3,1) are both not valid. The reason for this is that once a band has been read (or skipped over), the tape must be rewound to read a previous band. In the case of BANDS=(1,3,2,5) with NBANDS=(2,2), bands 1 and 3 are read and written out to the output file. The tape would then have to be rewound to process band 2, since band 3 has already been processed. Given the current logic in this application and the fact that rewinding and forwarding a tape is very time consuming during processing, the aforementioned stipulation has been made when specifying BANDS and NBANDS.
- WINDOW(--)
- 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. 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 for the WINDOW parameter.
= LS: Line/Sample = DEG: Degrees = DMS: Degrees Minutes Seconds (+DDDMMMSSS.SS) = PRO: Projection coordinates
- ODTYPE(SAME)
- Output data type. The data type of the output images.
= SAME: Same as input = BYTE: BYTE (8-bit unsigned integer) = I*2: INTEGER*2 (16-bit signed integer) = I*4: INTEGER*4 (32-bit signed integer) = R*4: REAL*4 (32-bit signed real)
- HDRFLG(YES)
- Header flag. The Fast Format header is saved as an associated file for the image(s) if this parameter is set to YES. The file extension for this file is "fhdr" ("fst" for Fast-L7A).
= YES: Create an associated file for the image from the Fast Format header. = NO: Do not create an associated file.
This example will read the EOSAT Fast Format file from
disk. It will process only bands 1, 2, 3 (if they are
available) and output them to 'outfile'. The output data
type will default to the same data type as the input image
since ODTYPE has not been specified. An associated file
called 'outfile.fhdr' will be created containing the
associated Fast Format header.
This example will read the Fast-L7A formatted files from
disk. It will process all available bands for this image
(visible, thermal, and pan) and output them to 'outfile'.
Since this is possibly a multi-resolution image, the bands
will be separated according to their headers. All the
visible bands will be output to 'outfile_vis', the thermal
bands to 'outfile_thm', and the pan bands to 'outfile_pan'.
An associated DDR will be produced for each different
resolution. The output data type will default to the
same data type as the input image since ODTYPE has not
been specified.
This example will read the image files from CD. It will
process bands 1, 5, 6L, and 8, if they are available. From
the NBANDS parameter, bands 1 and 5 will be processed and
output to '/sg1/csb/output/o1'. Bands 6L and 6H will be
output to '/sg1/csb/output/o2', and band 8 will be output
to '/sg1/csb/output/o3'. The output data type will default
to the same data type as the input image since ODTYPE has
not been specified. An associated file called 'outfile.fhdr'
will be created containing the associated Fast Format header.
This example will read the Fast-L7A formatted file from CD.
Since the bands are not specified, all available bands on
each CD will be processed. Since no INFILE was specified,
FSTFMTIN will search the CD and ingest the first image that
is found. Each CD is then searched for a visible, themal,
and pan header file and the available files are processed to
their appropriate output file 'outfile_vis', 'outfile_thm',
or 'outfile_pan' (outfile has already been modified to reflect
the path and basename if necessary). Since projection units
were specified for the window, each band will be subwindowed
to the specified window. The output data type will be byte data.
This example will read the EOSAT Fast Format file from CD.
Bands 1 and 7 will be subwindowed using the specified window
and output to 'o1'. Bands 2 and 5 will be subwindowed and
output to 'o2', and band 3 will be subwindowed and output
to 'o3'. Note that even though the user specified bands
7 and 1 for the first output image, the bands will be sorted
and therefore output as bands 1 and 7. The output data
type will default to the same data type as the input image
since ODTYPE has not been specified. An associated file
called 'outfile.fhdr' will be created containing the
associated Fast Format header.
This example will read the EOSAT Fast Format tapes starting with N0316 and ending with the tape that contains band 3. It will create an image file called 'outfile' that contains bands 1 and 3. Only the data within the window specified by WINDOW will be read for each band. Since the UNITS for the window were not specified, the window units will default to LS (line/ sample). The output data type will default to the same data type as the input image since ODTYPE has not been specified. An associated file called 'outfile.fhdr' will be created containing the Fast Format header from the tape.
FSTFMTIN will read the requested bands from tape, CD, or disk. If the image is to be ingested from tape or CD, FSTFMTIN will mount the specified tapes in order looking for the requested bands. For each line and band to be read, the image data is extracted and written to the appropriate LAS image. If the user specifies to subwindow the image, the subwindow is extracted for each band and written to the appropriate LAS image. If an error is encountered, the current tape or CD is dismounted if necessary and the application terminates. Each Fast Format media will contain a header file (or header files) and one or more bands. The header is an ASCII file containing information about the bands present on the media, the image size, projection parameters, scene corner points, satellite number, and instrument type.
* [fstfmtin-bands] Band <x> was not found for processing
Band <x> (of the user-specified bands) was not found on any of the tapes/CDs/diskfiles. This band was not processed, but all other existing bands were processed as specified.
* [fstfmtin-datum] Datum field is not available in the header
The datum field is not available in the header file. The DDR will not be updated for this field.
* [fstfmtin-datum] Unknown ellipsoid value
The datum value in the header is unknown. See the valid datum values in the LAS appendix. * [fstfmtin-datum] Walbeck ellipsoid is not supported
The Walbeck ellipsoid is no longer supported by LAS.
* [fstfmtin-ddr] Unable to update DDR
The Fast Format Header did not have sufficient information to update the ddr. The missing portion of the header was indicated in the preceding message. If the tapes are verified to be Fast Format tapes and a valid header was expected (See User Note 3), contact the system administrator.
* [fstfmtin-hfield] Missing <xxxx> in Fast Format Header A <xxxx> field in the Fast Format header was blank. The DDR will not be updated. Make sure the specified images are either Fast-A, Fast-B, Fast-C, Space Imaging Fast-C, or Fast-L7A Format files. * [fstfmtin-history] Error updating the image history
An error occurred trying to update the history file for this image. Processing will continue.
* [fstfmtin-idtype] Input data type is assumed to be of type byte
For Fast-A, Fast-B, and Fast-C formats, the input data type is not available in the header file. The input data type of these images are assumed to be of type BYTE.
* [fstfmtin-number] Too many (or too few) <xxxx> specified
Too many lines/samples were specified. The window size is reset to include all of the remaining lines/samples. If the window size is less than one, then it is also reset to include all of the remaining lines/samples. * [fstfmtin-spheroid] Error parsing <xxxxx>
An error occurred while trying to parse the spheroid buffer <xxxxx>. Processing will continue.
* [fstfmtin-alloc] Error allocating dynamic memory
An error was detected while trying to allocate dynamic memory. If the error persists contact the system administrator.
* [fstfmtin-bands] The count of BANDS must be the same as the count of OUT
If BANDS are specified, more than one OUT file is specified, and NBANDS are not specified, then the program outputs one band per output file. Thus the number of output files must equal the number of bands. * [fstfmtin-bands] Error in bands specified for the DDR
The number of bands in the list must be the same as the number of bands in the DDR.
* [fstfmtin-bddr] Error writing dummy BDDR
An error occurred writing out the dummy BDDR. This BDDR is required for converting the window parameters to line/sample coordinates.
* [fstfmtin-cdread] Error reading from CD
An error was encountered reading from CD, either while trying to open an expected input file or while reading data from one of those files. Verify that the CD is valid and that INFILE was entered correctly. * [fstfmtin-cmhost] Error returned from cmhost
An error was returned from c_cmhost.
* [fstfmtin-comment] COMMENT must be specified
To ingest images from CD or tape the COMMENT field is required so the operator will be notified to mount the proper media.
* [fstfmtin-convert] Error converting to packed DMS units
An error occurred while attempting an internal data conversion. See the LAS system manager.
* [fstfmtin-convertwindow] Error processing the header
An error occurred while processing the input header file. Thus the input window is not able to be converted to line/sample coordinates.
* [fstfmtin-datum] Datum value is not available
The datum value is not available thus the window coordinates in DEG, DMS, and PRO cannot be converted to line/sample coordinates.
* [fstfmtin-datasys] DATASYS environment variable not set
The DATASYS environment variable was not set. This environment variable is required to convert the window parameter to line/sample.
* [fstfmtin-ddr] Error writing dummy DDR
An error occurred writing out the dummy DDR. This DDR is required for converting the window parameters to line/sample coordinates.
* [fstfmtin-diskread] Error reading from disk
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 valid and that INFILE was entered correctly.
* [fstfmtin-dkdel] Error deleting the dummy DDR
An error occurred while deleting the dummy DDR. The same dummy DDR name will be used for the next resolution imagery.
* [fstfmtin-dms] Unexpected exponent <xx> found in DMS field
Degrees, Minutes, Seconds fields are assumed to have exponents in the range from 0 to 7. FSTFMTIN found an exponent with the value of <xx>. See the LAS system manager.
* [fstfmtin-dmslen] DMS field length is <xx>, expecting 24
Degrees, Minutes, Seconds fields are assumed to be 24 characters long. FSTFMTIN found one with <xx> characters. The conversion between GCTP formats will fail. See the LAS system manager.
* [fstfmtin-exists] Error: <XXXXX> currently exists
The file <XXXXX> already exists. Either remove this file, or change the name of the output image.
* [fstfmtin-fatal] Fatal error encountered
A fatal error was encountered during processing. The error message that is displayed immediately preceding this message is the specific error that was encountered.
* [fstfmtin-fhdfld] Error reading <xxxxx>
An error occurred in c_fhdfld when trying to read <xxxxx>.
* [fstfmtin-fhdrrd] Error reading <xxxxx>
An error occurred in c_fhdrrd when trying to read <xxxxx>.
* [fstfmtin-getddr] Error retrieving the DDR
An error occurred while retrieving the DDR file.
* [fstfmtin-hdrnum] An excess of 10 images was found on the CD
The maximum number of images that will be processed from CD when the user does not specify the basename (INFILE) is 10. There were more than 10 images found on this CD. Please specify the image to process with the INFILE parameter.
* [fstfmtin-header] Header file does not contain 1,536 bytes Fast Format header files contain 1,536 bytes. The first file on this tape does not contain exactly 1,536 bytes. Make sure that the specified tapes are EOSAT Fast Format tapes.
* [fstfmtin-header] Unable to open specified header
The input header was not able to be opened. Verify that the header is valid and that it contains the correct number of bytes. Fast-A, Fast-B, and Fast-C headers need to be 1,536 bytes long, while Fast-L7A and Space Imaging Fast-C headers need to contain three 1,536-byte records.
* [fstfmtin-header] Unknown header type
The input header is not a Fast-A, Fast-B, Fast-C, Space Imaging Fast-C, or Fast-L7A header. Verify that the header file is of the correct format.
* [fstfmtin-hfield] Missing <xxxxx>
The <xxxxx> field was not available in the header file.
* [fstfmtin-host] Error retrieving the host image name
An error occurred while trying to input the host image name from TAE.
* [fstfmtin-hostname] Error reading the hostname
An error occurred trying to read the hostname via gethostname.
* [fstfmtin-integer] Error passing <xxxxx> to TAE
An error occurred passing the integer value for <xxxxx> to the TAE block.
* [fstfmtin-L7Atape] Fast-L7A formatting cannot be read from tape
FSTFMTIN is not set up to support reading Fast-L7A formatted imagery from tapes. These files may only be read from CDs or from disk.
* [fstfmtin-lastables] $LASTABLES not defined
The LASTABLES environment variable is not defined. This is necessary for processing the spheroid.
* [fstfmtin-lng2tae] Error outputting <xxxxx>
An error occurred while trying to output a long value for the TAE parameter <xxxxx>.
* [fstfmtin-lsmknm] Error returned from c_lsmknm
An error was returned from the call to c_lsmknm. * [fstfmtin-media] Media type could not be determined
Could not determine media type. Either INFILE must be specified when processing from disk or MEDIA must be specified when processing from CD or tape.
* [fstfmtin-nbands] The count of NBANDS must be the same as the count of OUT
There must be an output file specified for each of the values in NBANDS.
* [fstfmtin-nbands] The total bands in NBANDS must add to the count of BANDS
Since NBANDS pairs the specified BANDS into groups, the sum of all the pairings in NBANDS must equal the total number of BANDS.
* [fstfmtin-nbands] Unable to find all of the requested bands
FSTFMTIN was unable to locate all of the requested bands. Make sure all of the tapes in this set have been specified and that they are in sequential order.
* [fstfmtin-open] Unable to open <xxxxx>
An error occurred while opening the file <xxxxx> .
* [fstfmtin-out] Invalid specification of OUT
OUT must specify one disk file to store all of the bands that are to be read or one disk file for each of the bands to be read.
* [fstfmtin-pname] Invalid projection name
Valid projection names are listed in the LAS appendix.
* [fstfmtin-previous] Band <x> is on a previous tape or does not exist.
Band <x> is stored on a previous tape volume of this set. Make sure the tapes are specified in the correct order. In the case of CD or disk and this error is reached, then the file does not exist.
* [fstfmtin-process] Invalid <xxxx> in Fast Format Header A <xxx> field in the Fast Format header was blank or contained an illegal value. Make sure the specified tapes are EOSAT Fast Format tapes.
* [fstfmtin-projection] Map projection number <xx> unknown
Valid map projection numbers are 1 through 21. FSTFMTIN found a map projection number of <xx>. Examine the header file of the tape to see if it contains a valid projection number.
* [fstfmtin-putbdr] Error writing BDDR
An error occurred while writing the BDDR to disk.
* [fstfmtin-putddr] Error writing DDR
An error occurred while writing the DDR to disk.
* [fstfmtin-qout] Error passing variables to TAE An error occurred while attempting to pass variables back to TAE. See the LAS system manager. * [fstfmtin-resolution] Invalid resolution entered
An invalid resolution was passed into this routine. The only valid resolutions are VISIBLE, THERMAL, and PAN.
* [fstfmtin-rtcoef] Error computing the transformation coefficients
An error occurred in c_rtcoef while trying to compute the transformation coefficients.
* [fstfmtin-SICtape] Space Imaging Fast-C formatting cannot be read from tape
FSTFMTIN is not set up to support reading Space Imaging Fastformatted imagery from tapes. These files may only be read from CDs or from disk.
* [fstfmtin-sscanf] Error retrieving <xxxxx> from header file An error occurred while retrieving the variable <xxxxx> from the header file on tape. See the LAS system manager.
* [fstfmtin-start] Starting <xxxxx> must be less than <yyyyy>
Starting line/sample must be less than <yyyyy>, where <yyyyy> is the number of lines/samples in the image. Use another starting line/sample in the range 1 - <yyyyy>.
* [fstfmtin-str2tae] Error outputting <xxxxx>
An error occurred while trying to output a string value for the TAE parameter <xxxxx>. * [fstfmtin-taevar] Error passing <xxxxx> to TAE
An error occurred while trying to pass the variable <xxxxx> from the application to TAE. See the LAS system manager.
* [fstfmtin-tpopen] Error opening <xxxxx>
An error occurred trying to open the file on <xxxxx>.
* [fstfmtin-tpreop] Error reopening <xxxxx>
An error occurred trying to reopen the file on <xxxxx>.
* [fstfmtin-tpclos] Error closing <xxxxx>
An error occurred trying to close <xxxxx>. * [fstfmtin-trans] Error converting the <xx> coordinate
An error occurred in c_trans trying to convert the <xx> corner coordinate from latitude/longitude to projection x/y.
* [fstfmtin-transinit] Error initializing the geometric registration routines
An error occurred in c_transinit trying to initialize the geometric registration routines.
* [fstfmtin-version] Fast Format version <x> unknown
Version <x> is an invalid version for Fast Format tapes/CDs. Valid Fast Format versions are Fast-A, Fast-B, Fast-C, Space Imaging Fast-C, and Fast-L7A. Make sure the specified tapes/CDs are of the correct formats supported by FSTFMTIN.
* [fstfmtin-window] Invalid window specified
The starting line and sample must be specified in the WINDOW parameter, if any values are specified. If more than 2 values are specified, then all the values must be specified. If a UNITS value other than LS is specified then both the UL and LR corner points must be specified for the WINDOW.
* [fstfmtin-window] Window must contain 4 parameters
The WINDOW passed to this PDF file must contain 4 parameters, upper left (y/lat, x/long) and lower right (y/lat, x/long).
* [fstfmint-wndchk] Error checking the window coordinates
An error occurred while checking the window coordinates and verifying they are valid for the input image.
* [fstfmtin-wndconv] Error converting window coordinates
An error occurred converting the window coordinates to line/sample coordinates.
* [fstfmtin-zone] Illegal zone number <xxxx>, for projection <yyyy>
FSTFMTIN found zone number <xxxx> for the projection type <yyyy>. This is an illegal zone number for this projection. See the LAS system manager.
* [fstfmtin-zonenum] Error getting the zone code
An error occurred while reading the zone code.
As another example, assume that we have the same tapes and want to read bands 2 and 3. The user may specify all three tapes but only needs to specify the first tape.
The same goes for CDs. The user needs only to specify the CDs that are necessary for processing.
The user may save a significant amount of time by only specifying the required tapes. However, the easiest approach is to specify all of the tapes in the set and let FSTFMTIN automatically locate the requested bands.
<infile>_band<band#>.dat Image data files
<infile>_header.dat Image header file
<band#> is the number of the band in the file.
Valid band numbers range from 1 to 7
For these formats on CD or disk, a basename is prefixed to the band or header file. The basename must be specified in the INFILE parameter when ingesting images from disk.
<infile>_<band#>.fst Image data files
<infile>_hrf.fst Visible band header file
<infile>_htm.fst Thermal band header file
<infile>_hpn.fst Pan band header file
<band#> is the number of the band in the file.
Valid band numbers range from 1 to 8 and the thermal bands are 61
and 62 for bands 6L and 6H, respectively.
Alternatively, INFILE may be used to specify the basename of the desired imagery to ingest. The filename will be modified if the image specified is found in a directory other than the root directory: outfile_path_to_subdir Image found in a subdirectory
If the first directory that is found to contain imagery data contains multiple images and no basename is specified, all images in that directory will be processed and the filename will be modified to indicate the path to the images as well as the image basenames: outfile_basename1, outfile_basename2 Images found in root directory outfile_path_to_subdir_basename1, Images found in a subdirectory outfile_path_to_subdir_basename2
Unless a CD contains multiple images, there is no need for the user to supply an INFILE basename.