@open3cl/engine 1.8.55 → 1.8.56

package/9_conso_ch.js

@@ -277,10 +277,15 @@ function calc_ch_base_appoint(
     const idx_ilpa = ilpa ? 1 : 0;
 
     const dh14Saison = mois_liste.reduce((acc, mois) => acc + dh14[idx_ilpa][ca][mois][zc], 0);
-    const rdim = de.rdim || 1;
-    const ratio_s = (s_chauffee_inst * rdim) / Sh;
-    const bch1 = (bch * ratio_s) / rdim;
-    const t = 14 - (pe * dh14Saison) / bch1;
+    /**
+     * Part de l'immeuble desservie par l'installation : S_ratio / Rdim = Sh_chauffée / Stotal
+     * (Tribu Calcul_installation.cs l.79-86 : bch et Bch1_mensuel sont proratisés tous les deux).
+     * `bch` est déjà proratisé par calc_chauffage ; le besoin mensuel, calculé pour tout le
+     * bâtiment, doit l'être avec le même ratio, sinon la part de base de chaque installation est
+     * calculée sur le besoin de l'immeuble entier.
+     */
+    const ratioSurface = s_chauffee_inst > 0 && Sh > 0 ? s_chauffee_inst / Sh : 1;
+    const t = 14 - (pe * dh14Saison) / bch;
 
     di.conso_ch = 0;
     for (const mois of mois_liste) {
@@ -310,10 +315,10 @@ function calc_ch_base_appoint(
         if (ratioDh <= 0) {
           bch_base_j = 0;
         } else {
-          bch_base_j = besoin_ch_mois[mois] * ratioDh;
+          bch_base_j = besoin_ch_mois[mois] * ratioSurface * ratioDh;
         }
       } else {
-        bch_base_j = besoin_ch_mois[mois] * 0.5;
+        bch_base_j = besoin_ch_mois[mois] * ratioSurface * 0.5;
       }
       bch_base += bch_base_j;
     }

package/9_conso_ch.spec.js

@@ -462,6 +462,90 @@ describe('conso_ch - installation collective base + appoint', () => {
     expect(di.conso_ch).toBeCloseTo(0, 9);
   });
 
+  /**
+   * Immeuble à plusieurs installations base + appoint : le besoin mensuel (calculé pour tout le
+   * bâtiment) est proratisé à la surface chauffée par l'installation, comme `bch`.
+   * Tribu Calcul_installation.cs l.79-86 : bch = Bch1 × S_ratio / Rdim et
+   * Bch1_mensuel × S_ratio / Rdim, avec S_ratio = Sh_chauffée × Rdim / Stotal.
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.8
+   */
+  describe('installation desservant une partie de l’immeuble (Sh_installation < Sh)', () => {
+    function appelPartiel(pos, { pn = 0, Sh = 200, sInst = 100, bch = 25, rdim = 1 } = {}) {
+      const args = baseAppointArgs(pos, { pn });
+      const [di, de, _pos, cfg, em_list, GV] = args;
+      de.rdim = rdim;
+      const besoinCouvert = conso_ch(
+        di,
+        de,
+        {},
+        _pos,
+        cfg,
+        em_list,
+        GV,
+        Sh,
+        2.5,
+        bch,
+        bch,
+        -9.5,
+        0,
+        1,
+        1,
+        { Janvier: 3000, Février: 2000 },
+        sInst,
+        args[16]
+      );
+      return { di, besoinCouvert };
+    }
+
+    test('pe = 0 : base = moitié du besoin mensuel de la seule part de l’installation', () => {
+      // Σ besoin mensuel immeuble = 5 kWh ; part de l'installation = 100 / 200 => base = 1,25 kWh
+      const { di, besoinCouvert } = appelPartiel(0);
+      expect(besoinCouvert).toBeCloseTo(1.25, 9);
+      // conso = base × Int (1) / (Rg 0,9 × Rendement émission 0,9)
+      expect(di.conso_ch).toBeCloseTo(1.25 / 0.81, 9);
+    });
+
+    test('pe = 0 : appoint = besoin de l’installation moins la base proratisée', () => {
+      const { besoinCouvert } = appelPartiel(1);
+      expect(besoinCouvert).toBeCloseTo(25 - 1.25, 9);
+    });
+
+    test('base + appoint = besoin de l’installation, quelle que soit la part de surface', () => {
+      for (const sInst of [20, 100, 180]) {
+        const bch = (50 * sInst) / 200;
+        const base = appelPartiel(0, { sInst, bch }).besoinCouvert;
+        const appoint = appelPartiel(1, { sInst, bch }).besoinCouvert;
+        expect(base + appoint).toBeCloseTo(bch, 9);
+        expect(base).toBeLessThanOrEqual(bch);
+      }
+    });
+
+    test('le rdim de l’installation ne modifie pas la part de base (S_ratio / Rdim)', () => {
+      const sansRdim = appelPartiel(0, { pn: 5000 }).besoinCouvert;
+      const avecRdim = appelPartiel(0, { pn: 5000, rdim: 7 }).besoinCouvert;
+      expect(avecRdim).toBeCloseTo(sansRdim, 9);
+    });
+
+    test('installation couvrant tout l’immeuble : comportement inchangé', () => {
+      // Sh = surface de l'installation => même résultat que le cas nominal
+      const { di } = appelPartiel(0, { Sh: 100, sInst: 100, bch: 50 });
+      expect(di.conso_ch).toBeCloseTo(3.0864197530864197, 9);
+    });
+
+    test('surface d’installation absente ou nulle : pas de proratisation du besoin mensuel', () => {
+      // Repli sur le besoin mensuel entier (ratio 1) : base = moitié de Σ besoin mensuel = 2,5 kWh
+      for (const sInst of [0, -1]) {
+        expect(appelPartiel(0, { sInst }).besoinCouvert).toBeCloseTo(2.5, 9);
+      }
+    });
+
+    test('surface habitable de l’immeuble nulle : pas de proratisation (aucune division par 0)', () => {
+      const { besoinCouvert } = appelPartiel(0, { Sh: 0 });
+      expect(Number.isFinite(besoinCouvert)).toBe(true);
+      expect(besoinCouvert).toBeCloseTo(2.5, 9);
+    });
+  });
+
   test('logement collectif ILPA + valeurs par défaut (rdim, rendement de génération)', () => {
     const di = { rg: 1, rg_dep: 1 };
     // pas de rdim => rdim = 1 ; pas de rendement_generation => Ich = 1

package/README.md

@@ -370,57 +370,57 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.8.54`** · branche `main` · généré le 2026-10-12
+> **Version `1.8.55`** · branche `main` · généré le 2026-10-12
 > Seuil de tolérance **5%**
 
 <table>
 <tr>
 <td align="center"><strong>9</strong><br/><sub>corpus</sub></td>
-<td align="center"><strong>89 980</strong><br/><sub>DPE analysés</sub></td>
-<td align="center"><strong>65 482</strong><br/><sub>DPE conformes</sub></td>
-<td align="center"><strong>72,77 %</strong><br/><sub>réussite globale</sub></td>
+<td align="center"><strong>89 853</strong><br/><sub>DPE analysés</sub></td>
+<td align="center"><strong>66 634</strong><br/><sub>DPE conformes</sub></td>
+<td align="center"><strong>74,16 %</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,65 %** | `█████████░░░░░░░░░░░` |  4 665 / 9 999 |
+| 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **47,08 %** | `█████████░░░░░░░░░░░` |  4 708 / 9 999 |
 | 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **92,90 %** | `███████████████████░` | 9 290 / 10 000 |
-| 🟢  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **91,62 %** | `██████████████████░░` | 9 162 / 10 000 |
-| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **89,93 %** | `██████████████████░░` |  8 986 / 9 992 |
-| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,89 %** | `██████████████████░░` |  8 888 / 9 999 |
-| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **84,57 %** | `█████████████████░░░` |  8 455 / 9 998 |
-| 🟡  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **74,90 %** | `███████████████░░░░░` |  7 486 / 9 995 |
-| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **56,67 %** | `███████████░░░░░░░░░` |  5 665 / 9 997 |
-| 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **28,85 %** | `██████░░░░░░░░░░░░░░` | 2 885 / 10 000 |
+| 🟢  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **91,72 %** | `██████████████████░░` | 9 172 / 10 000 |
+| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **90,47 %** | `██████████████████░░` |  9 040 / 9 992 |
+| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,90 %** | `██████████████████░░` |  8 889 / 9 999 |
+| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **84,58 %** | `█████████████████░░░` |  8 456 / 9 998 |
+| 🟡  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **84,58 %** | `█████████████████░░░` |  8 346 / 9 868 |
+| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **56,86 %** | `███████████░░░░░░░░░` |  5 684 / 9 997 |
+| 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **30,49 %** | `██████░░░░░░░░░░░░░░` | 3 049 / 10 000 |
 
 <sub>🟢 ≥ 85 % · 🟡 ≥ 60 % · 🔴 < 60 %</sub>
 
 #### Temps d’exécution
 
-> Durée de l’appel à `calcul_3cl` par DPE, sur 89 946 calculs.
+> Durée de l’appel à `calcul_3cl` par DPE, sur 89 819 calculs.
 > La copie défensive de l’entrée et la lecture du fichier sont exclues de la mesure.
 
 <table>
 <tr>
 <td align="center"><strong>5,46 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>4,78 ms</strong><br/><sub>médiane</sub></td>
-<td align="center"><strong>0,14 ms</strong><br/><sub>min</sub></td>
-<td align="center"><strong>912,6 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>4,77 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>656,0 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 4,42 ms | 3,97 ms | 0,21 ms |  28,2 ms | 8,06 ms | 11,2 ms |
-| **Appartement · chauffage individuel (2025)**  | 4,06 ms | 3,72 ms | 1,43 ms |  29,3 ms | 6,84 ms | 8,79 ms |
-| **Appartement · chauffage collectif (2025)**   | 4,46 ms | 4,11 ms | 1,68 ms |  38,0 ms | 7,20 ms | 9,18 ms |
-| **Logement individuel (2025)**                 | 5,51 ms | 4,94 ms | 1,67 ms |  41,4 ms | 10,2 ms | 13,5 ms |
-| **Maison individuelle (2025)**                 | 6,36 ms | 5,77 ms | 2,02 ms |  45,6 ms | 11,3 ms | 14,7 ms |
-| **Immeuble · chauffage individuel**            | 6,61 ms | 5,58 ms | 0,14 ms | 116,3 ms | 13,4 ms | 20,8 ms |
-| **Immeuble · chauffage collectif**             | 5,81 ms | 5,04 ms | 0,20 ms | 102,9 ms | 10,6 ms | 19,1 ms |
-| **Immeuble · chauffage mixte**                 | 5,69 ms | 4,56 ms | 0,20 ms | 912,6 ms | 12,1 ms | 20,2 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 6,24 ms | 5,28 ms | 1,72 ms |  64,6 ms | 11,8 ms | 19,5 ms |
+| **Généraliste**                                | 4,85 ms | 4,39 ms | 0,21 ms |  35,8 ms | 8,80 ms | 12,2 ms |
+| **Appartement · chauffage individuel (2025)**  | 4,07 ms | 3,71 ms | 1,47 ms |  33,7 ms | 7,08 ms | 8,93 ms |
+| **Appartement · chauffage collectif (2025)**   | 4,41 ms | 4,02 ms | 1,53 ms |  35,1 ms | 7,23 ms | 9,09 ms |
+| **Logement individuel (2025)**                 | 5,29 ms | 4,69 ms | 1,73 ms |  45,8 ms | 9,87 ms | 13,7 ms |
+| **Maison individuelle (2025)**                 | 6,25 ms | 5,66 ms | 1,90 ms |  52,3 ms | 11,1 ms | 14,7 ms |
+| **Immeuble · chauffage individuel**            | 6,46 ms | 5,54 ms | 0,13 ms | 105,5 ms | 12,9 ms | 20,2 ms |
+| **Immeuble · chauffage collectif**             | 5,76 ms | 4,91 ms | 0,19 ms | 116,4 ms | 10,6 ms | 16,8 ms |
+| **Immeuble · chauffage mixte**                 | 5,76 ms | 4,70 ms | 0,21 ms | 656,0 ms | 12,1 ms | 19,6 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 6,29 ms | 5,31 ms | 1,74 ms |  59,8 ms | 11,9 ms | 20,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

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

package/package.json

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