# earth-now.co
# Author:  Simon-Pierre Boucher
# Contact: contact@spboucher.ai
# File:    packages/registry/metrics/forest.yaml
# Purpose: MVP forest metrics (catalog §5, 🥇) — tree cover loss YTD/today and football-pitch equivalent

metrics:
  - id: forest_loss_ytd
    name: { fr: "Forêt perdue cette année", en: "Forest lost this year" }
    domain: forest
    priority: mvp
    kind: cumulative
    level: 1
    model: seasonal-ytd-v1
    unit: ha
    sources:
      - id: gfw_glad
        name: "Global Forest Watch / GLAD alerts"
        url: https://www.globalforestwatch.org/
        license: "CC BY 4.0"
        cadence: "weekly alerts + annual"
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 4
      unit: { fr: "hectares", en: "hectares" }
    constraints: { maxAbsRatePerSec: 5, maxJumpOnRefit: 100000 }
    windows: [ytd, today, session]
    editorialNote:
      fr: "Perte brute de couvert arboré (GFW) — pas la déforestation nette ; méthode affichée au clic."
      en: "Gross tree-cover loss (GFW) — not net deforestation; method shown on click."

  - id: forest_loss_today
    name: { fr: "Forêt perdue aujourd'hui", en: "Forest lost today" }
    domain: forest
    priority: mvp
    kind: derived
    level: derived
    model: derived
    unit: ha
    sources:
      - id: gfw_glad
        name: "Global Forest Watch (derived)"
        url: https://www.globalforestwatch.org/
        license: "CC BY 4.0"
        cadence: "weekly alerts + annual"
    refresh: on_source_update
    display:
      decimals: 0
      sigFigs: 4
      unit: { fr: "hectares", en: "hectares" }
    windows: [today, session]
    derived:
      op: window
      window: today
      inputs: [{ id: forest_loss_ytd, weight: 1 }]

  - id: forest_loss_football_fields
    name:
      fr: "Équivalent terrains de football perdus"
      en: "Football pitches of forest lost"
    domain: forest
    priority: mvp
    kind: derived
    level: derived
    model: derived
    unit: pitches
    sources:
      - id: gfw_glad
        name: "Global Forest Watch (derived, 1 pitch = 0.714 ha)"
        url: https://www.globalforestwatch.org/
        license: "CC BY 4.0"
        cadence: "weekly alerts + annual"
    refresh: on_source_update
    display:
      decimals: 1
      sigFigs: 3
      unit: { fr: "terrains de football", en: "football pitches" }
    windows: [today, session]
    derived:
      op: linear-combination
      inputs: [{ id: forest_loss_ytd, weight: 1.4005602 }]