@hestia-earth/guide 0.0.17 → 0.0.19

package/dist/content/models/cycleEmissions/organicSoil/co2ToAirOrganicSoilCultivation/ipcc2019.json

@@ -1 +1 @@
-{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Organic Soil"],"tab":["IPCC (2019)"],"modelId":["co2ToAirOrganicSoilCultivation"],"modelRequires":["longFallowRatio","nurseryDensity","nurseryDuration","plantationProductiveLifespan","plantationDensity","plantationLifespan","rotationDuration","histosol","ecoClimateZone"]},"content":"# CO2, to air, organic soil cultivation\n\nCarbon dioxide emissions to air, from organic soil (histosol) drainage and cultivation.\n\n## Overview\n\nFollowing the [IPCC (2019)](https://www.ipcc-nggip.iges.or.jp/public/2019rf/vol4.html) and [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Tier 1 guidelines, this model calculates the annual CO<sub>2</sub> emissions from the drainage and cultivation of organic soils and assigns them to [Cycles](https://www.hestia.earth/schema/Cycle) taking place during those years.\n\nOnly CO<sub>2</sub> emissions from the drainage and cultivation of organic soils are estimated by this model. CO<sub>2</sub> emissions from the burning of organic soils during deforestation or other land conversion events should be calculated otherwise.\n\nThe model is run as a Monte Carlo simulation with 10,000 iterations. Model result values are the row-wise `mean` of simulation results. See our guide on [Monte Carlo simulation](/guide/applying-models-monte-carlo) for more information.\n\n## How the model works\n\nThe model works by retrieving the percentage of the Cycle's associated Site under organic soils, the Cycle's land occupation, the Cycle's associated Site's eco-climate zone, and the Cycle's primary product category. Emissions from the drainage and cultivation of organic soils are estimated using emission factors provided in the [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Wetlands Supplement report.\n\n### Step 1. Retrieve required data from the Cycle and associated Site\n\nFrom the Cycle's associated Site, we retrieve:\n- the Site's `ecoClimateZone`\n- the percentage of the Site under organic soil\n- the Site's `siteType`\n\nOnly the `soilType` term `histosol` is used to estimate the percentage of a Site under organic soil; this is because this term is being gap-filled by the platform, which means that most Sites will have a value for it. See our guide on [Histosol gap-filling](/guide/histosol#Geospatial%20Database) for more information.\n\nFrom the Cycle, we retrieve the Cycle's primary Product. \n\nThe Cycle's land occupation is then calculated to determine how much of the Site's modelled land is actually occupied by the Cycle.\n\n### Step 2. Classify the primary Product\n\nIf the Cycle's associated Site has a `termType` = `cropland`, then, using the value of the primary Product term in the `IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY` lookup in the `crop` and `forage` glossaries, an organic soil cultivation category is assigned to the Cycle. This information will be used to retrieve land-use specific emission factors.\n\nIf the Cycle's associated Site has a `termType` = `permanent pasture`, then the organic soil cultivation category of `Grassland` is directly assigned to the Cycle.\n\nThe different organic soil cultivation categories are:\n\n|siteType|Organic soil cultivation category|\n|---|---|\n|cropland|Annual cropland|\n|cropland|Perennial cropland|\n|cropland|Acacia|\n|cropland|Oil palm|\n|cropland|Sago palm|\n|cropland|Rice|\n|permanent pasture|Grassland|\n\n### Step 3. Retrieve the CO<sub>2</sub> emission factor\n\nUsing the Cycle's eco-climate zone and assigned organic soil cultivation category, the CO<sub>2</sub> emission factor is retrieved from the `ecoClimateZone` lookup.\n\n**CO<sub>2</sub> emission factors (tonnes CO<sub>2</sub> ha<sup>-1</sup> y<sup>-1</sup>)**\n\n|ecoClimateZone|Annual cropland|Perennial cropland|Acacia|Oil palm|Sago palm|Rice|Grassland|\n|---|---|---|---|---|---|---|---|\n|Warm temperate moist|14 ± 13.56|15 ± 7.21|20 ± 6.62|11 ± 7.97|1.5 ± 3.10|9.4 ± 9.62|9.6 ± 9.1|\n|Warm temperate dry|14 ± 13.56|15 ± 7.21|20 ± 6.62|11 ± 7.97|1.5 ± 3.10|9.4 ± 9.62|9.6 ± 9.1|\n|Cool temperate moist|7 ± 4.47|7 ± 4.47|-|-|-|9.4 ± 9.62|6.1 ± 3.55|\n|Cool temperate dry|7 ± 4.47|7 ± 4.47|-|-|-|9.4 ± 9.62|6.1 ± 3.55|\n|Polar moist|-|-|-|-|-|-|-|\n|Polar dry|-|-|-|-|-|-|-|\n|Boreal moist|7 ± 4.47|7 ± 4.47|-|-|-|-|5.7 ± 3.41|\n|Boreal dry|7 ± 4.47|7 ± 4.47|-|-|-|-|5.7 ± 3.41|\n|Tropical montane|14 ± 13.56|15 ± 7.21|20 ± 6.62|11 ± 7.97|1.5 ± 3.10|9.4 ± 9.62|9.6 ± 9.1|\n|Tropical wet|14 ± 13.56|15 ± 7.21|20 ± 6.62|11 ± 7.97|1.5 ± 3.10|9.4 ± 9.62|9.6 ± 9.1|\n|Tropical moist|14 ± 13.56|15 ± 7.21|20 ± 6.62|11 ± 7.97|1.5 ± 3.10|9.4 ± 9.62|9.6 ± 9.1|\n|Tropical dry|14 ± 13.56|15 ± 7.21|20 ± 6.62|11 ± 7.97|1.5 ± 3.10|9.4 ± 9.62|9.6 ± 9.1|\n\nThe CO<sub>2</sub> emission factors for drained inland organic soils are provided by the [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Wetlands Supplement. All re-sampled values must be greater than 0, as no CO<sub>2</sub> removals were observed in the underlying data. No factors were provided for subtropical climate zones (Warm temperate eco-climate zones); tropical values were used for these eco-climate zones to match N<sub>2</sub>O and CH<sub>4</sub> factor stratifications. Standard deviations have been recalculated using the 95% confidence interval and `n` data provided in the IPCC report.\n\nFactors are stratified by land-use category, climate domain and nutrient status. Nutrient-rich grassland is further stratified into shallow-drained and deep-drained. Where data is not available to classify Sites by nutrient status or drainage depth, default categories are suggested based on climate domains. Because there is no information on nutrient status nor drainage depth available on HESTIA, the model uses the default values presented below:\n\n**Default nutrient status**\n\n|Climate domain|Nutrient status|\n|---|---|\n|Boreal|Nutrient-poor|\n|Temperate|Nutrient-rich|\n|Subtropical|Nutrient-rich|\n|Tropical|n/a|\n\n**Default drainage depth**\n\n|Climate domain|Drainage depth|\n|---|---|\n|Boreal|Deep|\n|Temperate|Deep|\n|Subtropical|n/a|\n|Tropical|n/a|\n\n### Step 4. Calculate the CO<sub>2</sub> emission\n\nThe model multiplies the CO<sub>2</sub> emission factor by the percentage of the Site's land under organic soil and the land occupation value.\n\n### Step 5. Assign an emission tier\n\nCO<sub>2</sub> emissions from organic soil cultivation are given the `methodTier` of `tier 1`, which corresponds to the model tier according to the [IPCC (2019) report](https://www.ipcc-nggip.iges.or.jp/public/2019rf/vol4.html).\n\n## Discussion\n\nWe plan to extend the model so it runs with the `usdaSoilType` term `histosols` and all its subclasses as well as with all the subclasses of the `soilType` term `histosol`, in addition to simply with the `soilType` term `histosol`. This will increase the instances for which the model will be able to run based on users' input data.\n\nWe will also release a new model calculating CO<sub>2</sub> emissions from organic soil burning during deforestation or other land-use changes, which will make our coverage of organic soil-related emissions more exhaustive.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/co2ToAirOrganicSoilCultivation\">co2ToAirOrganicSoilCultivation</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/ipcc2019\">ipcc2019</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#sd\">sd</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#min\">min</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#max\">max</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#observations\">observations</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#statsDefinition\">statsDefinition</a> with <code>simulated</code></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> with <code>forest</code> <strong>or</strong> <code>other natural vegetation</code> <strong>or</strong> <code>cropland</code> <strong>or</strong> <code>glass or high accessible cover</code> <strong>or</strong> <code>permanent pasture</code> and a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/histosol\">histosol</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/ecoClimateZone\">ecoClimateZone</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li>either:<ul>\n<li>the following fields:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a></li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#practices\">practices</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/longFallowRatio\">longFallowRatio</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li>for plantations, additional properties are required:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#practices\">practices</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/nurseryDensity\">nurseryDensity</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/nurseryDuration\">nurseryDuration</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/plantationProductiveLifespan\">plantationProductiveLifespan</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/plantationDensity\">plantationDensity</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/plantationLifespan\">plantationLifespan</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/rotationDuration\">rotationDuration</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n<li>optional:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/crop.csv\">crop.csv</a> -&gt; <code>isPlantation</code>; <code>IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/forage.csv\">forage.csv</a> -&gt; <code>isPlantation</code>; <code>IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/ecoClimateZone.csv\">ecoClimateZone.csv</a> -&gt; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_ANNUAL_CROPS</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_PERENNIAL_CROPS</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_ACACIA</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_OIL_PALM</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_SAGO_PALM</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_PADDY_RICE_CULTIVATION</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_GRASSLAND</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_OTHER</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>siteTypesAllowed</code>; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}
+{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Organic Soil"],"tab":["IPCC (2019)"],"modelId":["co2ToAirOrganicSoilCultivation"],"modelRequires":["longFallowRatio","nurseryDensity","nurseryDuration","plantationProductiveLifespan","plantationDensity","plantationLifespan","rotationDuration","organicSoils","ecoClimateZone"]},"content":"# CO2, to air, organic soil cultivation\n\nCarbon dioxide emissions to air, from organic soil (histosol) drainage and cultivation.\n\n## Overview\n\nFollowing the [IPCC (2019)](https://www.ipcc-nggip.iges.or.jp/public/2019rf/vol4.html) and [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Tier 1 guidelines, this model calculates the annual CO<sub>2</sub> emissions from the drainage and cultivation of organic soils and assigns them to [Cycles](/schema/Cycle) taking place during those years.\n\nOnly CO<sub>2</sub> emissions from the drainage and cultivation of organic soils are estimated by this model. CO<sub>2</sub> emissions from the burning of organic soils during deforestation or other land conversion events should be calculated otherwise.\n\nThe model is run as a Monte Carlo simulation with 10,000 iterations. Model result values are the row-wise `mean` of simulation results. See our guide on [Monte Carlo simulation](/guide/models-applying-models-monte-carlo) for more information.\n\n## How the model works\n\nThe model works by retrieving the percentage of the Cycle's associated Site under organic soils, the Cycle's land occupation, the Cycle's associated Site's eco-climate zone, and the Cycle's primary product category. Emissions from the drainage and cultivation of organic soils are estimated using emission factors provided in the [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Wetlands Supplement report.\n\n### Step 1. Retrieve required data from the Cycle and associated Site\n\nFrom the Cycle's associated Site, we retrieve:\n- the Site's `ecoClimateZone`\n- the percentage of the Site under organic soil\n- the Site's `siteType`\n\nOnly the `soilType` term `histosol` is used to estimate the percentage of a Site under organic soil; this is because this term is being gap-filled by the platform, which means that most Sites will have a value for it. See our guide on [Histosol gap-filling](/guide/histosol#Geospatial%20Database) for more information.\n\nFrom the Cycle, we retrieve the Cycle's primary Product.\n\nThe Cycle's land occupation is then calculated to determine how much of the Site's modelled land is actually occupied by the Cycle.\n\n### Step 2. Classify the primary Product\n\nIf the Cycle's associated Site has a `termType` = `cropland`, then, using the value of the primary Product term in the `IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY` lookup in the `crop` and `forage` glossaries, an organic soil cultivation category is assigned to the Cycle. This information will be used to retrieve land-use specific emission factors.\n\nIf the Cycle's associated Site has a `termType` = `permanent pasture`, then the organic soil cultivation category of `Grassland` is directly assigned to the Cycle.\n\nThe different organic soil cultivation categories are:\n\n| siteType          | Organic soil cultivation category |\n| ----------------- | --------------------------------- |\n| cropland          | Annual cropland                   |\n| cropland          | Perennial cropland                |\n| cropland          | Acacia                            |\n| cropland          | Oil palm                          |\n| cropland          | Sago palm                         |\n| cropland          | Rice                              |\n| permanent pasture | Grassland                         |\n\n### Step 3. Retrieve the CO<sub>2</sub> emission factor\n\nUsing the Cycle's eco-climate zone and assigned organic soil cultivation category, the CO<sub>2</sub> emission factor is retrieved from the `ecoClimateZone` lookup.\n\n**CO<sub>2</sub> emission factors (tonnes CO<sub>2</sub> ha<sup>-1</sup> y<sup>-1</sup>)**\n\n| ecoClimateZone       | Annual cropland | Perennial cropland | Acacia    | Oil palm  | Sago palm  | Rice       | Grassland  |\n| -------------------- | --------------- | ------------------ | --------- | --------- | ---------- | ---------- | ---------- |\n| Warm temperate moist | 14 ± 13.56      | 15 ± 7.21          | 20 ± 6.62 | 11 ± 7.97 | 1.5 ± 3.10 | 9.4 ± 9.62 | 9.6 ± 9.1  |\n| Warm temperate dry   | 14 ± 13.56      | 15 ± 7.21          | 20 ± 6.62 | 11 ± 7.97 | 1.5 ± 3.10 | 9.4 ± 9.62 | 9.6 ± 9.1  |\n| Cool temperate moist | 7.9 ± 4.47      | 7.9 ± 4.47         | -         | -         | -          | 9.4 ± 9.62 | 6.1 ± 3.55 |\n| Cool temperate dry   | 7.9 ± 4.47      | 7.9 ± 4.47         | -         | -         | -          | 9.4 ± 9.62 | 6.1 ± 3.55 |\n| Polar moist          | -               | -                  | -         | -         | -          | -          | -          |\n| Polar dry            | -               | -                  | -         | -         | -          | -          | -          |\n| Boreal moist         | 7.9 ± 4.47      | 7.9 ± 4.47         | -         | -         | -          | -          | 5.7 ± 3.41 |\n| Boreal dry           | 7.9 ± 4.47      | 7.9 ± 4.47         | -         | -         | -          | -          | 5.7 ± 3.41 |\n| Tropical montane     | 14 ± 13.56      | 15 ± 7.21          | 20 ± 6.62 | 11 ± 7.97 | 1.5 ± 3.10 | 9.4 ± 9.62 | 9.6 ± 9.1  |\n| Tropical wet         | 14 ± 13.56      | 15 ± 7.21          | 20 ± 6.62 | 11 ± 7.97 | 1.5 ± 3.10 | 9.4 ± 9.62 | 9.6 ± 9.1  |\n| Tropical moist       | 14 ± 13.56      | 15 ± 7.21          | 20 ± 6.62 | 11 ± 7.97 | 1.5 ± 3.10 | 9.4 ± 9.62 | 9.6 ± 9.1  |\n| Tropical dry         | 14 ± 13.56      | 15 ± 7.21          | 20 ± 6.62 | 11 ± 7.97 | 1.5 ± 3.10 | 9.4 ± 9.62 | 9.6 ± 9.1  |\n\nThe CO<sub>2</sub> emission factors for drained inland organic soils are provided by the [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Wetlands Supplement. All re-sampled values must be greater than 0, as no CO<sub>2</sub> removals were observed in the underlying data. No factors were provided for subtropical climate zones (Warm temperate eco-climate zones); tropical values were used for these eco-climate zones to match N<sub>2</sub>O and CH<sub>4</sub> factor stratifications. Standard deviations have been recalculated using the 95% confidence interval and `n` data provided in the IPCC report.\n\nFactors are stratified by land-use category, climate domain and nutrient status. Nutrient-rich grassland is further stratified into shallow-drained and deep-drained. Where data is not available to classify Sites by nutrient status or drainage depth, default categories are suggested based on climate domains. Because there is no information on nutrient status nor drainage depth available on HESTIA, the model uses the default values presented below:\n\n**Default nutrient status**\n\n| Climate domain | Nutrient status |\n| -------------- | --------------- |\n| Boreal         | Nutrient-poor   |\n| Temperate      | Nutrient-rich   |\n| Subtropical    | Nutrient-rich   |\n| Tropical       | n/a             |\n\n**Default drainage depth**\n\n| Climate domain | Drainage depth |\n| -------------- | -------------- |\n| Boreal         | Deep           |\n| Temperate      | Deep           |\n| Subtropical    | n/a            |\n| Tropical       | n/a            |\n\n### Step 4. Calculate the CO<sub>2</sub> emission\n\nThe model multiplies the CO<sub>2</sub> emission factor by the percentage of the Site's land under organic soil and the land occupation value.\n\n### Step 5. Assign an emission tier\n\nCO<sub>2</sub> emissions from organic soil cultivation are given the `methodTier` of `tier 1`, which corresponds to the model tier according to the [IPCC (2019) report](https://www.ipcc-nggip.iges.or.jp/public/2019rf/vol4.html).\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/co2ToAirOrganicSoilCultivation\">co2ToAirOrganicSoilCultivation</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/ipcc2019\">ipcc2019</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#sd\">sd</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#min\">min</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#max\">max</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#observations\">observations</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#statsDefinition\">statsDefinition</a> with <code>simulated</code></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> with <code>forest</code> <strong>or</strong> <code>other natural vegetation</code> <strong>or</strong> <code>cropland</code> <strong>or</strong> <code>glass or high accessible cover</code> <strong>or</strong> <code>permanent pasture</code> and a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/organicSoils\">organicSoils</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/ecoClimateZone\">ecoClimateZone</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li>either:<ul>\n<li>the following fields:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a></li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#practices\">practices</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/longFallowRatio\">longFallowRatio</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li>for plantations, additional properties are required:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#practices\">practices</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/nurseryDensity\">nurseryDensity</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/nurseryDuration\">nurseryDuration</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/plantationProductiveLifespan\">plantationProductiveLifespan</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/plantationDensity\">plantationDensity</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/plantationLifespan\">plantationLifespan</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/rotationDuration\">rotationDuration</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n<li>optional:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/crop.csv\">crop.csv</a> -&gt; <code>isPlantation</code>; <code>IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/forage.csv\">forage.csv</a> -&gt; <code>isPlantation</code>; <code>IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/ecoClimateZone.csv\">ecoClimateZone.csv</a> -&gt; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_ANNUAL_CROPS</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_PERENNIAL_CROPS</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_ACACIA</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_OIL_PALM</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_SAGO_PALM</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_PADDY_RICE_CULTIVATION</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_GRASSLAND</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_CO2-C_HECTARE_OTHER</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>siteTypesAllowed</code>; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}

package/dist/content/models/cycleEmissions/organicSoil/n2OToAirOrganicSoilCultivationDirect/content.json

@@ -1 +1 @@
-{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Organic Soil"],"tab":["IPCC (2019)"]},"content":"## N2O, to air, organic soil cultivation, direct\n\nNitrous oxide direct emissions to air, from organic soil (histosol) drainage and cultivation.\n\n## Overview\n\nFollowing the [IPCC (2019)](https://www.ipcc-nggip.iges.or.jp/public/2019rf/vol4.html) and [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Tier 1 guidelines, this model calculates the annual N<sub>2</sub>O emissions from the drainage and cultivation of organic soils and assigns them to [Cycles](https://www.hestia.earth/schema/Cycle) taking place during those years.\n\nOnly N<sub>2</sub>O emissions from the drainage and cultivation of organic soils are estimated by this model. N<sub>2</sub>O emissions from the burning of organic soils during deforestation or other land conversion events should be calculated otherwise.\n\nThe model is **not** run as a Monte Carlo simulation; instead, the uncertainty is propagated to the model results by multiplying the `sd` by the Cycle's land occupation factor.\n\n## How the model works\n\nThe model works by retrieving the percentage of the Cycle's associated Site under organic soils, the Cycle's land occupation, the Cycle's associated Site's eco-climate zone, and the Cycle's primary product category. Emissions from the drainage and cultivation of organic soils are estimated using emission factors provided in the [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Wetlands Supplement report.\n\n### Step 1. Retrieve required data from the Cycle and associated Site\n\nFrom the Cycle's associated Site, we retrieve:\n- the Site's `ecoClimateZone`\n- the percentage of the Site under organic soil\n- the Site's `siteType`\n\nOnly the `soilType` term `histosol` is used to estimate the percentage of a Site under organic soil; this is because this term is being gap-filled by the platform, which means that most Sites will have a value for it. See our guide on [Histosol gap-filling](/guide/histosol#Geospatial%20Database) for more information.\n\nFrom the Cycle, we retrieve the Cycle's primary Product. \n\nThe Cycle's land occupation is then calculated to determine how much of the Site's modelled land is actually occupied by the Cycle.\n\n### Step 2. Classify the primary Product\n\nIf the Cycle's associated Site has a `termType` = `cropland`, then, using the value of the primary Product term in the `IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY` lookup in the `crop` and `forage` glossaries, an organic soil cultivation category is assigned to the Cycle. This information will be used to retrieve land-use specific emission factors.\n\nIf the Cycle's associated Site has a `termType` = `permanent pasture`, then the organic soil cultivation category of `Grassland` is directly assigned to the Cycle.\n\nThe different organic soil cultivation categories are:\n\n|siteType|Organic soil cultivation category|\n|---|---|\n|cropland|Annual cropland|\n|cropland|Perennial cropland|\n|cropland|Acacia|\n|cropland|Oil palm|\n|cropland|Sago palm|\n|cropland|Rice|\n|permanent pasture|Grassland|\n\n### Step 3. Retrieve the N<sub>2</sub>O emission factor\n\nUsing the Cycle's eco-climate zone and assigned organic soil cultivation category, the N<sub>2</sub>O emission factor is retrieved from the `ecoClimateZone` lookup.\n\n**N<sub>2</sub>O emission factors (kg N<sub>2</sub>O ha<sup>-1</sup> y<sup>-1</sup>)**\n\n|ecoClimateZone|Annual cropland|Perennial cropland|Oil palm|Sago palm|Rice|Grassland|\n|---|---|---|---|---|---|---|\n|Warm temperate moist|5 ± 3.23|5 ± 3.23|1.2|3.3|0.4 ± 0.43|5 ± 3.23|\n|Warm temperate dry|5 ± 3.23|5 ± 3.23|1.2|3.3|0.4 ± 0.43|5 ± 3.23|\n|Cool temperate moist|13 ± 14.48|13 ± 14.48|-|-|0.4 ± 0.43|8.2 ± 10.39|\n|Cool temperate dry|13 ± 14.48|13 ± 14.48|-|-|0.4 ± 0.43|8.2 ± 10.39|\n|Polar moist|-|-|-|-|-|-|\n|Polar dry|-|-|-|-|-|-|\n|Boreal moist|13 ± 14.48|13 ± 14.48|-|-|-|9.5 ± 8.82|\n|Boreal dry|13 ± 14.48|13 ± 14.48|-|-|-|9.5 ± 8.82|\n|Tropical montane|5 ± 3.23|5 ± 3.23|1.2|3.3|0.4 ± 0.43|5 ± 3.23|\n|Tropical wet|5 ± 3.23|5 ± 3.23|1.2|3.3|0.4 ± 0.43|5 ± 3.23|\n|Tropical moist|5 ± 3.23|5 ± 3.23|1.2|3.3|0.4 ± 0.43|5 ± 3.23|\n|Tropical dry|5 ± 3.23|5 ± 3.23|1.2|3.3|0.4 ± 0.43|5 ± 3.23|\n\nThe N<sub>2</sub>O emission factors for drained inland organic soils are provided by the [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Wetlands Supplement. Standard deviations have been recalculated using the 95% confidence interval and `n` data provided in the IPCC report.\n\nFactors are stratified by land-use category, climate domain and nutrient status. Nutrient-rich grassland is further stratified into shallow-drained and deep-drained. Where data is not available to classify Sites by nutrient status or drainage depth, default categories are suggested based on climate domains. Because there is no information on nutrient status nor drainage depth available on HESTIA, the model uses the default values presented below:\n\n**Default nutrient status**\n\n|Climate domain|Nutrient status|\n|---|---|\n|Boreal|Nutrient-poor|\n|Temperate|Nutrient-rich|\n|Subtropical|Nutrient-rich|\n|Tropical|n/a|\n\n**Default drainage depth**\n\n|Climate domain|Drainage depth|\n|---|---|\n|Boreal|Deep|\n|Temperate|Deep|\n|Subtropical|n/a|\n|Tropical|n/a|\n\n### Step 4. Calculate the N<sub>2</sub>O emission\n\nThe model multiplies the N<sub>2</sub>O emission factor by the percentage of the Site's land under organic soil and the land occupation value.\n\n### Step 5. Assign an emission tier\n\nN<sub>2</sub>O emissions from organic soil cultivation are given the `methodTier` of `tier 1`, which corresponds to the model tier according to the [IPCC (2019) report](https://www.ipcc-nggip.iges.or.jp/public/2019rf/vol4.html).\n\n## Discussion\n\nWe plan to extend the model so it runs with the `usdaSoilType` term `histosols` and all its subclasses as well as with all the subclasses of the `soilType` term `histosol`, in addition to simply with the `soilType` term `histosol`. This will increase the instances for which the model will be able to run based on users' input data.\n\nWe will also release a new model calculating N<sub>2</sub>O emissions from organic soil burning during deforestation or other land-use changes, which will make our coverage of organic soil-related emissions more exhaustive.\n\n\n\n\n"}
+{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Organic Soil"],"tab":["IPCC (2019)"]},"content":"## N2O, to air, organic soil cultivation, direct\n\nNitrous oxide direct emissions to air, from organic soil (histosol) drainage and cultivation.\n\n## Overview\n\nFollowing the [IPCC (2019)](https://www.ipcc-nggip.iges.or.jp/public/2019rf/vol4.html) and [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Tier 1 guidelines, this model calculates the annual N<sub>2</sub>O emissions from the drainage and cultivation of organic soils and assigns them to [Cycles](/schema/Cycle) taking place during those years.\n\nOnly N<sub>2</sub>O emissions from the drainage and cultivation of organic soils are estimated by this model. N<sub>2</sub>O emissions from the burning of organic soils during deforestation or other land conversion events should be calculated otherwise.\n\nThe model is **not** run as a Monte Carlo simulation; instead, the uncertainty is propagated to the model results by multiplying the `sd` by the Cycle's land occupation factor.\n\n## How the model works\n\nThe model works by retrieving the percentage of the Cycle's associated Site under organic soils, the Cycle's land occupation, the Cycle's associated Site's eco-climate zone, and the Cycle's primary product category. Emissions from the drainage and cultivation of organic soils are estimated using emission factors provided in the [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Wetlands Supplement report.\n\n### Step 1. Retrieve required data from the Cycle and associated Site\n\nFrom the Cycle's associated Site, we retrieve:\n- the Site's `ecoClimateZone`\n- the percentage of the Site under organic soil\n- the Site's `siteType`\n\nOnly the `soilType` term `histosol` is used to estimate the percentage of a Site under organic soil; this is because this term is being gap-filled by the platform, which means that most Sites will have a value for it. See our guide on [Histosol gap-filling](/guide/histosol#Geospatial%20Database) for more information.\n\nFrom the Cycle, we retrieve the Cycle's primary Product.\n\nThe Cycle's land occupation is then calculated to determine how much of the Site's modelled land is actually occupied by the Cycle.\n\n### Step 2. Classify the primary Product\n\nIf the Cycle's associated Site has a `termType` = `cropland`, then, using the value of the primary Product term in the `IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY` lookup in the `crop` and `forage` glossaries, an organic soil cultivation category is assigned to the Cycle. This information will be used to retrieve land-use specific emission factors.\n\nIf the Cycle's associated Site has a `termType` = `permanent pasture`, then the organic soil cultivation category of `Grassland` is directly assigned to the Cycle.\n\nThe different organic soil cultivation categories are:\n\n| siteType          | Organic soil cultivation category |\n| ----------------- | --------------------------------- |\n| cropland          | Annual cropland                   |\n| cropland          | Perennial cropland                |\n| cropland          | Acacia                            |\n| cropland          | Oil palm                          |\n| cropland          | Sago palm                         |\n| cropland          | Rice                              |\n| permanent pasture | Grassland                         |\n\n### Step 3. Retrieve the N<sub>2</sub>O emission factor\n\nUsing the Cycle's eco-climate zone and assigned organic soil cultivation category, the N<sub>2</sub>O emission factor is retrieved from the `ecoClimateZone` lookup.\n\n**N<sub>2</sub>O emission factors (kg N<sub>2</sub>O ha<sup>-1</sup> y<sup>-1</sup>)**\n\n| ecoClimateZone       | Annual cropland | Perennial cropland | Oil palm | Sago palm | Rice       | Grassland   |\n| -------------------- | --------------- | ------------------ | -------- | --------- | ---------- | ----------- |\n| Warm temperate moist | 5 ± 3.23        | 5 ± 3.23           | 1.2      | 3.3       | 0.4 ± 0.43 | 5 ± 3.23    |\n| Warm temperate dry   | 5 ± 3.23        | 5 ± 3.23           | 1.2      | 3.3       | 0.4 ± 0.43 | 5 ± 3.23    |\n| Cool temperate moist | 13 ± 14.48      | 13 ± 14.48         | -        | -         | 0.4 ± 0.43 | 8.2 ± 10.39 |\n| Cool temperate dry   | 13 ± 14.48      | 13 ± 14.48         | -        | -         | 0.4 ± 0.43 | 8.2 ± 10.39 |\n| Polar moist          | -               | -                  | -        | -         | -          | -           |\n| Polar dry            | -               | -                  | -        | -         | -          | -           |\n| Boreal moist         | 13 ± 14.48      | 13 ± 14.48         | -        | -         | -          | 9.5 ± 8.82  |\n| Boreal dry           | 13 ± 14.48      | 13 ± 14.48         | -        | -         | -          | 9.5 ± 8.82  |\n| Tropical montane     | 5 ± 3.23        | 5 ± 3.23           | 1.2      | 3.3       | 0.4 ± 0.43 | 5 ± 3.23    |\n| Tropical wet         | 5 ± 3.23        | 5 ± 3.23           | 1.2      | 3.3       | 0.4 ± 0.43 | 5 ± 3.23    |\n| Tropical moist       | 5 ± 3.23        | 5 ± 3.23           | 1.2      | 3.3       | 0.4 ± 0.43 | 5 ± 3.23    |\n| Tropical dry         | 5 ± 3.23        | 5 ± 3.23           | 1.2      | 3.3       | 0.4 ± 0.43 | 5 ± 3.23    |\n\nThe N<sub>2</sub>O emission factors for drained inland organic soils are provided by the [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Wetlands Supplement. Standard deviations have been recalculated using the 95% confidence interval and `n` data provided in the IPCC report.\n\nFactors are stratified by land-use category, climate domain and nutrient status. Nutrient-rich grassland is further stratified into shallow-drained and deep-drained. Where data is not available to classify Sites by nutrient status or drainage depth, default categories are suggested based on climate domains. Because there is no information on nutrient status nor drainage depth available on HESTIA, the model uses the default values presented below:\n\n**Default nutrient status**\n\n| Climate domain | Nutrient status |\n| -------------- | --------------- |\n| Boreal         | Nutrient-poor   |\n| Temperate      | Nutrient-rich   |\n| Subtropical    | Nutrient-rich   |\n| Tropical       | n/a             |\n\n**Default drainage depth**\n\n| Climate domain | Drainage depth |\n| -------------- | -------------- |\n| Boreal         | Deep           |\n| Temperate      | Deep           |\n| Subtropical    | n/a            |\n| Tropical       | n/a            |\n\n### Step 4. Calculate the N<sub>2</sub>O emission\n\nThe model multiplies the N<sub>2</sub>O emission factor by the percentage of the Site's land under organic soil and the land occupation value.\n\n### Step 5. Assign an emission tier\n\nN<sub>2</sub>O emissions from organic soil cultivation are given the `methodTier` of `tier 1`, which corresponds to the model tier according to the [IPCC (2019) report](https://www.ipcc-nggip.iges.or.jp/public/2019rf/vol4.html).\n\n\n\n\n"}

package/dist/content/models/cycleEmissions/organicSoil/n2OToAirOrganicSoilCultivationDirect/ipcc2019.json

@@ -1 +1 @@
-{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Organic Soil"],"tab":["IPCC (2019)"],"modelId":["n2OToAirOrganicSoilCultivationDirect"],"modelRequires":["longFallowRatio","nurseryDensity","nurseryDuration","plantationProductiveLifespan","plantationDensity","plantationLifespan","rotationDuration","histosol","ecoClimateZone"]},"content":"## N2O, to air, organic soil cultivation, direct\n\nNitrous oxide direct emissions to air, from organic soil (histosol) drainage and cultivation.\n\n## Overview\n\nFollowing the [IPCC (2019)](https://www.ipcc-nggip.iges.or.jp/public/2019rf/vol4.html) and [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Tier 1 guidelines, this model calculates the annual N<sub>2</sub>O emissions from the drainage and cultivation of organic soils and assigns them to [Cycles](https://www.hestia.earth/schema/Cycle) taking place during those years.\n\nOnly N<sub>2</sub>O emissions from the drainage and cultivation of organic soils are estimated by this model. N<sub>2</sub>O emissions from the burning of organic soils during deforestation or other land conversion events should be calculated otherwise.\n\nThe model is **not** run as a Monte Carlo simulation; instead, the uncertainty is propagated to the model results by multiplying the `sd` by the Cycle's land occupation factor.\n\n## How the model works\n\nThe model works by retrieving the percentage of the Cycle's associated Site under organic soils, the Cycle's land occupation, the Cycle's associated Site's eco-climate zone, and the Cycle's primary product category. Emissions from the drainage and cultivation of organic soils are estimated using emission factors provided in the [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Wetlands Supplement report.\n\n### Step 1. Retrieve required data from the Cycle and associated Site\n\nFrom the Cycle's associated Site, we retrieve:\n- the Site's `ecoClimateZone`\n- the percentage of the Site under organic soil\n- the Site's `siteType`\n\nOnly the `soilType` term `histosol` is used to estimate the percentage of a Site under organic soil; this is because this term is being gap-filled by the platform, which means that most Sites will have a value for it. See our guide on [Histosol gap-filling](/guide/histosol#Geospatial%20Database) for more information.\n\nFrom the Cycle, we retrieve the Cycle's primary Product. \n\nThe Cycle's land occupation is then calculated to determine how much of the Site's modelled land is actually occupied by the Cycle.\n\n### Step 2. Classify the primary Product\n\nIf the Cycle's associated Site has a `termType` = `cropland`, then, using the value of the primary Product term in the `IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY` lookup in the `crop` and `forage` glossaries, an organic soil cultivation category is assigned to the Cycle. This information will be used to retrieve land-use specific emission factors.\n\nIf the Cycle's associated Site has a `termType` = `permanent pasture`, then the organic soil cultivation category of `Grassland` is directly assigned to the Cycle.\n\nThe different organic soil cultivation categories are:\n\n|siteType|Organic soil cultivation category|\n|---|---|\n|cropland|Annual cropland|\n|cropland|Perennial cropland|\n|cropland|Acacia|\n|cropland|Oil palm|\n|cropland|Sago palm|\n|cropland|Rice|\n|permanent pasture|Grassland|\n\n### Step 3. Retrieve the N<sub>2</sub>O emission factor\n\nUsing the Cycle's eco-climate zone and assigned organic soil cultivation category, the N<sub>2</sub>O emission factor is retrieved from the `ecoClimateZone` lookup.\n\n**N<sub>2</sub>O emission factors (kg N<sub>2</sub>O ha<sup>-1</sup> y<sup>-1</sup>)**\n\n|ecoClimateZone|Annual cropland|Perennial cropland|Oil palm|Sago palm|Rice|Grassland|\n|---|---|---|---|---|---|---|\n|Warm temperate moist|5 ± 3.23|5 ± 3.23|1.2|3.3|0.4 ± 0.43|5 ± 3.23|\n|Warm temperate dry|5 ± 3.23|5 ± 3.23|1.2|3.3|0.4 ± 0.43|5 ± 3.23|\n|Cool temperate moist|13 ± 14.48|13 ± 14.48|-|-|0.4 ± 0.43|8.2 ± 10.39|\n|Cool temperate dry|13 ± 14.48|13 ± 14.48|-|-|0.4 ± 0.43|8.2 ± 10.39|\n|Polar moist|-|-|-|-|-|-|\n|Polar dry|-|-|-|-|-|-|\n|Boreal moist|13 ± 14.48|13 ± 14.48|-|-|-|9.5 ± 8.82|\n|Boreal dry|13 ± 14.48|13 ± 14.48|-|-|-|9.5 ± 8.82|\n|Tropical montane|5 ± 3.23|5 ± 3.23|1.2|3.3|0.4 ± 0.43|5 ± 3.23|\n|Tropical wet|5 ± 3.23|5 ± 3.23|1.2|3.3|0.4 ± 0.43|5 ± 3.23|\n|Tropical moist|5 ± 3.23|5 ± 3.23|1.2|3.3|0.4 ± 0.43|5 ± 3.23|\n|Tropical dry|5 ± 3.23|5 ± 3.23|1.2|3.3|0.4 ± 0.43|5 ± 3.23|\n\nThe N<sub>2</sub>O emission factors for drained inland organic soils are provided by the [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Wetlands Supplement. Standard deviations have been recalculated using the 95% confidence interval and `n` data provided in the IPCC report.\n\nFactors are stratified by land-use category, climate domain and nutrient status. Nutrient-rich grassland is further stratified into shallow-drained and deep-drained. Where data is not available to classify Sites by nutrient status or drainage depth, default categories are suggested based on climate domains. Because there is no information on nutrient status nor drainage depth available on HESTIA, the model uses the default values presented below:\n\n**Default nutrient status**\n\n|Climate domain|Nutrient status|\n|---|---|\n|Boreal|Nutrient-poor|\n|Temperate|Nutrient-rich|\n|Subtropical|Nutrient-rich|\n|Tropical|n/a|\n\n**Default drainage depth**\n\n|Climate domain|Drainage depth|\n|---|---|\n|Boreal|Deep|\n|Temperate|Deep|\n|Subtropical|n/a|\n|Tropical|n/a|\n\n### Step 4. Calculate the N<sub>2</sub>O emission\n\nThe model multiplies the N<sub>2</sub>O emission factor by the percentage of the Site's land under organic soil and the land occupation value.\n\n### Step 5. Assign an emission tier\n\nN<sub>2</sub>O emissions from organic soil cultivation are given the `methodTier` of `tier 1`, which corresponds to the model tier according to the [IPCC (2019) report](https://www.ipcc-nggip.iges.or.jp/public/2019rf/vol4.html).\n\n## Discussion\n\nWe plan to extend the model so it runs with the `usdaSoilType` term `histosols` and all its subclasses as well as with all the subclasses of the `soilType` term `histosol`, in addition to simply with the `soilType` term `histosol`. This will increase the instances for which the model will be able to run based on users' input data.\n\nWe will also release a new model calculating N<sub>2</sub>O emissions from organic soil burning during deforestation or other land-use changes, which will make our coverage of organic soil-related emissions more exhaustive.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/n2OToAirOrganicSoilCultivationDirect\">n2OToAirOrganicSoilCultivationDirect</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/ipcc2019\">ipcc2019</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#sd\">sd</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#statsDefinition\">statsDefinition</a> with <code>modelled</code></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> with <code>forest</code> <strong>or</strong> <code>other natural vegetation</code> <strong>or</strong> <code>cropland</code> <strong>or</strong> <code>glass or high accessible cover</code> <strong>or</strong> <code>permanent pasture</code> and a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/histosol\">histosol</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/ecoClimateZone\">ecoClimateZone</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li>either:<ul>\n<li>the following fields:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a></li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#practices\">practices</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/longFallowRatio\">longFallowRatio</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li>for plantations, additional properties are required:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#practices\">practices</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/nurseryDensity\">nurseryDensity</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/nurseryDuration\">nurseryDuration</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/plantationProductiveLifespan\">plantationProductiveLifespan</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/plantationDensity\">plantationDensity</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/plantationLifespan\">plantationLifespan</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/rotationDuration\">rotationDuration</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n<li>optional:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/crop.csv\">crop.csv</a> -&gt; <code>isPlantation</code>; <code>IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/forage.csv\">forage.csv</a> -&gt; <code>isPlantation</code>; <code>IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/ecoClimateZone.csv\">ecoClimateZone.csv</a> -&gt; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_ANNUAL_CROPS</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_PERENNIAL_CROPS</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_ACACIA</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_OIL_PALM</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_SAGO_PALM</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_PADDY_RICE_CULTIVATION</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_GRASSLAND</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_OTHER</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>siteTypesAllowed</code>; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}
+{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Organic Soil"],"tab":["IPCC (2019)"],"modelId":["n2OToAirOrganicSoilCultivationDirect"],"modelRequires":["longFallowRatio","nurseryDensity","nurseryDuration","plantationProductiveLifespan","plantationDensity","plantationLifespan","rotationDuration","organicSoils","ecoClimateZone"]},"content":"## N2O, to air, organic soil cultivation, direct\n\nNitrous oxide direct emissions to air, from organic soil (histosol) drainage and cultivation.\n\n## Overview\n\nFollowing the [IPCC (2019)](https://www.ipcc-nggip.iges.or.jp/public/2019rf/vol4.html) and [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Tier 1 guidelines, this model calculates the annual N<sub>2</sub>O emissions from the drainage and cultivation of organic soils and assigns them to [Cycles](/schema/Cycle) taking place during those years.\n\nOnly N<sub>2</sub>O emissions from the drainage and cultivation of organic soils are estimated by this model. N<sub>2</sub>O emissions from the burning of organic soils during deforestation or other land conversion events should be calculated otherwise.\n\nThe model is **not** run as a Monte Carlo simulation; instead, the uncertainty is propagated to the model results by multiplying the `sd` by the Cycle's land occupation factor.\n\n## How the model works\n\nThe model works by retrieving the percentage of the Cycle's associated Site under organic soils, the Cycle's land occupation, the Cycle's associated Site's eco-climate zone, and the Cycle's primary product category. Emissions from the drainage and cultivation of organic soils are estimated using emission factors provided in the [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Wetlands Supplement report.\n\n### Step 1. Retrieve required data from the Cycle and associated Site\n\nFrom the Cycle's associated Site, we retrieve:\n- the Site's `ecoClimateZone`\n- the percentage of the Site under organic soil\n- the Site's `siteType`\n\nOnly the `soilType` term `histosol` is used to estimate the percentage of a Site under organic soil; this is because this term is being gap-filled by the platform, which means that most Sites will have a value for it. See our guide on [Histosol gap-filling](/guide/histosol#Geospatial%20Database) for more information.\n\nFrom the Cycle, we retrieve the Cycle's primary Product.\n\nThe Cycle's land occupation is then calculated to determine how much of the Site's modelled land is actually occupied by the Cycle.\n\n### Step 2. Classify the primary Product\n\nIf the Cycle's associated Site has a `termType` = `cropland`, then, using the value of the primary Product term in the `IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY` lookup in the `crop` and `forage` glossaries, an organic soil cultivation category is assigned to the Cycle. This information will be used to retrieve land-use specific emission factors.\n\nIf the Cycle's associated Site has a `termType` = `permanent pasture`, then the organic soil cultivation category of `Grassland` is directly assigned to the Cycle.\n\nThe different organic soil cultivation categories are:\n\n| siteType          | Organic soil cultivation category |\n| ----------------- | --------------------------------- |\n| cropland          | Annual cropland                   |\n| cropland          | Perennial cropland                |\n| cropland          | Acacia                            |\n| cropland          | Oil palm                          |\n| cropland          | Sago palm                         |\n| cropland          | Rice                              |\n| permanent pasture | Grassland                         |\n\n### Step 3. Retrieve the N<sub>2</sub>O emission factor\n\nUsing the Cycle's eco-climate zone and assigned organic soil cultivation category, the N<sub>2</sub>O emission factor is retrieved from the `ecoClimateZone` lookup.\n\n**N<sub>2</sub>O emission factors (kg N<sub>2</sub>O ha<sup>-1</sup> y<sup>-1</sup>)**\n\n| ecoClimateZone       | Annual cropland | Perennial cropland | Oil palm | Sago palm | Rice       | Grassland   |\n| -------------------- | --------------- | ------------------ | -------- | --------- | ---------- | ----------- |\n| Warm temperate moist | 5 ± 3.23        | 5 ± 3.23           | 1.2      | 3.3       | 0.4 ± 0.43 | 5 ± 3.23    |\n| Warm temperate dry   | 5 ± 3.23        | 5 ± 3.23           | 1.2      | 3.3       | 0.4 ± 0.43 | 5 ± 3.23    |\n| Cool temperate moist | 13 ± 14.48      | 13 ± 14.48         | -        | -         | 0.4 ± 0.43 | 8.2 ± 10.39 |\n| Cool temperate dry   | 13 ± 14.48      | 13 ± 14.48         | -        | -         | 0.4 ± 0.43 | 8.2 ± 10.39 |\n| Polar moist          | -               | -                  | -        | -         | -          | -           |\n| Polar dry            | -               | -                  | -        | -         | -          | -           |\n| Boreal moist         | 13 ± 14.48      | 13 ± 14.48         | -        | -         | -          | 9.5 ± 8.82  |\n| Boreal dry           | 13 ± 14.48      | 13 ± 14.48         | -        | -         | -          | 9.5 ± 8.82  |\n| Tropical montane     | 5 ± 3.23        | 5 ± 3.23           | 1.2      | 3.3       | 0.4 ± 0.43 | 5 ± 3.23    |\n| Tropical wet         | 5 ± 3.23        | 5 ± 3.23           | 1.2      | 3.3       | 0.4 ± 0.43 | 5 ± 3.23    |\n| Tropical moist       | 5 ± 3.23        | 5 ± 3.23           | 1.2      | 3.3       | 0.4 ± 0.43 | 5 ± 3.23    |\n| Tropical dry         | 5 ± 3.23        | 5 ± 3.23           | 1.2      | 3.3       | 0.4 ± 0.43 | 5 ± 3.23    |\n\nThe N<sub>2</sub>O emission factors for drained inland organic soils are provided by the [IPCC (2013)](https://www.ipcc-nggip.iges.or.jp/public/wetlands/) Wetlands Supplement. Standard deviations have been recalculated using the 95% confidence interval and `n` data provided in the IPCC report.\n\nFactors are stratified by land-use category, climate domain and nutrient status. Nutrient-rich grassland is further stratified into shallow-drained and deep-drained. Where data is not available to classify Sites by nutrient status or drainage depth, default categories are suggested based on climate domains. Because there is no information on nutrient status nor drainage depth available on HESTIA, the model uses the default values presented below:\n\n**Default nutrient status**\n\n| Climate domain | Nutrient status |\n| -------------- | --------------- |\n| Boreal         | Nutrient-poor   |\n| Temperate      | Nutrient-rich   |\n| Subtropical    | Nutrient-rich   |\n| Tropical       | n/a             |\n\n**Default drainage depth**\n\n| Climate domain | Drainage depth |\n| -------------- | -------------- |\n| Boreal         | Deep           |\n| Temperate      | Deep           |\n| Subtropical    | n/a            |\n| Tropical       | n/a            |\n\n### Step 4. Calculate the N<sub>2</sub>O emission\n\nThe model multiplies the N<sub>2</sub>O emission factor by the percentage of the Site's land under organic soil and the land occupation value.\n\n### Step 5. Assign an emission tier\n\nN<sub>2</sub>O emissions from organic soil cultivation are given the `methodTier` of `tier 1`, which corresponds to the model tier according to the [IPCC (2019) report](https://www.ipcc-nggip.iges.or.jp/public/2019rf/vol4.html).\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/n2OToAirOrganicSoilCultivationDirect\">n2OToAirOrganicSoilCultivationDirect</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/ipcc2019\">ipcc2019</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#sd\">sd</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#statsDefinition\">statsDefinition</a> with <code>modelled</code></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> with <code>forest</code> <strong>or</strong> <code>other natural vegetation</code> <strong>or</strong> <code>cropland</code> <strong>or</strong> <code>glass or high accessible cover</code> <strong>or</strong> <code>permanent pasture</code> and a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/organicSoils\">organicSoils</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/ecoClimateZone\">ecoClimateZone</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li>either:<ul>\n<li>the following fields:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a></li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#practices\">practices</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/longFallowRatio\">longFallowRatio</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li>for plantations, additional properties are required:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#practices\">practices</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/nurseryDensity\">nurseryDensity</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/nurseryDuration\">nurseryDuration</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/plantationProductiveLifespan\">plantationProductiveLifespan</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/plantationDensity\">plantationDensity</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/plantationLifespan\">plantationLifespan</a></li>\n<li><a href=\"https://hestia.earth/schema/Practice#value\">value</a> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/rotationDuration\">rotationDuration</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n<li>optional:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/crop.csv\">crop.csv</a> -&gt; <code>isPlantation</code>; <code>IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/forage.csv\">forage.csv</a> -&gt; <code>isPlantation</code>; <code>IPCC_2013_ORGANIC_SOIL_CULTIVATION_CATEGORY</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/ecoClimateZone.csv\">ecoClimateZone.csv</a> -&gt; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_ANNUAL_CROPS</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_PERENNIAL_CROPS</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_ACACIA</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_OIL_PALM</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_SAGO_PALM</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_PADDY_RICE_CULTIVATION</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_GRASSLAND</code>; <code>IPCC_2013_ORGANIC_SOILS_TONNES_N2O-N_HECTARE_OTHER</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>siteTypesAllowed</code>; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}

package/dist/content/models/cycleEmissions/other/co2ToAirLimeNeutralisation/ipcc2019.json

@@ -0,0 +1 @@
+{"tags":{"author":["Guillaume Royer"],"contributor":["Joseph Poore"],"group":["Cycle: Emissions"],"subgroup":["Other"],"tab":["IPCC (2019)"],"modelId":["co2ToAirLimeNeutralisation"],"modelRequires":["soilAmendment"]},"content":"# CO2, to air, lime hydrolysis\n\n\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/co2ToAirLimeNeutralisation\">co2ToAirLimeNeutralisation</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/ipcc2019\">ipcc2019</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>Data completeness assessment for soilAmendment: <a href=\"https://hestia.earth/schema/Completeness#soilAmendment\">completeness.soilAmendment</a></li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a> and <a href=\"https://hestia.earth/schema/Input#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=soilAmendment\">soilAmendment</a> and <a href=\"https://hestia.earth/schema/Input#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#units\">units</a> = <code>kg CaCO3</code> <strong>or</strong> <code>kg CaMg(CO3)2</code></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  \n  \n</div>"}

package/dist/content/models/cycleEmissions/other/nErosionSoilFlux/schererPfister2015.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"contributor":["Joseph Poore"],"group":["Cycle: Emissions"],"subgroup":["Other"],"tab":["Scherer Pfister (2015)"],"modelId":["nErosionSoilFlux"],"modelRequires":["precipitationAnnual","nutrientLossToAquaticEnvironment","heavyWinterPrecipitation","totalNitrogenPerKgSoil","erodibility","slopeLength","slope"]},"content":"# N, erosion, soil flux\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/nErosionSoilFlux\">nErosionSoilFlux</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/schererPfister2015\">schererPfister2015</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> with <code>forest</code> <strong>or</strong> <code>other natural vegetation</code> <strong>or</strong> <code>cropland</code> <strong>or</strong> <code>glass or high accessible cover</code> <strong>or</strong> <code>permanent pasture</code> and a <a href=\"https://hestia.earth/schema/Site#country\">country</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=region\">region</a> and a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:</li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/nutrientLossToAquaticEnvironment\">nutrientLossToAquaticEnvironment</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/heavyWinterPrecipitation\">heavyWinterPrecipitation</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/totalNitrogenPerKgSoil\">totalNitrogenPerKgSoil</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/erodibility\">erodibility</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/slopeLength\">slopeLength</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/slope\">slope</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li><a href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a></li>\n<li>either:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Input#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=water\">water</a></li>\n</ul>\n</li>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/precipitationAnnual\">precipitationAnnual</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/region.csv\">region.csv</a> -&gt; <code>P_EF_C1</code>; <code>EF_P_C2</code>; <code>Practice_Factor</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/tillage.csv\">tillage.csv</a> -&gt; <code>C2_FACTORS</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/organicFertiliser.csv\">organicFertiliser.csv</a> -&gt; <code>OrganicFertiliserClassification</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>siteTypesAllowed</code>; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}
+{"tags":{"author":["Guillaume Royer"],"contributor":["Joseph Poore"],"group":["Cycle: Emissions"],"subgroup":["Other"],"tab":["Scherer Pfister (2015)"],"modelId":["nErosionSoilFlux"],"modelRequires":["precipitationAnnual","nutrientLossToAquaticEnvironment","heavyWinterPrecipitation","totalNitrogenPerKgSoil","erodibility","slopeLength","slope"]},"content":"# N, erosion, soil flux\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/nErosionSoilFlux\">nErosionSoilFlux</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/schererPfister2015\">schererPfister2015</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> with <code>forest</code> <strong>or</strong> <code>other natural vegetation</code> <strong>or</strong> <code>cropland</code> <strong>or</strong> <code>glass or high accessible cover</code> <strong>or</strong> <code>permanent pasture</code> and a <a href=\"https://hestia.earth/schema/Site#country\">country</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=region\">region</a> and a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:</li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/nutrientLossToAquaticEnvironment\">nutrientLossToAquaticEnvironment</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/heavyWinterPrecipitation\">heavyWinterPrecipitation</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/totalNitrogenPerKgSoil\">totalNitrogenPerKgSoil</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/erodibility\">erodibility</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/slopeLength\">slopeLength</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/slope\">slope</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li><a href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a></li>\n<li>either:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Input#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=water\">water</a></li>\n</ul>\n</li>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/precipitationAnnual\">precipitationAnnual</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/region.csv\">region.csv</a> -&gt; <code>P_EF_C1</code>; <code>EF_P_C2</code>; <code>Practice_Factor</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/tillage.csv\">tillage.csv</a> -&gt; <code>C2_FACTORS</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/organicFertiliser.csv\">organicFertiliser.csv</a> -&gt; <code>OrganicFertiliserClassification</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>siteTypesAllowed</code>; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}

package/dist/content/models/cycleEmissions/other/pErosionSoilFlux/schererPfister2015.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"contributor":["Joseph Poore"],"group":["Cycle: Emissions"],"subgroup":["Other"],"tab":["Scherer Pfister (2015)"],"modelId":["pErosionSoilFlux"],"modelRequires":["precipitationAnnual","nutrientLossToAquaticEnvironment","heavyWinterPrecipitation","totalPhosphorusPerKgSoil","erodibility","slopeLength","slope"]},"content":"# P, erosion, soil flux\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/pErosionSoilFlux\">pErosionSoilFlux</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/schererPfister2015\">schererPfister2015</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> with <code>forest</code> <strong>or</strong> <code>other natural vegetation</code> <strong>or</strong> <code>cropland</code> <strong>or</strong> <code>glass or high accessible cover</code> <strong>or</strong> <code>permanent pasture</code> and a <a href=\"https://hestia.earth/schema/Site#country\">country</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=region\">region</a> and a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:</li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/nutrientLossToAquaticEnvironment\">nutrientLossToAquaticEnvironment</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/heavyWinterPrecipitation\">heavyWinterPrecipitation</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/totalPhosphorusPerKgSoil\">totalPhosphorusPerKgSoil</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/erodibility\">erodibility</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/slopeLength\">slopeLength</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/slope\">slope</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li><a href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a></li>\n<li>either:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Input#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=water\">water</a></li>\n</ul>\n</li>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/precipitationAnnual\">precipitationAnnual</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/region.csv\">region.csv</a> -&gt; <code>P_EF_C1</code>; <code>EF_P_C2</code>; <code>Practice_Factor</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/tillage.csv\">tillage.csv</a> -&gt; <code>C2_FACTORS</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/organicFertiliser.csv\">organicFertiliser.csv</a> -&gt; <code>OrganicFertiliserClassification</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>siteTypesAllowed</code>; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}
+{"tags":{"author":["Guillaume Royer"],"contributor":["Joseph Poore"],"group":["Cycle: Emissions"],"subgroup":["Other"],"tab":["Scherer Pfister (2015)"],"modelId":["pErosionSoilFlux"],"modelRequires":["precipitationAnnual","nutrientLossToAquaticEnvironment","heavyWinterPrecipitation","totalPhosphorusPerKgSoil","erodibility","slopeLength","slope"]},"content":"# P, erosion, soil flux\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/pErosionSoilFlux\">pErosionSoilFlux</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/schererPfister2015\">schererPfister2015</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> with <code>forest</code> <strong>or</strong> <code>other natural vegetation</code> <strong>or</strong> <code>cropland</code> <strong>or</strong> <code>glass or high accessible cover</code> <strong>or</strong> <code>permanent pasture</code> and a <a href=\"https://hestia.earth/schema/Site#country\">country</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=region\">region</a> and a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:</li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/nutrientLossToAquaticEnvironment\">nutrientLossToAquaticEnvironment</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/heavyWinterPrecipitation\">heavyWinterPrecipitation</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/totalPhosphorusPerKgSoil\">totalPhosphorusPerKgSoil</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/erodibility\">erodibility</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/slopeLength\">slopeLength</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/slope\">slope</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li><a href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a></li>\n<li>either:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Input#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=water\">water</a></li>\n</ul>\n</li>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> <code>&gt;= 0</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/precipitationAnnual\">precipitationAnnual</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/region.csv\">region.csv</a> -&gt; <code>P_EF_C1</code>; <code>EF_P_C2</code>; <code>Practice_Factor</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/tillage.csv\">tillage.csv</a> -&gt; <code>C2_FACTORS</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/organicFertiliser.csv\">organicFertiliser.csv</a> -&gt; <code>OrganicFertiliserClassification</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>siteTypesAllowed</code>; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}

package/dist/content/models/cycleEmissions/pesticide/content.json

@@ -0,0 +1 @@
+{"tags":{},"content":"# Pesticide"}

package/dist/content/models/cycleEmissions/pesticide/pesticideToAirPesticideApplication/content.json

@@ -0,0 +1 @@
+{"tags":{"author":["Juliet Telfer","Guillaume Royer"],"group":["Cycle: Emissions"],"subgroup":["Pesticide"],"tab":["PEFCR Guidance Document (2017)"]},"content":"## Pesticide, to air, pesticide application\n\nPesticide emissions shall be modelled as specific active ingredients.\n\nThe USEtox life cycle impact assessment method has a build in multimedia fate model which simulates the fate of the pesticides starting from the different emission compartments. Therefore, default emission fractions to environmental emission compartments are needed in the LCI modelling (Rosenbaum et al., 2015). As temporary approach, the pesticides applied on the field shall be modelled as 90% emitted to the agricultural soil compartment, 9% emitted to air and 1% emitted to water (based on expert judgement due to current limitations). More specific data might be used if available.\n\nA robust model to assess the link between the amount applied on the field and the amount ending up in the emission compartment is still missing today. The PESTLCI model might fill in this gap in the future, but is currently still under testing.\n\n\n\n\n\n"}

package/dist/content/models/cycleEmissions/pesticide/pesticideToAirPesticideApplication/pefcrGuidanceDocument2017.json

@@ -0,0 +1 @@
+{"tags":{"author":["Juliet Telfer","Guillaume Royer"],"group":["Cycle: Emissions"],"subgroup":["Pesticide"],"tab":["PEFCR Guidance Document (2017)"],"modelId":["pesticideToAirPesticideApplication"]},"content":"## Pesticide, to air, pesticide application\n\nPesticide emissions shall be modelled as specific active ingredients.\n\nThe USEtox life cycle impact assessment method has a build in multimedia fate model which simulates the fate of the pesticides starting from the different emission compartments. Therefore, default emission fractions to environmental emission compartments are needed in the LCI modelling (Rosenbaum et al., 2015). As temporary approach, the pesticides applied on the field shall be modelled as 90% emitted to the agricultural soil compartment, 9% emitted to air and 1% emitted to water (based on expert judgement due to current limitations). More specific data might be used if available.\n\nA robust model to assess the link between the amount applied on the field and the amount ending up in the emission compartment is still missing today. The PESTLCI model might fill in this gap in the future, but is currently still under testing.\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/pesticideToAirPesticideApplication\">pesticideToAirPesticideApplication</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/pefcrGuidanceDocument2017\">pefcrGuidanceDocument2017</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#key\">key</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=pesticideAI\">pesticideAI</a> <strong>or</strong> <a href=\"https://hestia.earth/glossary?termType=pesticideBrandName\">pesticideBrandName</a> and <a href=\"https://hestia.earth/schema/Input#value\">value</a> <code>&gt; 0</code></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}

package/dist/content/models/cycleEmissions/pesticide/pesticideToSoilPesticideApplication/content.json

@@ -0,0 +1 @@
+{"tags":{"author":["Juliet Telfer","Guillaume Royer"],"group":["Cycle: Emissions"],"subgroup":["Pesticide"],"tab":["PEFCR Guidance Document (2017)"]},"content":"## Pesticide, to soil, pesticide application\n\nPesticide emissions shall be modelled as specific active ingredients.\n\nThe USEtox life cycle impact assessment method has a build in multimedia fate model which simulates the fate of the pesticides starting from the different emission compartments. Therefore, default emission fractions to environmental emission compartments are needed in the LCI modelling (Rosenbaum et al., 2015). As temporary approach, the pesticides applied on the field shall be modelled as 90% emitted to the agricultural soil compartment, 9% emitted to air and 1% emitted to water (based on expert judgement due to current limitations). More specific data might be used if available.\n\nA robust model to assess the link between the amount applied on the field and the amount ending up in the emission compartment is still missing today. The PESTLCI model might fill in this gap in the future, but is currently still under testing.\n\n\n\n\n\n"}

package/dist/content/models/cycleEmissions/pesticide/pesticideToSoilPesticideApplication/pefcrGuidanceDocument2017.json

@@ -0,0 +1 @@
+{"tags":{"author":["Juliet Telfer","Guillaume Royer"],"group":["Cycle: Emissions"],"subgroup":["Pesticide"],"tab":["PEFCR Guidance Document (2017)"],"modelId":["pesticideToSoilPesticideApplication"]},"content":"## Pesticide, to soil, pesticide application\n\nPesticide emissions shall be modelled as specific active ingredients.\n\nThe USEtox life cycle impact assessment method has a build in multimedia fate model which simulates the fate of the pesticides starting from the different emission compartments. Therefore, default emission fractions to environmental emission compartments are needed in the LCI modelling (Rosenbaum et al., 2015). As temporary approach, the pesticides applied on the field shall be modelled as 90% emitted to the agricultural soil compartment, 9% emitted to air and 1% emitted to water (based on expert judgement due to current limitations). More specific data might be used if available.\n\nA robust model to assess the link between the amount applied on the field and the amount ending up in the emission compartment is still missing today. The PESTLCI model might fill in this gap in the future, but is currently still under testing.\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/pesticideToSoilPesticideApplication\">pesticideToSoilPesticideApplication</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/pefcrGuidanceDocument2017\">pefcrGuidanceDocument2017</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#key\">key</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=pesticideAI\">pesticideAI</a> <strong>or</strong> <a href=\"https://hestia.earth/glossary?termType=pesticideBrandName\">pesticideBrandName</a> and <a href=\"https://hestia.earth/schema/Input#value\">value</a> <code>&gt; 0</code></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}

package/dist/content/models/cycleEmissions/pesticide/pesticideToWaterPesticideApplication/content.json

@@ -0,0 +1 @@
+{"tags":{"author":["Juliet Telfer","Guillaume Royer"],"group":["Cycle: Emissions"],"subgroup":["Pesticide"],"tab":["PEFCR Guidance Document (2017)"]},"content":"## Pesticide, to water, pesticide application\n\nPesticide emissions shall be modelled as specific active ingredients.\n\nThe USEtox life cycle impact assessment method has a build in multimedia fate model which simulates the fate of the pesticides starting from the different emission compartments. Therefore, default emission fractions to environmental emission compartments are needed in the LCI modelling (Rosenbaum et al., 2015). As temporary approach, the pesticides applied on the field shall be modelled as 90% emitted to the agricultural soil compartment, 9% emitted to air and 1% emitted to water (based on expert judgement due to current limitations). More specific data might be used if available.\n\nA robust model to assess the link between the amount applied on the field and the amount ending up in the emission compartment is still missing today. The PESTLCI model might fill in this gap in the future, but is currently still under testing.\n\n\n\n\n\n"}

package/dist/content/models/cycleEmissions/pesticide/pesticideToWaterPesticideApplication/pefcrGuidanceDocument2017.json

@@ -0,0 +1 @@
+{"tags":{"author":["Juliet Telfer","Guillaume Royer"],"group":["Cycle: Emissions"],"subgroup":["Pesticide"],"tab":["PEFCR Guidance Document (2017)"],"modelId":["pesticideToWaterPesticideApplication"]},"content":"## Pesticide, to water, pesticide application\n\nPesticide emissions shall be modelled as specific active ingredients.\n\nThe USEtox life cycle impact assessment method has a build in multimedia fate model which simulates the fate of the pesticides starting from the different emission compartments. Therefore, default emission fractions to environmental emission compartments are needed in the LCI modelling (Rosenbaum et al., 2015). As temporary approach, the pesticides applied on the field shall be modelled as 90% emitted to the agricultural soil compartment, 9% emitted to air and 1% emitted to water (based on expert judgement due to current limitations). More specific data might be used if available.\n\nA robust model to assess the link between the amount applied on the field and the amount ending up in the emission compartment is still missing today. The PESTLCI model might fill in this gap in the future, but is currently still under testing.\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/pesticideToWaterPesticideApplication\">pesticideToWaterPesticideApplication</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/pefcrGuidanceDocument2017\">pefcrGuidanceDocument2017</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#key\">key</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=pesticideAI\">pesticideAI</a> <strong>or</strong> <a href=\"https://hestia.earth/glossary?termType=pesticideBrandName\">pesticideBrandName</a> and <a href=\"https://hestia.earth/schema/Input#value\">value</a> <code>&gt; 0</code></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}

package/dist/content/models/cycleEmissions/soil/co2ToAirBiocharStockChange/content.json

@@ -1 +1 @@
-{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Soil"],"tab":["IPCC (2019)"],"citation":["Payen, F. (2025) Biochar organic carbon stock modelling on HESTIA."],"tag":["soc modelling"]},"content":"# CO2, to air, biochar stock change\n\nCarbon dioxide emissions to air, from biochar stock change. Biochar is a charcoal-like substance obtained by burning organic materials from agricultural and forestry wastes in a controlled process.\n\n## Overview\n\nThis model calculates the annual emissions from biochar organic carbon (`biocharOrganicCarbonPerHa`) stock changes and assigns them to Cycles that take place during those years.\n\nThe model is run as a Monte Carlo simulation with 10,000 iterations. Model result values are the row-wise `mean` of simulation results. See our guide on [Monte Carlo simulation](/guide/applying-models-monte-carlo) for more information\n\n## How the model works\n\n### Step 1. Build an annual inventory of biochar organic carbon stock measurements\n\nAn annual inventory of `biocharOrganicCarbonPerHa` [Measurement](https://www.hestia.earth/schema/Measurement) values is created. These values represent the amount of organic carbon stored in biochar the soil at the **end of each inventory year**.\n\n[Measurements](https://www.hestia.earth/schema/Measurement) are grouped by `methodClassification`. It is critical that different methods are **never mixed** when calculating changes in carbon stock, as this could lead to large and misleading differences. Instead, the model processes each `methodClassification` separately, and includes only the emissions calculated using the **strongest available method** in the final output.\n\nOnly [Measurements](https://www.hestia.earth/schema/Measurement) with specific `methodClassification` values are included. All others are ignored. The valid classifications, listed from strongest to weakest, are:\n\n- `on-site physical measurement`\n- `modelled using other measurements`\n- `tier 3 model`\n- `tier 2 model`\n- `tier 1 model`\n\nEach carbon stock value must correspond to the timestamp `YYYY-12-31T23:59:59` — the end of the inventory year. If no [Measurement](https://www.hestia.earth/schema/Measurement) exists for this exact time, the value is estimated using linear interpolation between the closest available measurements before and after the target date.\n\n| Year | `on-site physical measurement`<sup>\\*</sup> | `tier 1 model`<sup>\\*</sup> |\n| ---- | ------------------------------------------- | --------------------------- |\n| 2002 | 48000                                       | -                           |\n| 2003 | 47000                                       | -                           |\n| 2004 | 45000                                       | 52350                       |\n| 2005 | 44500                                       | 51125                       |\n| 2006 | 44000                                       | 49900                       |\n| 2007 | 43500                                       | -                           |\n\n<sup>\\*</sup>biochar organic carbon stock (kg C ha<sup>-1</sup>)\n\nIn this scenario, the values of the `on-site physical measurement` column will be retained because it is the stronger `methodClassification`. The values of the `tier 1 model` will be discarded.\n\n### Step 2. Resample stock values for Monte Carlo simulation\n\nTo run the model as a Monte Carlo simulation, we need to generate an array of random samples for the `biocharOrganicCarbonPerHa` stock in each inventory year. These samples are drawn from a normal distribution defined by the `value` (mean) and `sd` of each year.\n\nIdeally, we would re-use the full set of iteration results from the [`ipcc2019.biocharOrganicCarbonPerHa`](./biocharOrganicCarbonPerHa) model's Monto Carlo simulation. However, HESTIA nodes can only store row-wise summaries of Monte Carlo simulation results. This means the full iteration-level data is not available for use in downstream models, so we lose the correlation between years in each simulation run.\n\nTo maintain realistic, coherent simulation behaviour:\n\n- Within each simulation run (column): Values across years (rows) should be correlated. If year 0 is a high value, we expect subsequent years to also be relatively high\n- Across simulation runs (columns): Values should be independent from one another\n\nFor this, we need to generate our new random samples with correlation by treating the inventory as a time series, where:\n\n- Rows = time steps (years)\n- Columns = independent Monte Carlo runs\n\nTo model the correlation between years, we assume that similarity in stock values decreases with time. Closer years are more correlated than years further apart. This is modelled using exponential decay, with a half-life of 100 years (based on the IPCC's transition period for biochar carbon stock equilibrium).\n\nUsing this correlation structure, we generate samples from a multivariate normal distribution, ensuring temporal correlation within runs and independence between runs.\n\nSee the [Scipy Cookbook on Correlated Random Samples](https://scipy-cookbook.readthedocs.io/items/CorrelatedRandomSamples.html) for more information.\n\nCarbon stock values without a corresponding `sd` are given a nominal error of 75% ($2*{sd}$ as a percentage of the mean).\n\n### Step 3. Calculate the annual CO<sub>2</sub> emission (or removal) due to biochar organic carbon stock change\n\nNext, the carbon stock change and the associated CO<sub>2</sub> change can be calculated for each inventory year:\n\n$\\Delta CO_2 = -1 * (C_y - C\\_{y-1}) * \\frac{44.01}{12.012}$\n\nWhere:\n\n- $\\Delta CO_2$ = the CO<sub>2</sub> emission due to carbon stock change for year $y$, kg CO<sub>2</sub> ha<sup>-1</sup>.\n- $C_y$ = the carbon stock in year $y$, kg C ha<sup>-1</sup>.\n- $C_{y-1}$ = the carbon stock in year $y-1$x, kg C ha<sup>-1</sup>.\n- $\\frac{44.01}{12.012}$ = the ratio of the atomic mass of CO<sub>$2$</sub> to C.\n\n_n.b._, the value is multiplied by $-1$ as a reduction in carbon stock is associated with an emission of CO<sub>2</sub> and vice versa.\n\n| Year | C stock (kg C ha<sup>-1</sup>) | C stock change (kg C ha<sup>-1</sup>) | CO<sub>2</sub> emission (kg CO<sub>2</sub> ha<sup>-1</sup>) |\n| ---- | ------------------------------ | ------------------------------------- | ----------------------------------------------------------- |\n| 2002 | 48000                          | n/a                                   | n/a                                                         |\n| 2003 | 47000                          | -1000                                 | 3664                                                        |\n| 2004 | 45000                          | -2000                                 | 7328                                                        |\n| 2005 | 44500                          | -500                                  | 1832                                                        |\n| 2006 | 44000                          | -500                                  | 1832                                                        |\n| 2007 | 43500                          | -500                                  | 1832                                                        |\n\n### Step 4. Allocate the CO<sub>2</sub> emission to overlapping Cycles\n\n[Measurements](https://www.hestia.earth/schema/Measurement), such as `biocharOrganicCarbonPerHa`, are attached to [Site](https://www.hestia.earth/schema/Site) nodes. In the HESTIA schema, a single [Site](https://www.hestia.earth/schema/Site) can be linked to multiple [Cycle](https://www.hestia.earth/schema/Cycle) nodes. However, emission models are run **per [Cycle](https://www.hestia.earth/schema/Cycle)**.\n\nTo ensure emissions are correctly allocated, the `ipcc2019.co2ToAirBiocharStockChange` model gathers data from all [Cycles](https://www.hestia.earth/schema/Cycle) associated with the same [Site](https://www.hestia.earth/schema/Site).\n\nEmissions from changes in carbon stock should only be assigned to a [Cycle](https://www.hestia.earth/schema/Cycle) if that Cycle meaningfully overlaps with the inventory year in which the stock change occurred.\n\nIf multiple [Cycles](https://www.hestia.earth/schema/Cycle) overlap the same inventory year, the emission for that year is **shared proportionally** based on the number of overlapping days. For example:\n\n- `cycle-y` overlaps by 200 days\n- `cycle-z` overlaps by 100 days\n\nThen:\n\n- `cycle-y` receives **66.6%** of the emission\n- `cycle-z` receives **33.3%**\n\n_n.b._, The total share of emissions across all overlapping [Cycles](https://www.hestia.earth/schema/Cycle) **must always sum to 100%** to avoid under- or over-reporting.\n\n#### Emissions across multiple years\n\nIf a [Cycle](https://www.hestia.earth/schema/Cycle) overlaps with **multiple inventory years**, it should be assigned the **sum of its proportional shares** from each of those years.\n\n<div class=\"table-container is-responsive\">\n  <table class=\"table is-fullwidth is-hoverable is-striped\">\n    <tr>\n      <th>Year</th>\n      <th>\n        Total emission(kg CO<sub>2</sub> ha<sup>-1</sup>)\n      </th>\n      <th>Cycle ID</th>\n      <th>Share of emission (%)</th>\n      <th>\n        Cycle emission(kg CO<sub>2</sub> ha<sup>-1</sup>)\n      </th>\n    </tr>\n    <tr>\n      <td>2003</td>\n      <td>3664</td>\n      <td>\n        cycle-a0\n      </td>\n      <td>100</td>\n      <td>3664</td>\n    </tr>\n    <tr>\n      <td rowspan=\"2\">2004</td>\n      <td rowspan=\"2\">7328</td>\n      <td>\n        cycle-a1\n      </td>\n      <td>50</td>\n      <td>3664</td>\n    </tr>\n    <tr>\n      <td>\n        cycle-a2\n      </td>\n      <td>50</td>\n      <td>3664</td>\n    </tr>\n    <tr>\n      <td>2005</td>\n      <td>1832</td>\n      <td>\n        cycle-a3\n      </td>\n      <td>100</td>\n      <td>1832</td>\n    </tr>\n    <tr>\n      <td>2006</td>\n      <td>1832</td>\n      <td>\n        cycle-a3\n      </td>\n      <td>100</td>\n      <td>1832</td>\n    </tr>\n    <tr>\n      <td>2007</td>\n      <td>1832</td>\n      <td>\n        cycle-a3\n      </td>\n      <td>100</td>\n      <td>1832</td>\n    </tr>\n  </table>\n</div>\n\n| Cycle ID   | `co2ToAirBiocharStockChange`(kg CO<sub>2</sub> ha<sup>-1</sup>) |\n| ---------- | --------------------------------------------------------------- |\n| `cycle-a0` | 3664                                                            |\n| `cycle-a1` | 3664                                                            |\n| `cycle-a2` | 3664                                                            |\n| `cycle-a3` | 5496                                                            |\n\n### Step 5. Assign an emission tier\n\nThe `methodTier` assigned to the emission node on each [Cycle](https://www.hestia.earth/schema/Cycle) reflects the **weakest** measurement method used in its calculation.\n\nFor example, if a [Cycle](https://www.hestia.earth/schema/Cycle)'s final emission is calculated by summing together the emissions of two inventory years, where:\n\n- One year uses [Measurements](https://www.hestia.earth/schema/Measurement) with `methodClassification = tier 1 model`\n- The other year uses `methodClassification = tier 2 model`\n\nThe resulting `methodTier` will be `tier 1`, since it is the **weakest** method involved.\n\nThe mapping between Measurement `methodClassification` and Emission `methodTier` is:\n\n| Measurement `methodClassification`  | Emission `methodTier` |\n| ----------------------------------- | --------------------- |\n| `on-site physical measurement`      | `measured`            |\n| `modelled using other measurements` | `measured`            |\n| `tier 3 model`                      | `tier 3`              |\n| `tier 2 model`                      | `tier 2`              |\n| `tier 1 model`                      | `tier 1`              |\n\n\n\n\n\n\n"}
+{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Soil"],"tab":["IPCC (2019)"],"citation":["Payen, F. (2025) Biochar organic carbon stock modelling on HESTIA."],"tag":["soc modelling"]},"content":"# CO2, to air, biochar stock change\n\nCarbon dioxide emissions to air, from biochar stock change. Biochar is a charcoal-like substance obtained by burning organic materials from agricultural and forestry wastes in a controlled process.\n\n## Overview\n\nThis model calculates the annual emissions from biochar organic carbon (`biocharOrganicCarbonPerHa`) stock changes and assigns them to Cycles that take place during those years.\n\nThe model is run as a Monte Carlo simulation with 10,000 iterations. Model result values are the row-wise `mean` of simulation results. See our guide on [Monte Carlo simulation](/guide/models-applying-models-monte-carlo) for more information\n\n## How the model works\n\n### Step 1. Build an annual inventory of biochar organic carbon stock measurements\n\nAn annual inventory of `biocharOrganicCarbonPerHa` [Measurement](/schema/Measurement) values is created. These values represent the amount of organic carbon stored in biochar the soil at the **end of each inventory year**.\n\n[Measurements](/schema/Measurement) are grouped by `methodClassification`. It is critical that different methods are **never mixed** when calculating changes in carbon stock, as this could lead to large and misleading differences. Instead, the model processes each `methodClassification` separately, and includes only the emissions calculated using the **strongest available method** in the final output.\n\nOnly [Measurements](/schema/Measurement) with specific `methodClassification` values are included. All others are ignored. The valid classifications, listed from strongest to weakest, are:\n\n- `on-site physical measurement`\n- `modelled using other measurements`\n- `tier 3 model`\n- `tier 2 model`\n- `tier 1 model`\n\nEach carbon stock value must correspond to the timestamp `YYYY-12-31T23:59:59` — the end of the inventory year. If no [Measurement](/schema/Measurement) exists for this exact time, the value is estimated using linear interpolation between the closest available measurements before and after the target date.\n\n| Year | `on-site physical measurement`<sup>\\*</sup> | `tier 1 model`<sup>\\*</sup> |\n| ---- | ------------------------------------------- | --------------------------- |\n| 2002 | 48000                                       | -                           |\n| 2003 | 47000                                       | -                           |\n| 2004 | 45000                                       | 52350                       |\n| 2005 | 44500                                       | 51125                       |\n| 2006 | 44000                                       | 49900                       |\n| 2007 | 43500                                       | -                           |\n\n<sup>\\*</sup>biochar organic carbon stock (kg C ha<sup>-1</sup>)\n\nIn this scenario, the values of the `on-site physical measurement` column will be retained because it is the stronger `methodClassification`. The values of the `tier 1 model` will be discarded.\n\n### Step 2. Resample stock values for Monte Carlo simulation\n\nTo run the model as a Monte Carlo simulation, we need to generate an array of random samples for the `biocharOrganicCarbonPerHa` stock in each inventory year. These samples are drawn from a normal distribution defined by the `value` (mean) and `sd` of each year.\n\nIdeally, we would re-use the full set of iteration results from the [`ipcc2019.biocharOrganicCarbonPerHa`](./biocharOrganicCarbonPerHa) model's Monto Carlo simulation. However, HESTIA nodes can only store row-wise summaries of Monte Carlo simulation results. This means the full iteration-level data is not available for use in downstream models, so we lose the correlation between years in each simulation run.\n\nTo maintain realistic, coherent simulation behaviour:\n\n- Within each simulation run (column): Values across years (rows) should be correlated. If year 0 is a high value, we expect subsequent years to also be relatively high\n- Across simulation runs (columns): Values should be independent from one another\n\nFor this, we need to generate our new random samples with correlation by treating the inventory as a time series, where:\n\n- Rows = time steps (years)\n- Columns = independent Monte Carlo runs\n\nTo model the correlation between years, we assume that similarity in stock values decreases with time. Closer years are more correlated than years further apart. This is modelled using exponential decay, with a half-life of 100 years (based on the IPCC's transition period for biochar carbon stock equilibrium).\n\nUsing this correlation structure, we generate samples from a multivariate normal distribution, ensuring temporal correlation within runs and independence between runs.\n\nSee the [Scipy Cookbook on Correlated Random Samples](https://scipy-cookbook.readthedocs.io/items/CorrelatedRandomSamples.html) for more information.\n\nCarbon stock values without a corresponding `sd` are given a nominal error of 75% ($2*{sd}$ as a percentage of the mean).\n\n### Step 3. Calculate the annual CO<sub>2</sub> emission (or removal) due to biochar organic carbon stock change\n\nNext, the carbon stock change and the associated CO<sub>2</sub> change can be calculated for each inventory year:\n\n$\\Delta CO_2 = -1 * (C_y - C\\_{y-1}) * \\frac{44.01}{12.012}$\n\nWhere:\n\n- $\\Delta CO_2$ = the CO<sub>2</sub> emission due to carbon stock change for year $y$, kg CO<sub>2</sub> ha<sup>-1</sup>.\n- $C_y$ = the carbon stock in year $y$, kg C ha<sup>-1</sup>.\n- $C_{y-1}$ = the carbon stock in year $y-1$x, kg C ha<sup>-1</sup>.\n- $\\frac{44.01}{12.012}$ = the ratio of the atomic mass of CO<sub>$2$</sub> to C.\n\n_n.b._, the value is multiplied by $-1$ as a reduction in carbon stock is associated with an emission of CO<sub>2</sub> and vice versa.\n\n| Year | C stock (kg C ha<sup>-1</sup>) | C stock change (kg C ha<sup>-1</sup>) | CO<sub>2</sub> emission (kg CO<sub>2</sub> ha<sup>-1</sup>) |\n| ---- | ------------------------------ | ------------------------------------- | ----------------------------------------------------------- |\n| 2002 | 48000                          | n/a                                   | n/a                                                         |\n| 2003 | 47000                          | -1000                                 | 3664                                                        |\n| 2004 | 45000                          | -2000                                 | 7328                                                        |\n| 2005 | 44500                          | -500                                  | 1832                                                        |\n| 2006 | 44000                          | -500                                  | 1832                                                        |\n| 2007 | 43500                          | -500                                  | 1832                                                        |\n\n### Step 4. Allocate the CO<sub>2</sub> emission to overlapping Cycles\n\n[Measurements](/schema/Measurement), such as `biocharOrganicCarbonPerHa`, are attached to [Site](/schema/Site) nodes. In the HESTIA schema, a single [Site](/schema/Site) can be linked to multiple [Cycle](/schema/Cycle) nodes. However, emission models are run **per [Cycle](/schema/Cycle)**.\n\nTo ensure emissions are correctly allocated, the `ipcc2019.co2ToAirBiocharStockChange` model gathers data from all [Cycles](/schema/Cycle) associated with the same [Site](/schema/Site).\n\nEmissions from changes in carbon stock should only be assigned to a [Cycle](/schema/Cycle) if that Cycle meaningfully overlaps with the inventory year in which the stock change occurred.\n\nIf multiple [Cycles](/schema/Cycle) overlap the same inventory year, the emission for that year is **shared proportionally** based on the number of overlapping days. For example:\n\n- `cycle-y` overlaps by 200 days\n- `cycle-z` overlaps by 100 days\n\nThen:\n\n- `cycle-y` receives **66.6%** of the emission\n- `cycle-z` receives **33.3%**\n\n_n.b._, The total share of emissions across all overlapping [Cycles](/schema/Cycle) **must always sum to 100%** to avoid under- or over-reporting.\n\n#### Emissions across multiple years\n\nIf a [Cycle](/schema/Cycle) overlaps with **multiple inventory years**, it should be assigned the **sum of its proportional shares** from each of those years.\n\n<div class=\"table-container is-responsive\">\n  <table class=\"table is-fullwidth is-hoverable is-striped\">\n    <tr>\n      <th>Year</th>\n      <th>\n        Total emission(kg CO<sub>2</sub> ha<sup>-1</sup>)\n      </th>\n      <th>Cycle ID</th>\n      <th>Share of emission (%)</th>\n      <th>\n        Cycle emission(kg CO<sub>2</sub> ha<sup>-1</sup>)\n      </th>\n    </tr>\n    <tr>\n      <td>2003</td>\n      <td>3664</td>\n      <td>\n        cycle-a0\n      </td>\n      <td>100</td>\n      <td>3664</td>\n    </tr>\n    <tr>\n      <td rowspan=\"2\">2004</td>\n      <td rowspan=\"2\">7328</td>\n      <td>\n        cycle-a1\n      </td>\n      <td>50</td>\n      <td>3664</td>\n    </tr>\n    <tr>\n      <td>\n        cycle-a2\n      </td>\n      <td>50</td>\n      <td>3664</td>\n    </tr>\n    <tr>\n      <td>2005</td>\n      <td>1832</td>\n      <td>\n        cycle-a3\n      </td>\n      <td>100</td>\n      <td>1832</td>\n    </tr>\n    <tr>\n      <td>2006</td>\n      <td>1832</td>\n      <td>\n        cycle-a3\n      </td>\n      <td>100</td>\n      <td>1832</td>\n    </tr>\n    <tr>\n      <td>2007</td>\n      <td>1832</td>\n      <td>\n        cycle-a3\n      </td>\n      <td>100</td>\n      <td>1832</td>\n    </tr>\n  </table>\n</div>\n\n| Cycle ID   | `co2ToAirBiocharStockChange`(kg CO<sub>2</sub> ha<sup>-1</sup>) |\n| ---------- | --------------------------------------------------------------- |\n| `cycle-a0` | 3664                                                            |\n| `cycle-a1` | 3664                                                            |\n| `cycle-a2` | 3664                                                            |\n| `cycle-a3` | 5496                                                            |\n\n### Step 5. Assign an emission tier\n\nThe `methodTier` assigned to the emission node on each [Cycle](/schema/Cycle) reflects the **weakest** measurement method used in its calculation.\n\nFor example, if a [Cycle](/schema/Cycle)'s final emission is calculated by summing together the emissions of two inventory years, where:\n\n- One year uses [Measurements](/schema/Measurement) with `methodClassification = tier 1 model`\n- The other year uses `methodClassification = tier 2 model`\n\nThe resulting `methodTier` will be `tier 1`, since it is the **weakest** method involved.\n\nThe mapping between Measurement `methodClassification` and Emission `methodTier` is:\n\n| Measurement `methodClassification`  | Emission `methodTier` |\n| ----------------------------------- | --------------------- |\n| `on-site physical measurement`      | `measured`            |\n| `modelled using other measurements` | `measured`            |\n| `tier 3 model`                      | `tier 3`              |\n| `tier 2 model`                      | `tier 2`              |\n| `tier 1 model`                      | `tier 1`              |\n\n\n\n\n\n\n"}

package/dist/content/models/cycleEmissions/soil/co2ToAirBiocharStockChange/ipcc2019.json

@@ -1 +1 @@
-{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Soil"],"tab":["IPCC (2019)"],"citation":["Payen, F. (2025) Biochar organic carbon stock modelling on HESTIA."],"tag":["soc modelling"],"modelId":["co2ToAirBiocharStockChange"],"modelRequires":["biocharOrganicCarbonPerHa"]},"content":"# CO2, to air, biochar stock change\n\nCarbon dioxide emissions to air, from biochar stock change. Biochar is a charcoal-like substance obtained by burning organic materials from agricultural and forestry wastes in a controlled process.\n\n## Overview\n\nThis model calculates the annual emissions from biochar organic carbon (`biocharOrganicCarbonPerHa`) stock changes and assigns them to Cycles that take place during those years.\n\nThe model is run as a Monte Carlo simulation with 10,000 iterations. Model result values are the row-wise `mean` of simulation results. See our guide on [Monte Carlo simulation](/guide/applying-models-monte-carlo) for more information\n\n## How the model works\n\n### Step 1. Build an annual inventory of biochar organic carbon stock measurements\n\nAn annual inventory of `biocharOrganicCarbonPerHa` [Measurement](https://www.hestia.earth/schema/Measurement) values is created. These values represent the amount of organic carbon stored in biochar the soil at the **end of each inventory year**.\n\n[Measurements](https://www.hestia.earth/schema/Measurement) are grouped by `methodClassification`. It is critical that different methods are **never mixed** when calculating changes in carbon stock, as this could lead to large and misleading differences. Instead, the model processes each `methodClassification` separately, and includes only the emissions calculated using the **strongest available method** in the final output.\n\nOnly [Measurements](https://www.hestia.earth/schema/Measurement) with specific `methodClassification` values are included. All others are ignored. The valid classifications, listed from strongest to weakest, are:\n\n- `on-site physical measurement`\n- `modelled using other measurements`\n- `tier 3 model`\n- `tier 2 model`\n- `tier 1 model`\n\nEach carbon stock value must correspond to the timestamp `YYYY-12-31T23:59:59` — the end of the inventory year. If no [Measurement](https://www.hestia.earth/schema/Measurement) exists for this exact time, the value is estimated using linear interpolation between the closest available measurements before and after the target date.\n\n| Year | `on-site physical measurement`<sup>\\*</sup> | `tier 1 model`<sup>\\*</sup> |\n| ---- | ------------------------------------------- | --------------------------- |\n| 2002 | 48000                                       | -                           |\n| 2003 | 47000                                       | -                           |\n| 2004 | 45000                                       | 52350                       |\n| 2005 | 44500                                       | 51125                       |\n| 2006 | 44000                                       | 49900                       |\n| 2007 | 43500                                       | -                           |\n\n<sup>\\*</sup>biochar organic carbon stock (kg C ha<sup>-1</sup>)\n\nIn this scenario, the values of the `on-site physical measurement` column will be retained because it is the stronger `methodClassification`. The values of the `tier 1 model` will be discarded.\n\n### Step 2. Resample stock values for Monte Carlo simulation\n\nTo run the model as a Monte Carlo simulation, we need to generate an array of random samples for the `biocharOrganicCarbonPerHa` stock in each inventory year. These samples are drawn from a normal distribution defined by the `value` (mean) and `sd` of each year.\n\nIdeally, we would re-use the full set of iteration results from the [`ipcc2019.biocharOrganicCarbonPerHa`](./biocharOrganicCarbonPerHa) model's Monto Carlo simulation. However, HESTIA nodes can only store row-wise summaries of Monte Carlo simulation results. This means the full iteration-level data is not available for use in downstream models, so we lose the correlation between years in each simulation run.\n\nTo maintain realistic, coherent simulation behaviour:\n\n- Within each simulation run (column): Values across years (rows) should be correlated. If year 0 is a high value, we expect subsequent years to also be relatively high\n- Across simulation runs (columns): Values should be independent from one another\n\nFor this, we need to generate our new random samples with correlation by treating the inventory as a time series, where:\n\n- Rows = time steps (years)\n- Columns = independent Monte Carlo runs\n\nTo model the correlation between years, we assume that similarity in stock values decreases with time. Closer years are more correlated than years further apart. This is modelled using exponential decay, with a half-life of 100 years (based on the IPCC's transition period for biochar carbon stock equilibrium).\n\nUsing this correlation structure, we generate samples from a multivariate normal distribution, ensuring temporal correlation within runs and independence between runs.\n\nSee the [Scipy Cookbook on Correlated Random Samples](https://scipy-cookbook.readthedocs.io/items/CorrelatedRandomSamples.html) for more information.\n\nCarbon stock values without a corresponding `sd` are given a nominal error of 75% ($2*{sd}$ as a percentage of the mean).\n\n### Step 3. Calculate the annual CO<sub>2</sub> emission (or removal) due to biochar organic carbon stock change\n\nNext, the carbon stock change and the associated CO<sub>2</sub> change can be calculated for each inventory year:\n\n$\\Delta CO_2 = -1 * (C_y - C\\_{y-1}) * \\frac{44.01}{12.012}$\n\nWhere:\n\n- $\\Delta CO_2$ = the CO<sub>2</sub> emission due to carbon stock change for year $y$, kg CO<sub>2</sub> ha<sup>-1</sup>.\n- $C_y$ = the carbon stock in year $y$, kg C ha<sup>-1</sup>.\n- $C_{y-1}$ = the carbon stock in year $y-1$x, kg C ha<sup>-1</sup>.\n- $\\frac{44.01}{12.012}$ = the ratio of the atomic mass of CO<sub>$2$</sub> to C.\n\n_n.b._, the value is multiplied by $-1$ as a reduction in carbon stock is associated with an emission of CO<sub>2</sub> and vice versa.\n\n| Year | C stock (kg C ha<sup>-1</sup>) | C stock change (kg C ha<sup>-1</sup>) | CO<sub>2</sub> emission (kg CO<sub>2</sub> ha<sup>-1</sup>) |\n| ---- | ------------------------------ | ------------------------------------- | ----------------------------------------------------------- |\n| 2002 | 48000                          | n/a                                   | n/a                                                         |\n| 2003 | 47000                          | -1000                                 | 3664                                                        |\n| 2004 | 45000                          | -2000                                 | 7328                                                        |\n| 2005 | 44500                          | -500                                  | 1832                                                        |\n| 2006 | 44000                          | -500                                  | 1832                                                        |\n| 2007 | 43500                          | -500                                  | 1832                                                        |\n\n### Step 4. Allocate the CO<sub>2</sub> emission to overlapping Cycles\n\n[Measurements](https://www.hestia.earth/schema/Measurement), such as `biocharOrganicCarbonPerHa`, are attached to [Site](https://www.hestia.earth/schema/Site) nodes. In the HESTIA schema, a single [Site](https://www.hestia.earth/schema/Site) can be linked to multiple [Cycle](https://www.hestia.earth/schema/Cycle) nodes. However, emission models are run **per [Cycle](https://www.hestia.earth/schema/Cycle)**.\n\nTo ensure emissions are correctly allocated, the `ipcc2019.co2ToAirBiocharStockChange` model gathers data from all [Cycles](https://www.hestia.earth/schema/Cycle) associated with the same [Site](https://www.hestia.earth/schema/Site).\n\nEmissions from changes in carbon stock should only be assigned to a [Cycle](https://www.hestia.earth/schema/Cycle) if that Cycle meaningfully overlaps with the inventory year in which the stock change occurred.\n\nIf multiple [Cycles](https://www.hestia.earth/schema/Cycle) overlap the same inventory year, the emission for that year is **shared proportionally** based on the number of overlapping days. For example:\n\n- `cycle-y` overlaps by 200 days\n- `cycle-z` overlaps by 100 days\n\nThen:\n\n- `cycle-y` receives **66.6%** of the emission\n- `cycle-z` receives **33.3%**\n\n_n.b._, The total share of emissions across all overlapping [Cycles](https://www.hestia.earth/schema/Cycle) **must always sum to 100%** to avoid under- or over-reporting.\n\n#### Emissions across multiple years\n\nIf a [Cycle](https://www.hestia.earth/schema/Cycle) overlaps with **multiple inventory years**, it should be assigned the **sum of its proportional shares** from each of those years.\n\n<div class=\"table-container is-responsive\">\n  <table class=\"table is-fullwidth is-hoverable is-striped\">\n    <tr>\n      <th>Year</th>\n      <th>\n        Total emission(kg CO<sub>2</sub> ha<sup>-1</sup>)\n      </th>\n      <th>Cycle ID</th>\n      <th>Share of emission (%)</th>\n      <th>\n        Cycle emission(kg CO<sub>2</sub> ha<sup>-1</sup>)\n      </th>\n    </tr>\n    <tr>\n      <td>2003</td>\n      <td>3664</td>\n      <td>\n        cycle-a0\n      </td>\n      <td>100</td>\n      <td>3664</td>\n    </tr>\n    <tr>\n      <td rowspan=\"2\">2004</td>\n      <td rowspan=\"2\">7328</td>\n      <td>\n        cycle-a1\n      </td>\n      <td>50</td>\n      <td>3664</td>\n    </tr>\n    <tr>\n      <td>\n        cycle-a2\n      </td>\n      <td>50</td>\n      <td>3664</td>\n    </tr>\n    <tr>\n      <td>2005</td>\n      <td>1832</td>\n      <td>\n        cycle-a3\n      </td>\n      <td>100</td>\n      <td>1832</td>\n    </tr>\n    <tr>\n      <td>2006</td>\n      <td>1832</td>\n      <td>\n        cycle-a3\n      </td>\n      <td>100</td>\n      <td>1832</td>\n    </tr>\n    <tr>\n      <td>2007</td>\n      <td>1832</td>\n      <td>\n        cycle-a3\n      </td>\n      <td>100</td>\n      <td>1832</td>\n    </tr>\n  </table>\n</div>\n\n| Cycle ID   | `co2ToAirBiocharStockChange`(kg CO<sub>2</sub> ha<sup>-1</sup>) |\n| ---------- | --------------------------------------------------------------- |\n| `cycle-a0` | 3664                                                            |\n| `cycle-a1` | 3664                                                            |\n| `cycle-a2` | 3664                                                            |\n| `cycle-a3` | 5496                                                            |\n\n### Step 5. Assign an emission tier\n\nThe `methodTier` assigned to the emission node on each [Cycle](https://www.hestia.earth/schema/Cycle) reflects the **weakest** measurement method used in its calculation.\n\nFor example, if a [Cycle](https://www.hestia.earth/schema/Cycle)'s final emission is calculated by summing together the emissions of two inventory years, where:\n\n- One year uses [Measurements](https://www.hestia.earth/schema/Measurement) with `methodClassification = tier 1 model`\n- The other year uses `methodClassification = tier 2 model`\n\nThe resulting `methodTier` will be `tier 1`, since it is the **weakest** method involved.\n\nThe mapping between Measurement `methodClassification` and Emission `methodTier` is:\n\n| Measurement `methodClassification`  | Emission `methodTier` |\n| ----------------------------------- | --------------------- |\n| `on-site physical measurement`      | `measured`            |\n| `modelled using other measurements` | `measured`            |\n| `tier 3 model`                      | `tier 3`              |\n| `tier 2 model`                      | `tier 2`              |\n| `tier 1 model`                      | `tier 1`              |\n\n\n\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/co2ToAirBiocharStockChange\">co2ToAirBiocharStockChange</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/ipcc2019\">ipcc2019</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#sd\">sd</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#min\">min</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#max\">max</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#statsDefinition\">statsDefinition</a> with <code>simulated</code></li>\n<li><a href=\"https://hestia.earth/schema/Emission#observations\">observations</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#depth\">depth</a> with <code>30</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> with <code>forest</code> <strong>or</strong> <code>other natural vegetation</code> <strong>or</strong> <code>cropland</code> <strong>or</strong> <code>glass or high accessible cover</code> <strong>or</strong> <code>permanent pasture</code> and a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> and <a href=\"https://hestia.earth/schema/Measurement#dates\">dates</a> and <a href=\"https://hestia.earth/schema/Measurement#depthUpper\">depthUpper</a> with <code>0</code> and <a href=\"https://hestia.earth/schema/Measurement#depthLower\">depthLower</a> with <code>30</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/biocharOrganicCarbonPerHa\">biocharOrganicCarbonPerHa</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li><a href=\"https://hestia.earth/schema/Cycle#functionalUnit\">functionalUnit</a> with <code>1 ha</code></li>\n<li><a href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a></li>\n<li>optional:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#startDate\">startDate</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>siteTypesAllowed</code>; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}
+{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Soil"],"tab":["IPCC (2019)"],"citation":["Payen, F. (2025) Biochar organic carbon stock modelling on HESTIA."],"tag":["soc modelling"],"modelId":["co2ToAirBiocharStockChange"],"modelRequires":["biocharOrganicCarbonPerHa"]},"content":"# CO2, to air, biochar stock change\n\nCarbon dioxide emissions to air, from biochar stock change. Biochar is a charcoal-like substance obtained by burning organic materials from agricultural and forestry wastes in a controlled process.\n\n## Overview\n\nThis model calculates the annual emissions from biochar organic carbon (`biocharOrganicCarbonPerHa`) stock changes and assigns them to Cycles that take place during those years.\n\nThe model is run as a Monte Carlo simulation with 10,000 iterations. Model result values are the row-wise `mean` of simulation results. See our guide on [Monte Carlo simulation](/guide/models-applying-models-monte-carlo) for more information\n\n## How the model works\n\n### Step 1. Build an annual inventory of biochar organic carbon stock measurements\n\nAn annual inventory of `biocharOrganicCarbonPerHa` [Measurement](/schema/Measurement) values is created. These values represent the amount of organic carbon stored in biochar the soil at the **end of each inventory year**.\n\n[Measurements](/schema/Measurement) are grouped by `methodClassification`. It is critical that different methods are **never mixed** when calculating changes in carbon stock, as this could lead to large and misleading differences. Instead, the model processes each `methodClassification` separately, and includes only the emissions calculated using the **strongest available method** in the final output.\n\nOnly [Measurements](/schema/Measurement) with specific `methodClassification` values are included. All others are ignored. The valid classifications, listed from strongest to weakest, are:\n\n- `on-site physical measurement`\n- `modelled using other measurements`\n- `tier 3 model`\n- `tier 2 model`\n- `tier 1 model`\n\nEach carbon stock value must correspond to the timestamp `YYYY-12-31T23:59:59` — the end of the inventory year. If no [Measurement](/schema/Measurement) exists for this exact time, the value is estimated using linear interpolation between the closest available measurements before and after the target date.\n\n| Year | `on-site physical measurement`<sup>\\*</sup> | `tier 1 model`<sup>\\*</sup> |\n| ---- | ------------------------------------------- | --------------------------- |\n| 2002 | 48000                                       | -                           |\n| 2003 | 47000                                       | -                           |\n| 2004 | 45000                                       | 52350                       |\n| 2005 | 44500                                       | 51125                       |\n| 2006 | 44000                                       | 49900                       |\n| 2007 | 43500                                       | -                           |\n\n<sup>\\*</sup>biochar organic carbon stock (kg C ha<sup>-1</sup>)\n\nIn this scenario, the values of the `on-site physical measurement` column will be retained because it is the stronger `methodClassification`. The values of the `tier 1 model` will be discarded.\n\n### Step 2. Resample stock values for Monte Carlo simulation\n\nTo run the model as a Monte Carlo simulation, we need to generate an array of random samples for the `biocharOrganicCarbonPerHa` stock in each inventory year. These samples are drawn from a normal distribution defined by the `value` (mean) and `sd` of each year.\n\nIdeally, we would re-use the full set of iteration results from the [`ipcc2019.biocharOrganicCarbonPerHa`](./biocharOrganicCarbonPerHa) model's Monto Carlo simulation. However, HESTIA nodes can only store row-wise summaries of Monte Carlo simulation results. This means the full iteration-level data is not available for use in downstream models, so we lose the correlation between years in each simulation run.\n\nTo maintain realistic, coherent simulation behaviour:\n\n- Within each simulation run (column): Values across years (rows) should be correlated. If year 0 is a high value, we expect subsequent years to also be relatively high\n- Across simulation runs (columns): Values should be independent from one another\n\nFor this, we need to generate our new random samples with correlation by treating the inventory as a time series, where:\n\n- Rows = time steps (years)\n- Columns = independent Monte Carlo runs\n\nTo model the correlation between years, we assume that similarity in stock values decreases with time. Closer years are more correlated than years further apart. This is modelled using exponential decay, with a half-life of 100 years (based on the IPCC's transition period for biochar carbon stock equilibrium).\n\nUsing this correlation structure, we generate samples from a multivariate normal distribution, ensuring temporal correlation within runs and independence between runs.\n\nSee the [Scipy Cookbook on Correlated Random Samples](https://scipy-cookbook.readthedocs.io/items/CorrelatedRandomSamples.html) for more information.\n\nCarbon stock values without a corresponding `sd` are given a nominal error of 75% ($2*{sd}$ as a percentage of the mean).\n\n### Step 3. Calculate the annual CO<sub>2</sub> emission (or removal) due to biochar organic carbon stock change\n\nNext, the carbon stock change and the associated CO<sub>2</sub> change can be calculated for each inventory year:\n\n$\\Delta CO_2 = -1 * (C_y - C\\_{y-1}) * \\frac{44.01}{12.012}$\n\nWhere:\n\n- $\\Delta CO_2$ = the CO<sub>2</sub> emission due to carbon stock change for year $y$, kg CO<sub>2</sub> ha<sup>-1</sup>.\n- $C_y$ = the carbon stock in year $y$, kg C ha<sup>-1</sup>.\n- $C_{y-1}$ = the carbon stock in year $y-1$x, kg C ha<sup>-1</sup>.\n- $\\frac{44.01}{12.012}$ = the ratio of the atomic mass of CO<sub>$2$</sub> to C.\n\n_n.b._, the value is multiplied by $-1$ as a reduction in carbon stock is associated with an emission of CO<sub>2</sub> and vice versa.\n\n| Year | C stock (kg C ha<sup>-1</sup>) | C stock change (kg C ha<sup>-1</sup>) | CO<sub>2</sub> emission (kg CO<sub>2</sub> ha<sup>-1</sup>) |\n| ---- | ------------------------------ | ------------------------------------- | ----------------------------------------------------------- |\n| 2002 | 48000                          | n/a                                   | n/a                                                         |\n| 2003 | 47000                          | -1000                                 | 3664                                                        |\n| 2004 | 45000                          | -2000                                 | 7328                                                        |\n| 2005 | 44500                          | -500                                  | 1832                                                        |\n| 2006 | 44000                          | -500                                  | 1832                                                        |\n| 2007 | 43500                          | -500                                  | 1832                                                        |\n\n### Step 4. Allocate the CO<sub>2</sub> emission to overlapping Cycles\n\n[Measurements](/schema/Measurement), such as `biocharOrganicCarbonPerHa`, are attached to [Site](/schema/Site) nodes. In the HESTIA schema, a single [Site](/schema/Site) can be linked to multiple [Cycle](/schema/Cycle) nodes. However, emission models are run **per [Cycle](/schema/Cycle)**.\n\nTo ensure emissions are correctly allocated, the `ipcc2019.co2ToAirBiocharStockChange` model gathers data from all [Cycles](/schema/Cycle) associated with the same [Site](/schema/Site).\n\nEmissions from changes in carbon stock should only be assigned to a [Cycle](/schema/Cycle) if that Cycle meaningfully overlaps with the inventory year in which the stock change occurred.\n\nIf multiple [Cycles](/schema/Cycle) overlap the same inventory year, the emission for that year is **shared proportionally** based on the number of overlapping days. For example:\n\n- `cycle-y` overlaps by 200 days\n- `cycle-z` overlaps by 100 days\n\nThen:\n\n- `cycle-y` receives **66.6%** of the emission\n- `cycle-z` receives **33.3%**\n\n_n.b._, The total share of emissions across all overlapping [Cycles](/schema/Cycle) **must always sum to 100%** to avoid under- or over-reporting.\n\n#### Emissions across multiple years\n\nIf a [Cycle](/schema/Cycle) overlaps with **multiple inventory years**, it should be assigned the **sum of its proportional shares** from each of those years.\n\n<div class=\"table-container is-responsive\">\n  <table class=\"table is-fullwidth is-hoverable is-striped\">\n    <tr>\n      <th>Year</th>\n      <th>\n        Total emission(kg CO<sub>2</sub> ha<sup>-1</sup>)\n      </th>\n      <th>Cycle ID</th>\n      <th>Share of emission (%)</th>\n      <th>\n        Cycle emission(kg CO<sub>2</sub> ha<sup>-1</sup>)\n      </th>\n    </tr>\n    <tr>\n      <td>2003</td>\n      <td>3664</td>\n      <td>\n        cycle-a0\n      </td>\n      <td>100</td>\n      <td>3664</td>\n    </tr>\n    <tr>\n      <td rowspan=\"2\">2004</td>\n      <td rowspan=\"2\">7328</td>\n      <td>\n        cycle-a1\n      </td>\n      <td>50</td>\n      <td>3664</td>\n    </tr>\n    <tr>\n      <td>\n        cycle-a2\n      </td>\n      <td>50</td>\n      <td>3664</td>\n    </tr>\n    <tr>\n      <td>2005</td>\n      <td>1832</td>\n      <td>\n        cycle-a3\n      </td>\n      <td>100</td>\n      <td>1832</td>\n    </tr>\n    <tr>\n      <td>2006</td>\n      <td>1832</td>\n      <td>\n        cycle-a3\n      </td>\n      <td>100</td>\n      <td>1832</td>\n    </tr>\n    <tr>\n      <td>2007</td>\n      <td>1832</td>\n      <td>\n        cycle-a3\n      </td>\n      <td>100</td>\n      <td>1832</td>\n    </tr>\n  </table>\n</div>\n\n| Cycle ID   | `co2ToAirBiocharStockChange`(kg CO<sub>2</sub> ha<sup>-1</sup>) |\n| ---------- | --------------------------------------------------------------- |\n| `cycle-a0` | 3664                                                            |\n| `cycle-a1` | 3664                                                            |\n| `cycle-a2` | 3664                                                            |\n| `cycle-a3` | 5496                                                            |\n\n### Step 5. Assign an emission tier\n\nThe `methodTier` assigned to the emission node on each [Cycle](/schema/Cycle) reflects the **weakest** measurement method used in its calculation.\n\nFor example, if a [Cycle](/schema/Cycle)'s final emission is calculated by summing together the emissions of two inventory years, where:\n\n- One year uses [Measurements](/schema/Measurement) with `methodClassification = tier 1 model`\n- The other year uses `methodClassification = tier 2 model`\n\nThe resulting `methodTier` will be `tier 1`, since it is the **weakest** method involved.\n\nThe mapping between Measurement `methodClassification` and Emission `methodTier` is:\n\n| Measurement `methodClassification`  | Emission `methodTier` |\n| ----------------------------------- | --------------------- |\n| `on-site physical measurement`      | `measured`            |\n| `modelled using other measurements` | `measured`            |\n| `tier 3 model`                      | `tier 3`              |\n| `tier 2 model`                      | `tier 2`              |\n| `tier 1 model`                      | `tier 1`              |\n\n\n\n\n\n\n\n\n\n\n\n<div class=\"collapsibles\">\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Returns</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A list of <a href=\"https://hestia.earth/schema/Emission\">Emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/co2ToAirBiocharStockChange\">co2ToAirBiocharStockChange</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/ipcc2019\">ipcc2019</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#sd\">sd</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#min\">min</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#max\">max</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#statsDefinition\">statsDefinition</a> with <code>simulated</code></li>\n<li><a href=\"https://hestia.earth/schema/Emission#observations\">observations</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#depth\">depth</a> with <code>30</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Requirements</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li>A <a href=\"https://hestia.earth/schema/Cycle\">Cycle</a> with:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> with <code>forest</code> <strong>or</strong> <code>other natural vegetation</code> <strong>or</strong> <code>cropland</code> <strong>or</strong> <code>glass or high accessible cover</code> <strong>or</strong> <code>permanent pasture</code> and a list of <a href=\"https://hestia.earth/schema/Site#measurements\">measurements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a> and <a href=\"https://hestia.earth/schema/Measurement#dates\">dates</a> and <a href=\"https://hestia.earth/schema/Measurement#depthUpper\">depthUpper</a> with <code>0</code> and <a href=\"https://hestia.earth/schema/Measurement#depthLower\">depthLower</a> with <code>30</code> and <a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/biocharOrganicCarbonPerHa\">biocharOrganicCarbonPerHa</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li><a href=\"https://hestia.earth/schema/Cycle#functionalUnit\">functionalUnit</a> with <code>1 ha</code></li>\n<li><a href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a></li>\n<li>optional:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#startDate\">startDate</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/emission.csv\">emission.csv</a> -&gt; <code>siteTypesAllowed</code>; <code>typesAllowed</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}