SAGA 9.4.2 | Tool Library Documentation

Cloud Shadow Detection


Description

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--
Elevationgrid, input, optionalDEM--
Greengrid, inputBAND_GREEN--
Redgrid, inputBAND_RED--
Near Infraredgrid, inputBAND_NIR--
Shortwave Infraredgrid, inputBAND_SWIR--
Thermalgrid, input, optionalBAND_THERMAL--
Brightness Bandsgrid list, inputBANDS_BRIGHTNESS--
OutputCloud Numbergrid, output, optionalCLOUD_ID--
Candidatesgrid, 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 point numberCAND_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 point numberBRIGHTNESS-Minimum: 0.000000 Maximum: 1.000000 Default: 0.050000
ProcessingchoicePROCESSING-Available Choices: [0] all clouds at once [1] cloud by cloud Default: 0
Azimuthfloating point numberSUN_AZIMUTHDirection of sun clockwise from North [degree].Minimum: 0.000000 Maximum: 360.000000 Default: -180.000000
Heightfloating point numberSUN_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.-

Command Line


Usage: saga_cmd imagery_tools 21 [-CLOUDS ] [-CAND_GRID_IN ] [-DEM ] [-CLOUD_ID ] [-CAND_GRID_OUT ] [-SHADOWS ] [-CLOUD_INFO ] [-BAND_GREEN ] [-BAND_RED ] [-BAND_NIR ] [-BAND_SWIR ] [-BAND_THERMAL ] [-BANDS_BRIGHTNESS ] [-OUTPUT ] [-CAND_GRID_VALUE ] [-THERMAL_UNIT ] [-CANDIDATES ] [-BRIGHTNESS ] [-PROCESSING ] [-SUN_AZIMUTH ] [-SUN_HEIGHT ] [-CLOUD_HEIGHT_MIN ] [-CLOUD_HEIGHT_MAX ]
  -CLOUDS:             	Clouds
	grid, input
  -CAND_GRID_IN:       	Candidates
	grid, input
  -DEM:                	Elevation
	grid, input, optional
  -CLOUD_ID:           	Cloud Number
	grid, output, optional
  -CAND_GRID_OUT:      	Candidates
	grid, output, optional
  -SHADOWS:            	Shadows
	grid, output
  -CLOUD_INFO:         	Cloud Info
	table, output
  -BAND_GREEN:         	Green
	grid, input
  -BAND_RED:           	Red
	grid, input
  -BAND_NIR:           	Near Infrared
	grid, input
  -BAND_SWIR:          	Shortwave Infrared
	grid, input
  -BAND_THERMAL:       	Thermal
	grid, input, optional
  -BANDS_BRIGHTNESS:   	Brightness Bands
	grid list, input
  -OUTPUT:             	Output
	choice
	Available Choices:
	[0] visible shadow
	[1] full shadow
	[2] shadow and clouds
	Default: 2
  -CAND_GRID_VALUE: 	Value
	floating point number
	Default: 0.000000
  -THERMAL_UNIT:       	Unit
	choice
	Available Choices:
	[0] Kelvin
	[1] Celsius
	Default: 0
  -CANDIDATES:         	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:      	Brightness Threshold
	floating point number
	Minimum: 0.000000
	Maximum: 1.000000
	Default: 0.050000
  -PROCESSING:         	Processing
	choice
	Available Choices:
	[0] all clouds at once
	[1] cloud by cloud
	Default: 0
  -SUN_AZIMUTH:     	Azimuth
	floating point number
	Minimum: 0.000000
	Maximum: 360.000000
	Default: -180.000000
  -SUN_HEIGHT:      	Height
	floating point number
	Minimum: 0.000000
	Maximum: 90.000000
	Default: 45.000000
  -CLOUD_HEIGHT_MIN:	Cloud Height
	value range
  -CLOUD_HEIGHT_MAX:	Cloud Height
	value range