@hestia-earth/guide 0.0.17 → 0.0.19

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

@@ -0,0 +1 @@
+{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Soil"],"tab":["IPCC (2019)"],"citation":["Payen, F. (2025) Soil organic carbon stock modelling on HESTIA."],"tag":["soc modelling"]},"content":"# CO2, to air, soil organic carbon stock change\n\nCarbon dioxide emissions to air, from soil organic carbon stock change. Soil organic carbon is defined as soil organic matter that is smaller than 2 mm in size.\n\n## Overview\n\nThis model calculates the annual emissions from soil organic carbon (SOC) stock changes and assigns them to Cycles that take place during those years. It can allocate these emissions to two HESTIA terms:\n\n1. [`co2ToAirSoilOrganicCarbonStockChangeLandUseChange`](/term/co2ToAirSoilOrganicCarbonStockChangeLandUseChange) - stock change emissions that occur in the 20 years after a land-use change event\n2. [`co2ToAirSoilOrganicCarbonStockChangeManagementChange`](/term/co2ToAirSoilOrganicCarbonStockChangeManagementChange) - stock change emissions that occur more than 20 years after a land-use change event\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 SOC measurements\n\nAn annual inventory of `organicCarbonPerHa` [Measurement](/schema/Measurement) values is created. These values represent the amount of organic carbon stored in 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>SOC 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 `organicCarbonPerHa` 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.organicCarbonPerHa`](./organicCarbonPerHa) 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 20 years (based on the IPCC's default transition period for 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 SOC 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 `organicCarbonPerHa`, 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.co2ToAirSoilOrganicCarbonStockChange` 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   | `co2ToAirSoilOrganicCarbonStockChangeManagementChange`(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### Step 6. Allocate the CO<sub>2</sub> emission to land-use change or management change\n\nIn line with reporting requirements, CO<sub>2</sub> emissions from stock changes must be classified as either:\n\n- due to land-use change (LUC), or\n- due to management change.\n\nIn HESTIA, the presence or absence of a blank node matters: returning no node is not the same as returning a node with 0 emissions. To ensure consistency, the model should always return two blank nodes (one for each category) if enough data is available.\n\n**Allocation rules**\n\nIf it is known whether the emission is due to LUC or management:\n\n- Return two blank nodes:\n  1. One node with the emission and the correct term.@id\n  2. One node with 0 emissions and the other term.@id\n\nIf it is unknown:\n\n- Return one blank node, allocating the full emission to management change\n\n**Decision criteria**\n\nAllocation is based on two factors:\n\n1. **Completeness of land-use data:**\n\n   - No land-use data\n   - Fewer than 20 years of data\n   - At least 20 years of data\n\n2. **Presence of a land-use change event:**\n   - No land-use change (LUC) event detected\n   - LUC event detected\n\n|                               | No land use data (1)                             | < 20 years' land use data (2)                                                                        | >= 20 years' land use data (3)                                                                       |\n| ----------------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |\n| **No LUC event detected (a)** | allocate all emissions to management change (a1) | allocate all emissions to management change (a2)                                                     | allocate all emissions to management change **AND** add a land use change emission with value 0 (a3) |\n| **LUC event detected (b)**    | n/a (b1)                                         | allocate all emissions to land use change **AND** add a management change emission with value 0 (b2) | allocate all emissions to land use change **AND** add a management change emission with value 0 (b3) |\n\n## Example\n\nIn this example, we follow the SOC stock of an olive orchard, which has not changed in land-use for over 50 years. Therefore, all emissions should be allocated to management changes and a corresponding `0` emission should be allocated to land-use change.\n\nFor simplicity, the uncertainty of model inputs and outputs have been excluded.\n\n### Input\n\n#### Site\n\n```json\n{\n  \"@id\": \"site-a\",\n  \"@type\": \"Site\",\n  \"siteType\": \"cropland\",\n  \"management\": [\n    {\n      \"@type\": \"Management\",\n      \"term\": {\n        \"@type\": \"Term\",\n        \"@id\": \"oliveTree\"\n      },\n      \"value\": [100],\n      \"startDate\": \"1960\",\n      \"endDate\": \"2006\"\n    }\n  ],\n  \"measurements\": [\n    {\n      \"@type\": \"Measurement\",\n      \"term\": {\n        \"@type\": \"Term\",\n        \"@id\": \"organicCarbonPerHa\"\n      },\n      \"value\": [43000],\n      \"method\": {\n        \"@type\": \"Term\",\n        \"@id\": \"ipcc2019\"\n      },\n      \"depthUpper\": 0,\n      \"depthLower\": 30,\n      \"dates\": [\"2003-12-31\"],\n      \"methodClassification\": \"tier 1 model\"\n    },\n    {\n      \"@type\": \"Measurement\",\n      \"term\": {\n        \"@type\": \"Term\",\n        \"@id\": \"organicCarbonPerHa\"\n      },\n      \"value\": [44333.333],\n      \"method\": {\n        \"@type\": \"Term\",\n        \"@id\": \"ipcc2019\"\n      },\n      \"depthUpper\": 0,\n      \"depthLower\": 30,\n      \"dates\": [\"2004-12-31\"],\n      \"methodClassification\": \"tier 1 model\"\n    },\n    {\n      \"@type\": \"Measurement\",\n      \"term\": {\n        \"@type\": \"Term\",\n        \"@id\": \"organicCarbonPerHa\"\n      },\n      \"value\": [45666.666],\n      \"method\": {\n        \"@type\": \"Term\",\n        \"@id\": \"ipcc2019\"\n      },\n      \"depthUpper\": 0,\n      \"depthLower\": 30,\n      \"dates\": [\"2005-12-31\"],\n      \"methodClassification\": \"tier 1 model\"\n    },\n    {\n      \"@type\": \"Measurement\",\n      \"term\": {\n        \"@type\": \"Term\",\n        \"@id\": \"organicCarbonPerHa\"\n      },\n      \"value\": [47000],\n      \"method\": {\n        \"@type\": \"Term\",\n        \"@id\": \"ipcc2019\"\n      },\n      \"depthUpper\": 0,\n      \"depthLower\": 30,\n      \"dates\": [\"2006-12-31\"],\n      \"methodClassification\": \"tier 1 model\"\n    }\n  ]\n}\n```\n\n#### Cycle\n\n```json\n{\n  \"@id\": \"cycle-a-04-06\",\n  \"@type\": \"Cycle\",\n  \"startDate\": \"2004\",\n  \"endDate\": \"2006\",\n  \"site\": {\n    \"@id\": \"site-a\",\n    \"@type\": \"Site\"\n  },\n  \"functionalUnit\": \"1 ha\"\n}\n```\n\n### Output\n\n```json\n[\n  {\n    \"@type\": \"Emission\",\n    \"term\": {\n      \"@type\": \"Term\",\n      \"@id\": \"co2ToAirSoilCarbonStockChangeLandUseChange\"\n    },\n    \"methodModel\": {\n      \"@type\": \"Term\",\n      \"@id\": \"ipcc2019\"\n    },\n    \"depth\": 30,\n    \"value\": [0],\n    \"methodTier\": \"tier 1\"\n  },\n  {\n    \"@type\": \"Emission\",\n    \"term\": {\n      \"@type\": \"Term\",\n      \"@id\": \"co2ToAirSoilCarbonStockChangeManagementChange\"\n    },\n    \"methodModel\": {\n      \"@type\": \"Term\",\n      \"@id\": \"ipcc2019\"\n    },\n    \"depth\": 30,\n    \"value\": [-14655.344655],\n    \"methodTier\": \"tier 1\"\n  }\n]\n```\n\n## Cases in which the model can run without SOC stock Measurements\n\nBecause emissions are allocated to either land-use change or management change (depending on whether a land-use change has been detected in the Site's `landCover` history), in some cases it is possible for this model to return partial results when there are no SOC stock Measurements.\n\nIf a land-use change is detected during the 20 years prior to a Cycle, all emissions should be allocated to the land-use change emission term (`co2ToAirSoilCarbonStockChangeLandUseChange`). Therefore, we can allocate `0` emissions to the management change emission term (`co2ToAirSoilCarbonStockChangeManagementChange`) even whem we can't calculate a value for the land-use change emission. To be certain that a land-use change has occurred, we require up to 20 year's `landCover` data prior to the Cycle's `startDate`.\n\nThe inverse is also true for when a land-use change is **not** detected in the 20 years prior to a Cycle. In this case, all emissions should be allocated to the management change emission term (`co2ToAirSoilCarbonStockChangeManagementChange`). Therefore, we can allocate `0` emissions to the land-use change emission term (`co2ToAirSoilCarbonStockChangeLandUseChange`) even when we can't calculate a value for the management change emission. To be certain that a land-use change has **not** occurred, we require a minimum of 20 year's `landCover` data prior to the Cycle's `startDate`.\n\nIf there is insufficient `landCover` data to determine whether a land-use change has occurred, the model will be unable to return partial results.\n\n\n\n\n\n\n"}

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

@@ -0,0 +1 @@
+{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Soil"],"tab":["IPCC (2019)"],"citation":["Payen, F. (2025) Soil organic carbon stock modelling on HESTIA."],"tag":["soc modelling"],"modelId":["co2ToAirSoilOrganicCarbonStockChangeLandUseChange","co2ToAirSoilOrganicCarbonStockChangeManagementChange"],"modelRequires":["organicCarbonPerHa"]},"content":"# CO2, to air, soil organic carbon stock change\n\nCarbon dioxide emissions to air, from soil organic carbon stock change. Soil organic carbon is defined as soil organic matter that is smaller than 2 mm in size.\n\n## Overview\n\nThis model calculates the annual emissions from soil organic carbon (SOC) stock changes and assigns them to Cycles that take place during those years. It can allocate these emissions to two HESTIA terms:\n\n1. [`co2ToAirSoilOrganicCarbonStockChangeLandUseChange`](/term/co2ToAirSoilOrganicCarbonStockChangeLandUseChange) - stock change emissions that occur in the 20 years after a land-use change event\n2. [`co2ToAirSoilOrganicCarbonStockChangeManagementChange`](/term/co2ToAirSoilOrganicCarbonStockChangeManagementChange) - stock change emissions that occur more than 20 years after a land-use change event\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 SOC measurements\n\nAn annual inventory of `organicCarbonPerHa` [Measurement](/schema/Measurement) values is created. These values represent the amount of organic carbon stored in 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>SOC 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 `organicCarbonPerHa` 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.organicCarbonPerHa`](./organicCarbonPerHa) 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 20 years (based on the IPCC's default transition period for 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 SOC 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 `organicCarbonPerHa`, 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.co2ToAirSoilOrganicCarbonStockChange` 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   | `co2ToAirSoilOrganicCarbonStockChangeManagementChange`(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### Step 6. Allocate the CO<sub>2</sub> emission to land-use change or management change\n\nIn line with reporting requirements, CO<sub>2</sub> emissions from stock changes must be classified as either:\n\n- due to land-use change (LUC), or\n- due to management change.\n\nIn HESTIA, the presence or absence of a blank node matters: returning no node is not the same as returning a node with 0 emissions. To ensure consistency, the model should always return two blank nodes (one for each category) if enough data is available.\n\n**Allocation rules**\n\nIf it is known whether the emission is due to LUC or management:\n\n- Return two blank nodes:\n  1. One node with the emission and the correct term.@id\n  2. One node with 0 emissions and the other term.@id\n\nIf it is unknown:\n\n- Return one blank node, allocating the full emission to management change\n\n**Decision criteria**\n\nAllocation is based on two factors:\n\n1. **Completeness of land-use data:**\n\n   - No land-use data\n   - Fewer than 20 years of data\n   - At least 20 years of data\n\n2. **Presence of a land-use change event:**\n   - No land-use change (LUC) event detected\n   - LUC event detected\n\n|                               | No land use data (1)                             | < 20 years' land use data (2)                                                                        | >= 20 years' land use data (3)                                                                       |\n| ----------------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |\n| **No LUC event detected (a)** | allocate all emissions to management change (a1) | allocate all emissions to management change (a2)                                                     | allocate all emissions to management change **AND** add a land use change emission with value 0 (a3) |\n| **LUC event detected (b)**    | n/a (b1)                                         | allocate all emissions to land use change **AND** add a management change emission with value 0 (b2) | allocate all emissions to land use change **AND** add a management change emission with value 0 (b3) |\n\n## Example\n\nIn this example, we follow the SOC stock of an olive orchard, which has not changed in land-use for over 50 years. Therefore, all emissions should be allocated to management changes and a corresponding `0` emission should be allocated to land-use change.\n\nFor simplicity, the uncertainty of model inputs and outputs have been excluded.\n\n### Input\n\n#### Site\n\n```json\n{\n  \"@id\": \"site-a\",\n  \"@type\": \"Site\",\n  \"siteType\": \"cropland\",\n  \"management\": [\n    {\n      \"@type\": \"Management\",\n      \"term\": {\n        \"@type\": \"Term\",\n        \"@id\": \"oliveTree\"\n      },\n      \"value\": [100],\n      \"startDate\": \"1960\",\n      \"endDate\": \"2006\"\n    }\n  ],\n  \"measurements\": [\n    {\n      \"@type\": \"Measurement\",\n      \"term\": {\n        \"@type\": \"Term\",\n        \"@id\": \"organicCarbonPerHa\"\n      },\n      \"value\": [43000],\n      \"method\": {\n        \"@type\": \"Term\",\n        \"@id\": \"ipcc2019\"\n      },\n      \"depthUpper\": 0,\n      \"depthLower\": 30,\n      \"dates\": [\"2003-12-31\"],\n      \"methodClassification\": \"tier 1 model\"\n    },\n    {\n      \"@type\": \"Measurement\",\n      \"term\": {\n        \"@type\": \"Term\",\n        \"@id\": \"organicCarbonPerHa\"\n      },\n      \"value\": [44333.333],\n      \"method\": {\n        \"@type\": \"Term\",\n        \"@id\": \"ipcc2019\"\n      },\n      \"depthUpper\": 0,\n      \"depthLower\": 30,\n      \"dates\": [\"2004-12-31\"],\n      \"methodClassification\": \"tier 1 model\"\n    },\n    {\n      \"@type\": \"Measurement\",\n      \"term\": {\n        \"@type\": \"Term\",\n        \"@id\": \"organicCarbonPerHa\"\n      },\n      \"value\": [45666.666],\n      \"method\": {\n        \"@type\": \"Term\",\n        \"@id\": \"ipcc2019\"\n      },\n      \"depthUpper\": 0,\n      \"depthLower\": 30,\n      \"dates\": [\"2005-12-31\"],\n      \"methodClassification\": \"tier 1 model\"\n    },\n    {\n      \"@type\": \"Measurement\",\n      \"term\": {\n        \"@type\": \"Term\",\n        \"@id\": \"organicCarbonPerHa\"\n      },\n      \"value\": [47000],\n      \"method\": {\n        \"@type\": \"Term\",\n        \"@id\": \"ipcc2019\"\n      },\n      \"depthUpper\": 0,\n      \"depthLower\": 30,\n      \"dates\": [\"2006-12-31\"],\n      \"methodClassification\": \"tier 1 model\"\n    }\n  ]\n}\n```\n\n#### Cycle\n\n```json\n{\n  \"@id\": \"cycle-a-04-06\",\n  \"@type\": \"Cycle\",\n  \"startDate\": \"2004\",\n  \"endDate\": \"2006\",\n  \"site\": {\n    \"@id\": \"site-a\",\n    \"@type\": \"Site\"\n  },\n  \"functionalUnit\": \"1 ha\"\n}\n```\n\n### Output\n\n```json\n[\n  {\n    \"@type\": \"Emission\",\n    \"term\": {\n      \"@type\": \"Term\",\n      \"@id\": \"co2ToAirSoilCarbonStockChangeLandUseChange\"\n    },\n    \"methodModel\": {\n      \"@type\": \"Term\",\n      \"@id\": \"ipcc2019\"\n    },\n    \"depth\": 30,\n    \"value\": [0],\n    \"methodTier\": \"tier 1\"\n  },\n  {\n    \"@type\": \"Emission\",\n    \"term\": {\n      \"@type\": \"Term\",\n      \"@id\": \"co2ToAirSoilCarbonStockChangeManagementChange\"\n    },\n    \"methodModel\": {\n      \"@type\": \"Term\",\n      \"@id\": \"ipcc2019\"\n    },\n    \"depth\": 30,\n    \"value\": [-14655.344655],\n    \"methodTier\": \"tier 1\"\n  }\n]\n```\n\n## Cases in which the model can run without SOC stock Measurements\n\nBecause emissions are allocated to either land-use change or management change (depending on whether a land-use change has been detected in the Site's `landCover` history), in some cases it is possible for this model to return partial results when there are no SOC stock Measurements.\n\nIf a land-use change is detected during the 20 years prior to a Cycle, all emissions should be allocated to the land-use change emission term (`co2ToAirSoilCarbonStockChangeLandUseChange`). Therefore, we can allocate `0` emissions to the management change emission term (`co2ToAirSoilCarbonStockChangeManagementChange`) even whem we can't calculate a value for the land-use change emission. To be certain that a land-use change has occurred, we require up to 20 year's `landCover` data prior to the Cycle's `startDate`.\n\nThe inverse is also true for when a land-use change is **not** detected in the 20 years prior to a Cycle. In this case, all emissions should be allocated to the management change emission term (`co2ToAirSoilCarbonStockChangeManagementChange`). Therefore, we can allocate `0` emissions to the land-use change emission term (`co2ToAirSoilCarbonStockChangeLandUseChange`) even when we can't calculate a value for the management change emission. To be certain that a land-use change has **not** occurred, we require a minimum of 20 year's `landCover` data prior to the Cycle's `startDate`.\n\nIf there is insufficient `landCover` data to determine whether a land-use change has occurred, the model will be unable to return partial results.\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/co2ToAirSoilOrganicCarbonStockChangeLandUseChange\">co2ToAirSoilOrganicCarbonStockChangeLandUseChange</a> <strong>or</strong> <a href=\"https://hestia.earth/term/co2ToAirSoilOrganicCarbonStockChangeManagementChange\">co2ToAirSoilOrganicCarbonStockChangeManagementChange</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/organicCarbonPerHa\">organicCarbonPerHa</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>"}

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

@@ -0,0 +1 @@
+{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Soil"],"tab":["IPCC (2019)"],"tag":["soc modelling"]},"content":"# N2O, to air, diminishing soil carbon stocks, direct\n\nThis model returns the amounts of N<sub>2</sub>O emitted due to diminishing soil carbon stocks according to the [IPCC (2019), volume 4, chapter 11](https://www.ipcc-nggip.iges.or.jp/public/2019rf/pdf/4_Volume4/19R_V4_Ch11_Soils_N2O_CO2.pdf) guidelines:\n\n1. [N<sub>2</sub>O, to air, diminishing soil carbon stocks, land use change, direct](/term/n2OToAirDiminishingSoilCarbonStocksLandUseChangeDirect) - Nitrous oxide emissions to air, released from soils with diminishing soil organic C stocks, caused by land use change (e.g., a change from forest land to cropland)\n2. [N<sub>2</sub>O, to air, diminishing soil carbon stocks, management change, direct](/term/n2OToAirDiminishingSoilCarbonStocksManagementChangeDirect) - Nitrous oxide emissions to air, released from soils with diminishing soil organic C stocks, caused by changes in Site management\n\nCurrently, this model can only calculate emissions from croplands, because the IPCC does not provide model factors for other land uses.\n\n## Description\n\nWhere soil C is lost through oxidation as a result of land-use or management change, this loss will be accompanied by a simultaneous mineralisation of N. This N is regarded as an additional source of N available for conversion to N<sub>2</sub>O. The same default emission factor is applied to mineralised N from soil organic matter loss as for direct emissions from fertiliser and organic N inputs to agricultural land.\n\nBecause this model represents N<sub>2</sub>O from diminishing SOC stocks, only CO<sub>2</sub> emissions (i.e., emissions with a positive value) should be considered, and not CO<sub>2</sub> removals (i.e., emissions with a negative value). CO<sub>2</sub> removals from increasing SOC stocks should be allocated a `0` emission for N<sub>2</sub>O.\n\n### Equation 11.8 - N mineralised in mineral soils as a result of loss of soil C through change in land use or management\n\n$F_{SOM} = \\sum\\limits_{LU} [(\\Delta C_{\\text{Mineral, LU}} \\cdot \\frac{1}{R}) \\cdot 10000]$\n\n| Variable                        | Description                                                                                                                               |\n| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |\n| $F_{SOM}$                       | The net annual amount of N mineralised in mineral soils as a result of loss of soil carbon through change in land use or management, kg N |\n| $\\Delta C_{\\text{Mineral, LU}}$ | Average annual loss of soil carbon for each land-use type $LU$, tonnes C                                                                  |\n| $R$                             | C:N ratio of the soil organic matter, unitless                                                                                            |\n\nBecause N<sub>2</sub>O emission factors and C:N ratios are available with associated uncertainty data, the model can be run as a Monte Carlo simulation with 1000 iterations to propagate uncertainty to results.\n\n### Default C:N ratios\n\n| Forest Land or Grassland -> Cropland | Cropland Remaining Cropland |\n| ------------------------------------ | --------------------------- |\n| 15 (10 - 30)                         | 10 (8 - 15)                 |\n\n## How the model works\n\n1. Retrieve the Cycle's `co2ToAirSoilOrganicCarbonStockChangeLandUseChange` and `co2ToAirSoilOrganicCarbonStockChangeManagementChange` nodes, and extract their values.\n\n2. Retrieve the N<sub>2</sub>O emission factor:\n\n   - If the Cycle's primary product is flooded rice, retrieve the emission factor from the water regime lookup\n   - Else, retrieve the emission factor using the Cycle's eco-climate zone\n\n3. Retrieve the relevant C:N ratios ( $R$ ):\n\n   - For `co2ToAirSoilOrganicCarbonStockChangeLandUseChange`, use a ratio of 15 (10 - 30)\n   - For `co2ToAirSoilOrganicCarbonStockChangeManagementChange`, use a ratio of 10 (8 - 15)\n\n4. Generate 1000 randomised samples for the emission factor and C:N ratios, using the `value` (mean), `sd`, `min` and `max` provided. Missing standard deviations can be estimated via `(min - max) / 4`, which is consistent with other N<sub>2</sub>O models across HESTIA.\n\n5. Convert CO<sub>2</sub> emissions to N<sub>2</sub>O emissions by multiplying the emission by:\n\n   - The atomic mass ratio of CO<sub>2</sub>:C\n   - The reciprocal of the C:N ratio ( $\\frac{1}{R}$ )\n   - The N<sub>2</sub>O emission factor\n   - and the atomic mass ratio of N:N<sub>2</sub>O\n\n6. If the calculated N<sub>2</sub>O emission is less than zero, set it to zero.\n\n7. Calculate descriptive statistics (`value` (mean), `sd`, `min` and `max`) for each emission and return them:\n\n   - Emissions calculated from `co2ToAirSoilOrganicCarbonStockChangeLandUseChange` should be assigned to `n2OToAirDiminishingSoilCarbonStocksLandUseChangeDirect`\n   - Emissions calculated from `co2ToAirSoilOrganicCarbonStockChangeManagementChange` should be assigned to `n2OToAirDiminishingSoilCarbonStocksManagementChangeDirect`\n\n\n\n\n\n"}

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

@@ -0,0 +1 @@
+{"tags":{"author":["Florian Payen"],"group":["Cycle: Emissions"],"subgroup":["Soil"],"tab":["IPCC (2019)"],"tag":["soc modelling"],"modelId":["n2OToAirDiminishingSoilCarbonStocksLandUseChangeDirect","n2OToAirDiminishingSoilCarbonStocksManagementChangeDirect"],"modelRequires":["co2ToAirSoilOrganicCarbonStockChangeLandUseChange","co2ToAirSoilOrganicCarbonStockChangeManagementChange","ecoClimateZone","riceGrainInHuskFlooded"]},"content":"# N2O, to air, diminishing soil carbon stocks, direct\n\nThis model returns the amounts of N<sub>2</sub>O emitted due to diminishing soil carbon stocks according to the [IPCC (2019), volume 4, chapter 11](https://www.ipcc-nggip.iges.or.jp/public/2019rf/pdf/4_Volume4/19R_V4_Ch11_Soils_N2O_CO2.pdf) guidelines:\n\n1. [N<sub>2</sub>O, to air, diminishing soil carbon stocks, land use change, direct](/term/n2OToAirDiminishingSoilCarbonStocksLandUseChangeDirect) - Nitrous oxide emissions to air, released from soils with diminishing soil organic C stocks, caused by land use change (e.g., a change from forest land to cropland)\n2. [N<sub>2</sub>O, to air, diminishing soil carbon stocks, management change, direct](/term/n2OToAirDiminishingSoilCarbonStocksManagementChangeDirect) - Nitrous oxide emissions to air, released from soils with diminishing soil organic C stocks, caused by changes in Site management\n\nCurrently, this model can only calculate emissions from croplands, because the IPCC does not provide model factors for other land uses.\n\n## Description\n\nWhere soil C is lost through oxidation as a result of land-use or management change, this loss will be accompanied by a simultaneous mineralisation of N. This N is regarded as an additional source of N available for conversion to N<sub>2</sub>O. The same default emission factor is applied to mineralised N from soil organic matter loss as for direct emissions from fertiliser and organic N inputs to agricultural land.\n\nBecause this model represents N<sub>2</sub>O from diminishing SOC stocks, only CO<sub>2</sub> emissions (i.e., emissions with a positive value) should be considered, and not CO<sub>2</sub> removals (i.e., emissions with a negative value). CO<sub>2</sub> removals from increasing SOC stocks should be allocated a `0` emission for N<sub>2</sub>O.\n\n### Equation 11.8 - N mineralised in mineral soils as a result of loss of soil C through change in land use or management\n\n$F_{SOM} = \\sum\\limits_{LU} [(\\Delta C_{\\text{Mineral, LU}} \\cdot \\frac{1}{R}) \\cdot 10000]$\n\n| Variable                        | Description                                                                                                                               |\n| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |\n| $F_{SOM}$                       | The net annual amount of N mineralised in mineral soils as a result of loss of soil carbon through change in land use or management, kg N |\n| $\\Delta C_{\\text{Mineral, LU}}$ | Average annual loss of soil carbon for each land-use type $LU$, tonnes C                                                                  |\n| $R$                             | C:N ratio of the soil organic matter, unitless                                                                                            |\n\nBecause N<sub>2</sub>O emission factors and C:N ratios are available with associated uncertainty data, the model can be run as a Monte Carlo simulation with 1000 iterations to propagate uncertainty to results.\n\n### Default C:N ratios\n\n| Forest Land or Grassland -> Cropland | Cropland Remaining Cropland |\n| ------------------------------------ | --------------------------- |\n| 15 (10 - 30)                         | 10 (8 - 15)                 |\n\n## How the model works\n\n1. Retrieve the Cycle's `co2ToAirSoilOrganicCarbonStockChangeLandUseChange` and `co2ToAirSoilOrganicCarbonStockChangeManagementChange` nodes, and extract their values.\n\n2. Retrieve the N<sub>2</sub>O emission factor:\n\n   - If the Cycle's primary product is flooded rice, retrieve the emission factor from the water regime lookup\n   - Else, retrieve the emission factor using the Cycle's eco-climate zone\n\n3. Retrieve the relevant C:N ratios ( $R$ ):\n\n   - For `co2ToAirSoilOrganicCarbonStockChangeLandUseChange`, use a ratio of 15 (10 - 30)\n   - For `co2ToAirSoilOrganicCarbonStockChangeManagementChange`, use a ratio of 10 (8 - 15)\n\n4. Generate 1000 randomised samples for the emission factor and C:N ratios, using the `value` (mean), `sd`, `min` and `max` provided. Missing standard deviations can be estimated via `(min - max) / 4`, which is consistent with other N<sub>2</sub>O models across HESTIA.\n\n5. Convert CO<sub>2</sub> emissions to N<sub>2</sub>O emissions by multiplying the emission by:\n\n   - The atomic mass ratio of CO<sub>2</sub>:C\n   - The reciprocal of the C:N ratio ( $\\frac{1}{R}$ )\n   - The N<sub>2</sub>O emission factor\n   - and the atomic mass ratio of N:N<sub>2</sub>O\n\n6. If the calculated N<sub>2</sub>O emission is less than zero, set it to zero.\n\n7. Calculate descriptive statistics (`value` (mean), `sd`, `min` and `max`) for each emission and return them:\n\n   - Emissions calculated from `co2ToAirSoilOrganicCarbonStockChangeLandUseChange` should be assigned to `n2OToAirDiminishingSoilCarbonStocksLandUseChangeDirect`\n   - Emissions calculated from `co2ToAirSoilOrganicCarbonStockChangeManagementChange` should be assigned to `n2OToAirDiminishingSoilCarbonStocksManagementChangeDirect`\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/n2OToAirDiminishingSoilCarbonStocksLandUseChangeDirect\">n2OToAirDiminishingSoilCarbonStocksLandUseChangeDirect</a> <strong>or</strong> <a href=\"https://hestia.earth/term/n2OToAirDiminishingSoilCarbonStocksManagementChangeDirect\">n2OToAirDiminishingSoilCarbonStocksManagementChangeDirect</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#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#sd\">sd</a></li>\n<li><a href=\"https://hestia.earth/schema/Emission#methodTier\">methodTier</a> with <code>tier 1</code></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#methodModelDescription\">methodModelDescription</a> with <code>Aggregated version</code> <strong>or</strong> <code>Disaggregated version</code></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></li>\n</ul>\n</li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#emissions\">emissions</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a> and <a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/co2ToAirSoilOrganicCarbonStockChangeLandUseChange\">co2ToAirSoilOrganicCarbonStockChangeLandUseChange</a> and <a href=\"https://hestia.earth/schema/Emission#depth\">depth</a> with <code>30</code></li>\n<li><a href=\"https://hestia.earth/schema/Emission#value\">value</a> and <a href=\"https://hestia.earth/schema/Emission#term\">term</a> with <a href=\"https://hestia.earth/term/co2ToAirSoilOrganicCarbonStockChangeManagementChange\">co2ToAirSoilOrganicCarbonStockChangeManagementChange</a> and <a href=\"https://hestia.earth/schema/Emission#depth\">depth</a> with <code>30</code></li>\n</ul>\n</li>\n<li>optional:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a></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> 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>a list of <a href=\"https://hestia.earth/schema/Cycle#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#term\">term</a> with <a href=\"https://hestia.earth/term/riceGrainInHuskFlooded\">riceGrainInHuskFlooded</a></li>\n</ul>\n</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#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=waterRegime\">waterRegime</a></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/waterRegime.csv\">waterRegime.csv</a> -&gt; <code>IPCC_2019_N2O_rice</code>; <code>IPCC_2019_N2O_rice-min</code>; <code>IPCC_2019_N2O_rice-max</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/cycleGeneral/cycle-cycleDuration/content.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle Duration\n\nThis model calculates the cycle duration using:\n* the `endDate` and the `startDate` if both are provided with a day precision;\n* for temporary crops, using the `croppingIntensity` if provided;\n* for permanent crops, the duration is set to `365`.\n\n\n\n"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle Duration\n\nThis model calculates the cycle duration using:\n* the `endDate` and the `startDate` if both are provided with a day precision;\n* for temporary crops, using the `croppingIntensity` if provided;\n* for permanent crops, the duration is set to `365`.\n\nCycles are understood to take place from the start of the `startDate` (i.e., 00:00:00) to the end of the `endDate` (i.e., 23:59:59). `cycleDuration` is **inclusive** of a Cycle's `endDate`; therefore a Cycle with `startDate` = `2001-01-01` and `endDate` = `2001-12-31` will have a `cycleDuration` = `365`.\n\n\n\n"}

package/dist/content/models/cycleGeneral/cycle-cycleDuration/cycle.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["cycleDuration"],"modelRequires":["croppingIntensity"]},"content":"# Cycle Duration\n\nThis model calculates the cycle duration using:\n* the `endDate` and the `startDate` if both are provided with a day precision;\n* for temporary crops, using the `croppingIntensity` if provided;\n* for permanent crops, the duration is set to `365`.\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 <code>number</code> or <code>None</code> if requirements are not met</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 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<li>a list of <a href=\"https://hestia.earth/schema/Cycle#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#primary\">primary</a> = <code>True</code> and <a href=\"https://hestia.earth/schema/Product#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=crop\">crop</a></li>\n</ul>\n</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/croppingIntensity\">croppingIntensity</a></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/crop.csv\">crop.csv</a> -&gt; <code>cropGroupingFAO</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["cycleDuration"],"modelRequires":["croppingIntensity"]},"content":"# Cycle Duration\n\nThis model calculates the cycle duration using:\n* the `endDate` and the `startDate` if both are provided with a day precision;\n* for temporary crops, using the `croppingIntensity` if provided;\n* for permanent crops, the duration is set to `365`.\n\nCycles are understood to take place from the start of the `startDate` (i.e., 00:00:00) to the end of the `endDate` (i.e., 23:59:59). `cycleDuration` is **inclusive** of a Cycle's `endDate`; therefore a Cycle with `startDate` = `2001-01-01` and `endDate` = `2001-12-31` will have a `cycleDuration` = `365`.\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 <code>number</code> or <code>None</code> if requirements are not met</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 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<li>a list of <a href=\"https://hestia.earth/schema/Cycle#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#primary\">primary</a> = <code>True</code> and <a href=\"https://hestia.earth/schema/Product#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=crop\">crop</a></li>\n</ul>\n</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/croppingIntensity\">croppingIntensity</a></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/crop.csv\">crop.csv</a> -&gt; <code>cropGroupingFAO</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}

package/dist/content/models/cycleGeneral/cycle-endDate/content.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle End Date\n\nThis model sets the [Cycle endDate](https://hestia.earth/schema/Cycle#endDate) based on:\n* if no `cycleDuration` is provided, and the `endDate` is set to month precision (e.g., `2000-01`), assumed it ended on the 14th of the month.\n\n\n\n"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle End Date\n\nThis model sets the [Cycle endDate](/schema/Cycle#endDate) based on:\n* if no `cycleDuration` is provided, and the `endDate` is set to month precision (e.g., `2000-01`), assumed it ended on the 14th of the month.\n\n\n\n"}

package/dist/content/models/cycleGeneral/cycle-endDate/cycle.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["endDate"]},"content":"# Cycle End Date\n\nThis model sets the [Cycle endDate](https://hestia.earth/schema/Cycle#endDate) based on:\n* if no `cycleDuration` is provided, and the `endDate` is set to month precision (e.g., `2000-01`), assumed it ended on the 14th of the month.\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>The endDate as a string</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 href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a> with <code>month precision</code></li>\n<li>none of:<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  \n  \n</div>"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["endDate"]},"content":"# Cycle End Date\n\nThis model sets the [Cycle endDate](/schema/Cycle#endDate) based on:\n* if no `cycleDuration` is provided, and the `endDate` is set to month precision (e.g., `2000-01`), assumed it ended on the 14th of the month.\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>The endDate as a string</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 href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a> with <code>month precision</code></li>\n<li>none of:<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  \n  \n</div>"}

package/dist/content/models/cycleGeneral/cycle-otherSitesUnusedDuration/content.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle Other Sites Unused Duration\n\nThis model sets the [Cycle otherSitesUnusedDuration](https://hestia.earth/schema/Cycle#otherSitesUnusedDuration) based on the `otherSites`, `otherSitesDuration`, and the `longFallowRatio` practice associated with each.\n\n\n\n"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle Other Sites Unused Duration\n\nThis model sets the [Cycle otherSitesUnusedDuration](/schema/Cycle#otherSitesUnusedDuration) based on the `otherSites`, `otherSitesDuration`, and the `longFallowRatio` practice associated with each.\n\n\n\n"}

package/dist/content/models/cycleGeneral/cycle-otherSitesUnusedDuration/cycle.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["otherSitesUnusedDuration"],"modelRequires":["longFallowRatio"]},"content":"# Cycle Other Sites Unused Duration\n\nThis model sets the [Cycle otherSitesUnusedDuration](https://hestia.earth/schema/Cycle#otherSitesUnusedDuration) based on the `otherSites`, `otherSitesDuration`, and the `longFallowRatio` practice associated with each.\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>The otherSitesUnusedDuration as an array of number</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#otherSites\">otherSites</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> with <code>cropland</code> <strong>or</strong> <code>glass and high accessible cover</code></li>\n</ul>\n</li>\n<li><a href=\"https://hestia.earth/schema/Cycle#otherSitesDuration\">otherSitesDuration</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> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/longFallowRatio\">longFallowRatio</a> and a <a href=\"https://hestia.earth/schema/Practice#site\">site</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  \n  \n</div>"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["otherSitesUnusedDuration"],"modelRequires":["longFallowRatio"]},"content":"# Cycle Other Sites Unused Duration\n\nThis model sets the [Cycle otherSitesUnusedDuration](/schema/Cycle#otherSitesUnusedDuration) based on the `otherSites`, `otherSitesDuration`, and the `longFallowRatio` practice associated with each.\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>The otherSitesUnusedDuration as an array of number</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#otherSites\">otherSites</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> with <code>cropland</code> <strong>or</strong> <code>glass and high accessible cover</code></li>\n</ul>\n</li>\n<li><a href=\"https://hestia.earth/schema/Cycle#otherSitesDuration\">otherSitesDuration</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> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Practice#term\">term</a> with <a href=\"https://hestia.earth/term/longFallowRatio\">longFallowRatio</a> and a <a href=\"https://hestia.earth/schema/Practice#site\">site</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  \n  \n</div>"}

package/dist/content/models/cycleGeneral/cycle-siteDuration/content.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle Site Duration\n\nThis model calculates the `siteDuration` on the `Cycle` to the same value as `cycleDuration` when only a single `Site` is present.\n\nNote: on `crop` production cycles:\n* For temporary crops, gap fill only when `startDateDefinition` = `harvest of previous crop`.\n* For permanent crops, no restriction applies.\n\n\n\n"}
+{"tags":{"author":["Guillaume Royer","Florian Payen"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle Site Duration\n\nThis model calculates the `siteDuration` on the `Cycle` to the same value as `cycleDuration` when only a single `Site` is present.\n\nNote: on `crop` production cycles:\n* For temporary crops:\n    * If `startDateDefinition` = `harvest of previous crop`, the `siteDuration` will be equal to the `cycleDuration`.\n    * If `startDateDefinition` = `soil preparation date`, `sowing date` or `transplanting date`, the `siteDuration` will be equal to the `cycleDuration` + `shortFallowDuration`. If the `shortFallowDuration` is not specified in the Cycle's `practices`, the model will not run.\n    * If `startDateDefinition` = `start of year` or `one year prior`, the model will not run.\n* For permanent crops, no restriction applies.\n\n\n\n\n"}

package/dist/content/models/cycleGeneral/cycle-siteDuration/cycle.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["siteDuration"]},"content":"# Cycle Site Duration\n\nThis model calculates the `siteDuration` on the `Cycle` to the same value as `cycleDuration` when only a single `Site` is present.\n\nNote: on `crop` production cycles:\n* For temporary crops, gap fill only when `startDateDefinition` = `harvest of previous crop`.\n* For permanent crops, no restriction applies.\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>the duration as a <code>number</code></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 href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a> <code>&gt; 0</code></li>\n<li>none of:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#otherSites\">otherSites</a></li>\n</ul>\n</li>\n<li>optional:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#primary\">primary</a> = <code>True</code> and <a href=\"https://hestia.earth/schema/Product#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=crop\">crop</a></li>\n</ul>\n</li>\n<li><a href=\"https://hestia.earth/schema/Cycle#startDateDefinition\">startDateDefinition</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  \n  \n</div>"}
+{"tags":{"author":["Guillaume Royer","Florian Payen"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["siteDuration"],"modelRequires":["shortFallowDuration"]},"content":"# Cycle Site Duration\n\nThis model calculates the `siteDuration` on the `Cycle` to the same value as `cycleDuration` when only a single `Site` is present.\n\nNote: on `crop` production cycles:\n* For temporary crops:\n    * If `startDateDefinition` = `harvest of previous crop`, the `siteDuration` will be equal to the `cycleDuration`.\n    * If `startDateDefinition` = `soil preparation date`, `sowing date` or `transplanting date`, the `siteDuration` will be equal to the `cycleDuration` + `shortFallowDuration`. If the `shortFallowDuration` is not specified in the Cycle's `practices`, the model will not run.\n    * If `startDateDefinition` = `start of year` or `one year prior`, the model will not run.\n* For permanent crops, no restriction applies.\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>the duration as a <code>number</code></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 href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a> <code>&gt; 0</code></li>\n<li>none of:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#otherSites\">otherSites</a></li>\n</ul>\n</li>\n<li>optional:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#primary\">primary</a> = <code>True</code> and <a href=\"https://hestia.earth/schema/Product#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=crop\">crop</a></li>\n</ul>\n</li>\n<li>either:<ul>\n<li>if startDateDefinition is <code>harvest of previous crop</code>, no further properties are required:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#startDateDefinition\">startDateDefinition</a> with <code>harvest of previous crop</code></li>\n</ul>\n</li>\n<li>if startDateDefinition is <code>soil preparation date</code>, <code>sowing date</code> or <code>transplanting date</code>, further properties are required:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#startDateDefinition\">startDateDefinition</a> = <code>soil preparation date</code> <strong>or</strong> <code>sowing date</code> <strong>or</strong> <code>transplanting date</code></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#term\">term</a> with <a href=\"https://hestia.earth/term/shortFallowDuration\">shortFallowDuration</a> and <a href=\"https://hestia.earth/schema/Practice#value\">value</a></li>\n</ul>\n</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/crop.csv\">crop.csv</a> -&gt; <code>cropGroupingFAO</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}

package/dist/content/models/cycleGeneral/cycle-siteUnusedDuration/content.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle Site Unused Duration\n\nThis model sets the [Cycle siteUnusedDuration](https://hestia.earth/schema/Cycle#siteUnusedDuration) based on the `siteDuration` and the `longFallowRatio` practice.\n\n\n\n"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle Site Unused Duration\n\nThis model sets the [Cycle siteUnusedDuration](/schema/Cycle#siteUnusedDuration) based on the `siteDuration` and the `longFallowRatio` practice.\n\n\n\n"}

package/dist/content/models/cycleGeneral/cycle-siteUnusedDuration/cycle.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["siteUnusedDuration"],"modelRequires":["longFallowRatio"]},"content":"# Cycle Site Unused Duration\n\nThis model sets the [Cycle siteUnusedDuration](https://hestia.earth/schema/Cycle#siteUnusedDuration) based on the `siteDuration` and the `longFallowRatio` practice.\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>The siteUnusedDuration as a number</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>cropland</code> <strong>or</strong> <code>glass and high accessible cover</code></li>\n</ul>\n</li>\n<li><a href=\"https://hestia.earth/schema/Cycle#siteDuration\">siteDuration</a> <code>&gt; 0</code></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> <code>&gt; 0</code> 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</ul>\n</div>\n  </div>\n  \n  \n</div>"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["siteUnusedDuration"],"modelRequires":["longFallowRatio"]},"content":"# Cycle Site Unused Duration\n\nThis model sets the [Cycle siteUnusedDuration](/schema/Cycle#siteUnusedDuration) based on the `siteDuration` and the `longFallowRatio` practice.\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>The siteUnusedDuration as a number</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>cropland</code> <strong>or</strong> <code>glass and high accessible cover</code></li>\n</ul>\n</li>\n<li><a href=\"https://hestia.earth/schema/Cycle#siteDuration\">siteDuration</a> <code>&gt; 0</code></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> <code>&gt; 0</code> 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</ul>\n</div>\n  </div>\n  \n  \n</div>"}

package/dist/content/models/cycleGeneral/cycle-startDate/content.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle Start Date\n\nThis model sets the [Cycle startDate](https://hestia.earth/schema/Cycle#startDate) based on:\n* the `cycleDuration` and the `endDate` if it has been provided to a day precision (e.g., `2000-01-01`);\n* if no `cycleDuration` is provided, and the `startDate` is set to month precision (e.g., `2000-01`), assumed it started on the 15th of the month.\n\n\n\n"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle Start Date\n\nThis model sets the [Cycle startDate](/schema/Cycle#startDate) based on:\n* the `cycleDuration` and the `endDate` if it has been provided to a day precision (e.g., `2000-01-01`);\n* if no `cycleDuration` is provided, and the `startDate` is set to month precision (e.g., `2000-01`), assumed it started on the 15th of the month.\n\nCycles are understood to take place from the start of the `startDate` (i.e., 00:00:00) to the end of the `endDate` (i.e., 23:59:59). `cycleDuration` is **inclusive** of a Cycle's `endDate`; therefore a Cycle with `endDate` = `2001-12-31` and `cycleDuration` = `365` will have a `startDate` = `2001-01-01`.\n\n\n\n"}

package/dist/content/models/cycleGeneral/cycle-startDate/cycle.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["startDate"]},"content":"# Cycle Start Date\n\nThis model sets the [Cycle startDate](https://hestia.earth/schema/Cycle#startDate) based on:\n* the `cycleDuration` and the `endDate` if it has been provided to a day precision (e.g., `2000-01-01`);\n* if no `cycleDuration` is provided, and the `startDate` is set to month precision (e.g., `2000-01`), assumed it started on the 15th of the month.\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>The startDate as a string</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>optional:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#startDate\">startDate</a> with <code>month precision</code></li>\n<li><a href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a> with <code>day precision</code></li>\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  \n  \n</div>"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["startDate"]},"content":"# Cycle Start Date\n\nThis model sets the [Cycle startDate](/schema/Cycle#startDate) based on:\n* the `cycleDuration` and the `endDate` if it has been provided to a day precision (e.g., `2000-01-01`);\n* if no `cycleDuration` is provided, and the `startDate` is set to month precision (e.g., `2000-01`), assumed it started on the 15th of the month.\n\nCycles are understood to take place from the start of the `startDate` (i.e., 00:00:00) to the end of the `endDate` (i.e., 23:59:59). `cycleDuration` is **inclusive** of a Cycle's `endDate`; therefore a Cycle with `endDate` = `2001-12-31` and `cycleDuration` = `365` will have a `startDate` = `2001-01-01`.\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>The startDate as a string</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>none of:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#startDate\">startDate</a> with <code>in day precision</code></li>\n</ul>\n</li>\n<li>optional:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a> with <code>in day precision</code></li>\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  \n  \n</div>"}

package/dist/content/models/cycleGeneral/cycle-startDateDefinition/content.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle Start Date Definition\n\nThis model sets the [Cycle startDateDefinition](https://hestia.earth/schema/Cycle#startDateDefinition)\nbased on the result of the `cycleDuration` gap-filling model.\n\n\n\n"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"]},"content":"# Cycle Start Date Definition\n\nThis model sets the [Cycle startDateDefinition](/schema/Cycle#startDateDefinition)\nbased on the result of the `cycleDuration` gap-filling model.\n\n\n\n"}

package/dist/content/models/cycleGeneral/cycle-startDateDefinition/cycle.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["startDateDefinition"]},"content":"# Cycle Start Date Definition\n\nThis model sets the [Cycle startDateDefinition](https://hestia.earth/schema/Cycle#startDateDefinition)\nbased on the result of the `cycleDuration` gap-filling model.\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>The startDateDefinition as a string</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 href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a></li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#primary\">primary</a> = <code>True</code> and <a href=\"https://hestia.earth/schema/Product#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=crop\">crop</a></li>\n</ul>\n</li>\n<li>optional:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  \n  \n</div>"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: General"],"tab":["Cycle"],"modelId":["startDateDefinition"]},"content":"# Cycle Start Date Definition\n\nThis model sets the [Cycle startDateDefinition](/schema/Cycle#startDateDefinition)\nbased on the result of the `cycleDuration` gap-filling model.\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>The startDateDefinition as a string</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 href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a></li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#primary\">primary</a> = <code>True</code> and <a href=\"https://hestia.earth/schema/Product#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=crop\">crop</a></li>\n</ul>\n</li>\n<li>optional:<ul>\n<li><a href=\"https://hestia.earth/schema/Cycle#endDate\">endDate</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  \n  \n</div>"}

package/dist/content/models/cycleInputs/cycle-input-hestiaAggregatedData/content.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: Inputs"],"tab":["Cycle"]},"content":"# HESTIA Aggregated Data\n\nThis model adds `impactAssessment` to inputs based on data which has been aggregated into country level averages.\n\nNote: to get more accurate impacts, we recommend setting the [input.impactAssessment](https://hestia.earth/schema/Input#impactAssessment) instead of the region-level averages using this model.\n\nFor `seed` inputs, we will match ImpactAssessment in the following order of priority:\n- match using the value from the lookup `linkedImpactAssessmentTermId`;\n- match using the primary crop product;\n- match using the \"generic\" crop product term.\n\n\n\n"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: Inputs"],"tab":["Cycle"]},"content":"# HESTIA Aggregated Data\n\nThis model adds `impactAssessment` to inputs based on data which has been aggregated into country level averages.\n\nNote: to get more accurate impacts, we recommend setting the [input.impactAssessment](/schema/Input#impactAssessment) instead of the region-level averages using this model.\n\nFor `seed` inputs, we will match ImpactAssessment in the following order of priority:\n- match using the value from the lookup `linkedImpactAssessmentTermId`;\n- match using the primary crop product;\n- match using the \"generic\" crop product term.\n\n\n\n"}

package/dist/content/models/cycleInputs/cycle-input-hestiaAggregatedData/cycle.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: Inputs"],"tab":["Cycle"],"modelId":["impactAssessment"],"modelRequires":["seed"]},"content":"# HESTIA Aggregated Data\n\nThis model adds `impactAssessment` to inputs based on data which has been aggregated into country level averages.\n\nNote: to get more accurate impacts, we recommend setting the [input.impactAssessment](https://hestia.earth/schema/Input#impactAssessment) instead of the region-level averages using this model.\n\nFor `seed` inputs, we will match ImpactAssessment in the following order of priority:\n- match using the value from the lookup `linkedImpactAssessmentTermId`;\n- match using the primary crop product;\n- match using the \"generic\" crop product term.\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/Input\">Inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#impactAssessment\">impactAssessment</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#impactAssessmentIsProxy\">impactAssessmentIsProxy</a> with <code>True</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#value\">value</a> and none of:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Input#impactAssessment\">impactAssessment</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#fromCycle\">fromCycle</a> with <code>True</code></li>\n<li><a href=\"https://hestia.earth/schema/Input#producedInCycle\">producedInCycle</a> with <code>True</code> and optional:</li>\n<li>a <a href=\"https://hestia.earth/schema/Input#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></li>\n</ul>\n</li>\n<li>a <a href=\"https://hestia.earth/schema/Input#region\">region</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></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n<li>optional:<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>cropland</code> <strong>or</strong> <code>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></li>\n</ul>\n</li>\n</ul>\n</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#term\">term</a> with <a href=\"https://hestia.earth/term/seed\">seed</a> and <a href=\"https://hestia.earth/schema/Input#value\">value</a> and none of:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Input#impactAssessment\">impactAssessment</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#value\">value</a> and <a href=\"https://hestia.earth/schema/Product#primary\">primary</a> = <code>True</code></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/seed.csv\">seed.csv</a> -&gt; <code>linkedImpactAssessmentTermId</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: Inputs"],"tab":["Cycle"],"modelId":["impactAssessment"],"modelRequires":["seed"]},"content":"# HESTIA Aggregated Data\n\nThis model adds `impactAssessment` to inputs based on data which has been aggregated into country level averages.\n\nNote: to get more accurate impacts, we recommend setting the [input.impactAssessment](/schema/Input#impactAssessment) instead of the region-level averages using this model.\n\nFor `seed` inputs, we will match ImpactAssessment in the following order of priority:\n- match using the value from the lookup `linkedImpactAssessmentTermId`;\n- match using the primary crop product;\n- match using the \"generic\" crop product term.\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/Input\">Inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#impactAssessment\">impactAssessment</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#impactAssessmentIsProxy\">impactAssessmentIsProxy</a> with <code>True</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#value\">value</a> and none of:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Input#impactAssessment\">impactAssessment</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#fromCycle\">fromCycle</a> with <code>True</code></li>\n<li><a href=\"https://hestia.earth/schema/Input#producedInCycle\">producedInCycle</a> with <code>True</code> and optional:</li>\n<li>a <a href=\"https://hestia.earth/schema/Input#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></li>\n</ul>\n</li>\n<li>a <a href=\"https://hestia.earth/schema/Input#region\">region</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></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n<li>optional:<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>cropland</code> <strong>or</strong> <code>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></li>\n</ul>\n</li>\n</ul>\n</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#term\">term</a> with <a href=\"https://hestia.earth/term/seed\">seed</a> and <a href=\"https://hestia.earth/schema/Input#value\">value</a> and none of:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Input#impactAssessment\">impactAssessment</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#value\">value</a> and <a href=\"https://hestia.earth/schema/Product#primary\">primary</a> = <code>True</code></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/seed.csv\">seed.csv</a> -&gt; <code>linkedImpactAssessmentTermId</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}

package/dist/content/models/cycleInputs/cycle-input-properties/content.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: Inputs"],"tab":["Cycle"]},"content":"# Properties\n\nThis model handles multiple cases:\n- when the [impactAssessment](https://hestia.earth/schema/Input#impactAssessment) field is set, the model\nadds properties to the `Input` when they are connected to another `Cycle` that has an indentical `Product`;\n- when the `dryMatter` property is set, the model recalculates the other properties based on the data from feedipedia;\n- when the `min` and `max` are set, the model averages the `value`.\n\n\n\n"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: Inputs"],"tab":["Cycle"]},"content":"# Properties\n\nThis model handles multiple cases:\n- when the [impactAssessment](/schema/Input#impactAssessment) field is set, the model\nadds properties to the `Input` when they are connected to another `Cycle` that has an indentical `Product`;\n- when the `dryMatter` property is set, the model recalculates the other properties based on the data from feedipedia;\n- when the `min` and `max` are set, the model averages the `value`.\n\n\n\n"}

package/dist/content/models/cycleInputs/cycle-input-properties/cycle.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: Inputs"],"tab":["Cycle"],"modelId":["properties"]},"content":"# Properties\n\nThis model handles multiple cases:\n- when the [impactAssessment](https://hestia.earth/schema/Input#impactAssessment) field is set, the model\nadds properties to the `Input` when they are connected to another `Cycle` that has an indentical `Product`;\n- when the `dryMatter` property is set, the model recalculates the other properties based on the data from feedipedia;\n- when the `min` and `max` are set, the model averages the `value`.\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/Input\">Inputs</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Input#properties\">properties</a></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>either:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Input#impactAssessment\">impactAssessment</a></li>\n<li>a list of <a href=\"https://hestia.earth/schema/Input#properties\">properties</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Property#id\">@id</a> must be set (is linked to an existing Property)</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/crop-property.csv\">crop-property.csv</a> -&gt; <code>dryMatter</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/forage-property.csv\">forage-property.csv</a> -&gt; <code>dryMatter</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/processedFoor-property.csv\">processedFoor-property.csv</a> -&gt; <code>dryMatter</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/property.csv\">property.csv</a> -&gt; <code>feedipediaConversionEnum</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: Inputs"],"tab":["Cycle"],"modelId":["properties"]},"content":"# Properties\n\nThis model handles multiple cases:\n- when the [impactAssessment](/schema/Input#impactAssessment) field is set, the model\nadds properties to the `Input` when they are connected to another `Cycle` that has an indentical `Product`;\n- when the `dryMatter` property is set, the model recalculates the other properties based on the data from feedipedia;\n- when the `min` and `max` are set, the model averages the `value`.\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/Input\">Inputs</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Input#properties\">properties</a></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>either:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Input#impactAssessment\">impactAssessment</a></li>\n<li>a list of <a href=\"https://hestia.earth/schema/Input#properties\">properties</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Property#id\">@id</a> must be set (is linked to an existing Property)</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/crop-property.csv\">crop-property.csv</a> -&gt; <code>dryMatter</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/forage-property.csv\">forage-property.csv</a> -&gt; <code>dryMatter</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/processedFoor-property.csv\">processedFoor-property.csv</a> -&gt; <code>dryMatter</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/property.csv\">property.csv</a> -&gt; <code>feedipediaConversionEnum</code></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}

package/dist/content/models/cycleInputs/cycle-input-value/content.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: Inputs"],"tab":["Cycle"]},"content":"# Value\n\nThis model calculates the `value` of the [Input](https://hestia.earth/schema/Input) by taking an average from the `min` and `max` values.\n\n\n\n"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: Inputs"],"tab":["Cycle"]},"content":"# Value\n\nThis model calculates the `value` of the [Input](/schema/Input) by taking an average from the `min` and `max` values.\n\n\n\n"}

package/dist/content/models/cycleInputs/cycle-input-value/cycle.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"group":["Cycle: Inputs"],"tab":["Cycle"],"modelId":["value"]},"content":"# Value\n\nThis model calculates the `value` of the [Input](https://hestia.earth/schema/Input) by taking an average from the `min` and `max` values.\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/Input\">Inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a></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#min\">min</a> and <a href=\"https://hestia.earth/schema/Input#max\">max</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  \n  \n</div>"}
+{"tags":{"author":["Guillaume Royer"],"group":["Cycle: Inputs"],"tab":["Cycle"],"modelId":["value"]},"content":"# Value\n\nThis model calculates the `value` of the [Input](/schema/Input) by taking an average from the `min` and `max` values.\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/Input\">Inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a></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#min\">min</a> and <a href=\"https://hestia.earth/schema/Input#max\">max</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  \n  \n</div>"}

package/dist/content/models/cycleInputs/hestia-materialAndSubstrate/hestia.json

@@ -1 +1 @@
-{"tags":{"author":["Guillaume Royer"],"contributor":["James Bradbury"],"group":["Cycle: Inputs"],"tab":["HESTIA"],"modelId":["materialAndSubstrate"],"modelRequires":["material"]},"content":"# Material and Substrate\n\nThis model gap-fills depreciated amount per Cycle from Site Infrastructure node.\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/Input\">Inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#model\">model</a> with <a href=\"https://hestia.earth/term/hestia\">hestia</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#min\">min</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#max\">max</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#sd\">sd</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#statsDefinition\">statsDefinition</a></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 material: <a href=\"https://hestia.earth/schema/Completeness#material\">completeness.material</a> must be <code>False</code></li>\n<li><a href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a></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#infrastructure\">infrastructures</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Infrastructure#defaultLifespan\">defaultLifespan</a> and a list of <a href=\"https://hestia.earth/schema/Infrastructure#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=material\">material</a> <strong>or</strong> <a href=\"https://hestia.earth/glossary?termType=substrate\">substrate</a> and <a href=\"https://hestia.earth/schema/Input#value\">value</a> and <a href=\"https://hestia.earth/schema/Input#lifespan\">lifespan</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/material.csv\">material.csv</a></li>\n</ul>\n</div>\n  </div>\n  \n</div>"}
+{"tags":{"author":["Guillaume Royer"],"contributor":["James Bradbury"],"group":["Cycle: Inputs"],"tab":["HESTIA"],"modelId":["materialAndSubstrate"],"modelRequires":["material"]},"content":"# Material and Substrate\n\nThis model gap-fills depreciated amount per Cycle from Site Infrastructure node.\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/Input\">Inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#model\">model</a> with <a href=\"https://hestia.earth/term/hestia\">hestia</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#min\">min</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#max\">max</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#sd\">sd</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#statsDefinition\">statsDefinition</a></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 material: <a href=\"https://hestia.earth/schema/Completeness#material\">completeness.material</a> must be <code>False</code></li>\n<li><a href=\"https://hestia.earth/schema/Cycle#cycleDuration\">cycleDuration</a></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#infrastructure\">infrastructures</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Infrastructure#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=material\">material</a> <strong>or</strong> <a href=\"https://hestia.earth/glossary?termType=substrate\">substrate</a> and <a href=\"https://hestia.earth/schema/Input#value\">value</a> <code>&gt; 0</code> and <a href=\"https://hestia.earth/schema/Input#lifespan\">lifespan</a> <code>&gt; 0</code> and optional:</li>\n<li><a href=\"https://hestia.earth/schema/Infrastructure#defaultLifespan\">defaultLifespan</a> <code>&gt; 0</code></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  \n  \n</div>"}