Class SimpleNitrogenMineralization

java.lang.Object
net.simplace.sim.model.FWSimComponent
net.simplace.sim.components.experimental.amei.nmin.SimpleNitrogenMineralization
All Implemented Interfaces:
net.simplace.sim.util.FWSimFieldContainer

public class SimpleNitrogenMineralization extends net.simplace.sim.model.FWSimComponent
Calculates daily net soil nitrogen mineralization from a single "potentially mineralizable N" pool, scaled by soil-temperature and soil-moisture response factors.

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 TypeNameDescriptionData TypeUnitMin ValueMax ValueDefault Value
constantcInitialPotentiallyMineralizableNinitial size of the potentially mineralizable N pool, used to initialize the state variable at the start of the simulationDOUBLEkg/ha0.0-100.0
constantcRateConstantpotential (unscaled) first-order mineralization rate constant of the N poolDOUBLEper_day0.00.050.0025
inputiMoistureFactordimensionless soil-moisture response factor for N mineralizationDOUBLE1--1.0
inputiTemperatureFactordimensionless soil-temperature response factor for N mineralizationDOUBLE1--1.0
statesPotentiallyMineralizableNremaining size of the potentially mineralizable N poolDOUBLEkg/ha0.0-0.0
raterNMineralizeddaily net soil nitrogen mineralizationDOUBLEkilogram_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
    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

    • SimpleNitrogenMineralization

      public SimpleNitrogenMineralization()
      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. Sets the state variable to its configured initial pool size.
      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. 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:
      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)