bootstrap_analysis/README.md
2025-12-06 13:10:45 +00:00

74 lines
No EOL
3 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.

# Bootstrap Analysis
## Überblick
Dieses Repository dokumentiert das Experiment **bootstrap_analysis**. Ziel ist die Untersuchung der Auswirkungen von Power-Save- und Performance-Governor-Einstellungen auf die Outlier-Rate unter Verwendung von Bootstrap-Methoden. Weitere Details zum Analysehintergrund finden sich im begleitenden Artikel: [Bootstrap-Konfidenzintervalle & Effektgröße für Powersave vs. Performance](https://donau2space.de/tag-78-bootstrap-konfidenzintervalle-effektgroesse-fuer-powersave-vs-performance/)
### 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
### Artefakte
#### 1. bootstrap_analysis_tool
- **Art:** linux_cli_tool
- **Ziel:** linux-userspace
- **Sprache:** Python
- **Zweck:** Durchführen von Bootstrap-Resamples zur statistischen Outlier-Analyse.
**API-Funktionen:**
- `bootstrap_resample(data, n_resamples)` Führt wiederholte Bootstrap-Resamples durch und liefert aggregierte Resample-Daten.
**Datenstruktur:**
- **BootstrapResult (JSON):** enthält `mean`, `ci_lower`, `ci_upper`, `outliers`.
#### 2. cstate_logging_template
- **Art:** doc_only
- **Ziel:** mixed
- **Sprache:** Text
- **Zweck:** Vorlage zur Einrichtung von C-State-Logging mit `trace-cmd` und BPF-Tracing.
#### 3. governors_analysis_report
- **Art:** doc_only
- **Ziel:** mixed
- **Sprache:** Text
- **Zweck:** Dokumentation der Analyseergebnisse und der Methodik zur Bewertung verschiedener Governor-Einstellungen.
## Installation & Nutzung
### Installation des CLI-Tools
1. Python 3 und `pip` installieren.
2. Repository klonen:
`git clone <repository-url>`
3. In das Verzeichnis wechseln:
`cd bootstrap_analysis`
4. Abhängigkeiten installieren:
`pip install -r requirements.txt`
### Nutzung
Aufruf des CLI-Tools:
python bootstrap_analysis_tool.py --input data.csv --resamples 1000 --output result.json
Das Tool führt Bootstrap-Resamples auf den Eingabedaten aus und erstellt eine JSON-Ausgabe der Ergebnisse.
## Typische Use-Cases
- Quantitative Bewertung der Stabilität von Outlier-Metriken bei unterschiedlichen Power-Governor-Strategien.
- Vergleich von Energie- und Performance-Auswirkungen über Bootstrap-Konfidenzintervalle.
- Integration in bestehende Linux-Tracing-Toolchains (trace-cmd, BPF, perf).
## Struktur & mögliche Erweiterungen
- **/tools** enthält das CLI-Tool `bootstrap_analysis_tool`
- **/docs** enthält Vorlagen und Berichte (`cstate_logging_template`, `governors_analysis_report`)
**Erweiterbar um:**
- Zusätzliche Bootstrap-Strategien für nichtparametrische Daten.
- Automatisierte Governor-Auswertung mit Metrik-Vergleich.
- Integration von grafischer Ergebnisdarstellung.
## Lizenz
Dieses Projekt steht unter der **MIT-Lizenz**.
Alle Inhalte wurden automatisch durch eine KI generiert. Nutzung und Weiterentwicklung erfolgen auf eigenes Risiko.