@open3cl/engine 1.8.28 → 1.8.30

package/15_conso_aux.js

@@ -16,9 +16,8 @@ const H_CHAUDIERE_BOIS = 10.5;
  * @param type {'ecs'|'ch'}
  * @param besoin {number} Besoin en chauffage ou ecs pour ce générateur
  * @param besoin_dep {number} Besoin en chauffage ou ecs pour ce générateur (mode dépensier)
- * @param Sh {number} Surface habitable du logement
  */
-export function conso_aux_gen(di, de, type, besoin, besoin_dep, Sh) {
+export function conso_aux_gen(di, de, type, besoin, besoin_dep) {
   const typeGenerateur = parseInt(de[`enum_type_generateur_${type}_id`]);
 
   const presenceVentilateur = de.presenceVentilateur || 0;
@@ -26,7 +25,16 @@ export function conso_aux_gen(di, de, type, besoin, besoin_dep, Sh) {
   const g = getG(type, typeGenerateur, presenceVentilateur === 1);
   const h = getH(type, typeGenerateur, presenceVentilateur === 1);
 
-  let pe = di.pn / (de.ratio_virtualisation || 1);
+  /**
+   * Caux_g = Paux_g × Bch / Pn : les plafonds ci-dessous (400 / 300 / 70 kW) ne s'appliquent
+   * qu'à la puissance utilisée dans Paux_g = G + H × Pn ; le dénominateur reste la puissance
+   * nominale réelle du générateur, comme le moteur de référence CSTB (Tribu) et comme le calcul
+   * dépensier. Autotests CSTB APP3-0-3 (chaudière bois collective 150 kW, Tribu Qaux_ch =
+   * 13,27 kWh) et IC4-0-1 (chaudière bois 300 kW, Tribu Qaux_ch = 864,60 kWh).
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
+   */
+  const pnReel = di.pn / (de.ratio_virtualisation || 1);
+  let pe = pnReel;
 
   // Pour les chaudières gaz ou fioul : si Pn > 400 kW alors Pn = 400 kW
   if (g === G_CHAUDIERE && pe > 400000) {
@@ -53,17 +61,16 @@ export function conso_aux_gen(di, de, type, besoin, besoin_dep, Sh) {
   let besoinAppart = besoin * (de[`cle_repartition_${type}`] || 1);
   let besoinAppartDep = besoin_dep * (de[`cle_repartition_${type}`] || 1);
 
-  let ratio = 1;
-
-  // Pour le chauffage, le besoin de chauffage est proratisé à la surface chauffée
-  if (type === 'ch') {
-    const Sc = de.surface_chauffee || Sh;
-    ratio = Sc / Sh;
-  }
-
-  di[`conso_auxiliaire_generation_${type}`] = (Paux_g_ch * besoinAppart * ratio) / pe || 0;
-  di[`conso_auxiliaire_generation_${type}_depensier`] =
-    (Paux_g_ch * besoinAppartDep * ratio) / (di.pn / (de.ratio_virtualisation || 1)) || 0;
+  /**
+   * Le besoin reçu est déjà celui de l'installation : calc_chauffage le proratise par
+   * Sc / Sh (surface chauffée de l'installation / surface habitable). Ne pas le proratiser une
+   * seconde fois (sinon Bch × (Sc / Sh)²), comme le moteur de référence CSTB (Tribu).
+   * Autotest CSTB MI5-0-8 : radiateur gaz, Sc = 96 m², Sh = 136 m², Tribu Qaux_ch = 84,69 kWh
+   * (59,78 kWh avec le double prorata, −29 %).
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
+   */
+  di[`conso_auxiliaire_generation_${type}`] = (Paux_g_ch * besoinAppart) / pnReel || 0;
+  di[`conso_auxiliaire_generation_${type}_depensier`] = (Paux_g_ch * besoinAppartDep) / pnReel || 0;
 }
 
 /**

package/15_conso_aux.spec.js

@@ -83,13 +83,39 @@ describe('conso_aux_gen - auxiliaires de génération', () => {
     expect(sansVentilateur.conso_auxiliaire_generation_ch).toBe(0);
   });
 
-  test('chaudière gaz avec Pn > 400 kW : puissance plafonnée à 400 kW', () => {
+  test('chaudière gaz avec Pn > 400 kW : puissance plafonnée à 400 kW dans Paux_g seulement', () => {
     const diCap = { pn: 500000 };
     conso_aux_gen(diCap, { enum_type_generateur_ch_id: '90' }, 'ch', 1000, 1200, 100);
-    expect(diCap.conso_auxiliaire_generation_ch).toBeCloseTo(1.65, 10);
+    // Paux = 20 + 1,6 × 400 = 660 W ; conso = 660 × 1000 / 500000 (Pn réel, §15.1)
+    expect(diCap.conso_auxiliaire_generation_ch).toBeCloseTo(1.32, 10);
     expect(diCap.conso_auxiliaire_generation_ch_depensier).toBeCloseTo(1.584, 10);
   });
 
+  /**
+   * Le besoin transmis par calc_chauffage est déjà proratisé par Sc / Sh : aucun second prorata.
+   * Autotest CSTB MI5-0-8 : radiateur gaz (G = 40, H = 0), Sc = 96 m², Sh = 136 m².
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
+   */
+  test('chauffage : surface chauffée partielle sans second prorata Sc / Sh du besoin', () => {
+    const diPartiel = { pn: 20000 };
+    const diTotal = { pn: 20000 };
+    conso_aux_gen(
+      diPartiel,
+      { enum_type_generateur_ch_id: '90', surface_chauffee: 96 },
+      'ch',
+      1000,
+      1200
+    );
+    conso_aux_gen(diTotal, { enum_type_generateur_ch_id: '90' }, 'ch', 1000, 1200);
+    // Paux = 20 + 1,6 × 20 = 52 W ; conso = 52 × 1000 / 20000 = 2,6 (sans facteur 96 / 136)
+    expect(diPartiel.conso_auxiliaire_generation_ch).toBeCloseTo(2.6, 10);
+    expect(diPartiel.conso_auxiliaire_generation_ch_depensier).toBeCloseTo(3.12, 10);
+    expect(diPartiel.conso_auxiliaire_generation_ch).toBeCloseTo(
+      diTotal.conso_auxiliaire_generation_ch,
+      10
+    );
+  });
+
   test('type ECS : aucun prorata de surface chauffée appliqué', () => {
     const de = { enum_type_generateur_ecs_id: '50' };
     conso_aux_gen(di, de, 'ecs', 800, 1000, 100);
@@ -102,8 +128,8 @@ describe('conso_aux_gen - auxiliaires de génération', () => {
     const diAir = { pn: 500000 };
     conso_aux_gen(diAir, { enum_type_generateur_ch_id: '50' }, 'ch', 1000, 1200, 100);
     // g=0, h=4, pe plafonné à 300000 => Paux = 0 + 4*300 = 1200
-    // conso = (1 * (1200 * 1000 * 1)) / 300000 = 4
-    expect(diAir.conso_auxiliaire_generation_ch).toBeCloseTo(4, 10);
+    // conso = (1200 * 1000) / 500000 = 2.4 (dénominateur = Pn réel, §15.1)
+    expect(diAir.conso_auxiliaire_generation_ch).toBeCloseTo(2.4, 10);
     // depensier utilise di.pn (500000, non plafonné) : (1200 * 1200) / 500000 = 2.88
     expect(diAir.conso_auxiliaire_generation_ch_depensier).toBeCloseTo(2.88, 10);
   });
@@ -120,8 +146,37 @@ describe('conso_aux_gen - auxiliaires de génération', () => {
       100
     );
     // pe plafonné à 70000 => Paux = 73.3 + 10.5*70 = 808.3
-    // conso = (1 * (808.3 * 1000 * 1)) / 70000
-    expect(diBois.conso_auxiliaire_generation_ch).toBeCloseTo((808.3 * 1000) / 70000, 10);
+    // conso = (808.3 * 1000) / 100000 (dénominateur = Pn réel, §15.1)
+    expect(diBois.conso_auxiliaire_generation_ch).toBeCloseTo((808.3 * 1000) / 100000, 10);
+  });
+
+  /**
+   * Autotest CSTB APP3-0-3 : chaudière bois collective (ventilateur), Pn logement 5589,19 W,
+   * ratio_virtualisation 0,0372613 => Pn immeuble 150 kW, plafonnée à 70 kW dans Paux_g seulement.
+   * Paux_g = 73,3 + 10,5 × 70 = 808,3 W ; Tribu Qaux_ch = 13,27 kWh = 808,3 × 2462,6 / 150000
+   * (avec le plafond au dénominateur : 808,3 × 2462,6 / 70000 = 28,4 kWh, +114 %).
+   */
+  test('chaudière bois virtualisée > 70 kW : Caux_g = Paux_g(70 kW) × Bch / Pn immeuble réelle', () => {
+    const diApp = { pn: 5589.19 };
+    conso_aux_gen(
+      diApp,
+      {
+        enum_type_generateur_ch_id: '60',
+        presenceVentilateur: 1,
+        ratio_virtualisation: 0.037261294829995344
+      },
+      'ch',
+      2462.6,
+      2462.6,
+      80
+    );
+    const pnImmeuble = 5589.19 / 0.037261294829995344;
+    expect(diApp.conso_auxiliaire_generation_ch).toBeCloseTo((808.3 * 2462.6) / pnImmeuble, 10);
+    expect(diApp.conso_auxiliaire_generation_ch).toBeCloseTo(13.27, 2);
+    expect(diApp.conso_auxiliaire_generation_ch_depensier).toBeCloseTo(
+      diApp.conso_auxiliaire_generation_ch,
+      10
+    );
   });
 
   test('type de générateur inconnu (ni ch ni ecs) : facteurs nuls, consommation nulle', () => {

package/9_generateur_ch.js

@@ -249,7 +249,7 @@ export function calc_generateur_ch(
     tv_rendement_generation(di, de, du);
   }
 
-  conso_aux_gen(di, de, 'ch', bch, bch_dep, Sh);
+  conso_aux_gen(di, de, 'ch', bch, bch_dep);
 
   /**
    * 15 Calcul des consommations d’auxiliaires des installations de chauffage (Caux_ch) et d’ECS (Caux_ecs)

package/README.md

@@ -4,7 +4,7 @@
 [![Forks][forks-shield]][forks-url]
 [![Stargazers][stars-shield]][stars-url]
 [![Issues][issues-shield]][issues-url]
-[![ GPL-3.0 license][license-shield]][license-url]
+[![ MIT license][license-shield]][license-url]
 
 <br />
 <div align="center">
@@ -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.27`** · branche `main` · généré le 2026-10-08
+> **Version `1.8.29`** · branche `main` · généré le 2026-10-09
 > Seuil de tolérance **5%**
 
 <table>
 <tr>
 <td align="center"><strong>9</strong><br/><sub>corpus</sub></td>
-<td align="center"><strong>89 989</strong><br/><sub>DPE analysés</sub></td>
-<td align="center"><strong>60 907</strong><br/><sub>DPE conformes</sub></td>
-<td align="center"><strong>67,68 %</strong><br/><sub>réussite globale</sub></td>
+<td align="center"><strong>89 988</strong><br/><sub>DPE analysés</sub></td>
+<td align="center"><strong>60 937</strong><br/><sub>DPE conformes</sub></td>
+<td align="center"><strong>67,72 %</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,05 %** | `█████████░░░░░░░░░░░` | 4 605 / 10 000 |
-| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **92,53 %** | `███████████████████░` | 9 253 / 10 000 |
+| 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **46,04 %** | `█████████░░░░░░░░░░░` | 4 604 / 10 000 |
+| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **92,52 %** | `███████████████████░` | 9 252 / 10 000 |
 | 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **89,54 %** | `██████████████████░░` |  8 947 / 9 992 |
 | 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,60 %** | `██████████████████░░` | 8 860 / 10 000 |
-| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **76,90 %** | `███████████████░░░░░` |  7 688 / 9 998 |
+| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **76,99 %** | `███████████████░░░░░` |  7 697 / 9 998 |
 | 🟡  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **71,59 %** | `██████████████░░░░░░` | 7 159 / 10 000 |
 | 🟡  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **65,11 %** | `█████████████░░░░░░░` |  6 510 / 9 999 |
-| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **51,91 %** | `██████████░░░░░░░░░░` | 5 191 / 10 000 |
+| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **52,15 %** | `██████████░░░░░░░░░░` |  5 214 / 9 999 |
 | 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **26,94 %** | `█████░░░░░░░░░░░░░░░` | 2 694 / 10 000 |
 
 <sub>🟢 ≥ 85 % · 🟡 ≥ 60 % · 🔴 < 60 %</sub>
 
 #### Temps d’exécution
 
-> Durée de l’appel à `calcul_3cl` par DPE, sur 89 955 calculs.
+> Durée de l’appel à `calcul_3cl` par DPE, sur 89 953 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,59 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>4,92 ms</strong><br/><sub>médiane</sub></td>
-<td align="center"><strong>0,12 ms</strong><br/><sub>min</sub></td>
-<td align="center"><strong>654,9 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>9,94 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>7,15 ms</strong><br/><sub>médiane</sub></td>
+<td align="center"><strong>0,19 ms</strong><br/><sub>min</sub></td>
+<td align="center"><strong>66,85 s</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 5,40 ms | 4,68 ms | 0,21 ms |  38,2 ms | 11,3 ms | 17,6 ms |
-| **Appartement · chauffage individuel (2025)**  | 4,35 ms | 4,09 ms | 1,33 ms |  32,0 ms | 7,37 ms | 9,75 ms |
-| **Logement individuel (2025)**                 | 5,10 ms | 4,57 ms | 1,63 ms |  30,7 ms | 9,40 ms | 12,8 ms |
-| **Maison individuelle (2025)**                 | 6,42 ms | 5,86 ms | 1,83 ms |  53,6 ms | 11,4 ms | 15,0 ms |
-| **Immeuble · chauffage individuel**            | 6,99 ms | 5,99 ms | 0,12 ms | 117,3 ms | 14,2 ms | 22,7 ms |
-| **Appartement · chauffage collectif (2025)**   | 4,42 ms | 4,10 ms | 1,48 ms |  35,7 ms | 7,13 ms | 9,90 ms |
-| **Immeuble · chauffage collectif**             | 5,62 ms | 4,85 ms | 0,13 ms | 141,8 ms | 10,3 ms | 18,5 ms |
-| **Immeuble · chauffage mixte**                 | 5,70 ms | 4,65 ms | 0,21 ms | 654,9 ms | 11,9 ms | 19,5 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 6,29 ms | 5,46 ms | 1,67 ms |  52,7 ms | 12,1 ms | 18,9 ms |
+| **Généraliste**                                | 6,79 ms | 5,99 ms | 0,39 ms |  52,1 ms | 13,0 ms | 19,5 ms |
+| **Appartement · chauffage individuel (2025)**  | 8,93 ms | 7,17 ms | 1,94 ms | 180,6 ms | 18,4 ms | 31,1 ms |
+| **Logement individuel (2025)**                 | 5,69 ms | 5,16 ms | 1,61 ms |  35,6 ms | 10,4 ms | 13,9 ms |
+| **Maison individuelle (2025)**                 | 6,07 ms | 5,48 ms | 1,91 ms |  46,2 ms | 10,8 ms | 14,1 ms |
+| **Immeuble · chauffage individuel**            | 11,6 ms | 8,93 ms | 0,19 ms | 194,3 ms | 27,2 ms | 49,5 ms |
+| **Appartement · chauffage collectif (2025)**   | 9,01 ms | 7,02 ms | 1,88 ms | 173,7 ms | 18,6 ms | 30,2 ms |
+| **Immeuble · chauffage collectif**             | 14,3 ms | 11,0 ms | 0,20 ms | 218,6 ms | 30,1 ms | 63,7 ms |
+| **Immeuble · chauffage mixte**                 | 7,99 ms | 6,27 ms | 0,28 ms |   1,25 s | 18,0 ms | 32,0 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 19,1 ms | 7,29 ms | 1,74 ms |  66,85 s | 16,6 ms | 35,0 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
@@ -495,7 +495,7 @@ debug d'un écart de calcul — est dans **[CONTRIBUTING.fr.md](CONTRIBUTING.fr.
 
 ## 📄 Licence
 
-Distribué sous licence **GPL-3.0**. Voir le fichier [`LICENSE`](LICENSE) pour plus d'informations.
+Distribué sous licence **MIT**. Voir le fichier [`LICENSE`](LICENSE) pour plus d'informations.
 
 <p align="right">(<a href="#readme-top">Retour sommaire</a>)</p>
 
@@ -557,6 +557,6 @@ Merci à toutes les personnes qui ont écrit, testé, relu ou corrigé une ligne
 [issues-shield]: https://img.shields.io/github/issues/Open3CL/engine.svg?style=for-the-badge
 [issues-url]: https://github.com/Open3CL/issues
 [license-shield]: https://img.shields.io/github/license/Open3CL/engine.svg?style=for-the-badge
-[license-url]: https://github.com/Open3CL/blob/master/LICENSE
+[license-url]: https://github.com/Open3CL/engine/blob/main/LICENSE
 [product-screenshot]: images/screenshot.png
 [Javascript]: https://img.shields.io/badge/javascript-000000?style=for-the-badge&logo=javascript&logoColor=white

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.28';
+const LIB_VERSION = '1.8.30';
 
 const dpeSanitizerService = new DpeSanitizerService();
 

package/package.json

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