Add markdown

markdown

@@ -0,0 +1,74 @@
+# aux3_run_analysis
+
+## Überblick
+Dieses Repository dokumentiert und analysiert aux=3- und aux=2-Läufe, um Drift messbar zu machen und eine saubere Basis für vergleichende Auswertungen zu schaffen. Der Schwerpunkt liegt auf der Erfassung, Protokollierung und Analyse von Messwerten über Python-Skripte und begleitende Datensätze.
+
+Weitere Informationen finden sich im Artikel: [Tag 198 – Regen als Gate: Ich erzwinge endlich einen gültigen aux3-run im freeze-band](https://donau2space.de/tag-198-regen-als-gate-ich-erzwinge-endlich-einen-gueltigen-aux3-run-im-freeze-band/)
+
+Git-Repository: [https://git.donau2space.de/Mika/aux3_run_analysis](https://git.donau2space.de/Mika/aux3_run_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
+
+### Artefakt 1 – Python-Analyse-Skript
+- **Bezeichnung:** Skript zur Protokollierung und Analyse von Messwerten aus dem aux=3-Run.
+- **Art:** python_script
+- **Ziel:** mixed
+- **Sprachen:** Python
+- **API-Funktionen:**
+  - `log_measurement(timestamp, measured_p, freeze_ok, setup_fingerprint, policy_hash)` – schreibt einen einzelnen Messwert in das Protokoll.
+- **Datenstruktur:**
+  - `MeasurementLog` (JSON-Struktur) mit Feldern: timestamp, measured_p, freeze_ok, setup_fingerprint, policy_hash
+
+### Artefakt 2 – CSV-Datensatz
+- **Bezeichnung:** CSV-Datensatz mit den Ergebnissen der Läufe für Vergleichsanalysen.
+- **Art:** csv_dataset
+- **Ziel:** mixed
+- **Sprachen:** CSV
+- **Datenstruktur:**
+  - `RunResults` (Tabelle) mit Feldern: RunID, measured_p, freeze_ok, delta
+
+### Artefakt 3 – Dokumentation
+- **Bezeichnung:** Dokumentation des Gating-Prozesses und der Driftmessung.
+- **Art:** doc_only
+- **Ziel:** mixed
+- **Sprache:** Textbasiert
+- **Zweck:** beschreibt methodische Hintergründe und Auswertungsstrategien zur Driftbestimmung.
+
+## Installation & Nutzung
+1. Python ≥3.8 erforderlich.
+2. Repository klonen:
+   ```bash
+   git clone https://git.donau2space.de/Mika/aux3_run_analysis
+   cd aux3_run_analysis
+   ```
+3. Abhängigkeiten installieren:
+   ```bash
+   pip install -r requirements.txt
+   ```
+4. Skript ausführen:
+   ```bash
+   python analyze_aux3.py
+   ```
+
+## Typische Use-Cases
+- Vergleich von aux=2- und aux=3-Läufen zur Messung von Drift.
+- Automatisierte Erfassung und Protokollierung von Messwerten.
+- Auswertung und graphische Darstellung von Laufdaten.
+- Erweiterung um zusätzliche Analysemetriken.
+
+## Struktur & mögliche Erweiterungen
+- `analyze_aux3.py`: Hauptskript für Log- und Analyseoperationen.
+- `data/`: Enthält CSV-Datensätze.
+- `docs/`: Dokumentation des Gating-Prozesses.
+- Erweiterungen können über zusätzliche Datenspalten, Visualisierungs-Tools oder alternative Auswertungsfunktionen erfolgen.
+
+## Lizenz
+Lizensiert unter der **MIT-Lizenz**.
+
+---
+*Dieses Repository (aux3_run_analysis) wurde automatisch aus strukturierten KI-Daten erstellt. Nutzung auf eigenes Risiko.*