90 lines
No EOL
3.3 KiB
Markdown
90 lines
No EOL
3.3 KiB
Markdown
# Patch Stability Probe
|
||
|
||
## Überblick
|
||
Das Experiment **patch_stability_probe** untersucht die Behebung eines Off-By-3 Fehlers in einem Python-Skript, die Durchführung einer Stabilitätsprobe für einen Patch und das Testen von Spacer-Konfigurationen. Ziel ist es, die Auswirkungen des Patches auf Systemstabilität und Frequenzsteuerung zu evaluieren.
|
||
|
||
[Artikel zur Versuchsbeschreibung](https://donau2space.de/tag-84-mittag-off-by-3-behoben-patch-stability-probe-kurzbootstrap-spacer-check/)
|
||
|
||
### 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 drei zentrale Python-Skripte:
|
||
|
||
### 1. off_by_3_fix
|
||
- **Art:** Python-Skript
|
||
- **Ziel:** Linux Userspace
|
||
- **Sprachen:** Python
|
||
- **Zweck:** Behebung des Off-By-3 Fehlers in `trace_agg.py` durch Umstellung auf Integer-Buckets.
|
||
|
||
**API-Funktionen:**
|
||
- `fix_off_by_3(trace_data)` – korrigiert Off-By-3 Fehler in Trace-Daten.
|
||
|
||
**Strukturen:**
|
||
- `TraceData` (JSON): Felder `group`, `bucket`, `value`.
|
||
|
||
### 2. patch_stability_probe
|
||
- **Art:** Python-Skript
|
||
- **Ziel:** Linux Userspace
|
||
- **Sprachen:** Python
|
||
- **Zweck:** Durchführung einer Stabilitätsprobe des Patches über verschiedene Governors.
|
||
|
||
**API-Funktionen:**
|
||
- `run_stability_probe(governor)` – führt eine Stabilitätsprobe für den angegebenen Governor durch und liefert ein Ergebnisobjekt.
|
||
|
||
**Strukturen:**
|
||
- `StabilityResult` (JSON): Felder `governor`, `max_residual`, `median`, `samples`.
|
||
|
||
### 3. spacer_check
|
||
- **Art:** Python-Skript
|
||
- **Ziel:** Linux Userspace
|
||
- **Sprachen:** Python
|
||
- **Zweck:** Tests des Spacer-Effekts bei unterschiedlichen Konfigurationen.
|
||
|
||
**API-Funktionen:**
|
||
- `test_spacer_effect(config_a, config_b)` – vergleicht zwei Spacer-Konfigurationen und liefert Messergebnisse.
|
||
|
||
**Strukturen:**
|
||
- `SpacerTestResult` (JSON): Felder `configuration`, `hf_peak`, `noise`, `cycles`.
|
||
|
||
## Installation & Nutzung
|
||
### Voraussetzungen
|
||
- Linux-System mit Python 3.8 oder höher
|
||
- Git für Repository-Klon
|
||
|
||
### Installation
|
||
1. Repository klonen:
|
||
```bash
|
||
git clone https://example.com/patch_stability_probe.git
|
||
cd patch_stability_probe
|
||
```
|
||
2. Abhängigkeiten installieren:
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### Nutzung (Beispiel)
|
||
```bash
|
||
python patch_stability_probe.py --governor performance
|
||
```
|
||
Das Skript führt eine Probe mit dem angegebenen Governor aus und speichert die Ergebnisse als JSON in `results/`.
|
||
|
||
## Typische Use-Cases
|
||
- Validierung von Patches auf Stabilitätsverhalten über verschiedene Skalierungs-Governors.
|
||
- Analyse von Messfehlern und Spacing-Einflüssen.
|
||
- Automatisierte Tests auf Off-By-N Fehler im Trace-Handling.
|
||
|
||
## Struktur & Erweiterbarkeit
|
||
- **core/** enthält die Basisskripte für Fehlerkorrektur, Stabilitätsproben und Spacer-Tests.
|
||
- **data/** speichert Eingabe- und Ergebnisdateien (JSON).
|
||
- **docs/** dokumentiert Ablauf, Messverfahren und mögliche Erweiterungen.
|
||
|
||
Erweiterungen können neue Governor-Profile, Messparameter oder Trace-Formate einbeziehen. Jede API-Funktion ist modular aufgebaut und kann unabhängig getestet werden.
|
||
|
||
## Lizenz
|
||
Veröffentlicht unter der **MIT-Lizenz**.
|
||
|
||
---
|
||
*Automatisch generierte technische Dokumentation. Nutzung auf eigenes Risiko.* |