Eine Quelldatei auf die Gebäudetabelle abbilden

Eine Anleitung, um einen Gebäudedatensatz, der eigene Spaltennamen verwendet, in eine Tabelle umzuwandeln, die TESSA importieren kann. Verfasst, damit sie von einer Person oder von einem KI-Assistenten anhand dieser Seite befolgt werden kann.

Das Glossar der Gebäudevariablen sagt, was jede TESSA-Spalte bedeutet. Diese Seite sagt, wie Sie entscheiden, welche Ihrer Spalten zu welcher TESSA-Spalte wird, und was zu tun ist, wenn die Antwort nicht eindeutig ist.

Dateiformate

Akzeptiert: CSV, Excel (.xlsx), ODS, GeoPackage (.gpkg), GeoJSON und andere von GDAL/OGR lesbare Formate (KML). Formate mit Geometrie behalten ihre Geometrie; tabellarische Formate benötigen Koordinatenspalten (siehe Geometrie).

Die Umwandlung des Dateiformats ist selten das Problem. Das Umbenennen der Spalten ist es.

Das Vorgehen

Schritt 1 — Die Quelle inventarisieren

Bevor Sie etwas abbilden, listen Sie für jede Spalte der Quelldatei auf:

• den Spaltennamen
• ihren Datentyp
• drei oder vier Beispielwerte
• wie viele Zeilen null sind

Beispielwerte sind wichtiger als Namen. heat_demand könnte jährliche kWh, kWh/m² oder eine Spitzenleistung in kW sein — nur die Grössenordnung verrät, welche, und die Zuordnung zur falschen TESSA-Spalte verfälscht die Studie stillschweigend.

Schritt 2 — Geometrie

Jedes Gebäude braucht einen Standort. TESSA sucht die Geometrie in dieser Reihenfolge und hört beim ersten auf, der einen brauchbaren Wert liefert:

1. eine Spalte geometry — native Geometrie in einem GeoPackage/GeoJSON oder eine WKT-Zeichenkette
2. lat + lon — Dezimalgrad, WGS 84
3. x + y — Rechts-/Hochwert im beim Upload angegebenen CRS

Hinweise:

• Ist das Quell-CRS nicht WGS 84, geben Sie es beim Upload an (input_crs) oder projizieren Sie vorher um. Eine Schweizer Datei verwendet meist EPSG:2056; eine britische EPSG:27700.
• Zeilen ohne brauchbare Geometrie werden verworfen, und der Import meldet, wie viele.

Schritt 3 — Die Gebäudekennung

building_id muss eine ganze Zahl sein, eindeutig innerhalb des Quartiers.

• Hat die Quelle eine nationale oder Kataster-Kennung, die numerisch ist (zum Beispiel eine Schweizer EGID), verwenden Sie diese.
• Ist die Kennung nicht numerisch ("BLD-0042", eine UPRN-Zeichenkette, eine GUID), versuchen Sie nicht, sie umzuwandeln. Vergeben Sie eine fortlaufende ganze Zahl als building_id und behalten Sie das Original in einer separaten Spalte, damit der Kunde weiterhin mit seinen eigenen Datensätzen verknüpfen kann.
• Gibt es überhaupt keine Kennung, nummerieren Sie die Zeilen 1..n.

Schritt 4 — Flächenspalten

Hier sind Fehler am häufigsten und am schädlichsten.

era ist, was die Bedarfsmodelle tatsächlich verwenden. Hat die Quelle nur eine Bruttogeschossfläche, ordnen Sie sie total_surface zu und lassen Sie TESSA era ableiten — ordnen Sie die Bruttofläche nicht direkt era zu, das überschätzt den Bedarf.

Eine Grundrissfläche ist keine Geschossfläche. Hat die Quelle nur einen Grundriss und eine Geschosszahl, ist die Bruttogeschossfläche ≈ Grundriss × Geschosse — halten Sie aber fest, dass Sie sie abgeleitet haben.

Schritt 5 — Bedarfsspalten

Unterscheiden Sie die drei Familien nach Grössenordnung und Einheit, nicht nach Namen:

Und nach Verwendungszweck:

Faustregeln:

• Ein einzelner undifferenzierter «Wärmebedarf», der eindeutig Warmwasser einschliesst, ist q_hww_kwh, nicht q_h_kwh.
• Liefern Sie beliebige zwei von Heizung / Warmwasser / kombiniert, und TESSA leitet die dritte ab. Alle drei inkonsistent zu liefern ist schlimmer, als zwei zu liefern.
• Rechnen Sie zuerst in kWh um. Eine Quelle in MWh, GJ oder therms, die ohne Umrechnung zugeordnet wird, ist um Grössenordnungen falsch, und die Validierung fängt das nicht ab.
• Spalten für Spitzenleistung (p_*) sind Modellausgaben und werden als Eingaben nicht akzeptiert. Siehe die Spalte Input im Glossar.

Schritt 6 — Kontrollierte Vokabulare

Drei Felder akzeptieren nur Werte aus einer festen Liste. Freitext wird nicht abgelehnt — er passt einfach zu keinem Archetyp, und das Gebäude fällt auf Standardwerte zurück.

• const_class — 27 Werte, siehe Gebäudearchetypen. Ordnen Sie die Nutzungsklassifikation der Quelle der nächstliegenden zu, z. B. "MFH" / "multi-family" → Apartment building; "EFH" / "detached" → Single-family house; "retail" → Commercial building.
• const_period — in Bändern, nicht als Jahr. Wandeln Sie ein Baujahr in sein Band um: 1974 → 1971-1980. Die Werte reichen von < 1919 bis > 2015, plus Unknown.
• fuel_sh, fuel_dhw, fuel_c und thermal_generator_* — Codes aus Energieträger, z. B. gas, oil, wood_pellet, electricity; gas_boiler, ashp, gshp.

Ist das Vokabular der Quelle gröber als das von TESSA, ordnen Sie dem nächstliegenden Wert zu und vermerken Sie das in den Übergabenotizen. Erfinden Sie keine Präzision, die die Quelle nicht hat.

Schritt 7 — Flags

is_heated und is_cooled sind Schalter, keine Bezeichner: Sie multiplizieren den Bedarf in den Modellen. Ein Gebäude mit is_cooled false oder null trägt null Kühlbedarf bei, unabhängig von den Kühlwerten, die Sie dazu geliefert haben.

Wenn Sie also Kühldaten zuordnen, setzen Sie is_cooled für diese Zeilen auf true. is_heated ist standardmässig true, wenn die Spalte fehlt.

Schritt 8 — Prüfung vor dem Schreiben

Prüfen Sie der Reihe nach:

1. Jede Quellspalte ist entweder zugeordnet oder bewusst verworfen — keine Spalte stillschweigend vergessen.
2. Jede von Ihnen erzeugte TESSA-Spalte ist genau so geschrieben, wie das Glossar sie aufführt.
3. Keine im Glossar mit Input: No markierte Spalte wurde befüllt.
4. Einheiten umgerechnet und Grössenordnungen plausibel (siehe Schritt 5).
5. Die Zeilenzahl stimmt mit der Quelle überein, oder die Differenz ist erklärt.

Was zu übergeben ist

Halten Sie zusammen mit der umgewandelten Datei fest:

• die Zuordnungstabelle: Quellspalte → TESSA-Spalte, mit jeder angewandten Umrechnung
• abgeleitete Spalten und wie sie abgeleitet wurden
• verworfene Spalten und warum
• Vokabularzuordnungen, wo die Quelle gröber war als die von TESSA
• erforderliche Daten, die fehlten — vor allem, wenn es keine era und keine Fläche zu deren Ableitung gibt

Das ermöglicht es später, das Ergebnis zu beurteilen, und ist der Teil, den eine automatische Umwandlung am häufigsten auslässt.

Minimal brauchbarer Import

Hat die Quelle sehr wenig, ist die kleinste brauchbare Tabelle:

• building_id — ganze Zahl, eindeutig
• Geometrie — geometry, oder lat+lon, oder x+y
• era — oder total_surface, aus der TESSA sie ableiten kann

Mit zusätzlichem const_class und const_period können die Schweizer Archetypmodelle den Bedarf schätzen. Ohne jegliche Flächenspalte platziert der Import die Gebäude auf der Karte, kann aber keinen Bedarf für sie modellieren.

Siehe auch: Glossar der Gebäudevariablen · Gebäudedatenvorlage · Gebäudearchetypen · Energieträger · Koordinatensysteme