90 lines
No EOL
3.8 KiB
Markdown
90 lines
No EOL
3.8 KiB
Markdown
# aux_comparison_freeze_band
|
||
|
||
## Überblick
|
||
Dieses Repository dokumentiert das Experiment **aux_comparison_freeze_band**. Ziel ist der Vergleich der Systeme *aux=2* und *aux=3* anhand von Preflight-Versuchen im sogenannten Freeze-Band. Es wurden Versuchsreihen durchgeführt, logged, ausgewertet und dokumentiert. Die Ergebnisse liefern Anhaltspunkte für Parameterunterschiede und Bandbreiteneffekte zwischen den beiden Systemen.
|
||
|
||
**Link zum Artikel:** [https://donau2space.de/tag-199-wolkendecke-als-pruefstand-aux3-bekommt-ein-zweites-freeze-band-siegel/](https://donau2space.de/tag-199-wolkendecke-als-pruefstand-aux3-bekommt-ein-zweites-freeze-band-siegel/)
|
||
|
||
**Git Repository:** [https://git.donau2space.de/Mika/aux_comparison_freeze_band](https://git.donau2space.de/Mika/aux_comparison_freeze_band)
|
||
|
||
### 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 umfasst drei Hauptartefakte:
|
||
|
||
1. **logging_tool**
|
||
**Art:** python_script
|
||
**Ziel:** Linux Userspace
|
||
**Sprache:** Python
|
||
**Zweck:** Protokollierung der Preflight-Versuche mit strukturierten Log-Einträgen.
|
||
**API-Funktion:**
|
||
- `log_preflight_attempt(timestamp, measured_p, freeze_ok, setup_fingerprint, policy_hash)` – speichert einen strukturierten Log-Eintrag.
|
||
|
||
**Datenstruktur:**
|
||
- `LogEntry` (JSON) mit Feldern: `timestamp`, `measured_p`, `freeze_ok`, `setup_fingerprint`, `policy_hash`
|
||
|
||
2. **analysis_tool**
|
||
**Art:** python_script
|
||
**Ziel:** Linux Userspace
|
||
**Sprache:** Python
|
||
**Zweck:** Analyse der gesammelten Preflight-Daten und Berechnung statistischer Kennwerte.
|
||
**API-Funktion:**
|
||
- `analyze_results(log_entries)` – erzeugt eine Analysezusammenfassung mit statistischen Parametern.
|
||
|
||
**Datenstruktur:**
|
||
- `AnalysisSummary` (JSON) mit Feldern: `valid`, `median`, `IQR`, `band_width`, `delta_band_width`
|
||
|
||
3. **results_report**
|
||
**Art:** doc_only
|
||
**Ziel:** Mixed
|
||
**Sprache:** nicht anwendbar
|
||
**Zweck:** Dokumentation der Versuchsauswertung und Zusammenfassung der Ergebnisse.
|
||
|
||
## Installation & Nutzung
|
||
### Voraussetzungen
|
||
- Linux- oder UNIX-ähnliches System
|
||
- Python 3.8 oder höher
|
||
- Zugriffsrechte zum Lesen und Schreiben von Log-Dateien
|
||
|
||
### Installation
|
||
1. Repository klonen:
|
||
`git clone https://git.donau2space.de/Mika/aux_comparison_freeze_band`
|
||
|
||
2. Abhängigkeiten installieren (innerhalb des Projektverzeichnisses):
|
||
`pip install -r requirements.txt`
|
||
|
||
### Nutzung
|
||
1. **Logging ausführen:**
|
||
`python3 logging_tool.py --session preflight_2024a`
|
||
|
||
2. **Analyse starten:**
|
||
`python3 analysis_tool.py --input logs/preflight_2024a.json`
|
||
|
||
3. **Bericht einsehen:**
|
||
Berichtsdokument `results_report` unter `docs/` verfügbar.
|
||
|
||
## Typische Use-Cases
|
||
- Durchführung von Datenprotokollen während Flugversuchen.
|
||
- Auswertung von Freeze-Band-Leistungskennwerten zwischen verschiedenen AUX-Systemen.
|
||
- Vergleich relativer Schwankungsbreiten zwischen Versuchskonfigurationen.
|
||
- Validierung von Sensordaten über mehrere Testreihen hinweg.
|
||
|
||
## Struktur & mögliche Erweiterungen
|
||
Verzeichnisübersicht:
|
||
|
||
- `logging_tool.py` – Erfassung der Daten.
|
||
- `analysis_tool.py` – Durchführung der Auswertung.
|
||
- `docs/results_report.md` – Zusammenfassung und Schlussfolgerungen.
|
||
|
||
Erweiterungspotential:
|
||
- Automatisierte Grafikausgabe der Analyseergebnisse.
|
||
- Erweiterte Statistikfunktionen (z. B. Varianzanalysen oder Resampling).
|
||
- Integration in CI-Pipeline zur automatischen Validierung neuer Datensätze.
|
||
|
||
## Lizenz
|
||
Dieses Projekt steht unter der **MIT-Lizenz**.
|
||
|
||
Alle Inhalte wurden automatisch durch KI erstellt. Nutzung erfolgt ausschließlich auf eigenes Risiko. |