Riferimento

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.

Per le colonne che TESSA richiede come minimo, vedere Modello dati degli edifici. Per i valori ammessi di const_class e const_period, vedere Archetipi di edifici.

Identità e geometria

Nome	Tipo	Unità	Input	Descrizione
`building_id`	integer	–	Sì	Identificatore univoco dell'edificio. Per gli edifici svizzeri è l'EGID federale. Deve essere univoco all'interno del quartiere. Usato come indice della tabella.
`id`	integer	–	No	ID interno della riga del database. Assegnato da TESSA alla creazione dell'edificio; non significativo tra quartieri o esportazioni.
`geometry`	geometry	–	Sì	Posizione dell'edificio come punto (centroide) o impronta poligonale. Stringa WKT o geometria GeoJSON. Se assente, TESSA tenta di ricavarla dalle colonne `lat`/`lon` o `x`/`y`.
`lat`	float	° (WGS 84)	Sì	Latitudine in gradi decimali (WGS 84). Alternativa a una colonna `geometry`.
`lon`	float	° (WGS 84)	Sì	Longitudine in gradi decimali (WGS 84). Alternativa a una colonna `geometry`.
`x`	float	m	Sì	Coordinata est nel CRS specificato al momento del caricamento. Alternativa a `lat`/`lon`.
`y`	float	m	Sì	Coordinata nord nel CRS specificato al momento del caricamento. Alternativa a `lat`/`lon`.

Caratteristiche dell'edificio

Nome	Tipo	Unità	Input	Descrizione
`is_heated`	boolean	–	Sì	Indica se l'edificio è riscaldato. Gli edifici non riscaldati (ad es. i garage) restano nel dataset ma contribuiscono con fabbisogno nullo.
`is_cooled`	boolean	–	Sì	Indica se l'edificio dispone di raffrescamento attivo degli ambienti. Un edificio lasciato nullo o `false` qui contribuisce con fabbisogno di raffrescamento nullo, anche se vengono forniti valori di raffrescamento.
`has_supplied_load_curve`	boolean	–	No	Indica se per questo edificio è stata fornita una curva di carico oraria (dati misurati, un modello esterno, …). I modelli di fabbisogno saltano questi edifici: la curva fornita è presa così com'è e sommata alla curva del quartiere senza scalatura. Impostato dal caricamento della curva di carico, non dalla tabella degli edifici.
`total_surface`	float	m²	Sì	Superficie lorda sommata su tutti i piani. Usata come ripiego per stimare l'ERA quando questa non è fornita.
`total_surface_main_residence`	float	m²	Sì	Superficie lorda usata come residenza principale.
`era`	float	m²	Sì	Energy Reference Area (superficie di riferimento energetico) — la superficie riscaldata (esclude cantina, sottotetto non riscaldato, ecc.). È la principale variabile di superficie usata nei calcoli del fabbisogno.
`n_floors`	integer	–	Sì	Numero di piani dell'edificio. Usato da alcuni modelli di archetipi e di raffrescamento come indicatore secondario delle dimensioni accanto a `era`/`total_surface`.
`const_class`	string	–	Sì	Destinazione d'uso / classe di costruzione dell'edificio. Vedere Archetipi di edifici per i valori validi.
`const_period`	string	–	Sì	Fascia del periodo di costruzione. Vedere Archetipi di edifici per i valori validi.
`altitude_m`	float	m	Sì	Altitudine sul livello del mare. Usata dal modello del fabbisogno di calore per la correzione climatica.

Impianto di riscaldamento esistente

Nome	Tipo	Unità	Input	Descrizione
`thermal_generator_sh`	string	–	Sì	Tipo di impianto esistente per il riscaldamento degli ambienti (ad es. `gas_boiler`, `ashp`). Usato per calcolare le emissioni di riferimento e l'energia finale.
`fuel_sh`	string	–	Sì	Codice del combustibile per il riscaldamento degli ambienti (ad es. `gas`, `electricity`, `wood_pellet`). Vedere Fonti energetiche per i codici validi.
`heat_sh_efficiency`	float	–	Sì	Rendimento dell'impianto esistente di riscaldamento degli ambienti. Per le caldaie: rendimento termico η; per le pompe di calore: SPF. Se non fornito, il valore predefinito è quello del preset della fonte termica.
`thermal_generator_dhw`	string	–	Sì	Tipo di impianto esistente per l'acqua calda sanitaria.
`fuel_dhw`	string	–	Sì	Codice del combustibile per l'acqua calda sanitaria.
`heat_dhw_efficiency`	float	–	Sì	Rendimento dell'impianto per l'acqua calda sanitaria.
`temp_h_deg`	float	°C	Sì	Temperatura di distribuzione del riscaldamento degli ambienti richiesta dall'impianto interno dell'edificio. Usata per dimensionare le sottostazioni (da essa si calcola un COP), non è un setpoint ambiente.
`temp_ww_deg`	float	°C	Sì	Temperatura di distribuzione dell'acqua calda richiesta dall'impianto interno dell'edificio.

Impianto di raffrescamento esistente

Nome	Tipo	Unità	Input	Descrizione
`thermal_generator_c`	string	–	Sì	Tipo di impianto esistente di raffrescamento (ad es. `air_cooled_chiller`).
`fuel_c`	string	–	Sì	Codice del combustibile per il raffrescamento.
`thermal_c_efficiency`	float	–	Sì	Rendimento (COP / SPF) dell'impianto di raffrescamento esistente.
`temp_c_deg`	float	°C	Sì	Temperatura di distribuzione del raffrescamento degli ambienti richiesta dall'impianto interno dell'edificio.

Fabbisogno di riscaldamento e acqua calda (annuo)

Queste colonne possono essere fornite nel caricamento per escludere il modello del fabbisogno di calore, oppure sono calcolate da esso.

Nome	Tipo	Unità	Input	Descrizione
`q_h_kwh_m2`	float	kWh/m²·ERA	Sì	Fabbisogno specifico di riscaldamento degli ambienti.
`q_ww_kwh_m2`	float	kWh/m²·ERA	Sì	Fabbisogno specifico di acqua calda sanitaria.
`q_hww_kwh_m2`	float	kWh/m²·ERA	Sì	Fabbisogno specifico combinato di calore + acqua calda. Ricavato dai due precedenti se non fornito.
`q_h_kwh`	float	kWh	Sì	Fabbisogno totale di riscaldamento degli ambienti. Ricavato da `q_h_kwh_m2 × era` se non fornito.
`q_ww_kwh`	float	kWh	Sì	Fabbisogno totale di acqua calda sanitaria.
`q_hww_kwh`	float	kWh	Sì	Fabbisogno totale di calore + acqua calda. Ricavato dai due precedenti se non fornito.

Fabbisogno di raffrescamento (annuo)

Nome	Tipo	Unità	Input	Descrizione
`q_c_kwh_m2`	float	kWh/m²·ERA	Sì	Fabbisogno specifico di raffrescamento.
`q_c_kwh`	float	kWh	Sì	Fabbisogno totale di raffrescamento.

Energia finale (riscaldamento e acqua calda)

Calcolata come fabbisogno utile ÷ rendimento del sistema. Non usata come input.

Nome	Tipo	Unità	Input	Descrizione
`q_h_final_kwh`	float	kWh	No	Energia finale consumata dal riscaldamento degli ambienti (al contatore del combustibile/dell'elettricità).
`q_ww_final_kwh`	float	kWh	No	Energia finale consumata dall'impianto per l'acqua calda sanitaria.
`q_hww_final_kwh`	float	kWh	No	Energia finale totale per riscaldamento e acqua calda.
`q_c_final_kwh`	float	kWh	No	Energia finale consumata dall'impianto di raffrescamento.

Potenza di picco

Calcolata dalla curva di carico. Non accettata come input.

Nome	Tipo	Unità	Input	Descrizione
`p_h_max1h_kw`	float	kW	No	Potenza oraria di picco del riscaldamento degli ambienti.
`p_ww_max1h_kw`	float	kW	No	Potenza oraria di picco dell'acqua calda.
`p_hww_max1h_kw`	float	kW	No	Potenza oraria di picco combinata di calore + acqua calda.
`p_c_max1h_kw`	float	kW	No	Potenza oraria di picco del raffrescamento.
`p_h_max1d_kw`	float	kW	No	Potenza di picco media giornaliera del riscaldamento degli ambienti.
`p_ww_max1d_kw`	float	kW	No	Potenza di picco media giornaliera dell'acqua calda.
`p_hww_max1d_kw`	float	kW	No	Potenza di picco media giornaliera combinata di calore + acqua calda.
`p_c_max1d_kw`	float	kW	No	Potenza di picco media giornaliera del raffrescamento.

Emissioni di gas serra

Nome	Tipo	Unità	Input	Descrizione
`co2eq_h_kg`	float	kg CO₂-eq	No	Emissioni di CO₂ equivalente del riscaldamento degli ambienti.
`co2eq_ww_kg`	float	kg CO₂-eq	No	Emissioni di CO₂ equivalente dell'acqua calda sanitaria.
`co2eq_hww_kg`	float	kg CO₂-eq	No	Emissioni totali di CO₂ equivalente di riscaldamento e acqua calda.
`co2eq_hww_kg_m2`	float	kg CO₂-eq/m²·ERA	No	Emissioni totali di CO₂ equivalente di riscaldamento e acqua calda, per metro quadro di ERA.
`co2eq_c_kg`	float	kg CO₂-eq	No	Emissioni di CO₂ equivalente del raffrescamento.
`c_co2_kg_kwh`	float	kg CO₂-eq/kWh	No	Intensità di CO₂ applicata all'energia finale del raffrescamento.
`sh_co2_kg_kwh`	float	kg CO₂-eq/kWh	No	Intensità di CO₂ applicata all'energia finale del riscaldamento degli ambienti.
`dhw_co2_kg_kwh`	float	kg CO₂-eq/kWh	No	Intensità di CO₂ applicata all'energia finale dell'acqua calda sanitaria.

Emissioni di inquinanti atmosferici locali (riscaldamento e acqua calda)

Calcolate dai fattori di emissione della combustione per il combustibile di riscaldamento. Non calcolate per i sistemi esclusivamente elettrici.

Nome	Tipo	Unità	Input	Descrizione
`nox_hww_g`	float	g	No	Emissioni di NOx da riscaldamento e acqua calda.
`co_hww_g`	float	g	No	Emissioni di CO da riscaldamento e acqua calda.
`sox_hww_g`	float	g	No	Emissioni di SOx da riscaldamento e acqua calda.
`pm10_hww_g`	float	g	No	Emissioni di PM10 da riscaldamento e acqua calda.
`pm2_5_hww_g`	float	g	No	Emissioni di PM2.5 da riscaldamento e acqua calda.

Provenienza dei dati

Nome	Tipo	Unità	Input	Descrizione
`era_origin`	string	–	Sì	Fonte del valore dell'ERA (ad es. `regbl`, `user`, `total_surface`).
`qh_origin`	string	–	Sì	Fonte del valore del fabbisogno di calore per riscaldamento degli ambienti (ad es. `ch_tessa`, `user`).
`qww_origin`	string	–	Sì	Fonte del valore del fabbisogno di acqua calda.
`qc_origin`	string	–	Sì	Fonte del valore del fabbisogno di raffrescamento.
`heating_origin`	string	–	Sì	Fonte del valore di `is_heated`.
`cooling_origin`	string	–	Sì	Fonte del valore di `is_cooled`.

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.

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.