# earth-now.co
# Author:  Simon-Pierre Boucher
# Contact: contact@spboucher.ai
# File:    packages/registry/metrics/climate.yaml
# Purpose: MVP climate & atmosphere metrics (catalog §3, 🥇) — CO₂ ppm (Keeling vedette), temperature anomaly, carbon budget

metrics:
  - id: co2_ppm
    name: { fr: "Concentration CO₂ (Mauna Loa)", en: "CO₂ concentration (Mauna Loa)" }
    domain: climate
    priority: mvp
    kind: stock
    level: 2
    model: keeling-fusion-v1
    unit: ppm
    sources:
      - id: noaa_gml_mlo
        name: "NOAA Global Monitoring Laboratory — Mauna Loa"
        url: https://gml.noaa.gov/ccgg/trends/
        license: "US Government public domain (cite NOAA GML)"
        cadence: "daily/weekly"
    refresh: on_source_update
    display:
      decimals: 2
      sigFigs: 5
      unit: { fr: "ppm", en: "ppm" }
    constraints: { maxAbsRatePerSec: 0.00001, maxJumpOnRefit: 1 }
    windows: [total]

  - id: temp_anomaly
    name:
      fr: "Anomalie de température globale (vs 1850-1900)"
      en: "Global temperature anomaly (vs 1850-1900)"
    domain: climate
    priority: mvp
    kind: stock
    level: 2
    model: seasonal-spline-v2
    unit: degC
    sources:
      - id: copernicus_era5
        name: "Copernicus C3S / ERA5"
        url: https://climate.copernicus.eu/
        license: "Copernicus licence — free use with attribution"
        cadence: monthly
      - id: berkeley_earth
        name: "Berkeley Earth"
        url: https://berkeleyearth.org/data/
        license: "CC BY 4.0"
        cadence: monthly
    refresh: on_source_update
    display:
      decimals: 2
      sigFigs: 3
      unit: { fr: "°C", en: "°C" }
    constraints: { maxAbsRatePerSec: 0.0000001, maxJumpOnRefit: 0.05 }
    windows: [total]
    uncertaintyFraction: 0.08

  - id: carbon_budget_remaining
    name:
      fr: "Budget carbone 1,5 °C restant"
      en: "Remaining 1.5 °C carbon budget"
    domain: climate
    priority: mvp
    kind: derived
    level: derived
    model: derived
    unit: t_co2
    sources:
      - id: ipcc_ar6_gcb
        name: "IPCC AR6 + Global Carbon Budget (updated)"
        url: https://www.globalcarbonproject.org/carbonbudget/
        license: "CC BY 4.0"
        cadence: yearly
    refresh: on_source_update
    display:
      decimals: 1
      sigFigs: 3
      scale: 0.000000001
      unit: { fr: "Gt CO₂", en: "Gt CO₂" }
    windows: [total]
    derived:
      op: linear-combination
      constant: 197000000000
      inputs: [{ id: co2_emissions_ytd, weight: -1 }]
    uncertaintyFraction: 0.5
    editorialNote:
      fr: "Budget 50 % de chances de rester sous +1,5 °C, au 1er janvier 2026 — intervalle très large, affiché obligatoirement."
      en: "Budget for a 50 % chance of staying under +1.5 °C, as of Jan 1 2026 — very wide interval, always displayed."

  - id: carbon_budget_years_remaining
    name:
      fr: "Temps restant avant épuisement du budget 1,5 °C"
      en: "Time left before the 1.5 °C budget runs out"
    domain: climate
    priority: mvp
    kind: derived
    level: derived
    model: derived
    unit: years
    sources:
      - id: ipcc_ar6_gcb
        name: "IPCC AR6 + Global Carbon Budget (derived)"
        url: https://www.globalcarbonproject.org/carbonbudget/
        license: "CC BY 4.0"
        cadence: yearly
    refresh: on_source_update
    display:
      decimals: 1
      sigFigs: 2
      unit: { fr: "années", en: "years" }
    windows: [total]
    derived:
      op: depletion-countdown
      inputs: [{ id: carbon_budget_remaining, weight: 1 }]
    uncertaintyFraction: 0.5
    editorialNote:
      fr: "Dérivé : budget restant ÷ taux d'émission courant. Estimation, intervalle affiché."
      en: "Derived: remaining budget ÷ current emission rate. Estimate, interval displayed."