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