tmp_equil: Temperature, equilibrium

Description Usage Arguments Value References

View source: R/heat_functions.R

Description

Calculates the equilibrium temperature based on de Bruin (1982) Equation 3, as presented in McMahon et al. (2013) S11.30.

Usage

1
tmp_equil(loc, lake, weather, albedo, SBc = 4.903e-09)

Arguments

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.

SBc

Stefan-Boltzman constant (MJ/m^2/day). Defaults to 4.903e-9 MJ/m^2/day.

Value

eqtmp

equilibrium temperature (degrees C)

References

McMahon, T. A., Peel, M. C., Lowe, L., Srikanthan, R., and McVicar, T. R.: 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, 2013.


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