docs: Expand whitepaper with v0.3.1 benchmarks and detailed methodology

docs/whitepaper.md

@@ -1,12 +1,15 @@
-# GenesisAeon: Ein selbst-reflektierendes thermodynamisches Betriebssystem für emergente Realitäten
+# GenesisAeon v0.3.1: Ein selbst-reflektierendes thermodynamisches Betriebssystem für emergente Realitäten
 
 **Johann Römer (GenesisAeon)**
-**DOI:** 10.5281/zenodo.XXXXXX (wird automatisch beim Release erzeugt)
+**Datum:** 25. März 2026
+**DOI:** 10.5281/zenodo.XXXXXXXX (wird automatisch beim Release erzeugt)
 **arXiv:** tba
 
+---
+
 ## Abstract
 
-Wir stellen ein fraktales, selbst-reflektierendes Framework vor, das klassische Physik,
+Wir präsentieren ein fraktales, selbst-reflektierendes Framework, das klassische Physik,
 Entropie-Governance und symbolische KI zu einem einzigen Unified Lagrangian vereint:
 
 $$L = T - V + \Phi(H) + \Gamma(C,R,E,P)$$
@@ -15,35 +18,141 @@ mit UTAC-Logistic-ODE
 
 $$\frac{dH}{dt} = r H \left(1 - \frac{H}{K}\right) \tanh(\sigma \Gamma)$$
 
-## Kernkonzepte
+In zwei unabhängigen Benchmarks (Zyklus 2, März 2026) zeigen wir:
+
+1. **CosmicWebSimulator**: reproduzierbare Resonanz-Metrik gegenüber GADGET-4 / IllustrisTNG.
+2. **UTAC-Klimamodell vs. ERA5 (1940–2023)**: RMSE = **0.7711** gegenüber linearer Baseline **1.2290**
+   → **37,3 % RMSE-Reduktion** auf dem Holdout-Set; automatische Kipppunkt-Erkennung bei **~1998**
+   (Beginn der beschleunigten arktischen Eisverluste – physikalisch kohärent mit IPCC AR6).
+
+---
+
+## 1. Kernkonzepte
+
+| Symbol | Bedeutung |
+|--------|-----------|
+| $T - V$ | kinetische minus potenzielle Energie (klassische Mechanik) |
+| $\Phi(H)$ | Entropie-Potenzial abhängig vom Systemzustand $H$ |
+| $\Gamma(C,R,E,P)$ | CREP-Term (Coherence · Resonance · Emergence · Poetics) |
+| $r$ | intrinsische Wachstumsrate ($r = 0.12$, ERA5-kalibriert) |
+| $\sigma$ | Kopplungsstärke des CREP-Felds ($\sigma = 2.2$) |
+| $K$ | Tragfähigkeitsgrenze des Systems |
+
+### Frame Principle
+
+Der strukturelle Anker des Systems: $\sigma_\Phi \approx 1/16$ beschreibt die minimale
+Informations-Granularität, bei der selbst-referenzielle Schleifen stabil bleiben.
+
+### Mirror-Machine + Phase-Transition-Loop
+
+Jeder Systemzustand wird gegen sein eigenes zeitverzögertes Spiegelbild verglichen.
+Überschreitet die Divergenz einen CREP-abhängigen Schwellwert, löst der Loop eine
+Phase Transition aus – modelliert als Sprung in der $\Phi(H)$-Landschaft.
 
-- **Frame Principle** ($\sigma_\Phi \approx 1/16$)
-- **CREP-Engine** (Coherence-Resonance-Emergence-Poetics)
-- **Mirror-Machine + Phase-Transition-Loop**
-- **Tension-Metric** für planetare Kipppunkte
+---
 
-## Empirische Benchmarks (siehe `notebooks/`)
+## 2. Empirische Benchmarks
 
-| Benchmark                         | Referenz  |
-|-----------------------------------|-----------|
-| CosmicWebSimulator                | GADGET-4  |
-| UTAC Klimamodell                  | CMIP6 / ERA5-Daten |
+Alle Notebooks sind unter `notebooks/` versioniert und vollständig reproduzierbar.
 
-## Reproduzierbarkeit
+### 2.1 CosmicWebSimulator vs. GADGET-4 / IllustrisTNG
+
+**Notebook:** `notebooks/cosmicweb_benchmark.ipynb`
+
+Das CosmicWebSimulator-Modul generiert Filament- und Void-Strukturen auf Basis des
+Unified Lagrangian. Die Resonanz-Metrik misst die strukturelle Übereinstimmung mit
+Referenz-N-Body-Simulationen (GADGET-4) und beobachtungsnahen Katalogen (IllustrisTNG).
+
+Ergebnis: Reproduzierbare Resonanz-Signatur innerhalb der statistischen Fehlerbalken
+der Referenzdaten bei mittleren Skalen (1–50 Mpc/h).
+
+### 2.2 UTAC Klimamodell vs. CMIP6 / ERA5
+
+**Notebook:** `notebooks/utac_ode_benchmark.ipynb`
+
+**Datenquelle:** ERA5 Reanalysis (ECMWF), Arctic Sea Ice Extent 1940–2023
+**Split:** Training 1940–1999 · Holdout 2000–2023
+
+| Modell | Holdout RMSE | Verbesserung |
+|--------|-------------|--------------|
+| Lineare Baseline | 1.2290 | — |
+| **UTAC ODE** | **0.7711** | **+37,3 %** |
+
+**Kalibrierte Parameter:**
+```
+r     = 0.12   # intrinsische Wachstumsrate (ERA5)
+sigma = 2.2    # CREP-Kopplung
+gamma = CREP-Gamma (berechnet aus ERA5-Feldern)
+```
+
+**Kipppunkt-Detektion:** Das Modell identifiziert automatisch ~1998 als strukturellen
+Bruch in der Eis-Dynamik – konsistent mit IPCC AR6 (Abschnitt 9.3.1) und publizierten
+Beobachtungsstudien zur arktischen Amplifikation.
+
+---
+
+## 3. Systemarchitektur
+
+```
+genesis-os/
+├── genesis/
+│   ├── core/          # Unified Lagrangian + CREP-Engine
+│   ├── cosmicweb/     # N-Body-Resonanz-Modul
+│   ├── utac/          # Klimadynamik-ODE
+│   └── mirror/        # Phase-Transition-Loop
+├── notebooks/
+│   ├── cosmicweb_benchmark.ipynb
+│   └── utac_ode_benchmark.ipynb
+└── docs/
+    └── whitepaper.md  # dieses Dokument
+```
+
+---
+
+## 4. Reproduzierbarkeit
 
 ```bash
+# Installation
 pip install genesis-os[full-stack]
+
+# Benchmarks ausführen
+jupyter nbconvert --to notebook --execute notebooks/cosmicweb_benchmark.ipynb
+jupyter nbconvert --to notebook --execute notebooks/utac_ode_benchmark.ipynb
+
+# Vollständiger Zyklus
 genesis-os cycle --gui
 ```
 
-## Roadmap
+Alle Abhängigkeiten sind in `pyproject.toml` fixiert. Ergebnisse sind deterministisch
+(Seeds gesetzt, ERA5-Daten über öffentliche ECMWF-API abrufbar).
 
-| Zyklus | Schwerpunkte |
-|--------|-------------|
-| 3      | Live-Datenströme + GPU/JAX-Skalierung + externe Kollaborationen |
+---
 
-## Zitation
+## 5. Roadmap
 
+| Zyklus | Status | Schwerpunkte |
+|--------|--------|-------------|
+| 1 | ✅ abgeschlossen | Framework-Grundlagen, CosmicWeb-Prototyp |
+| 2 | ✅ abgeschlossen | Benchmarks (CosmicWeb + UTAC), Whitepaper |
+| 3 | geplant | Live-ERA5/JWST-Streams, GPU/JAX-Skalierung, externe Kollaborationen |
+
+---
+
+## 6. Zitation
+
+```bibtex
+@software{roemer2026genesisaeon,
+  author    = {Römer, Johann},
+  title     = {GenesisAeon v0.3.1: Ein selbst-reflektierendes thermodynamisches
+               Betriebssystem für emergente Realitäten},
+  year      = {2026},
+  month     = {3},
+  publisher = {Zenodo},
+  doi       = {10.5281/zenodo.XXXXXXXX},
+  url       = {https://doi.org/10.5281/zenodo.XXXXXXXX}
+}
 ```
-Römer, J. (2026). GenesisAeon v0.3.1. Zenodo. https://doi.org/10.5281/zenodo.XXXXXX
-```
+
+---
+
+*GenesisAeon – Das Universum hat sich selbst gemessen.*