EVOLUTION-MANAGER

Edit File: frmt_fast.html

<html>
<head>
<title>FAST -- EOSAT FAST Format</title>
</head>

<h1>FAST -- EOSAT FAST Format</h1>

Supported reading from FAST-L7A format (Landsat TM data) and EOSAT Fast Format
Rev. C (IRS-1C/1D data). If you want to read other datasets in this format (SPOT),
write to me (Andrey Kiselev, <a href=mailto:dron@ak4719.spb.edu>dron@ak4719.spb.edu</a>).
You should share data samples with me.

Datasets in FAST format represented by several files: one or more
administrative headers and one or more files with actual image data in raw
format. Administrative files contains different information about scene
parameters including filenames of images. You can read files with
administrative headers with any text viewer/editor, it is just plain ASCII
text.

This driver wants administrative file for input. Filenames of images will be
extracted and data will be imported, every file will be interpreted as band.

FAST-L7A consists form several files: big ones with image data and three
small files with administrative information. You should give to driver one
of the administrative files:

<ul>
<li>L7fppprrr_rrrYYYYMMDD_HPN.FST: panchromatic band header file with 1
 band
<li>L7fppprrr_rrrYYYYMMDD_HRF.FST: VNIR/ SWIR bands header file with 6
 bands
<li>L7fppprrr_rrrYYYYMMDD_HTM.FST: thermal bands header file with 2 bands
</ul>

All raw images corresponded to their administrative files will be imported
as GDAL bands.

From the ``<a href=http://ltpwww.gsfc.nasa.gov/IAS/pdfs/DFCB_V5_B2_R4.pdf>
Level 1 Product Output Files Data Format Control Book</a>'':
<tt>
The file naming convention for the FAST-L7A product files is
 
L7fppprrr_rrrYYYYMMDD_AAA.FST 
 
where 
 
L7 = Landsat 7 mission 
 
f = ETM+ format (1 or 2) (data not pertaining to a specific format defaults to 1) 
 
ppp = starting path of the product 
 
rrr_rrr = starting and ending rows of the product 
 
YYYYMMDD = acquisition date of the image 
 
AAA = file type: 
HPN = panchromatic band header file 
HRF = VNIR/ SWIR bands header file 
HTM = thermal bands header file 
B10 = band 1 
B20 = band 2 
B30 = band 3 
B40 = band 4 
B50 = band 5 
B61 = band 6L 
B62 = band 6H 
B70 = band 7 
B80 = band 8 
 
FST = FAST file extension 
</tt>

So you should give to driver one of the <tt>L7fppprrr_rrrYYYYMMDD_HPN.FST</tt>, 
<tt>L7fppprrr_rrrYYYYMMDD_HRF.FST</tt> or
<tt>L7fppprrr_rrrYYYYMMDD_HTM.FST</tt> files.

Fast Format REV. C does not contain band filenames in administrative header.
So we should guess band filenames, because different data distributors name
their files differently. Several naming schemes hardcoded in GDAL's FAST
driver. These are:

<tt>
&lt;header&gt;.&lt;ext&gt; 
&lt;header&gt;.1.&lt;ext&gt; 
&lt;header&gt;.2.&lt;ext&gt; 
... 
</tt>

or

<tt>
&lt;header&gt;.&lt;ext&gt; 
band1.&lt;ext&gt; 
band2.&lt;ext&gt; 
... 
</tt>

or

<tt>
&lt;header&gt;.&lt;ext&gt; 
band1.dat 
band2.dat 
... 
</tt>

or

<tt>
&lt;header&gt;.&lt;ext&gt; 
imagery1.&lt;ext&gt; 
imagery2.&lt;ext&gt; 
... 
</tt>

or

<tt>
&lt;header&gt;.&lt;ext&gt; 
imagery1.dat 
imagery2.dat 
... 
</tt>

in lower or upper case. Header file could be named arbitrarily. This should
cover majority of distributors fantasy in naming files. But if you out of
luck and your datasets named differently you should rename them manually
before importing data with GDAL.

GDAL also supports the logic for naming band files for datasets produced by
Euromap GmbH for IRS-1C/IRS-1D PAN, LISS3 and WIFS sensors.
Their filename logic is explained in the <a href="http://www.euromap.de/download/em_names.pdf">
Euromap Naming Conventions</a> document.

<h2>Georeference</h2>

All USGS projections should be supported (namely UTM, LCC, PS, PC, TM, OM, SOM).
Contact me if you have troubles with proper projection extraction.

<h2>Metadata</h2>

Calibration coefficients for each band reported as metadata items.

<ul>

<li> ACQUISITION_DATE: First scene acquisition date in yyyyddmm
	format.

<li> SATELLITE: First scene satellite name.

<li> SENSOR: First scene sensor name.

<li> BIASn: Bias value for the channel n.

<li> GAINn: Gain value for the channel n.

</ul>

<ul>
<li> Implemented as <tt>gdal/frmts/raw/fastdataset.cpp</tt>.

<li> Landsat FAST L7A format description available from
<a href="http://ltpwww.gsfc.nasa.gov/IAS/htmls/l7_review.html">
http://ltpwww.gsfc.nasa.gov/IAS/htmls/l7_review.html</a>
(see <a href="http://ltpwww.gsfc.nasa.gov/IAS/pdfs/DFCB_V5_B2_R4.pdf">
ESDIS Level 1 Product Generation System (LPGS) Output Files DFCB, Vol. 5, Book 2</a>)

<li> EOSAT Fast Format REV. C description available from
<a href="http://www.euromap.de/docs/doc_001.html">http://www.euromap.de/docs/doc_001.html</a>

</body>
</html>