@hestia-earth/engine-models 0.82.1 → 0.82.2

package/cjs/version.d.ts

@@ -1 +1 @@
-export declare const ENGINE_VERSION = "0.82.1";
+export declare const ENGINE_VERSION = "0.82.2";

package/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ENGINE_VERSION = void 0;
-exports.ENGINE_VERSION = '0.82.1';
+exports.ENGINE_VERSION = '0.82.2';

package/esm/version.d.ts

@@ -1 +1 @@
-export declare const ENGINE_VERSION = "0.82.1";
+export declare const ENGINE_VERSION = "0.82.2";

package/esm/version.js

@@ -1 +1 @@
-export const ENGINE_VERSION = '0.82.1';
+export const ENGINE_VERSION = '0.82.2';

package/formulas/README.md

@@ -177,6 +177,12 @@ Where:
 - Tag a **named** constant with `` `[const:<value>]` `` (e.g. `ER` → `` `[const:2]` ``):
   it substitutes to the literal value (rather than rendering as-is) without being
   logged, and is excluded from coverage.
+- Tag a **documentation-only** symbol with `` `[display]` `` when it genuinely
+  can't be substituted and is *not* a constant — e.g. a per-event Monte-Carlo term
+  that never reduces to a single logged value. It renders symbolically and is
+  excluded from coverage. **Do not** use `` `[const]` `` for a real variable to
+  reach coverage: `validate-formula-bindings.js` errors on an empty `` `[const]` ``
+  whose symbol isn't a numeric literal.
 
 For a `\sum` over inputs, bind each summand symbol to a **table column** with
 `` `[<table key>:<column>]` `` — the log key of the packed `log_as_table` value

package/formulas/index.json

@@ -1882,8 +1882,7 @@
         {
           "symbol": "\\Delta C",
           "description": "the change in carbon stock over year $y$, i.e. $C_y - C_{y-1}$, the difference between the carbon stocks at the end of years $y$ and $y-1$ (kg C ha<sup>-1</sup>).",
-          "key": "carbon_stock_inventory",
-          "column": "carbon-stock-change"
+          "key": "carbon_stock_change"
         },
         {
           "symbol": "\\frac{44.01}{12.012}",
@@ -1905,8 +1904,7 @@
         {
           "symbol": "\\Delta C",
           "description": "the change in carbon stock over year $y$, i.e. $C_y - C_{y-1}$, the difference between the carbon stocks at the end of years $y$ and $y-1$ (kg C ha<sup>-1</sup>).",
-          "key": "carbon_stock_inventory",
-          "column": "carbon-stock-change"
+          "key": "carbon_stock_change"
         },
         {
           "symbol": "\\frac{44.01}{12.012}",
@@ -1928,8 +1926,7 @@
         {
           "symbol": "\\Delta C",
           "description": "the change in carbon stock over year $y$, i.e. $C_y - C_{y-1}$, the difference between the carbon stocks at the end of years $y$ and $y-1$ (kg C ha<sup>-1</sup>).",
-          "key": "carbon_stock_inventory",
-          "column": "carbon-stock-change"
+          "key": "carbon_stock_change"
         },
         {
           "symbol": "\\frac{44.01}{12.012}",
@@ -1941,7 +1938,7 @@
   ],
   "hestia_earth/models/ipcc2019/co2ToAirLimeNeutralisation.md": [
     {
-      "formula": "CO_2 = \\sum_{i=1}^{n_{CaCO_3}} M_{CaCO_3,i} \\times EF_{CaCO_3} + \\sum_{j=1}^{n_{dolomite}} M_{dolomite,j} \\times EF_{dolomite}",
+      "formula": "CO_2 = (C_{CaCO_3} + C_{dolomite}) \\times \\frac{44.01}{12.012}",
       "bindings": [
         {
           "symbol": "CO_2",
@@ -1949,34 +1946,19 @@
           "key": "value"
         },
         {
-          "symbol": "n_{CaCO_3}",
-          "description": "number of limestone (CaCO<sub>3</sub>) inputs",
-          "key": "CaCO3_values"
+          "symbol": "C_{CaCO_3}",
+          "description": "total carbon from limestone (CaCO<sub>3</sub>) inputs (kg C), i.e. $\\sum_i M_{CaCO_3,i} \\times 0.12$",
+          "key": "CaCO3_carbon"
         },
         {
-          "symbol": "M_{CaCO_3,i}",
-          "description": "mass of each limestone input (kg)",
-          "constant": ""
-        },
-        {
-          "symbol": "EF_{CaCO_3}",
-          "description": "limestone emission factor (kg CO<sub>2</sub> per kg CaCO<sub>3</sub>)",
-          "constant": "0.44"
+          "symbol": "C_{dolomite}",
+          "description": "total carbon from dolomite (CaMg(CO<sub>3</sub>)<sub>2</sub>) inputs (kg C), i.e. $\\sum_j M_{dolomite,j} \\times 0.13$",
+          "key": "MgCO3_carbon"
         },
         {
-          "symbol": "n_{dolomite}",
-          "description": "number of dolomite (CaMg(CO<sub>3</sub>)<sub>2</sub>) inputs",
-          "key": "MgCO3_values"
-        },
-        {
-          "symbol": "M_{dolomite,j}",
-          "description": "mass of each dolomite input (kg)",
+          "symbol": "\\frac{44.01}{12.012}",
+          "description": "ratio of the atomic mass of CO<sub>2</sub> to C",
           "constant": ""
-        },
-        {
-          "symbol": "EF_{dolomite}",
-          "description": "dolomite emission factor (kg CO<sub>2</sub> per kg dolomite)",
-          "constant": "0.477"
         }
       ]
     }
@@ -2035,8 +2017,7 @@
         {
           "symbol": "\\Delta C",
           "description": "the change in carbon stock over year $y$, i.e. $C_y - C_{y-1}$, the difference between the carbon stocks at the end of years $y$ and $y-1$ (kg C ha<sup>-1</sup>).",
-          "key": "carbon_stock_inventory",
-          "column": "carbon-stock-change"
+          "key": "carbon_stock_change"
         },
         {
           "symbol": "\\frac{44.01}{12.012}",
@@ -2077,12 +2058,12 @@
         {
           "symbol": "M",
           "description": "mass of fuel biomass combusted during land conversion event (tonnes dry matter, >= 0)",
-          "constant": ""
+          "display": true
         },
         {
           "symbol": "A",
           "description": "area lost (ha)",
-          "constant": ""
+          "display": true
         },
         {
           "symbol": "B_{region}",
@@ -2092,13 +2073,12 @@
         {
           "symbol": "F_{fuel}",
           "description": "fuel factor, mass of fuel biomass per hectare for fuel category (tonnes dry matter ha<sup>-1</sup>)",
-          "constant": ""
+          "display": true
         },
         {
           "symbol": "F_{org}",
           "description": "organic soil factor, % area of the Site with organic soils (decimal percentage, 0 - 1)",
-          "key": "inventory",
-          "column": "percent-organic-soils"
+          "display": true
         }
       ]
     },
@@ -2113,12 +2093,12 @@
         {
           "symbol": "M",
           "description": "mass of fuel available for combustion (tonnes dry matter, >= 0)",
-          "constant": ""
+          "display": true
         },
         {
           "symbol": "G_{emission, fuel}",
           "description": "emission factor (g kg<sup>-1</sup> dry matter burnt)",
-          "constant": ""
+          "display": true
         }
       ]
     }
@@ -3000,12 +2980,12 @@
         {
           "symbol": "M",
           "description": "mass of fuel biomass combusted during land conversion event (tonnes dry matter, >= 0)",
-          "constant": ""
+          "display": true
         },
         {
           "symbol": "A",
           "description": "area lost (ha)",
-          "constant": ""
+          "display": true
         },
         {
           "symbol": "B_{region}",
@@ -3015,7 +2995,7 @@
         {
           "symbol": "F_{fuel}",
           "description": "fuel factor, mass of fuel biomass per hectare for fuel category (tonnes dry matter ha<sup>-1</sup>)",
-          "constant": ""
+          "display": true
         }
       ]
     },
@@ -3030,12 +3010,12 @@
         {
           "symbol": "M",
           "description": "mass of fuel available for combustion (tonnes dry matter, >= 0)",
-          "constant": ""
+          "display": true
         },
         {
           "symbol": "G_{emission, fuel}",
           "description": "emission factor (g kg<sup>-1</sup> dry matter burnt)",
-          "constant": ""
+          "display": true
         }
       ]
     }
@@ -3902,8 +3882,8 @@
         },
         {
           "symbol": "FF",
-          "description": "fate factor, fraction of the applied mass reaching air",
-          "constant": "0.09"
+          "description": "fate factor, fraction of the applied mass reaching air (from the `pefcr2017PesticideFateFactor` lookup, ~0.09)",
+          "key": "emission_factor"
         }
       ]
     }
@@ -3924,8 +3904,8 @@
         },
         {
           "symbol": "FF",
-          "description": "fate factor, fraction of the applied mass reaching agricultural soil",
-          "constant": "0.9"
+          "description": "fate factor, fraction of the applied mass reaching agricultural soil (from the `pefcr2017PesticideFateFactor` lookup, ~0.9)",
+          "key": "emission_factor"
         }
       ]
     }
@@ -3946,8 +3926,8 @@
         },
         {
           "symbol": "FF",
-          "description": "fate factor, fraction of the applied mass reaching water",
-          "constant": "0.01"
+          "description": "fate factor, fraction of the applied mass reaching water (from the `pefcr2017PesticideFateFactor` lookup, ~0.01)",
+          "key": "emission_factor"
         }
       ]
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hestia-earth/engine-models",
-  "version": "0.82.1",
+  "version": "0.82.2",
   "description": "HESTIA Engine Models",
   "main": "cjs/index.js",
   "module": "esm/index.js",