R_n: Radiation, net

Description Usage Arguments Value References

View source: R/radiation_functions.R

Description

Calculates the net solar or shortwave radiation using the "FAO" Penman Monteith approach for reference evapotranspiration (Allen et al., 1998, Equation 38), the "McJannet" approach for lake temperature (McMahon et al., 2013, Equation S11.25), or the McJannet approach for "wet_bulb" temperature (McMahon et al., 2013, Equation S11.31).

Usage

1
R_n(type = "FAO", loc, lake, weather, albedo)

Arguments

type

type of net radiation function to use. Defaults to "FAO" for FAO Penman-Monteith reference evapotranspiration. Other options include "McJannet" for net radiation at lake temperature and "wet_bulb" for net radiation at wet-bulb temperature.

loc

a list with location information that includes:

  • z: elevation above mean sea level (m)

  • phi: latitude of location (radians). Positive for northern hemisphere, negative for southern hemisphere.

  • Lm: longitude of location (degrees west of Greenwich).

  • Lz: longitude of location's measurement timezone (degrees west of Greenwich). For example, Lz = 75, 90, 105 and 120° for measurement times based on the Eastern, Central, Rocky Mountain and Pacific time zones (United States) and Lz = 0° for Greenwich, 330° for Cairo (Egypt), and 255° for Bangkok (Thailand).

lake

A list with lake data. Defaults to NULL, but for McJannet lake evaporation calculations, should include:

  • A: surface area of the lake (km^2).

  • depth_m: depth of the lake (m). Can be a static value or vector corresponding with datetimes vector.

  • lst: optional data frame with date (datetime) and ltmp (lake temperature, degC).

  • wtmp0: required initial water temperature for first day in datetimes (degC).

weather

a list with weather data that includes:

  • dt: string indicating the timestep of input weather series. Expects "hourly", "daily", or "monthly".

  • datetimes: datetimes of weather records POSIXct. If monthly timestep, make sure date is the 15th of each month.

  • atmp: If hourly timestep, vector of air temperature (degrees C) corresponding with datetimes vector. If daily or monthly timestep, list with two vectors, "min" and "max", with mean daily min and max air temperature (degrees C) corresponding with datetimes vector

  • RH: If hourly timestep, vector of relative humidity (percent) corresponding with datetimes vector. If daily or monthly timestep, list with two vectors, "min" and "max", with mean daily min and max relative humidity (percent) corresponding with datetimes vector.

  • Rs: vector of incoming solar or shortwave radiation (MJ/m^2/hr if hourly timestep, MG/m^2/day if daily or monthly), corresponding with datetimes vector.

  • wind: vector with mean wind speed (m/s), corresponding with datetimes vector.

  • wind_elev: atomic number, height at which wind is measured (m)

  • z0: aerodynamic roughness of weather measurement site (m)

albedo

a list with albedos for different surfaces, defaults to:

  • ref_crop: albedo of the hypothetical grass reference crop, 0.23

  • water: albedo of water, 0.08.

Value

Rn

net radiation (MJ/m^2/timestep)

References

Allen, R. G., Pereira, L. S., Raes, D., & Smith, M. (1998). Crop evapotranspiration: Guidelines for computing crop water requirements. Rome: FAO. Retrieved from http://www.fao.org/docrep/X0490E/x0490e00.htm.

McMahon, T. A., Peel, M. C., Lowe, L., Srikanthan, R., and McVicar, T. R. (2013). Estimating actual, potential, reference crop and pan evaporation using standard meteorological data: a pragmatic synthesis, Hydrol. Earth Syst. Sci., 17, 1331–1363. https://doi.org/10.5194/hess-17-1331-2013.


WDNR-Water-Use/CSLSevap documentation built on April 9, 2021, 1:35 a.m.