Class NMineralizationMoistureFactor
- All Implemented Interfaces:
net.simplace.sim.util.FWSimFieldContainer
SimpleNitrogenMineralization).
Calculates how soil water content scales the rate of nitrogen mineralization, using a trapezoidal response function expressed relative to field capacity. The factor is 0 below a configurable "onset" fraction of field capacity, rises linearly to 1 towards field capacity, stays at 1 in an optimum window around field capacity (net mineralization has repeatedly been found to peak around 80-100% of field capacity), and then declines again towards a waterlogged floor value for water contents above field capacity (oxygen limitation). Only soil water content and field capacity are required; the shape parameters have literature-informed defaults and can be left untouched for a first, overview-level run.
References
and Jones, 1991: Nitrogen dynamics in soil-plant systems - trapezoidal soil water factor for mineralization/decomposition used in CERES-type models studies (e.g. on Q10 and moisture response of N mineralization) report a net mineralization optimum around 80-100% of field capacity
Component Variables
| Content Type | Name | Description | Data Type | Unit | Min Value | Max Value | Default Value |
|---|---|---|---|---|---|---|---|
| constant | cFieldCapacity | field capacity water content of the considered soil layer | DOUBLE | m3/m3 | 0.0 | 1.0 | 0.3 |
| constant | cMinFactorWhenWaterlogged | floor value of the moisture factor under waterlogged conditions | DOUBLE | 1 | 0.0 | 1.0 | 0.5 |
| constant | cOnsetFraction | water content, as a fraction of field capacity, below which the moisture factor is 0 | DOUBLE | 1 | 0.0 | 1.0 | 0.3 |
| constant | cOptimumHigh | water content, as a fraction of field capacity, up to which the moisture factor stays at 1 | DOUBLE | 1 | 0.0 | 1.5 | 1.0 |
| constant | cOptimumLow | water content, as a fraction of field capacity, at which the moisture factor first reaches 1 | DOUBLE | 1 | 0.0 | 1.5 | 0.8 |
| constant | cSaturationRatio | water content, as a fraction of field capacity, at which the moisture factor reaches its waterlogged floor | DOUBLE | 1 | 1.0 | 2.0 | 1.3 |
| input | iSoilWaterContent | current water content of the considered soil layer | DOUBLE | m3/m3 | - | - | 0.0 |
| out | MoistureFactor | dimensionless soil-moisture response factor for N mineralization (0-1) | DOUBLE | 1 | - | - | 1.0 |
- Author:
- Andreas Enders, Claude AI
-
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 -
Method Summary
Modifier and TypeMethodDescriptionprotected net.simplace.sim.model.FWSimComponentclone(net.simplace.sim.util.FWSimVarMap aVarMap) Create the FWSimVariables as interface for this SimComponentfillTestVariables(int aParamIndex, net.simplace.sim.model.FWSimComponent.TEST_STATE aDefineOrCheck) called for single component test to check the components algorithm.protected voidinit()Initializes the fields by getting input and output FWSimVariables from VarMapprotected voidprocess()Process the algorithm and write the results back to VarMapMethods 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
-
Constructor Details
-
NMineralizationMoistureFactor
public NMineralizationMoistureFactor()Empty constructor used by class.forName()
-
-
Method Details
-
createVariables
Create the FWSimVariables as interface for this SimComponent- Specified by:
createVariablesin interfacenet.simplace.sim.util.FWSimFieldContainer- Specified by:
createVariablesin classnet.simplace.sim.model.FWSimComponent- See Also:
-
init
protected void init()Initializes the fields by getting input and output FWSimVariables from VarMap- Specified by:
initin classnet.simplace.sim.model.FWSimComponent- See Also:
-
process
protected void process()Process the algorithm and write the results back to VarMap- Specified by:
processin classnet.simplace.sim.model.FWSimComponent- See Also:
-
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. Test case 0: water content at 50% of field capacity, halfway up the rising branch (onset 30%, optimum 80% of FC) -> factor must be (0.5-0.3)/(0.8-0.3) = 0.4. Test case 1: water content exactly at field capacity (100%), inside the optimum plateau (80-100% of FC) -> factor must be 1. Test case 2: water content at 120% of field capacity, on the waterlogged branch (plateau ends at 100%, floor of 0.5 reached at 130%) -> factor must be 1 - (1-0.5)/(1.3-1.0) * (1.2-1.0) = 0.667.- Specified by:
fillTestVariablesin classnet.simplace.sim.model.FWSimComponent
-
clone
protected net.simplace.sim.model.FWSimComponent clone(net.simplace.sim.util.FWSimVarMap aVarMap) - Specified by:
clonein classnet.simplace.sim.model.FWSimComponent- See Also:
-