Exportformate
TESSA bietet mehrere Möglichkeiten, Ergebnisse und Geometrie aus einem Szenario für externe Werkzeuge zu extrahieren.
Szenarioexport (GeoPackage)
Format: GeoPackage (.gpkg), gebündelt in einem .zip-Archiv.
Verfügbar über: Reiter Berichte → Szenario exportieren oder den API-Endpunkt GET /v1/scenarios/{id}/export.
Ein Szenario-GeoPackage enthält die vollständigen Projektdaten eines einzelnen Szenarios, darunter:
| Ebene / Tabelle | Beschreibung |
|---|---|
| Gebäudegeometrie und -attribute | Alle Gebäudedaten einschliesslich Bedarfsergebnissen (EBF, q_h_kwh, q_c_kwh, Zusammenfassung der Lastkurve usw.) |
| Untersuchungsgebiet-Ebenen | Im Projekt gezeichnete Polygon-, Linien- und Punktebenen |
| Rohrnetz | Rohre mit Geometrie, DN, Länge, Durchfluss, Wärmeverlust und Kostendaten |
| Energiezentralen | Standorte der Energiezentralen und Parameter der Wärmequellen |
| Übergabestationen | Gebäudeanschlusspunkte und Übergabestationsgeometrie |
| Erdsondenfelder | Geometrie des Sondenlayouts und Auslegungsergebnisse |
| Klimadaten | Zeitreihen, im GeoPackage als Binärspalte gespeichert |
Alle Geometrie liegt in EPSG:4326 (WGS 84) vor. Das GeoPackage lässt sich in QGIS, ArcGIS oder jeder OGR-kompatiblen GIS-Software öffnen.
Round-Trip-Import
GeoPackage-Exporte können wieder in TESSA importiert werden, um Szenarien zwischen Benutzern oder Instanzen zu teilen. Verwenden Sie Projekte → Szenario importieren und geben Sie die .zip-Datei an.
Szenarioexport (KMZ)
Format: KMZ (gezipptes KML) für Google Earth und ähnliche Werkzeuge.
Verfügbar über: Reiter Berichte → KMZ exportieren.
Enthält Gebäudegrundrisse/-punkte, das Rohrnetz und die Standorte der Energiezentralen. Die Attributdaten sind gegenüber dem GeoPackage-Export vereinfacht. Das Koordinatensystem ist geografisches WGS 84 (Standard für KML).
Gebäudetabelle (CSV / Excel)
Format: CSV oder Excel (.xlsx).
Verfügbar über: Quartier-Inspektor → Gebäudetabelle → Herunterladen oder die API.
Exportiert die vollständige Gebäudeattributtabelle (alle im Glossar der Gebäudevariablen gezeigten Spalten) ohne Geometrie. Nützlich für die Nachbearbeitung in Excel, Python oder R.
Die Spaltenauswahl kann in der Benutzeroberfläche vor dem Herunterladen eingeschränkt werden.
Rohrtabelle (Excel)
Format: Excel (.xlsx) oder ODS.
Verfügbar über: Netz-Inspektor → Rohre → Herunterladen.
Exportiert die Rohrattributtabelle mit:
| Spalte | Beschreibung |
|---|---|
pipe_id | Interne Rohrkennung |
dn | Nennweite mm |
inner_diameter_m | Innendurchmesser m |
length | Rohrlänge m (einzelnes Rohr) |
velocity_ms | Strömungsgeschwindigkeit m/s bei Spitze |
mass_flow_kgs | Massenstrom kg/s bei Spitze |
heat_loss_kw | Rohrwärmeverlust kW |
investment_cost_chf | Schätzung der Rohrinstallationskosten CHF |
Lastkurve (CSV / Excel)
Format: CSV oder Excel.
Der Quartierlastgang (stündliche Heiz- und Kühlleistung) kann im Bereich Lastkurven heruntergeladen werden. Die Spalten folgen dem Lastkurvenformat: timestamp, p_h_kw, p_ww_kw, p_hww_kw, p_c_kw.
Ergebnisse der Netzsimulation
Die Ergebnisse der Netzsimulation (Knotentemperaturen, Drücke, Rohrdurchflüsse) werden im Reiter Berichte angezeigt und können im Netzberichtsbereich als Excel oder ODS heruntergeladen werden.
Rohergebnis-Datensatz (Quartierergebnisse)
Format: Excel (.xlsx), CSV oder ODS. Standarddateiname raw_table.xlsx.
Verfügbar über: den Rohdaten-Download der Berichtsseite oder den API-Endpunkt GET /api/v1/report/raw_data.
Das ist der Langformat-Datensatz, der jeden Berichtskonsumenten speist — eine Zeile pro (Teil, Komponente, Variable). Er ist der vollständigste maschinenlesbare Export der Ergebnisse eines Szenarios und eignet sich für eigene Pivots und Diagramme.
Jede Zeile enthält:
| Spalte | Beschreibung |
|---|---|
part | buildings, stand-alone, eine UID eines thermischen Netzes oder district. |
component | thermal_source, pump, pipe, heat_loss, cooling_loss, booster_heat_pumps, energy_center, overall, … |
name | Lesbare Bezeichnung (null bei Aggregat-/overall-Zeilen). |
code | Stabiler Code des Domänenobjekts (z. B. der Code der thermischen Quelle oder Energiezentrale). |
uid | Stabile Objektkennung. |
variable | Name der Kennzahl (z. B. energy_useful, fuel, n_thermal_sources). |
value | Numerischer Wert oder Zeichenkettenwert. |
calculation_unit | Einheit, in der der Wert berechnet wird. |
display_unit | Einheit, in der die App ihn anzeigt (kann null sein). |
Selbstbeschreibende Einheiten und stabile Kennungen (v5.3)
Seit v5.3 enthält jede Zeile calculation_unit, display_unit, code und uid, der Datensatz ist also selbstbeschreibend — Sie müssen die internen Einheitenkonventionen von TESSA nicht mehr kennen, um einen Wert zu interpretieren. Die Einheiten stammen aus den Definitionen der Anzeigevariablen; die Kennungen aus den zugrunde liegenden Domänenobjekten.
Aggregatzeilen entfernt
Die alten Aggregat-Zeilen component="thermal_sources" und component="pumps" wurden entfernt. Verwenden Sie stattdessen die Zeilen pro Instanz (component="thermal_source" / "pump") und die neuen Zeilen pro Energiezentrale (component="energy_center" mit den Zählern n_thermal_sources / n_pumps) für strukturelle Summen. Summenfelder wurden ebenso aus den overall-Projektionszeilen entfernt, die nun nur noch Intensitäten, Spitzen, physikalische Eigenschaften und den Systemzustand enthalten. Wenn Sie ein Skript haben, das diese Aggregatzeilen las, stellen Sie es auf die Summierung der Zeilen pro Instanz um.
Koordinatensystem der Exporte
Alle räumlichen Exporte verwenden geografische Koordinaten in EPSG:4326 (WGS 84). Um mit dem Schweizer Landesnetz (LV95) zu arbeiten, transformieren Sie nach dem Export mit QGIS (Ebene → Speichern unter → CRS 2056 wählen) oder ogr2ogr:
ogr2ogr -t_srs EPSG:2056 output_lv95.gpkg input_wgs84.gpkg
Siehe auch: Koordinatensysteme · Benutzerhandbuch — Ergebnisse exportieren
Lastkurvenformat
Eine Lastkurve ist eine stündliche Zeitreihe des thermischen Leistungsbedarfs. TESSA kann benutzerdefinierte Lastkurven auf Quartiersebene (den berechneten Bedarf ersetzend oder ergänzend) und auf Gebäudeebene (für einzelne Gebäude mit gemessenen Verbrauchsdaten) übernehmen.
Einheiten und Konventionen