@open3cl/engine 1.8.2 → 1.8.3

package/9_besoin_ch.js

@@ -171,6 +171,13 @@ export default function calc_besoin_ch(
     besoin_ch_depensier += besoin_ch_mois_dep[mois] / 1000;
   }
 
+  /**
+   * Fraction des besoins de chauffage couverts par les apports gratuits sur l'année :
+   * moyenne des Fj mensuels pondérée par les déperditions mensuelles (GV × DHj).
+   * C'est une fraction sans unité comprise entre 0 et 1, elle n'est PAS arrondie à 1.
+   * Certains logiciels publient 1 dans le XML ADEME : ce n'est pas une valeur calculée
+   * et elle ne doit pas servir de référence (cf. issue #51).
+   */
   fraction_apport_gratuit_ch /= sumDh19;
   fraction_apport_gratuit_depensier_ch /= sumDh21;
 

package/9_besoin_ch.spec.js

@@ -130,6 +130,27 @@ describe('calc_besoin_ch - agrégation mensuelle du besoin de chauffage', () =>
     expect(ret.fraction_apport_gratuit_depensier_ch).toBeCloseTo(0.05808492254600494, 9);
   });
 
+  /**
+   * La fraction des apports gratuits est une moyenne pondérée des Fj :
+   * elle reste dans [0, 1] et n'est jamais arrondie à 1 (cf. issue #51).
+   */
+  test("la fraction des apports gratuits n'est pas arrondie à 1 et reste dans [0, 1]", () => {
+    const ret = appelSansRecup();
+    const Fj = calc_Fj(100, 2000, 5000, 1000, 'moyenne');
+    const FjDep = calc_Fj(100, 2000, 5000, 1200, 'moyenne');
+
+    // sur un seul mois, la moyenne pondérée vaut exactement Fj
+    expect(ret.fraction_apport_gratuit_ch).toBeCloseTo(Fj, 12);
+    expect(ret.fraction_apport_gratuit_depensier_ch).toBeCloseTo(FjDep, 12);
+    for (const fraction of [
+      ret.fraction_apport_gratuit_ch,
+      ret.fraction_apport_gratuit_depensier_ch
+    ]) {
+      expect(fraction).toBeGreaterThan(0);
+      expect(fraction).toBeLessThan(1);
+    }
+  });
+
   test('sans récupération, toutes les pertes récupérées retournées sont nulles', () => {
     const ret = appelSansRecup();
     expect(ret.pertes_distribution_ecs_recup).toBe(0);

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

package/package.json

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