SAGA-GIS Tool Library Documentation (v9.1.2)

Tool Cloud Shadow Detection

This tool derives cloud shadows from detected clouds based on their spectral characteristics as well as terrain, sun position and expected cloud height. The initial cloud mask can be created by the tool "Cloud Detection".


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputCloudsGrid, inputCLOUDS--
CandidatesGrid, inputCAND_GRID_IN--
Elevation (*)Grid, input, optionalDEM--
GreenGrid, inputBAND_GREEN--
RedGrid, inputBAND_RED--
Near InfraredGrid, inputBAND_NIR--
Shortwave InfraredGrid, inputBAND_SWIR--
Thermal (*)Grid, input, optionalBAND_THERMAL--
Brightness BandsGrid list, inputBANDS_BRIGHTNESS--
OutputCloud Number (*)Grid, output, optionalCLOUD_ID--
Candidates (*)Grid, output, optionalCAND_GRID_OUT--
ShadowsGrid, outputSHADOWS--
Cloud InfoTable, outputCLOUD_INFO--
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
Grid SystemGrid systemBANDS_SWIR--
Grid SystemGrid systemBANDS_THERMAL--
OutputChoiceOUTPUT-Available Choices:
[0] visible shadow
[1] full shadow
[2] shadow and clouds
Default: 2
ValueFloating pointCAND_GRID_VALUE-Default: 0.000000
UnitChoiceTHERMAL_UNIT-Available Choices:
[0] Kelvin
[1] Celsius
Default: 0
CandidatesChoiceCANDIDATES-Available Choices:
[0] all cells of candidates grid that are not no-data
[1] all cells of candidates grid with a specified value
[2] average brightness threshold
[3] Irish
[4] Irish modified by Tizado
Default: 0
Brightness ThresholdFloating pointBRIGHTNESS-Minimum: 0.000000
Maximum: 1.000000
Default: 0.050000
ProcessingChoicePROCESSING-Available Choices:
[0] all clouds at once
[1] cloud by cloud
Default: 0
AzimuthFloating pointSUN_AZIMUTHDirection of sun clockwise from North [degree].Minimum: 0.000000
Maximum: 360.000000
Default: -180.000000
HeightFloating pointSUN_HEIGHTHeight of sun above horizon [degree].Minimum: 0.000000
Maximum: 90.000000
Default: 45.000000
Cloud HeightValue rangeCLOUD_HEIGHTThe range of cloud height above ground to be tested.-
(*) optional

Command-line

Usage: saga_cmd imagery_tools 21 [-CLOUDS <str>] [-CAND_GRID_IN <str>] [-DEM <str>] [-CLOUD_ID <str>] [-CAND_GRID_OUT <str>] [-SHADOWS <str>] [-CLOUD_INFO <str>] [-BAND_GREEN <str>] [-BAND_RED <str>] [-BAND_NIR <str>] [-BAND_SWIR <str>] [-BAND_THERMAL <str>] [-BANDS_BRIGHTNESS <str>] [-OUTPUT <str>] [-CAND_GRID_VALUE <double>] [-THERMAL_UNIT <str>] [-CANDIDATES <str>] [-BRIGHTNESS <double>] [-PROCESSING <str>] [-SUN_AZIMUTH <double>] [-SUN_HEIGHT <double>] [-CLOUD_HEIGHT_MIN <double>] [-CLOUD_HEIGHT_MAX <double>]
  -CLOUDS:<str>             	Clouds
	Grid, input
  -CAND_GRID_IN:<str>       	Candidates
	Grid, input
  -DEM:<str>                	Elevation
	Grid, input, optional
  -CLOUD_ID:<str>           	Cloud Number
	Grid, output, optional
  -CAND_GRID_OUT:<str>      	Candidates
	Grid, output, optional
  -SHADOWS:<str>            	Shadows
	Grid, output
  -CLOUD_INFO:<str>         	Cloud Info
	Table, output
  -BAND_GREEN:<str>         	Green
	Grid, input
  -BAND_RED:<str>           	Red
	Grid, input
  -BAND_NIR:<str>           	Near Infrared
	Grid, input
  -BAND_SWIR:<str>          	Shortwave Infrared
	Grid, input
  -BAND_THERMAL:<str>       	Thermal
	Grid, input, optional
  -BANDS_BRIGHTNESS:<str>   	Brightness Bands
	Grid list, input
  -OUTPUT:<str>             	Output
	Choice
	Available Choices:
	[0] visible shadow
	[1] full shadow
	[2] shadow and clouds
	Default: 2
  -CAND_GRID_VALUE:<double> 	Value
	Floating point
	Default: 0.000000
  -THERMAL_UNIT:<str>       	Unit
	Choice
	Available Choices:
	[0] Kelvin
	[1] Celsius
	Default: 0
  -CANDIDATES:<str>         	Candidates
	Choice
	Available Choices:
	[0] all cells of candidates grid that are not no-data
	[1] all cells of candidates grid with a specified value
	[2] average brightness threshold
	[3] Irish
	[4] Irish modified by Tizado
	Default: 0
  -BRIGHTNESS:<double>      	Brightness Threshold
	Floating point
	Minimum: 0.000000
	Maximum: 1.000000
	Default: 0.050000
  -PROCESSING:<str>         	Processing
	Choice
	Available Choices:
	[0] all clouds at once
	[1] cloud by cloud
	Default: 0
  -SUN_AZIMUTH:<double>     	Azimuth
	Floating point
	Minimum: 0.000000
	Maximum: 360.000000
	Default: -180.000000
  -SUN_HEIGHT:<double>      	Height
	Floating point
	Minimum: 0.000000
	Maximum: 90.000000
	Default: 45.000000
  -CLOUD_HEIGHT_MIN:<double>	Cloud Height
	Value range
  -CLOUD_HEIGHT_MAX:<double>	Cloud Height
	Value range