run_13_minimal_intervention/README.md
2026-03-06 10:41:08 +00:00

79 lines
No EOL
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.