Documentation — Lecteur XML RSET RE2020

Lecteur XML RSET RE2020

Documentation par l'exemple — cas d'usage chiffrés

Outil: rubrique-Thermique/xmlRE2020Reader.php — Bâti'Tools (compte PRO)
Ce que l'outil détermine: Les indicateurs RE2020 d'un projet — Bbio, Cep, Cep,nr, DH — lus directement dans le fichier XML RSET produit par le moteur de calcul, avec l'écart à chaque valeur maximale et l'enveloppe qui les explique
Entrée: Un fichier XML RSET, glissé dans la page
Sortie: Sept tableaux à l'écran, et un export CSV en dix sections

Il n'y a rien d'autre à faire que déposer le fichier dans la page. Pas de formulaire, pas de paramètre, pas de bouton « calculer » : la lecture démarre au dépôt et toutes les sections se remplissent d'un coup.

Un RSET est un fichier volumineux et profondément imbriqué, que personne n'ouvre avec plaisir dans un éditeur de texte. Pourtant tout ce qu'on veut en tirer au moment du rendu tient en quelques lignes : le Bbio du bâtiment tient-il sous son maximum, de combien, le Cep,nr passe-t-il, quel groupe dépasse en DH, et quelles parois portent ces résultats. L'outil va chercher ces valeurs et les met en tableau, sans rien recalculer : ce qui s'affiche est ce que contient le fichier, les seules valeurs dérivées étant les pourcentages de gain, obtenus par (max − projet) / max.

✓ Le fichier ne quitte jamais le navigateur. La lecture, l'analyse et la génération du CSV se font intégralement côté client, par le JavaScript de la page. Aucun envoi réseau, aucun dépôt sur le serveur : un RSET d'affaire peut y passer sans question de confidentialité.

Les sept sections de la page, dans l'ordre où elles apparaissent. Le bouton « Exporter CSV », en haut à droite, reste grisé tant qu'aucun fichier n'a été lu.

Le fichier d'exemple

Tous les tableaux qui suivent sortent d'un même RSET : deux bâtiments collectifs, chauffés et alimentés en ECS par une PAC air/eau collective avec appoint électrique.

Opération: Résidence Les Tilleuls — 2 bâtiments collectifs
Bâtiment A: S_REF = 1842,60 m² — trois parois opaques, deux menuiseries, ψ̄ = 0,312
Bâtiment B: S_REF = 968,40 m² — deux parois opaques, une menuiserie, ψ̄ = 0,348
Localisation: département 69, altitude 180 m
Générations: PAC air/eau collective (chauffage + ECS), appoint électrique ECS

Le cas est construit pour être instructif plutôt que confortable : le bâtiment A passe tous les seuils, le bâtiment B en rate deux et dépasse en DH. C'est précisément la situation où l'outil rend service — repérer en un coup d'œil lequel des deux bloque le dépôt.

E1 — Synthèse RE2020 : la première chose à regarder

La section en tête de page. Une ligne par bâtiment, chaque indicateur face à son maximum réglementaire, et le gain calculé par (max − projet) / max.

Bâtiment A

Bbio	Bbio max	Gain Bbio	Cep	Cep max	Gain Cep	Cepnr	Cepnr max	Gain Cepnr	Ratio ψ global
58.40	63.20	7.59 %	62.30	75.00	16.93 %	48.90	55.00	11.09 %	0.312

Bâtiment B

Bbio	Bbio max	Gain Bbio	Cep	Cep max	Gain Cep	Cepnr	Cepnr max	Gain Cepnr	Ratio ψ global
66.10	63.20	-4.59 % (non conforme)	71.80	75.00	4.27 %	56.40	55.00	-2.55 % (non conforme)	0.348

Lecture : un gain positif est une marge, un gain négatif un dépassement — l'outil l'écrit en rouge et ajoute « (non conforme) » derrière la valeur, sans qu'il y ait à comparer deux colonnes de tête. Le bâtiment B dépasse de 4,59 % en Bbio et de 2,55 % en Cep,nr, alors même que son Cep passe avec 4,27 % de marge : les trois indicateurs sont indépendants et il suffit d'un pour bloquer.

La marge du bâtiment A sur le Cep (16,93 %) est confortable ; celle du bâtiment B (4,27 %) ne l'est pas — à ce niveau, une variante de menuiserie ou un changement de scénario en fin d'étude peut la consommer entièrement.

E2 — Résumé & métadonnées, Opération, Générations

Les trois cartes de contrôle : elles servent surtout à vérifier qu'on lit bien le fichier qu'on croit, avant de s'appuyer sur les chiffres.

Résumé & métadonnées

Fichier: exemple_rset.xml
Opération (nom): Résidence Les Tilleuls — 2 bâtiments collectifs
Générations (nb): 2
Bâtiments (nb): 2

Générations

Deux pastilles : « PAC air/eau collective — chauffage + ECS » et « Appoint électrique ECS ».

RSET — Sorties du projet

Name: Résidence Les Tilleuls
Département: 69
Altitude: 180

Département et altitude déterminent la zone climatique et donc les valeurs maximales de la ligne du dessus : les vérifier ici évite d'argumenter sur un Bbio max calculé pour la mauvaise commune.

E3 — Bâtiments — Enveloppe : ce qui explique le résultat

Un volet dépliable par bâtiment, ouvert d'office pour les trois premiers. C'est la section à ouvrir quand un indicateur ne passe pas, pour voir sur quelle paroi agir.

Bâtiment #1 · O_SREF = 1842.60 · ψ̄ = 0.312

type_paroi	name	e (cm)	R (m²K/W)	U (W/m²K)	Surface (m²)
Mur ext.	Mur béton 20 + ITE 160	16.0	4.44	0.211	1204.80
Toiture	Toiture terrasse isolée 220	22.0	7.33	0.132	620.40
Plancher bas	Plancher bas sur parking — 120	12.0	3.16	0.286	620.40

orientation	name	Uw	Sw
Sud	Menuiserie alu RPT double vitrage — Sud	1.42	0.44
Nord	Menuiserie alu RPT double vitrage — Nord	1.42	0.38

Bâtiment #2 · O_SREF = 968.40 · ψ̄ = 0.348

type_paroi	name	e (cm)	R (m²K/W)	U (W/m²K)	Surface (m²)
Mur ext.	Mur béton 20 + ITE 140	14.0	3.89	0.239	702.10
Toiture	Toiture terrasse isolée 200	20.0	6.67	0.145	324.00

orientation	name	Uw	Sw
Ouest	Menuiserie PVC double vitrage — Ouest	1.30	0.41

Lecture : mis côte à côte, les deux volets donnent la réponse au dépassement du bâtiment B. Son mur est isolé en 140 au lieu de 160 (U 0,239 contre 0,211), sa toiture en 200 au lieu de 220 (0,145 contre 0,132), et son ψ̄ est plus élevé (0,348 contre 0,312) — trois écarts qui vont tous dans le même sens et se cumulent sur le Bbio. La comparaison est immédiate parce que les deux bâtiments sont lus dans le même tableau, avec les mêmes colonnes.

E4 — DH par bâtiment / zone / groupe : le confort d'été

La section la plus fine de la page : elle descend au groupe, seul niveau où le DH a un sens. Chemin strict dans le fichier — bâtiment, puis zone, puis groupe.

Bâtiment A · O_SREF = 1842.60 · Zones = 1 — Zone logements A

Groupe	DH projet (O_NbDegresHeures)	DH max (O_NbDegresHeures_max)
Logements traversants	612.40	1250.00
Logements mono-orientés Sud	1104.70	1250.00

Bâtiment B · O_SREF = 968.40 · Zones = 1 — Zone logements B

Groupe	DH projet (O_NbDegresHeures)	DH max (O_NbDegresHeures_max)
Logements mono-orientés Ouest	1387.20	1250.00

Lecture : le groupe traversant du bâtiment A est à moins de la moitié du plafond (612 pour 1250), les logements mono-orientés Sud sont à 88 % — passables mais sans réserve —, et le groupe mono-orienté Ouest du bâtiment B dépasse de 137 DH. L'exposition ouest en fin de journée d'été se lit directement dans le tableau, et le groupe fautif est nommé : c'est sur lui qu'il faut agir (protection solaire, surventilation, brasseurs), pas sur l'ensemble du bâtiment.

! Cette section ne rend pas de verdict. Contrairement à la synthèse RE2020, elle affiche les deux colonnes sans coloration ni mention « non conforme » : la comparaison 1387,20 > 1250,00 est à faire à l'œil. C'est la ligne à ne pas parcourir trop vite.

E5 — L'export CSV : dix sections dans un seul fichier

Le bouton « Exporter CSV », en haut à droite, s'active dès qu'un fichier a été lu. Il produit ici exemple_rset_extraction_rset.csv — le nom du XML, suffixé.

Le fichier est un CSV à point-virgule, découpé en sections annoncées par une ligne ### Section - …. Ouvert dans un tableur, il donne dans l'ordre :

Synthese RE2020 - Batiments — la synthèse de la section E1, gains compris
RSET - Sortie_Batiment_D (zones & groupes) — les DH, une ligne par groupe
Operation & Generations
Batiments - Indicateurs & O_SREF — index, surface de référence, ψ̄
Parois_opaques — une ligne par paroi, préfixée de l'index du bâtiment
Parois_vitrees
RSET - Entree_Projet — nom du projet, générations, bâtiments déclarés
RSET - Sortie_Projet — nom, département, altitude
RSET - Sortie_Batiment_B — Bbio, Bbio max, ratio ψ, Q4Pa/Sparoi
RSET - Sortie_Batiment_C — Cep, Cep max, Cep,nr, Cep,nr max

Les deux premières sections, telles qu'exportées

### Section - Synthese RE2020 - Batiments
Name;Bbio;Bbio_Max;Gain_Bbio_%;Cep;Cep_Max;Gain_Cep_%;Cepnr;Cepnr_Max;Gain_Cepnr_%;Ratio_psi
Bâtiment A;58.40;63.20;7.59;62.30;75.00;16.93;48.90;55.00;11.09;0.312
Bâtiment B;66.10;63.20;-4.59;71.80;75.00;4.27;56.40;55.00;-2.55;0.348

### Section - RSET - Sortie_Batiment_D (zones & groupes)
Batiment_Name;O_SREF;Zone_Name;Groupe_Name;O_NbDegresHeures;O_NbDegresHeures_max
Bâtiment A;1842.60;Zone logements A;Logements traversants;612.40;1250.00
Bâtiment A;1842.60;Zone logements A;Logements mono-orientés Sud;1104.70;1250.00
Bâtiment B;968.40;Zone logements B;Logements mono-orientés Ouest;1387.20;1250.00

Et la section des parois opaques

### Section - Parois_opaques
Bat_Index;type_paroi;name;epaisseur_isolant;resistance_thermique_isolant;U_paroi;surface_totale
1;Mur ext.;Mur béton 20 + ITE 160;16.0;4.44;0.211;1204.80
1;Toiture;Toiture terrasse isolée 220;22.0;7.33;0.132;620.40
1;Plancher bas;Plancher bas sur parking — 120;12.0;3.16;0.286;620.40
2;Mur ext.;Mur béton 20 + ITE 140;14.0;3.89;0.239;702.10
2;Toiture;Toiture terrasse isolée 200;20.0;6.67;0.145;324.00

Le séparateur point-virgule et les valeurs entre guillemets dès qu'elles contiennent un point-virgule, une virgule ou un retour à la ligne : le fichier s'ouvre directement dans Excel en configuration française. En revanche les nombres gardent le point décimal du XML — c'est fidèle au fichier source, mais il faut penser au remplacement point → virgule si l'on veut recalculer dans le tableur.

Ce que l'outil ne fait pas, et les messages

Fichier illisible: « Erreur de parsing XML: … » — le fichier n'est pas un XML valide, ou a été tronqué à la copie
Aucune donnée de sortie: « Aucune donnée de sortie RE2020 trouvée (Sortie_Batiment_B/C). » — le fichier déposé est probablement un RSEE ou un export intermédiaire, pas un RSET
Aucun DH: « Aucune Sortie_Batiment_D / Zone / Groupe trouvée via le chemin strict. »
Section d'entrée absente: « Section RSET/Entree_Projet non trouvée. »
Ni génération, ni paroi: « Aucune génération trouvée. », « Aucune paroi opaque. », « Aucune paroi vitrée. »

Trois limites à connaître :

L'outil ne recalcule rien. Il ne vérifie pas un Bbio, il le lit. Si le moteur de calcul s'est trompé, l'outil affichera la même erreur sans la détecter. Les seuls nombres qu'il produit lui-même sont les trois pourcentages de gain.
Il ne compare pas deux fichiers. Pour confronter une variante à une base, il faut exporter les deux CSV et les rapprocher dans le tableur.
Il ne remonte aucune valeur au serveur — ce qui est un avantage sur la confidentialité, mais signifie aussi qu'aucun historique n'est conservé d'une session à l'autre. Le CSV est la seule trace : il est à ranger dans le dossier de l'affaire.