Formati di esportazione
TESSA offre diversi modi per estrarre risultati e geometrie da uno scenario per l'uso in strumenti esterni.
Esportazione dello scenario (GeoPackage)
Formato: GeoPackage (.gpkg) incluso in un archivio .zip.
Disponibile da: scheda Reports → Export scenario oppure dall'endpoint API GET /v1/scenarios/{id}/export.
Un GeoPackage dello scenario contiene l'intero insieme di dati di progetto di un singolo scenario, tra cui:
| Livello / tabella | Descrizione |
|---|---|
| Geometria e attributi degli edifici | Tutti i dati degli edifici compresi i risultati del fabbisogno (ERA, q_h_kwh, q_c_kwh, riepilogo della curva di carico, ecc.) |
| Livelli dell'area di studio | Livelli di poligoni, linee e punti disegnati nel progetto |
| Rete di tubazioni | Tubazioni con geometria, DN, lunghezza, portata, perdite di calore e dati di costo |
| Centrali energetiche | Posizioni delle centrali energetiche e parametri delle fonti di calore |
| Sottostazioni | Punti di connessione degli edifici e geometria delle sottostazioni |
| Campi di sonde | Geometria della disposizione delle sonde e risultati del dimensionamento |
| Dati climatici | Serie temporali memorizzate nel GeoPackage come colonna binaria |
Tutta la geometria è in EPSG:4326 (WGS 84). Il GeoPackage può essere aperto in QGIS, ArcGIS o in qualsiasi software GIS compatibile con OGR.
Importazione di ritorno
Le esportazioni GeoPackage possono essere reimportate in TESSA per condividere scenari tra utenti o istanze. Usi Projects → Import scenario e fornisca il file .zip.
Esportazione dello scenario (KMZ)
Formato: KMZ (KML compresso) per Google Earth e strumenti analoghi.
Disponibile da: scheda Reports → Export KMZ.
Comprende impronte/punti degli edifici, rete di tubazioni e posizioni delle centrali energetiche. I dati degli attributi sono semplificati rispetto all'esportazione GeoPackage. Il sistema di coordinate è geografico WGS 84 (standard per KML).
Tabella degli edifici (CSV / Excel)
Formato: CSV o Excel (.xlsx).
Disponibile da: District inspector → Buildings table → Download oppure dall'API.
Esporta l'intera tabella degli attributi degli edifici (tutte le colonne mostrate nel Glossario delle variabili degli edifici) senza geometria. Utile per l'elaborazione successiva in Excel, Python o R.
La selezione delle colonne può essere ristretta nell'interfaccia prima del download.
Tabella delle tubazioni (Excel)
Formato: Excel (.xlsx) o ODS.
Disponibile da: Network inspector → Pipes → Download.
Esporta la tabella degli attributi delle tubazioni con:
| Colonna | Descrizione |
|---|---|
pipe_id | Identificatore interno della tubazione |
dn | Diametro nominale mm |
inner_diameter_m | Diametro interno m |
length | Lunghezza della tubazione m (singola tubazione) |
velocity_ms | Velocità del flusso m/s al picco |
mass_flow_kgs | Portata massica kg/s al picco |
heat_loss_kw | Perdita di calore della tubazione kW |
investment_cost_chf | Stima del costo di posa della tubazione CHF |
Curva di carico (CSV / Excel)
Formato: CSV o Excel.
La curva di carico del quartiere (potenza oraria di riscaldamento e raffrescamento) può essere scaricata dal pannello Load curves. Le colonne seguono il formato delle curve di carico: timestamp, p_h_kw, p_ww_kw, p_hww_kw, p_c_kw.
Risultati della simulazione della rete
I risultati della simulazione della rete (temperature dei nodi, pressioni, portate nelle tubazioni) sono visualizzati nella scheda Reports e possono essere scaricati come Excel o ODS dal pannello del rapporto della rete.
Dataset dei risultati grezzi (risultati del quartiere)
Formato: Excel (.xlsx), CSV o ODS. Nome file predefinito raw_table.xlsx.
Disponibile da: il download dei dati grezzi nella pagina del rapporto, oppure dall'endpoint API GET /api/v1/report/raw_data.
È il dataset in formato lungo che alimenta ogni elemento del rapporto — una riga per (part, component, variable). È l'esportazione leggibile da macchina più completa dei risultati di uno scenario, adatta a costruire tabelle pivot e grafici propri.
Ogni riga contiene:
| Colonna | Descrizione |
|---|---|
part | buildings, stand-alone, un uid di rete termica o district. |
component | thermal_source, pump, pipe, heat_loss, cooling_loss, booster_heat_pumps, energy_center, overall, … |
name | Etichetta leggibile (nulla nelle righe aggregate/overall). |
code | Codice stabile dell'oggetto di dominio (ad es. il codice della fonte termica o della centrale energetica). |
uid | Identificatore stabile dell'oggetto. |
variable | Nome della metrica (ad es. energy_useful, fuel, n_thermal_sources). |
value | Valore numerico o stringa. |
calculation_unit | Unità in cui il valore è calcolato. |
display_unit | Unità in cui l'app lo visualizza (può essere nulla). |
Unità autodescrittive e identificatori stabili (v5.3)
Dalla v5.3 ogni riga contiene calculation_unit, display_unit, code e uid, quindi il dataset è autodescrittivo — non occorre più conoscere le convenzioni interne di TESSA sulle unità per interpretare un valore. Le unità provengono dalle definizioni delle variabili di visualizzazione; gli identificatori provengono dagli oggetti di dominio sottostanti.
Righe aggregate rimosse
Le vecchie righe aggregate component="thermal_sources" e component="pumps" sono state rimosse. Usi invece le righe per singola istanza (component="thermal_source" / "pump") e le nuove righe per centrale energetica (component="energy_center" con i conteggi n_thermal_sources / n_pumps) per i totali strutturali. Anche i campi di tipo somma sono stati eliminati dalle righe di proiezione overall, che ora contengono solo intensità, picchi, proprietà fisiche e stato del sistema. Se dispone di uno script che leggeva quelle righe aggregate, lo modifichi in modo che sommi le righe per singola istanza.
Sistema di coordinate delle esportazioni
Tutte le esportazioni spaziali usano coordinate geografiche EPSG:4326 (WGS 84). Per lavorare con il reticolo nazionale svizzero (LV95), riproietti dopo l'esportazione con QGIS (Layer → Save As → selezioni il CRS 2056) o con ogr2ogr:
ogr2ogr -t_srs EPSG:2056 output_lv95.gpkg input_wgs84.gpkg
Vedere anche: Sistemi di coordinate · Guida utente — Esportare i risultati
Formato delle curve di carico
Una curva di carico è una serie temporale oraria del fabbisogno di potenza termica. TESSA può accettare curve di carico personalizzate a livello di quartiere (che sostituiscono o integrano il fabbisogno calcolato) e a livello di edificio (per singoli edifici con dati di consumo misurati).
Unità e convenzioni