Class EquationsSoltaniSinclair2012

java.lang.Object
net.simplace.sim.components.util.helper.EquationsSoltaniSinclair2012

public class EquationsSoltaniSinclair2012 extends Object
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

    Fields
    Modifier and Type
    Field
    Description
    static final double
    typical/default crop (canopy) albedo, fairly constant
    static final double
    default minimum soil evaporation when soil is covered by crop [mm day-1]
    static final double
    default extinction coefficient for total global solar radiation, KET
    static final double
    default rainfall/irrigation amount required to reset soil evaporation from Stage II to Stage I [mm]
  • Constructor Summary

    Constructors
    Constructor
    Description
     
  • Method Summary

    Modifier and Type
    Method
    Description
    static double
    Actual soil evaporation during Stage I (top soil layer contains water, i.e.
    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.
    static double
    ConvertSoilEvaporationToMillimeters(double EOS_energyUnits)
    Converts potential soil evaporation from energy units to millimeters of water evaporated.
    static double
    EquilibriumEvaporation(double SRAD, double ALBEDO, double TD)
    Equilibrium evaporation, from surface albedo, average daily air temperature and daily solar radiation.
    static double
    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 double
    PotentialSoilEvaporationEnergyUnits(double SRAD, double SALB, double KET, double ETLAI, double DELT)
    Potential soil evaporation from a bare, wet soil surface, in energy units.
    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).
    static double
    Saturation vapor pressure at temperature T.
    static double
    Slope of the saturated vapor pressure curve versus temperature (DELT).
    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.
    static double
    TopLayerTranspiration(double TR, double RT1)
    Amount of transpirational water withdrawn from the top soil layer.
    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).
    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).
    static double
    VapourPressureDeficitForTranspiration(double VPDF, double VPTMAX, double VPTMIN)
    Effective, weighted vapor pressure deficit for transpiration through the daily cycle.
    static double
    WeightedMeanDailyTemperature(double TMAX, double TMIN)
    Average air temperature during the day, weighted towards TMAX.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • KET_Default

      public static final double KET_Default
      default extinction coefficient for total global solar radiation, KET
      See Also:
    • EOSMIN_Default

      public static final double EOSMIN_Default
      default minimum soil evaporation when soil is covered by crop [mm day-1]
      See Also:
    • WETWAT_Default

      public static final double WETWAT_Default
      default rainfall/irrigation amount required to reset soil evaporation from Stage II to Stage I [mm]
      See Also:
    • CALB_Default

      public static final double CALB_Default
      typical/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, see SlopeOfSaturationVapourPressureCurve(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, see PotentialSoilEvaporationEnergyUnits(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, see SaturationVapourPressure(double) [kPa]
      VPTMIN - saturation vapor pressure at TMIN, see SaturationVapourPressure(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, see VapourPressureDeficitForTranspiration(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, see Transpiration(double, double, double) [mm day-1]
      RT1 - fraction of transpirational water withdrawn from the top layer, see TopLayerTranspirationFraction(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, see CALB_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, see SurfaceAlbedo(double, double, double, double) [-]
      TD - weighted mean daily temperature, see WeightedMeanDailyTemperature(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, see EquilibriumEvaporation(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, see PotentialEvapotranspirationPriestleyTaylor(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]