@open3cl/engine 1.4.5 → 1.5.0

package/16.2_production_enr.js

@@ -1,7 +1,7 @@
 import enums from './enums.js';
 import { mois_liste, tv } from './utils.js';
 import tvs from './tv.js';
-import { COEFF_EP_1_9, COEFF_EP_2_3 } from './conso.js';
+import { DEFAULT_COEFF_EP } from './conso.js';
 
 export class ProductionENR {
   #taplpi = {
@@ -18,9 +18,13 @@ export class ProductionENR {
    * Calcul des consommations d'électricité auto-consommée par enveloppe
    * Mise à jour des conso ef en prenant en compte ces auto-consommations
    * @param productionElecEnr
-   * @param Sh {string}
+   * @param conso
+   * @param Sh {number}
+   * @param th {string}
+   * @param zc_id {string}
+   * @param coeff_ep_override {number?}
    */
-  calculateEnr(productionElecEnr, conso, Sh, th, zc_id, use_coeff_ch_elec_2_3) {
+  calculateEnr(productionElecEnr, conso, Sh, th, zc_id, coeff_ep_override) {
     const productionElectricite = {
       conso_elec_ac: 0,
       production_pv: 0,
@@ -45,7 +49,7 @@ export class ProductionENR {
       this.updateEfConso(productionElectricite, conso, Sh);
 
       // Mise à jour des consommations d'énergie primaire en minorant l'énergie consommée par l'énergie autoconsommée par le poste
-      this.updateEPConso(productionElectricite, conso, Sh, use_coeff_ch_elec_2_3);
+      this.updateEPConso(productionElectricite, conso, Sh, coeff_ep_override);
     }
 
     return {
@@ -181,17 +185,17 @@ export class ProductionENR {
    * @param productionElectricite
    * @param conso {{ep_conso: Ep_conso}}
    * @param Sh {number}
-   * @param use_coeff_ch_elec_2_3 {boolean} "true" pour ne pas utiliser le dernier coeff de chauffage électrique
+   * @param coeff_ep_override {number?} coeff ep à surcharger si définit
    */
-  updateEPConso(productionElectricite, conso, Sh, use_coeff_ch_elec_2_3) {
-    if (use_coeff_ch_elec_2_3) {
-      conso.ep_conso.ep_conso_ecs -= COEFF_EP_2_3 * productionElectricite.conso_elec_ac_ecs;
-      conso.ep_conso.ep_conso_ch -= COEFF_EP_2_3 * productionElectricite.conso_elec_ac_ch;
-      conso.ep_conso.ep_conso_fr -= COEFF_EP_2_3 * productionElectricite.conso_elec_ac_fr;
+  updateEPConso(productionElectricite, conso, Sh, coeff_ep_override) {
+    if (coeff_ep_override) {
+      conso.ep_conso.ep_conso_ecs -= coeff_ep_override * productionElectricite.conso_elec_ac_ecs;
+      conso.ep_conso.ep_conso_ch -= coeff_ep_override * productionElectricite.conso_elec_ac_ch;
+      conso.ep_conso.ep_conso_fr -= coeff_ep_override * productionElectricite.conso_elec_ac_fr;
       conso.ep_conso.ep_conso_eclairage -=
-        COEFF_EP_2_3 * productionElectricite.conso_elec_ac_eclairage;
+        coeff_ep_override * productionElectricite.conso_elec_ac_eclairage;
       conso.ep_conso.ep_conso_totale_auxiliaire -=
-        COEFF_EP_2_3 * productionElectricite.conso_elec_ac_auxiliaire;
+        coeff_ep_override * productionElectricite.conso_elec_ac_auxiliaire;
 
       const conso_elec =
         productionElectricite.conso_elec_ac_ecs +
@@ -200,17 +204,17 @@ export class ProductionENR {
         productionElectricite.conso_elec_ac_eclairage +
         productionElectricite.conso_elec_ac_auxiliaire;
 
-      conso.ep_conso.ep_conso_5_usages -= COEFF_EP_2_3 * conso_elec;
+      conso.ep_conso.ep_conso_5_usages -= coeff_ep_override * conso_elec;
 
       conso.ep_conso.ep_conso_5_usages_m2 = Math.floor(conso.ep_conso.ep_conso_5_usages / Sh);
     } else {
-      conso.ep_conso.ep_conso_ecs -= COEFF_EP_1_9 * productionElectricite.conso_elec_ac_ecs;
-      conso.ep_conso.ep_conso_ch -= COEFF_EP_1_9 * productionElectricite.conso_elec_ac_ch;
-      conso.ep_conso.ep_conso_fr -= COEFF_EP_1_9 * productionElectricite.conso_elec_ac_fr;
+      conso.ep_conso.ep_conso_ecs -= DEFAULT_COEFF_EP * productionElectricite.conso_elec_ac_ecs;
+      conso.ep_conso.ep_conso_ch -= DEFAULT_COEFF_EP * productionElectricite.conso_elec_ac_ch;
+      conso.ep_conso.ep_conso_fr -= DEFAULT_COEFF_EP * productionElectricite.conso_elec_ac_fr;
       conso.ep_conso.ep_conso_eclairage -=
-        COEFF_EP_1_9 * productionElectricite.conso_elec_ac_eclairage;
+        DEFAULT_COEFF_EP * productionElectricite.conso_elec_ac_eclairage;
       conso.ep_conso.ep_conso_totale_auxiliaire -=
-        COEFF_EP_1_9 * productionElectricite.conso_elec_ac_auxiliaire;
+        DEFAULT_COEFF_EP * productionElectricite.conso_elec_ac_auxiliaire;
 
       const conso_elec =
         productionElectricite.conso_elec_ac_ecs +
@@ -219,7 +223,7 @@ export class ProductionENR {
         productionElectricite.conso_elec_ac_eclairage +
         productionElectricite.conso_elec_ac_auxiliaire;
 
-      conso.ep_conso.ep_conso_5_usages -= COEFF_EP_1_9 * conso_elec;
+      conso.ep_conso.ep_conso_5_usages -= DEFAULT_COEFF_EP * conso_elec;
 
       conso.ep_conso.ep_conso_5_usages_m2 = Math.floor(conso.ep_conso.ep_conso_5_usages / Sh);
     }

package/README.md

@@ -83,7 +83,12 @@ C'est un bon moyen de détecter un éventuel problème dans le dpe ou la librair
 ## Utilisation
 
 ```javascript
-import { calcul_3cl } from 'open3cl';
+import { @open3cl } from 'open3cl/engine';
+import {
+  set_bug_for_bug_compat,
+} from '@open3cl/engine/utils.js';
+
+set_bug_for_bug_compat();
 
 // Exemple d'objet JSON (partiel) issu d'un fichier XML DPE
 const dpeData = {
@@ -316,20 +321,29 @@ Résultats des tests de corpus avec le mode de compatibilité activé.
 | 1.4.3                | dpe_immeuble_chauffage_collectif.csv                     | 6149                           | 61%                     |                                                   |
 | 1.4.3                | dpe_immeuble_chauffage_mixte.csv                         | 4805                           | 48%                     |                                                   |
 | 1.4.3                | dpe_individuel_a_partir_dpe_immeuble_2026.csv            | 2755                           | 27%                     |                                                   |
+| <ins>**1.4.4**<ins>  | <ins>**corpus_dpe.csv**<ins>                             | <ins>**4560 (+4)**<ins>        | <ins>**45%**<ins>       |                                                   |
+| 1.4.4                | dpe_logement_individuel_2025.csv                         | 8719 (+3)                      | 87% (+2%)               |                                                   |
+| 1.4.4                | dpe_maison_individuelle_2025.csv                         | 8715                           | 87%                     |                                                   |
+| 1.4.4                | dpe_appartement_individuel_chauffage_individuel_2025.csv | 9070                           | 91%                     |                                                   |
+| 1.4.4                | dpe_appartement_individuel_chauffage_collectif_2025.csv  | 6803 (-1)                      | 68%                     |                                                   |
+| 1.4.4                | dpe_immeuble_chauffage_individuel.csv                    | 7320                           | 73%                     |                                                   |
+| 1.4.4                | dpe_immeuble_chauffage_collectif.csv                     | 6149                           | 61%                     |                                                   |
+| 1.4.4                | dpe_immeuble_chauffage_mixte.csv                         | 4805                           | 48%                     |                                                   |
+| 1.4.4                | dpe_individuel_a_partir_dpe_immeuble_2026.csv            | 2755                           | 27%                     |                                                   |
 
 </details>
 
-| Version librairie   | corpus                                                   | Nb en dessous du taux d'erreur | Taux de réussite  | Description |
-| :------------------ | -------------------------------------------------------- | ------------------------------ | ----------------- | ----------- |
-| <ins>**1.4.4**<ins> | <ins>**corpus_dpe.csv**<ins>                             | <ins>**4560 (+4)**<ins>        | <ins>**45%**<ins> |             |
-| 1.4.4               | dpe_logement_individuel_2025.csv                         | 8719 (+3)                      | 87% (+2%)         |             |
-| 1.4.4               | dpe_maison_individuelle_2025.csv                         | 8715                           | 87%               |             |
-| 1.4.4               | dpe_appartement_individuel_chauffage_individuel_2025.csv | 9070                           | 91%               |             |
-| 1.4.4               | dpe_appartement_individuel_chauffage_collectif_2025.csv  | 6803 (-1)                      | 68%               |             |
-| 1.4.4               | dpe_immeuble_chauffage_individuel.csv                    | 7320                           | 73%               |             |
-| 1.4.4               | dpe_immeuble_chauffage_collectif.csv                     | 6149                           | 61%               |             |
-| 1.4.4               | dpe_immeuble_chauffage_mixte.csv                         | 4805                           | 48%               |             |
-| 1.4.4               | dpe_individuel_a_partir_dpe_immeuble_2026.csv            | 2755                           | 27%               |             |
+| Version librairie   | corpus                                                   | Nb en dessous du taux d'erreur | Taux de réussite        | Description |
+| :------------------ | -------------------------------------------------------- | ------------------------------ | ----------------------- | ----------- |
+| <ins>**1.4.5**<ins> | <ins>**corpus_dpe.csv**<ins>                             | <ins>**4582 (+22)**<ins>       | <ins>**46% (+1%)**<ins> |             |
+| 1.4.5               | dpe_logement_individuel_2025.csv                         | 8790 (+71)                     | 88% (+1%)               |             |
+| 1.4.5               | dpe_maison_individuelle_2025.csv                         | 8791 (+76)                     | 88% (+1%)               |             |
+| 1.4.5               | dpe_appartement_individuel_chauffage_individuel_2025.csv | 9143 (+73)                     | 91%                     |             |
+| 1.4.5               | dpe_appartement_individuel_chauffage_collectif_2025.csv  | 6836 (+33)                     | 68%                     |             |
+| 1.4.5               | dpe_immeuble_chauffage_individuel.csv                    | 7371 (+51)                     | 74% (+1%)               |             |
+| 1.4.5               | dpe_immeuble_chauffage_collectif.csv                     | 6155 (+6)                      | 61%                     |             |
+| 1.4.5               | dpe_immeuble_chauffage_mixte.csv                         | 4816 (+11S)                    | 48%                     |             |
+| 1.4.5               | dpe_individuel_a_partir_dpe_immeuble_2026.csv            | 2755                           | 27%                     |             |
 
 ## Roadmap
 

package/conso.js

@@ -5,6 +5,8 @@ import { tv } from './utils.js';
 
 export const COEFF_EP_2_3 = 2.3;
 export const COEFF_EP_1_9 = 1.9;
+export const COEFF_EP_1_7 = 1.7;
+export const DEFAULT_COEFF_EP = COEFF_EP_1_9;
 
 /**
  * Coeff de chauffage 1.9 au 01/01/2026
@@ -29,6 +31,17 @@ export const coef_ep_2_3 = {
   'électricité auxiliaire': COEFF_EP_2_3
 };
 
+/**
+ * Coeff de chauffage 1.7 au 01/01/2027
+ */
+export const coef_ep_1_7 = {
+  'électricité ch': COEFF_EP_1_7,
+  'électricité ecs': COEFF_EP_1_7,
+  'électricité fr': COEFF_EP_1_7,
+  'électricité éclairage': COEFF_EP_1_7,
+  'électricité auxiliaire': COEFF_EP_1_7
+};
+
 /**
  * Au 31 mars 2021
  * @link {https://www.legifrance.gouv.fr/download/pdf?id=doxMrRr0wbfJVvtWjfDP4gHzzERt1iX0PtobthCE6A0=}

package/dpe-sanitizer.service.js

@@ -1,28 +1,39 @@
 import { ObjectUtil } from './core/util/infrastructure/object-util.js';
+import { set, has } from 'lodash-es';
 
 const nodesToMap = [
-  'mur',
-  'plancher_bas',
-  'plancher_haut',
-  'baie_vitree',
-  'porte',
-  'pont_thermique',
-  'ventilation',
   'installation_ecs',
   'generateur_ecs',
-  'climatisation',
   'installation_chauffage',
   'generateur_chauffage',
   'emetteur_chauffage',
   'sortie_par_energie'
 ];
 
+const nodesCollectionToCheck = [
+  'logement.enveloppe.mur_collection.mur',
+  'logement.enveloppe.plancher_bas_collection.plancher_bas',
+  'logement.enveloppe.plancher_haut_collection.plancher_haut',
+  'logement.ventilation_collection.ventilation',
+  'logement.climatisation_collection.climatisation',
+  'logement.enveloppe.baie_vitree_collection.baie_vitree',
+  'logement.enveloppe.porte_collection.porte',
+  'logement.enveloppe.pont_thermique_collection.pont_thermique'
+];
+
 /**
  * Transform single nodes in {@link nodesToMap} into array of nodes.
  * Transform string number into digits
  * These transformations should be done inside the open3cl library
  *
  * @example
+ *
+ * // Will create
+ * "plancher_haut_collection": {
+ *         "plancher_haut": []
+ * }
+ * if the plancher_haut_collection.plancher_haut nodes does not exist or are not an array
+ *
  * // Will transform
  * "plancher_haut_collection": {
  *         "plancher_haut": {"id": 1}
@@ -44,6 +55,12 @@ export default class DpeSanitizerService {
    * @return {FullDpe}
    */
   execute(dpe) {
+    for (const path of nodesCollectionToCheck) {
+      if (!has(dpe, path)) {
+        set(dpe, path, []);
+      }
+    }
+
     return ObjectUtil.deepObjectTransform(
       dpe,
       (key) => key,

package/engine.js

@@ -11,7 +11,10 @@ import calc_conso, {
   classe_bilan_dpe,
   classe_emission_ges,
   coef_ep,
-  coef_ep_2_3
+  coef_ep_1_7,
+  coef_ep_2_3,
+  COEFF_EP_1_7,
+  COEFF_EP_2_3
 } from './conso.js';
 import {
   add_references,
@@ -28,7 +31,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.4.5';
+const LIB_VERSION = '1.5.0';
 
 const dpeSanitizerService = new DpeSanitizerService();
 
@@ -559,8 +562,30 @@ export function calcul_3cl(inputDpe, options) {
     conso,
     Sh,
     th,
+    zc_id
+  );
+
+  const conso1_7 = calc_conso(
+    Sh,
     zc_id,
-    false
+    ca_id,
+    vt_list,
+    instal_ch,
+    ecs,
+    clim,
+    prorataECS,
+    prorataChauffage,
+    dateDpe,
+    coef_ep_1_7
+  );
+
+  productionENR.calculateEnr(
+    dpe.logement.production_elec_enr,
+    conso1_7,
+    Sh,
+    th,
+    zc_id,
+    COEFF_EP_1_7
   );
 
   const conso2_3 = calc_conso(
@@ -577,7 +602,14 @@ export function calcul_3cl(inputDpe, options) {
     coef_ep_2_3
   );
 
-  productionENR.calculateEnr(dpe.logement.production_elec_enr, conso2_3, Sh, th, zc_id, true);
+  productionENR.calculateEnr(
+    dpe.logement.production_elec_enr,
+    conso2_3,
+    Sh,
+    th,
+    zc_id,
+    COEFF_EP_2_3
+  );
 
   // get all baie_vitree orientations
   const ph_list = env.plancher_haut_collection.plancher_haut || [];
@@ -594,12 +626,15 @@ export function calcul_3cl(inputDpe, options) {
     ...logement.sortie.ep_conso,
     coeff_2_3_classe_bilan_dpe: conso2_3.ep_conso.classe_bilan_dpe,
     coeff_2_3_ep_conso_5_usages: conso2_3.ep_conso.ep_conso_5_usages,
-    coeff_2_3_ep_conso_5_usages_m2: conso2_3.ep_conso.ep_conso_5_usages_m2
+    coeff_2_3_ep_conso_5_usages_m2: conso2_3.ep_conso.ep_conso_5_usages_m2,
+    coeff_1_7_classe_bilan_dpe: conso1_7.ep_conso.classe_bilan_dpe,
+    coeff_1_7_ep_conso_5_usages: conso1_7.ep_conso.ep_conso_5_usages,
+    coeff_1_7_ep_conso_5_usages_m2: conso1_7.ep_conso.ep_conso_5_usages_m2
   };
 
-  logement.sortie.ep_conso.classe_bilan_dpe_2026 = logement.sortie.ep_conso.classe_bilan_dpe;
-  logement.sortie.ep_conso.ep_conso_5_usages_2026 = logement.sortie.ep_conso.ep_conso_5_usages;
-  logement.sortie.ep_conso.ep_conso_5_usages_2026_m2 =
+  logement.sortie.ep_conso.classe_bilan_dpe_2027 = logement.sortie.ep_conso.classe_bilan_dpe;
+  logement.sortie.ep_conso.ep_conso_5_usages_2027 = logement.sortie.ep_conso.ep_conso_5_usages;
+  logement.sortie.ep_conso.ep_conso_5_usages_2027_m2 =
     logement.sortie.ep_conso.ep_conso_5_usages_m2;
 
   return dpe;
@@ -633,20 +668,31 @@ export function get_classe_ges_dpe(dpe) {
 
 /**
  * Calcul de la nouvelle conso suite à la modification du coefficient pour le chauffage électrique
- * Applicable uniquement à partir de janvier 2026
+ * Applicable uniquement à partir de janvier 2027
+ *
+ * {@link https://www.legifrance.gouv.fr/jorf/id/JORFTEXT000054747079}
  *
- * {@link https://www.ecologie.gouv.fr/actualites/evolutions-du-calcul-du-dpe-reponses-vos-questions#:~:text=Les%20DPE%20r%C3%A9alis%C3%A9s%20avant%20le,%2DAudit%20de%20l'Ademe.}
+ * @param dpe {FullDpe}
+ * @returns {{ep_conso_5_usages: number; ep_conso_5_usages_m2: number; classe_bilan_dpe: string}}
+ */
+export function get_conso_coeff_1_7_2027(dpe) {
+  return get_conso_with_coeff(dpe, 0.7 / 0.9);
+}
+
+/**
+ * Calcul de la nouvelle conso suite à la modification du coefficient pour le chauffage électrique
  *
  * @param dpe {FullDpe}
+ * @param coeff {number}
  * @returns {{ep_conso_5_usages: number; ep_conso_5_usages_m2: number; classe_bilan_dpe: string}}
  */
-export function get_conso_coeff_1_9_2026(dpe) {
+function get_conso_with_coeff(dpe, coeff) {
   const zc_id = dpe.logement.meteo.enum_zone_climatique_id;
   const ca_id = dpe.logement.meteo.enum_classe_altitude_id;
   const th = calc_th(dpe.logement.caracteristique_generale.enum_methode_application_dpe_log_id);
 
   const ep_conso_5_usages =
-    (0.9 / 1.3) *
+    coeff *
       (Number(dpe.logement.sortie.ep_conso.ep_conso_5_usages) -
         Number(dpe.logement.sortie.ef_conso.conso_5_usages)) +
     Number(dpe.logement.sortie.ef_conso.conso_5_usages);

package/index.js

@@ -3,8 +3,16 @@ import {
   calcul_3cl_xml,
   get_classe_ges_dpe,
   get_conso_coeff_1_9_2026,
+  get_conso_coeff_1_7_2027,
   getVersion
 } from './engine.js';
-export { calcul_3cl, calcul_3cl_xml, get_classe_ges_dpe, get_conso_coeff_1_9_2026, getVersion };
+export {
+  calcul_3cl,
+  calcul_3cl_xml,
+  get_classe_ges_dpe,
+  get_conso_coeff_1_9_2026,
+  get_conso_coeff_1_7_2027,
+  getVersion
+};
 import { Umur, Uph, Upb, Uporte, Ubv, Upt } from './3_deperdition.js';
 export { Umur, Uph, Upb, Uporte, Ubv, Upt };

package/package.json

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