Add README.md

README.md

@@ -0,0 +1,79 @@
+# Run 13 – Minimale Intervention
+
+## Überblick
+Dieses Experiment (experiment_key: **run_13_minimal_intervention**) untersucht die minimalinvasive Korrektur von Zeitmessungen, bei denen durch Messfehler negative Δt-Werte auftreten. Dazu wird ein Retry-Mechanismus eingesetzt, der fehlerhafte Intervalle überprüft und korrigiert, ohne das Gesamtergebnis zu verzerren. Der Testlauf bewertet Leistungs- und Stabilitätsaspekte dieses Mechanismus.
+
+**Link zum Artikel:** [Donau2Space – Tag 169: Run 13](https://donau2space.de/tag-169-run-13-einmal-warten-einmal-neu-lesen-und-ploetzlich-wird-%ce%b4t-wieder-brav-%e2%89%a5-0/)
+
+**Git Repository:** [https://git.donau2space.de/Mika/run_13_minimal_intervention](https://git.donau2space.de/Mika/run_13_minimal_intervention)
+
+### 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 enthält folgende Artefakte:
+
+### 1. retry_mechanism
+- **Art:** Python Script
+- **Ziel:** Linux Userspace
+- **Sprachen:** Python
+- **Zweck:** Implementierung eines Retry-Mechanismus, der bei negativer Δt-Zeitmessung einen neuen Messdurchgang startet und das korrigierte Ergebnis zurückgibt.
+- **API-Funktionen:**
+  - `retry_if_negative_dt(dt)` – Überprüft einen gemessenen Wert Δt und wiederholt die Messung, falls ein negativer Wert auftritt. Rückgabe des korrigierten Δt.
+- **Datenstrukturen:**
+  - `TimingResult` (JSON)
+    - Felder: retry_taken, retry_fixed, dt
+
+### 2. logging_format
+- **Art:** Dokumentation
+- **Ziel:** Mixed
+- **Sprachen:** –
+- **Zweck:** Beschreibung des Logging-Formats, das Kompatibilität zu früheren Experimentläufen sicherstellt.
+
+### 3. result_table
+- **Art:** CSV-Datensatz
+- **Ziel:** Linux Userspace
+- **Sprachen:** CSV
+- **Zweck:** Speicherung der Ergebnisse des Laufs #13 mit relevanten Messmetriken und Resultaten zur Auswertung.
+
+## Installation & Nutzung
+
+### Voraussetzungen
+- Linux-System mit installiertem Python ≥ 3.8
+- Schreibrechte im Arbeitsverzeichnis
+
+### Installation
+1. Repository klonen: `git clone https://git.donau2space.de/Mika/run_13_minimal_intervention`
+2. In das Verzeichnis wechseln: `cd run_13_minimal_intervention`
+3. Abhängigkeiten installieren (falls vorhanden): `pip install -r requirements.txt`
+
+### Nutzung
+Das Skript `retry_mechanism.py` kann direkt gestartet werden:
+
+```bash
+python retry_mechanism.py
+```
+
+## Typische Use-Cases
+- Validierung von Zeitmessungen in Hardware- oder Softwaretests.
+- Untersuchung der Auswirkungen von Retry-Zyklen auf Performance-Messungen.
+- Vergleich von Messdaten mit und ohne Korrekturmechanismus.
+- Reproduktion der Ergebnisse des Experiments run_13_minimal_intervention.
+
+## Struktur & mögliche Erweiterungen
+- **Verzeichnisstruktur**
+  - `/src` – enthält den Retry-Mechanismus
+  - `/docs` – Dokumentation des Logging-Formats
+  - `/data` – CSV-Datensätze der Versuchsergebnisse
+- **Erweiterungsmöglichkeiten:**
+  - Hinzufügen weiterer Prüflogiken für Δt-Abweichungen
+  - Integration in umfassendere Mess-Frameworks
+  - Erweiterung der Datenausgabe um Fehlerstatistiken
+
+## Lizenz
+Dieses Repository steht unter der **MIT-Lizenz**.
+
+Alle Inhalte wurden automatisch per KI erstellt. Nutzung, Anpassung und Weiterentwicklung erfolgen auf eigenes Risiko.