Class SoilEvaporationSoltaniSinclair2012

java.lang.Object
net.simplace.sim.model.FWSimComponent
net.simplace.sim.components.evapotran.SoilEvaporationSoltaniSinclair2012
All Implemented Interfaces:
net.simplace.sim.util.FWSimFieldContainer

public class SoilEvaporationSoltaniSinclair2012 extends net.simplace.sim.model.FWSimComponent
Calculates potential and actual soil evaporation using the simplified Penman method and the two-stage (Amir and Sinclair, 1991) evaporation model.

Calculates potential soil evaporation from a bare, wet soil surface (simplified Penman equation) and actual soil evaporation using a two-stage drying model. Stage I lasts while the top soil layer still holds water and the profile is not dry; actual evaporation then equals potential evaporation. Once the top layer has dried out, Stage II reduces evaporation as a function of the square root of the number of days since drying began.

For documentation of the formulas please check the original reference (Soltani & Sinclair, 2012).

References

Soltani, A. and Sinclair, T.R. (2012) Modeling Physiology of Crop Development, Growth and Yield. CAB International. Chapter 14, Eq. 14.15-14.19.

Component Variables

Content TypeNameDescriptionData TypeUnitMin ValueMax ValueDefault Value
constantcEOSMINminimum soil evaporation when soil is covered by cropDOUBLEmm/d0.0-1.5
constantcKETextinction coefficient for total global solar radiationDOUBLE10.01.00.5
inputiDaysSinceStageIIStartdays since the start of Stage II evaporation (DYSE)DOUBLEd0.0-0.0
inputiETLAIleaf area index used in calculation of evapotranspirationDOUBLE10.0-0.0
inputiInStageIItrue if soil evaporation is currently in Stage II (top layer dried out)BOOLEAN--false
inputiMeanTemperaturemean daily temperatureDOUBLE°C--0.0
inputiSoilAlbedosoil albedoDOUBLE10.01.00.12
inputiSolarRadiationdaily solar radiationDOUBLEMJ/(m2 d)--0.0
outActualSoilEvaporationactual soil evaporation (SEVP)DOUBLEmm/d--0.0
outPotentialSoilEvaporationpotential soil evaporation from a bare, wet soil surface (EOS)DOUBLEmm/d--0.0
outSlopeSaturationVapourPressureCurveslope of saturation vapour pressure curve (DELT)DOUBLE1--0.0
  • Nested Class Summary

    Nested classes/interfaces inherited from class net.simplace.sim.model.FWSimComponent

    net.simplace.sim.model.FWSimComponent.TEST_STATE
  • Field Summary

    Fields inherited from class net.simplace.sim.model.FWSimComponent

    iFieldMap, iFrequence, iInputMap, iJexlRule, iMasterComponentGroup, iName, iOrderNumber, iResetWhenInactive, isComponentGroup, iSimComponentElement, iSimModel, iVarMap
  • Constructor Summary

    Constructors
    Constructor
    Description
    Empty constructor used by class.forName()
  • Method Summary

    Modifier and Type
    Method
    Description
    protected net.simplace.sim.model.FWSimComponent
    clone(net.simplace.sim.util.FWSimVarMap aVarMap)
     
    HashMap<String,net.simplace.sim.util.FWSimVariable<?>>
    Create the FWSimVariables as interface for this SimComponent
    HashMap<String,net.simplace.sim.util.FWSimVariable<?>>
    fillTestVariables(int aParamIndex, net.simplace.sim.model.FWSimComponent.TEST_STATE aDefineOrCheck)
    called for single component test to check the components algorithm.
    protected void
    Initializes the fields by getting input and output FWSimVariables from VarMap
    protected void
    Process the algorithm and write the results back to VarMap

    Methods inherited from class net.simplace.sim.model.FWSimComponent

    addVariable, bind, checkCondition, createSimComponent, createSimComponent, createSimComponent, createSimComponent, doProcess, getConstantVariables, getContentType, getCreateFormXML, getDescription, getEditFormXML, getFieldMap, getFrequence, getFrequenceRuleScript, getInputs, getInputValueText, getInputVariables, getMasterComponentGroup, getName, getOrderNumber, getOutputVariables, getSimComponentElement, getVariable, getVariableField, getVarMap, initialize, isConditionCheck, isVariableAvailable, performLinks, performLinks, readInputs, removeVariable, reset, runComponentTest, setInputValue, setVariablesDefault, syncInputLinks, toComponentLinkingXML, toDocXML, toGroupXML, toOutputDefinitionXML, toResourcesDataXML, toResourcesDefinitionXML, toString, toXML, writeVarInfos

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Constructor Details

    • SoilEvaporationSoltaniSinclair2012

      public SoilEvaporationSoltaniSinclair2012()
      Empty constructor used by class.forName()
  • Method Details

    • createVariables

      public HashMap<String,net.simplace.sim.util.FWSimVariable<?>> createVariables()
      Create the FWSimVariables as interface for this SimComponent
      Specified by:
      createVariables in interface net.simplace.sim.util.FWSimFieldContainer
      Specified by:
      createVariables in class net.simplace.sim.model.FWSimComponent
      See Also:
      • FWSimComponent.createVariables()
    • init

      protected void init()
      Initializes the fields by getting input and output FWSimVariables from VarMap
      Specified by:
      init in class net.simplace.sim.model.FWSimComponent
      See Also:
      • FWSimComponent.init()
    • process

      protected void process()
      Process the algorithm and write the results back to VarMap
      Specified by:
      process in class net.simplace.sim.model.FWSimComponent
      See Also:
      • FWSimComponent.process()
    • fillTestVariables

      public HashMap<String,net.simplace.sim.util.FWSimVariable<?>> fillTestVariables(int aParamIndex, net.simplace.sim.model.FWSimComponent.TEST_STATE aDefineOrCheck)
      called for single component test to check the components algorithm.
      Specified by:
      fillTestVariables in class net.simplace.sim.model.FWSimComponent
    • clone

      protected net.simplace.sim.model.FWSimComponent clone(net.simplace.sim.util.FWSimVarMap aVarMap)
      Specified by:
      clone in class net.simplace.sim.model.FWSimComponent
      See Also:
      • FWSimComponent.clone(net.simplace.sim.util.FWSimVarMap)