Help for ACCA

PURPOSE

   This program creates a cloud mask from a given LANDSAT image.
The output is a binary image where clouds are marked as 1s and
nonclouds are marked as 0s.  LANDSAT band images are passed to
the program in the inp parameter and are ordered 2, 3, 4, 5, and
6.

   This program will create temporary working files needed for
storing reflectance values and downsampled reflectance values.
Also tempcomp, ndsi, gv (growing vegetation), sv (scenesing
vegatation), rs (reflective soil), are also store in temporary
files.

   If no output files are specified for the temporary data then
default names will be given.  Please see parameter list for the
default names.

   The user may need to grow the final cloud mask by a few
pixels.

EXECUTION

   The program consists of 2 pass cloud detection system.  The
general run of the program is:

   1. calculate reflectance from raw dn
   2. calculate brightness temperature from TIR raw dn
   3. downsample reflectance files
   4. perform pass1
   5. perform pass2

   For details of the pass1 and pass2 algorithms, please see
"Characterization of the Landsat-7 ETM+ Automated Cloud-Cover
Assessment (ACCA) Algorithm" by Richard R. Irish,
John L. Barker, Samuel N. Goward, and Terry Arvidson.  The
article can be found in "Photogrammetric Engineering & Remote
Sensing", Vol. 72, No. 10, October 2006, pp. 1179 - 1188.

EXAMPLES

   The only parameters that are necessary are LANDSAT bands
(2, 3, 4, 5, 6) as inp, metafile, and output mask file as out.
Other files can be specified for debugging purposes.

   acca inp=(b2, b3, b4, b5, b6) meta=meta out=cloudmask

RESTRICTIONS

Original Programmer: P. Kim, 18 Aug 2009

REVISIONS
2022-08-10 B. Crocco afids to opensource (untested)


PARAMETERS:


INP

5 LANDSAT bands (2, 3, 4, 5, 6)

META

metafile

OUT

output binary final cloud file

MASKSNOW

debug output binary snow file

MASKDESERT

debug output binary desert file

MASKWARMCLOUD

debug output binary warm cloud file

MASKCOLDCLOUD

debug output binary cold cloud file

MASKICE

debug output binary ice file

MASKCIRRUS

debug output binary cirrus file

MASKAMBIG

debug output binary ambiguous clouds file

MASKVALID

debug output binary valid pixel file

RAD2OUT

debug output real band 2 radiance file

RAD3OUT

debug output real band 3 radiance file

RAD4OUT

debug output real band 4 radiance file

RAD5OUT

debug output real band 5 radiance file

RAD61OUT

debug output real band 6 radiance file

REF2OUT

output real reflectance band 2 file

REF3OUT

output real reflectance band 3 file

REF4OUT

output real reflectance band 4 file

REF5OUT

output real reflectance band 5 file

BTEMP61OUT

output real brightness temperature file

REF2DSOUT

output downsampled real reflectance band 2 file

REF3DSOUT

output downsampled real reflectance band 2 file

REF4DSOUT

output downsampled real reflectance band 2 file

REF5DSOUT

output downsampled real reflectance band 2 file

FILTER1OUT

debug output byte pass1 filter1 file

FILTER2OUT

debug output byte pass1 filter2 file

FILTER3OUT

debug output byte pass1 filter3 file

FILTER4OUT

debug output byte pass1 filter4 file

FILTER5OUT

debug output byte pass1 filter5 file

FILTER6OUT

debug output byte pass1 filter6 file

FILTER7OUT

debug output byte pass1 filter7 file

FILTER8OUT

debug output byte pass1 filter8 file

TEMPCOMPOUT

debug output real tempcomp file

NDSIOUT

debug output real ndsi file

GVOUT

debug output real growing vegetation file

SVOUT

debug output real scenesing vegetation file

RSOUT

debug output real reflective soil file

See Examples: