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

Tarini, M. / Cignoni, P. / Montani, C. (2006): Ambient Occlusion and Edge Cueing to Enhance Real Time Molecular Visualization. IEEE Transactions on Visualization and Computer Graphics, Vol. 12, No. 5, pp. 1237-1244.

Author: O.Conrad, V.Wichmann (c) 2003-2013
Menu: Terrain Analysis|Lighting

Parameters

	Name	Type	Identifier	Description	Constraints
Input	Elevation	Grid, input	`ELEVATION`	-	-
Output	Analytical Hillshading	Grid, output	`SHADE`	The angle between the surface and the incoming light beams, measured in radians.	-
Options	Grid System	Grid system	`PARAMETERS_GRID_SYSTEM`	-	-
	Shading Method	Choice	`METHOD`	-	Available Choices: [0] Standard [1] Limited Maximum [2] With Shadows [3] Shadows Only [4] Ambient Occlusion [5] Combined Shading Default: 0
	Sun's Position	Choice	`POSITION`	-	Available Choices: [0] azimuth and height [1] date and time Default: 0
	Azimuth	Floating point	`AZIMUTH`	Direction of the light source, measured in degree clockwise from the North direction.	Minimum: 0.000000 Maximum: 360.000000 Default: 315.000000
	Height	Floating point	`DECLINATION`	Height of the light source, measured in degree above the horizon.	Minimum: 0.000000 Maximum: 90.000000 Default: 45.000000
	Day	Date	`DATE`	-	Default: 2023-03-30
	Hour	Floating point	`TIME`	-	Minimum: 0.000000 Maximum: 24.000000 Default: 12.000000
	Exaggeration	Floating point	`EXAGGERATION`	The terrain exaggeration factor allows one to increase the shading contrasts in flat areas.	Default: 1.000000
	Unit	Choice	`UNIT`	-	Available Choices: [0] radians [1] degree Default: 0
	Shadow	Choice	`SHADOW`	Choose '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 Directions	Integer	`NDIRS`	Number 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 Radius	Floating point	`RADIUS`	Radius 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-03-30
  -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