SAGA 9.12.5 | Tool Documentation

Topographic Correction

Author(s) O.Conrad (c) 2008
Library IDimagery_tools
Tool ID 19
Version 1.0
Menu Imagery | Tools

Description

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

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. http://www.cartesia.org/geodoc/isprs2004/comm3/papers/347.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. http://www.geogra.uah.es/~emilio/pdf/Riano2003b.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, inputDEM--
Bandsgrid list, inputBANDS--
OutputCorrected Bandsgrid list, outputCORRECTED--
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Grid systemgrid systemDEM_GRIDSYSTEM--
Azimuthfloating point numberAZIMUTHdirection of sun (degree, clockwise from North)Minimum: 0.000000 Maximum: 360.000000 Default: 180.000000
Heightfloating point numberHEIGHTheight 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 point numberMINNAERT-Minimum: 0.000000 Maximum: 1.000000 Default: 0.500000
Maximum Number of Cellsinteger numberMAXCELLSMaximum 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 point numberLIMIT_MIN-Default: 1.000000
Maximumfloating point numberLIMIT_MAX-Default: 255.000000

Command Line


Usage: saga_cmd imagery_tools 19 [-DEM ] [-BANDS ] [-CORRECTED ] [-AZIMUTH ] [-HEIGHT ] [-METHOD ] [-MINNAERT ] [-MAXCELLS ] [-LIMIT ] [-LIMIT_MIN ] [-LIMIT_MAX ]
  -DEM:            Elevation
	grid, input
  -BANDS:          Bands
	grid list, input
  -CORRECTED:      Corrected Bands
	grid list, output
  -AZIMUTH:     Azimuth
	floating point number
	Minimum: 0.000000
	Maximum: 360.000000
	Default: 180.000000
  -HEIGHT:      Height
	floating point number
	Minimum: 0.000000
	Maximum: 90.000000
	Default: 45.000000
  -METHOD:
                        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:
                        Minnaert Correction
                        	floating point number
                        	Minimum: 0.000000
                        	Maximum: 1.000000
                        	Default: 0.500000
  -MAXCELLS:       Maximum Number of Cells
	integer number
	Minimum: 1000
	Default: 100000
  -LIMIT:          Limit Value Range
	boolean
	Default: 0
  -LIMIT_MIN:   Minimum
	floating point number
	Default: 1.000000
  -LIMIT_MAX:   Maximum
	floating point number
	Default: 255.000000