User's Guide

FSTFMTIN

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.

Function:

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.

Parameters:

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.

Examples:

  1. LAS> fstfmtin infile="[sg1.csb2.las.eosatcd]" out=outfile bands=(1,2,3)

    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.

  2. LAS> fstfmtin infile="[sg1.csb2.las.l7]l71041036_03619920924" out=outfile hdrflg=no

    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.

  3. LAS> fstfmtin media=cd infile="lt5004047008502110" out=([sg1.csb.output]o1,[sg1.csb.output]o2,[sg1.csb.output]o3) bands=(1,5,6,9,8) nbands=(2,2,1) hdrflg=yes

    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.

  4. LAS> fstfmtin media=cd out=outfile units=pro odtype=byte comment=("please mount fast-l7a cd1/4", "please mount fast-l7a cd2/4", "please mount fast-l7a cd3/4", "please mount fast-l7a cd4/4") window=(4354290.000,588000.001,4320690.000,650400.002)

    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.

  5. LAS> fstfmtin media=cd out=(o1,o2,o3) bands=(7,1,2,5,3) nbands=(2,2,1) hdrflg=yes comment=("please mount fast-l7a cd1/4", "please mount fast-l7a cd2/4", "please mount fast-l7a cd3/4", "please mount fast-l7a cd4/4") window=(39.33356,-121.97894,39.02233,-121.26262) units=deg infile="l71044034_03419990707"

    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.

  6. LAS> fstfmtin media=tape comment=("please mount n0316", "please mount n0317", "please mount n0318") out=outfile bands=(1,3) window=(50,50,100,100)

    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.

Description/Algorithm:

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.

Nonfatal Error Message:

    * [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.

Fatal Error Messages:

    * [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.

User Notes:

  1. Tapes are not supported for Fast-L7A and Space Imaging Fastformats.

  2. There is no need to specify more tapes than are necessary to locate all of the requested bands. For example, assume tape T123 contains bands 1, 2, and 3, tape T456 contains bands 4, 5, and 6 and that tape T007 contains band 7. To read bands 5 and 7 the user could specify all three tapes or just tapes T456 and T007. In the first case FSTFMTIN will mount tape T123 and determine that band 5 is not located on that tape, immediately dismount the tape and move on to T456.

    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.

  3. Tapes/CDs have been received where necessary projection parameters in the Fast Format Header are missing. In this case, the projection parameters are set to 0.0. If the datum is also not available, then it too will be invalid. An invalid datum will not allow the user to subwindow a product.

  4. When a Fast-A, Fast-B, or Fast-C image is read from disk, it is assumed that the input image is of type BYTE.

  5. Naming conventions are as follows for Fast-A, Fast-B, Fast-C Format files on disk:

            <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.

  6. Naming conventions for Space Imaging Fast-C Format files on disk and CD are the same as the above listed Fast-A, Fast-B, and Fastexcept the <band#> in the filename is not based on the band number itself. The <band#> in the filename is instead based on that band's place in the header file. For example, if band 3 is listed as the second band in the header file, then its filename will be band2.dat (NOT band3.dat as for Fast-ABC formats).

  7. Naming conventions are as follows for Fast-L7A files on disk and CD:

            <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.
    
  8. When ingesting images from CD, the INFILE parameter may be left blank and the imagery files will be located on the CD automatically. In this case, the filename will be modified to contain the basename of the image found as well as the path to the directory the image was found in if not the root directory: outfile_basename Image found in root directory outfile_path_to_subdir_basename Image found in a subdirectory

    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.

  9. When processing Fast-L7A images, the bands will be separated according to their header file. Thus the visible bands will be processed together and their filename will have a '_vis' extension, the thermal bands will have a '_thm' extension, and the pan bands will have a '_pan' extension. These extensions will follow any path and/or basename references that have been appended (See User Note 8).

  10. For multi-volume processing, the files for each CD are processed and output to a file with an _vol# extension. After all CDs are processed these multiple volumes are copied together into one final image as specified by the input parameters.

  11. When windowing a multi-resolution (Fast-L7A) image, it is recommended that the user specify the window coordinates in PRO, DMS, or DEG. If the window coordinates are specified in LS, the results will not be the same for each resolution. A specific line/sample in a 30m resolution will be in a different place on the image than the same line/sample in a 15m resolution.
  12. For Fast-L7A, if the user wants to process band 6L then band '6' needs to be specified in the BANDS parameter. To process band 6H, band '9' should be entered in the BANDS parameter.

  13. For further information on the FSTFMTIN format, consult the EOSAT Fast Format Document for TM Digital Products Version B, December 1, 1993 or the IRS-1C Digital Data Products Format for Revision C Fast Format Products, January 5, 1997 or the Fast-L7A DFCB Volume 5, Book 2, Revision 3, May 1999.