Package net.simplace.sim.components.models.gecros.modular

Class GecrosSoilWater

java.lang.Object

net.simplace.sim.model.FWSimComponent

net.simplace.sim.components.models.gecros.modular.GecrosSoilWater

All Implemented Interfaces:

net.simplace.sim.util.FWSimFieldContainer

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

Simulates soil water. Part of the Gecros model.

Consult reference for description of algorithms.

This module calculates only the water balance part. For biomass producution there is the complementary module GecrosCrop. There is also a module Gecros, where crop and soil water part are calculated simultaneusly.

Reference: Yin, X. and van Laar, H.H. (2005): Crop Systems Dynamics. An ecophysiological simulation model for genotype-by-environment interactions. Wageningen Academic Publishers, Wageningen, The Netherlands.

Author:

Gunther Krauss

See Also:

• Gecros
• GecrosFunctions
• net.simplace.sim.components.models.gecros.modular
• GecrosCrop

Component Variables

Content Type	Name	Description	Data Type	Unit	Min Value	Max Value	Default Value
constant	cBHC	Initial value for microbial biomass in the soil and humified organic matter in the soil (BIO + HUM)	DOUBLE	g/m2	-	-	3500.0
constant	cBIOR	Decomposition rate constant for microbial biomass in the soil (BIO)	DOUBLE	a-1	-	-	0.66
constant	cCLAY	Percentage of clay in the soil	DOUBLE	%	-	-	23.4
constant	cDPMI	Initial value of decomposable plant material (DPM)	DOUBLE	g/m2	-	-	0.0
constant	cDPMR0	Standard value for decomposition rate constant (DPMR) for decomposable plant material (DPM)	DOUBLE	a-1	-	-	10.0
constant	cDRPM	Ratio decomposable plant material/resistant plant material (DPM/RPM) of added plant material	DOUBLE	1	-	-	1.44
constant	cFBIOC	Fraction of initial value for for micobial biomass in the soil (BIOI) in initial total soil organic carbon (TOC)	DOUBLE	1	-	-	0.03
constant	cHUMR	Decomposition rate constant for humified organic matter in the soil (HUM)	DOUBLE	a-1	-	-	0.02
constant	cMULTF	Multiplication factor for initial soil water status	DOUBLE	1	-	-	1.0
constant	cNAI	Initial ammonium-N in the soil	DOUBLE	g/m2	-	-	0.0
constant	cNNI	Initial nitrate-N in the soil	DOUBLE	g/m2	-	-	0.0
constant	cNSWI	Switch variable for N supply for crop: false=user defined (NINPA, NINPN); true=simulated	BOOLEAN	1	-	-	false
constant	cRA	Residual ammonium-N in the soil	DOUBLE	g/m2	-	-	1.0
constant	cRN	Residual nitrate-N in the soil	DOUBLE	g/m2	-	-	1.0
constant	cRPMR0	Standard value for decompostion rate constant (RPMR) for resistant plant material (RPM)	DOUBLE	a-1	-	-	0.3
constant	cSD1	Thickness of upper evaporative soil layer	DOUBLE	cm	-	-	5.0
constant	cTCP	Time Constant	DOUBLE	d	-	-	1.0
constant	cTCT	Time constant for soil temperature dynamics	DOUBLE	d	-	-	4.0
constant	cTOC	Total organic C in the soil	DOUBLE	g/m2	-	-	7193.0
constant	cTSOILI	Initial soil temperature	DOUBLE	°C	-	-	0.0
constant	cWCFC	Soil water content in field capacity	DOUBLE	m3/m3	-	-	0.25
constant	cWCMAX	Soil water content at maximum water holding capacity	DOUBLE	m3/m3	-	-	0.35
constant	cWCMIN	Minimum soil water content	DOUBLE	m3/m3	-	-	0.05
constant	cWSWI	Switch variable for water supply for crop: false=user defined (WINPUT); true=simulated	BOOLEAN	1	-	-	false
input	iActualSoilEvaporation	Actual soil evaporation (AESOIL)	DOUBLE	mm/d	-	-	0.0
input	iActualTranspiration	Actual canopy transpiration (ATCAN)	DOUBLE	mm/d	-	-	0.0
input	iDoHarvest	Trigger for harvesting	BOOLEAN	1	-	-	false
input	iDoSow	Trigger for sowing	BOOLEAN	1	-	-	false
input	iFERNA	Ammonium-N application rate	DOUBLE	g/(m2 d)	-	-	0.0
input	iFERNN	Nitrate-N application rate	DOUBLE	g/(m2 d)	-	-	0.0
input	iIRRI	Rate of water added by irrigation	DOUBLE	mm/d	-	-	0.0
input	iLITC	Litter carbon entering the soil	DOUBLE	g/(m2 d)	-	-	0.0
input	iLITN	Litter nitrogen entering the soil	DOUBLE	g/(m2 d)	-	-	0.0
input	iNINPA	User-defined ammonium-N supply to crop	DOUBLE	g/(m2 d)	-	-	0.0
input	iNINPN	User-defined nitrate-N supply to crop	DOUBLE	g/(m2 d)	-	-	0.0
input	iNUPTA	Ammonium-N uptake by the crop	DOUBLE	g/(m2 d)	-	-	0.0
input	iNUPTN	Nitrate-N uptake by the crop	DOUBLE	g/(m2 d)	-	-	0.0
input	iRAIN	Precipitation	DOUBLE	mm	-	-	0.0
input	iRD	Rooting depth to the soil	DOUBLE	cm	-	-	0.0
input	iRRD	Rate of change in rooting depth of the soil	DOUBLE	cm/d	-	-	0.0
input	iTAVSS	Daily average temperature at the soil surface	DOUBLE	°C	-	-	0.0
input	iWINPUT	User-defined water supply to crop	DOUBLE	mm/d	-	-	0.0
state	sBIO	Microbial biomass in the soil	DOUBLE	g/m2	-	-	0.0
state	sDPM	Decomposable plant material	DOUBLE	g/m2	-	-	0.0
state	sDPN	Organic N in DPM	DOUBLE	g/m2	-	-	0.0
state	sHUM	Humified organic matter in soil	DOUBLE	g/m2	-	-	0.0
state	sNALL	Ammonium-N in the lower soil layer	DOUBLE	g/m2	-	-	0.0
state	sNAUL	Ammonium-N in the upper soil layer	DOUBLE	g/m2	-	-	0.0
state	sNNLL	Nitrate-N in the lower soil layer	DOUBLE	g/m2	-	-	0.0
state	sNNUL	Nitrate-N in the upper soil layer	DOUBLE	g/m2	-	-	0.0
state	sRPM	Resistant plant material (difficult to decompose)	DOUBLE	g/m2	-	-	0.0
state	sRPN	Organic N in resistant plant material (RPM)	DOUBLE	g/m2	-	-	0.0
state	sSFERNA	NH4-N fertilizer susceptible to volatilization	DOUBLE	g/m2	-	-	0.0
state	sTNLEA	Total nitrate-N leached to groundwater	DOUBLE	g/m2	-	-	0.0
state	sTSOIL	Soil temperature	DOUBLE	°C	-	-	0.0
state	sWLL	Water content in the lower soil layer	DOUBLE	mm	-	-	0.0
state	sWUL	Water content of the upper soil layer	DOUBLE	mm	-	-	0.0
out	DWSUP	Daily water supply for evapotranspiration	DOUBLE	mm/d	-	-	0.0
out	NMINER	Mineral N in the soil	DOUBLE	g/m2	-	-	0.0
out	NSUPA	Ammonium-N supply to crop	DOUBLE	g/(m2 d)	-	-	0.0
out	NSUPN	Nitrate-N supply to crop	DOUBLE	g/(m2 d)	-	-	0.0
out	WCUL	Water content of the upper soil layer	DOUBLE	m3/m3	-	-	0.0
out	WithCrop	crop is present	BOOLEAN	1	-	-	false

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
GecrosSoilWater()	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
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()	Initializes the fields by getting input and output FWSimVariables from VarMap Initial values are calculated and states are set to these initial Values.
protected void	initializeModel()
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

GecrosSoilWater

public GecrosSoilWater()

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 Initial values are calculated and states are set to these initial Values.

Specified by:

init in class net.simplace.sim.model.FWSimComponent

See Also:

• FWSimComponent.init()

initializeModel

protected void initializeModel()

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

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)