Class NMineralizationMoistureFactor

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

public class NMineralizationMoistureFactor extends net.simplace.sim.model.FWSimComponent
Calculates a dimensionless soil-moisture response factor for nitrogen mineralization, part of a simple, low-data soil N mineralization approach (see 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 TypeNameDescriptionData TypeUnitMin ValueMax ValueDefault Value
constantcFieldCapacityfield capacity water content of the considered soil layerDOUBLEm3/m30.01.00.3
constantcMinFactorWhenWaterloggedfloor value of the moisture factor under waterlogged conditionsDOUBLE10.01.00.5
constantcOnsetFractionwater content, as a fraction of field capacity, below which the moisture factor is 0DOUBLE10.01.00.3
constantcOptimumHighwater content, as a fraction of field capacity, up to which the moisture factor stays at 1DOUBLE10.01.51.0
constantcOptimumLowwater content, as a fraction of field capacity, at which the moisture factor first reaches 1DOUBLE10.01.50.8
constantcSaturationRatiowater content, as a fraction of field capacity, at which the moisture factor reaches its waterlogged floorDOUBLE11.02.01.3
inputiSoilWaterContentcurrent water content of the considered soil layerDOUBLEm3/m3--0.0
outMoistureFactordimensionless soil-moisture response factor for N mineralization (0-1)DOUBLE1--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
    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

    • NMineralizationMoistureFactor

      public NMineralizationMoistureFactor()
      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
      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: 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:
      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)