SAGA-GIS Tool Library Documentation (v7.3.0)

Tool Topographic Correction


References:
Civco, D. L. (1989): 'Topographic Normalization of Landsat Thematic Mapper Digital Imagery', Photogrammetric Engineering and Remote Sensing, 55(9), pp.1303-1309.

Law, K.H., Nichol, J. (2004): 'Topographic Correction for Differential Illumination Effects on Ikonos Satellite Imagery', ISPRS 2004 International Society for Photogrammetry and Remote Sensing, pdf.

Phua, M.-H., Saito, H. (2003): 'Estimation of biomass of a mountainous tropical forest using Landsat TM data', Canadian Journal of Remote Sensing, 29(4), pp.429-440.

Riano, D., Chuvieco, E. Salas, J., Aguado, I. (2003): 'Assessment of Different Topographic Corrections in Landsat-TM Data for Mapping Vegetation Types', IEEE Transactions on Geoscience and Remote Sensing, 41(5), pp.1056-1061, pdf.

Teillet, P.M., Guindon, B., Goodenough, D.G. (1982): 'On the slope-aspect correction of multispectral scanner data', Canadian Journal of Remote Sensing, 8(2), pp.1537-1540.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationGrid (input)DEM--
Original ImageGrid (input)ORIGINAL--
OutputCorrected ImageGrid (output)CORRECTED--
OptionsGrid systemGrid systemPARAMETERS_GRID_SYSTEM--
Grid systemGrid systemDEM_GRIDSYSTEM--
AzimuthFloating pointAZIdirection of sun (degree, clockwise from North)Minimum: 0.000000
Maximum: 360.000000
Default: 180.000000
HeightFloating pointHGTheight 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: 4
Minnaert CorrectionFloating pointMINNAERT-Minimum: 0.000000
Maximum: 1.000000
Default: 0.500000
Maximum Cells (C Correction Analysis)IntegerMAXCELLSMaximum number of grid cells used for trend analysis as required by C correction.Minimum: 10
Default: 1000
Value RangeChoiceMAXVALUE-Available Choices:
[0] 1 byte (0-255)
[1] 2 byte (0-65535)
Default: 0

Command-line

Usage: saga_cmd ta_lighting 4 [-DEM <str>] [-ORIGINAL <str>] [-CORRECTED <str>] [-AZI <double>] [-HGT <double>] [-METHOD <str>] [-MINNAERT <double>] [-MAXCELLS <num>] [-MAXVALUE <str>]
  -DEM:<str>        	Elevation
	Grid (input)
  -ORIGINAL:<str>   	Original Image
	Grid (input)
  -CORRECTED:<str>  	Corrected Image
	Grid (output)
  -AZI:<double>     	Azimuth
	Floating point
	Minimum: 0.000000
	Maximum: 360.000000
	Default: 180.000000
  -HGT:<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: 4
  -MINNAERT:<double>	Minnaert Correction
	Floating point
	Minimum: 0.000000
	Maximum: 1.000000
	Default: 0.500000
  -MAXCELLS:<num>   	Maximum Cells (C Correction Analysis)
	Integer
	Minimum: 10
	Default: 1000
  -MAXVALUE:<str>   	Value Range
	Choice
	Available Choices:
	[0] 1 byte (0-255)
	[1] 2 byte (0-65535)
	Default: 0