SAGA-GIS Tool Library Documentation (v8.5.1)

Tool Potential Annual Insolation

Calculates the annual potential total insolation for given time steps and stores resulting time series in a grid collection.

Parameters

 NameTypeIdentifierDescriptionConstraints
InputElevationGrid, inputDEM--
OutputAnnual InsolationGrids, outputINSOLATION--
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
Number of StepsIntegerSTEPSNumber of time steps per year.Minimum: 2
Maximum: 365
Default: 14
UnitsChoiceUNITSUnits for output radiation values.Available Choices:
[0] kWh / m2
[1] kJ / m2
[2] J / cm2
Default: 0
Resolution [h]Floating pointHOUR_STEPTime step size for a day's calculation given in hours.Minimum: 0.000000
Maximum: 24.000000
Default: 0.500000
Reference YearIntegerYEAR-Default: 2000

Command-line

Usage: saga_cmd ta_lighting 7 [-DEM <str>] [-INSOLATION <str>] [-STEPS <num>] [-UNITS <str>] [-HOUR_STEP <double>] [-YEAR <num>]
  -DEM:<str>         	Elevation
	Grid, input
  -INSOLATION:<str>  	Annual Insolation
	Grids, output
  -STEPS:<num>       	Number of Steps
	Integer
	Minimum: 2
	Maximum: 365
	Default: 14
  -UNITS:<str>       	Units
	Choice
	Available Choices:
	[0] kWh / m2
	[1] kJ / m2
	[2] J / cm2
	Default: 0
  -HOUR_STEP:<double>	Resolution [h]
	Floating point
	Minimum: 0.000000
	Maximum: 24.000000
	Default: 0.500000
  -YEAR:<num>        	Reference Year
	Integer
	Default: 2000