Formats d'export
TESSA offre plusieurs moyens d'extraire les résultats et la géométrie d'un scénario pour les utiliser dans des outils externes.
Export de scénario (GeoPackage)
Format : GeoPackage (.gpkg) regroupé dans une archive .zip.
Disponible depuis : onglet Rapports → Exporter le scénario ou le point d'accès API GET /v1/scenarios/{id}/export.
Un GeoPackage de scénario contient l'ensemble des données du projet pour un seul scénario, notamment :
| Couche / table | Description |
|---|---|
| Géométrie et attributs des bâtiments | Toutes les données de bâtiments, y compris les résultats de demande (SRE, q_h_kwh, q_c_kwh, synthèse de la courbe de charge, etc.) |
| Couches de zone d'étude | Couches de polygones, de lignes et de points dessinées dans le projet |
| Réseau de conduites | Conduites avec géométrie, DN, longueur, débit, pertes thermiques et données de coûts |
| Centres énergétiques | Emplacements des centres énergétiques et paramètres des sources de chaleur |
| Sous-stations | Points de raccordement des bâtiments et géométrie des sous-stations |
| Champs de sondes | Géométrie de l'implantation des sondes et résultats de dimensionnement |
| Données climatiques | Séries temporelles stockées dans le GeoPackage dans une colonne binaire |
Toute la géométrie est en EPSG:4326 (WGS 84). Le GeoPackage peut être ouvert dans QGIS, ArcGIS ou tout logiciel SIG compatible OGR.
Import aller-retour
Les exports GeoPackage peuvent être réimportés dans TESSA pour partager des scénarios entre utilisateurs ou instances. Utilisez Projets → Importer un scénario et fournissez le fichier .zip.
Export de scénario (KMZ)
Format : KMZ (KML compressé) pour Google Earth et outils similaires.
Disponible depuis : onglet Rapports → Exporter en KMZ.
Comprend les emprises/points de bâtiments, le réseau de conduites et les emplacements des centres énergétiques. Les données d'attributs sont simplifiées par rapport à l'export GeoPackage. Le système de coordonnées est le WGS 84 géographique (standard pour le KML).
Tableau des bâtiments (CSV / Excel)
Format : CSV ou Excel (.xlsx).
Disponible depuis : Inspecteur de quartier → Tableau des bâtiments → Télécharger ou l'API.
Exporte le tableau complet des attributs des bâtiments (toutes les colonnes présentées dans le Glossaire des variables de bâtiments) sans géométrie. Utile pour le post-traitement dans Excel, Python ou R.
La sélection des colonnes peut être restreinte dans l'interface avant le téléchargement.
Tableau des conduites (Excel)
Format : Excel (.xlsx) ou ODS.
Disponible depuis : Inspecteur de réseau → Conduites → Télécharger.
Exporte le tableau des attributs des conduites avec :
| Colonne | Description |
|---|---|
pipe_id | Identifiant interne de la conduite |
dn | Diamètre nominal mm |
inner_diameter_m | Diamètre intérieur m |
length | Longueur de la conduite m (conduite simple) |
velocity_ms | Vitesse d'écoulement m/s à la pointe |
mass_flow_kgs | Débit massique kg/s à la pointe |
heat_loss_kw | Pertes thermiques de la conduite kW |
investment_cost_chf | Estimation du coût de pose de la conduite CHF |
Courbe de charge (CSV / Excel)
Format : CSV ou Excel.
La courbe de charge du quartier (puissance horaire de chauffage et de refroidissement) peut être téléchargée depuis le panneau Courbes de charge. Les colonnes suivent le format des courbes de charge : timestamp, p_h_kw, p_ww_kw, p_hww_kw, p_c_kw.
Résultats de simulation du réseau
Les résultats de simulation du réseau (températures des nœuds, pressions, débits des conduites) sont affichés dans l'onglet Rapports et peuvent être téléchargés en Excel ou ODS depuis le panneau de rapport du réseau.
Jeu de données de résultats bruts (résultats du quartier)
Format : Excel (.xlsx), CSV ou ODS. Nom de fichier par défaut raw_table.xlsx.
Disponible depuis : le téléchargement des données brutes de la page Rapport, ou le point d'accès API GET /api/v1/report/raw_data.
C'est le jeu de données au format long qui alimente tous les consommateurs du rapport — une ligne par (partie, composant, variable). C'est l'export lisible par machine le plus complet des résultats d'un scénario, adapté à la construction de vos propres tableaux croisés et graphiques.
Chaque ligne comporte :
| Colonne | Description |
|---|---|
part | buildings, stand-alone, un uid de réseau thermique, ou district. |
component | thermal_source, pump, pipe, heat_loss, cooling_loss, booster_heat_pumps, energy_center, overall, … |
name | Libellé lisible (nul sur les lignes agrégées/overall). |
code | Code stable de l'objet du domaine (p. ex. le code de la source thermique ou du centre énergétique). |
uid | Identifiant stable de l'objet. |
variable | Nom de la métrique (p. ex. energy_useful, fuel, n_thermal_sources). |
value | Valeur numérique ou chaîne. |
calculation_unit | Unité dans laquelle la valeur est calculée. |
display_unit | Unité dans laquelle l'application l'affiche (peut être nulle). |
Unités auto-descriptives et identifiants stables (v5.3)
Depuis la v5.3, chaque ligne comporte calculation_unit, display_unit, code et uid, de sorte que le jeu de données est auto-descriptif — vous n'avez plus besoin de connaître les conventions d'unités internes de TESSA pour interpréter une valeur. Les unités proviennent des définitions des variables d'affichage ; les identifiants proviennent des objets du domaine sous-jacents.
Lignes agrégées supprimées
Les anciennes lignes agrégées component="thermal_sources" et component="pumps" ont été supprimées. Utilisez plutôt les lignes par instance (component="thermal_source" / "pump"), et les nouvelles lignes par centre énergétique (component="energy_center" avec les nombres n_thermal_sources / n_pumps) pour les totaux structurels. Les champs de type somme ont également été retirés des lignes de projection overall, qui ne portent plus que des intensités, des pointes, des propriétés physiques et l'état du système. Si vous avez un script qui lisait ces lignes agrégées, modifiez-le pour qu'il somme les lignes par instance.
Système de coordonnées des exports
Tous les exports spatiaux utilisent des coordonnées géographiques EPSG:4326 (WGS 84). Pour travailler en coordonnées du réseau national suisse (MN95), reprojetez après l'export avec QGIS (Couche → Enregistrer sous → sélectionner le CRS 2056) ou ogr2ogr :
ogr2ogr -t_srs EPSG:2056 output_lv95.gpkg input_wgs84.gpkg
Voir aussi : Systèmes de coordonnées · Guide de l'utilisateur — Exporter les résultats
Format des courbes de charge
Une courbe de charge est une série temporelle horaire de la demande de puissance thermique. TESSA peut accepter des courbes de charge personnalisées au niveau du quartier (en remplacement ou en complément de la demande calculée) et au niveau du bâtiment (pour des bâtiments individuels disposant de données de consommation mesurées).
Unités et conventions