ma_analyse

Analysepipeline fuer Simulationsdaten der Masterarbeit.

Setup

python -m pip install -e ".[dev]"

Ordnerstruktur

Ordner	Zweck
data/ma_analyse/ida_imports/	IDA-Importdaten und Variantenordner
data/ma_analyse/database/	aufbereitete Raumdaten
data/ma_analyse/output/	regulaere Analyseausgaben
data/test_output/	lokale Test- und Smoke-Test-Ausgaben
data/ma_variants/	Import-, Export- und IDA-Uebergabedaten des Variantenkerns
data/ma_weather/	lokale TRY-Dateien, aufbereitete Wetterdaten, Wetterdiagramme und Berichte
data/catalogs/	Produkt-, Material-, Quellen- und Dokumentkataloge
docs/project/	Planstatus, Planindex, Entscheidungen, Strukturreviews und Projektinput-Regeln
docs/project/workflow/	führende fachliche Ablaufdokumentation und Modulsteckbriefe für die Workflowansicht
docs/ma_analyse/	Befehle, Architektur und Plot-Template-Beispiele der Analysepipeline
docs/ma_variants/	Workflow, Datenmodell und Wirtschaftlichkeitsmodell des Variantenkerns
docs/ma_weather/	Wetterdatenanalyse und TRY-Integration
docs/ma_ui/	Bedienung und Startwege der zentralen Streamlit-Oberflaeche
docs/ma_workflow/	Workflow-Katalog, Statuswerte und interne Pruefbefehle
src/ma_analyse/app/	CLI und Befehlssteuerung
src/ma_analyse/core/	zentrale Konfiguration und Logging
src/ma_analyse/preprocessing/	Datenvorbereitung aus Rohdaten
src/ma_analyse/analysis/	Datenverarbeitung, Auswertung und gemeinsame Analyse-Komponenten
src/ma_analyse/settings/	Naming- und Formatlogik plus zugehoerige Markdown-Dateien
src/ma_ui/tkinter_app/	fachlich gekoppelte Tkinter-Oberflaeche der Analysepipeline
src/ma_variants/	modularer Varianten-, Export-, Katalog- und Bewertungskern
src/ma_weather/	Wetterkatalog und lokale TRY-Analysepipeline
src/ma_ui/	zentrale Streamlit-Oberflaeche mit getrennter Bearbeitungs- und Workflowansicht
src/ma_workflow/	zentraler Struktur- und Statuskatalog mit fachlichem Dokumentationsadapter
src/ma_core/, src/ma_database/, src/ma_project/	leichte Zielpakete fuer Plattform und Projektinitialisierung
src/ma_building/, src/ma_zones/, src/ma_technical/, src/ma_parameters/	leichte Zielpakete fuer Eingangsdaten
src/ma_analyse/stage_1_dimensioning/ bis stage_4_sensitivity/	getrennte Analyse-Stufen fuer Dimensionierung, Optimierung, Norm-Nachweis und Sensitivitaet
src/ma_simulation_setup/, src/ma_export_simulation/, src/ma_import_simulation/	leichte Zielpakete fuer Runs und Simulationsschnittstellen
src/ma_economy/, src/ma_sustainability/, src/ma_assessment/	leichte Zielpakete fuer Bewertung
src/ma_reporting/, src/ma_data_export/, src/ma_validation/, src/ma_feedback/	leichte Zielpakete fuer Ergebnisse und Querschnittsfunktionen
tests/	automatisierte Code-Tests
logs/	automatisch erzeugte Laufprotokolle der Analysebefehle

Wichtige Befehle

python -m ma_analyse --help
python -m ma_analyse gui
python -m ma_analyse prepare --export-format both
python -m ma_analyse comfort --output-type plot_analysis_overview
python -m ma_analyse analyze-data --series-layout separate
python -m ma_analyse heating --view year --heating-mode single
python -m ma_analyse cooling --view year --variant-mode single
python -m ma_analyse plot-template --template heating-year --variants Dimensionierung --rooms "101 lobby"
python -m ma_analyse all

Qualitaetssicherung

python -m ruff check src tests --no-cache
python -m ruff format --check src tests --no-cache
python -m pytest

Lokale Daten- und Ausgabeordner unter data/ sind in .gitignore ausgeschlossen. Analysebefehle schreiben automatisch Logdateien mit Schritt- und Gesamtlaufzeiten nach logs/; die Logdateien selbst werden nicht versioniert.

Projektsteuerung

• Verbindlicher Rahmenplan: docs/project/plans/inbox/Masterarbeit_VSCode_Projektplan_2026-06-21.md
• Aktiver Planstatus: docs/project/plans/PLAN_STATUS.md
• Planindex und Plan-Inbox: docs/project/plans/
• Technische Entscheidungen: docs/project/decisions/TECHNICAL_DECISIONS.md
• Nutzerentscheidungen: docs/project/decisions/USER_DECISIONS_MASTERTHESIS_CODE.md
• Root-Changelog: CHANGELOG.md