Modello di dati degli edifici
Utilizzare questi modelli Excel come punto di partenza per preparare una tabella di dati degli edifici da caricare in TESSA.
Tabella minima — il più piccolo insieme di colonne necessario per caricare gli edifici ed eseguire un modello della domanda di calore: buildings_table_template_minimal.xlsx
Tabella completa — tutte le colonne di input accettate con valori di esempio: buildings_table_template_complete.xlsx
Formati di file
TESSA accetta tabelle di edifici in formato CSV, Excel (.xlsx) oppure ODS. I nomi delle colonne devono corrispondere esattamente (distinzione tra maiuscole e minuscole, trattini bassi come indicato).
Colonne minime obbligatorie
Queste sono le uniche colonne che occorre fornire. Tutto il resto viene derivato automaticamente o compilato dal modello della domanda di calore.
| Colonna | Tipo | Descrizione |
|---|---|---|
building_id | integer | Identificatore univoco dell'edificio nel proprio dataset. Per gli edifici svizzeri è l'EGID. Deve essere univoco per riga. |
era | float | Superficie di riferimento energetico — la superficie riscaldata m². Se assente, TESSA tenta di stimarla da total_surface con fattori di correzione per archetipo; fornirla direttamente dà risultati più accurati. |
Per collocare gli edifici sulla mappa serve inoltre almeno una colonna di geometria:
| Colonna | Note |
|---|---|
geometry | Stringa WKT di punto o poligono, nel CRS indicato al caricamento (predefinito WGS 84 / EPSG:4326) |
lat + lon | Gradi decimali, WGS 84 |
x + y | Coordinate est/nord nel CRS indicato al caricamento |
Se non viene fornita alcuna geometria, gli edifici vengono creati senza ubicazione e non possono essere collegati a una rete finché non si aggiunge la geometria.
Fornire direttamente i valori di domanda
Se si dispone già della domanda energetica annua misurata o modellata, fornirla nel caricamento e TESSA salterà la corrispondente fase di modello per quegli edifici. Ogni edificio con un valore non nullo in q_h_kwh o q_hww_kwh mantiene tale valore quando è selezionata l'opzione Fill building data automatically → preserve existing values (predefinita).
| Colonna | Descrizione |
|---|---|
q_h_kwh | Domanda annua di riscaldamento degli ambienti kWh |
q_ww_kwh | Domanda annua di acqua calda sanitaria kWh |
q_hww_kwh | Domanda combinata di riscaldamento + acqua calda kWh. Se non fornita, viene derivata come somma delle due precedenti. |
q_c_kwh | Domanda annua di raffrescamento kWh |
q_h_kwh_m2 | Domanda specifica di riscaldamento degli ambienti kWh/m². TESSA ne deriva q_h_kwh con era se manca il totale. |
q_ww_kwh_m2 | Domanda specifica di acqua calda kWh/m² |
q_c_kwh_m2 | Domanda specifica di raffrescamento kWh/m² |
Colonne obbligatorie per modello di domanda
Quando si esegue Simulate annual demands → Built-in model, le colonne che devono già esistere nella tabella degli edifici dipendono dal modello scelto. I modelli si dividono in due gruppi:
- Modelli ad archetipi (Svizzera (Planeto) per il calore, Svizzera (PACE) per il freddo) derivano la domanda annuale dagli archetipi di edificio. Richiedono colonne di archetipo e di superficie, ma calcolano loro i valori di domanda.
- Demand Ninja è un modellatore di curve di carico. Scala un profilo guidato dal clima per farlo corrispondere a domande annuali e picchi che devono già essere presenti nella tabella — non calcola la domanda dagli archetipi. Selezionare Demand Ninja senza le colonne di domanda sotto riportate non produce alcuna domanda.
Riscaldamento — Switzerland (Planeto)
| Colonna | Tipo | Descrizione |
|---|---|---|
const_class | string | Codice dell'archetipo della classe costruttiva (ad es. Single-family house) |
const_period | string | Codice dell'archetipo del periodo di costruzione (ad es. 1971-1980) |
era | float | Superficie di riferimento energetico m² |
is_heated assume per impostazione predefinita il valore true se assente. I valori esistenti di q_h_kwh / q_ww_kwh vengono mantenuti in modalità Preserva i valori esistenti; le colonne facoltative thermal_generator_sh, thermal_generator_dhw, fuel_sh e fuel_dhw abilitano l'output di efficienza ed emissioni.
Riscaldamento — Demand Ninja
| Colonna | Tipo | Descrizione |
|---|---|---|
is_heated | bool | Se l'edificio richiede riscaldamento |
q_h_kwh | float | Domanda annua di riscaldamento degli ambienti kWh |
p_h_max1h_kw | float | Potenza di picco oraria di riscaldamento kW |
q_ww_kwh | float | Domanda annua di acqua calda sanitaria kWh |
p_ww_max1h_kw | float | Potenza di picco oraria per l'acqua calda sanitaria kW |
Valore di ripiego: se q_h_kwh / q_ww_kwh mancano ma è presente q_hww_kwh (combinato), la ripartizione predefinita è 80 % riscaldamento / 20 % acqua calda sanitaria. Utilizzare valori individuali misurati o simulati, se disponibili.
Raffrescamento — Switzerland (PACE)
Obbligatorie quando Simula raffrescamento utilizza il modello PACE:
| Colonna | Tipo | Descrizione |
|---|---|---|
const_class | string | Classe costruttiva (stessi codici del calore) |
const_period | string | Periodo di costruzione (stessi codici del calore) |
canton | string | Codice del cantone svizzero (ad es. GE, ZH); utilizzato per la mappatura climatica regionale |
Il modello richiede inoltre un indicatore della superficie, risolto in quest'ordine: total_surface, poi era, poi ricavato a ritroso da q_h_kwh / q_h_kwh_m2 o q_hww_kwh / q_hww_kwh_m2. Se non è possibile risolverne alcuno, viene generato un errore. era serve a convertire la domanda specifica di raffrescamento dell'archetipo in un valore assoluto (q_c_kwh = q_c_kwh_m2 × era); se era manca, si ricorre a total_surface. is_cooled è considerato false quando la colonna è assente o vuota, quindi un edificio riceve domanda di raffrescamento solo se è contrassegnato esplicitamente come raffrescato. Si noti l'asimmetria con is_heated, considerato true se assente. I valori esistenti di q_c_kwh_m2 / q_c_kwh vengono mantenuti in modalità Preserva i valori esistenti; thermal_generator_c e fuel_c assumono per impostazione predefinita il condizionamento dell'aria a elettricità se assenti.
Raffrescamento — Demand Ninja
| Colonna | Tipo | Descrizione |
|---|---|---|
is_cooled | bool | Se l'edificio richiede raffrescamento |
q_c_kwh | float | Domanda annua di raffrescamento kWh |
p_c_max1h_kw | float | Potenza di picco oraria di raffrescamento kW |
Colonne di archetipo
Queste guidano il modello della domanda di calore quando la domanda non è fornita in anticipo. Per i valori di stringa validi, vedere Archetipi di edificio.
| Colonna | Descrizione |
|---|---|
const_class | Destinazione d'uso / classe costruttiva dell'edificio (ad es. Single-family house, Apartment building, Office building) |
const_period | Fascia del periodo di costruzione (ad es. 1971-1980, > 2015) |
Colonne del sistema di riscaldamento esistente
Fornirle per calcolare il consumo di energia finale di base e le emissioni del sistema di riscaldamento attuale — utile per confrontare uno scenario di teleriscaldamento con lo scenario senza interventi.
| Colonna | Descrizione |
|---|---|
thermal_generator_sh | Codice del sistema esistente di riscaldamento degli ambienti (ad es. gas_boiler, ashp). Vedere Fonti energetiche. |
fuel_sh | Codice del combustibile per il riscaldamento degli ambienti (ad es. gas, electricity). |
heat_sh_efficiency | Efficienza del sistema o SPF −. Se omessa, assume il valore predefinito del codice del generatore. |
thermal_generator_dhw | Codice del sistema esistente per l'acqua calda sanitaria. |
fuel_dhw | Codice del combustibile per l'acqua calda. |
heat_dhw_efficiency | Efficienza del sistema per l'acqua calda −. |
thermal_generator_c | Codice del sistema esistente di raffrescamento (ad es. air_cooled_chiller). |
fuel_c | Codice del combustibile per il raffrescamento. |
thermal_c_efficiency | COP / SPF del sistema di raffrescamento −. |
Altre colonne accettate
| Colonna | Descrizione |
|---|---|
is_heated | true/false — se l'edificio è riscaldato. Gli edifici non riscaldati contribuiscono con domanda nulla. Predefinito true per le classi costruttive diverse dai garage. |
is_cooled | true/false — se l'edificio dispone di raffrescamento attivo. Considerato false se assente, a differenza di is_heated. Entrambi agiscono da condizioni di attivazione: i modelli di domanda moltiplicano la domanda per questi valori, quindi un indicatore non impostato azzera tale domanda invece di limitarsi a etichettare l'edificio. |
total_surface | Superficie lorda di pavimento su tutti i piani m². Utilizzata solo per stimare l'ERA quando questa manca. |
total_surface_main_residence | Superficie lorda di pavimento residenziale m². |
altitude_m | Altitudine m. Utilizzata da alcuni modelli per la correzione climatica. |
canton | Sigla del cantone svizzero (ad es. GE). |
temp_h_deg | Temperatura di setpoint di riscaldamento °C. |
temp_ww_deg | Temperatura di erogazione dell'acqua calda °C. |
temp_c_deg | Temperatura di setpoint di raffrescamento °C. |
era_origin | Etichetta della fonte del valore ERA (testo libero, memorizzato come riferimento). |
qh_origin | Etichetta della fonte del valore di domanda di calore. |
qww_origin | Etichetta della fonte del valore di domanda di acqua calda. |
qc_origin | Etichetta della fonte del valore di domanda di raffrescamento. |
Colonne prodotte da TESSA (non accettate come input)
Le colonne seguenti vengono calcolate da TESSA dopo l'esecuzione del modello di calore/freddo e della generazione delle curve di carico. Compaiono nelle esportazioni e nella vista della tabella degli edifici, ma vengono ignorate se presenti in un caricamento.
Potenza di picco, energia finale, totali di emissioni di CO₂ e di inquinanti atmosferici — per l'elenco completo vedere il Glossario delle variabili degli edifici.
Sistema di riferimento delle coordinate
Il CRS predefinito per le coordinate caricate è EPSG:4326 (WGS 84). Se i dati utilizzano LV95 svizzero (EPSG:2056) o un altro sistema metrico, impostare il campo Codice EPSG CRS dati di input nello strumento di caricamento prima di caricare il file.
Vedere anche: Glossario delle variabili degli edifici · Archetipi di edificio · Sistemi di coordinate
Modello dati di reti e fonti di calore
Il lato offerta di uno studio TESSA: come vengono modellate e organizzate le tubazioni della rete termica, le sottostazioni degli edifici, le centrali energetiche, le fonti di calore e i campi di sonde.
Glossario delle variabili degli edifici
Ogni colonna che TESSA accetta in un caricamento di dati sugli edifici o produce come risultato di calcolo è elencata qui. Le colonne sono raggruppate per argomento; la colonna Input indica se il campo è accettato al caricamento di una tabella di edifici.
