SAGA.ta_lighting.2: Potential Incoming Solar Radiation

Calculation of potential incoming solar radiation (insolation). Times of sunrise/sunset will only be calculated if time span is set to single day.<br/>Most options should do well, but TAPES-G based diffuse irradiance calculation ('Atmospheric Effects' methods 2 and 3) needs further revision!

Inputs

Élévation

format
href
Please set a value for GRD_DEM.

Sky View Factor

format
href
Please set a value for GRD_SVF.

Water Vapour Pressure [mbar]

format
href
Please set a value for GRD_VAPOUR.

default value if no grid has been selected

number

Linke Turbidity Coefficient

format
href
Please set a value for GRD_LINKE.

default value if no grid has been selected

number
SOLARCONST 'description'

Use sky view factor based on local slope (after Oke 1988), if no sky viev factor grid is given.

boolean

Units for output radiation values.

string

Choose 'slim' to trace grid node's shadow, 'fat' to trace the whole cell's shadow, or ignore shadowing effects. The first is slightly faster but might show some artifacts.

string

Location

string

Latitude

number

Time Period

string

Day

string

Last Day

string

Time step size for a range of days calculation given in days.

integer

Moment [h]

number

Time span used for the calculation of daily radiation sums.

number

Time span used for the calculation of daily radiation sums.

number

Time step size for a day's calculation given in hours.

number

Atmospheric Effects

string

Height of Atmosphere [m]

number

Barometric Pressure [mbar]

number

Water content of a vertical slice of atmosphere in cm: 1.5 to 1.7, average=1.68

number

Dust factor: 100 ppm (standard)

number

The transmittance of the atmosphere, usually between 60 and 80 percent.

number

show direct insolation for each time step.

string

Constant Histogram Stretch

number

Outputs

Direct Insolation

format
transmission

Diffuse Insolation

format
transmission

Total Insolation

format
transmission

Direct to Diffuse Ratio

format
transmission

Compare to Flat Terrain

format
transmission

Duration of Insolation

format
transmission

Sunrise

format
transmission

Sunset

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.2", "title": "Potential Incoming Solar Radiation", "description": "Calculation of potential incoming solar radiation (insolation). Times of sunrise/sunset will only be calculated if time span is set to single day.<br/>Most options should do well, but TAPES-G based diffuse irradiance calculation ('Atmospheric Effects' methods 2 and 3) needs further revision!", "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://demo.mapmint.com/ogc-api/processes/SAGA.ta_lighting.2/execution"}, {"rel": "alternate", "type": "text/html", "title": "Execute End Point", "href": "http://demo.mapmint.com/ogc-api/processes/SAGA.ta_lighting.2/execution.html"}], "inputs": {"GRD_DEM": {"title": "\u00c9l\u00e9vation", "description": "\u00c9l\u00e9vation", "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": "GRD_DEM"}, "GRD_SVF": {"title": "Sky View Factor", "description": "Sky View Factor", "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"}]}}}], "nullable": true}, "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": "GRD_SVF"}, "GRD_VAPOUR": {"title": "Water Vapour Pressure [mbar]", "description": "Water Vapour Pressure [mbar]", "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"}]}}}], "nullable": true}, "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": "GRD_VAPOUR"}, "GRD_VAPOUR_DEFAULT": {"title": "D\u00e9faut", "description": "default value if no grid has been selected", "schema": {"type": "number", "default": 10, "format": "double", "nullable": true}, "id": "GRD_VAPOUR_DEFAULT"}, "GRD_LINKE": {"title": "Linke Turbidity Coefficient", "description": "Linke Turbidity Coefficient", "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"}]}}}], "nullable": true}, "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": "GRD_LINKE"}, "GRD_LINKE_DEFAULT": {"title": "D\u00e9faut", "description": "default value if no grid has been selected", "schema": {"type": "number", "default": 3, "format": "double", "nullable": true}, "id": "GRD_LINKE_DEFAULT"}, "SOLARCONST": {"schema": {"type": "number", "default": 1367, "format": "double", "nullable": true}, "id": "SOLARCONST"}, "LOCALSVF": {"title": "Local Sky View Factor", "description": "Use sky view factor based on local slope (after Oke 1988), if no sky viev factor grid is given.", "schema": {"type": "boolean", "default": false, "enum": ["true", "false"], "nullable": true}, "id": "LOCALSVF"}, "UNITS": {"title": "Units", "description": "Units for output radiation values.", "schema": {"type": "string", "enum": [], "nullable": true}, "id": "UNITS"}, "SHADOW": {"title": "Shadow", "description": "Choose 'slim' to trace grid node's shadow, 'fat' to trace the whole cell's shadow, or ignore shadowing effects. The first is slightly faster but might show some artifacts.", "schema": {"type": "string", "default": "slim", "enum": ["slim", "fat", "none"], "nullable": true}, "id": "SHADOW"}, "LOCATION": {"title": "Location", "description": "Location", "schema": {"type": "string", "default": "constant latitude", "enum": ["constant latitude", "calculate from grid system"], "nullable": true}, "id": "LOCATION"}, "LATITUDE": {"title": "Latitude", "description": "Latitude", "schema": {"type": "number", "default": 53, "format": "double", "minimum": -90, "maximum": 90, "nullable": true}, "id": "LATITUDE"}, "PERIOD": {"title": "Time Period", "description": "Time Period", "schema": {"type": "string", "default": "day", "enum": ["moment", "day", "range of days"], "nullable": true}, "id": "PERIOD"}, "DAY_MIN": {"title": "Day (min value)", "description": "Day", "schema": {"type": "string", "format": "date", "nullable": true}, "id": "DAY_MIN"}, "DAY_STOP_MIN": {"title": "Last Day (min value)", "description": "Last Day", "schema": {"type": "string", "format": "date", "nullable": true}, "id": "DAY_STOP_MIN"}, "DAYS_STEP": {"title": "Resolution [d]", "description": "Time step size for a range of days calculation given in days.", "schema": {"type": "integer", "default": 5, "nullable": true}, "id": "DAYS_STEP"}, "MOMENT": {"title": "Moment [h]", "description": "Moment [h]", "schema": {"type": "number", "default": 12, "format": "double", "minimum": 0, "maximum": 24, "nullable": true}, "id": "MOMENT"}, "HOUR_RANGE_MIN": {"title": "Time Span [h] (min value)", "description": "Time span used for the calculation of daily radiation sums.", "schema": {"type": "number", "nullable": true}, "id": "HOUR_RANGE_MIN"}, "HOUR_RANGE_MAX": {"title": "Time Span [h] (max value)", "description": "Time span used for the calculation of daily radiation sums.", "schema": {"type": "number", "nullable": true}, "id": "HOUR_RANGE_MAX"}, "HOUR_STEP": {"title": "Resolution [h]", "description": "Time step size for a day's calculation given in hours.", "schema": {"type": "number", "default": 0.5, "format": "double", "minimum": 0, "maximum": 24, "nullable": true}, "id": "HOUR_STEP"}, "METHOD": {"title": "Atmospheric Effects", "description": "Atmospheric Effects", "schema": {"type": "string", "default": "Lumped Atmospheric Transmittance", "enum": ["Height of Atmosphere and Vapour Pressure", "Air Pressure", " Water and Dust Content", "Lumped Atmospheric Transmittance", "Hofierka and Suri"], "nullable": true}, "id": "METHOD"}, "ATMOSPHERE": {"title": "Height of Atmosphere [m]", "description": "Height of Atmosphere [m]", "schema": {"type": "number", "default": 12000, "format": "double", "nullable": true}, "id": "ATMOSPHERE"}, "PRESSURE": {"title": "Barometric Pressure [mbar]", "description": "Barometric Pressure [mbar]", "schema": {"type": "number", "default": 1013, "format": "double", "nullable": true}, "id": "PRESSURE"}, "WATER": {"title": "Water Content [cm]", "description": "Water content of a vertical slice of atmosphere in cm: 1.5 to 1.7, average=1.68", "schema": {"type": "number", "default": 1.68, "format": "double", "nullable": true}, "id": "WATER"}, "DUST": {"title": "Dust [ppm]", "description": "Dust factor: 100 ppm (standard)", "schema": {"type": "number", "default": 100, "format": "double", "nullable": true}, "id": "DUST"}, "LUMPED": {"title": "Lumped Atmospheric Transmittance [Percent]", "description": "The transmittance of the atmosphere, usually between 60 and 80 percent.", "schema": {"type": "number", "default": 70, "format": "double", "minimum": 0, "maximum": 100, "nullable": true}, "id": "LUMPED"}, "UPDATE": {"title": "Update", "description": "show direct insolation for each time step.", "schema": {"type": "string", "default": "do not update", "enum": ["do not update", "fit histogram stretch for each time step", "constant histogram stretch for all time steps"], "nullable": true}, "id": "UPDATE"}, "UPDATE_STRETCH": {"title": "Constant Histogram Stretch", "description": "Constant Histogram Stretch", "schema": {"type": "number", "default": 1, "format": "double", "nullable": true}, "id": "UPDATE_STRETCH"}}, "outputs": {"GRD_DIRECT": {"title": "Direct Insolation", "description": "Direct Insolation", "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": "GRD_DIRECT"}, "GRD_DIFFUS": {"title": "Diffuse Insolation", "description": "Diffuse Insolation", "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": "GRD_DIFFUS"}, "GRD_TOTAL": {"title": "Total Insolation", "description": "Total Insolation", "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": "GRD_TOTAL"}, "GRD_RATIO": {"title": "Direct to Diffuse Ratio", "description": "Direct to Diffuse Ratio", "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": "GRD_RATIO"}, "GRD_FLAT": {"title": "Compare to Flat Terrain", "description": "Compare to Flat Terrain", "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": "GRD_FLAT"}, "GRD_DURATION": {"title": "Duration of Insolation", "description": "Duration of Insolation", "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": "GRD_DURATION"}, "GRD_SUNRISE": {"title": "Sunrise", "description": "Sunrise", "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": "GRD_SUNRISE"}, "GRD_SUNSET": {"title": "Sunset", "description": "Sunset", "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": "GRD_SUNSET"}}}

http://demo.mapmint.com/ogc-apihttp://localhost/ogc-api/processes/SAGA.ta_lighting.2.html
Last modified: Sat Feb 19 15:43:34 CET 2022