@open3cl/engine 1.8.4 → 1.8.6

package/2021_04_13_qualite_isolation.js

@@ -115,6 +115,13 @@ export default function calc_qualite_isolation(enveloppe, dp) {
     0
   );
 
+  /**
+   * Ubat = coefficient de transmission surfacique moyen de l'enveloppe (W/m².K).
+   * Il ne prend en compte QUE les déperditions par les parois et les ponts thermiques :
+   * les déperditions par renouvellement d'air (DR) sont volontairement exclues
+   * (cf. issue #45).
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - annexe 8 (indicateurs de qualité d'isolation)
+   */
   const deperdition =
     dp.deperdition_mur +
     dp.deperdition_plancher_bas +

package/2021_04_13_qualite_isolation.spec.js

@@ -4,9 +4,8 @@ import { describe, expect, test } from 'vitest';
  * Module purement calculatoire (aucune dépendance externe) : on teste
  * directement les seuils de qualité et l'agrégation des déperditions.
  */
-const { default: calc_qualite_isolation, qualite_isol } = await import(
-  './2021_04_13_qualite_isolation.js'
-);
+const { default: calc_qualite_isolation, qualite_isol } =
+  await import('./2021_04_13_qualite_isolation.js');
 
 /**
  * Qualité de l'isolation
@@ -121,6 +120,39 @@ describe('calc_qualite_isolation - agrégation et classement', () => {
     expect(ret.qualite_isol_plancher_haut_comble_amenage).toBe(2); // U = 0.2
   });
 
+  /**
+   * Ubat est un coefficient de transmission surfacique moyen : il exclut les
+   * déperditions par renouvellement d'air (DR).
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - annexe 8 / issue #45
+   */
+  test("les déperditions par renouvellement d'air (DR) ne sont pas prises en compte dans ubat", () => {
+    const env = enveloppe({
+      murs: [mur({ surface: 100, umur: 0.5 })],
+      pb: [plancherBas({ surface: 50, upb: 0.4 })],
+      ph: [plancherHaut({ surface: 30, uph: 0.2 })],
+      bv: [baie({ surface: 20, u: 2 })],
+      portes: [porte({ surface: 5, u: 2 })]
+    });
+    const dpSansDr = {
+      deperdition_mur: 50,
+      deperdition_plancher_bas: 20,
+      deperdition_plancher_haut: 6,
+      deperdition_baie_vitree: 40,
+      deperdition_porte: 10,
+      deperdition_pont_thermique: 10
+    };
+    const dpAvecDr = { ...dpSansDr, deperdition_renouvellement_air: 60 };
+
+    const sansDr = calc_qualite_isolation(env, dpSansDr);
+    const avecDr = calc_qualite_isolation(env, dpAvecDr);
+
+    // ubat = 136 / 205 dans les deux cas ; en incluant DR il vaudrait (136 + 60) / 205 ≈ 0.956
+    expect(avecDr.ubat).toBeCloseTo(136 / 205, 9);
+    expect(avecDr.ubat).toBe(sansDr.ubat);
+    // la classe d'isolation de l'enveloppe reste « moyenne » (3) et ne bascule pas en 4
+    expect(avecDr.qualite_isol_enveloppe).toBe(3);
+  });
+
   test('les locaux non déperditifs (adjacence 22) sont exclus des murs et planchers bas', () => {
     const env = enveloppe({
       murs: [mur({ surface: 100, umur: 0.5 }), mur({ adjacence: '22', surface: 999, umur: 9 })],

package/6.2_surface_sud_equivalente.js

@@ -5,12 +5,13 @@ import { mois_liste } from './utils.js';
 export function calc_sse_j(bv_list, ets, ca, zc, mois) {
   const baiesAdjVeranda = bv_list.filter((bv) => bv.donnee_entree.enum_type_adjacence_id === '10');
   const baiesAdjExt = bv_list.filter((bv) => bv.donnee_entree.enum_type_adjacence_id === '1');
+  const sseBaiesExt = baiesAdjExt.reduce((acc, bv) => {
+    return acc + getSsd(bv, zc, mois, bv.donnee_intermediaire.sw);
+  }, 0);
 
   //ets peut etre un tableau vide  ou undefined selon les DPE, d'où la vérification ajoutée sur le tableau et sa longueur
   if (!ets || (Array.isArray(ets) && ets.length === 0)) {
-    return baiesAdjExt.reduce((acc, bv) => {
-      return acc + getSsd(bv, zc, mois, bv.donnee_intermediaire.sw);
-    }, 0);
+    return sseBaiesExt;
   }
 
   // Certaines vérandas sont dupliqués dans les DPE.
@@ -18,6 +19,15 @@ export function calc_sse_j(bv_list, ets, ca, zc, mois) {
     ets = ets[0];
   }
 
+  /**
+   * 6.3 Traitement des espaces tampons solarisés
+   * Sse_ver n'est calculée que pour les baies vitrées qui séparent le logement de l'espace tampon
+   * (adjacence 10). Sans aucune de ces baies, les apports de l'espace tampon n'entrent pas dans le logement.
+   */
+  if (baiesAdjVeranda.length === 0) {
+    return sseBaiesExt;
+  }
+
   const bver = ets.donnee_intermediaire.bver;
   const T = ets.donnee_intermediaire.coef_transparence_ets;
 
@@ -70,10 +80,6 @@ export function calc_sse_j(bv_list, ets, ca, zc, mois) {
    */
   const SseVerandaj = Ssdj + ssIndj * bver;
 
-  const sseBaiesExt = baiesAdjExt.reduce((acc, bv) => {
-    return acc + getSsd(bv, zc, mois, bv.donnee_intermediaire.sw);
-  }, 0);
-
   return sseBaiesExt + SseVerandaj;
 }
 

package/6.2_surface_sud_equivalente.spec.js

@@ -115,10 +115,13 @@ describe('calc_sse_j - surface sud équivalente journalière', () => {
       }
     };
 
+    // Une baie logement / véranda (adjacence 10) est nécessaire pour que Sse_ver soit calculée (issue #140).
+    const bvList = [baie({ adjacence: '10', surface: 3, sw: 0.5 })];
+
     // orientation 'sud' + inclinaison par défaut 'verticale' => clé 'sud verticale' (c1j = 0.5)
     // coeff = 0.8 * T + 0.024 = 0.664 ; Sstj = 4 * 0.5 * 0.664 = 1.328
-    // pas de baie véranda => Ssdj = 0 ; ssInd = 1.328 ; SseVeranda = 1.328 * bver = 0.664
-    expect(calc_sse_j([], ets, 'ca1', 'h1a', 'Janvier')).toBeCloseTo(0.664, 10);
+    // Ssdj = 0.8 * (3*0.5*0.5) = 0.6 ; ssInd = 0.728 ; SseVeranda = 0.6 + 0.728 * bver = 0.964
+    expect(calc_sse_j(bvList, ets, 'ca1', 'h1a', 'Janvier')).toBeCloseTo(0.964, 10);
   });
 
   test('les facteurs fe1/fe2 de la baie extérieure sont appliqués au calcul', () => {
@@ -130,6 +133,78 @@ describe('calc_sse_j - surface sud équivalente journalière', () => {
   });
 });
 
+/**
+ * Issue #140 : la surface sud équivalente véranda (Sse_ver = Ssd + Ssind * bver) n'est calculée que
+ * pour les baies vitrées séparant le logement de l'espace tampon solarisé (adjacence 10).
+ * Sans aucune de ces baies, les apports de l'ETS n'entrent pas dans le logement => Sse_ver = 0.
+ * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.3
+ */
+describe('calc_sse_j - espace tampon solarisé sans baie séparant le logement de l’ETS', () => {
+  /** Fabrique un espace tampon solarisé avec une baie donnant sur l'extérieur. */
+  function espaceTampon({ bver = 0.5, T = 0.8 } = {}) {
+    return {
+      donnee_intermediaire: { bver, coef_transparence_ets: T },
+      baie_ets_collection: { baie_ets: baie({ adjacence: '1', surface: 4, sw: 1 }) }
+    };
+  }
+
+  test('ETS avec seulement des baies extérieures : seule la somme des baies adjacence 1 est retenue', () => {
+    const bvList = [
+      baie({ adjacence: '1', surface: 2, sw: 0.4 }),
+      baie({ adjacence: '3', surface: 5, sw: 0.9 }) // adjacence autre => ignorée
+    ];
+    // sseBaiesExt = 2 * 0.5 * 0.4 = 0.4 ; Sse_ver non ajoutée (avant correctif : 0.4 + 0.664)
+    expect(calc_sse_j(bvList, espaceTampon(), 'ca1', 'h1a', 'Janvier')).toBeCloseTo(0.4, 10);
+  });
+
+  test('ETS sans baie adjacence 10 : bver et coefficient de transparence sont sans effet', () => {
+    const bvList = [baie({ adjacence: '1', surface: 2, sw: 0.4 })];
+    const ref = calc_sse_j(bvList, null, 'ca1', 'h1a', 'Janvier');
+
+    expect(calc_sse_j(bvList, espaceTampon({ bver: 0.9, T: 0.2 }), 'ca1', 'h1a', 'Janvier')).toBe(
+      ref
+    );
+    expect(calc_sse_j(bvList, espaceTampon({ bver: 0.1, T: 0.9 }), 'ca1', 'h1a', 'Janvier')).toBe(
+      ref
+    );
+  });
+
+  test('ETS sans aucune baie vitrée du logement : surface sud équivalente nulle', () => {
+    expect(calc_sse_j([], espaceTampon(), 'ca1', 'h1a', 'Janvier')).toBe(0);
+  });
+
+  test('ETS dupliqué (tableau) sans baie adjacence 10 : même règle, Sse_ver non ajoutée', () => {
+    const bvList = [baie({ adjacence: '1', surface: 2, sw: 0.4 })];
+    const ets = [espaceTampon(), espaceTampon()];
+    expect(calc_sse_j(bvList, ets, 'ca1', 'h1a', 'Janvier')).toBeCloseTo(0.4, 10);
+  });
+
+  test('ETS avec une baie adjacence 10 : Sse_ver toujours calculée (non-régression)', () => {
+    const bvList = [
+      baie({ adjacence: '10', surface: 3, sw: 0.5 }),
+      baie({ adjacence: '1', surface: 2, sw: 0.4 })
+    ];
+    // Ssdj = 0.8 * (3*0.5*0.5) = 0.6 ; Sstj = 4 * 0.5 * 0.664 = 1.328 ; ssInd = 0.728
+    // SseVeranda = 0.6 + 0.728 * 0.5 = 0.964 ; sseBaiesExt = 0.4
+    // Valeur de référence de régression (calculée avec le vrai module, tables mockées) : 1.364
+    expect(calc_sse_j(bvList, espaceTampon(), 'ca1', 'h1a', 'Janvier')).toBeCloseTo(1.364, 9);
+  });
+
+  test('sans ETS : seules les baies extérieures comptent, les baies adjacence 10 sont ignorées', () => {
+    const bvList = [
+      baie({ adjacence: '10', surface: 3, sw: 0.5 }),
+      baie({ adjacence: '1', surface: 2, sw: 0.4 })
+    ];
+    expect(calc_sse_j(bvList, undefined, 'ca1', 'h1a', 'Janvier')).toBeCloseTo(0.4, 10);
+    expect(calc_sse_j(bvList, [], 'ca1', 'h1a', 'Janvier')).toBeCloseTo(0.4, 10);
+  });
+
+  test('calc_sse annuel : ETS sans baie adjacence 10 => pas de Sse_ver', () => {
+    const bvList = [baie({ adjacence: '1', surface: 2, sw: 0.4 })];
+    expect(calc_sse('ca1', 'h1a', bvList, espaceTampon())).toBeCloseTo(0.4, 10);
+  });
+});
+
 describe('calc_sse - surface sud équivalente annuelle', () => {
   test('agrège la surface sud équivalente sur tous les mois', () => {
     const bvList = [baie({ adjacence: '1', surface: 2, sw: 0.4 })];

package/README.md

@@ -370,28 +370,28 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.8.1`** · à publier · branche `main` · généré le 2026-10-01
+> **Version `1.8.5`** · à publier · branche `main` · généré le 2026-10-01
 > Seuil de tolérance **5%**
 
 <table>
 <tr>
 <td align="center"><strong>9</strong><br/><sub>corpus</sub></td>
 <td align="center"><strong>89 990</strong><br/><sub>DPE analysés</sub></td>
-<td align="center"><strong>59 630</strong><br/><sub>DPE conformes</sub></td>
-<td align="center"><strong>66,26 %</strong><br/><sub>réussite globale</sub></td>
+<td align="center"><strong>59 740</strong><br/><sub>DPE conformes</sub></td>
+<td align="center"><strong>66,39 %</strong><br/><sub>réussite globale</sub></td>
 </tr>
 </table>
 
 |     | Corpus                                                                                                                  |    Réussite |                        |  DPE conformes |
 | :-: | :---------------------------------------------------------------------------------------------------------------------- | ----------: | :--------------------- | -------------: |
-| 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **46,11 %** | `█████████░░░░░░░░░░░` | 4 611 / 10 000 |
-| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **91,69 %** | `██████████████████░░` | 9 169 / 10 000 |
-| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **88,19 %** | `██████████████████░░` |  8 812 / 9 992 |
-| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,02 %** | `██████████████████░░` | 8 802 / 10 000 |
-| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **74,08 %** | `███████████████░░░░░` |  7 407 / 9 999 |
-| 🟡  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **69,67 %** | `██████████████░░░░░░` | 6 967 / 10 000 |
-| 🟡  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **62,42 %** | `████████████░░░░░░░░` |  6 241 / 9 999 |
-| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **48,82 %** | `██████████░░░░░░░░░░` | 4 882 / 10 000 |
+| 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **46,23 %** | `█████████░░░░░░░░░░░` | 4 623 / 10 000 |
+| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **91,76 %** | `██████████████████░░` | 9 176 / 10 000 |
+| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **88,40 %** | `██████████████████░░` |  8 833 / 9 992 |
+| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,38 %** | `██████████████████░░` | 8 838 / 10 000 |
+| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **74,11 %** | `███████████████░░░░░` |  7 410 / 9 999 |
+| 🟡  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **69,74 %** | `██████████████░░░░░░` | 6 974 / 10 000 |
+| 🟡  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **62,44 %** | `████████████░░░░░░░░` |  6 243 / 9 999 |
+| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **49,04 %** | `██████████░░░░░░░░░░` | 4 904 / 10 000 |
 | 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **27,39 %** | `█████░░░░░░░░░░░░░░░` | 2 739 / 10 000 |
 
 <sub>🟢 ≥ 85 % · 🟡 ≥ 60 % · 🔴 < 60 %</sub>
@@ -403,24 +403,24 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <table>
 <tr>
-<td align="center"><strong>4,88 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>4,26 ms</strong><br/><sub>médiane</sub></td>
-<td align="center"><strong>0,11 ms</strong><br/><sub>min</sub></td>
-<td align="center"><strong>891,4 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>5,01 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>4,31 ms</strong><br/><sub>médiane</sub></td>
+<td align="center"><strong>0,13 ms</strong><br/><sub>min</sub></td>
+<td align="center"><strong>567,2 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 3,65 ms | 3,28 ms | 0,21 ms |  29,7 ms | 6,67 ms | 8,87 ms |
-| **Appartement · chauffage individuel (2025)**  | 3,54 ms | 3,23 ms | 1,09 ms |  24,6 ms | 6,11 ms | 8,02 ms |
-| **Logement individuel (2025)**                 | 4,89 ms | 4,37 ms | 1,41 ms |  39,4 ms | 9,35 ms | 12,7 ms |
-| **Maison individuelle (2025)**                 | 5,30 ms | 4,73 ms | 1,69 ms |  39,6 ms | 9,54 ms | 13,0 ms |
-| **Immeuble · chauffage individuel**            | 5,64 ms | 4,78 ms | 0,11 ms |  76,2 ms | 11,4 ms | 17,8 ms |
-| **Appartement · chauffage collectif (2025)**   | 3,92 ms | 3,56 ms | 1,18 ms |  32,4 ms | 6,59 ms | 9,44 ms |
-| **Immeuble · chauffage collectif**             | 5,56 ms | 4,75 ms | 0,13 ms | 140,4 ms | 10,7 ms | 18,7 ms |
-| **Immeuble · chauffage mixte**                 | 5,41 ms | 4,41 ms | 0,19 ms | 891,4 ms | 11,0 ms | 18,0 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 6,04 ms | 5,26 ms | 1,65 ms |  64,0 ms | 11,5 ms | 17,8 ms |
+| **Généraliste**                                | 4,04 ms | 3,63 ms | 0,21 ms |  24,9 ms | 7,45 ms | 10,8 ms |
+| **Appartement · chauffage individuel (2025)**  | 3,20 ms | 2,93 ms | 1,18 ms |  28,6 ms | 5,51 ms | 7,45 ms |
+| **Logement individuel (2025)**                 | 4,73 ms | 4,22 ms | 1,38 ms |  33,1 ms | 8,88 ms | 12,4 ms |
+| **Maison individuelle (2025)**                 | 5,37 ms | 4,79 ms | 1,68 ms |  52,5 ms | 9,69 ms | 13,3 ms |
+| **Immeuble · chauffage individuel**            | 7,43 ms | 6,08 ms | 0,19 ms | 137,8 ms | 16,0 ms | 28,0 ms |
+| **Appartement · chauffage collectif (2025)**   | 3,82 ms | 3,40 ms | 1,24 ms |  31,6 ms | 6,52 ms | 8,64 ms |
+| **Immeuble · chauffage collectif**             | 5,47 ms | 4,55 ms | 0,13 ms | 104,3 ms | 10,4 ms | 19,2 ms |
+| **Immeuble · chauffage mixte**                 | 5,31 ms | 4,38 ms | 0,22 ms | 567,2 ms | 10,9 ms | 17,8 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 5,72 ms | 4,85 ms | 1,75 ms |  61,2 ms | 11,0 ms | 17,3 ms |
 
 <sub>La moyenne est tirée vers le haut par les DPE collectifs, dont le coût atteint plusieurs
 dizaines de fois la médiane : c’est la médiane qui décrit le cas courant, et p95/p99 le cas

package/engine.js

@@ -33,7 +33,7 @@ import getFicheTechnique from './ficheTechnique.js';
 import { ProductionENR } from './16.2_production_enr.js';
 import DpeSanitizerService from './dpe-sanitizer.service.js';
 
-const LIB_VERSION = '1.8.4';
+const LIB_VERSION = '1.8.6';
 
 const dpeSanitizerService = new DpeSanitizerService();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open3cl/engine",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "description": "Open Source 3CL-DPE engine",
   "main": "index.js",
   "directories": {