RemoteConditions

{
  "reference": {
    "notes": "source_ref: GasChem.jl@8c12c048482b515fb8eb2110bf8ab4b4f4e71309:src/combined_system.jl:261\nUpstream `RemoteConditions` is an MTK `@component` declaring 11 species-concentration parameters (M, O2, H2O, O3, NO, NO2, CO, CH4, OH, HO2, CH3O2) and 11 corresponding output variables (`*_out`). The 11 equations are pure identity assignments `*_out ~ *`. There are no time derivatives, no kinetics — the model exists so a downstream system can read preset concentrations through a uniform variable interface (e.g., `RemoteConditions().O3_out` rather than reaching into `parameters(sys)` to find the matching @parameter).\n\nObservability classification: observed-only — all 11 `*_out` variables are determined by trivial algebraic equations from the 11 parameters. Equivalent to evaluating `get_conditions_dict(RemoteConditions())` upstream.\n\nTolerance rationale (model-level rel=1e-12): the equations are exact identity assignments. Floating-point round-off is ~1e-15; 1e-12 is comfortably tight without being fragile across MTK simplification permutations."
  },
  "tolerance": {
    "rel": 1e-12
  },
  "variables": {
    "M": {
      "type": "parameter",
      "units": "m^-3",
      "default": 2.5e+25,
      "description": "Total air at STP"
    },
    "O2": {
      "type": "parameter",
      "units": "m^-3",
      "default": 5.25e+24,
      "description": "O₂, 21% of M"
    },
    "H2O": {
      "type": "parameter",
      "units": "m^-3",
      "default": 4e+23,
      "description": "Water vapor"
    },
    "O3": {
      "type": "parameter",
      "units": "m^-3",
      "default": 7.5e+17,
      "description": "Ozone, ~30 ppb"
    },
    "NO": {
      "type": "parameter",
      "units": "m^-3",
      "default": 250000000000000.0,
      "description": "NO, ~10 ppt"
    },
    "NO2": {
      "type": "parameter",
      "units": "m^-3",
      "default": 500000000000000.0,
      "description": "NO₂, ~20 ppt"
    },
    "CO": {
      "type": "parameter",
      "units": "m^-3",
      "default": 2e+18,
      "description": "CO, ~80 ppb"
    },
    "CH4": {
      "type": "parameter",
      "units": "m^-3",
      "default": 4.5e+19,
      "description": "CH₄, ~1800 ppb"
    },
    "OH": {
      "type": "parameter",
      "units": "m^-3",
      "default": 1000000000000.0,
      "description": "OH, typical daytime"
    },
    "HO2": {
      "type": "parameter",
      "units": "m^-3",
      "default": 200000000000000.0,
      "description": "HO₂, higher due to low NOx"
    },
    "CH3O2": {
      "type": "parameter",
      "units": "m^-3",
      "default": 200000000000000.0,
      "description": "CH₃O₂"
    },
    "M_out": {
      "type": "unknown",
      "units": "m^-3",
      "description": "Total air number density"
    },
    "O2_out": {
      "type": "unknown",
      "units": "m^-3",
      "description": "O₂ concentration"
    },
    "H2O_out": {
      "type": "unknown",
      "units": "m^-3",
      "description": "Water vapor concentration"
    },
    "O3_out": {
      "type": "unknown",
      "units": "m^-3",
      "description": "Ozone concentration"
    },
    "NO_out": {
      "type": "unknown",
      "units": "m^-3",
      "description": "NO concentration"
    },
    "NO2_out": {
      "type": "unknown",
      "units": "m^-3",
      "description": "NO₂ concentration"
    },
    "CO_out": {
      "type": "unknown",
      "units": "m^-3",
      "description": "CO concentration"
    },
    "CH4_out": {
      "type": "unknown",
      "units": "m^-3",
      "description": "CH₄ concentration"
    },
    "OH_out": {
      "type": "unknown",
      "units": "m^-3",
      "description": "OH concentration"
    },
    "HO2_out": {
      "type": "unknown",
      "units": "m^-3",
      "description": "HO₂ concentration"
    },
    "CH3O2_out": {
      "type": "unknown",
      "units": "m^-3",
      "description": "CH₃O₂ concentration"
    }
  },
  "equations": [
    {
      "lhs": "M_out",
      "rhs": "M"
    },
    {
      "lhs": "O2_out",
      "rhs": "O2"
    },
    {
      "lhs": "H2O_out",
      "rhs": "H2O"
    },
    {
      "lhs": "O3_out",
      "rhs": "O3"
    },
    {
      "lhs": "NO_out",
      "rhs": "NO"
    },
    {
      "lhs": "NO2_out",
      "rhs": "NO2"
    },
    {
      "lhs": "CO_out",
      "rhs": "CO"
    },
    {
      "lhs": "CH4_out",
      "rhs": "CH4"
    },
    {
      "lhs": "OH_out",
      "rhs": "OH"
    },
    {
      "lhs": "HO2_out",
      "rhs": "HO2"
    },
    {
      "lhs": "CH3O2_out",
      "rhs": "CH3O2"
    }
  ],
  "tests": [
    {
      "id": "default_remote_preset",
      "description": "All 11 outputs should equal the upstream default remote-conditions preset values (Seinfeld & Pandis Ch 6 background regime). Reproduces `get_conditions_dict(RemoteConditions())` from GasChem.jl test/test_combined_system.jl.",
      "time_span": {
        "start": 0.0,
        "end": 1.0
      },
      "assertions": [
        {
          "variable": "M_out",
          "time": 0.0,
          "expected": 2.5e+25
        },
        {
          "variable": "O2_out",
          "time": 0.0,
          "expected": 5.25e+24
        },
        {
          "variable": "H2O_out",
          "time": 0.0,
          "expected": 4e+23
        },
        {
          "variable": "O3_out",
          "time": 0.0,
          "expected": 7.5e+17
        },
        {
          "variable": "NO_out",
          "time": 0.0,
          "expected": 250000000000000.0
        },
        {
          "variable": "NO2_out",
          "time": 0.0,
          "expected": 500000000000000.0
        },
        {
          "variable": "CO_out",
          "time": 0.0,
          "expected": 2e+18
        },
        {
          "variable": "CH4_out",
          "time": 0.0,
          "expected": 4.5e+19
        },
        {
          "variable": "OH_out",
          "time": 0.0,
          "expected": 1000000000000.0
        },
        {
          "variable": "HO2_out",
          "time": 0.0,
          "expected": 200000000000000.0
        },
        {
          "variable": "CH3O2_out",
          "time": 0.0,
          "expected": 200000000000000.0
        }
      ]
    },
    {
      "id": "remote_vs_typical_NO_low",
      "description": "Remote NO (2.5e14 m⁻³, ~10 ppt) should be ~1000× lower than typical NO (2.5e15 m⁻³, ~0.1 ppb). Override NO to the typical value and check that the preset reflects the original remote default at zero override. This test pins the canonical remote-NO defaults from GasChem.jl test/test_combined_system.jl line 89 (`@test remote[:NO] < typical[:NO]`).",
      "time_span": {
        "start": 0.0,
        "end": 1.0
      },
      "assertions": [
        {
          "variable": "NO_out",
          "time": 0.0,
          "expected": 250000000000000.0
        },
        {
          "variable": "NO2_out",
          "time": 0.0,
          "expected": 500000000000000.0
        }
      ]
    },
    {
      "id": "remote_vs_typical_HO2_high",
      "description": "Remote HO₂ (2.0e14 m⁻³) should be ~2× higher than typical HO₂ (1.0e14 m⁻³) because lower NOx leaves more HO₂ unconverted to OH. Pins the canonical remote-HO₂ default from GasChem.jl test/test_combined_system.jl line 91 (`@test remote[:HO2] > typical[:HO2]`).",
      "time_span": {
        "start": 0.0,
        "end": 1.0
      },
      "assertions": [
        {
          "variable": "HO2_out",
          "time": 0.0,
          "expected": 200000000000000.0
        }
      ]
    },
    {
      "id": "remote_air_density_equals_typical",
      "description": "Total air density M (2.5e25 m⁻³, STP) is regime-independent and equals the typical-conditions value. Pins GasChem.jl test/test_combined_system.jl line 92 (`@test remote[:M] ≈ typical[:M]`).",
      "time_span": {
        "start": 0.0,
        "end": 1.0
      },
      "assertions": [
        {
          "variable": "M_out",
          "time": 0.0,
          "expected": 2.5e+25
        },
        {
          "variable": "O2_out",
          "time": 0.0,
          "expected": 5.25e+24
        }
      ]
    },
    {
      "id": "parameter_override_passthrough",
      "description": "Override O3 and NO to non-default values; outputs should reflect the overrides exactly (identity equations). Confirms the model behaves as a pure pass-through.",
      "parameter_overrides": {
        "O3": 1.5e+18,
        "NO": 1e+16
      },
      "time_span": {
        "start": 0.0,
        "end": 1.0
      },
      "assertions": [
        {
          "variable": "O3_out",
          "time": 0.0,
          "expected": 1.5e+18
        },
        {
          "variable": "NO_out",
          "time": 0.0,
          "expected": 1e+16
        }
      ]
    }
  ],
  "analyses": [
    {
      "id": "default_remote_snapshot",
      "description": "Snapshot of the 11 default remote-conditions species concentrations. Reproduces the canonical preset used in GasChem.jl regime-comparison tests (RemoteConditions vs TypicalConditions vs UrbanConditions).",
      "initial_state": {},
      "time_span": {
        "start": 0.0,
        "end": 1.0
      },
      "plots": [
        {
          "id": "remote_concentrations_bar",
          "type": "line",
          "description": "Constant species concentrations under the remote preset — every *_out variable stays at its parameter default across the time span (no time evolution; preset model).",
          "x": {
            "variable": "t",
            "label": "time (s)"
          },
          "y": {
            "variable": "O3_out",
            "label": "O₃ concentration (m⁻³)"
          }
        }
      ]
    },
    {
      "id": "no_sweep",
      "description": "Sweep NO from a remote background (1e13 m⁻³, ~0.4 ppt) to mid-urban (1e17 m⁻³, ~4 ppb) to show how the preset interface propagates parameter overrides. Useful for downstream sensitivity tests against RemoteConditions defaults.",
      "initial_state": {},
      "time_span": {
        "start": 0.0,
        "end": 1.0
      },
      "parameter_sweep": {
        "type": "cartesian",
        "dimensions": [
          {
            "parameter": "NO",
            "range": {
              "start": 10000000000000.0,
              "stop": 1e+17,
              "count": 30
            }
          }
        ]
      },
      "plots": [
        {
          "id": "no_out_vs_no",
          "type": "line",
          "description": "NO_out vs NO override — confirms identity passthrough across four decades.",
          "x": {
            "variable": "NO",
            "label": "NO override (m⁻³)"
          },
          "y": {
            "variable": "NO_out",
            "label": "NO_out (m⁻³)"
          }
        }
      ]
    }
  ]
}