Caricare una tabella di edifici
Se dispone di dati esterni sugli edifici — da un catasto comunale, un foglio di calcolo del cliente, un'esportazione GIS o un rilevamento energetico — può caricarli direttamente in TESSA. In questo modo si crea un nuovo quartiere (o se ne aggiorna uno esistente) popolato con i Suoi edifici, coordinate, attributi e fabbisogni energetici.
Il caricamento di una tabella è anche il modo principale per lavorare con aree di progetto al di fuori della Svizzera o in luoghi non coperti dalle interrogazioni automatiche dei registri (come il Registro federale degli edifici e delle abitazioni o OpenStreetMap).
Quando usarlo
- Dispone di elenchi o inventari locali di edifici: ad es. bollette energetiche annuali misurate, epoche di costruzione note o fogli di calcolo forniti dal cliente.
- Sta modellando al di fuori della Svizzera: quando l'integrazione con i registri nazionali non è disponibile, il caricamento di una tabella offre pieno controllo su geometrie e proprietà degli edifici.
- Desidera aggiornare un quartiere esistente: integrare o sovrascrivere i dati modellati del quartiere con informazioni locali verificate.
- Desidera fornire direttamente fabbisogni misurati: ignorare i modelli di fabbisogno predefiniti fornendo valori noti di riscaldamento, acqua calda sanitaria (ACS) o raffrescamento.
Formati di file e sistemi di coordinate supportati
Formati di file
TESSA accetta tabelle nei formati standard di fogli di calcolo e vettoriali geospaziali:
- Foglio di calcolo: Microsoft Excel (
.xlsx), valori separati da virgola (.csv) o OpenDocument Spreadsheet (.ods). - Vettoriale geospaziale: GeoPackage (
.gpkg) o GeoJSON.
Le intestazioni delle colonne devono corrispondere esattamente ai nomi dei campi di TESSA (distinzione tra maiuscole e minuscole, minuscole con trattino basso). Le colonne non riconosciute vengono ignorate.
Posizione e sistema di riferimento delle coordinate (CRS)
Ogni edificio deve avere una posizione geografica. Fornisca le coordinate usando una delle seguenti combinazioni di colonne:
| Formato della geometria | Colonne | Note |
|---|---|---|
| WGS 84 Lat / Lon | lat, lon | Gradi decimali (coordinate GPS standard). |
| X / Y proiettate | x, y | Est e nord nel CRS specificato nello strumento di caricamento (ad es. LV95 svizzero EPSG:2056). |
| Geometria WKT | geometry | Stringa Well-Known Text che rappresenta un POINT o un POLYGON (ad es. POINT(2600000 1200000)). |
| Geometria di livello vettoriale | Elemento GIS standard | Colonna di geometria nativa quando si carica un .gpkg o un GeoJSON. |
Gli edifici del quartiere sono punti
TESSA memorizza gli edifici del quartiere come punti (centroidi) sul livello del quartiere. Se carica impronte poligonali, TESSA ricava coordinate puntuali rappresentative per ogni edificio. Se servono le superfici delle impronte degli edifici, fornisca la superficie utile in era o total_surface anziché affidarsi al calcolo dell'area del poligono durante la creazione del quartiere.
Confine della regione del progetto
Tutti gli edifici caricati devono ricadere all'interno del confine della regione di progetto definita per il Suo scenario. Ogni edificio al di fuori del confine viene scartato automaticamente e il caricamento viene bloccato se nessun edificio ricade nella regione.
Passo per passo: caricare una tabella di edifici
- Apra uno scenario nel Suo progetto.
- Nel pannello Strumenti, selezioni Create district from buildings.
- Scelga la modalità di operazione:
- Crea nuovo distretto: inserisca un Nome quartiere.
- Aggiorna distretto esistente: selezioni il quartiere di destinazione e scelga un Metodo di aggiornamento (vedere sotto).
- Faccia clic su Carica file e selezioni il file
.xlsx,.csv,.odso.gpkg. - In Codice EPSG CRS dati di input, inserisca il codice EPSG delle Sue coordinate (predefinito
4326per WGS 84,2056per LV95 svizzero, ecc.). - Configuri Fill building data automatically:
- Spuntato (consigliato per dati parziali): selezioni una Building data source (o un catalogo di archetipi) e scelga Heat model e Cooling model. TESSA completa gli attributi mancanti e genera le curve di carico.
- Non spuntato (quando si forniscono dati completi): TESSA usa solo i valori forniti, senza completare gli attributi mancanti né stimare i fabbisogni non forniti.
- Faccia clic su Esegui.
Metodi di aggiornamento (quando si aggiorna un quartiere esistente)
Quando si aggiorna un quartiere esistente, si sceglie una delle quattro strategie di unione:
| Metodo di aggiornamento | Comportamento |
|---|---|
| Union, keep existing values | Aggiunge i nuovi edifici dal file. Gli edifici esistenti mantengono i valori e le modifiche attuali. |
| Union, overwrite existing values | Aggiunge i nuovi edifici e aggiorna gli edifici esistenti corrispondenti con i valori del Suo file. |
| Replace, keep existing values | Mantiene solo gli edifici presenti nel file caricato. Gli edifici esistenti corrispondenti mantengono i valori attuali. |
| Replace, overwrite existing values | Sostituisce tutti gli edifici del quartiere con il file caricato, ricostruendo il quartiere da zero. |
Quali dati devo fornire?
TESSA si adatta a vari livelli di disponibilità dei dati — da un elenco minimo di coordinate e superfici fino a un inventario completo degli impianti con dati di carico misurati.
1. Colonne minime obbligatorie
Per creare edifici ed eseguire i modelli di fabbisogno basati su archetipi di TESSA bastano tre elementi:
- Identificatore:
building_id— un numero intero univoco per ogni edificio. - Posizione: coordinate (
lat/lon,x/yogeometry). - Superficie utile:
era(Energy Reference Area, superficie di riferimento energetico m² — superficie riscaldata). Se assente, TESSA può stimare l'ERA datotal_surface(superficie lorda su tutti i piani).
building_id,lat,lon,era,const_class,const_period
1,46.2044,6.1432,450.0,Single-family house,1971-1980
2,46.2051,6.1440,1200.0,Apartment building,1991-2000
2. Colonne per la stima basata su archetipi
Quando i fabbisogni annui non sono stati misurati, i modelli integrati di TESSA (come Svizzera (Planeto) per il calore e Svizzera (PACE) per il raffrescamento) calcolano il fabbisogno energetico annuo a partire dagli archetipi:
const_class: categoria/archetipo dell'edificio (ad es.Single-family house,Apartment building,Office building,School). Vedere Archetipi di edifici per le stringhe riconosciute.const_period: fascia dell'epoca di costruzione (ad es.< 1919,1971-1980,2001-2010,> 2015).canton: codice del cantone svizzero (ad es.GE,VD,ZH), usato per la calibrazione climatica e regionale degli archetipi.
3. Fornire direttamente i valori di fabbisogno
Se dispone già di consumi misurati o di fabbisogni annui modellati (ad es. da certificati energetici, fatturazione del cliente o simulazioni di terzi), può includerli direttamente nella tabella. TESSA salta la stima per archetipi per questi edifici e usa i Suoi valori:
| Colonna di fabbisogno | Descrizione |
|---|---|
q_h_kwh | Fabbisogno annuo di riscaldamento degli ambienti kWh |
q_ww_kwh | Fabbisogno annuo di acqua calda sanitaria (ACS) kWh |
q_hww_kwh | Fabbisogno combinato di riscaldamento degli ambienti + ACS kWh |
q_c_kwh | Fabbisogno annuo di raffrescamento kWh |
q_h_kwh_m2 / q_ww_kwh_m2 / q_c_kwh_m2 | Fabbisogni annui specifici per metro quadro kWh/m² |
Come TESSA riconcilia i dati di fabbisogno parziali
TESSA applica regole coerenti quando combina o riconcilia i valori di fabbisogno:
- I valori dell'utente hanno la precedenza: i calcoli del modello non sovrascrivono mai i fabbisogni forniti dall'utente quando Preserva i valori esistenti è attivo.
- La regola 2 su 3: se vengono forniti due qualsiasi tra riscaldamento degli ambienti (
q_h_kwh), acqua calda sanitaria (q_ww_kwh) e fabbisogno combinato (q_hww_kwh), il terzo viene ricavato (q_hww = q_h + q_ww). - Conversione tra per m² e totale: se vengono forniti il fabbisogno specifico (ad es.
q_h_kwh_m2) e la superficie utile (era), viene calcolato il fabbisogno totale (q_h_kwh) (total = specific × era). Viceversa, se vengono forniti totali e superficie, si calcolano i valori specifici. - Requisito di Demand Ninja: se seleziona il modello Demand Ninja per dare forma alle curve di carico, deve fornire i totali annui di fabbisogno (
q_h_kwh,q_ww_kwh,q_c_kwh) e la potenza di picco oraria (p_h_max1h_kw,p_ww_max1h_kw,p_c_max1h_kw). Demand Ninja scala i profili orari sui Suoi valori; non calcola i fabbisogni a partire dagli archetipi.
4. Sistemi di riscaldamento e raffrescamento esistenti, ed emissioni
Per valutare il consumo di combustibile e le emissioni di CO₂ esistenti (per il confronto di base con una nuova rete di teleriscaldamento o teleraffrescamento), fornisca i dettagli degli impianti esistenti:
| Colonna | Descrizione | Esempio |
|---|---|---|
thermal_generator_sh | Codice del generatore esistente per il riscaldamento degli ambienti | gas_boiler, ashp, oil_boiler, direct_electric |
fuel_sh | Codice del combustibile per il riscaldamento degli ambienti | gas, electricity, heating_oil, wood_pellets |
heat_sh_efficiency | Rendimento o SPF del sistema di riscaldamento esistente − | 0.90 |
thermal_generator_dhw | Codice del generatore ACS esistente | electric_boiler, gas_boiler |
fuel_dhw | Codice del combustibile per l'ACS | electricity, gas |
heat_dhw_efficiency | Rendimento del sistema ACS esistente − | 0.85 |
thermal_generator_c | Codice del sistema di raffrescamento esistente | air_cooled_chiller, reversible_heat_pump |
fuel_c | Codice del combustibile per il raffrescamento | electricity |
thermal_c_efficiency | COP / SPF del raffrescamento esistente − | 3.2 |
I codici riconosciuti di generatori e combustibili recuperano automaticamente i fattori di emissione e i rendimenti predefiniti dal database di TESSA. Vedere Fonti energetiche.
5. Temperature di distribuzione (temperature di esercizio)
È possibile specificare le temperature di mandata della distribuzione interna dei sistemi di riscaldamento e raffrescamento dell'edificio:
temp_h_deg: temperatura di mandata della distribuzione di riscaldamento °C (ad es.65per radiatori datati,35per il riscaldamento a pavimento).temp_ww_deg: temperatura di mandata dell'acqua calda sanitaria °C (tipicamente60).temp_c_deg: temperatura di mandata della distribuzione di raffrescamento °C (tipicamente da7a12).
Temperature di distribuzione e setpoint di comfort
Si tratta delle temperature di mandata dell'acqua all'interno del sistema di distribuzione dell'edificio, usate per il dimensionamento delle sottostazioni e per il calcolo del COP delle pompe di calore. Non sono i setpoint del termostato dell'aria ambiente (come 20 °C).
Regole importanti e insidie comuni
1. building_id deve essere un numero intero
TESSA richiede che building_id sia un numero intero univoco (ad es. 1, 2, 3... o numeri EGID svizzeri). Se i dati di origine usano identificatori alfanumerici (ad es. BLD-101), conservi l'identificatore originale in una colonna di metadati personalizzata e assegni interi sequenziali a building_id.
2. Gating del fabbisogno: is_heated rispetto a is_cooled
is_heated: valetrueper impostazione predefinita se assente o nullo (tranne che per i garage). Gli edifici non riscaldati restano nel dataset ma ricevono fabbisogno di riscaldamento pari a zero.is_cooled: valefalseper impostazione predefinita se assente o nullo. A differenza del riscaldamento, gli edifici non ricevono fabbisogno di raffrescamento a meno cheis_coolednon sia esplicitamente impostato sutrue. Se fornisce valori di fabbisogno di raffrescamento o desidera che il modello PACE calcoli il raffrescamento, si assicuri cheis_cooledsia impostato sutrue(o1).
3. Tracciare la provenienza dei dati
È possibile includere colonne di metadati di origine per documentare da dove provengono i valori:
era_origin: fonte della superficie utile (ad es.cadastre,client_plan).qh_origin,qww_origin,qc_origin: fonte dei valori di fabbisogno (ad es.billing_2023,simulation,archetype).heating_origin,cooling_origin: fonte dello stato di riscaldamento/raffrescamento.
4. Colonne di output ignorate in input
Le colonne seguenti sono prodotte dalle simulazioni di TESSA e non devono essere fornite nelle tabelle di caricamento (gli eventuali valori forniti verranno sovrascritti o ignorati):
- Potenze termiche di picco in uscita (ad es.
p_h_max_kw,p_c_max_kw— salvo l'uso dei campi di input di Demand Ninja comep_h_max1h_kw). - Totali calcolati di energia finale ed emissioni (
emissions_co2_kg,final_energy_sh_kwh, ecc.). has_supplied_load_curve: impostato automaticamente quando si caricano curve di carico orarie con lo strumento per le curve di carico, non nella tabella degli edifici.
Scaricare i modelli
Parta da uno dei nostri modelli Excel preformattati:
- Modello minimo di tabella degli edifici — insieme minimo di colonne necessarie per caricare gli edifici ed eseguire un modello di fabbisogno di calore.
- Modello completo di tabella degli edifici — tutte le colonne di input accettate con descrizioni e valori di esempio.
Cosa fare dopo
Una volta caricata la tabella degli edifici in un quartiere:
- Ispezionare gli edifici sulla mappa: faccia clic sui singoli edifici per verificare coordinate, superficie, classificazioni degli archetipi e stime del fabbisogno. Vedere Modificare gli edifici sulla mappa.
- Generare curve di carico orarie: esegua Simulate building load curves per calcolare curve di riscaldamento e raffrescamento di 8760 ore per la simulazione della rete. Vedere Lavorare con le curve di carico degli edifici.
- Caricare curve di carico misurate: se dispone di curve di carico misurate a 15 minuti o orarie per specifici carichi di riferimento, le carichi con lo strumento di caricamento delle curve di carico. Vedere Caricare la curva di carico di un edificio.
- Progettare la rete: colleghi gli edifici alle fonti di calore con gli strumenti di tracciamento. Vedere Creare una rete.
Documentazione correlata
- Modello dati degli edifici — specifiche dettagliate e riferimento delle colonne per i modelli Excel.
- Mappare un file di origine sulla tabella degli edifici — guida passo per passo per trasformare esportazioni GIS e catastali nello schema di tabella di TESSA.
- Glossario delle variabili degli edifici — dizionario completo di tutte le variabili di input e output degli edifici.
- Archetipi di edifici — valori validi per
const_classeconst_period. - Fonti energetiche — codici di generatori e combustibili per i sistemi di riscaldamento e raffrescamento.
- Create district from buildings — documentazione di riferimento del pannello dello strumento.
- Creare edifici a mano — aggiungere singoli edifici direttamente senza caricare un file.
Caricare gli edifici da una regione
Nelle regioni supportate, TESSA può recuperare automaticamente i dati degli edifici da un database precaricato. Si disegna un poligono sulla mappa e TESSA interroga tutti gli edifici al suo interno, popolando il quartiere con geometria, attributi e stime della domanda di energia.
Utilizzare i dati degli edifici di OpenStreetMap
Per le località al di fuori della Svizzera, o ovunque si desiderino dati globali liberamente disponibili, TESSA può utilizzare le impronte degli edifici di OpenStreetMap (OSM) come punto di partenza per un quartiere.
