Mappare un file sorgente sulla tabella degli edifici

Una guida per convertire un dataset di edifici che usa propri nomi di colonna in una tabella che TESSA può importare. Scritta per essere seguita da una persona o da un assistente IA che lavora a partire da questa pagina.

Il glossario delle variabili degli edifici spiega cosa significa ciascuna colonna TESSA. Questa pagina spiega come decidere quale delle proprie colonne diventa quale colonna TESSA e cosa fare quando la risposta è ambigua.

Formati di file

Accettati: CSV, Excel (.xlsx), ODS, GeoPackage (.gpkg), GeoJSON e altri formati leggibili da GDAL/OGR (KML). I formati con geometria mantengono la propria geometria; i formati tabellari richiedono colonne di coordinate (vedere Geometria).

La conversione del formato del file raramente è il problema. Lo è rinominare le colonne.

La procedura

Passaggio 1 — Inventariare la sorgente

Prima di mappare qualsiasi cosa, elencare per ogni colonna del file sorgente:

• il nome della colonna
• il suo tipo di dato
• tre o quattro valori di esempio
• quante righe sono nulle

I valori di esempio contano più dei nomi. heat_demand potrebbe essere kWh annui, kWh/m² o un valore di potenza di picco in kW — solo l'ordine di grandezza dice quale, e mapparlo sulla colonna TESSA sbagliata corrompe silenziosamente lo studio.

Passaggio 2 — Geometria

Ogni edificio necessita di una posizione. TESSA cerca la geometria in quest'ordine e si ferma alla prima che fornisce un valore utilizzabile:

1. una colonna geometry — geometria nativa in un GeoPackage/GeoJSON, oppure una stringa WKT
2. lat + lon — gradi decimali, WGS 84
3. x + y — coordinata est/nord nel CRS dichiarato al caricamento

Note:

• Se il CRS di origine non è WGS 84, dichiararlo al caricamento (input_crs) oppure riproiettare prima. Un file svizzero è di solito in EPSG:2056; uno britannico in EPSG:27700.
• Le righe senza geometria utilizzabile vengono scartate e l'importazione riporta quante.

Passaggio 3 — L'identificativo dell'edificio

building_id deve essere un intero, univoco all'interno del quartiere.

• Se la sorgente ha un identificativo nazionale o catastale numerico (ad esempio un EGID svizzero), usarlo.
• Se l'identificativo è non numerico ("BLD-0042", una stringa UPRN, un GUID), non tentare di forzarlo. Assegnare un building_id intero sequenziale e conservare l'originale in una colonna separata, in modo che il cliente possa comunque ricollegarsi ai propri registri.
• Se non esiste alcun identificativo, numerare le righe da 1..n.

Passaggio 4 — Colonne di superficie

Sbagliare queste è l'errore più comune e più dannoso.

era è ciò che i modelli di fabbisogno usano effettivamente. Se la sorgente ha solo una superficie lorda di piano, mapparla su total_surface e lasciare che TESSA ricavi era — non mappare la superficie lorda direttamente su era, perché si sovrastima il fabbisogno.

La superficie dell'impronta non è una superficie di piano. Se la sorgente ha solo un'impronta e un numero di piani, la superficie lorda di piano ≈ impronta × piani — ma annotare che è stata ricavata.

Passaggio 5 — Colonne di fabbisogno

Distinguere le tre famiglie in base a ordine di grandezza e unità, non in base al nome:

E in base all'uso finale:

Regole pratiche:

• Un unico "fabbisogno di calore" indifferenziato che include chiaramente l'acqua calda è q_hww_kwh, non q_h_kwh.
• Fornendo due qualsiasi tra riscaldamento / acqua calda / combinato, TESSA ricava il terzo. Fornirli tutti e tre in modo incoerente è peggio che fornirne due.
• Convertire prima in kWh. Una sorgente in MWh, GJ o therm mappata senza conversione è sbagliata di ordini di grandezza e non verrà intercettata dalla validazione.
• Le colonne di potenza di picco (p_*) sono output del modello e non sono accettate come input. Vedere la colonna Input del glossario.

Passaggio 6 — Vocabolari controllati

Tre campi accettano solo valori di un elenco fisso. Il testo libero non viene respinto — semplicemente non trova corrispondenza con un archetipo e l'edificio ricade sui valori predefiniti.

• const_class — 27 valori, vedere Archetipi di edifici. Mappare la classificazione d'uso della sorgente sul valore più vicino, ad es. "MFH" / "multi-family" → Apartment building; "EFH" / "detached" → Single-family house; "retail" → Commercial building.
• const_period — a fasce, non un anno. Convertire un anno di costruzione nella sua fascia: 1974 → 1971-1980. I valori vanno da < 1919 a > 2015, più Unknown.
• fuel_sh, fuel_dhw, fuel_c e thermal_generator_* — codici da Fonti energetiche, ad es. gas, oil, wood_pellet, electricity; gas_boiler, ashp, gshp.

Dove il vocabolario della sorgente è più grossolano di quello di TESSA, mappare sul valore più vicino e dichiararlo nelle note di consegna. Non inventare una precisione che la sorgente non ha.

Passaggio 7 — Flag

is_heated e is_cooled sono porte, non etichette: moltiplicano il fabbisogno nei modelli. Un edificio con is_cooled falso o nullo contribuisce con fabbisogno di raffrescamento zero, qualunque dato di raffrescamento sia stato fornito insieme.

Quindi, se si mappano dati di raffrescamento, impostare is_cooled a vero per quelle righe. is_heated è vero per impostazione predefinita quando la colonna è assente.

Passaggio 8 — Verifica prima della scrittura

Controllare, in ordine:

1. Ogni colonna sorgente è mappata oppure scartata consapevolmente — nessuna colonna dimenticata silenziosamente.
2. Ogni colonna TESSA prodotta è scritta esattamente come la elenca il glossario.
3. Nessuna colonna contrassegnata Input: No nel glossario è stata popolata.
4. Unità convertite e ordini di grandezza plausibili (vedere il Passaggio 5).
5. Il numero di righe corrisponde alla sorgente, oppure la differenza è spiegata.

Cosa consegnare

Insieme al file convertito, registrare:

• la tabella di mappatura: colonna sorgente → colonna TESSA, con l'eventuale conversione applicata
• le colonne derivate e come sono state ricavate
• le colonne scartate e perché
• le mappature di vocabolario dove la sorgente era più grossolana di TESSA
• i dati richiesti assenti — soprattutto se non c'è era e nessuna superficie da cui ricavarla

Questo permette a qualcuno di valutare il risultato in seguito ed è la parte che una conversione automatica omette più spesso.

Importazione minima praticabile

Se la sorgente ha pochissimo, la tabella utile più piccola è:

• building_id — intero, univoco
• geometria — geometry, oppure lat+lon, oppure x+y
• era — oppure total_surface da cui TESSA la ricava

Aggiungendo const_class e const_period, i modelli archetipici svizzeri possono stimare il fabbisogno. Senza alcuna colonna di superficie, l'importazione posiziona gli edifici sulla mappa ma non può modellarne il fabbisogno.

Vedere anche: Glossario delle variabili degli edifici · Modello dei dati degli edifici · Archetipi di edifici · Fonti energetiche · Sistemi di coordinate