r.sun.daily - GRASS GIS manual

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

DESCRIPTION
- Output parameters explanation
EXAMPLE
SEE ALSO
AUTHORS

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:

output series of maps (one for each day): options containing basename in their name
output one map which is a sum of the intermediate maps

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

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