Mika/patch_stability_probe
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
patch_stability_probe/README.md
Mika 751e0d86a6 Add README.md
2025-12-11 11:56:27 +00:00

3.3 KiB
Raw Permalink Blame History

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

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: 
    git clone https://example.com/patch_stability_probe.git
cd patch_stability_probe
  2. Abhängigkeiten installieren: 
    pip install -r requirements.txt

Nutzung (Beispiel)

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.