Faire correspondre un fichier source au tableau des bâtiments

Un guide pour convertir un jeu de données de bâtiments qui utilise ses propres noms de colonnes en un tableau que TESSA peut importer. Rédigé pour être suivi par une personne ou par un assistant IA travaillant à partir de cette page.

Le glossaire des variables de bâtiment dit ce que chaque colonne TESSA signifie. Cette page explique comment décider laquelle de vos colonnes devient quelle colonne TESSA, et que faire lorsque la réponse est ambiguë.

Formats de fichier

Acceptés : CSV, Excel (.xlsx), ODS, GeoPackage (.gpkg), GeoJSON, et d'autres formats lisibles par GDAL/OGR (KML). Les formats avec géométrie conservent leur géométrie ; les formats tabulaires nécessitent des colonnes de coordonnées (voir Géométrie).

Convertir le format de fichier pose rarement problème. Renommer les colonnes, si.

La procédure

Étape 1 — Inventorier la source

Avant de faire la moindre correspondance, listez pour chaque colonne du fichier source :

• le nom de la colonne
• son type de données
• trois ou quatre exemples de valeurs
• le nombre de lignes nulles

Les exemples de valeurs comptent plus que les noms. heat_demand peut être des kWh annuels, des kWh/m², ou une puissance de pointe en kW — seul l'ordre de grandeur vous le dit, et l'associer à la mauvaise colonne TESSA fausse silencieusement l'étude.

Étape 2 — Géométrie

Chaque bâtiment a besoin d'une localisation. TESSA cherche la géométrie dans cet ordre, et s'arrête à la première qui donne une valeur utilisable :

1. une colonne geometry — géométrie native dans un GeoPackage/GeoJSON, ou une chaîne WKT
2. lat + lon — degrés décimaux, WGS 84
3. x + y — coordonnées est/nord dans le SCR déclaré lors du téléversement

Remarques :

• Si le SCR source n'est pas WGS 84, déclarez-le lors du téléversement (input_crs) ou reprojetez d'abord. Un fichier suisse est généralement en EPSG:2056 ; un fichier britannique en EPSG:27700.
• Les lignes sans géométrie utilisable sont écartées, et l'importation indique combien.

Étape 3 — L'identifiant du bâtiment

building_id doit être un entier, unique dans le quartier.

• Si la source a un identifiant national ou cadastral numérique (un EGID suisse, par exemple), utilisez-le.
• Si l'identifiant est non numérique ("BLD-0042", une chaîne UPRN, un GUID), n'essayez pas de le convertir de force. Attribuez un building_id entier séquentiel, et conservez l'original dans une colonne séparée afin que le client puisse toujours faire le lien avec ses propres enregistrements.
• S'il n'y a aucun identifiant, numérotez les lignes 1..n.

Étape 4 — Colonnes de surface

Se tromper ici est l'erreur la plus fréquente et la plus dommageable.

era est ce que les modèles de demande utilisent réellement. Si la source n'a qu'une surface de plancher brute, associez-la à total_surface et laissez TESSA dériver era — n'associez pas la surface brute à era directement, ce qui surestime la demande.

Une surface d'emprise n'est pas une surface de plancher. Si la source n'a qu'une emprise et un nombre de niveaux, surface de plancher brute ≈ emprise × niveaux — mais notez que vous l'avez dérivée.

Étape 5 — Colonnes de demande

Distinguez les trois familles par ordre de grandeur et par unité, pas par le nom :

Et par usage final :

Règles pratiques :

• Une « demande de chaleur » unique et indifférenciée qui inclut manifestement l'eau chaude est q_hww_kwh, et non q_h_kwh.
• Fournissez deux quelconques parmi chauffage / eau chaude / combiné et TESSA dérive la troisième. Fournir les trois de façon incohérente est pire que d'en fournir deux.
• Convertissez d'abord en kWh. Une source en MWh, GJ ou therms associée sans conversion est fausse de plusieurs ordres de grandeur et ne sera pas détectée par la validation.
• Les colonnes de puissance de pointe (p_*) sont des sorties de modèle et ne sont pas acceptées en entrée. Voir la colonne Input du glossaire.

Étape 6 — Vocabulaires contrôlés

Trois champs n'acceptent que des valeurs d'une liste fixe. Le texte libre n'est pas rejeté — il ne correspond simplement à aucun archétype, et le bâtiment retombe sur les valeurs par défaut.

• const_class — 27 valeurs, voir Archétypes de bâtiments. Associez la classification d'usage de la source à la plus proche, p. ex. "MFH" / "multi-family" → Apartment building ; "EFH" / "detached" → Single-family house ; "retail" → Commercial building.
• const_period — par tranches, pas une année. Convertissez une année de construction en sa tranche : 1974 → 1971-1980. Les valeurs vont de < 1919 à > 2015, plus Unknown.
• fuel_sh, fuel_dhw, fuel_c et thermal_generator_* — codes de Sources d'énergie, p. ex. gas, oil, wood_pellet, electricity ; gas_boiler, ashp, gshp.

Lorsque le vocabulaire de la source est plus grossier que celui de TESSA, associez à la valeur la plus proche et signalez-le dans les notes de remise. N'inventez pas une précision que la source n'a pas.

Étape 7 — Indicateurs

is_heated et is_cooled sont des portes, pas des étiquettes : ils multiplient la demande dans les modèles. Un bâtiment avec is_cooled faux ou nul contribue zéro demande de refroidissement, quels que soient les chiffres de refroidissement fournis à côté.

Donc si vous associez des données de refroidissement, mettez is_cooled à vrai pour ces lignes. is_heated vaut vrai par défaut lorsque la colonne est absente.

Étape 8 — Relire avant d'écrire

Vérifiez, dans l'ordre :

1. Chaque colonne source est soit associée, soit délibérément écartée — aucune colonne oubliée silencieusement.
2. Chaque colonne TESSA que vous avez produite est orthographiée exactement comme dans le glossaire.
3. Aucune colonne marquée Input: No dans le glossaire n'a été remplie.
4. Unités converties, et ordres de grandeur plausibles (voir l'Étape 5).
5. Le nombre de lignes correspond à la source, ou la différence est expliquée.

Ce qu'il faut remettre

En plus du fichier converti, consignez :

• le tableau de correspondance : colonne source → colonne TESSA, avec toute conversion appliquée
• les colonnes dérivées et comment elles ont été dérivées
• les colonnes écartées et pourquoi
• les correspondances de vocabulaire lorsque la source était plus grossière que celle de TESSA
• les données requises absentes — surtout s'il n'y a pas de era ni de surface dont la dériver

Cela permet à quelqu'un de juger le résultat plus tard, et c'est la partie qu'une conversion automatique omet le plus souvent.

Importation minimale viable

Si la source contient très peu, le plus petit tableau utile est :

• building_id — entier, unique
• géométrie — geometry, ou lat+lon, ou x+y
• era — ou total_surface pour que TESSA en dérive era

Avec const_class et const_period en plus, les modèles d'archétypes suisses peuvent estimer la demande. Sans aucune colonne de surface, l'importation placera les bâtiments sur la carte mais ne peut pas modéliser leur demande.

Voir aussi : Glossaire des variables de bâtiment · Modèle de données de bâtiments · Archétypes de bâtiments · Sources d'énergie · Systèmes de coordonnées