From 61620c74b6587f01e4931c8fa041da7e1909a488 Mon Sep 17 00:00:00 2001
From: Mika <kontakt@donau2space.de>
Date: Sat, 24 Jan 2026 12:03:31 +0000
Subject: [PATCH] Add README.md

---
 README.md | 83 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 83 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0d6880d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,83 @@
+# Frozen Runs Analysis
+
+## Überblick
+Das Projekt **frozen_runs_analysis** untersucht sogenannte Frozen-Runs mit Fokus auf Messmetriken, Bootstrap-Resampling und Timing-Effekte. Ziel ist es, reproduzierbare Messergebnisse und statistische Unsicherheiten bei Mehrfachausführungen experimentell zu analysieren.
+
+[Artikel zur Analyse](https://donau2space.de/tag-128-1258-vier-frozen-runs-und-der-erste-belastbare-zwischen-checkpoint/)  
+[Git Repository](https://git.donau2space.de/Mika/frozen_runs_analysis)
+
+### Hinweis
+Alle Inhalte wurden per KI generiert.  
+Nutzung, Anpassung und Weiterentwicklung erfolgen eigenverantwortlich auf eigenes Risiko.  
+Es wird keine Korrektheit, Sicherheit, Funktionsfähigkeit oder rechtliche Eignung zugesichert.
+
+## Inhalt des Repositories
+
+Das Repository umfasst folgende Artefakte:
+
+### 1. frozen_runs_report
+- **Art**: Dokumentation (doc_only)
+- **Ziel**: mixed (plattformunabhängig)
+- **Beschreibung**: Bericht über die Ergebnisse und Metriken der Frozen-Runs, inklusive statistischer Kennzahlen und Vergleichstabellen.
+
+### 2. metrics_analysis_script
+- **Art**: Python-Skript (python_script)
+- **Ziel**: Linux Userspace
+- **Sprachen**: Python
+- **Beschreibung**: Analysemodul zur statistischen Auswertung der Metriken mit Bootstrap-Resampling.
+
+**API-Funktionen:**
+- `analyze_metrics(data)` → Analysiert Metriken und liefert Ergebnisdaten mit Konfidenzintervallen zurück.
+
+**Datenstrukturen:**
+- `MetricResults` (JSON)
+  - Felder: `metric_name`, `p50`, `p95`, `max`, `retry_free_rate`, `bootstrap_ci`
+
+### 3. visualization_tool
+- **Art**: Weboberfläche (web_ui)
+- **Ziel**: web
+- **Sprachen**: HTML, CSS, JavaScript
+- **Beschreibung**: Web-Frontend zur Visualisierung der Metriken und Bootstrap-Analysen.
+
+**Routen:**
+- `GET /metrics` → Ruft die visualisierten Metriken ab.
+
+## Build & Installation
+
+Voraussetzungen:
+- Python 3.x
+- Bibliotheken: `numpy`, `pandas`, `scipy`, `matplotlib`
+- Für das Web-Frontend: Webserver mit Unterstützung für statische Dateien (z. B. nginx, Apache oder einfache Python HTTP-Server)
+
+**Installation:**
+1. Repository klonen:  
+   `git clone https://git.donau2space.de/Mika/frozen_runs_analysis`
+2. Abhängigkeiten installieren:  
+   `pip install -r requirements.txt`
+
+**Starten der Visualisierung:**
+1. Im Projektverzeichnis ausführen:  
+   `python -m http.server 8080`
+2. Webbrowser öffnen:  
+   `http://localhost:8080/visualization_tool/`
+
+## Typische Use-Cases
+- Analyse großer Metriksets aus wiederholten Testläufen
+- Berechnung von Bootstrap-Konfidenzintervallen zur Stabilitätsprüfung
+- Vergleich von Frozen-Run-Ergebnissen unterschiedlicher Builds
+- Visualisierung von Metriken und Trends über die Zeit
+
+## Struktur & Erweiterbarkeit
+
+Modularer Aufbau:
+- `metrics_analysis_script.py` – Analysemodul, leicht erweiterbar um neue Kennzahlen
+- `visualization_tool/` – Frontend-Files, kann mit zusätzlicher Interaktivität oder API-Erweiterungen kombiniert werden
+- `docs/` bzw. `frozen_runs_report` – Berichtsstruktur, anpassbar für neue Datensätze
+
+Erweiterungspunkte:
+- Integration weiterer Visualisierungsframeworks (z. B. D3.js)
+- Automatisierte Importpipelines für neue Metrikformate
+
+## Lizenz
+Dieses Projekt steht unter der **MIT-Lizenz**.  
+Die Verwendung und Weiterentwicklung von **frozen_runs_analysis** erfolgt auf eigene Verantwortung.
\ No newline at end of file