Model Description¶
The ET-Demands package
RefET¶
Reference evapotranspiration is calculated according to the ASCE Standardized Reference Evapotranspiration Equation (ASCE-EWRI, 2005).
Gap Filling and QA/QC¶
Missing Data¶
Missing values of maximum air temperature (Tmax), minimum air temperature (Tmin), and mean wind speed (ux), up to six timesteps, are first filled through linear interpolation. Additional missing values not handled by the linear interpolation are filled using mean monthly values. Missing values of precipitation (Pr), snow, (Sn), and snow depth (Sd) are set to 0.
Maximum and Minimum Air Temperature¶
Maximum air temperature (Tmax) values greater than 120°F are set to 120°F. Minimum air temperature (Tmin) values greater than 90°F are set to 90°F. Maximum air temperature is checked against minimum air temperature at every time step. If minimum air temperature is greater than maximum air temperature, maximum air temperature is set to minimum air temperature.
ASCE Standardized Reference Evapotranspiration Equation¶
Daily Reference Evapotranspiration¶
where:
ETsz = standardized reference crop evapotranspiration for short ETos or tall ETrs surfaces [mm d-1 for daily time steps or mm h-1 for hourly time steps]
Rn = calculated net radiation at the crop surface [MM m-2 d-1 for daily time steps or MM m-2 h-1 for hourly time steps]
G = soil heat flux density at the soil surface [MM m-2 d-1 for daily time steps or MM m-2 h-1 for hourly time steps]
Tmean = mean daily or hourly air temperature at 1.5 to 2.5-m height [°C]
u2 = mean daily or hourly wind speed at 2-m height [m s-1]
es = saturation vapor pressure at 1.5 to 2.5-m height [kPa]
ea = mean actual vapor pressure at 1.5 to 2.5-m height [kPa]
Δ = slope of the saturation vapor pressure-temperature curve [kPa °C-1]
γ = psychrometric constant [kPa °C-1]
Cn = numerator constant that changes with reference type and calculation time step [K mm s3 Mg-1 d-1 for daily time steps or K mm s3 Mg-1 h-1 for hourly time steps]
Cd = denominator constant that changes with reference type and calculation time step [s m-1]
For a grass reference surface (ETo),
Cn = 900
Cd = 0.34
For an alfalfa reference surface (ETr),
Cn = 1600
Cd = 0.38
As soil heat flux density is positive when the soil is warming and negative when the soil is cooling, over a day period it is relatively small compared to daily Rn. For daily calculations it is ignored,
G = 0
Hourly Reference Evapotranspiration¶
The equation for ETsz is the same as daily, with
For a grass reference surface (ETo),
Cn = 37.0
At night, when Rn < 0,
Cd = 0.96
G = 0.5
For an alfalfa reference surface (ETr),
Cn = 66.0
At night, when Rn < 0,
Cd = 1.7
G = 0.2
# UNIT CONVERSION
Mean Air Temperature (Tmean)¶
ASCE-EWRI (2005) advises to use the mean of daily minimum and daily maximum temperature to calculate mean daily temperature as opposed to the mean of hourly temperatures.
where:
Tmean = mean daily air temperature [°C]
Tmax = maximum daily air temperature [°C]
Tmin = minimum daily air temperature [°C]
Ultimately, the ETsz equation requires actual vapor pressure (ea). This can be calculated from dew point temperature (Td), specific humidity (q), or relative humidity (RH). If needed, dew point temperature can be calculated from minimum air temperature (Tmin) and mean monthly dew point depression values (K0).
Dew Point Temperature¶
where:
Td = mean hourly or daily dew point temperature [°C]
Tmin = mean hourly or daily minimum daily air temperature [°C]
K0 = mean monthly dew point depression [°C]
Actual Vapor Pressure (ea) from Dew Point Temperature (Td)¶
where:
ea = actual vapor pressure [kPa]
Td = mean hourly or daily dew point temperature [°C]
# CALCULATE ACTUAL VAPOR PRESSURE FROM RELATIVE HUMIDITY
Actual Vapor Pressure (ea) from Relative Humidity (RH)¶
where:
ea = actual vapor pressure [kPa]
RH = relative humidity [%]
es = saturation vapor pressure [kPa]
Actual Vapor Pressure (ea) from Specific Humidity (q)¶
where:
ea = actual vapor pressure [kPa]
q = specific humidity [kg/kg]
P = mean atmospheric pressure at station elevation [kPa]
Atmospheric Pressure (P)¶
where:
P = mean atmospheric pressure at station elevation [kPa]
z = station elevation above mean sea level [m]
This equation differs slightly from ASCE 2005 as it reflects full precision per Dr. Allen (pers. comm.).
Psychrometric Constant (γ)¶
where:
γ = psychrometric constant [kPa °C-1]
P = mean atmospheric pressure at station elevation [kPa]
Slope of the Saturation Vapor Pressure-Temperature Curve (Δ)¶
where:
Δ = slope of the saturation vapor pressure-temperature curve (kPa °C-1]
Tmean = mean daily air temperature [°C]
Saturation Vapor Pressure (es)¶
where:
es = saturation vapor pressure
Tetens (1930)
Vapor Pressure Deficit (VPD)¶
where:
VPD = vapor pressure deficit [kPa]
es = saturation vapor pressure [kPa]
ea = actual vapor pressure [kPa]
Extraterrestrial Radiation (Ra)¶
The calculations for hourly and daily extraterrestrial radiation (Ra) differ slightly as the hourly calculations require hourly solar time angles (ω) in addition to the sunset hour angle (ωs) while the daily calculations just require the sunset hour angle.
Hourly and daily calculations require solar declination (δ), sunset hour angle (ωs), and inverse square of the earth-sun distance (dr).
Solar Declination (δ)
where:
δ = solar declination [radians]
DOY = day of year
Sunset Hour Angle (ωs)
where:
ωs = sunset hour angle [radians]
lat = Latitude [radians]
δ = solar declination [radians]
To calcuate the inverse quare of the earth-sun distance, the day-of-year fraction (DOYfrac) is needed
Day-of-Year Fraction (DOYfrac)
where:
DOYfrac = day-of-year fraction
DOY = day-of-year
Inverse Square of the Earth-Sun Distance (dr)
where:
dr = inverse square of the earth-sun distance [d-2]
ωs = sunset hour angle [radians]
lat = Latitude [radians]
δ = solar declination [radians]
Daily Extraterrestrial Radiation¶
where:
ωs = sunset hour angle [radians]
lat = Latitude [radians]
Ra = daily extraterrestrial radiation [MJ m-2 d-1]
δ = solar declination [radians]
dr = inverse square of the earth-sun distance [d-2]
Hourly Extraterrestrial Radiation¶
Hourly calculations also require the calculation hourly solar time angles (ω), which requires the calculation of solar time (ts).
Seasonal Correction (sc)
where:
sc = seasonal correction [hours]
DOY = day-of-year
Solar Time (t:sub:`s`)
where:
ts = solar time (i.e. noon is 0) [hours]
lon = Longitude [radians]
t = UTC time at the midpoint of the period [hours]
sc = seasonal correction [hours]
Solar Time Angle (ω)
where:
ω = solar hour angle [radians]
ts = solar time (i.e. noon is 0) [hours]
Hourly Extraterrestrial Radiation
Checks on ω1 and ω2
where: ω1 = solar time angle at the beginning of the period [radians]
ω2 = solar time angle at the end of the period [radians]
ω = solar hour angle [radians]
t = UTC time at the midpoint of the period [hours]
ωs = sunset hour angle [radians]
lat = Latitude [radians]
δ = solar declination [radians]
Ra = hourly extraterrestrial radiation [MJ m-2 h-1]
dr = inverse square of the earth-sun distance [d-2]
Clear-Sky Radiation (Rso)¶
Sin of the Angle of the Sun above the Horizon (sin:sub:`β24`)
where:
sin:sub:`β24`= sine of the angle of the sun above the horizon [radians]
lat = Latitude [radians]
DOYfrac = day-of-year fraction
Precipitable Water (w)
where:
w = precipitable water [mm]
P = mean atmospheric pressure at station elevation [kPa]
ea = actual vapor pressure [kPa]
Clearness Index for Direct Beam Radiation (k:sub:`b`)
where:
kb = clearness index for direct beam radiation
P = mean atmospheric pressure at station elevation [kPa]
sin:sub:`β24`= sine of the angle of the sun above the horizon [radians]
w = precipitable water [mm]
Transmissivity Index for Diffuse Radiation (k:sub:`d`)
where:
kd = transmissivity index for diffuse radiation
kb = clearness index for direct beam radiation
Daily Clear-Sky Radiation¶
where:
Rso = daily clear-sky radiation [MJ m-2 d-1]
Ra = daily extraterrestrial radiation [MJ m-2 d-1]
kb = clearness index for direct beam radiation
kd = transmissivity index for diffuse radiation
Hourly Clear-Sky Radiation¶
Several calculations, including the sin of the angle of the sun above the horizon (sinβ) and the clearness index for direct beam radiation (kb) change when calculating hourly clear-sky radiation.
Sin of the Angle of the Sun above the Horizon (sin:sub:`β`)
where:
sin:sub:`β`= sine of the angle of the sun above the horizon [radians]
sinβ,c`= sin:sub:`β limited to 0.01 so that kb does not go undefined
lat = Latitude [radians]
δ = solar declination [radians]
ω = solar hour angle [radians]
Clearness Index for Direct Beam Radiation (k:sub:`b`)
where:
kt = atmospheric turbidity coefficient
kb = clearness index for direct beam radiation
P = mean atmospheric pressure at station elevation [kPa]
sin:sub:`β,c`= sine of the angle of the sun above the horizon, limited to 0.01 [radians]
w = precipitable water [mm]
Transmissivity Index for Diffuse Radiation (k:sub:`d`)
where:
kd = transmissivity index for diffuse radiation
kb = clearness index for direct beam radiation
Hourly Clear-Sky Radiation
where:
Rso = hourly clear-sky radiation [MJ m-2 h-1]
Ra = hourly extraterrestrial radiation [MJ m-2 h-1]
kb = clearness index for direct beam radiation
kd = transmissivity index for diffuse radiation
Cloudiness Fraction (fcd)¶
Daily Cloudiness Fraction
where:
fcd = daily cloudiness fraction
Rs = measured solar radiation [MJ m-2 d-1]
Rso = clear sky solar radiation [MJ m-2 d-1]
Rs / Rso is limited to 0.3 < Rs / Rso ≤ 1.0
Hourly Cloudiness Fraction
At low sun angles (β), cloudiness fraction (fcd) is set to 1.
where:
β = angle of the sun above the horizon [radians]
lat = Latitude [radians]
δ = solar declination [radians]
ω = solar hour angle [radians]
fcd = hourly cloudiness fraction
Rs = measured solar radiation [MJ m-2 h-1]
Rso = clear sky solar radiation [MJ m-2 h-1]
Net Longwave Radiation (Rnl)¶
Daily Net Longwave Radiation
where:
Rnl = daily net longwave radiation [MJ m-2 d-1]
fcd = daily cloudiness fraction
ea = actual vapor pressure [kPa]
Tmax = maximum daily air temperature [°C]
Tmin = minimum daily air temperature [°C]
Hourly Net Longwave Radiation
where:
Rnl = hourly net longwave radiation [MJ m-2 h-1]
fcd = daily cloudiness fraction
ea = actual vapor pressure [kPa]
Tmean = mean hourly air temperature [°C]
Net Radiation (Rn)¶
Daily Net Radiation
where:
Rn = daily net radiation [MJ m-2 d-1]
Rnl = daily net longwave radiation [MJ m-2 d-1]
Rs = measured solar radiation [MJ m-2 d-1]
Hourly Net Radiation
where:
Rn = hourly net radiation [MJ m-2 h-1]
Rnl = hourly net longwave radiation [MJ m-2 h-1]
Rs = measured solar radiation [MJ m-2 h-1]
Windspeed Adjustment¶
The standardized reference crop evapotranspiration equation assumes a 2-m height windspeed. Windspeed measured at different heights can be approximated as
where:
u2 = wind speed at 2 m above ground surface [m s-1]
uz = measured wind speed at zw m above ground surface [m s-1]
zw = height of wind measurement about ground surface [m]
## CACLULATE MIN AND MAX MONTHLY MEAN TEMPERATURES
Thornton and Running Solar Radiation Estimate¶
If measured solar radiation (Rs) is not provided, it can be estimated using the approach described in Thorton and Running (1999). This approach requires three calibrated coefficients [LINK TO PAGE ON HOW TO DO THIS].
where:
Tdiff = temperature difference [°C]
Tmax = maximum daily air temperature [°C]
Tmin = minimum daily air temperature [°C]
Tmon,diff = mean monthly temperature difference [°C]
Tmon,max = mean monthly maximum air temperature [°C]
Tmon,min = mean monthly minimum air temperature [°C]
TRb0 = Thornton and Running b0 coefficient
TRb1 = Thornton and Running b1 coefficient
TRb2 = Thornton and Running b2 coefficient
BTR = Thorton and Running parameter
Rs = calculated solar radiation [MJ m-2 d-1]
Rso = clear sky solar radiation [MJ m-2 d-1]
For arid stations, [REFERENCE FOR THESE COEFFICIENTS]
TRb0 = 0.023
TRb1 = 0.1
TRb2 = 0.2
[DISCUSSION OF THESE PARAMETERS, AND HOW TO GET THEM]
Other Potential ET Estimates¶
The RefET module code can also calculate potential evapotranspiration using several different approaches. This provides a comparison with reference ET.
Latent Heat of Vaporization (λ)¶
The latent heat of vaporization is calculated from mean air temperature. This differs from ASCE-EWRI (2005) which advises to use a constant value of 2.45 MJ kg-1 as it varies only slightly over the ranges of air temperature that occur in agricultural or hydrologic systems. The equation used is from XXX.
where:
λ = latent heat of vaporization [MJ kg-1]
Tmean = mean daily air temperature [°C]
Penman¶
where:
ETo = grass reference evapotranspiration [mm d-1]
W = weighting factor (depends on temperature and altitude)
Rn = net radiation in equivalent evaporation [mm d-1]
f(ur) = wind-related function
(ea - ed) = difference between saturation vapor pressure at mean air temperature and the mean actual vapor pressure of the air [hPa]
where:
f(ur) = wind-related function
ur2 = daily wind run at 2-m height [km d-1]
Kimberly Penman 1982¶
Hargreaves-Samani¶
Priestley-Taylor¶
CropETPrep¶
CropET¶
The CropET module of the ET Demands model is the FAO-56 dual crop coefficient model (Allen et al., 1998) .
ETc = crop evapotranspiration
Kc = crop coefficient
Kcb = Basal crop coefficient
Ke = coefficient representing bare soil evaporation
ETo = reference crop evapotranspiration from a grass reference surface
Aridity Rating¶
Allen and Brockway (1983) estimated consumptive irrigation requirements for crops in Idaho, and developed an aridity rating for each meteorological weather station used to adjust temperature data. The aridity rating ranges from 0 (fully irrigated) to 100 (arid) and reflects conditions affecting the aridity of the site. The aridity rating was based on station metadata information, questionnaires, and phone conversations, and includes conditions close to the station (within a 50m radius),the area around the station (within a 1600m radius in the upwind direction), and the region around the station (within a 48km radius in the upwind direction).
Allen and Brockway (1983) used empirical data from Allen and Brockway (1982) to develop monthly aridity effect values (Ae). These values were used as adjustment factors for the temperature data based on the aridity rating. Stations with an aridity rating of 100 applied the adjustment factor directly, while stations with aridity ratings less than 100, weighted the adjustment factor by the aridity rating.
The empirical temperature data and aridity effect values used are show in the table below. These data are the average monthly departure of air temperatures over arid areas from air temperatures over irrigated areas in southern Idaho during 1981, and the aridity effect.
Month | Tmax | Tmin | Tmean | Ae |
---|---|---|---|---|
April | 2.7 | 2.4 | 2.5 | 1.0 |
May | 1.3 | 0.6 | 0.9 | 1.5 |
June | 2.4 | 1.8 | 2.1 | 2.0 |
July | 4.8 | 2.9 | 3.8 | 3.5 |
August | 5.2 | 4.3 | 4.7 | 4.5 |
September | 3.3 | 2.7 | 3.0 | 3.0 |
October | 0.3 | 1.6 | 0.9 | 0.0 |
HOW WAS THE ARIDITY EFFECT DETERMINED. ARE THESE DATA GENERAL ENOUGH TO USE AT OTHER LOCATIONS IF AN ARIDITY RATING IS DEVELOPED? IF NOT, CAN WE GENERALIZE THE APPROACH TO DEVELOPING AN ARIDITY RATING, AND ASSOCIATED ARIDITY EFFECT ADJUSTMENTS? ALSO, THE ‘CropET’ MODULE HAS A WAY OF PULLING IN ARIDITY EFFECT VALUES, HOWEVER, THE ‘RefET’ MODULE DOES NOT. THIS MEANS THAT WHILE TEMPERATURES USED IN THE CropET MODULE ARE ADJUSTED, TEMPERATURES USED TO CALCUATE REFERENCE ET ARE NOT. IF WE WANT TO CONTINUE TO SUPPORT THE ARIDITY RATING, THIS SHOULD BE ADDRESSED. WOULD ALSO REQUIRE PASSING THE MODEL THE ARIDITY EFFECT ADJUSTMENT FACTORS.
AreaET¶
PostProcessing¶
References¶
Allen, R. G., & Brockway, C. E. (1982). Weather and Consumptive Use in the Bear River Basin, Idaho During 1982.
Allen, R. G., & Brockway, C. E. (1983). Estimating Consumptive Irrigation Requirements for Crops in Idaho.
Allen, R. G., Pereira, L. S., Smith, M., Raes, D., & Wright, J. L. (2005). FAO-56 Dual Crop Coefficient Method for Estimating Evaporation from Soil and Application Extensions. Journal of Irrigation and Drainage Engineering, 131(1), 2–13. https://doi.org/10.1061/(ASCE)0733-9437(2005)131:1(2)
Allen, R. G., & Robison, C. W. (2007). Evapotranspiration and Consumptive Irrigation Water Requirements for Idaho.
ASCE-EWRI. (2005). The ASCE Standardized Reference Evapotranspiration Equation.
Blaney, H. F., & Criddle, W. D. (1950). Determining Water Requirements in Irrigated Areas from Climatological and Irrigation Data. SCS-TP-96. Washington D.C.
Hargreaves, G. H., & A. Samani, Z. (1985). Reference Crop Evapotranspiration from Temperature. Applied Engineering in Agriculture, 1(2), 96–99. https://doi.org/https://doi.org/10.13031/2013.26773
Penman, H. L. (1948). Natural Evaporation from Open Water, Bare Soil and Grass. Proceedings of the Royal Society A: Mathematical, Physical and Engineering Sciences, 193(1032), 120–145. https://doi.org/10.1098/rspa.1948.0037
Priestley, C. H. B., & Taylor, R. J. (1972). On the Assessment of Surface Heat Flux and Evaporation Using Large-Scale Parameters. Monthly Weather Review, 100(2), 81–92. https://doi.org/10.1175/1520-0493(1972)100<0081:OTAOSH>2.3.CO;2
Thornton, P. E., & Running, S. W. (1999). An improved algorithm for estimating incident daily solar radiation from measurements of temperature, humidity, and precipitation. Agricultural and Forest Meteorology, 93, 211–228. https://doi.org/10.1016/S0168-1923(98)00126-9