Add README.md

README.md

@@ -0,0 +1,74 @@
+# 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.