GRASS logo

Note: This addon document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade your GRASS GIS installation, and read the current addon manual page.

NAME

r.sun.daily - Runs r.sun for multiple days in loop (mode 2)

KEYWORDS

raster, solar, sun energy

SYNOPSIS

r.sun.daily
r.sun.daily --help
r.sun.daily [-tpm] elevation=name [aspect=string] [slope=string] [linke=name] [linke_value=float] [albedo=name] [albedo_value=float] [lat=name] [long=name] [horizon_basename=basename] [horizon_step=stepsize] start_day=integer end_day=integer [day_step=integer] [step=float] [civil_time=float] [beam_rad=string] [diff_rad=string] [refl_rad=string] [glob_rad=string] [insol_time=string] [beam_rad_basename=string] [diff_rad_basename=string] [refl_rad_basename=string] [glob_rad_basename=string] [insol_time_basename=string] [solar_constant=float] [nprocs=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-t
Register created series of output maps into temporal dataset
Dataset name is the same as the base name for the output series of maps
-p
Do not incorporate the shadowing effect of terrain
-m
Use the low-memory version of the program
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

elevation=name [required]
Name of the input elevation raster map [meters]
aspect=string
Name of the input aspect map (terrain aspect or azimuth of the solar panel) [decimal degrees]
slope=string
Name of the input slope raster map (terrain slope or solar panel inclination) [decimal degrees]
linke=name
Name of the Linke atmospheric turbidity coefficient input raster map [-]
linke_value=float
A single value of the Linke atmospheric turbidity coefficient [-]
Options: 0.0-7.0
Default: 3.0
albedo=name
Name of the ground albedo coefficient input raster map [-]
albedo_value=float
A single value of the ground albedo coefficient [-]
Options: 0.0-1.0
Default: 0.2
lat=name
Name of input raster map containing latitudes (if projection undefined) [decimal degrees]
long=name
Name of input raster map containing longitudes (if projection undefined) [decimal degrees]
horizon_basename=basename
The horizon information input map basename
horizon_step=stepsize
Angle step size for multidirectional horizon [degrees]
start_day=integer [required]
Start day (of year) of interval
Options: 1-365
end_day=integer [required]
End day (of year) of interval
Options: 1-365
day_step=integer
Run r.sun for every n-th day [days]
Options: 1-365
Default: 1
step=float
Time step when computing all-day radiation sums [decimal hours]
Default: 0.5
civil_time=float
Civil time zone value, if none, the time will be local solar time
beam_rad=string
Output beam irradiation raster map cumulated for the whole period of time [Wh.m-2.day-1]
diff_rad=string
Output diffuse irradiation raster map cumulated for the whole period of time [Wh.m-2.day-1]
refl_rad=string
Output ground reflected irradiation raster map cumulated for the whole period of time [Wh.m-2.day-1]
glob_rad=string
Output global (total) irradiance/irradiation raster map cumulated for the whole period of time [Wh.m-2.day-1]
insol_time=string
Output insolation time raster map cumulated for the whole period of time [h]
beam_rad_basename=string
Base name for output beam irradiation raster maps [Wh.m-2.day-1]
Underscore and day number are added to the base name for daily maps
diff_rad_basename=string
Base name for output diffuse irradiation raster maps [Wh.m-2.day-1]
Underscore and day number are added to the base name for daily maps
refl_rad_basename=string
Base name for output ground reflected irradiation raster maps [Wh.m-2.day-1]
Underscore and day number are added to the base name for daily maps
glob_rad_basename=string
Base name for output global (total) irradiance/irradiation raster maps [Wh.m-2.day-1]
Underscore and day number are added to the base name for daily maps
insol_time_basename=string
Base name for output insolation time raster map cumulated for the whole period of time [h]
Underscore and day number are added to the base name for daily maps
solar_constant=float
Solar constant [W/m^2]
If not specified, r.sun default will be used.
nprocs=integer
Number of r.sun processes to run in parallel
Options: 1-
Default: 1

Table of contents

DESCRIPTION

r.sun.daily is a convenient script for running r.sun for multiple days in a loop. It corresponds to mode 2 (aggregation mode, see r.sun manual page).

Output parameters explanation

There are two basic options: You can choose any combination of parameters: e.g. total map of diffuse radiance and series of beam radiance maps. Series of maps are (if flag t is checked) registered to space time raster dataset with relative time and point time (not interval time). For GRASS 6, only timestamp is assigned.

EXAMPLE

g.region raster=elevation -p
r.sun.daily elevation=elevation start_day=30 end_day=40 \
            beam_rad_basename=beam beam_rad=beam_sum nprocs=4 -t
# show information about newly created space time dataset
t.info beam

# show information about newly created beam_sum raster map
r.info beam

SEE ALSO

r.sun
r.sun.hourly in Addons

AUTHORS

Vaclav Petras, NCSU OSGeoREL,
Anna Petrasova, NCSU OSGeoREL

SOURCE CODE

Available at: r.sun.daily source code (history)

Latest change: Mon Jun 28 07:54:09 2021 in commit: 1cfc0af029a35a5d6c7dae5ca7204d0eb85dbc55


Note: This addon document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade your GRASS GIS installation, and read the current addon manual page.

Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

© 2003-2023 GRASS Development Team, GRASS GIS 7.8.8dev Reference Manual