diff --git a/README.md b/README.md new file mode 100644 index 0000000..2210504 --- /dev/null +++ b/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. \ No newline at end of file