Class EquationsSoltaniSinclair2012
java.lang.Object
net.simplace.sim.components.util.helper.EquationsSoltaniSinclair2012
Helper EquationsSoltaniSinclair2012 for computing values due to equations from
Soltani & Sinclair (2012), Chapter 14 "Soil Water Balance".
Equation numbers refer to the book cited below (Chapter 14). Covers three independent evapotranspiration-related sub-models:
- potential and actual soil evaporation (simplified Penman method, Eq. 14.15-14.19)
- plant transpiration after Tanner & Sinclair (Eq. 14.20-14.24)
- potential evapotranspiration after Priestley & Taylor, as an alternative method described in the "Additional Notes" (Eq. 14.29-14.32)
References
- (Soltani & Sinclair 2012) Soltani, A. and Sinclair, T.R. Modeling Physiology of Crop Development, Growth and Yield. CAB International, 2012. Chapter 14.
- (Amir and Sinclair, 1991) referenced therein for the two-stage soil evaporation model
- (Tanner and Sinclair, 1983) referenced therein for the transpiration efficiency approach
- (Ritchie, 1998) referenced therein for the Priestley-Taylor method
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final doubletypical/default crop (canopy) albedo, fairly constantstatic final doubledefault minimum soil evaporation when soil is covered by crop [mm day-1]static final doubledefault extinction coefficient for total global solar radiation, KETstatic final doubledefault rainfall/irrigation amount required to reset soil evaporation from Stage II to Stage I [mm] -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic doubleActualSoilEvaporationStageI(double EOS) Actual soil evaporation during Stage I (top soil layer contains water, i.e.static doubleActualSoilEvaporationStageII(double EOS, double DYSE) Actual soil evaporation during Stage II (top soil layer has dried out): potential evaporation is reduced as a function of the square root of time since the start of Stage II.static doubleConvertSoilEvaporationToMillimeters(double EOS_energyUnits) Converts potential soil evaporation from energy units to millimeters of water evaporated.static doubleEquilibriumEvaporation(double SRAD, double ALBEDO, double TD) Equilibrium evaporation, from surface albedo, average daily air temperature and daily solar radiation.static doublePotentialEvapotranspirationPriestleyTaylor(double EEQ, double TMAX) Potential evapotranspiration after Priestley & Taylor, as equilibrium evaporation multiplied by 1.1 to account for unsaturated air; the multiplier is increased for advection (TMAX > 34) and reduced for frozen soil / cold-temperature stomatal closure (TMAX < 5).static doublePotentialSoilEvaporationEnergyUnits(double SRAD, double SALB, double KET, double ETLAI, double DELT) Potential soil evaporation from a bare, wet soil surface, in energy units.static doublePotentialSoilEvaporationFromPET(double PET, double KET, double ETLAI) Potential (soil) evaporation from bare, wet soil surface, obtained from potential evapotranspiration and the fraction of soil not covered by the crop (exponential Beer-Bouguer-Lambert equation).static doubleSaturationVapourPressure(double T) Saturation vapor pressure at temperature T.static doubleSlopeOfSaturationVapourPressureCurve(double TMP) Slope of the saturated vapor pressure curve versus temperature (DELT).static doubleSurfaceAlbedo(double CALB, double SALB, double KET, double ETLAI) Surface (crop plus soil) albedo, as a function of the fraction of the field surface covered by crop versus soil, weighted with the crop and soil albedos.static doubleTopLayerTranspiration(double TR, double RT1) Amount of transpirational water withdrawn from the top soil layer.static doubleTopLayerTranspirationFraction(double FTSW1, double WSSG) Fraction of transpirational water withdrawn from the top soil layer, dependent on the top layer's soil water status relative to the crop-specific FTSW threshold at which transpiration starts to decline (WSSG, discussed in Chapter 15).static doubleTranspiration(double DDMP, double VPD, double TEC) Daily plant transpiration, linked to daily dry matter production via a transpiration efficiency coefficient (Tanner and Sinclair, 1983).static doubleVapourPressureDeficitForTranspiration(double VPDF, double VPTMAX, double VPTMIN) Effective, weighted vapor pressure deficit for transpiration through the daily cycle.static doubleWeightedMeanDailyTemperature(double TMAX, double TMIN) Average air temperature during the day, weighted towards TMAX.
-
Field Details
-
KET_Default
public static final double KET_Defaultdefault extinction coefficient for total global solar radiation, KET- See Also:
-
EOSMIN_Default
public static final double EOSMIN_Defaultdefault minimum soil evaporation when soil is covered by crop [mm day-1]- See Also:
-
WETWAT_Default
public static final double WETWAT_Defaultdefault rainfall/irrigation amount required to reset soil evaporation from Stage II to Stage I [mm]- See Also:
-
CALB_Default
public static final double CALB_Defaulttypical/default crop (canopy) albedo, fairly constant- See Also:
-
-
Constructor Details
-
EquationsSoltaniSinclair2012
public EquationsSoltaniSinclair2012()
-
-
Method Details
-
SlopeOfSaturationVapourPressureCurve
public static double SlopeOfSaturationVapourPressureCurve(double TMP) Slope of the saturated vapor pressure curve versus temperature (DELT). Eq. (14.15)- Parameters:
TMP- mean daily temperature [degree C]- Returns:
- DELT slope of saturated vapor pressure curve [-]
-
PotentialSoilEvaporationEnergyUnits
public static double PotentialSoilEvaporationEnergyUnits(double SRAD, double SALB, double KET, double ETLAI, double DELT) Potential soil evaporation from a bare, wet soil surface, in energy units. Simplified Penman equation, using discounted solar radiation (Beer-Bouguer-Lambert, Eq. 10.1) and soil albedo. Eq. (14.17)- Parameters:
SRAD- daily solar radiation [MJ m-2 day-1]SALB- soil albedo [-]KET- extinction coefficient for total global solar radiation [-]ETLAI- leaf area index used for calculation of evapotranspiration [m2 m-2]DELT- slope of saturated vapor pressure curve, seeSlopeOfSaturationVapourPressureCurve(double)[-]- Returns:
- EOS potential soil evaporation, energy units
-
ConvertSoilEvaporationToMillimeters
public static double ConvertSoilEvaporationToMillimeters(double EOS_energyUnits) Converts potential soil evaporation from energy units to millimeters of water evaporated. Eq. (14.18)- Parameters:
EOS_energyUnits- potential soil evaporation, energy units, seePotentialSoilEvaporationEnergyUnits(double, double, double, double, double)- Returns:
- EOS potential soil evaporation [mm day-1]
-
ActualSoilEvaporationStageI
public static double ActualSoilEvaporationStageI(double EOS) Actual soil evaporation during Stage I (top soil layer contains water, i.e. ATSW1 > 1 mm, and total soil profile not dry, i.e. FTSW > 0.5): actual evaporation equals potential evaporation. Eq. (14.19), Stage I- Parameters:
EOS- potential soil evaporation [mm day-1]- Returns:
- SEVP actual soil evaporation [mm day-1]
-
ActualSoilEvaporationStageII
public static double ActualSoilEvaporationStageII(double EOS, double DYSE) Actual soil evaporation during Stage II (top soil layer has dried out): potential evaporation is reduced as a function of the square root of time since the start of Stage II. Eq. (14.19), Stage II- Parameters:
EOS- potential soil evaporation [mm day-1]DYSE- days since the start of Stage II evaporation [day]- Returns:
- SEVP actual soil evaporation [mm day-1]
-
SaturationVapourPressure
public static double SaturationVapourPressure(double T) Saturation vapor pressure at temperature T. Eq. (14.22)- Parameters:
T- air temperature [degree C]- Returns:
- e0(T) saturation vapor pressure [kPa]
-
VapourPressureDeficitForTranspiration
public static double VapourPressureDeficitForTranspiration(double VPDF, double VPTMAX, double VPTMIN) Effective, weighted vapor pressure deficit for transpiration through the daily cycle. Eq. (14.21)- Parameters:
VPDF- fraction of the difference between saturation vapor pressure at TMAX and TMIN used for effective VPD, typically 0.65-0.75 [-]VPTMAX- saturation vapor pressure at TMAX, seeSaturationVapourPressure(double)[kPa]VPTMIN- saturation vapor pressure at TMIN, seeSaturationVapourPressure(double)[kPa]- Returns:
- VPD effective vapor pressure deficit for transpiration [kPa]
-
Transpiration
public static double Transpiration(double DDMP, double VPD, double TEC) Daily plant transpiration, linked to daily dry matter production via a transpiration efficiency coefficient (Tanner and Sinclair, 1983). Note: VPD is in kPa but TEC is in Pa; this results in the conversion of the transpiration unit from g m-2 day-1 to mm day-1. Eq. (14.20)- Parameters:
DDMP- daily dry matter production [g m-2 day-1]VPD- effective vapor pressure deficit for transpiration, seeVapourPressureDeficitForTranspiration(double, double, double)[kPa]TEC- transpiration efficiency coefficient, crop specific [Pa]- Returns:
- TR daily plant transpiration [mm day-1]
-
TopLayerTranspirationFraction
public static double TopLayerTranspirationFraction(double FTSW1, double WSSG) Fraction of transpirational water withdrawn from the top soil layer, dependent on the top layer's soil water status relative to the crop-specific FTSW threshold at which transpiration starts to decline (WSSG, discussed in Chapter 15). Eq. (14.23)- Parameters:
FTSW1- fraction transpirable soil water in the top layer [-]WSSG- threshold FTSW when crop transpiration starts to decline [-]- Returns:
- RT1 fraction of transpirational water withdrawn from the top layer [-]
-
TopLayerTranspiration
public static double TopLayerTranspiration(double TR, double RT1) Amount of transpirational water withdrawn from the top soil layer. Eq. (14.24)- Parameters:
TR- daily plant transpiration, seeTranspiration(double, double, double)[mm day-1]RT1- fraction of transpirational water withdrawn from the top layer, seeTopLayerTranspirationFraction(double, double)[-]- Returns:
- TR1 transpirational water withdrawn from the top layer [mm day-1]
-
SurfaceAlbedo
public static double SurfaceAlbedo(double CALB, double SALB, double KET, double ETLAI) Surface (crop plus soil) albedo, as a function of the fraction of the field surface covered by crop versus soil, weighted with the crop and soil albedos. From Box 14.1 (program listing); no explicit equation number is given in the main text.- Parameters:
CALB- albedo of the crop, fairly constant, seeCALB_Default[-]SALB- albedo of the soil [-]KET- extinction coefficient for total global solar radiation [-]ETLAI- leaf area index used for calculation of evapotranspiration [m2 m-2]- Returns:
- ALBEDO surface albedo [-]
-
WeightedMeanDailyTemperature
public static double WeightedMeanDailyTemperature(double TMAX, double TMIN) Average air temperature during the day, weighted towards TMAX. Eq. (14.32)- Parameters:
TMAX- maximum daily temperature [degree C]TMIN- minimum daily temperature [degree C]- Returns:
- TD weighted mean daily temperature [degree C]
-
EquilibriumEvaporation
public static double EquilibriumEvaporation(double SRAD, double ALBEDO, double TD) Equilibrium evaporation, from surface albedo, average daily air temperature and daily solar radiation. Eq. (14.31)- Parameters:
SRAD- daily solar radiation [MJ m-2 day-1]ALBEDO- surface (crop plus soil) albedo, seeSurfaceAlbedo(double, double, double, double)[-]TD- weighted mean daily temperature, seeWeightedMeanDailyTemperature(double, double)[degree C]- Returns:
- EEQ equilibrium evaporation [mm day-1]
-
PotentialEvapotranspirationPriestleyTaylor
public static double PotentialEvapotranspirationPriestleyTaylor(double EEQ, double TMAX) Potential evapotranspiration after Priestley & Taylor, as equilibrium evaporation multiplied by 1.1 to account for unsaturated air; the multiplier is increased for advection (TMAX > 34) and reduced for frozen soil / cold-temperature stomatal closure (TMAX < 5). Eq. (14.30)- Parameters:
EEQ- equilibrium evaporation, seeEquilibriumEvaporation(double, double, double)[mm day-1]TMAX- maximum daily temperature [degree C]- Returns:
- PET potential evapotranspiration [mm day-1]
-
PotentialSoilEvaporationFromPET
public static double PotentialSoilEvaporationFromPET(double PET, double KET, double ETLAI) Potential (soil) evaporation from bare, wet soil surface, obtained from potential evapotranspiration and the fraction of soil not covered by the crop (exponential Beer-Bouguer-Lambert equation). Eq. (14.29)- Parameters:
PET- potential evapotranspiration, seePotentialEvapotranspirationPriestleyTaylor(double, double)[mm day-1]KET- extinction coefficient for total global solar radiation [-]ETLAI- leaf area index used for calculation of evapotranspiration [m2 m-2]- Returns:
- EOS potential soil evaporation [mm day-1]
-