SAGA-GIS Tool Library Documentation (v9.1.2)

Tool Analytical Hillshading

This tool performs an analytical hillshade computation for an elevation grid. The 'Standard' method simply calculates the angle at which light coming from the position of the light source would hit the surface. This method can produce angles greater than 90 degree. With the second method all values are kept within the range of 0-90 degree. It can be enhanced with shadowing effects, where shadowed cells will be marked with a value of exactly 90 degree. 'Shadows Only' creates a mask for the shadowed areas and sets all other cells to no-data. 'Combined Shading' takes the values of the standard method and multiplies these with the normalized slope. 'Ambient Occlusion' is based on the concepts of Tarini et al. (2006), but only the northern half-space is considered here.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationGrid, inputELEVATION--
OutputAnalytical HillshadingGrid, outputSHADEThe angle between the surface and the incoming light beams, measured in radians.-
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
Shading MethodChoiceMETHOD-Available Choices:
[0] Standard
[1] Limited Maximum
[2] With Shadows
[3] Shadows Only
[4] Ambient Occlusion
[5] Combined Shading
Default: 0
Sun's PositionChoicePOSITION-Available Choices:
[0] azimuth and height
[1] date and time
Default: 0
AzimuthFloating pointAZIMUTHDirection of the light source, measured in degree clockwise from the North direction.Minimum: 0.000000
Maximum: 360.000000
Default: 315.000000
HeightFloating pointDECLINATIONHeight of the light source, measured in degree above the horizon.Minimum: 0.000000
Maximum: 90.000000
Default: 45.000000
DayDateDATE-Default: 2023-07-16
HourFloating pointTIME-Minimum: 0.000000
Maximum: 24.000000
Default: 12.000000
ExaggerationFloating pointEXAGGERATIONThe terrain exaggeration factor allows one to increase the shading contrasts in flat areas.Default: 1.000000
UnitChoiceUNIT-Available Choices:
[0] radians
[1] degree
Default: 0
ShadowChoiceSHADOWChoose 'slim' to trace grid node's shadow, 'fat' to trace the whole cell's shadow. The first is slightly faster but might show some artifacts.Available Choices:
[0] slim
[1] fat
Default: 0
Number of DirectionsIntegerNDIRSNumber of sample directions for ambient occlusion. Divides azimuth range (270 to 0 to 90 degree) into sectors. Declination (0 to 90 degree) is divided in (Number of Directions / 4) sectors.Minimum: 2
Default: 8
Search RadiusFloating pointRADIUSRadius used to trace for shadows (ambient occlusion) [map units].Minimum: 0.001000
Default: 10.000000

Command-line

Usage: saga_cmd ta_lighting 0 [-ELEVATION <str>] [-SHADE <str>] [-METHOD <str>] [-POSITION <str>] [-AZIMUTH <double>] [-DECLINATION <double>] [-DATE <date>] [-TIME <double>] [-EXAGGERATION <double>] [-UNIT <str>] [-SHADOW <str>] [-NDIRS <num>] [-RADIUS <double>]
  -ELEVATION:<str>      	Elevation
	Grid, input
  -SHADE:<str>          	Analytical Hillshading
	Grid, output
  -METHOD:<str>         	Shading Method
	Choice
	Available Choices:
	[0] Standard
	[1] Limited Maximum
	[2] With Shadows
	[3] Shadows Only
	[4] Ambient Occlusion
	[5] Combined Shading
	Default: 0
  -POSITION:<str>       	Sun's Position
	Choice
	Available Choices:
	[0] azimuth and height
	[1] date and time
	Default: 0
  -AZIMUTH:<double>     	Azimuth
	Floating point
	Minimum: 0.000000
	Maximum: 360.000000
	Default: 315.000000
  -DECLINATION:<double> 	Height
	Floating point
	Minimum: 0.000000
	Maximum: 90.000000
	Default: 45.000000
  -DATE:<date>          	Day
	Date
	Default: 2023-07-16
  -TIME:<double>        	Hour
	Floating point
	Minimum: 0.000000
	Maximum: 24.000000
	Default: 12.000000
  -EXAGGERATION:<double>	Exaggeration
	Floating point
	Default: 1.000000
  -UNIT:<str>           	Unit
	Choice
	Available Choices:
	[0] radians
	[1] degree
	Default: 0
  -SHADOW:<str>         	Shadow
	Choice
	Available Choices:
	[0] slim
	[1] fat
	Default: 0
  -NDIRS:<num>          	Number of Directions
	Integer
	Minimum: 2
	Default: 8
  -RADIUS:<double>      	Search Radius
	Floating point
	Minimum: 0.001000
	Default: 10.000000