SAGA-GIS Tool Library Documentation (v9.1.2)

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


Parameters

 NameTypeIdentifierDescriptionConstraints
InputBlueGrid, inputBAND_BLUE--
GreenGrid, inputBAND_GREEN--
RedGrid, inputBAND_RED--
Near InfraredGrid, inputBAND_NIR--
Shortwave Infrared 1Grid, inputBAND_SWIR1--
Shortwave Infrared 2Grid, inputBAND_SWIR2--
Thermal (*)Grid, input, optionalBAND_THERMAL--
Cirrus (*)Grid, input, optionalBAND_CIRRUS--
OutputCloudsGrid, outputCLOUDS--
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
Grid SystemGrid systemBANDS_SWIR--
Grid SystemGrid systemBANDS_THERMAL--
Grid SystemGrid systemBANDS_CIRRUS--
UnitChoiceTHERMAL_UNIT-Available Choices:
[0] Kelvin
[1] Celsius
Default: 0
AlgorithmChoiceALGORITHM-Available Choices:
[0] Fmask
[1] ACCA
Default: 0
SWIR/Thermal ThresholdFloating pointACCA_B56CThreshold for SWIR/Thermal Composite (step 6).Default: 225.000000
Desert Detection ThresholdFloating pointACCA_B45RThreshold for desert detection (step 10, NIR/SWIR Ratio).Default: 1.000000
Temperature HistogramIntegerACCA_HIST_NNumber of classes in the cloud temperature histogram.Minimum: 10
Default: 100
Cloud SignatureBooleanACCA_CSIGAlways use cloud signature (step 14).Default: 1
Cloud DifferentiationBooleanACCA_PASS2Differentiate between warm (not ambiguous) and cold clouds.Default: 0
ShadowsBooleanACCA_SHADOWInclude a category for cloud shadows.Default: 0
Shadow DetectionBooleanSHADOWSRun cloud shadow detection tool with standard settings.Default: 0
Sun's AzimuthFloating pointSUN_AZIMUTHDirection of sun clockwise from North [degree].Minimum: 0.000000
Maximum: 360.000000
Default: -180.000000
Sun's HeightFloating pointSUN_HEIGHTHeight 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