@open3cl/engine 1.10.0 → 1.11.0

package/15_conso_aux.js

@@ -368,6 +368,24 @@ export function conso_aux_distribution_ecs(
 ) {
   const typeInstallation = parseInt(de.enum_type_installation_id);
 
+  const ratioVirtu = parseFloat(de.ratio_virtualisation);
+  let Sh_immeuble_ratio = Sh_immeuble;
+  let Sh_install = de.surface_habitable || Sh_logement;
+  let Niv_inst_ecs = de.nombre_niveau_installation_ecs || 1;
+
+  if (!(Sh_immeuble > Sh_logement) && ratioVirtu > 0 && ratioVirtu < 1) {
+    Sh_immeuble_ratio = Sh_logement / ratioVirtu;
+    Sh_install = Sh_logement;
+    Niv_inst_ecs = nombre_niveau_immeuble || Niv_inst_ecs;
+  }
+
+  // Etape 3: Lb - longueur par défaut du bouclage ECS (m)
+  // Sh est la surface habitable des logements desservis par l'installation d'ECS
+  // Pour l'appartement, on utilise la surface à l'échelle de l'immeuble
+  const Sh = (Sh_install / Sh_logement) * Sh_immeuble_ratio;
+  const Lb = 4 * Math.pow(Sh / Niv_inst_ecs, 0.5) + 6 * (Niv_inst_ecs - 0.5);
+  di.lb = Lb;
+
   if (typeInstallation === 1) {
     di.conso_auxiliaire_distribution_ecs = 0;
     return;
@@ -402,24 +420,6 @@ export function conso_aux_distribution_ecs(
   const ca = enums.classe_altitude[caId];
   const zc = enums.zone_climatique[zcId];
 
-  const ratioVirtu = parseFloat(de.ratio_virtualisation);
-  let Sh_immeuble_ratio = Sh_immeuble;
-  let Sh_install = de.surface_habitable || Sh_logement;
-  let Niv_inst_ecs = de.nombre_niveau_installation_ecs || 1;
-
-  if (!(Sh_immeuble > Sh_logement) && ratioVirtu > 0 && ratioVirtu < 1) {
-    Sh_immeuble_ratio = Sh_logement / ratioVirtu;
-    Sh_install = Sh_logement;
-    Niv_inst_ecs = nombre_niveau_immeuble || Niv_inst_ecs;
-  }
-
-  // Etape 3: Lb - longueur par défaut du bouclage ECS (m)
-  // Sh est la surface habitable des logements desservis par l'installation d'ECS
-  // Pour l'appartement, on utilise la surface à l'échelle de l'immeuble
-  const Sh = (Sh_install / Sh_logement) * Sh_immeuble_ratio;
-  const Lb = 4 * Math.pow(Sh / Niv_inst_ecs, 0.5) + 6 * (Niv_inst_ecs - 0.5);
-  di.lb = Lb;
-
   // Etape 4: DeltaPb (kPa) - perte de charge dans le bouclage
   const DeltaPb = 0.2 * Lb + 10;
 

package/15_conso_aux.spec.js

@@ -874,7 +874,7 @@ describe("conso_aux_distribution_ecs - auxiliaires de distribution d'ECS", () =>
   ])('%s : pas de longueur de bouclage lb', (_libelle, de) => {
     const di = { besoin_ecs: 1000 };
     conso_aux_distribution_ecs({}, de, di, 50, 2000, 1, 1, 30);
-    expect(di.lb).toBeUndefined();
+    expect(di.lb).toBeCloseTo(181.88543819998318);
   });
 
   test('plus de niveaux desservis : bouclage plus court, donc consommation plus faible', () => {

package/9_chauffage.js

@@ -41,6 +41,20 @@ export function isEmetteurAppointIndividuel(instChDe, idx) {
   );
 }
 
+/**
+ * Longueur par défaut du réseau de l'installation de chauffage (m), même formule que la
+ * longueur de bouclage de l'installation ECS :
+ * Lb = 4 × (Sh / Niv)^0,5 + 6 × (Niv − 0,5)
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.3
+ * @param {number} surfaceInstallation surface chauffée par l'installation (m²)
+ * @param {number} nombreNiveau nombre de niveaux desservis par l'installation
+ * @returns {number}
+ */
+export function calc_lb_installation_ch(surfaceInstallation, nombreNiveau) {
+  const niv = Number(nombreNiveau) || 1;
+  return 4 * Math.pow(surfaceInstallation / niv, 0.5) + 6 * (niv - 0.5);
+}
+
 export default function calc_chauffage(
   dpe,
   ch,
@@ -67,6 +81,7 @@ export default function calc_chauffage(
 
   di.besoin_ch = bch;
   di.besoin_ch_depensier = bch_dep;
+  di.lb = calc_lb_installation_ch(de.surface_chauffee || Sh, de.nombre_niveau_installation_ch);
 
   const em_ch = ch.emetteur_chauffage_collection.emetteur_chauffage;
   em_ch.forEach((em_ch, idx) => {

package/9_chauffage.spec.js

@@ -62,7 +62,8 @@ const {
   generateursPrincipauxCascade,
   ratioDimensionnement,
   reseauCirculateurUnique,
-  isEmetteurAppointIndividuel
+  isEmetteurAppointIndividuel,
+  calc_lb_installation_ch
 } = await import('./9_chauffage.js');
 const { requestInput, tv, tvColumnIDs } = await import('./utils.js');
 const { calc_emetteur_ch } = await import('./9_emetteur_ch.js');
@@ -185,6 +186,8 @@ describe('calc_chauffage - cas nominal (1 générateur, 1 émetteur)', () => {
     expect(ch.donnee_intermediaire).toStrictEqual({
       besoin_ch: 1000,
       besoin_ch_depensier: 1200,
+      // 4 × (100 / 1)^0,5 + 6 × (1 − 0,5) = 43
+      lb: 43,
       conso_ch: 100,
       conso_ch_depensier: 120
     });
@@ -237,6 +240,53 @@ describe('calc_chauffage - cas nominal (1 générateur, 1 émetteur)', () => {
   });
 });
 
+/**
+ * Longueur du réseau de l'installation de chauffage, même formule que la longueur de
+ * bouclage ECS : Lb = 4 × (Sh / Niv)^0,5 + 6 × (Niv − 0,5)
+ * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.3
+ */
+describe('calc_lb_installation_ch - longueur du réseau de chauffage', () => {
+  test.each([
+    ['1 niveau, 100 m²', 100, 1, 43],
+    ['1 niveau, 50 m²', 50, 1, 31.284271247461902],
+    ['3 niveaux, 100 m²', 100, 3, 38.09401076758503]
+  ])('%s', (_libelle, surface, niveaux, attendu) => {
+    // valeurs de référence de régression
+    expect(calc_lb_installation_ch(surface, niveaux)).toBeCloseTo(attendu, 9);
+  });
+
+  test.each([undefined, 0, null])('nombre de niveaux %s : repli sur 1 niveau', (niveaux) => {
+    expect(calc_lb_installation_ch(100, niveaux)).toBe(43);
+  });
+
+  test('nombre de niveaux saisi en chaîne', () => {
+    expect(calc_lb_installation_ch(100, '3')).toBeCloseTo(38.09401076758503, 9);
+  });
+});
+
+describe('calc_chauffage - longueur lb dans la donnée intermédiaire de l’installation', () => {
+  test('surface chauffée et nombre de niveaux de l’installation utilisés', () => {
+    const ch = installation([generateur()], [emetteur('1')], {
+      surface_chauffee: 100,
+      nombre_niveau_installation_ch: 3
+    });
+    appel(ch, { Sh: 500 });
+    expect(ch.donnee_intermediaire.lb).toBeCloseTo(38.09401076758503, 9);
+  });
+
+  test('surface chauffée absente : repli sur la surface habitable Sh', () => {
+    const ch = installation([generateur()], [emetteur('1')], { surface_chauffee: 0 });
+    appel(ch, { Sh: 50 });
+    expect(ch.donnee_intermediaire.lb).toBeCloseTo(31.284271247461902, 9);
+  });
+
+  test('aucun impact sur le besoin transmis au générateur', () => {
+    const ch = installation([generateur()], [emetteur('1')], { nombre_niveau_installation_ch: 3 });
+    appel(ch);
+    expect(vi.mocked(calc_generateur_ch).mock.calls[0][5]).toBe(1000);
+  });
+});
+
 describe('calc_chauffage - mise à l’échelle du besoin selon la surface', () => {
   test('besoin ajusté au prorata surface_chauffee / Sh quand elles diffèrent', () => {
     const ch = installation([generateur()], [emetteur('1')]);

package/README.md

@@ -383,7 +383,7 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.9.1`** · branche `main` · généré le 2026-10-26
+> **Version `1.10.0`** · branche `main` · généré le 2026-10-29
 > Seuil de tolérance **5%**
 
 <table>
@@ -416,24 +416,24 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <table>
 <tr>
-<td align="center"><strong>6,66 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>5,79 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>911,0 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>5,64 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>4,87 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>957,0 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Appartement · chauffage individuel (2025)**  | 5,04 ms | 4,55 ms | 1,68 ms |  58,6 ms | 8,75 ms | 11,6 ms |
-| **Appartement · chauffage collectif (2025)**   | 5,96 ms | 5,55 ms | 2,00 ms |  56,7 ms | 9,64 ms | 12,0 ms |
-| **Logement individuel (2025)**                 | 6,17 ms | 5,46 ms | 1,75 ms |  60,4 ms | 11,5 ms | 16,1 ms |
-| **Maison individuelle (2025)**                 | 6,97 ms | 6,28 ms | 2,02 ms |  59,3 ms | 12,3 ms | 16,7 ms |
-| **Maison individuelle (2026)**                 | 7,06 ms | 6,30 ms | 2,00 ms |  45,5 ms | 12,6 ms | 17,6 ms |
-| **Immeuble · chauffage collectif**             | 6,94 ms | 5,88 ms | 0,14 ms | 144,5 ms | 12,8 ms | 22,1 ms |
-| **Immeuble · chauffage individuel**            | 7,88 ms | 6,68 ms | 0,13 ms | 172,2 ms | 15,7 ms | 25,4 ms |
-| **Immeuble · chauffage mixte**                 | 6,74 ms | 5,47 ms | 0,22 ms | 911,0 ms | 14,1 ms | 22,5 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 7,21 ms | 5,97 ms | 1,81 ms |  91,1 ms | 13,7 ms | 22,1 ms |
+| **Appartement · chauffage individuel (2025)**  | 4,00 ms | 3,58 ms | 1,42 ms |  34,6 ms | 6,99 ms | 9,30 ms |
+| **Appartement · chauffage collectif (2025)**   | 4,46 ms | 4,04 ms | 1,62 ms |  42,4 ms | 7,33 ms | 9,33 ms |
+| **Logement individuel (2025)**                 | 5,20 ms | 4,57 ms | 1,74 ms |  56,0 ms | 9,72 ms | 13,5 ms |
+| **Maison individuelle (2025)**                 | 6,01 ms | 5,41 ms | 2,04 ms |  51,8 ms | 10,7 ms | 14,3 ms |
+| **Maison individuelle (2026)**                 | 6,16 ms | 5,47 ms | 2,09 ms |  46,7 ms | 11,1 ms | 15,1 ms |
+| **Immeuble · chauffage collectif**             | 5,81 ms | 4,91 ms | 0,14 ms | 126,7 ms | 10,9 ms | 17,7 ms |
+| **Immeuble · chauffage individuel**            | 7,07 ms | 5,99 ms | 0,11 ms | 123,4 ms | 14,5 ms | 22,6 ms |
+| **Immeuble · chauffage mixte**                 | 5,73 ms | 4,63 ms | 0,20 ms | 957,0 ms | 11,9 ms | 19,7 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 6,33 ms | 5,26 ms | 1,79 ms |  79,2 ms | 12,0 ms | 19,1 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

@@ -36,7 +36,7 @@ import DpeSanitizerService from './dpe-sanitizer.service.js';
 import { reconstituerRdimDpeGenereImmeuble } from './17.2_rdim_dpe_genere_immeuble.js';
 import { reconstituerRdimEcsIndividuelleUnique } from './11_rdim_ecs_individuelle_unique.js';
 
-const LIB_VERSION = '1.10.0';
+const LIB_VERSION = '1.11.0';
 
 const dpeSanitizerService = new DpeSanitizerService();
 

package/package.json

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