SAGA 9.4.2 | Tool Library Documentation

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. Most options should do well, but TAPES-G based diffuse irradiance calculation ('Atmospheric Effects' methods 2 and 3) needs further revision!


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationgrid, inputGRD_DEM--
Sky View Factorgrid, input, optionalGRD_SVF--
Water Vapour Pressure [mbar]grid, input, optionalGRD_VAPOUR--
Linke Turbidity Coefficientgrid, input, optionalGRD_LINKE--
OutputDirect Insolationgrid, outputGRD_DIRECT--
Diffuse Insolationgrid, outputGRD_DIFFUS--
Total Insolationgrid, output, optionalGRD_TOTAL--
Direct to Diffuse Ratiogrid, output, optionalGRD_RATIO--
Compare to Flat Terraingrid, output, optionalGRD_FLAT--
Duration of Insolationgrid, output, optionalGRD_DURATION--
Sunrisegrid, output, optionalGRD_SUNRISE--
Sunsetgrid, output, optionalGRD_SUNSET--
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Defaultfloating point numberGRD_VAPOUR_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000 Default: 10.000000
Defaultfloating point numberGRD_LINKE_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000 Default: 3.000000
Solar Constant [W/m_]floating point numberSOLARCONST-Minimum: 0.000000 Default: 1367.000000
Local Sky View FactorbooleanLOCALSVFUse sky view factor based on local slope (after Oke 1988), if no sky viev factor grid is given.Default: 1
UnitschoiceUNITSUnits for output radiation values.Available Choices: [0] [kWh/m_] [1] [kJ/m_] [2] [J/cm_] Default: 0
ShadowchoiceSHADOWChoose '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.Available Choices: [0] slim [1] fat [2] none Default: 1
LocationchoiceLOCATION-Available Choices: [0] constant latitude [1] calculate from grid system Default: 0
LatitudedegreeLATITUDE-Minimum: -90.000000 Maximum: 90.000000 Default: 53.000000
Time PeriodchoicePERIOD-Available Choices: [0] moment [1] day [2] range of days Default: 1
DaydateDAY-Default: 2024-07-05
Last DaydateDAY_STOP-Default: 2024-07-05
Resolution [d]integer numberDAYS_STEPTime step size for a range of days calculation given in days.Minimum: 1 Default: 5
Moment [h]floating point numberMOMENT-Minimum: 0.000000 Maximum: 24.000000 Default: 12.000000
Time Span [h]value rangeHOUR_RANGETime span used for the calculation of daily radiation sums.-
Resolution [h]floating point numberHOUR_STEPTime step size for a day's calculation given in hours.Minimum: 0.000000 Maximum: 24.000000 Default: 0.500000
Atmospheric EffectschoiceMETHOD-Available Choices: [0] Height of Atmosphere and Vapour Pressure [1] Air Pressure, Water and Dust Content [2] Lumped Atmospheric Transmittance [3] Hofierka and __ri Default: 2
Height of Atmosphere [m]floating point numberATMOSPHERE-Minimum: 0.000000 Default: 12000.000000
Barometric Pressure [mbar]floating point numberPRESSURE-Minimum: 0.000000 Default: 1013.000000
Water Content [cm]floating point numberWATERWater content of a vertical slice of atmosphere in cm: 1.5 to 1.7, average=1.68Minimum: 0.000000 Default: 1.680000
Dust [ppm]floating point numberDUSTDust factor: 100 ppm (standard)Minimum: 0.000000 Default: 100.000000
Lumped Atmospheric Transmittance [Percent]floating point numberLUMPEDThe transmittance of the atmosphere, usually between 60 and 80 percent.Minimum: 0.000000 Maximum: 100.000000 Default: 70.000000
Updatechoice, GUIUPDATEshow direct insolation for each time step.Available Choices: [0] do not update [1] fit histogram stretch for each time step [2] constant histogram stretch for all time steps Default: 0
Constant Histogram Stretchfloating point number, GUIUPDATE_STRETCH-Minimum: 0.000000 Default: 1.000000

Command Line


Usage: saga_cmd ta_lighting 2 [-GRD_DEM ] [-GRD_SVF ] [-GRD_VAPOUR ] [-GRD_VAPOUR_DEFAULT ] [-GRD_LINKE ] [-GRD_LINKE_DEFAULT ] [-GRD_DIRECT ] [-GRD_DIFFUS ] [-GRD_TOTAL ] [-GRD_RATIO ] [-GRD_FLAT ] [-GRD_DURATION ] [-GRD_SUNRISE ] [-GRD_SUNSET ] [-SOLARCONST ] [-LOCALSVF ] [-UNITS ] [-SHADOW ] [-LOCATION ] [-LATITUDE ] [-PERIOD ] [-DAY ] [-DAY_STOP ] [-DAYS_STEP ] [-MOMENT ] [-HOUR_RANGE_MIN ] [-HOUR_RANGE_MAX ] [-HOUR_STEP ] [-METHOD ] [-ATMOSPHERE ] [-PRESSURE ] [-WATER ] [-DUST ] [-LUMPED ]
  -GRD_DEM:              	Elevation
	grid, input
  -GRD_SVF:              	Sky View Factor
	grid, input, optional
  -GRD_VAPOUR:           	Water Vapour Pressure [mbar]
	grid, input, optional
  -GRD_VAPOUR_DEFAULT:	Default
	floating point number
	Minimum: 0.000000
	Default: 10.000000
  -GRD_LINKE:            	Linke Turbidity Coefficient
	grid, input, optional
  -GRD_LINKE_DEFAULT: 	Default
	floating point number
	Minimum: 0.000000
	Default: 3.000000
  -GRD_DIRECT:           	Direct Insolation
	grid, output
  -GRD_DIFFUS:           	Diffuse Insolation
	grid, output
  -GRD_TOTAL:            	Total Insolation
	grid, output, optional
  -GRD_RATIO:            	Direct to Diffuse Ratio
	grid, output, optional
  -GRD_FLAT:             	Compare to Flat Terrain
	grid, output, optional
  -GRD_DURATION:         	Duration of Insolation
	grid, output, optional
  -GRD_SUNRISE:          	Sunrise
	grid, output, optional
  -GRD_SUNSET:           	Sunset
	grid, output, optional
  -SOLARCONST:        	Solar Constant [W/m_]
	floating point number
	Minimum: 0.000000
	Default: 1367.000000
  -LOCALSVF:             	Local Sky View Factor
	boolean
	Default: 1
  -UNITS:                	Units
	choice
	Available Choices:
	[0] [kWh/m_]
	[1] [kJ/m_]
	[2] [J/cm_]
	Default: 0
  -SHADOW:               	Shadow
	choice
	Available Choices:
	[0] slim
	[1] fat
	[2] none
	Default: 1
  -LOCATION:             	Location
	choice
	Available Choices:
	[0] constant latitude
	[1] calculate from grid system
	Default: 0
  -LATITUDE:          	Latitude
	degree
	Minimum: -90.000000
	Maximum: 90.000000
	Default: 53.000000
  -PERIOD:               	Time Period
	choice
	Available Choices:
	[0] moment
	[1] day
	[2] range of days
	Default: 1
  -DAY:                 	Day
	date
	Default: 2024-07-05
  -DAY_STOP:            	Last Day
	date
	Default: 2024-07-05
  -DAYS_STEP:            	Resolution [d]
	integer number
	Minimum: 1
	Default: 5
  -MOMENT:            	Moment [h]
	floating point number
	Minimum: 0.000000
	Maximum: 24.000000
	Default: 12.000000
  -HOUR_RANGE_MIN:    	Time Span [h]
	value range
  -HOUR_RANGE_MAX:    	Time Span [h]
	value range
  -HOUR_STEP:         	Resolution [h]
	floating point number
	Minimum: 0.000000
	Maximum: 24.000000
	Default: 0.500000
  -METHOD:               	Atmospheric Effects
	choice
	Available Choices:
	[0] Height of Atmosphere and Vapour Pressure
	[1] Air Pressure, Water and Dust Content
	[2] Lumped Atmospheric Transmittance
	[3] Hofierka and __ri
	Default: 2
  -ATMOSPHERE:        	Height of Atmosphere [m]
	floating point number
	Minimum: 0.000000
	Default: 12000.000000
  -PRESSURE:          	Barometric Pressure [mbar]
	floating point number
	Minimum: 0.000000
	Default: 1013.000000
  -WATER:             	Water Content [cm]
	floating point number
	Minimum: 0.000000
	Default: 1.680000
  -DUST:              	Dust [ppm]
	floating point number
	Minimum: 0.000000
	Default: 100.000000
  -LUMPED:            	Lumped Atmospheric Transmittance [Percent]
	floating point number
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 70.000000