spb/earth-now Public License

1# earth-now.co2# Author:  Simon-Pierre Boucher3# Contact: contact@spboucher.ai4# File:    packages/registry/metrics/energy.yaml5# Purpose: MVP energy metrics (catalog §6, 🥇) — electricity produced, renewable share, coal burned, oil pumped67metrics:8  - id: electricity_ytd9    name: { fr: "Électricité produite cette année", en: "Electricity generated this year" }10    domain: energy11    priority: mvp12    kind: cumulative13    level: 114    model: seasonal-ytd-v115    unit: MWh16    sources:17      - id: ember_202518        name: "Ember — Global Electricity Review / monthly data"19        url: https://ember-energy.org/20        license: "CC BY 4.0"21        cadence: monthly22      - id: iea_electricity23        name: "IEA Electricity"24        url: https://www.iea.org/data-and-statistics25        license: "CC BY 4.0"26        cadence: yearly27    refresh: on_source_update28    display:29      decimals: 230      sigFigs: 531      scale: 0.00000132      unit: { fr: "TWh", en: "TWh" }33    constraints: { maxAbsRatePerSec: 2000, maxJumpOnRefit: 20000000 }34    windows: [ytd, today, session]3536  - id: renewable_share37    name:38      fr: "Part renouvelable de l'électricité"39      en: "Renewable share of electricity"40    domain: energy41    priority: mvp42    kind: stock43    level: 244    model: seasonal-spline-v245    unit: percent46    sources:47      - id: ember_202548        name: "Ember — Global Electricity Review"49        url: https://ember-energy.org/50        license: "CC BY 4.0"51        cadence: monthly52    refresh: on_source_update53    display:54      decimals: 155      sigFigs: 356      unit: { fr: "%", en: "%" }57    constraints: { maxAbsRatePerSec: 0.000001, maxJumpOnRefit: 0.5 }58    windows: [total]59    editorialNote:60      fr: "v0.1 : tendance annuelle lissée — la saisonnalité intra-annuelle (hydro, solaire) sera ajoutée avec les données mensuelles Ember."61      en: "v0.1: smoothed annual trend — intra-year seasonality (hydro, solar) lands with Ember monthly data."6263  - id: coal_burned_ytd64    name: { fr: "Charbon brûlé cette année", en: "Coal burned this year" }65    domain: energy66    priority: mvp67    kind: cumulative68    level: 169    model: seasonal-ytd-v170    unit: t71    sources:72      - id: iea_coal73        name: "IEA Coal / Energy Institute Statistical Review"74        url: https://www.iea.org/reports/coal-202475        license: "CC BY 4.0"76        cadence: yearly77    refresh: on_source_update78    display:79      decimals: 080      sigFigs: 481      unit: { fr: "tonnes", en: "tonnes" }82    constraints: { maxAbsRatePerSec: 600, maxJumpOnRefit: 10000000 }83    windows: [ytd, today, session]8485  - id: oil_pumped_ytd86    name: { fr: "Pétrole pompé cette année", en: "Oil pumped this year" }87    domain: energy88    priority: mvp89    kind: cumulative90    level: 191    model: seasonal-ytd-v192    unit: barrels93    sources:94      - id: eia_opec95        name: "US EIA / OPEC monthly reports"96        url: https://www.eia.gov/97        license: "US Government public domain"98        cadence: monthly99    refresh: on_source_update100    display:101      decimals: 0102      sigFigs: 5103      unit: { fr: "barils", en: "barrels" }104    constraints: { maxAbsRatePerSec: 2500, maxJumpOnRefit: 50000000 }105    windows: [ytd, today, session]106107  - id: solar_installed_ytd108    name: { fr: "Capacité solaire installée cette année", en: "Solar capacity installed this year" }109    domain: energy110    priority: v1111    kind: cumulative112    level: 1113    model: seasonal-ytd-v1114    unit: W115    sources:116      - id: irena_bnef117        name: "IRENA / BloombergNEF — annual solar additions"118        url: https://www.irena.org/Data119        license: "IRENA open data — citation required"120        licenseNote: "verify reuse terms before launch"121        cadence: yearly122    refresh: on_source_update123    display:124      decimals: 0125      sigFigs: 4126      scale: 0.001127      unit: { fr: "kW", en: "kW" }128    constraints: { maxAbsRatePerSec: 30000, maxJumpOnRefit: 5000000000 }129    windows: [session, today, ytd]130    editorialNote:131      fr: "~600 GW ajoutés en 2026 (IRENA/BNEF), pic d'installations en fin d'année modélisé — regardez la fenêtre « depuis votre arrivée »."132      en: "~600 GW added in 2026 (IRENA/BNEF), year-end installation rush modelled — watch the 'since you arrived' window."133