SAGA-GIS Tool Library Documentation (v9.1.1)

Tool Topographic Correction

Topographic correction tools for satellite imagery using a digital elevation model (DEM) and the position of the Sun at acquisition time to estimate and remove shading effects.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationGrid, inputDEM--
BandsGrid list, inputBANDS--
OutputCorrected BandsGrid list, outputCORRECTED--
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
Grid systemGrid systemDEM_GRIDSYSTEM--
AzimuthFloating pointAZIMUTHdirection of sun (degree, clockwise from North)Minimum: 0.000000
Maximum: 360.000000
Default: 180.000000
HeightFloating pointHEIGHTheight of sun above horizon (degree)Minimum: 0.000000
Maximum: 90.000000
Default: 45.000000
MethodChoiceMETHOD-Available Choices:
[0] Cosine Correction (Teillet et al. 1982)
[1] Cosine Correction (Civco 1989)
[2] Minnaert Correction
[3] Minnaert Correction with Slope (Riano et al. 2003)
[4] Minnaert Correction with Slope (Law & Nichol 2004)
[5] C Correction
[6] Normalization (after Civco, modified by Law & Nichol)
Default: 2
Minnaert CorrectionFloating pointMINNAERT-Minimum: 0.000000
Maximum: 1.000000
Default: 0.500000
Maximum Number of CellsIntegerMAXCELLSMaximum number of grid cells used for trend analysis as required by C correction.Minimum: 1000
Default: 100000
Limit Value RangeBooleanLIMITAvoid over and undershootings specifying value range limits.Default: 0
MinimumFloating pointLIMIT_MIN-Default: 1.000000
MaximumFloating pointLIMIT_MAX-Default: 255.000000

Command-line

Usage: saga_cmd imagery_tools 19 [-DEM <str>] [-BANDS <str>] [-CORRECTED <str>] [-AZIMUTH <double>] [-HEIGHT <double>] [-METHOD <str>] [-MINNAERT <double>] [-MAXCELLS <num>] [-LIMIT <str>] [-LIMIT_MIN <double>] [-LIMIT_MAX <double>]
  -DEM:<str>         	Elevation
	Grid, input
  -BANDS:<str>       	Bands
	Grid list, input
  -CORRECTED:<str>   	Corrected Bands
	Grid list, output
  -AZIMUTH:<double>  	Azimuth
	Floating point
	Minimum: 0.000000
	Maximum: 360.000000
	Default: 180.000000
  -HEIGHT:<double>   	Height
	Floating point
	Minimum: 0.000000
	Maximum: 90.000000
	Default: 45.000000
  -METHOD:<str>      	Method
	Choice
	Available Choices:
	[0] Cosine Correction (Teillet et al. 1982)
	[1] Cosine Correction (Civco 1989)
	[2] Minnaert Correction
	[3] Minnaert Correction with Slope (Riano et al. 2003)
	[4] Minnaert Correction with Slope (Law & Nichol 2004)
	[5] C Correction
	[6] Normalization (after Civco, modified by Law & Nichol)
	Default: 2
  -MINNAERT:<double> 	Minnaert Correction
	Floating point
	Minimum: 0.000000
	Maximum: 1.000000
	Default: 0.500000
  -MAXCELLS:<num>    	Maximum Number of Cells
	Integer
	Minimum: 1000
	Default: 100000
  -LIMIT:<str>       	Limit Value Range
	Boolean
	Default: 0
  -LIMIT_MIN:<double>	Minimum
	Floating point
	Default: 1.000000
  -LIMIT_MAX:<double>	Maximum
	Floating point
	Default: 255.000000