Class SimpleNitrogenMineralization
- All Implemented Interfaces:
net.simplace.sim.util.FWSimFieldContainer
A simple, low-data alternative to a full multi-pool soil C/N model (such as SoilCN), intended for situations where time or the data for a detailed model are not available.
The approach follows the mono-compartmental first-order kinetics of Stanford and Smith (1972): a single pool of potentially mineralizable organic N (N0) is depleted at a rate proportional to its current size, dN/dt = -k * N. The potential rate constant k is scaled daily by a dimensionless soil-temperature factor (Q10 approach) and a dimensionless soil-moisture factor (trapezoidal, optimum near field capacity):
rNMineralized = sPotentiallyMineralizableN * cRateConstant * TemperatureFactor * MoistureFactor
This component is designed to be used together with
NMineralizationTemperatureFactor and
NMineralizationMoistureFactor, e.g. combined
into a single SimComponentGroup ("composition") so the three appear as one component to the
rest of the model. See SimpleNMineralization_grp.xml.
Note that this component only covers mineralization of an existing, pre-set organic N pool. It does not add fresh residue N to that pool - if that is needed, it would have to be added as an extra input/rate feeding into sPotentiallyMineralizableN in a later extension.
Validation reference (observed field data)
A rough order-of-magnitude check against real, published net N mineralization data: Wade, Burger and Horwath (2015, UC Davis / California FREP soil respiration study) report aerobic lab-incubation net N mineralization (Stanford and Smith method, air-dried and rewetted soils, cover-cropped California fields) at three incubation dates, converted here from lbs N/ac to kg N/ha (factor 1.121):
day 28: 43.5 - 75.3 lbs N/ac =~ 49 - 84 kg N/ha
day 56: 44.5 - 72.4 lbs N/ac =~ 50 - 81 kg N/ha
day 105: 52.6 - 88.2 lbs N/ac =~ 59 - 99 kg N/ha
Running this component once per day for 105 days at TemperatureFactor = MoistureFactor = 1 (i.e. assuming near-optimal incubation conditions, consistent with the lab method) with cInitialPotentiallyMineralizableN = 120 kg N/ha and cRateConstant = 0.013 d-1 (well within the commonly reported Stanford-Smith range of roughly 0.05-0.1 wk-1) reproduces day 56 (~62 kg N/ha) and day 105 (~90 kg N/ha) inside the observed ranges above. Day 28 (~37 kg N/ha) is still somewhat below the observed range - a known structural limitation of a single-pool exponential model, which cannot fully reproduce the faster early-time release captured by the square-root-of-time behaviour Stanford and Smith (1972) originally described; a two-pool extension would be needed to fix that if the early days matter for a given use case.
References
Stanford and Smith, 1972: Nitrogen mineralization potentials of soils. Soil Science Society of America Journal 36 Wade, Burger and Horwath, 2015: Soil Respiration Tests as Predictors of Nitrogen Mineralization Potential. UC Davis / California FREP conference presentation
Component Variables
| Content Type | Name | Description | Data Type | Unit | Min Value | Max Value | Default Value |
|---|---|---|---|---|---|---|---|
| constant | cInitialPotentiallyMineralizableN | initial size of the potentially mineralizable N pool, used to initialize the state variable at the start of the simulation | DOUBLE | kg/ha | 0.0 | - | 100.0 |
| constant | cRateConstant | potential (unscaled) first-order mineralization rate constant of the N pool | DOUBLE | per_day | 0.0 | 0.05 | 0.0025 |
| input | iMoistureFactor | dimensionless soil-moisture response factor for N mineralization | DOUBLE | 1 | - | - | 1.0 |
| input | iTemperatureFactor | dimensionless soil-temperature response factor for N mineralization | DOUBLE | 1 | - | - | 1.0 |
| state | sPotentiallyMineralizableN | remaining size of the potentially mineralizable N pool | DOUBLE | kg/ha | 0.0 | - | 0.0 |
| rate | rNMineralized | daily net soil nitrogen mineralization | DOUBLE | kilogram_per_hectare_per_day | - | - | 0.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 VarMap.protected 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
-
SimpleNitrogenMineralization
public SimpleNitrogenMineralization()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. Sets the state variable to its configured initial pool size.- 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: default parameters, one day at reference conditions (both factors = 1) -> rNMineralized = 100 * 0.0025 * 1 * 1 = 0.25, remaining pool = 99.75. Test case 1: field-calibrated parameter set from the validation note in the class Javadoc (N0 = 120 kg N/ha, k = 0.013 d-1), one day at reference conditions -> rNMineralized = 120 * 0.013 = 1.56, remaining pool = 118.44. Running this parameter set once per day for 105 days approximates the observed field range reported by Wade, Burger and Horwath (2015), see the class Javadoc.- 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:
-