88 lines
No EOL
3.7 KiB
Markdown
88 lines
No EOL
3.7 KiB
Markdown
# Resonanzband Untersuchung
|
||
|
||
## Überblick
|
||
Untersuchung der Wechselwirkungen zwischen Startkohorten und Resonanzband in einem Testszenario. Diese Studie analysiert die dynamische Veränderung der Band-Lage in Abhängigkeit der Kohortenparameter und visualisiert die Ergebnisse als Heatmap.
|
||
|
||
**Projekt-Key:** `resonanzband_untersuchung`
|
||
|
||
**Artikel-Link:** [https://donau2space.de/tag-181-run-27-burst-verschoben-wandert-das-resonanzband-wirklich-mit-der-kohorte/](https://donau2space.de/tag-181-run-27-burst-verschoben-wandert-das-resonanzband-wirklich-mit-der-kohorte/)
|
||
|
||
**Git-Repository:** [https://git.donau2space.de/Mika/resonanzband_untersuchung](https://git.donau2space.de/Mika/resonanzband_untersuchung)
|
||
|
||
### 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. `run_data_analysis`
|
||
- **Art:** Python-Skript (`python_script`)
|
||
- **Zielumgebung:** Linux Userspace
|
||
- **Sprache:** Python
|
||
- **Zweck:** Analyse der Runs zur Bestimmung der Band-Lage und relevanter Kennzahlen.
|
||
- **API-Funktion:**
|
||
- `analyse_run_data(run_data)` → Gibt `analysis_results` zurück.
|
||
- **Datenstruktur:**
|
||
- `RunData` (JSON): Felder `band_center`, `band_width`, `cluster_score`, `retry_tail`
|
||
|
||
#### 2. `heatmap_visualization`
|
||
- **Art:** Webanwendung (`web_ui`)
|
||
- **Zielumgebung:** Webbrowser
|
||
- **Sprachen:** HTML, CSS, JavaScript
|
||
- **Zweck:** Darstellung der Heatmap der Resonanzband-Lage über eine Weboberfläche.
|
||
- **API-Routen:**
|
||
- `GET /heatmap` → Lädt Heatmap-Daten zur Visualisierung.
|
||
- **UI-Komponenten:** CSS-Komponente `heatmap-style`, JS-Modul `heatmap-renderer`
|
||
|
||
#### 3. `run_metrics_report`
|
||
- **Art:** Datensatz (`csv_dataset`)
|
||
- **Zielumgebung:** Plattformübergreifend
|
||
- **Sprache:** CSV
|
||
- **Zweck:** Export der berechneten Metriken für jede Run-Serie.
|
||
- **API-Funktion:**
|
||
- `export_metrics(runs)` → Gibt `csv_file_path` zurück.
|
||
- **Datenstruktur:**
|
||
- `RunMetrics` (Tabelle): `run_id`, `band_center`, `band_width`, `cluster_score`, `retry_tail`
|
||
|
||
## Voraussetzungen (Webserver)
|
||
- Ein beliebiger Webserver (z. B. Apache oder Nginx)
|
||
- Unterstützt lokale oder modulare JS/CSS-Dateien
|
||
- Zugriff auf die generierten CSV-Dateien für den Heatmap-Datensatz
|
||
|
||
## Starten der Anwendung
|
||
1. Web-UI-Dateien aus `heatmap_visualization` in den Webserver-Root kopieren.
|
||
2. Server starten und im Browser `http://localhost/heatmap` öffnen.
|
||
3. Heatmap zeigt dynamisch generierte Resonanzband-Ergebnisse.
|
||
|
||
## Installation & Nutzung (Python-Komponente)
|
||
1. Repository klonen:
|
||
```bash
|
||
git clone https://git.donau2space.de/Mika/resonanzband_untersuchung
|
||
cd resonanzband_untersuchung
|
||
```
|
||
2. Abhängigkeiten installieren (z. B. pandas, numpy):
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
3. Skript ausführen:
|
||
```bash
|
||
python run_data_analysis.py --input data/runs.json --output results/analysis.json
|
||
```
|
||
|
||
## Typische Use-Cases
|
||
- Analyse und Visualisierung der Resonanzband-Verschiebung über Kohorten hinweg.
|
||
- Vergleich unterschiedlicher Startbedingungen anhand exportierter CSV-Berichte.
|
||
- Experimentelle Validierung der Band-Stabilität unter Testbedingungen.
|
||
|
||
## Struktur & Erweiterbarkeit
|
||
- `src/` – Python-Analysemodule
|
||
- `web/` – Heatmap-Visualisierungsoberfläche
|
||
- `data/` – Eingabe- und Ergebnisdatensätze im CSV- und JSON-Format
|
||
|
||
Erweiterbar durch zusätzliche Analysefunktionen oder erweiterte Visualisierungen.
|
||
|
||
## Lizenz
|
||
Veröffentlicht unter der **MIT-Lizenz**. Nutzung und Weitergabe unter den Bedingungen dieser Lizenz.
|
||
|
||
**Hinweis:** Dieses Repository enthält KI-generierte Inhalte. Verwendung erfolgt auf eigene Verantwortung. |