{
  "schema": "semiagora.photonics-causal-chain-metric-contract.v1",
  "version": "2026-08-23-v99",
  "experimentId": "SA-KNOW-PHOTONICS-001",
  "constants": {
    "planckConstantJs": 6.62607015e-34,
    "speedOfLightMPerS": 299792458,
    "elementaryChargeC": 1.602176634e-19,
    "provenance": "NIST 2022 CODATA exact SI values"
  },
  "equations": [
    {
      "id": "photon-energy",
      "expression": "E = h*c/lambda",
      "output": "photon_energy_j and photon_energy_ev",
      "boundary": "Vacuum wavelength relation only; no semiconductor absorption or transition probability."
    },
    {
      "id": "ideal-responsivity",
      "expression": "R_ideal = eta*q*lambda/(h*c)",
      "output": "ideal_one_electron_responsivity_a_per_w",
      "boundary": "Assumed external quantum efficiency and one collected electron per counted photon; not a material or calibrated detector model."
    },
    {
      "id": "led-wall-plug-ceiling-proxy",
      "expression": "WPE_proxy = eta_external*(h*c/(q*lambda))/V_forward",
      "output": "led_wall_plug_ceiling_proxy",
      "boundary": "Illustrative ceiling proxy only; no internal quantum efficiency, extraction, droop, series resistance, spectrum, thermal, or lifetime model."
    },
    {
      "id": "laser-threshold-contract",
      "expression": "Gamma*g_th = alpha_i + alpha_m",
      "output": "symbolic contract only",
      "boundary": "No numeric gain, confinement, internal loss, mirror loss, threshold current, or slope-efficiency calculation."
    },
    {
      "id": "all-pass-ring",
      "expression": "T = (a^2 - 2*a*r*cos(phi) + r^2)/(1 - 2*a*r*cos(phi) + a^2*r^2), phi = 2*pi*n_eff*L/lambda",
      "output": "all_pass_ring_transmission",
      "boundary": "Assumed scalar n_eff, loss, coupling, and geometry; no mode solve, dispersion, backscatter, bend loss, fabrication variation, or calibration."
    },
    {
      "id": "mzi-phase-and-transfer",
      "expression": "delta_phi = 2*pi*delta_n*L/lambda; P_norm = 0.5*(1 + visibility*cos(pi/2 + delta_phi))",
      "output": "mzi_phase_shift_rad and mzi_normalized_output",
      "boundary": "Assumed delta-n, length, bias, and visibility; no carrier model, junction, optical loss, voltage, bandwidth, or energy-per-bit calculation."
    }
  ],
  "fixedTeachingInputs": {
    "ringRadiusUm": 10,
    "effectiveIndex": 2.4,
    "mziLengthMm": 5,
    "mziBiasPhaseRad": 1.57079633,
    "mziVisibility": 0.98,
    "statement": "These values are original illustrative inputs selected to make equation behavior visible. They are not sourced device parameters or design recommendations."
  },
  "zeroBoundaryFields": [
    "external_device_performance_values_used",
    "real_measurement_rows_used",
    "calibrated_material_models_used",
    "fdtd_or_mode_solver_runs",
    "solar_efficiency_calculations",
    "laser_gain_solves",
    "live_server_runs"
  ]
}