Package net.simplace.sim.components.experimental.fao56

Class CropEvapoTranspirationSoilEvap

java.lang.Object

net.simplace.sim.model.FWSimComponent

net.simplace.sim.components.experimental.fao56.CropEvapoTranspirationSoilEvap

All Implemented Interfaces:

net.simplace.sim.util.FWSimFieldContainer

public class CropEvapoTranspirationSoilEvap
extends net.simplace.sim.model.FWSimComponent

Calculates the soil evaporation reduction coefficient K_r using formulas from (FAO 56).

Implemented methods: Allen et al (1998), equations 73 and 74.

For full documentation of the formulas please check the original reference (FAO56)

References: Allen et al., 1998. Crop evapotranspiration - Guidelines for computing crop water requirements - FAO Irrigation and drainage paper 56, 1998 http://www.fao.org/docrep/x0490e/x0490e00.htm

Author:

Roelof Oomen, Heidi Webber

Component Variables

Content Type	Name	Description	Data Type	Unit	Min Value	Max Value	Default Value
constant	cMaxSoilEvaporationDepth	Depth of the surface soil layer that is subject to drying by way of evaporation (Z_e)	DOUBLE	m	0.0	1.0	-
constant	cREW	Readily evaporable water over the full evaporation depth	DOUBLE	mm	0.0	100.0	-
constant	cSoilLayerDepth	Depth of the bottom of each soil layer after soil layer transformation	DOUBLEARRAY	m	-	-	-
constant	cSoilWaterFieldCapacity	Volumetric soil water content of each layer at field capacity (pF2.5 or -33 KPa)	DOUBLEARRAY	m3/m3	-	-	-
constant	cSoilWaterWiltingPoint	Volumetric soil water content of each layer at permanent wilting point (pF4.2 or -1500 KPa)	DOUBLEARRAY	m3/m3	-	-	-
input	iET0	reference crop evapotranspiration	DOUBLE	mm	0.0	20.0	0.0
input	iKcMax	Upper limit on ETC	DOUBLE	1	0.0	2.0	-
input	iKcb	Basal crop coefficient	DOUBLE	1	0.0	2.0	-
input	iKeUpper	Upper limit of soil evaporation coefficient	DOUBLE	1	0.0	2.0	-
input	iPotentialTranCrop	Potential rate of transpiration from the crop	DOUBLE	mm/d	0.0	20.0	-
input	iTotalWaterContentPerLayer	Total water content in each soil layer (mm)	DOUBLEARRAY	mm	0.0	-	-
out	ActualSoilEvapCrop	Actual rate of evaporation from the soil	DOUBLE	mm/d	0.0	20.0	0.0
out	ETC	Crop ET under standard conditions (no water, nutrient, weed, pest or disease limitations to growth)	DOUBLE	mm/d	0.0	20.0	-
out	Ke	Soil evaporation coefficient	DOUBLE	1	0.0	2.0	-
out	Kr	Soil evaporation reduction coefficient	DOUBLE	1	0.0	1.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, isComponentGroup, iSimComponentElement, iSimModel, iVarMap

Constructor Summary

Constructors

Constructor	Description
CropEvapoTranspirationSoilEvap()	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<?>>	createVariables()	Create the FWSimVariables as interface for this SimComponent
protected double	EvaporationReduction()	Calculates K_r.
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	init()	Initialises the fields by getting input and output FWSimVariables from VarMap
protected void	process()	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, getInputVariables, getMasterComponentGroup, getName, getOrderNumber, getOutputVariables, getVariable, getVariableField, getVarMap, initialize, isConditionCheck, isVariableAvailable, performLinks, performLinks, readInputs, removeVariable, reset, runComponentTest, setVariablesDefault, 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

CropEvapoTranspirationSoilEvap

public CropEvapoTranspirationSoilEvap()

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()

Initialises 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()

EvaporationReduction

protected double EvaporationReduction()

Calculates K_r. Allen et al (1998) specifies K_r = 1 when soil surface is wet, which also the case here, as when WM > 0, WR = FC, and therefore D_e will be zero.

Returns:

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

See Also:

• net.simplace.sim.util.FWSimFieldContainer#fillTestVariables(int aParamIndex, TEST_STATE aDefineOrCheck)

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)