solarcoef: Calculates the solar coefficient

In ilyamaclean/microctools: Various worker functions for microclimc package

Calculates the solar coefficient

Description

solarcoef is used to calculate the proportion of direct beam radiation incident on an inclined surface at a specified time and location.

Usage

solarcoef(
  slope,
  aspect,
  localtime,
  lat,
  long,
  jd,
  merid = round(long/15, 0) * 15,
  dst = 0,
  horizon = TRUE
)

Arguments

slope	slopes angle (decimal º)
aspect	aspect angle (decimal º)
localtime	local time (decimal hour, 24 hour clock).
lat	latitude of the location for which the coefficientis required (decimal degrees, -ve south of the equator).
long	longitude of the location for which the solar index is required (decimal degrees, -ve west of Greenwich meridian).
jd	integer representing the Julian day as returned by jday().
merid	optional value representing the longitude (decimal degrees) of the local time zone meridian (0 for GMT). Default is round(long / 15, 0) * 15
dst	optional numeric value representing the time difference from the timezone meridian (hours, e.g. +1 for BST if merid = 0).
horizon	optinal logical indicating whether to set coefficient to zero if solar altitude < 0.

Value

the proportion of direct beam radiation incident on an inclined surface.

See Also

the microclimafunction microclima::solarindex() can be used to derive the solar coeffficient for cells of a digital elevation dataset accounting for topographic shading.

Examples

library(raster)
jd <- jday (2010, 6, 21) # Julian day
lt <- c(0:2400) / 100
si <- solarcoef(0, 0, lt, 50, -5, jd)
plot(si ~ lt, type = "l")

ilyamaclean/microctools documentation built on Jan. 25, 2023, 5:29 a.m.