@open3cl/engine 1.8.31 → 1.8.33

package/15_conso_aux.js

@@ -212,6 +212,19 @@ export function conso_aux_distribution_ch(
  * @param Tbase {number} température
  */
 function getPuissanceCirculateur(em_ch, de, di, du, surfaceHabitable, GV, Tbase) {
+  /**
+   * Le circulateur dessert les émetteurs reliés au générateur (enum_lien_generateur_emetteur_id),
+   * et non ceux d'un autre générateur de l'installation (ex. convecteurs électriques d'appoint).
+   * Autotest CSTB IC5-0-3 : chaudière gaz sur plancher chauffant (lien 1) + convecteurs (lien 2),
+   * Tribu Caux_dist_ch = 1951,90 kWh (Fcot du plancher, 0,156).
+   */
+  const emetteursLies = em_ch.filter(
+    (em) =>
+      em.donnee_entree.enum_lien_generateur_emetteur_id === de.enum_lien_generateur_emetteur_id
+  );
+  if (emetteursLies.length > 0) {
+    em_ch = emetteursLies;
+  }
   const typeEmetteur = parseInt(em_ch[0].donnee_entree.enum_type_emission_distribution_id);
 
   // Perte de charge de l’émetteur

package/15_conso_aux.spec.js

@@ -291,6 +291,70 @@ describe('conso_aux_distribution_ch - auxiliaires de distribution', () => {
     expect(di.conso_auxiliaire_distribution_ch).toBeCloseTo(372.082418731648, 9);
   });
 
+  /**
+   * Seuls les émetteurs reliés au générateur (même enum_lien_generateur_emetteur_id) dimensionnent
+   * son circulateur. Autotest CSTB IC5-0-3 : chaudière (lien 1) sur plancher chauffant + convecteurs
+   * électriques d'appoint (lien 2) : Fcot du plancher (0,156), pas le forçage multi-émetteurs.
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
+   */
+  test('émetteurs reliés à un autre générateur : exclus du dimensionnement du circulateur', () => {
+    const plancher = {
+      donnee_entree: {
+        enum_type_emission_distribution_id: '6',
+        enum_temp_distribution_ch_id: '3',
+        enum_lien_generateur_emetteur_id: '1'
+      }
+    };
+    const convecteur = {
+      donnee_entree: {
+        enum_type_emission_distribution_id: '1',
+        enum_temp_distribution_ch_id: '3',
+        enum_lien_generateur_emetteur_id: '2'
+      }
+    };
+    const diMixte = {};
+    const diSeul = {};
+    const de = { enum_lien_generateur_emetteur_id: '1' };
+    conso_aux_distribution_ch([plancher, convecteur], de, diMixte, {}, 100, 1, 1, '0', 100000);
+    conso_aux_distribution_ch([plancher], de, diSeul, {}, 100, 1, 1, '0', 100000);
+    // identique au plancher seul (valeur de référence ci-dessus : 215,178 kWh)
+    expect(diMixte.conso_auxiliaire_distribution_ch).toBeCloseTo(215.1781621610199, 9);
+    expect(diMixte.conso_auxiliaire_distribution_ch).toBeCloseTo(
+      diSeul.conso_auxiliaire_distribution_ch,
+      10
+    );
+  });
+
+  test('aucun émetteur relié au générateur : tous les émetteurs sont conservés', () => {
+    const em = (lien) => ({
+      donnee_entree: {
+        enum_type_emission_distribution_id: '6',
+        enum_temp_distribution_ch_id: '3',
+        enum_lien_generateur_emetteur_id: lien
+      }
+    });
+    const diSansLien = {};
+    const diDeuxEmetteurs = {};
+    conso_aux_distribution_ch(
+      [em('2'), em('3')],
+      { enum_lien_generateur_emetteur_id: '1' },
+      diSansLien,
+      {},
+      100,
+      1,
+      1,
+      '0',
+      100000
+    );
+    conso_aux_distribution_ch([em('2'), em('3')], {}, diDeuxEmetteurs, {}, 100, 1, 1, '0', 100000);
+    // repli : 2 émetteurs => Fcot forcé à 0,802, comme sans lien renseigné
+    expect(diSansLien.conso_auxiliaire_distribution_ch).toBeCloseTo(
+      diDeuxEmetteurs.conso_auxiliaire_distribution_ch,
+      10
+    );
+    expect(diSansLien.conso_auxiliaire_distribution_ch).toBeGreaterThan(215.1781621610199);
+  });
+
   test('plusieurs émetteurs : Fcot forcé à 0,802 (cas le plus défavorable)', () => {
     // Deux émetteurs de type plancher chauffant : sans le forçage, Fcot=0,156.
     const em = [

package/16.2_production_enr.js

@@ -4,13 +4,19 @@ import tvs from './tv.js';
 import { DEFAULT_COEFF_EP } from './conso.js';
 
 export class ProductionENR {
+  /**
+   * Taux d'autoproduction limite par poste Taplpi (§16.2).
+   * Auxiliaires de distribution : 0,1 (valeur du moteur de référence CSTB, autotests MI5-0-2/21 :
+   * Celec_ac_aux_dist_ch / Celec_ac reproduit à 1e-15 avec 0,1 ; 9 fixtures ADEME PV sur 21 à ±0,1 %
+   * sur conso_elec_ac au lieu de 4 avec 0,05).
+   */
   #taplpi = {
     chauffage: 0.02,
     ecs: 0.05,
     refroidissement: 0.25,
     eclairage: 0.05,
     auxiliaire_ventilation: 0.5,
-    auxiliaire_distribution: 0.05,
+    auxiliaire_distribution: 0.1,
     autres: 0.45
   };
 

package/16.2_production_enr.spec.js

@@ -147,8 +147,8 @@ describe('production ENR unit tests', () => {
       conso_elec_ac_eclairage: 0.018,
       conso_elec_ac_ecs: 0.03,
       conso_elec_ac_fr: 0.08,
-      conso_elec_ac_auxiliaire_distribution_ch: 0.005,
-      conso_elec_ac_auxiliaire_distribution_ecs: 0.0022,
+      conso_elec_ac_auxiliaire_distribution_ch: 0.01,
+      conso_elec_ac_auxiliaire_distribution_ecs: 0.0044,
       conso_elec_ac_auxiliaire_generation_ch: 0.0008,
       conso_elec_ac_auxiliaire_generation_ecs: 0.0024,
       conso_elec_ac_ventilation: 0.03,
@@ -437,4 +437,40 @@ describe('production ENR unit tests', () => {
     expect(conso.ef_conso.conso_ecs).toBeLessThan(1000);
     expect(conso.ef_conso.conso_5_usages).toBeLessThan(1500);
   });
+
+  test('Taplpi des auxiliaires de distribution = 0,1 (chauffage et ECS)', () => {
+    const ret = productionENR.getTapl(
+      { conso_auxiliaire_distribution_ch: 100, conso_auxiliaire_distribution_ecs: 50 },
+      {},
+      0,
+      1000
+    );
+    expect(ret.conso_elec_ac_auxiliaire_distribution_ch).toBeCloseTo((0.1 * 100) / 1000, 12);
+    expect(ret.conso_elec_ac_auxiliaire_distribution_ecs).toBeCloseTo((0.1 * 50) / 1000, 12);
+  });
+
+  test('reproduit le Tapl et Celec_ac du moteur de référence CSTB (autotest MI5-0-2)', () => {
+    // MI5-0-2 (maison 136 m², chaudière gaz, PV 12 m²) : sorties Tribu Tap = 0,2911459118583647,
+    // Celec_ac = 1396,6145145780897, Celec_ac_aux_dist_ch = 9,334520076617249
+    const efConso = {
+      conso_eclairage: 258.06816,
+      conso_auxiliaire_ventilation: 438,
+      conso_auxiliaire_distribution_ch: 135.06,
+      conso_auxiliaire_generation_ch: 18.561508010921234,
+      conso_auxiliaire_generation_ecs: 3.2676571446810665
+    };
+    const ccom = productionENR.getCelecAu('maison', 136);
+    const celecTot = 438 + 258.06816 + 135.06 + 18.561508010921234 + 3.2676571446810665 + ccom;
+    const prod = productionENR.getTapl(efConso, {}, ccom, celecTot);
+    const tapl = Object.values(prod).reduce((acc, v) => acc + v, 0);
+    const ppv = 4521.818630399999;
+    const tap = 1 / (celecTot / ppv + 1 / tapl);
+
+    expect(tap).toBeCloseTo(0.2911459118583647, 12);
+    expect(celecTot * tap).toBeCloseTo(1396.6145145780897, 9);
+    expect((celecTot * tap * prod.conso_elec_ac_auxiliaire_distribution_ch) / tapl).toBeCloseTo(
+      9.334520076617249,
+      9
+    );
+  });
 });

package/9_chauffage.js

@@ -157,7 +157,7 @@ export default function calc_chauffage(
     /* c8 ignore next 2 -- repli défensif inatteignable : donnee_utilisateur est toujours renseignée
        par la première boucle sur gen_ch ci-dessus */
     (gen.donnee_utilisateur = gen.donnee_utilisateur || {}).nbGenerateurCascade =
-      Number.parseInt(de.enum_cfg_installation_ch_id) === 1 ? 1 : gen_ch.length;
+      reseauCirculateurUnique(de.enum_cfg_installation_ch_id) ? 1 : gen_ch.length;
 
     calc_generateur_ch(
       dpe,
@@ -230,6 +230,21 @@ export function generateursPrincipauxCascade(gen_ch) {
  * Cas particulier des PAC hybrides avec répartition forfaitaire du besoin
  * @type {number|number}
  */
+/**
+ * 15.2.1 Le circulateur est dimensionné pour tout le besoin du réseau (ratio du besoin couvert = 1)
+ * lorsque les générateurs alimentent le même réseau hydraulique : installation simple (cfg 1),
+ * relève d'une chaudière bois (cfg 6), chaudière en relève de PAC (cfg 8), base + appoint
+ * collectif (cfg 10). Le circulateur unique n'est pas divisé par le nombre de générateurs.
+ * Autotests CSTB IC4-0-1 (cfg 6, Tribu Caux_dist_ch = 8908,24 kWh), IC5-0-1 (cfg 8, 1777,76 kWh),
+ * IC5-0-3 (cfg 10, 1951,90 kWh).
+ * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
+ * @param cfgInstallationId {string|number} enum_cfg_installation_ch_id
+ * @return {boolean}
+ */
+export function reseauCirculateurUnique(cfgInstallationId) {
+  return [1, 6, 8, 10].includes(Number.parseInt(cfgInstallationId));
+}
+
 function getProrataGenerateur(
   genCh,
   nbCascadeAndCombustion,

package/9_chauffage.spec.js

@@ -60,7 +60,8 @@ const {
   tauxChargeForGenerator,
   isImmeuble,
   generateursPrincipauxCascade,
-  ratioDimensionnement
+  ratioDimensionnement,
+  reseauCirculateurUnique
 } = await import('./9_chauffage.js');
 const { requestInput, tv, tvColumnIDs } = await import('./utils.js');
 const { calc_emetteur_ch } = await import('./9_emetteur_ch.js');
@@ -421,6 +422,35 @@ describe('calc_chauffage - nombre de générateurs pris en compte pour le circul
   });
 });
 
+/**
+ * 15.2.1 Réseau à circulateur unique : relève d'une chaudière bois (cfg 6), chaudière en relève de
+ * PAC (cfg 8) et base + appoint collectif (cfg 10) partagent le réseau ; le circulateur est
+ * dimensionné pour tout le besoin, comme en installation simple (cfg 1).
+ * Autotests CSTB IC4-0-1 (cfg 6), IC5-0-1 (cfg 8), IC5-0-3 (cfg 10).
+ * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
+ */
+describe('reseauCirculateurUnique', () => {
+  test.each(['1', '6', '8', '10', 6, 8])('configuration %s : circulateur unique', (cfg) => {
+    expect(reseauCirculateurUnique(cfg)).toBe(true);
+  });
+
+  test.each(['2', '3', '4', '5', '7', '9', '11', undefined])(
+    'configuration %s : besoin réparti entre générateurs',
+    (cfg) => {
+      expect(reseauCirculateurUnique(cfg)).toBe(false);
+    }
+  );
+
+  test('chaudière en relève de PAC (cfg 8) avec 2 générateurs : pas de division du besoin', () => {
+    const gen1 = generateur();
+    const gen2 = generateur();
+    const ch = installation([gen1, gen2], [emetteur('1')], { enum_cfg_installation_ch_id: '8' });
+    appel(ch);
+    expect(gen1.donnee_utilisateur.nbGenerateurCascade).toBe(1);
+    expect(gen2.donnee_utilisateur.nbGenerateurCascade).toBe(1);
+  });
+});
+
 describe('calc_chauffage - prorata entre générateurs', () => {
   test('configuration ≠ 1 : prorata neutre (1 / (0 || 1))', () => {
     const ch = installation([generateur()], [emetteur('1')], {

package/README.md

@@ -370,29 +370,29 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.8.29`** · branche `main` · généré le 2026-10-09
+> **Version `1.8.32`** · 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 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>
+<td align="center"><strong>89 987</strong><br/><sub>DPE analysés</sub></td>
+<td align="center"><strong>60 962</strong><br/><sub>DPE conformes</sub></td>
+<td align="center"><strong>67,75 %</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,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 |
+| 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **46,14 %** | `█████████░░░░░░░░░░░` | 4 614 / 10 000 |
+| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **92,53 %** | `███████████████████░` | 9 253 / 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,99 %** | `███████████████░░░░░` |  7 697 / 9 998 |
+| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,60 %** | `██████████████████░░` |  8 859 / 9 999 |
+| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **77,02 %** | `███████████████░░░░░` |  7 700 / 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>                                        | **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 |
+| 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **27,06 %** | `█████░░░░░░░░░░░░░░░` | 2 706 / 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>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>
+<td align="center"><strong>5,04 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>4,40 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>540,9 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **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 |
+| **Généraliste**                                | 4,72 ms | 4,29 ms | 0,22 ms |  39,9 ms | 8,47 ms | 12,0 ms |
+| **Appartement · chauffage individuel (2025)**  | 3,77 ms | 3,41 ms | 1,43 ms |  30,2 ms | 6,59 ms | 8,63 ms |
+| **Logement individuel (2025)**                 | 4,70 ms | 4,16 ms | 1,67 ms |  35,0 ms | 8,73 ms | 11,8 ms |
+| **Maison individuelle (2025)**                 | 5,69 ms | 5,09 ms | 1,67 ms |  53,0 ms | 10,4 ms | 13,8 ms |
+| **Immeuble · chauffage individuel**            | 6,13 ms | 5,22 ms | 0,12 ms |  77,1 ms | 12,3 ms | 19,5 ms |
+| **Appartement · chauffage collectif (2025)**   | 4,20 ms | 3,77 ms | 1,44 ms |  24,5 ms | 6,96 ms | 9,09 ms |
+| **Immeuble · chauffage collectif**             | 5,33 ms | 4,49 ms | 0,12 ms |  99,2 ms | 9,91 ms | 18,2 ms |
+| **Immeuble · chauffage mixte**                 | 5,06 ms | 4,14 ms | 0,20 ms | 540,9 ms | 10,6 ms | 16,8 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 5,77 ms | 5,02 ms | 1,64 ms |  45,3 ms | 10,9 ms | 16,5 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.31';
+const LIB_VERSION = '1.8.33';
 
 const dpeSanitizerService = new DpeSanitizerService();
 

package/package.json

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