Tool Cloud Detection
This tool implements pass one of the Function of mask (Fmask) algorithm for cloud and cloud shadow detection in Landsat imagery. Landsat Top of Atmosphere (TOA) reflectance and Brightness Temperature (BT) are used as input.
Alternatively you can choose the scene-average automated cloud-cover assessment (ACCA) algorithm as proposed by Irish (2000) and Irish et al. (2006).
This tool can optionally pass the cloud mask to the "Cloud Shadow Detection" tool as well.
References
- Irish, R.R. (2000): Landsat 7 Automatic Cloud Cover Assessment. In: Shen, S.S., Descour, M.R. [Eds.]: Algorithms for Multispectral, Hyperspectral, and Ultraspectral Imagery VI. Proceedings of SPIE, 4049: 348-355. doi:10.1117/12.410358.
- Irish, R.R., Barker, J.L., Goward, S.N., Arvidson, T. (2006): Characterization of the Landsat-7 ETM+ Automated Cloud-Cover Assessment (ACCA) Algorithm.. Photogrammetric Engineering and Remote Sensing vol. 72(10): 1179-1188. doi:10.14358/PERS.72.10.1179.
- Tizado, E.J. (2010): GRASS GIS i.landsat.acca. E.J. Tizado's implementation of the ACCA algorithm as proposed by Irish (2000), Irish et al. (2006). Source Code.
- Zhu, Z., Wang, S., Woodcock, C.E. (2015): Improvement and expansion of the Fmask algorithm: cloud, cloud shadow, and snow detection for Landsats 4-7, 8, and Sentinel 2 images. Remote Sensing of Environment 159, 269-277. doi:10.1016/j.rse.2014.12.014.
- Zhu, Z., Woodcock, C.E. (2012): Object-based cloud and cloud shadow detection in Landsat imagery. Remote Sensing of Environment 118, 83-94. doi:10.1016/j.rse.2011.10.028.
- Author: J.Spitzmüller, O.Conrad (c) 2023
- Menu: Imagery|Feature Extraction
Parameters
| | Name | Type | Identifier | Description | Constraints |
|---|
| Input | Blue | Grid, input | BAND_BLUE | - | - |
| Green | Grid, input | BAND_GREEN | - | - |
| Red | Grid, input | BAND_RED | - | - |
| Near Infrared | Grid, input | BAND_NIR | - | - |
| Shortwave Infrared 1 | Grid, input | BAND_SWIR1 | - | - |
| Shortwave Infrared 2 | Grid, input | BAND_SWIR2 | - | - |
| Thermal (*) | Grid, input, optional | BAND_THERMAL | - | - |
| Cirrus (*) | Grid, input, optional | BAND_CIRRUS | - | - |
| Output | Clouds | Grid, output | CLOUDS | - | - |
| Options | Grid System | Grid system | PARAMETERS_GRID_SYSTEM | - | - |
| Grid System | Grid system | BANDS_SWIR | - | - |
| Grid System | Grid system | BANDS_THERMAL | - | - |
| Grid System | Grid system | BANDS_CIRRUS | - | - |
| Unit | Choice | THERMAL_UNIT | - | Available Choices:
[0] Kelvin
[1] Celsius
Default: 0 |
| Algorithm | Choice | ALGORITHM | - | Available Choices:
[0] Fmask
[1] ACCA
Default: 0 |
| SWIR/Thermal Threshold | Floating point | ACCA_B56C | Threshold for SWIR/Thermal Composite (step 6). | Default: 225.000000 |
| Desert Detection Threshold | Floating point | ACCA_B45R | Threshold for desert detection (step 10, NIR/SWIR Ratio). | Default: 1.000000 |
| Temperature Histogram | Integer | ACCA_HIST_N | Number of classes in the cloud temperature histogram. | Minimum: 10
Default: 100 |
| Cloud Signature | Boolean | ACCA_CSIG | Always use cloud signature (step 14). | Default: 1 |
| Cloud Differentiation | Boolean | ACCA_PASS2 | Differentiate between warm (not ambiguous) and cold clouds. | Default: 0 |
| Shadows | Boolean | ACCA_SHADOW | Include a category for cloud shadows. | Default: 0 |
| Shadow Detection | Boolean | SHADOWS | Run cloud shadow detection tool with standard settings. | Default: 0 |
| Sun's Azimuth | Floating point | SUN_AZIMUTH | Direction of sun clockwise from North [degree]. | Minimum: 0.000000
Maximum: 360.000000
Default: -180.000000 |
| Sun's Height | Floating point | SUN_HEIGHT | Height of sun above horizon [degree]. | Minimum: 0.000000
Maximum: 90.000000
Default: 45.000000 |
| (*) optional |
Command-line
Usage: saga_cmd imagery_tools 20 [-CLOUDS <str>] [-BAND_BLUE <str>] [-BAND_GREEN <str>] [-BAND_RED <str>] [-BAND_NIR <str>] [-BAND_SWIR1 <str>] [-BAND_SWIR2 <str>] [-BAND_THERMAL <str>] [-BAND_CIRRUS <str>] [-THERMAL_UNIT <str>] [-ALGORITHM <str>] [-ACCA_B56C <double>] [-ACCA_B45R <double>] [-ACCA_HIST_N <num>] [-ACCA_CSIG <str>] [-ACCA_PASS2 <str>] [-ACCA_SHADOW <str>] [-SHADOWS <str>] [-SUN_AZIMUTH <double>] [-SUN_HEIGHT <double>]
-CLOUDS:<str> Clouds
Grid, output
-BAND_BLUE:<str> Blue
Grid, input
-BAND_GREEN:<str> Green
Grid, input
-BAND_RED:<str> Red
Grid, input
-BAND_NIR:<str> Near Infrared
Grid, input
-BAND_SWIR1:<str> Shortwave Infrared 1
Grid, input
-BAND_SWIR2:<str> Shortwave Infrared 2
Grid, input
-BAND_THERMAL:<str> Thermal
Grid, input, optional
-BAND_CIRRUS:<str> Cirrus
Grid, input, optional
-THERMAL_UNIT:<str> Unit
Choice
Available Choices:
[0] Kelvin
[1] Celsius
Default: 0
-ALGORITHM:<str> Algorithm
Choice
Available Choices:
[0] Fmask
[1] ACCA
Default: 0
-ACCA_B56C:<double> SWIR/Thermal Threshold
Floating point
Default: 225.000000
-ACCA_B45R:<double> Desert Detection Threshold
Floating point
Default: 1.000000
-ACCA_HIST_N:<num> Temperature Histogram
Integer
Minimum: 10
Default: 100
-ACCA_CSIG:<str> Cloud Signature
Boolean
Default: 1
-ACCA_PASS2:<str> Cloud Differentiation
Boolean
Default: 0
-ACCA_SHADOW:<str> Shadows
Boolean
Default: 0
-SHADOWS:<str> Shadow Detection
Boolean
Default: 0
-SUN_AZIMUTH:<double> Sun's Azimuth
Floating point
Minimum: 0.000000
Maximum: 360.000000
Default: -180.000000
-SUN_HEIGHT:<double> Sun's Height
Floating point
Minimum: 0.000000
Maximum: 90.000000
Default: 45.000000