food_chain/PARAMETER-PROVENANCE.json

{
  "schemaVersion": 1,
  "modelVersion": "43.0.0",
  "parameters": {
    "timeStepDays": {
      "value": 0.041666666666666664,
      "unit": "day",
      "sourceType": "implementation-plan",
      "note": "1/24 day"
    },
    "phytoplankton.muMax": {
      "equation": "0.81 * exp(0.0631 * temperatureC)",
      "unit": "day^-1",
      "environment": [
        "freshwater",
        "marine"
      ],
      "source": "Bissinger et al. 2008; updated Eppley temperature-growth relation",
      "sourceType": "primary-study"
    },
    "assimilation.plant": {
      "value": 0.45,
      "unit": "fraction",
      "sourceType": "published-food-web-model"
    },
    "assimilation.animal": {
      "value": 0.85,
      "unit": "fraction",
      "sourceType": "published-food-web-model"
    },
    "metabolism.massExponent": {
      "value": 0.75,
      "unit": "dimensionless",
      "source": "Gillooly et al. metabolic scaling framework",
      "sourceType": "primary-study-framework"
    },
    "metabolism.ectotherm.activationEnergy": {
      "value": 0.65,
      "unit": "eV",
      "sourceType": "model-calibration",
      "note": "Arrhenius temperature response normalization used by the simulator"
    },
    "metabolism.B0.ectotherm": {
      "value": 42,
      "unit": "kJ day^-1 at 1 kg",
      "sourceType": "model-calibration"
    },
    "metabolism.B0.endotherm": {
      "value": 310,
      "unit": "kJ day^-1 at 1 kg",
      "sourceType": "model-calibration"
    },
    "producer.terrestrial.rMax": {
      "value": 0.03,
      "unit": "day^-1",
      "sourceType": "implementation-plan-fallback"
    },
    "producer.terrestrial.K": {
      "value": 0.5,
      "unit": "kg m^-2",
      "sourceType": "implementation-plan-fallback"
    },
    "producer.freshwater.K": {
      "value": 0.18,
      "unit": "kg m^-2",
      "sourceType": "model-calibration"
    },
    "producer.marine.K": {
      "value": 0.14,
      "unit": "kg m^-2",
      "sourceType": "model-calibration"
    },
    "predatorPreyRatio.terrestrial": {
      "value": 35,
      "unit": "predator/prey mass ratio",
      "source": "Brose et al. relationship used as structural basis",
      "sourceType": "model-calibration"
    },
    "predatorPreyRatio.freshwater": {
      "value": 80,
      "unit": "predator/prey mass ratio",
      "source": "Brose et al. freshwater tendency used as structural basis",
      "sourceType": "model-calibration"
    },
    "predatorPreyRatio.marine": {
      "value": 55,
      "unit": "predator/prey mass ratio",
      "source": "Brose et al. relationship used as structural basis",
      "sourceType": "model-calibration"
    },
    "feeding.rall.attack": {
      "activationEnergyEv": 0.44,
      "consumerMassExponent": 0.47,
      "resourceMassExponent": 0.15,
      "source": "Rall et al. 2012, all-data only-slopes model",
      "sourceType": "primary-study"
    },
    "feeding.rall.handling": {
      "activationEnergyEv": -0.27,
      "consumerMassExponent": -0.48,
      "resourceMassExponent": 0.34,
      "source": "Rall et al. 2012, all-data only-slopes model",
      "sourceType": "primary-study"
    },
    "feeding.rall.localResiduals": {
      "attackMassRatio": "-1.81 + 0.37*ln(R) - 0.017*ln(R)^2",
      "handlingMassRatio": "1.93 - 0.48*ln(R) + 0.026*ln(R)^2",
      "handlingTemperature": "0.51 - 0.055*T + 0.0013*T^2",
      "source": "Rall et al. 2012 residual analysis",
      "sourceType": "primary-study",
      "note": "normalized relative to 20 C and each profile's preferred predator/prey ratio"
    },
    "feeding.edgeBaselines": {
      "sourceType": "model-calibration",
      "note": "default attackRate and handlingTimeDays are simulator baselines; Rall scaling is applied at runtime"
    },
    "movement.maximumSpeed.running": {
      "a": 25.5,
      "b": 0.26,
      "h": 22.0,
      "i": -0.6,
      "equation": "v_kmh = a*M^b*(1-exp(-h*M^i))",
      "source": "Hirt et al. 2017 Supplementary Table 4",
      "sourceType": "primary-study"
    },
    "movement.maximumSpeed.flying": {
      "a": 142.8,
      "b": 0.24,
      "h": 2.4,
      "i": -0.72,
      "equation": "v_kmh = a*M^b*(1-exp(-h*M^i))",
      "source": "Hirt et al. 2017 Supplementary Table 4",
      "sourceType": "primary-study"
    },
    "movement.maximumSpeed.swimming": {
      "a": 11.2,
      "b": 0.36,
      "h": 19.5,
      "i": -0.56,
      "equation": "v_kmh = a*M^b*(1-exp(-h*M^i))",
      "source": "Hirt et al. 2017 Supplementary Table 4",
      "sourceType": "primary-study"
    },
    "movement.behaviourFractions": {
      "sourceType": "model-calibration",
      "note": "routine/foraging/escape fractions and free-roaming waypoint scale are simulator behaviour parameters; they are not claimed as Hirt coefficients"
    },
    "zooplankton.cohort": {
      "sourceType": "model-calibration",
      "note": "cohort ingestion/mortality coefficients are provisional simulator calibration values"
    },
    "energy.plant": {
      "value": 18000,
      "unit": "kJ kg^-1",
      "sourceType": "model-calibration/reference-value"
    },
    "energy.animal": {
      "value": 7000,
      "unit": "kJ kg^-1",
      "sourceType": "model-calibration/reference-value"
    },
    "energy.reserveCapacity": {
      "value": 1200,
      "unit": "kJ kg^-1 body mass",
      "sourceType": "model-calibration"
    },
    "growth.energyCost": {
      "value": 6000,
      "unit": "kJ kg^-1 structural growth",
      "sourceType": "model-calibration",
      "note": "juvenile structural mass gain is limited by surplus reserve energy; adult mass remains the genome target"
    },
    "water.initialRadiusMultiplier": {
      "value": 1.4142135623730951,
      "unit": "radius ratio",
      "sourceType": "user-requirement",
      "note": "sqrt(2); gives roughly twice initial water area without measuring or optimizing union area"
    },
    "water.userEditMultiplier": {
      "value": 1,
      "unit": "radius ratio",
      "sourceType": "user-requirement",
      "note": "user-edited geometry is applied as supplied"
    },
    "water.addToolDefaultRadiusM": {
      "value": 170,
      "unit": "m",
      "sourceType": "compatibility",
      "note": "same default as v38"
    },
    "movement.grazingSpeed": {
      "routineFraction": 0.55,
      "minimumMPerDay": 45,
      "sourceType": "model-calibration",
      "note": "while feeding from continuous producer/zooplankton fields, navigation continues at a reduced fraction of routine travel speed; no fixed 90 m/day cap"
    },
    "movement.spawnShorelineClearance": {
      "value": 24,
      "unit": "m minimum before body-radius adjustment",
      "sourceType": "simulation-structure",
      "note": "prevents initial non-amphibious agents from being snapped directly onto the habitat boundary"
    },
    "movement.staminaRecovery": {
      "equation": "capacity_fraction_per_day = clamp((0.46 + 0.32*gene) * (M/3)^-0.035, 0.62, 1.45)",
      "sourceType": "model-calibration",
      "note": "capacity-relative recovery; routine travel does not consume sprint stamina"
    },
    "movement.sprintStaminaDrain": {
      "equation": "capacity_fraction_per_day = 0.72 + 0.48*clamp(speed/routineSpeed - 1, 0, 2)",
      "sourceType": "model-calibration",
      "note": "applied only to escape/chase sprint states"
    },
    "ui.normalPlaybackRate": {
      "value": 1,
      "unit": "simulated day per real second at x1 target",
      "sourceType": "interface-setting",
      "note": "playback target only; ecological dt remains 1/24 day and actual throughput is reported separately"
    },
    "feeding.fieldResources": {
      "massExponent": 0.78,
      "producerMaxIntakeCoefficient": 0.16,
      "producerHalfSaturationKgPerM2": 0.08,
      "zooplanktonMaxIntakeCoefficient": 0.12,
      "zooplanktonHalfSaturationKgPerM2": 0.012,
      "sourceType": "model-calibration",
      "note": "continuous producer/zooplankton biomass fields use density-based Holling saturation; field density is not treated as an individual prey body mass and is not passed through Rall predator:prey mass-ratio scaling"
    },
    "demography.breedingPhase": {
      "equation": "phaseDays = (speciesId * 137.508) mod 365",
      "unit": "day of annual cycle",
      "sourceType": "simulation-structure",
      "note": "staggers generic species breeding windows so all species in one trophic role do not reproduce in lockstep; window lengths and intervals remain role fallbacks"
    },
    "movement.socialSteering": {
      "sourceType": "model-calibration",
      "note": "position-only separation plus weak centroid attraction; neighbor velocities and any rotation/spin detector are intentionally excluded to prevent self-sustaining milling feedback"
    }
  }
}