GRASS logo

NAME

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

KEYWORDS

raster, solar, sun energy, parallel

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: Monday Jan 30 19:52:26 2023 in commit: cac8d9d848299297977d1315b7e90cc3f7698730


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

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