@hestia-earth/engine-models 0.82.1 → 0.83.0

package/cjs/version.d.ts

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

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.83.0';

package/config/ImpactAssessment.json

@@ -960,6 +960,30 @@
         },
         "stage": 1
       },
+      {
+        "key": "impacts",
+        "model": "environmentalFootprintV3-1",
+        "value": "humanToxicityPotentialCancerCtuh",
+        "runStrategy": "add_blank_node_if_missing",
+        "mergeStrategy": "list",
+        "mergeArgs": {
+          "replaceThreshold": ["value", 0.01],
+          "sameMethodModel": true
+        },
+        "stage": 1
+      },
+      {
+        "key": "impacts",
+        "model": "environmentalFootprintV3-1",
+        "value": "humanToxicityPotentialNonCancerCtuh",
+        "runStrategy": "add_blank_node_if_missing",
+        "mergeStrategy": "list",
+        "mergeArgs": {
+          "replaceThreshold": ["value", 0.01],
+          "sameMethodModel": true
+        },
+        "stage": 1
+      },
       {
         "key": "impacts",
         "model": "usetoxV2-1",

package/esm/version.d.ts

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

package/esm/version.js

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

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

@@ -311,27 +311,22 @@
   ],
   "hestia_earth/models/deRuijterEtAl2010/nh3ToAirCropResidueDecomposition.md": [
     {
-      "formula": "NH_3 = a \\times N_{AG} \\times \\frac{17}{14}",
+      "formula": "a = \\left(0.38 \\times 1000 \\times \\frac{NC}{100} - 5.44\\right) / 100",
       "bindings": [
-        {
-          "symbol": "NH_3",
-          "description": "is the ammonia emission from crop residue decomposition, in kg NH<sub>3</sub>.",
-          "key": "value"
-        },
         {
           "symbol": "a",
           "description": "is the volatilisation coefficient, bounded $0 \\le a < 17\\%$ (the bounds of observations in the study).",
           "key": "A"
         },
         {
-          "symbol": "N_{AG}",
-          "description": "is the nitrogen in above ground crop residue left on field or incorporated, in kg.",
-          "key": "left_on_field_residue"
+          "symbol": "NC",
+          "description": "is the nitrogen content of the above ground crop residue (left on field or incorporated), in % (i.e. kg N per 100 kg dry matter); the ratio $\\frac{N_{AG}}{AG_{DM}}$ expressed as a percentage.",
+          "key": "total_nitrogenContent"
         }
       ]
     },
     {
-      "formula": "a = \\left(0.38 \\times 1000 \\times \\frac{NC}{100} - 5.44\\right) / 100",
+      "formula": "NH_3 = a \\times N_{AG} \\times \\frac{17}{14}",
       "bindings": [
         {
           "symbol": "NH_3",
@@ -340,18 +335,13 @@
         },
         {
           "symbol": "a",
-          "description": "is the volatilisation coefficient, bounded $0 \\le a < 17\\%$ (the bounds of observations in the study).",
+          "description": "is the volatilisation coefficient derived above.",
           "key": "A"
         },
         {
           "symbol": "N_{AG}",
           "description": "is the nitrogen in above ground crop residue left on field or incorporated, in kg.",
           "key": "left_on_field_residue"
-        },
-        {
-          "symbol": "NC",
-          "description": "is the nitrogen content of the above ground crop residue (left on field or incorporated), in % (i.e. kg N per 100 kg dry matter); the ratio $\\frac{N_{AG}}{AG_{DM}}$ expressed as a percentage.",
-          "key": "total_nitrogenContent"
         }
       ]
     }
@@ -1882,8 +1872,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 +1894,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 +1916,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 +1928,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 +1936,19 @@
           "key": "value"
         },
         {
-          "symbol": "n_{CaCO_3}",
-          "description": "number of limestone (CaCO<sub>3</sub>) inputs",
-          "key": "CaCO3_values"
-        },
-        {
-          "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_{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": "n_{dolomite}",
-          "description": "number of dolomite (CaMg(CO<sub>3</sub>)<sub>2</sub>) inputs",
-          "key": "MgCO3_values"
+          "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": "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 +2007,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 +2048,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 +2063,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
         }
       ]
     },
@@ -2107,18 +2077,43 @@
       "bindings": [
         {
           "symbol": "L_{fire}",
-          "description": "amount of greenhouse gas emissions from fire (kg)",
-          "key": "value"
+          "description": "amount of greenhouse gas emissions from fire, per year and fuel category, before amortisation and allocation (kg)",
+          "display": true
         },
         {
           "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
+        }
+      ]
+    },
+    {
+      "formula": "E = \\sum_{y} s_{y} \\times A_{y}",
+      "bindings": [
+        {
+          "symbol": "E",
+          "description": "emission from organic soil burning allocated to the Cycle (kg)",
+          "key": "value"
+        },
+        {
+          "symbol": "s_{y}",
+          "description": "the Cycle's share of the emissions amortised to year $y$ (fraction, based on the portion of year $y$ the Cycle spans)",
+          "display": true
+        },
+        {
+          "symbol": "A_{y}",
+          "description": "the emission amortised to year $y$ — a 1/20 share of $L_{fire}$ from that year and the preceding nineteen (kg)",
+          "display": true
+        },
+        {
+          "symbol": "A",
+          "description": "area lost (ha)",
+          "display": true
         }
       ]
     }
@@ -3000,12 +2995,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 +3010,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
         }
       ]
     },
@@ -3024,18 +3019,43 @@
       "bindings": [
         {
           "symbol": "L_{fire}",
-          "description": "amount of greenhouse gas emissions from fire (kg)",
-          "key": "value"
+          "description": "amount of greenhouse gas emissions from fire, per year and fuel category, before amortisation and allocation (kg)",
+          "display": true
         },
         {
           "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
+        }
+      ]
+    },
+    {
+      "formula": "E = \\sum_{y} s_{y} \\times A_{y}",
+      "bindings": [
+        {
+          "symbol": "E",
+          "description": "non-CO<sub>2</sub> emission from natural vegetation burning allocated to the Cycle (kg)",
+          "key": "value"
+        },
+        {
+          "symbol": "s_{y}",
+          "description": "the Cycle's share of the emissions amortised to year $y$ (fraction, based on the portion of year $y$ the Cycle spans)",
+          "display": true
+        },
+        {
+          "symbol": "A_{y}",
+          "description": "the emission amortised to year $y$ — a 1/20 share of $L_{fire}$ from that year and the preceding nineteen (kg)",
+          "display": true
+        },
+        {
+          "symbol": "A",
+          "description": "area lost (ha)",
+          "display": true
         }
       ]
     }
@@ -3902,8 +3922,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 +3944,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 +3966,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"
         }
       ]
     }
@@ -4196,13 +4216,8 @@
   ],
   "hestia_earth/models/pooreNemecek2018/no3ToGroundwaterCropResidueDecomposition.md": [
     {
-      "formula": "NO_3^--N_{CR} = NO_3^--N_{TOTAL} \\times \\left[ \\frac{F_{CR}}{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
+      "formula": "NO_3^--N_{TOTAL} = Frac_{LEACH} \\times \\left[{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
       "bindings": [
-        {
-          "symbol": "NO_3^--N_{CR}",
-          "description": "is nitrate leaching, in nitrogen equivalents, related to crop residue decomposition",
-          "key": "value"
-        },
         {
           "symbol": "NO_3^--N_{TOTAL}",
           "description": "is the total anthropogenically induced nitrate leaching, in nitrogen equivalents",
@@ -4231,13 +4246,23 @@
       ]
     },
     {
-      "formula": "NO_3^--N_{TOTAL} = Frac_{LEACH} \\times \\left[{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
+      "formula": "NO_3^--N_{CR} = NO_3^--N_{TOTAL} \\times \\left[ \\frac{F_{CR}}{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
       "bindings": [
+        {
+          "symbol": "NO_3^--N_{CR}",
+          "description": "is nitrate leaching, in nitrogen equivalents, related to crop residue decomposition",
+          "key": "value"
+        },
         {
           "symbol": "NO_3^--N_{TOTAL}",
           "description": "is the total anthropogenically induced nitrate leaching, in nitrogen equivalents",
           "key": "total_no3_leaching"
         },
+        {
+          "symbol": "F_{CR}",
+          "description": "is the amount of nitrogen in crop residues left on field or incorporated",
+          "key": "N_crop_residue"
+        },
         {
           "symbol": "F_{SN}",
           "description": "is the amount of nitrogen in inorganic (synthetic) fertiliser",
@@ -4248,11 +4273,6 @@
           "description": "is the amount of nitrogen in organic fertiliser",
           "key": "N_organic_fertiliser"
         },
-        {
-          "symbol": "F_{CR}",
-          "description": "is the amount of nitrogen in crop residues left on field or incorporated",
-          "key": "N_crop_residue"
-        },
         {
           "symbol": "F_{PRP}",
           "description": "is the amount of nitrogen in animal excreta, where animals excrete directly on cropland",
@@ -4263,13 +4283,8 @@
   ],
   "hestia_earth/models/pooreNemecek2018/no3ToGroundwaterExcreta.md": [
     {
-      "formula": "NO_3^--N_{PRP} = NO_3^--N_{TOTAL} \\times \\left[ \\frac{F_{PRP}}{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
+      "formula": "NO_3^--N_{TOTAL} = Frac_{LEACH} \\times \\left[{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
       "bindings": [
-        {
-          "symbol": "NO_3^--N_{PRP}",
-          "description": "is nitrate leaching, in nitrogen equivalents, related to animal excreta, where animals excrete directly on cropland",
-          "key": "value"
-        },
         {
           "symbol": "NO_3^--N_{TOTAL}",
           "description": "is the total anthropogenically induced nitrate leaching, in nitrogen equivalents",
@@ -4298,13 +4313,23 @@
       ]
     },
     {
-      "formula": "NO_3^--N_{TOTAL} = Frac_{LEACH} \\times \\left[{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
+      "formula": "NO_3^--N_{PRP} = NO_3^--N_{TOTAL} \\times \\left[ \\frac{F_{PRP}}{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
       "bindings": [
+        {
+          "symbol": "NO_3^--N_{PRP}",
+          "description": "is nitrate leaching, in nitrogen equivalents, related to animal excreta, where animals excrete directly on cropland",
+          "key": "value"
+        },
         {
           "symbol": "NO_3^--N_{TOTAL}",
           "description": "is the total anthropogenically induced nitrate leaching, in nitrogen equivalents",
           "key": "total_no3_leaching"
         },
+        {
+          "symbol": "F_{PRP}",
+          "description": "is the amount of nitrogen in animal excreta, where animals excrete directly on cropland",
+          "key": "N_excreta"
+        },
         {
           "symbol": "F_{SN}",
           "description": "is the amount of nitrogen in inorganic (synthetic) fertiliser",
@@ -4319,24 +4344,14 @@
           "symbol": "F_{CR}",
           "description": "is the amount of nitrogen in crop residues left on field or incorporated",
           "key": "N_crop_residue"
-        },
-        {
-          "symbol": "F_{PRP}",
-          "description": "is the amount of nitrogen in animal excreta, where animals excrete directly on cropland",
-          "key": "N_excreta"
         }
       ]
     }
   ],
   "hestia_earth/models/pooreNemecek2018/no3ToGroundwaterInorganicFertiliser.md": [
     {
-      "formula": "NO_3^--N_{SN} = NO_3^--N_{TOTAL} \\times \\left[ \\frac{F_{SN}}{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
+      "formula": "NO_3^--N_{TOTAL} = Frac_{LEACH} \\times \\left[{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
       "bindings": [
-        {
-          "symbol": "NO_3^--N_{SN}",
-          "description": "is nitrate leaching, in nitrogen equivalents, related to inorganic fertiliser application",
-          "key": "value"
-        },
         {
           "symbol": "NO_3^--N_{TOTAL}",
           "description": "is the total anthropogenically induced nitrate leaching, in nitrogen equivalents",
@@ -4365,8 +4380,13 @@
       ]
     },
     {
-      "formula": "NO_3^--N_{TOTAL} = Frac_{LEACH} \\times \\left[{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
+      "formula": "NO_3^--N_{SN} = NO_3^--N_{TOTAL} \\times \\left[ \\frac{F_{SN}}{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
       "bindings": [
+        {
+          "symbol": "NO_3^--N_{SN}",
+          "description": "is nitrate leaching, in nitrogen equivalents, related to inorganic fertiliser application",
+          "key": "value"
+        },
         {
           "symbol": "NO_3^--N_{TOTAL}",
           "description": "is the total anthropogenically induced nitrate leaching, in nitrogen equivalents",
@@ -4397,13 +4417,8 @@
   ],
   "hestia_earth/models/pooreNemecek2018/no3ToGroundwaterOrganicFertiliser.md": [
     {
-      "formula": "NO_3^--N_{ON} = NO_3^--N_{TOTAL} \\times \\left[ \\frac{F_{ON}}{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
+      "formula": "NO_3^--N_{TOTAL} = Frac_{LEACH} \\times \\left[{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
       "bindings": [
-        {
-          "symbol": "NO_3^--N_{ON}",
-          "description": "is nitrate leaching, in nitrogen equivalents, related to organic fertiliser application",
-          "key": "value"
-        },
         {
           "symbol": "NO_3^--N_{TOTAL}",
           "description": "is the total anthropogenically induced nitrate leaching, in nitrogen equivalents",
@@ -4432,23 +4447,28 @@
       ]
     },
     {
-      "formula": "NO_3^--N_{TOTAL} = Frac_{LEACH} \\times \\left[{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
+      "formula": "NO_3^--N_{ON} = NO_3^--N_{TOTAL} \\times \\left[ \\frac{F_{ON}}{F_{SN} + F_{ON} + F_{CR} + F_{PRP}} \\right]",
       "bindings": [
+        {
+          "symbol": "NO_3^--N_{ON}",
+          "description": "is nitrate leaching, in nitrogen equivalents, related to organic fertiliser application",
+          "key": "value"
+        },
         {
           "symbol": "NO_3^--N_{TOTAL}",
           "description": "is the total anthropogenically induced nitrate leaching, in nitrogen equivalents",
           "key": "total_no3_leaching"
         },
-        {
-          "symbol": "F_{SN}",
-          "description": "is the amount of nitrogen in inorganic (synthetic) fertiliser",
-          "key": "N_inorganic_fertiliser"
-        },
         {
           "symbol": "F_{ON}",
           "description": "is the amount of nitrogen in organic fertiliser",
           "key": "N_organic_fertiliser"
         },
+        {
+          "symbol": "F_{SN}",
+          "description": "is the amount of nitrogen in inorganic (synthetic) fertiliser",
+          "key": "N_inorganic_fertiliser"
+        },
         {
           "symbol": "F_{CR}",
           "description": "is the amount of nitrogen in crop residues left on field or incorporated",
@@ -5191,14 +5211,9 @@
           "key": "value"
         },
         {
-          "symbol": "NO_{x,soil}",
-          "description": "total NO<sub>x</sub> soil flux across all nitrogen sources (kg NO<sub>x</sub>)",
-          "key": "noxToAirSoilFlux"
-        },
-        {
-          "symbol": "EF_{NOX}",
-          "description": "country-specific NO<sub>x</sub> emission factor (kg NO<sub>x</sub> per kg N)",
-          "key": "EF_NOX"
+          "symbol": "N_{CR}",
+          "description": "nitrogen from crop residue decomposition (kg N)",
+          "key": "N_crop_residue"
         },
         {
           "symbol": "N_{total}",
@@ -5206,9 +5221,9 @@
           "key": "N_total"
         },
         {
-          "symbol": "N_{CR}",
-          "description": "nitrogen from crop residue decomposition (kg N)",
-          "key": "N_crop_residue"
+          "symbol": "NO_{x,soil}",
+          "description": "total NO<sub>x</sub> soil flux across all nitrogen sources (kg NO<sub>x</sub>)",
+          "key": "noxToAirSoilFlux"
         }
       ]
     }
@@ -5243,14 +5258,9 @@
           "key": "value"
         },
         {
-          "symbol": "NO_{x,soil}",
-          "description": "total NO<sub>x</sub> soil flux across all nitrogen sources (kg NO<sub>x</sub>)",
-          "key": "noxToAirSoilFlux"
-        },
-        {
-          "symbol": "EF_{NOX}",
-          "description": "country-specific NO<sub>x</sub> emission factor (kg NO<sub>x</sub> per kg N)",
-          "key": "EF_NOX"
+          "symbol": "N_{ex}",
+          "description": "nitrogen from excreta (kg N)",
+          "key": "N_excreta"
         },
         {
           "symbol": "N_{total}",
@@ -5258,9 +5268,9 @@
           "key": "N_total"
         },
         {
-          "symbol": "N_{ex}",
-          "description": "nitrogen from excreta (kg N)",
-          "key": "N_excreta"
+          "symbol": "NO_{x,soil}",
+          "description": "total NO<sub>x</sub> soil flux across all nitrogen sources (kg NO<sub>x</sub>)",
+          "key": "noxToAirSoilFlux"
         }
       ]
     }
@@ -5295,14 +5305,9 @@
           "key": "value"
         },
         {
-          "symbol": "NO_{x,soil}",
-          "description": "total NO<sub>x</sub> soil flux across all nitrogen sources (kg NO<sub>x</sub>)",
-          "key": "noxToAirSoilFlux"
-        },
-        {
-          "symbol": "EF_{NOX}",
-          "description": "country-specific NO<sub>x</sub> emission factor (kg NO<sub>x</sub> per kg N)",
-          "key": "EF_NOX"
+          "symbol": "N_{SN}",
+          "description": "nitrogen from inorganic fertiliser (kg N)",
+          "key": "N_inorganic_fertiliser"
         },
         {
           "symbol": "N_{total}",
@@ -5310,9 +5315,9 @@
           "key": "N_total"
         },
         {
-          "symbol": "N_{SN}",
-          "description": "nitrogen from inorganic fertiliser (kg N)",
-          "key": "N_inorganic_fertiliser"
+          "symbol": "NO_{x,soil}",
+          "description": "total NO<sub>x</sub> soil flux across all nitrogen sources (kg NO<sub>x</sub>)",
+          "key": "noxToAirSoilFlux"
         }
       ]
     }
@@ -5347,14 +5352,9 @@
           "key": "value"
         },
         {
-          "symbol": "NO_{x,soil}",
-          "description": "total NO<sub>x</sub> soil flux across all nitrogen sources (kg NO<sub>x</sub>)",
-          "key": "noxToAirSoilFlux"
-        },
-        {
-          "symbol": "EF_{NOX}",
-          "description": "country-specific NO<sub>x</sub> emission factor (kg NO<sub>x</sub> per kg N)",
-          "key": "EF_NOX"
+          "symbol": "N_{ON}",
+          "description": "nitrogen from organic fertiliser (kg N)",
+          "key": "N_organic_fertiliser"
         },
         {
           "symbol": "N_{total}",
@@ -5362,9 +5362,9 @@
           "key": "N_total"
         },
         {
-          "symbol": "N_{ON}",
-          "description": "nitrogen from organic fertiliser (kg N)",
-          "key": "N_organic_fertiliser"
+          "symbol": "NO_{x,soil}",
+          "description": "total NO<sub>x</sub> soil flux across all nitrogen sources (kg NO<sub>x</sub>)",
+          "key": "noxToAirSoilFlux"
         }
       ]
     }

package/model-links.json

@@ -869,10 +869,21 @@
       "docPath": "hestia_earth/models/environmentalFootprintV3_1/freshwaterEcotoxicityPotentialCtue.md",
       "guidePath": "freshwaterEcotoxicityPotentialCtue#Environmental%20Footprint%20v3.1",
       "model": "environmentalFootprintV3-1",
-      "term": "freshwaterEcotoxicityPotentialCtue",
-      "dependencies": [
-        "completeness"
-      ]
+      "term": "freshwaterEcotoxicityPotentialCtue"
+    },
+    {
+      "path": "hestia_earth/models/environmentalFootprintV3_1/humanToxicityPotentialCancerCtuh.py",
+      "docPath": "hestia_earth/models/environmentalFootprintV3_1/humanToxicityPotentialCancerCtuh.md",
+      "guidePath": "humanToxicityPotentialCancerCtuh#Environmental%20Footprint%20v3.1",
+      "model": "environmentalFootprintV3-1",
+      "term": "humanToxicityPotentialCancerCtuh"
+    },
+    {
+      "path": "hestia_earth/models/environmentalFootprintV3_1/humanToxicityPotentialNonCancerCtuh.py",
+      "docPath": "hestia_earth/models/environmentalFootprintV3_1/humanToxicityPotentialNonCancerCtuh.md",
+      "guidePath": "humanToxicityPotentialNonCancerCtuh#Environmental%20Footprint%20v3.1",
+      "model": "environmentalFootprintV3-1",
+      "term": "humanToxicityPotentialNonCancerCtuh"
     },
     {
       "path": "hestia_earth/models/environmentalFootprintV3_1/marineEutrophicationPotential.py",
@@ -11278,6 +11289,24 @@
           "term": "ozoneDepletionPotential"
         }
       ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
       "nEqMarineEutrophicationEnvironmentalFootprintV3": [
         {
           "model": "environmentalFootprintV3-1",
@@ -12804,12 +12833,6 @@
           "modelKey": "landCover"
         }
       ],
-      "cropGroupingFaostatProduction": [
-        {
-          "model": "hestia",
-          "modelKey": "landCover"
-        }
-      ],
       "FAOSTAT_LAND_AREA_CATEGORY": [
         {
           "model": "hestia",
@@ -13580,12 +13603,240 @@
           "modelKey": "cycle"
         }
       ],
-      "pafM3DFreshwaterEcotoxicityUsetox2-1Hc20Ec10eq": [
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToSoil": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToSoilAgricultural": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToSoilNonAgricultural": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToWater": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToSaltWater": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToFreshWater": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToAir": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToAirIndoor": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToAirUrbanCloseToGround": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToAirOtherHigherAltitudes": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToAirIndoorIndustrial": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToHarvestedCrop": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "freshwaterEcotoxicityPotentialCtue"
+        }
+      ],
+      "freshwaterEcotoxicityPotentialCtueEnvironmentalFootprintV3-1ToAirIndoorHousehold": [
         {
           "model": "environmentalFootprintV3-1",
           "term": "freshwaterEcotoxicityPotentialCtue"
         }
       ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToSoil": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToSoilAgricultural": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToSoilNonAgricultural": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToWater": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToSaltWater": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToFreshWater": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToAir": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToAirIndoor": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToAirUrbanCloseToGround": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToAirOtherHigherAltitudes": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToAirIndoorIndustrial": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToHarvestedCrop": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialCancerCtuhEnvironmentalFootprintV3-1ToAirIndoorHousehold": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToSoil": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToSoilAgricultural": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToSoilNonAgricultural": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToWater": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToSaltWater": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToFreshWater": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToAir": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToAirIndoor": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToAirUrbanCloseToGround": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToAirOtherHigherAltitudes": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToAirIndoorIndustrial": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToHarvestedCrop": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
+      "humanToxicityPotentialNonCancerCtuhEnvironmentalFootprintV3-1ToAirIndoorHousehold": [
+        {
+          "model": "environmentalFootprintV3-1",
+          "term": "humanToxicityPotentialNonCancerCtuh"
+        }
+      ],
       "pdfYear100YearsFreshwaterEcotoxicityDamageToFreshwaterEcosystemsLCImpact": [
         {
           "model": "lcImpactAllEffects100Years",
@@ -14219,7 +14470,7 @@
         }
       ]
     },
-    "region-crop-cropGroupingFaostatArea-landCover-annualCropland": {
+    "region-crop-cropGroupingFaostatArea-areaHarvested": {
       "all": [
         {
           "model": "hestia",
@@ -14227,7 +14478,7 @@
         }
       ]
     },
-    "region-crop-cropGroupingFaostatArea-landCover-forest": {
+    "region-crop-cropGroupingFaostatArea-areaHarvestedUpTo20YearExpansion": {
       "all": [
         {
           "model": "hestia",
@@ -14235,7 +14486,7 @@
         }
       ]
     },
-    "region-crop-cropGroupingFaostatArea-landCover-otherLand": {
+    "region-crop-cropGroupingFaostatArea-landCover-annualCropland": {
       "all": [
         {
           "model": "hestia",
@@ -14243,7 +14494,7 @@
         }
       ]
     },
-    "region-crop-cropGroupingFaostatArea-landCover-permanentCropland": {
+    "region-crop-cropGroupingFaostatArea-landCover-forest": {
       "all": [
         {
           "model": "hestia",
@@ -14251,7 +14502,7 @@
         }
       ]
     },
-    "region-crop-cropGroupingFaostatArea-landCover-permanentPasture": {
+    "region-crop-cropGroupingFaostatArea-landCover-otherLand": {
       "all": [
         {
           "model": "hestia",
@@ -14259,7 +14510,7 @@
         }
       ]
     },
-    "region-crop-cropGroupingFaostatProduction-areaHarvested": {
+    "region-crop-cropGroupingFaostatArea-landCover-permanentCropland": {
       "all": [
         {
           "model": "hestia",
@@ -14267,7 +14518,7 @@
         }
       ]
     },
-    "region-crop-cropGroupingFaostatProduction-areaHarvestedUpTo20YearExpansion": {
+    "region-crop-cropGroupingFaostatArea-landCover-permanentPasture": {
       "all": [
         {
           "model": "hestia",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hestia-earth/engine-models",
-  "version": "0.82.1",
+  "version": "0.83.0",
   "description": "HESTIA Engine Models",
   "main": "cjs/index.js",
   "module": "esm/index.js",
@@ -72,12 +72,12 @@
     "@babel/preset-typescript": "^7.28.5",
     "@commitlint/cli": "^19.8.1",
     "@commitlint/config-conventional": "^19.8.1",
-    "@hestia-earth/api": "^0.26.14",
+    "@hestia-earth/api": "^0.27.3",
     "@hestia-earth/eslint-config": "^0.1.1",
     "@hestia-earth/json-schema": "^38.0.0",
     "@hestia-earth/schema": "^38.0.0",
     "@hestia-earth/schema-validation": "^38.0.0",
-    "@hestia-earth/utils": "^0.17.19",
+    "@hestia-earth/utils": "^0.17.24",
     "@jest/globals": "^29.7.0",
     "@types/node": "^22.19.15",
     "@typescript-eslint/eslint-plugin": "^5.62.0",