@hestia-earth/engine-models 0.81.5 → 0.82.0

package/formulas/ipcc2019/belowGroundCropResidue.json

@@ -0,0 +1,31 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/belowGroundCropResidue.md",
+  "formulas": [
+    {
+      "formula": "BG = (Y \\times R_{AG} + AG) \\times R_{BG-BIO}",
+      "bindings": [
+        {
+          "symbol": "BG",
+          "description": "below-ground crop residue (root biomass, kg)",
+          "key": "value"
+        },
+        {
+          "symbol": "Y",
+          "description": "crop yield"
+        },
+        {
+          "symbol": "R_{AG}",
+          "description": "above-ground residue ratio"
+        },
+        {
+          "symbol": "AG",
+          "description": "above-ground residue"
+        },
+        {
+          "symbol": "R_{BG-BIO}",
+          "description": "ratio of below-ground biomass to total above-ground biomass"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/ch4ToAirAquacultureSystems.json

@@ -0,0 +1,29 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/ch4ToAirAquacultureSystems.md",
+  "formulas": [
+    {
+      "formula": "F_{CH_4} = A_{waterbody} * EF_{CH_4} * siteDuration / 365",
+      "bindings": [
+        {
+          "symbol": "F_{CH_4}",
+          "description": "the total amount of CH<sub>4</sub> emitted during the Cycle, in kg CH<sub>4</sub>.",
+          "key": "value"
+        },
+        {
+          "symbol": "A_{waterbody}",
+          "description": "the area of the waterbody, in ha.",
+          "key": "site_area"
+        },
+        {
+          "symbol": "EF_{CH_4}",
+          "description": "the CH<sub>4</sub> emission rate, in kg CH<sub>4</sub> / ha / year (see Table 1)."
+        },
+        {
+          "symbol": "siteDuration",
+          "description": "the duration of the Site, in days.",
+          "key": "site_duration"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/ch4ToAirEntericFermentation.json

@@ -0,0 +1,29 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/ch4ToAirEntericFermentation.md",
+  "formulas": [
+    {
+      "formula": "E_{CH4} = (GE \\times Y_m) / 55.65",
+      "bindings": [
+        {
+          "symbol": "E_{CH4}",
+          "description": "Methane emissions (in kg $CH_4$)",
+          "key": "value"
+        },
+        {
+          "symbol": "GE",
+          "description": "Gross Energy intake (in MJ). This is derived from the quantity and energy content of the feed.",
+          "key": "total_feed_in_MJ"
+        },
+        {
+          "symbol": "Y_m",
+          "description": "Methane conversion factor (unitless fraction). This is the fraction of gross energy in the feed that is converted to $CH_4$. This value is specific to the animal type and feed quality.",
+          "key": "enteric_factor"
+        },
+        {
+          "symbol": "55.65",
+          "description": "The energy content of methane (in MJ/kg $CH_4$)."
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/ch4ToAirExcreta.json

@@ -0,0 +1,36 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/ch4ToAirExcreta.md",
+  "formulas": [
+    {
+      "formula": "CH_4 = VS \\times B_0 \\times 0.67 \\times \\frac{MCF}{100}",
+      "bindings": [
+        {
+          "symbol": "CH_4",
+          "description": "methane emission from excreta management (kg)",
+          "key": "value"
+        },
+        {
+          "symbol": "VS",
+          "description": "volatile solids in excreta (kg VS)"
+        },
+        {
+          "symbol": "B_0",
+          "description": "maximum CH<sub>4</sub> producing capacity (m<sup>3</sup> CH<sub>4</sub> per kg VS)"
+        },
+        {
+          "symbol": "0.67",
+          "description": "density conversion (kg CH<sub>4</sub> per m<sup>3</sup>)"
+        },
+        {
+          "symbol": "MCF",
+          "description": "methane conversion factor (%)",
+          "key": "CH4_conv_factor"
+        },
+        {
+          "symbol": "100",
+          "description": "percent-to-fraction conversion"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/ch4ToAirFloodedRice.json

@@ -0,0 +1,31 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/ch4ToAirFloodedRice.md",
+  "formulas": [
+    {
+      "formula": "CH_4 = EF_{base} \\times SF_w \\times SF_o \\times t",
+      "bindings": [
+        {
+          "symbol": "CH_4",
+          "description": "methane emission from flooded rice (kg CH<sub>4</sub>)",
+          "key": "value"
+        },
+        {
+          "symbol": "EF_{base}",
+          "description": "baseline emission factor (kg CH<sub>4</sub> ha<sup>-1</sup> day<sup>-1</sup>)"
+        },
+        {
+          "symbol": "SF_w",
+          "description": "water regime scaling factor"
+        },
+        {
+          "symbol": "SF_o",
+          "description": "organic amendment scaling factor"
+        },
+        {
+          "symbol": "t",
+          "description": "cropping duration (days)"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/ch4ToAirOrganicSoilCultivation.json

@@ -0,0 +1,40 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/ch4ToAirOrganicSoilCultivation.md",
+  "formulas": [
+    {
+      "formula": "CH_{4~cycle} = A_{cycle} * Frac_{org} * (EF_{CH_4~ditch} * Frac_{ditch} + EF_{CH_4~land} * (1 - Frac_{ditch}))",
+      "bindings": [
+        {
+          "symbol": "CH_{4~cycle}",
+          "description": "The total emissions from the Cycle, kg CH<sub>4</sub>",
+          "key": "value"
+        },
+        {
+          "symbol": "A_{cycle}",
+          "description": "The area occupied by the Cycle, ha",
+          "key": "land_occupation"
+        },
+        {
+          "symbol": "Frac_{org}",
+          "description": "The fraction of land with drained organic soils, decimal between 0 and 1",
+          "key": "organic_soils"
+        },
+        {
+          "symbol": "EF_{CH_4~ditch}",
+          "description": "The emission factor for direct CH<sub>4</sub> emissions from drainage ditches, kg CH<sub>4</sub> ha<sup>-1</sup> yr<sup>-1</sup>",
+          "key": "ditch_factor"
+        },
+        {
+          "symbol": "EF_{CH_4~land}",
+          "description": "The emission factor for direct CH<sub>4</sub> emissions from drained organic soils for the Cycle's land use, kg CH<sub>4</sub> ha<sup>-1</sup> yr<sup>-1</sup>",
+          "key": "emission_factor"
+        },
+        {
+          "symbol": "Frac_{ditch}",
+          "description": "The fraction of the Site that is occupied by ditches, decimal between 0 and 1",
+          "key": "ditch_frac"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/co2ToAirUreaHydrolysis.json

@@ -0,0 +1,27 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/co2ToAirUreaHydrolysis.md",
+  "formulas": [
+    {
+      "formula": "CO_2 = \\sum_i M_{urea,i} \\times EF_i",
+      "bindings": [
+        {
+          "symbol": "CO_2",
+          "description": "carbon dioxide emission from urea hydrolysis (kg)",
+          "key": "value"
+        },
+        {
+          "symbol": "M_{urea,i}",
+          "description": "mass of each urea-containing fertiliser applied (kg)",
+          "key": "urea_values",
+          "column": "value"
+        },
+        {
+          "symbol": "EF_i",
+          "description": "product-specific CO<sub>2</sub> emission factor",
+          "key": "urea_values",
+          "column": "factor"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/emissionsToAirOrganicSoilBurning.json

@@ -0,0 +1,49 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/emissionsToAirOrganicSoilBurning.md",
+  "formulas": [
+    {
+      "formula": "M = A * B_{region} * F_{fuel} * F_{org}",
+      "bindings": [
+        {
+          "symbol": "M",
+          "description": "mass of fuel biomass combusted during land conversion event (tonnes dry matter, >= 0)"
+        },
+        {
+          "symbol": "A",
+          "description": "area lost (ha)"
+        },
+        {
+          "symbol": "B_{region}",
+          "description": "burnt fraction, percentage of land area burnt during a land conversation event for region where natural vegetation loss occurs (decimal percentage, 0 - 1)",
+          "key": "percent_burned"
+        },
+        {
+          "symbol": "F_{fuel}",
+          "description": "fuel factor, mass of fuel biomass per hectare for fuel category (tonnes dry matter ha<sup>-1</sup>)"
+        },
+        {
+          "symbol": "F_{org}",
+          "description": "organic soil factor, % area of the Site with organic soils (decimal percentage, 0 - 1)"
+        }
+      ]
+    },
+    {
+      "formula": "L_{fire} = M * G_{emission, fuel}",
+      "bindings": [
+        {
+          "symbol": "L_{fire}",
+          "description": "amount of greenhouse gas emissions from fire (kg)",
+          "key": "value"
+        },
+        {
+          "symbol": "M",
+          "description": "mass of fuel available for combustion (tonnes dry matter, >= 0)"
+        },
+        {
+          "symbol": "G_{emission, fuel}",
+          "description": "emission factor (g kg<sup>-1</sup> dry matter burnt)"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/n2OToAirAquacultureSystemsIndirect.json

@@ -0,0 +1,31 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/n2OToAirAquacultureSystemsIndirect.md",
+  "formulas": [
+    {
+      "formula": "N_2O_{indirect} = \\left[(NH_3\\text{-}N + NO_x\\text{-}N) \\times EF_4\\right] \\times \\frac{44}{28}",
+      "bindings": [
+        {
+          "symbol": "N_2O_{indirect}",
+          "description": "indirect N<sub>2</sub>O emission from aquaculture systems (the model result)",
+          "key": "value"
+        },
+        {
+          "symbol": "NH_3\\text{-}N",
+          "description": "nitrogen volatilised as ammonia from aquaculture systems (precursor, kg N)"
+        },
+        {
+          "symbol": "NO_x\\text{-}N",
+          "description": "nitrogen volatilised as nitrogen oxides from aquaculture systems (precursor, kg N)"
+        },
+        {
+          "symbol": "EF_4",
+          "description": "emission factor for N<sub>2</sub>O from atmospheric deposition of volatilised N"
+        },
+        {
+          "symbol": "\\frac{44}{28}",
+          "description": "conversion of N<sub>2</sub>O-N to N<sub>2</sub>O"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/n2OToAirCropResidueBurningDirect.json

@@ -0,0 +1,25 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/n2OToAirCropResidueBurningDirect.md",
+  "formulas": [
+    {
+      "formula": "N_2O = M_{burnt} \\times EF_{burning}",
+      "bindings": [
+        {
+          "symbol": "N_2O",
+          "description": "direct N<sub>2</sub>O emission from crop residue burning (kg N<sub>2</sub>O)",
+          "key": "value"
+        },
+        {
+          "symbol": "M_{burnt}",
+          "description": "mass of crop residue burnt (kg)",
+          "key": "crop_residue_burnt_value"
+        },
+        {
+          "symbol": "EF_{burning}",
+          "description": "crop-specific N<sub>2</sub>O burning emission factor",
+          "key": "burning_factor"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/n2OToAirCropResidueDecompositionDirect.json

@@ -0,0 +1,28 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/n2OToAirCropResidueDecompositionDirect.md",
+  "formulas": [
+    {
+      "formula": "N_2O = F_{CR} \\times EF_1 \\times \\frac{44}{28}",
+      "bindings": [
+        {
+          "symbol": "N_2O",
+          "description": "direct N<sub>2</sub>O emission from crop residue decomposition (kg N<sub>2</sub>O)",
+          "key": "value"
+        },
+        {
+          "symbol": "F_{CR}",
+          "description": "nitrogen content of crop residues (kg N)",
+          "key": "N_crop_residue"
+        },
+        {
+          "symbol": "EF_1",
+          "description": "wet-climate emission factor (kg N<sub>2</sub>O-N per kg N)"
+        },
+        {
+          "symbol": "\\frac{44}{28}",
+          "description": "conversion of N<sub>2</sub>O-N to N<sub>2</sub>O"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/n2OToAirCropResidueDecompositionIndirect.json

@@ -0,0 +1,35 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/n2OToAirCropResidueDecompositionIndirect.md",
+  "formulas": [
+    {
+      "formula": "N_2O_{indirect} = \\left[NH_3\\text{-}N \\times EF_4 + NO_3\\text{-}N \\times EF_5\\right] \\times \\frac{44}{28}",
+      "bindings": [
+        {
+          "symbol": "N_2O_{indirect}",
+          "description": "indirect N<sub>2</sub>O emission from crop residue decomposition (the model result)",
+          "key": "value"
+        },
+        {
+          "symbol": "NH_3\\text{-}N",
+          "description": "nitrogen volatilised as ammonia from crop residue decomposition (precursor, kg N)"
+        },
+        {
+          "symbol": "EF_4",
+          "description": "emission factor for N<sub>2</sub>O from atmospheric deposition of volatilised N"
+        },
+        {
+          "symbol": "NO_3\\text{-}N",
+          "description": "nitrogen lost as nitrate via leaching/runoff (precursor, kg N)"
+        },
+        {
+          "symbol": "EF_5",
+          "description": "emission factor for N<sub>2</sub>O from leaching/runoff of N"
+        },
+        {
+          "symbol": "\\frac{44}{28}",
+          "description": "conversion of N<sub>2</sub>O-N to N<sub>2</sub>O"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/n2OToAirExcretaDirect.json

@@ -0,0 +1,25 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/n2OToAirExcretaDirect.md",
+  "formulas": [
+    {
+      "formula": "N_{2}O_s = N_{excreta,s} \\times EF_{3,s} \\times \\frac{44}{28}",
+      "bindings": [
+        {
+          "symbol": "N_{2}O_s",
+          "description": "is the quantity of N2O produced from excreta management system $s$.",
+          "key": "value"
+        },
+        {
+          "symbol": "N_{excreta,s}",
+          "description": "is the quantity of nitrogen in excreta managed in system $s$.",
+          "key": "N_total"
+        },
+        {
+          "symbol": "EF_{3,s}",
+          "description": "is the emission factor (see Table 1).",
+          "key": "N2O_N_EF"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/n2OToAirExcretaIndirect.json

@@ -0,0 +1,39 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/n2OToAirExcretaIndirect.md",
+  "formulas": [
+    {
+      "formula": "N_2O_{indirect} = \\left[(NH_3\\text{-}N + NO_x\\text{-}N) \\times EF_4 + NO_3\\text{-}N \\times EF_5\\right] \\times \\frac{44}{28}",
+      "bindings": [
+        {
+          "symbol": "N_2O_{indirect}",
+          "description": "indirect N<sub>2</sub>O emission from excreta (kg N<sub>2</sub>O)",
+          "key": "value"
+        },
+        {
+          "symbol": "NH_3\\text{-}N",
+          "description": "nitrogen from ammonia volatilisation (kg N)"
+        },
+        {
+          "symbol": "NO_x\\text{-}N",
+          "description": "nitrogen from NO<sub>x</sub> emission (kg N)"
+        },
+        {
+          "symbol": "EF_4",
+          "description": "emission factor for N volatilisation and redeposition"
+        },
+        {
+          "symbol": "NO_3\\text{-}N",
+          "description": "nitrogen leached as nitrate (kg N)"
+        },
+        {
+          "symbol": "EF_5",
+          "description": "emission factor for N leaching/runoff"
+        },
+        {
+          "symbol": "\\frac{44}{28}",
+          "description": "conversion of N<sub>2</sub>O-N to N<sub>2</sub>O"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/n2OToAirFuelCombustionIndirect.json

@@ -0,0 +1,31 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/n2OToAirFuelCombustionIndirect.md",
+  "formulas": [
+    {
+      "formula": "N_2O_{indirect} = \\left[(NH_3\\text{-}N + NO_x\\text{-}N) \\times EF_4\\right] \\times \\frac{44}{28}",
+      "bindings": [
+        {
+          "symbol": "N_2O_{indirect}",
+          "description": "indirect N<sub>2</sub>O emission from fuel combustion (the model result)",
+          "key": "value"
+        },
+        {
+          "symbol": "NH_3\\text{-}N",
+          "description": "nitrogen volatilised as ammonia from fuel combustion (precursor, kg N)"
+        },
+        {
+          "symbol": "NO_x\\text{-}N",
+          "description": "nitrogen volatilised as nitrogen oxides from fuel combustion (precursor, kg N)"
+        },
+        {
+          "symbol": "EF_4",
+          "description": "emission factor for N<sub>2</sub>O from atmospheric deposition of volatilised N"
+        },
+        {
+          "symbol": "\\frac{44}{28}",
+          "description": "conversion of N<sub>2</sub>O-N to N<sub>2</sub>O"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/n2OToAirInorganicFertiliserDirect.json

@@ -0,0 +1,28 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/n2OToAirInorganicFertiliserDirect.md",
+  "formulas": [
+    {
+      "formula": "N_2O = F_{SN} \\times EF_1 \\times \\frac{44}{28}",
+      "bindings": [
+        {
+          "symbol": "N_2O",
+          "description": "direct N<sub>2</sub>O emission from inorganic fertiliser (kg N<sub>2</sub>O)",
+          "key": "value"
+        },
+        {
+          "symbol": "F_{SN}",
+          "description": "total nitrogen applied as inorganic fertiliser (kg N)",
+          "key": "N_total"
+        },
+        {
+          "symbol": "EF_1",
+          "description": "emission factor selected by eco-climate zone (kg N<sub>2</sub>O-N per kg N)"
+        },
+        {
+          "symbol": "\\frac{44}{28}",
+          "description": "conversion of N<sub>2</sub>O-N to N<sub>2</sub>O"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/n2OToAirInorganicFertiliserIndirect.json

@@ -0,0 +1,39 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/n2OToAirInorganicFertiliserIndirect.md",
+  "formulas": [
+    {
+      "formula": "N_2O_{indirect} = \\left[(NH_3\\text{-}N + NO_x\\text{-}N) \\times EF_4 + NO_3\\text{-}N \\times EF_5\\right] \\times \\frac{44}{28}",
+      "bindings": [
+        {
+          "symbol": "N_2O_{indirect}",
+          "description": "indirect N<sub>2</sub>O emission from inorganic fertiliser (the model result)",
+          "key": "value"
+        },
+        {
+          "symbol": "NH_3\\text{-}N",
+          "description": "nitrogen volatilised as ammonia from inorganic fertiliser (precursor, kg N)"
+        },
+        {
+          "symbol": "NO_x\\text{-}N",
+          "description": "nitrogen volatilised as nitrogen oxides from inorganic fertiliser (precursor, kg N)"
+        },
+        {
+          "symbol": "EF_4",
+          "description": "emission factor for N<sub>2</sub>O from atmospheric deposition of volatilised N"
+        },
+        {
+          "symbol": "NO_3\\text{-}N",
+          "description": "nitrogen lost as nitrate via leaching/runoff (precursor, kg N)"
+        },
+        {
+          "symbol": "EF_5",
+          "description": "emission factor for N<sub>2</sub>O from leaching/runoff of N"
+        },
+        {
+          "symbol": "\\frac{44}{28}",
+          "description": "conversion of N<sub>2</sub>O-N to N<sub>2</sub>O"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/n2OToAirNaturalVegetationBurningIndirect.json

@@ -0,0 +1,31 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/n2OToAirNaturalVegetationBurningIndirect.md",
+  "formulas": [
+    {
+      "formula": "N_2O_{indirect} = \\left[(NH_3\\text{-}N + NO_x\\text{-}N) \\times EF_4\\right] \\times \\frac{44}{28}",
+      "bindings": [
+        {
+          "symbol": "N_2O_{indirect}",
+          "description": "indirect N<sub>2</sub>O emission from natural vegetation burning (the model result)",
+          "key": "value"
+        },
+        {
+          "symbol": "NH_3\\text{-}N",
+          "description": "nitrogen volatilised as ammonia from natural vegetation burning (precursor, kg N)"
+        },
+        {
+          "symbol": "NO_x\\text{-}N",
+          "description": "nitrogen volatilised as nitrogen oxides from natural vegetation burning (precursor, kg N)"
+        },
+        {
+          "symbol": "EF_4",
+          "description": "emission factor for N<sub>2</sub>O from atmospheric deposition of volatilised N"
+        },
+        {
+          "symbol": "\\frac{44}{28}",
+          "description": "conversion of N<sub>2</sub>O-N to N<sub>2</sub>O"
+        }
+      ]
+    }
+  ]
+}

package/formulas/ipcc2019/n2OToAirOrganicFertiliserDirect.json

@@ -0,0 +1,28 @@
+{
+  "docPath": "hestia_earth/models/ipcc2019/n2OToAirOrganicFertiliserDirect.md",
+  "formulas": [
+    {
+      "formula": "N_2O = F_{ON} \\times EF_1 \\times \\frac{44}{28}",
+      "bindings": [
+        {
+          "symbol": "N_2O",
+          "description": "direct N<sub>2</sub>O emission from organic fertiliser (kg N<sub>2</sub>O)",
+          "key": "value"
+        },
+        {
+          "symbol": "F_{ON}",
+          "description": "total nitrogen applied as organic fertiliser (kg N)",
+          "key": "N_total"
+        },
+        {
+          "symbol": "EF_1",
+          "description": "wet-climate emission factor (kg N<sub>2</sub>O-N per kg N)"
+        },
+        {
+          "symbol": "\\frac{44}{28}",
+          "description": "conversion of N<sub>2</sub>O-N to N<sub>2</sub>O"
+        }
+      ]
+    }
+  ]
+}