🌡 Temperatur-Leaderboard Deutschland

Live-Rangliste der Lufttemperatur aller DWD-Messstationen in Deutschland — plus Tages-, Wochen-, Monats- und Jahreswerte, Karte und Stationsverlauf. Daten vom Deutschen Wetterdienst, Website als statische Vanilla-TypeScript-Seite (kein Framework), stündlich automatisch aktualisiert per GitHub Actions und über GitHub Pages ausgeliefert.

Features

• Rangliste aller ~200 Stationen — „Jetzt" (Live) sowie Höchst-/Tiefstwerte für Tag / Woche / Monat / Jahr; im Jahr-Umschalter zeigt „Allzeit" den Allzeit-Rekord je Station aus dem vollen DWD-Archiv (gemerged mit den Live-Jahren).
• Tabelle & Deutschlandkarte (Stationen als Punkte, nach Temperatur eingefärbt).
• Stationsdetail per Klick (lädt die volle Stationshistorie on-demand nach, je nach Station bis ins 19. Jahrhundert zurück):
  • Verlauf — Tagesmax/-min des aktuellen & Vorjahrs plus Normal-Kurve 1991–2020 und Schwellenlinien bei 20/30/35/40 °C; Hover mit Werten + Allzeit-Rekord des Tages.
  • Verteilung Max/Min — Häufigkeit je 1 °C für aktuelles & Vorjahr gegen das Normal; Hover mit Perzentil und Normal-Tagen pro Jahr.
  • Kalender — Heatmap je Jahr, umschaltbar 2 / 10 / 30 / alle Jahre.
  • Jahres-Höchst/-Tiefst, Badge bei neuem Jahresrekord.
• Überblicks-Strip: heißeste/kälteste Station, Spanne, größter Steiger/Faller, Jahresrekorde des Tages.
• Funfacts-Banderole (Laufband mit Temperatur-Fakten).
• Frische-Anzeige + Auto-Refresh (alle 5 min) mit Stale-Warnung.
• Farb-Legende, Dark Mode, teilbare URLs (#year/min/map), Berlin-Zeit in der Anzeige (gespeichert wird immer UTC).

Aufbau

.
├─ temp-leaderboard.sh        # holt DWD-Daten, erzeugt latest/tops/series/stations/stats + daily + history
├─ backfill.sh                # Backfill der Tageshistorie eines Jahres aus dem DWD-Klimaarchiv
├─ reference.sh               # Tages-Klimatologie -> reference.json + records.json (+ --history -> history/<wmo>.json)
├─ annual-mean.sh             # offizielles DWD-Gebietsmittel (Jahrestemperatur DE) -> annual-mean.json
├─ web/                       # Vite + TypeScript (kein Framework)
│  ├─ index.html
│  ├─ src/main.ts             # Rendering: Tabelle, Karte, Detail, Banderole, Theme, URL-State
│  ├─ src/style.css           # Oldschool-Almanach-Design + Dark Mode
│  ├─ src/funfacts.ts         # die Temperatur-Fakten der Banderole
│  └─ public/
│     ├─ germany.json         # Karten-Outline (statisches Asset)
│     └─ data/                # die ausgelieferten Daten (siehe unten)
└─ .github/workflows/update-and-deploy.yml

Daten (web/public/data/)

Datei	Inhalt	versioniert
latest.json	aktueller Snapshot (Rangliste „Jetzt")	✅
tops.json	Höchst-/Tiefstwerte je Station für Tag/Woche/Monat/Jahr	✅
daily/<datum>.json	Tages-Min/Max je Station	✅
history.csv	Roh-Log der Messungen (dedupliziert), rollierendes Fenster der letzten 7 Tage (HISTORY_KEEP_DAYS) — dient nur als Dedup-Quelle für daily/; das Langzeit-Archiv liegt in daily/	✅
reference.json	Tages-Klimatologie 1991–2020 je Station (Normal-Verlauf + Referenzverteilung)	✅ statisch
history/<wmo>.json	volle Tageshistorie je Station (oft Jahrzehnte zurück), on-demand geladen	✅ statisch
timeline.json	nationale Jahres-Zeitreihen je Rekord-Metrik (heißester Tag / Zähler pro Jahr) — speist den Rekord-Zeitverlauf im Modal	✅ statisch
annual-mean.json	offizielles DWD-Gebietsmittel der Jahres-Lufttemperatur Deutschlands (1881–heute) — speist die Kurve oben auf der Rekorde-Seite (Trend/30-J.-Mittel im Frontend)	✅
records.json	Allzeit-Rekorde je Station (heißester/kältester Tag, wärmste Nacht, längste Hitze-/Wüsten-/Extrem-/Glut-/Eis- & Tropennacht-/Wüstennacht-/Super-Tropennacht-Serie, meiste Hitze-/Wüsten-/Extrem-/Gluttage & Tropen-/Wüsten-/Super-Tropennächte) + nationale Bestjahre — speist „Allzeit"-Rangliste & Rekorde-Tafel („Gesamt"). Deckt alle DWD-Klimastationen ab, auch reine Klimastationen ohne Live-POI-Feed (Namen in names), damit kein Rekord fehlt	✅ statisch
series.json, stations.json, stats.json	abgeleitet (Verlauf, Koordinaten, Überblick)	❌ neu erzeugt
poi/, stations.cfg, de_stations.tsv, kl_hist_stations.txt	Roh-Cache / Hilfsdateien	❌ neu erzeugt

Gespeichert wird durchgängig UTC; die Website rechnet für die Anzeige in Berlin-Zeit um.

Wie es funktioniert

• temp-leaderboard.sh lädt die aktuellen POI-Messwerte des DWD (eine CSV je Station), ermittelt die deutschen Stationen über den MOSMIX-Katalog und schreibt daraus latest.json + tops.json + series.json + stations.json + stats.json, führt die Tages-Min/Max in daily/ fort und pflegt history.csv (Dedup-Quelle, rollierendes 7-Tage-Fenster via HISTORY_KEEP_DAYS; ältere Messungen kann die ~24 h-POI-Datei ohnehin nicht erneut liefern). Gibt zusätzlich ein Leaderboard im Terminal aus (--help zeigt alle Optionen).
• backfill.sh [JAHR] [--gaps] füllt die Tageshistorie eines Jahres (Höchst-/ Tiefstwerte) aus dem DWD-Klimaarchiv nach (Standard: aktuelles Jahr; recent deckt aktuelles + Vorjahr ab). Zuordnung der internen DWD-IDs zu den WMO-IDs über Koordinaten + Namens-Fallback. --gaps zieht nur für das Jahr fehlende Stationen nach.
• reference.sh [VON BIS] erzeugt einmalig reference.json, records.json und timeline.json: pro Station die Tages-Klimatologie der Normalperiode (Standard 1991–2020) aus dem historical-KL-Archiv (TXK/TNK) — geglättete Normalwerte je Kalendertag (Referenzkurve im Verlauf) plus die gepoolte Verteilung (Referenzkurve in „Verteilung Max/Min"); records.json enthält zusätzlich den Allzeit-Höchst/-Tiefstwert je Station, timeline.json die nationalen Jahres-Zeitreihen je Rekord-Metrik (für den Rekord-Zeitverlauf). records.json/timeline.json decken alle aktiven Klimastationen ab (nicht nur die mit Live-POI-Feed), damit auch reine Klimastationen als Rekordhalter erscheinen. Rate-limit-schonend: Verzeichnis-Listing nur 1×, kleine Parallelität (--jobs), Backoff-Retries, resumebarer ZIP-Cache (zweiter Lauf nach Abbruch lädt nur Fehlendes; --refresh erzwingt Neuladen). Eine Normal-Linie entsteht für Stationen mit Detailansicht (POI immer; reine Klimastationen nur, wenn noch aktuell — s. u.) und nur bei ≥ 20 abgedeckten Jahren in der Periode (REF_MIN_YEARS); bei Teilabdeckung trägt das Label die tatsächliche Spanne. Nur nötig, wenn sich die Normalperiode ändert. Mit --history schreibt dasselbe Skript zusätzlich history/<key>.json (die volle Tageshistorie je Station, aus demselben ZIP-Cache) — vom Frontend on-demand beim Öffnen einer Station geladen, sodass Kalender/Verlauf/Verteilung die gesamte Historie zeigen, ohne series.json aufzublähen. Geschrieben wird für alle POI plus reine Klimastationen, die noch aktuell senden (Reihen-Ende ≥ akt. Jahr − REF_HIST_MAX_LAG) und ≥ 20 Jahre (REF_MIN_HIST_YEARS) umfassen. Veraltete Stationen (Reihe endet vor Jahren, z. B. Heidelberg bis 2012) bleiben reine Rekordhalter — ein Verlauf, der weit vor den Live-Stationen endet, wäre irreführend.
• reference.sh --recent hält die Rekorde aktuell, ohne einen Vollauf: es lädt nur das tägliche recent-KL-Produkt (feste Dateinamen, kein Verzeichnis-Listing, ephemerer Cache) aller zuletzt aktiven Stationen und merged neue Werte in die bestehende records.json + timeline.json (Extreme richtungsabhängig, Zähler/Serien als Maximum; nie schlechter). So werden aktuelle Rekorde — auch reiner Klimastationen, die im Live-POI-Feed fehlen — erfasst, die das historical-Archiv (das ~1 Jahr nachhängt) noch nicht enthält. reference.json bleibt unangetastet.
• annual-mean.sh holt das offizielle DWD-Gebietsmittel der Jahres-Lufttemperatur für Deutschland (regional_averages_DE, Spalte „Deutschland", ab 1881) und schreibt es nach annual-mean.json. Trendlinie und gleitendes 30-Jahres-Mittel berechnet das Frontend selbst. Läuft in der Pipeline bei jedem Lauf mit; robust (bei Download-/Parse-Fehler bleibt die bestehende Datei unangetastet, kein Abbruch des Deploys).
• GitHub Actions (update-and-deploy.yml) führt stündlich temp-leaderboard.sh aus, committet die aktualisierten Daten zurück, baut die Seite und deployt sie auf GitHub Pages. Einmal täglich (≈04 UTC) läuft zusätzlich reference.sh --recent, sodass neue Rekorde reiner Klimastationen automatisch nachgeführt werden.

Lokal

./temp-leaderboard.sh             # Daten aktualisieren (-> web/public/data/)
npm --prefix web install          # einmalig
npm --prefix web run dev          # Dev-Server, http://localhost:5173
npm --prefix web run build        # Production-Build -> web/dist/

Quellen

• Live-Messwerte: opendata.dwd.de/weather/weather_reports/poi/
• Stationskatalog: DWD MOSMIX
• Tageshistorie: opendata.dwd.de/climate_environment/CDC/.../daily/kl/recent/
• Normalwerte (Referenzlinien): opendata.dwd.de/climate_environment/CDC/.../daily/kl/historical/
• Karten-Outline: deutschlandGeoJSON