spb/earth-now Public License

1# earth-now.co2# Author:  Simon-Pierre Boucher3# Contact: contact@spboucher.ai4# File:    packages/registry/metrics/population.yaml5# Purpose: MVP population & demography metrics (catalog §1, all 🥇) — UN WPP driven67metrics:8  - id: world_population9    name: { fr: "Population mondiale", en: "World population" }10    domain: population11    priority: mvp12    kind: stock13    level: 214    model: seasonal-spline-v215    unit: people16    sources:17      - id: un_wpp_202418        name: "UN World Population Prospects 2024"19        url: https://population.un.org/wpp/20        license: "CC BY 3.0 IGO"21        cadence: yearly22        variants: [low, median, high]23    refresh: on_source_update24    display:25      decimals: 026      sigFigs: 727      unit: { fr: "personnes", en: "people" }28    constraints: { maxAbsRatePerSec: 10, maxJumpOnRefit: 5000000 }29    windows: [total]3031  - id: births_ytd32    name: { fr: "Naissances cette année", en: "Births this year" }33    domain: population34    priority: mvp35    kind: cumulative36    level: 137    model: seasonal-ytd-v138    unit: people39    sources:40      - id: un_wpp_202441        name: "UN World Population Prospects 2024 (derived crude birth rate)"42        url: https://population.un.org/wpp/43        license: "CC BY 3.0 IGO"44        cadence: yearly45    refresh: on_source_update46    display:47      decimals: 048      sigFigs: 649      unit: { fr: "personnes", en: "people" }50    constraints: { maxAbsRatePerSec: 8, maxJumpOnRefit: 500000 }51    windows: [ytd, today, session]5253  - id: births_today54    name: { fr: "Naissances aujourd'hui", en: "Births today" }55    domain: population56    priority: mvp57    kind: derived58    level: derived59    model: derived60    unit: people61    sources:62      - id: un_wpp_202463        name: "UN World Population Prospects 2024 (derived)"64        url: https://population.un.org/wpp/65        license: "CC BY 3.0 IGO"66        cadence: yearly67    refresh: on_source_update68    display:69      decimals: 070      sigFigs: 571      unit: { fr: "personnes", en: "people" }72    windows: [today, session]73    derived:74      op: window75      window: today76      inputs: [{ id: births_ytd, weight: 1 }]7778  - id: deaths_ytd79    name: { fr: "Décès cette année", en: "Deaths this year" }80    domain: population81    priority: mvp82    kind: cumulative83    level: 184    model: seasonal-ytd-v185    unit: people86    sources:87      - id: un_wpp_202488        name: "UN World Population Prospects 2024 (derived crude death rate)"89        url: https://population.un.org/wpp/90        license: "CC BY 3.0 IGO"91        cadence: yearly92    refresh: on_source_update93    display:94      decimals: 095      sigFigs: 696      unit: { fr: "personnes", en: "people" }97    constraints: { maxAbsRatePerSec: 4, maxJumpOnRefit: 300000 }98    windows: [ytd, today, session]99    editorialNote:100      fr: "Compteur de mortalité : ton sobre, source et méthode affichées au clic, pas de gamification."101      en: "Mortality counter: sober tone, source and method shown on click, no gamification."102103  - id: deaths_today104    name: { fr: "Décès aujourd'hui", en: "Deaths today" }105    domain: population106    priority: mvp107    kind: derived108    level: derived109    model: derived110    unit: people111    sources:112      - id: un_wpp_2024113        name: "UN World Population Prospects 2024 (derived)"114        url: https://population.un.org/wpp/115        license: "CC BY 3.0 IGO"116        cadence: yearly117    refresh: on_source_update118    display:119      decimals: 0120      sigFigs: 5121      unit: { fr: "personnes", en: "people" }122    windows: [today, session]123    derived:124      op: window125      window: today126      inputs: [{ id: deaths_ytd, weight: 1 }]127    editorialNote:128      fr: "Compteur de mortalité : ton sobre, source et méthode affichées au clic, pas de gamification."129      en: "Mortality counter: sober tone, source and method shown on click, no gamification."130131  - id: heartbeats_ytd132    name: { fr: "Battements de cœur humains cette année", en: "Human heartbeats this year" }133    domain: population134    priority: v1135    kind: cumulative136    level: 0137    model: linear-ytd-v1138    unit: beats139    sources:140      - id: derived_heartbeats141        name: "Dérivé pédagogique — population ONU WPP × ~70 battements/min"142        url: https://population.un.org/wpp/143        license: "CC BY 3.0 IGO (population); heart-rate factor: physiology literature"144        cadence: yearly145    refresh: on_source_update146    display:147      decimals: 0148      sigFigs: 4149      unit: { fr: "battements", en: "beats" }150    constraints: { maxAbsRatePerSec: 20000000000, maxJumpOnRefit: 1000000000000000 }151    windows: [today, ytd, session]152    uncertaintyFraction: 0.1153    editorialNote:154      fr: "Compteur pédagogique : population mondiale × ~70 battements/min en moyenne — ordre de grandeur, intervalle affiché."155      en: "Pedagogical counter: world population × ~70 beats/min on average — order of magnitude, interval displayed."156157  - id: heartbeats_today158    name: { fr: "Battements de cœur aujourd'hui", en: "Heartbeats today" }159    domain: population160    priority: v1161    kind: derived162    level: derived163    model: derived164    unit: beats165    sources:166      - id: derived_heartbeats167        name: "Dérivé pédagogique (derived)"168        url: https://population.un.org/wpp/169        license: "CC BY 3.0 IGO (population); heart-rate factor: physiology literature"170        cadence: yearly171    refresh: on_source_update172    display:173      decimals: 0174      sigFigs: 4175      unit: { fr: "battements", en: "beats" }176    windows: [today, session]177    derived:178      op: window179      window: today180      inputs: [{ id: heartbeats_ytd, weight: 1 }]181    uncertaintyFraction: 0.1182183  - id: net_growth_today184    name: { fr: "Croissance nette aujourd'hui", en: "Net population growth today" }185    domain: population186    priority: mvp187    kind: derived188    level: derived189    model: derived190    unit: people191    sources:192      - id: un_wpp_2024193        name: "UN World Population Prospects 2024 (births − deaths)"194        url: https://population.un.org/wpp/195        license: "CC BY 3.0 IGO"196        cadence: yearly197    refresh: on_source_update198    display:199      decimals: 0200      sigFigs: 5201      unit: { fr: "personnes", en: "people" }202    windows: [today, ytd, session]203    derived:204      op: linear-combination205      inputs:206        - { id: births_ytd, weight: 1 }207        - { id: deaths_ytd, weight: -1 }208