Externe Auswertung

Überblick

Neben der eingebauten Falschfarben-Darstellung und den Liniendiagrammen der Ergebnisansicht können alle Simulationsergebnisse mit externen Werkzeugen ausgewertet werden. VICUS Buildings bindet dafür das Auswertungsprogramm PostProc 2 direkt an und legt die Ergebnisse als offene, tabulatorgetrennte Textdateien (TSV) ab, die sich auch in Tabellenkalkulationen oder Skriptsprachen weiterverarbeiten lassen.

PostProc 2 starten

Aufruf über Werkzeuge > Externe Ergebnisse… oder die Schaltfläche Externe Ergebnisse in der linken Hauptwerkzeugleiste.

Voraussetzung ist ein gültiger Pfad zur PostProc-2-Programmdatei. Ist keiner hinterlegt, erscheint der Hinweis Bitte wählen Sie zunächst den Pfad zum externen Postprozessing im Einstellungsdialog! und der Einstellungsdialog öffnet sich automatisch: Bearbeiten > Einstellungen…, Seite Werkzeuge/Dienste, Abschnitt Externe Werkzeuge, Feld PostProc 2:. Unter Windows findet die Schaltfläche Automatische Erkennung neben dem Feld installierte Versionen selbständig (Installationspfade unter C:\Program Files\IBK\PostProc 2.x bzw. C:\Program Files (x86)\IBK\PostProc 2.x).

Beim Start passiert Folgendes:

1. Ist ein Projekt geladen, erzeugt VICUS Buildings eine Session-Datei <Projektname>.p2 im Projektverzeichnis (neben der .vicus-Datei). Existiert bereits eine, fragt das Programm Vorhandene PostProc-Sitzungsdatei ‘%1’ überschreiben? — mit Nein bleibt die eigene, ggf. angepasste Session erhalten.
2. Die Session-Datei verweist auf das Ergebnisverzeichnis des Projekts, sodass PostProc 2 die Ausgabedateien direkt im Verzeichnisbaum anzeigt.
3. PostProc 2 wird mit dieser Session gestartet. Läuft bereits eine von VICUS Buildings gestartete Instanz, wird diese wiederverwendet (unter Windows in den Vordergrund geholt) statt eine zweite zu öffnen.

Ergebnisverzeichnis und Dateistruktur

Beim Simulationsstart exportiert VICUS Buildings das Projekt als NANDRAD-Datei <Projektname>.nandrad neben die .vicus-Datei. Der Solver legt dazu ein gleichnamiges Verzeichnis <Projektname>/ mit drei Unterordnern an:

MeinProjekt.vicus
MeinProjekt.nandrad
MeinProjekt.p2            (PostProc-Session, optional)
MeinProjekt/
├── results/              Ergebnisdateien (*.tsv bzw. *.btf)
├── log/                  Protokolle und Fortschritt
└── var/                  Neustartdaten, Ausgabereferenzliste

Ausgabedateien (results/)

Für jede Ausgabegröße entsteht eine Datei im Verzeichnis results/, benannt nach der Größe, dem Zeittyp und ggf. dem Ausgaberaster, z. B. AirTemperature.tsv oder IdealCoolingLoad-mean.tsv (siehe Ausgaben):

• TSV-Format (Standard): Textdatei mit Tabulator-getrennten Spalten. Die erste Spalte enthält die Zeit, die Kopfzeile je Spalte Objektname mit ID, Größenname und Einheit in eckigen Klammern. Diese Dateien lassen sich direkt in PostProc 2, Excel oder mit Python/Pandas öffnen.
• Binärformat (*.btf): Wird erzeugt, wenn auf der Seite Ausgaben die Option Binärformat verwenden aktiviert ist — schneller zu schreiben und zu lesen und platzsparender, aber nicht mit Texteditoren auswertbar. Die eingebaute Ergebnisansicht liest beide Formate.

Logverzeichnis (log/)

Datei	Inhalt
screenlog.txt	Vollständiges Bildschirmprotokoll des Solvers; wird über die Schaltfläche Protokoll (Tooltip Simulations-Logdatei öffnen…) auf der Simulationsstart-Seite angezeigt
progress.tsv	Simulationsfortschritt (Simulationszeit, Prozent); Grundlage für die Fortschritts- und Statusanzeige in VICUS Buildings
summary.txt	Zusammenfassung der Löserstatistik nach Abschluss des Laufs
integrator_cvode_stats.tsv	Integratorstatistik; wird bei jedem Lauf zu den Ausgabezeitpunkten geschrieben, mit der Option Schreibe Statistiken für jeden internen Lösungsschritt (siehe Simulation starten) zusätzlich für jeden internen Solver-Schritt

Arbeitsverzeichnis (var/)

• restart.bin — Neustartdaten; ermöglicht das Fortsetzen einer abgebrochenen Simulation über die Schaltfläche Fortfahren im Startdialog
• output_reference_list.txt — Liste aller im Modell verfügbaren Ausgabegrößen; wird von der Funktion Ausgabeliste aktualisieren auf der Seite Ausgaben eingelesen

Verwandte Themen

• Falschfarben-Darstellung
• Ausgaben
• Simulation starten
• Solver-Optionen