SAGA.ta_lighting.0: 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.

Inputs

Elevation

format
href
Please set a value for ELEVATION.

Shading Method

string

Sun's Position

string

Direction of the light source, measured in degree clockwise from the North direction.

number

Height of the light source, measured in degree above the horizon.

number

Day

string

Hour

number

The terrain exaggeration factor allows one to increase the shading contrasts in flat areas.

number

Unit

string

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.

string

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.

integer

Radius used to trace for shadows (ambient occlusion) [map units].

number

Outputs

The angle between the surface and the incoming light beams, measured in radians.

format
transmission

Execution options

successUri
inProgressUri
failedUri

format

mode

Execute End Point

View the execution endpoint of a process.

View the alternative version in HTML.

{"id": "SAGA.ta_lighting.0", "title": "Analytical Hillshading", "description": "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. ", "version": "1.0.0", "jobControlOptions": ["sync-execute", "async-execute", "dismiss"], "outputTransmission": ["value", "reference"], "links": [{"rel": "http://www.opengis.net/def/rel/ogc/1.0/execute", "type": "application/json", "title": "Execute End Point", "href": "http://tb17.geolabs.fr:8119/ogc-api/processes/SAGA.ta_lighting.0/execution"}, {"rel": "alternate", "type": "text/html", "title": "Execute End Point", "href": "http://tb17.geolabs.fr:8119/ogc-api/processes/SAGA.ta_lighting.0/execution.html"}], "inputs": {"ELEVATION": {"title": "Elevation", "description": "Elevation", "extended-schema": {"oneOf": [{"allOf": [{"$ref": "http://zoo-project.org/dl/link.json"}, {"type": "object", "properties": {"type": {"enum": ["image/tiff", "application/x-ogc-envi", "application/x-ogc-aaigrid", "image/png"]}}}]}, {"type": "object", "required": ["value"], "properties": {"value": {"oneOf": [{"type": "string", "contentEncoding": "base64", "contentMediaType": "image/tiff"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "application/x-ogc-envi"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "application/x-ogc-aaigrid"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/png"}]}}}]}, "schema": {"oneOf": [{"type": "string", "contentEncoding": "base64", "contentMediaType": "image/tiff"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "application/x-ogc-envi"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "application/x-ogc-aaigrid"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/png"}]}, "id": "ELEVATION"}, "METHOD": {"title": "Shading Method", "description": "Shading Method", "schema": {"type": "string", "default": "Standard", "enum": ["Standard", "Limited Maximum", "With Shadows", "Shadows Only", "Ambient Occlusion", "Combined Shading"], "nullable": true}, "id": "METHOD"}, "POSITION": {"title": "Sun's Position", "description": "Sun's Position", "schema": {"type": "string", "default": "azimuth and height", "enum": ["azimuth and height", "date and time"], "nullable": true}, "id": "POSITION"}, "AZIMUTH": {"title": "Azimuth", "description": "Direction of the light source, measured in degree clockwise from the North direction.", "schema": {"type": "number", "default": 315, "format": "double", "minimum": 0, "maximum": 360, "nullable": true}, "id": "AZIMUTH"}, "DECLINATION": {"title": "Height", "description": "Height of the light source, measured in degree above the horizon.", "schema": {"type": "number", "default": 45, "format": "double", "minimum": 0, "maximum": 90, "nullable": true}, "id": "DECLINATION"}, "DATE_MIN": {"title": "Day (min value)", "description": "Day", "schema": {"type": "string", "format": "date", "nullable": true}, "id": "DATE_MIN"}, "TIME": {"title": "Hour", "description": "Hour", "schema": {"type": "number", "default": 12, "format": "double", "minimum": 0, "maximum": 24, "nullable": true}, "id": "TIME"}, "EXAGGERATION": {"title": "Exaggeration", "description": "The terrain exaggeration factor allows one to increase the shading contrasts in flat areas.", "schema": {"type": "number", "default": 1, "format": "double", "nullable": true}, "id": "EXAGGERATION"}, "UNIT": {"title": "Unit", "description": "Unit", "schema": {"type": "string", "default": "radians", "enum": ["radians", "degree"], "nullable": true}, "id": "UNIT"}, "SHADOW": {"title": "Shadow", "description": "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.", "schema": {"type": "string", "default": "slim", "enum": ["slim", "fat"], "nullable": true}, "id": "SHADOW"}, "NDIRS": {"title": "Number of Directions", "description": "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.", "schema": {"type": "integer", "default": 8, "nullable": true}, "id": "NDIRS"}, "RADIUS": {"title": "Search Radius", "description": "Radius used to trace for shadows (ambient occlusion) [map units].", "schema": {"type": "number", "default": 10, "format": "double", "nullable": true}, "id": "RADIUS"}}, "outputs": {"SHADE": {"title": "Analytical Hillshading", "description": "The angle between the surface and the incoming light beams, measured in radians.", "extended-schema": {"oneOf": [{"allOf": [{"$ref": "http://zoo-project.org/dl/link.json"}, {"type": "object", "properties": {"type": {"enum": ["image/tiff", "application/x-ogc-envi", "application/x-ogc-aaigrid", "image/png"]}}}]}, {"type": "object", "required": ["value"], "properties": {"value": {"oneOf": [{"type": "string", "contentEncoding": "base64", "contentMediaType": "image/tiff"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "application/x-ogc-envi"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "application/x-ogc-aaigrid"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/png"}]}}}]}, "schema": {"oneOf": [{"type": "string", "contentEncoding": "base64", "contentMediaType": "image/tiff"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "application/x-ogc-envi"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "application/x-ogc-aaigrid"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/png"}]}, "id": "SHADE"}}}

http://tb17.geolabs.fr:8119/ogc-api/processes/SAGA.ta_lighting.0.html
Last modified: Sat Feb 19 15:43:34 CET 2022