r.sun.daily - GRASS GIS manual

NAME

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

KEYWORDS

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] [method=string] [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 [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 aggregated for the whole period of time [Wh.m-2.day-1]
diff_rad=string: Output diffuse irradiation raster map aggregated for the whole period of time [Wh.m-2.day-1]
refl_rad=string: Output ground reflected irradiation raster map aggregated for the whole period of time [Wh.m-2.day-1]
glob_rad=string: Output global (total) irradiance/irradiation raster map aggregated for the whole period of time [Wh.m-2.day-1]
insol_time=string: Output insolation time raster map aggregated 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 aggregated 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.
method=string: Method for daily maps aggregation; Options: sum, average; Default: sum
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 an aggregation 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: Wednesday Aug 09 10:54:52 2023 in commit: 719723f05685d97466ffe34c84929befc3f89780