@hestia-earth/guide 0.0.12 → 0.0.14

package/dist/content/models/siteMetaData/region/content.json

@@ -1,14 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Guillaume Royer"
-    ],
-    "group": [
-      "Site Meta-Data"
-    ],
-    "tab": [
-      "Geospatial Database"
-    ]
-  },
-  "content": "## Region\n\nThis model finds the region that contains the coordinates provided.\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 <a href=\"https://hestia.earth/schema/Term\">Term</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</div>\n  </div>\n\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/Site\">Site</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Site#latitude\">latitude</a></li>\n<li><a href=\"https://hestia.earth/schema/Site#longitude\">longitude</a></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n</div>"
-}

package/dist/content/models/siteMetaData/value/content.json

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

package/dist/content/models/soilEmissions/organicCarbonPerHa/content.json

@@ -1,4 +0,0 @@
-{
-  "tags": {},
-  "content": "## Organic carbon (per ha)"
-}

package/dist/content/models/soilEmissions/organicCarbonPerHa/ipcc2019Tier1.json

@@ -1,14 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Florian Payen"
-    ],
-    "group": [
-      "Soil Emissions"
-    ],
-    "tab": [
-      "IPCC (2019) Tier 1"
-    ]
-  },
-  "content": "## Organic carbon (per ha)\n\nSource: [IPCC (2019), Vol. 4, Chapter 2](https://www.ipcc-nggip.iges.or.jp/public/2019rf/pdf/4_Volume4/19R_V4_Ch02_Generic%20Methods.pdf).\n\n### Overview\n\nThis page is about the IPCC Tier 1 model for estimating SOC stock changes in the 0 - 30 cm depth interval for croplands and grasslands.\n\nThe model estimates the SOC stock changes that occur on Sites after a land use and/or land management change event by linearly interpolating between the initial SOC stock and the new SOC stock equilibrium over the course of 20 years. After 20 years, it is assumed that the new SOC equilibrium has been reached and the ongoing SOC stock change is negligible until a new land use and/or land management change event occurs.\n\nn.b.: land use and/or land management change events that occur before the SOC stock equilibrium has been reached restart the 20 year process.\n\n### How the model works\n\n#### Step 1. Assigning an $SOC_{ref}$\n\nThe $SOC_{ref}$ of a Site represents the SOC stock (kg C ha<sup>-1</sup>) that the soil would have in the 0 - 30 cm depth interval when non-degraded, unimproved and under native vegetation. This reference value will later be multiplied by a series of factors to calculate SOC stock gains or losses from changes in land use and/or land management.\n\nFor most Sites, the $SOC_{ref}$ value is assigned based on the combination of its [`ecoClimateZone`](https://hestia.earth/term/ecoClimateZone) and `IpccSoilCategory`. Once these two elements have been determined for a Site, we can allocate the $SOC_{ref}$ value using the default $SOC_{ref}$ values for mineral soils (kg C ha<sup>-1</sup> in 0 - 30 cm depth interval) provided by the IPCC (2019) (see table below). All values are presented in the format of the mean for the soil by climate combination ± the 95% confidence limit expressed as a percentage of the mean (i.e., ± 1.96 * standard error /mean *100). Values in parentheses are the number of soils included in the derivation of mean and standard error values for each combination of soil and climate types.\n\n|IPCC climate zone|High activity clay soils|Low activity clay soils|Sandy soils|Spodic soils|Volcanic soils|Wetlands soils|\n|-|-|-|-|-|-|-|\n|Polar Moist/Dry (Px - undiff)<sup>2</sup>|59000 ± 41% (24)|NA<sup>1</sup>|27000 ± 67% (18)|NO<sup>1</sup>|NA<sup>1</sup>|NA<sup>1</sup>|\n|Boreal Moist/Dry (Bx - undiff)<sup>2</sup>|63000 ± 18% (35)|NA<sup>1</sup>|10000 ± 90%|117000 ± 90%|20000 ± 90%|116000 ± 65% (6)|\n|Cool temperate dry (C2)|43000 ± 8% (177)|33000 ± 90%|13000 ± 33% (10)|NO<sup>1</sup>|20000 ± 90%|87000 ± 90%|\n|Cool temperate moist (C1)|81000 ± 5% (334)|76000 ± 51% (6)|51000 ± 13% (126)|128000 ± 14% (45)|136000 ± 14% (28)|128000 ± 13% (42)|\n|Warm temperate dry (W2)|24000 ± 5% (781)|19000 ± 16% (41)|10000 ± 5% (338)|NO<sup>1</sup>|84000 ± 65% (10)|74000 ± 17% (49)|\n|Warm temperate moist (W1)|64000 ± 5% (489)|55000 ± 8% (183)|36000 ± 23% (39)|143000 ± 30% (9)|138000 ± 12% (42)|135000 ± 28% (28)|\n|Tropical dry (T4)|21000 ± 5% (554)|19000 ± 10% (135)|9000 ± 9% (164)|NA<sup>1</sup>|50000 ± 90%|22000 ± 17% (32)|\n|Tropical moist (T3)|40000 ± 7% (226)|38000 ± 5% (326)|27000 ± 12% (76)|NA<sup>1</sup>|70000 ± 90%|68000 ± 17% (55)|\n|Tropical wet (T2)|60000 ± 8% (137)|52000 ± 6% (271)|46000 ± 20% (43)|NA<sup>1</sup>|77000 ± 27% (14)|49000 ± 19% (33)|\n|Tropical montane (T1)|51000 ± 10% (114)|44000 ± 11% (84)|52000 ± 34% (11)|NA<sup>1</sup>|96000 ± 31% (10)|82000 ± 50% (12)|\n\nNotes:\n- <sup>1</sup> NA denotes that the soil category may occur in a climate zone, but no data was available. NO denotes that the soil type does not normally occur within a climate zone.\n- <sup>2</sup> The Boreal dry and Boreal moist zones and the Polar dry and Polar moist zones were not differentiated. Results presented represent the SOC30 stocks for the undifferentiated (undiff.) Boreal (Bx) and Polar (Px) classes.\n\n##### IPCC eco-climate zones\n\nThe IPCC divides the globe into 12 broad eco-climate zones:\n- Polar dry (P2)\n- Polar moist (P1)\n- Boreal dry (B2)\n- Boreal moist (B1)\n- Cool temperate dry (C2)\n- Cool temperate moist (C1)\n- Warm temperate dry (W2)\n- Warm temperate moist (W1)\n- Tropical dry (T4)\n- Tropical moist (T3)\n- Tropical wet (T2)\n- Tropical montane (T1)\n\n![World divided into eco-climate zones.](/assets/ipccClimateZones.png)\n\nWorld divided into eco-climate zones.\n\nThese climate classes were defined by the [IPCC (2006), Vol. 4, Chapter 3, p. 3.39)](https://www.ipcc-nggip.iges.or.jp/public/2006gl/pdf/4_Volume4/V4_03_Ch3_Representation.pdf) using elevation, mean annual temperature (MAT), mean annual precipitation (MAP), mean annual precipitation to potential evapotranspiration (PET) ratio and frost occurrence.\n\nThe IPCC eco-climate zone of a Site is automatically gap-filled by Hestia when data is uploaded using the Site's geo-location data (`site.latitude` & `site.longitude` or `site.region`).\n\n##### IPCC soil categories\n\nThe 7 IPCC soil categories are:\n\n|`IpccSoilCategory`|Description|\n|-|-|\n|`ORGANIC_SOILS`|Soils having organic material (Histosols).<br/><br/>The model **should not run** for any Sites assigned this category.|\n|`HIGH_ACTIVITY_CLAY_SOILS`|Soils with high activity clay (HAC) minerals are lightly to moderately weathered soils dominated by 2:1 silicate clay minerals (in the World Reference Base for Soil Resources (WRB) classification: Leptosols, Vertisols, Kastanozems, Chernozems, Phaeozems, Luvisols, Alisols, Albeluvisols, Solonetz, Calcisols, Gypsisols, Umbrisols, Cambisols, Regosols; in USDA classification: Mollisols, Vertisols, high-base status Alfisols, Aridisols, Inceptisols).|\n|`LOW_ACTIVITY_CLAY_SOILS`|Soils with low activity clay (LAC) minerals are highly weathered soils, dominated by 1:1 clay minerals and amorphous iron and aluminium oxides (in WRB classification: Acrisols, Lixisols, Nitisols, Ferralsols, Durisols; in USDA classification: Ultisols, Oxisols, acidic Alfisols).|\n|`SANDY_SOILS`|Soils (regardless of taxonomic classification) having > 70% sand and < 8% clay (in WRB classification: Arenosols; in USDA classification: Psamments).|\n|`SPODIC_SOILS`|Soils exhibiting strong podzolization (in WRB classification: Podzols; in USDA classification: Spodosols).|\n|`VOLCANIC_SOILS`|Soils derived from volcanic ash with allophanic mineralogy (in WRB classification: Andosols; in USDA classification: Andisols).|\n|`WETLAND_SOILS`|Soils with restricted drainage leading to periodic flooding and anaerobic conditions (in WRB classification: Gleysols; in USDA classification: Aquic suborders).|\n\n##### Assigning an IPCC soil category\n\nTo assign an `IpccSoilCategory` to a Site, we use the [`soilType`](https://hestia.earth/glossary?termType=soilType) or [`usdaSoilType`](https://hestia.earth/glossary?termType=usdaSoilType) nodes in [`site.measurements`](https://hestia.earth/schema/Site#measurements). To satisfy the requirements of each soil category, soil types belonging to that category must cover more than 30% of the Site.\n\nFirst, we check for measurements with terms in the [`soilType`](https://hestia.earth/glossary?termType=soilType) glossary in the following order:\n\n![Flow diagram for assigning an IPCC soil category from WRB soil type.](/assets/organicCarbonPerHa-figure1.png)\nFlow diagram for assigning an IPCC soil category from WRB soil type.\n\nIf a category has not been assigned, we try again checking for measurements with terms in the [`usdaSoilType`](https://hestia.earth/glossary?termType=usdaSoilType) glossary in the following order:\n\n![Flow diagram for assigning an IPCC soil category from USDA soil type.](/assets/organicCarbonPerHa-figure2.png)\nFlow diagram for assigning an IPCC soil category from USDA soil type.\n\nTODO: Remake flow charts as mermaid diagrams and include the organic soils step.\n\nIf a soil category has not been assigned after following both decision trees, the Site should be assigned the default category of `IpccSoilCategory.LOW_ACTIVITY_CLAY_SOILS`.\n\nn.b., An $SOC_{ref}$ cannot be assigned for all combinations of [`ecoClimateZone`](https://hestia.earth/term/ecoClimateZone) and `IpccSoilCategory`. This is because some soil categories do not normally occur within all climate zones or because no data was available to calculate a reference value. In these cases, the model **should not run**.\n\n#### Step 2. Compiling an annual inventory\n\nOnce an $SOC_{ref}$ has been assigned to a Site, we need to compile an annual inventory of the land use and land management of the Site. For each year of the inventory, we summarise the nodes in [`site.management`](https://hestia.earth/schema/Site#management) by assigning an `IpccLandUseCategory`. For some land use categories, we then assign an additional `IpccManagementCategory` and `IpccCarbonInputCategory`.\n\n##### IPCC land use categories\n\nThe `IpccLandUseCategory` categories are:\n\n|`IpccLandUseCategory`|Description|\n|-|-|\n|`GRASSLAND`|All native and/or permanent grassland. <br/><br/> An additional grassland management category **must** be assigned.|\n|`ANNUAL_CROPS`|Represents area that has been converted from native conditions and continuously managed for predominantly annual crops over 50 years. <br/><br/> Additional tillage management and cropland carbon input categories **must** be assigned.|\n|`ANNUAL_CROPS_WET`|Represents area with mineral wetland soils that has been converted from native conditions and continuously managed for predominantly annual crops over 50 years. <br/><br/> Additional tillage management and cropland carbon input categories **must** be assigned.|\n|`PADDY_RICE_CULTIVATION`|Long-term (> 20 years) annual cropping of wetlands (paddy rice). Can include double-cropping with non-flooded crops.|\n|`PERENNIAL_CROPS`|Long-term perennial tree crops such as fruit and nut trees, coffee and cacao.|\n|`SET_ASIDE`|Represents temporary (< 20 years) set aside of annual cropland (e.g., conservation reserves) or other idle cropland that has been revegetated with perennial grasses.|\n|`FOREST`|All native and/or permanent forest.|\n|`NATIVE`|Any other native vegetation.|\n|`OTHER`|Any other land use. The model should not run for any inventory years assigned this category.|\n\n##### IPCC management categories\n\n*For grasslands*:\n\nThe management categories for inventory years with `IpccLandUseCategory.GRASSLAND` are:\n\n|`IpccManagementCategory`|Description|\n|-|-|\n|`IMPROVED_GRASSLAND`|Represents grassland that is sustainably managed with light to moderate grazing pressure (or cutting and removal of vegetation) and that receive at least one improvement (e.g., fertilisation, species improvement, irrigation). <br/><br/> An additional grassland carbon input category **must** be assigned.|\n|`HIGH_INTENSITY_GRAZING`|Represents high intensity grazing systems (or cutting and removal of vegetation) with shifts in vegetation composition and possibly productivity but is not severely degraded.|\n|`NOMINALLY_MANAGED`|Represents low or medium intensity grazing regimes, in addition to periodic cutting and removal of above-ground vegetation, without significant management improvements. High intensity grazing may be moderately degraded, but it does not represent excessive grazing intensity that leads to severe grassland degradation.|\n|`SEVERELY_DEGRADED`|Implies major long-term loss of productivity and vegetation cover, due to severe mechanical damage to the vegetation and/or severe soil erosion.|\n\nFor inventory years assigned `IpccLandUseCategory.GRASSLAND`, a default management category of `IpccManagementCategory.NOMINALLY_MANAGED` should be assigned if the `landCover` management data is insufficient to assign another category.\n\n*For annual croplands*:\n\nThe management categories for inventory years with `IpccLandUseCategory.ANNUAL_CROPS` or `IpccLandUseCategory.ANNUAL_CROPS_WET` are:\n\n|`IpccManagementCategory`|Description|\n|-|-|\n|`FULL_TILLAGE`|Substantial soil disturbance with full inversion and/or frequent (within year) tillage operations. At planting time, little (e.g., <30%) of the surface is covered by residues.|\n|`REDUCED_TILLAGE`|Primary and/or secondary tillage but with reduced soil disturbance (usually shallow and without full soil inversion). Normally leaves surface with >30% coverage by residues at planting.|\n|`NO_TILLAGE`|Direct seeding without primary tillage, with only minimal soil disturbance in the seeding zone. Herbicides are typically used for weed control.|\n\nFor inventory years assigned `IpccLandUseCategory.ANNUAL_CROPS` or `IpccLandUseCategory.ANNUAL_CROPS_WET`, a default management category of `IpccManagementCategory.FULL_TILLAGE` should be assigned if the `tillage` management data is insufficient to assign another category.\n\n##### IPCC carbon input categories\n\n*For grasslands*:\n\nThe carbon input categories for inventory years with `IpccManagementCategory.IMPROVED_GRASSLAND` are:\n\n|`IpccCarbonInputCategory`|Description|\n|-|-|\n|`GRASSLAND_MEDIUM`|Applies to improved grassland where a single management input or improvement has been made.|\n|`GRASSLAND_HIGH`|Applies to improved grassland where two or more management inputs or improvements have been used.|\n\nFor inventory years assigned `IpccManagementCategory.IMPROVED_GRASSLAND`, a default carbon input category of `IpccCarbonInputCategory.GRASSLAND_MEDIUM` should be assigned if the management data is insufficient to assign another category.\n\n*For annual croplands*:\n\nThe carbon input categories for inventory years with `IpccLandUseCategory.ANNUAL_CROPS` or `IpccLandUseCategory.ANNUAL_CROPS_WET` are:\n\n|`IpccCarbonInputCategory`|Description|\n|-|-|\n|`CROPLAND_LOW`|Low residue return occurs when there is removal of residues (via collection or burning), frequent bare-fallowing, production of crops yielding low residues (e.g., vegetables, tobacco, cotton), no mineral fertilisation or no N-fixing crops.|\n|`CROPLAND_MEDIUM`|Representative for annual cropping with cereals where all crop residues are returned to the field. If residues are removed, then supplemental organic matter (e.g., manure) is added. Also requires mineral fertilisation or N-fixing crop in rotation.|\n|`CROPLAND_HIGH_WITHOUT_MANURE`|Represents significantly greater crop residue inputs over medium carbon input cropping systems due to additional practices, such as production of high residue yielding crops, use of green manures, cover crops, improved vegetated fallows, irrigation, frequent use of perennial grasses in annual crop rotations, but without manure applied (see row below).|\n|`CROPLAND_HIGH_WITH_MANURE`|Represents significantly higher carbon input over medium carbon input cropping systems due to an additional practice of regular addition of animal manure.|\n\nFor inventory years assigned `IpccLandUseCategory.ANNUAL_CROPS` or `IpccLandUseCategory.ANNUAL_CROPS_WET`, a default carbon input category of `IpccCarbonInputCategory.CROPLAND_LOW` should be assigned if the management data is insufficient to assign another category.\n\n##### Assigning land use, management and carbon input categories\n\nTo assign land use, management and carbon input categories, we use the nodes in [`site.management`](https://hestia.earth/schema/Site#management). To satisfy the requirements of each step in the flow diagram, appropriate managements must have been used on more than 30% of the Site.\n\n*For grasslands*:\n\n![Flow diagram for assigning IPCC categories in grasslands.](/assets/organicCarbonPerHa-figure3.png)\n\nn.b., land cover, land management practices and improvements must cover >30% of the Site's area to satisfy the condition.\n\n*For croplands*:\n\n![Flow diagram for assigning IPCC categories in croplands.](/assets/organicCarbonPerHa-figure4.png)\n\nn.b., land cover, land management practices and improvements must cover >30% of the Site's area to satisfy the condition.\n\nTODO: Remake flow charts as mermaid diagrams and harmonise everything to more accurately reflect the Hestia implementation.\n\nA land-use factor $F_{LU}$, a management factor $F_{MG}$ and a carbon input factor $F_{CI}$ can then be retrieved based on the `IpccLandUseCategory`, the `IpccManagementCategory` and the `IpccCarbonInputCategory` allocated for each year of the Site's inventory using the default relative stock change factors provided by the IPCC (2019) (see tables below):\n\n![Relative stock change factors for grassland management.](/assets/organicCarbonPerHa-figure5.png)\n![Relative stock change factors for cropland management.](/assets/organicCarbonPerHa-figure6.png)\n![Screenshot_2024-05-07_at_19.44.51](/assets/organicCarbonPerHa-figure7.png)\n\n#### Step 3. Calculating SOC equilibriums\n\nFor each year in the inventory, we estimate the soil organic carbon equilibrium ($SOC_{eq}$), which describes the stable SOC stock that the Site would reach if the land use and land management remained consistent for 20 years:\n\n>$$\n>SOC_{eq} = SOC_{ref} * F_{LU} * F_{MG} * F_{CI}\n>$$\n>\n>Where:\n>\n>* $SOC_{eq}$ = the SOC equilibrium for the Site under a specific land use and land management regime, kg C ha<sup>-1</sup>.\n>* $SOC_{ref}$ = the SOC stock for mineral soils in the reference condition, kg C ha<sup>-1</sup>.\n>* $F_{LU}$ = the stock change factor for a particular land use, dimensionless.\n>* $F_{MG}$ = the stock change factor for a particular land management regime, dimensionless.\n>* $F_{CI}$ = the stock change factor for a particular carbon input regime, dimensionless.\n>\n>Source: [IPCC (2019)](https://www.ipcc-nggip.iges.or.jp/public/2019rf/pdf/4_Volume4/19R_V4_Ch02_Generic%20Methods.pdf)\n\nTODO: redo the tables above as real tables instead of image.\n\n#### Step 4. Interpolating between SOC equilibriums\n\nStarting from the earliest year in the inventory, we can then interpolate linearly between $SOC_{eq}$ values following changes in land use and/or land management for each year of the Site's inventory according to the following equation:\n\n>$$\n>SOC_{0+T} = SOC_{0} + \\frac{min(T, 20)}{20}(SOC_{eq} - SOC_{0})\n>$$\n>\n>Where:\n>\n>* $SOC_{0+T}$ = the soil organic carbon stock $T$ years after the most recent land use and/or land management change, kg C ha<sup>-1</sup>.\n>* $SOC_{0}$ = the soil organic carbon stock when the land use and/or land management change occurred, kg C ha<sup>-1</sup>.\n>* $SOC_{eq}$ = the soil organic carbon equilibrium for the Site under the most recent land use, management regime and carbon input regime, kg C ha<sup>-1</sup>.\n>* $T$ = the number of years since the most recent land use and/or land management change event, yr.\n>\n>If $T>20$ it is capped to twenty as annual SOC stock changes are assumed to be negligible after the $SOC_{eq}$ has been reached if land use and land management remain consistent.\n>\n>Source: [IPCC (2019)](https://www.ipcc-nggip.iges.or.jp/public/2019rf/pdf/4_Volume4/19R_V4_Ch02_Generic%20Methods.pdf)\n\n### Data recommendations\n\nFor inventory years to be assigned the correct `IpccManagementCategory` and `IpccCarbonInputCategory`, it is imperative that the management data is as complete as possible.\n\nFor each year of the inventory, we recommend specifying the following:\n\n*For grassland years*:\n\n  * Grassland condition, using the terms [`highIntensityGrazingPasture`](https://hestia.earth/term/highIntensityGrazingPasture), [`improvedPasture`](https://hestia.earth/term/improvedPasture), [`nativePasture`](https://hestia.earth/term/nativePasture), [`nominallyManagedPasture`](https://hestia.earth/term/nominallyManagedPasture) and/or [`severelyDegradedPasture`](https://hestia.earth/term/severelyDegradedPasture).\n  * Irrigation, using terms in the [water regime glossary](https://hestia.earth/glossary?termType=waterRegime).\n  * Inputs to soil, using the terms [`amendmentIncreasingSoilCarbonUsed`](https://hestia.earth/term/amendmentIncreasingSoilCarbonUsed), [`animalManureUsed`](https://hestia.earth/term/animalManureUsed), [`inorganicNitrogenFertiliserUsed`](https://hestia.earth/term/inorganicNitrogenFertiliserUsed) and/or [`organicFertiliserUsed`](https://hestia.earth/term/organicFertiliserUsed).\n  * Any terms in the [land cover glossary](https://hestia.earth/glossary?termType=landCover) to specify the type of grass or fresh forage grown.\n\n*For cropland years*:\n\n  * Tillage, using terms in the [tillage glossary](https://hestia.earth/glossary?termType=tillage).\n  * Irrigation, using terms in the [water regime glossary](https://hestia.earth/glossary?termType=waterRegime).\n  * Crop residue management, using terms in the [crop residue management glossary](https://hestia.earth/glossary?termType=cropResidueManagement).\n  * Inputs to soil, using the terms [`amendmentIncreasingSoilCarbonUsed`](https://hestia.earth/term/amendmentIncreasingSoilCarbonUsed), [`animalManureUsed`](https://hestia.earth/term/animalManureUsed), [`inorganicNitrogenFertiliserUsed`](https://hestia.earth/term/inorganicNitrogenFertiliserUsed) and/or [`organicFertiliserUsed`](https://hestia.earth/term/organicFertiliserUsed).\n  * Use of cover crops, using terms in the [land cover glossary](https://hestia.earth/glossary?termType=landCover) plus one of the following properties: [`catchCrop`](https://hestia.earth/term/catchCrop), [`coverCrop`](https://hestia.earth/term/coverCrop), [`groundCover`](https://hestia.earth/term/groundCover), [`longFallowCrop`](https://hestia.earth/term/longFallowCrop) and/or [`shortFallowCrop`](https://hestia.earth/term/shortFallowCrop).\n\n### Example\n\n|Eco-climate zone|`IpccSoilCategory`|$SOC_{ref}$ (kg C ha<sup>-1</sup>)|\n|-|-|-|\n|Cool temperate dry|`HIGH_ACTIVITY_CLAY_SOILS`|43000|\n\n|Year|`IpccLandUseCategory`|`IpccManagementCategory`|`IpccCarbonInputCategory`|`organicCarbonPerHa` (kg C ha<sup>-1</sup>)|\n|-|-|-|-|-|\n|2014|`ANNUAL_CROPS`|`FULL_TILLAGE`|`CROPLAND_LOW`|31455|\n|2015|`ANNUAL_CROPS`|`FULL_TILLAGE`|`CROPLAND_LOW`|31455|\n|2016|`ANNUAL_CROPS`|`FULL_TILLAGE`|`CROPLAND_LOW`|31455|\n|2017|`ANNUAL_CROPS`|`FULL_TILLAGE`|`CROPLAND_MEDIUM`|31537|\n|2018|`ANNUAL_CROPS`|`FULL_TILLAGE`|`CROPLAND_MEDIUM`|31620|\n|2019|`ANNUAL_CROPS`|`REDUCED_TILLAGE`|`CROPLAND_MEDIUM`|31661|\n|2020|`ANNUAL_CROPS`|`REDUCED_TILLAGE`|`CROPLAND_HIGH_WITH_MANURE`|32301|\n|2021|`ANNUAL_CROPS`|`REDUCED_TILLAGE`|`CROPLAND_HIGH_WITH_MANURE`|32940|\n|2022|`ANNUAL_CROPS`|`REDUCED_TILLAGE`|`CROPLAND_HIGH_WITH_MANURE`|33580|\n|2023|`ANNUAL_CROPS`|`REDUCED_TILLAGE`|`CROPLAND_HIGH_WITH_MANURE`|34220|\n\n![Graph displaying the Tier 1 SOC model outputs.](/assets/organicCarbonPerHa-figure8.png)\n\nGraph displaying the Tier 1 SOC model outputs.\n\n### Discussion\n\nWhile the Tier 1 methodology is useful due to its relatively low data requirements (i.e., user uploads generally report the required data and/or the required data can be easily gap-filled using other Hestia models), the methodology does have some important flaws:\n\n* Neither `soilType` nor `usdaSoilType` are gap-filled using geospatial models by the Hestia platform yet. Therefore, they must be specified in the user upload (see [issue 741](https://gitlab.com/hestia-earth/hestia-engine-models/-/issues/741)).\n* There are no factors for different land management and carbon input regimes for forests, paddy-rice cultivation and perennial crops. New factors should be calculated to make the model more useful for these land uses (see [issue 658](https://gitlab.com/hestia-earth/hestia-engine-models/-/issues/658)).\n* The model must be extended to meet the requirements of new reporting standards:\n  - Country-specific factors must be calculated to bump the method up to Tier 2 (see [issue 757](https://gitlab.com/hestia-earth/hestia-engine-models/-/issues/757)).\n  - The uncertainty of model results must be calculated and reported (see [issue 753](https://gitlab.com/hestia-earth/hestia-engine-models/-/issues/753)).\n\nThere is also a downstream issue, specific to the Tier 1 methodology, regarding the allocation of emissions due to SOC stock changes. The Tier 1 methodology can be used to estimate SOC stock changes due to land use changes (`IpccLandUseCategory`) AND land management changes (`IpccManagementCategory` & `IpccCarbonInputCategory`). However, to meet reporting requirements, CO<sub>2</sub> emissions from SOC stock changes should be disaggregated into those due to land use changes ([`co2ToAirSoilCarbonStockChangeManagementChange`](https://www.hestia.earth/term/co2ToAirSoilCarbonStockChangeManagementChange)) and those due to land management changes ([`co2ToAirSoilCarbonStockChangeLandUseChange`](https://www.hestia.earth/term/co2ToAirSoilCarbonStockChangeLandUseChange)). Currently, the Hestia platform has no way of disaggregating these emissions and all CO<sub>2</sub> emissions from SOC stock changes are accounted for by the `ipcc2019.co2ToAirSoilCarbonStockChangeManagementChange` model. Further work will be required to disaggregate these emissions (see [issue \\*\\*\\*]()).\n\n**Finally, the model currently only outputs a `value`, but it does not calculate any descriptive statistics for its results (i.e., `sd`, `min` and `max`); however, it is a reporting requirement (TODO: add which reporting guidelines) to provide the min, max and uncertainty of modelled `organicCarbonPerHa` values if CO<sub>2</sub> is reported to have been removed from the atmosphere via SOC stock changes. We are currently working to address this by running the model as a Monte Carlo simulation (see [issue 753](https://gitlab.com/hestia-earth/hestia-engine-models/-/issues/753)).**\n\n\n\n"
-}

package/dist/content/models/soilEmissions/organicCarbonPerHa/ipcc2019Tier2.json

@@ -1,14 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Florian Payen"
-    ],
-    "group": [
-      "Soil Emissions"
-    ],
-    "tab": [
-      "IPCC (2019) Tier 2"
-    ]
-  },
-  "content": "## Organic carbon (per ha)\n\nSource: [IPCC (2019), Vol. 4, Chapter 5](https://www.ipcc-nggip.iges.or.jp/public/2019rf/pdf/4_Volume4/19R_V4_Ch05_Cropland.pdf).\n\n### Overview\n\nThe IPCC Tier 2 steady-state method is used to estimate soil organic carbon stock changes in the 0 - 30 cm depth interval for croplands remaining croplands.\n\nThis approach estimates carbon stock changes using annual carbon input data (through crop residues and organic amendments); annual tillage data; monthly irrigation data; and monthly climate data (temperature, precipitation and potential evapotranspiration). The Hestia platform constructs an annual inventory of this data (sourcing data from Site nodes and their linked Cycle nodes). The inventory is used to model the annual carbon gains and losses of three organic carbon sub-pool: active, slow and passive. A final `organicCarbonPerHa` value is calculated by summing together these three sub-pools.\n\n![A diagram of organic carbon flows between carbon sub-pools.](/assets/organicCarbonPerHa-figure9.png)\n\nA diagram of organic carbon flows between carbon sub-pools.\n\n### How the model works\n\n#### Step 1: Building the time series using Site and Cycle data\n\nThis step consists of retrieving and organising the input data for the model. For each year in the time series, we need:\n\n1. Climate data: `temperatureMonthly` (deg C), `precipitationMonthly` (mm), and `potentialEvapotranspirationMonthly` (PET) (mm month<sup>-1</sup>).\n2. Organic carbon sources (with a `value` (kg) and the the properties `carbonContent` (%), `nitrogenContent` (%), and `ligninContent` (%)). Carbon sources include: `aboveGroundCropResidueLeftOnField`, `aboveGroundCropResidueIncorporated`, `belowGroundCropResidue`, `discardedCropLeftOnField`, `discardedCropIncorporated`, `Organic fertilisers` and specific `Soil amendments`.\n3. _(Optional)_ irrigation: whether or not irrigation is used for each month in the time series.\n4. _(Optional)_ annual IPCC tillage category for each month in the time series: `FULL_TILLAGE`, `REDUCED_TILLAGE`, `NO_TILLAGE`, or `OTHER` (unknown tillage).\n\n#### Step 2: Retrieving model parameters\n\nThis is a relatively simple step as we are only using the IPCC default parameters (but the model could be extended by calculating more specific model parameters for specific use cases in the future, e.g., for specific crop types, etc.)\n\n1. Select model parameters.\n2. Retrieve the sand content of the soil.\n\nThe default parameters provided by the IPCC (2019) are provided in the table below:\n\n|Parameter|value|minimum|maximum|sd|description|\n|-|-|-|-|-|-|\n|`active_decay_factor`|7.4|-|-|n/a|Decay rate constant under optimal conditions for decomposition of the active sub-pool.|\n|`slow_decay_factor`|0.209|0.058|0.3|0.566|Decay rate constant under optimal conditions for decomposition of the slow sub-pool.|\n|`passive_decay_factor`|0.00689|0.005|0.01|0.00125|Decay rate constant under optimal conditions for decomposition of the passive sub-pool.|\n|`f_1`|0.378|0.01|0.8|0.0719|Fraction of metabolic dead organic matter decay.|\n|`f_2_full_tillage`|0.455|-|-|n/a|Fraction of structural dead organic matter decay products transferred the active sub-pool under full tillage (source Vol 4. Ch. 5 Excel attachment).|\n|`f_2_reduced_tillage`|0.477|-|-|n/a|Fraction of structural dead organic matter decay products transferred the active sub-pool under reduced tillage (source Vol 4. Ch. 5 Excel attachment).|\n|`f_2_no_tillage`|0.5|-|-|n/a|Fraction of structural dead organic matter decay products transferred the active sub-pool under no tillage (source Vol 4. Ch. 5 Excel attachment).|\n|`f_2_unknown_tillage`|0.368|0.007|0.5|0.0998|Fraction of structural dead organic matter decay products transferred the active sub-pool under unknown tillage.|\n|`f_3`|0.455|0.1|0.8|0.201|Fraction of structural dead organic matter decay products transferred to the slow sub-pool.|\n|`f_5`|0.0855|0.037|0.1|0.0122|Fraction of active sub-pool decay products transferred to the passive sub-pool.|\n|`f_6`|0.0504|0.02|0.19|0.0280|Fraction of slow sub-pool decay products transferred to the passive sub-pool.|\n|`f_7`|0.42|-|-|n/a|Fraction of slow sub-pool decay products transferred to the active sub-pool.|\n|`f_8`|0.45|-|-|n/a|Fraction of passive sub-pool decay products transferred to the active sub-pool.|\n|`tillage_factor_full_tillage`|3.036|1.4|4.0|0.579|Full tillage disturbance modifier for decay rates.|\n|`tillage_factor_reduced_tillage`|2.075|1.0|3.0|0.569|Reduced tillage disturbance modifier for decay rates.|\n|`tillage_factor_no_tillage`|1|-|-|n/a|No tillage disturbance modifier for decay rates.|\n|`maximum_temperature`|45|-|-|n/a|Maximum monthly average temperature for decomposition.|\n|`optimum_temperature`|33.69|30.7|35.34|0.66|Optimum temperature to estimate temperature modifier on decomposition.|\n|`water_factor_slope`|1.331|0.8|2.0|0.386|Slope parameter for estimating annual water factors.|\n|`default_carbon_content`|0.42|-|-|n/a|The default carbon content of crop residues as a decimal proportion of dry matter mass.|\n\n#### Step 3: Pre-processing climate and carbon input data\n\n1. Calculate the annual temperature factors from the monthly average temperature data (see `_run_annual_temperature_factors`).\n2. Calculate the annual water factors from the monthly sum precipitation, monthly sum PET, and monthly irrigation used (see `_run_annual_water_factors`).\n3. Calculate annual organic carbon input, the average nitrogen content of carbon sources, and the average lignin content of carbon sources (see `_run_annual_organic_carbon_inputs`).\n\n#### Step 4: Running the model\n\nThis is to describe the sequence of what the model (`_run_soc_stocks`) does, in the following order:\n\n1. Calculates the _f_4_ parameter based on the sand content of the soil.\n2. Retrieves the correct _f_2_ parameter for each year in the time series based on the tillage category.\n3. Retrieves the correct tillage factor for each year in the time series based on the tillage category.\n4. Separates the time series into \"run-in\" and \"inventory\". The \"run-in\" consists of the first five years of the time series; it is used by the model to calculate an initial value of SOC stock. It is mandatory for Tier 2 to work. The five years of the \"run-in\" are averaged by the model to create the first year of the \"inventory\". Then, all subsequent years in the time series are added to the \"inventory\" without any manipulation. The last year of the inventory would correspond to the final value of SOC stock calculated by the model. (See `time_series_to_inventory` helper function.)\n5. Calculates the steady-state SOC stock (in kg C / ha) for each year in the **inventory** for the active, slow and passive sub-pools. (The steady-state corresponds to the SOC stock of each sub-pool if the soil was at equilibrium under specific management practices and climatic conditions.)\n6. Calculates the estimated SOC stock (in kg C / ha) for each year in the **inventory** for the active, slow and passive sub-pools based on the steady-state SOC stock value and the annual decay factors. The initial SOC stock is the steady-state value of the first year of the inventory (i.e. the average of the five years of the run-in).\n7. Calculates the total SOC stock for each year of the **inventory** by summing together the SOC stock values from each of the three sub-pools.\n\nTODO: simplify step-by-step section.\n\n#### Tier 2 model cut-off points:\n\n* If there are fewer than 5 successive inventory years overall on a Site, Tier 2 **cannot** run. This is due to the fact that the Tier 2 methodology requires five consecutive years of run-in data to estimate the initial SOC stock. A Tier 1 methodology should be considered instead.\n* If there are gaps in the time series, the Tier 2 model **cannot** be used as it requires the knowledge of the previous years' SOC stocks to calculate the next. It would be preferable to use a Tier 1 approach instead, as Tier 1 can interpolate between years. However, if separate time series of longer than 5 years each can be constructed for a single Site, then the Tier 2 model can work. We are currently working on a way to run Tier 1 for the missing years in the time series and feed Tier 1's outputs into the Tier 2 methodology (see [issue 752](https://gitlab.com/hestia-earth/hestia-engine-models/-/issues/752)).\n* If the amount of above-ground and below-ground crop residues is unknown and cannot not be estimated (e.g., if yield values & the yield to above-ground residue ratio or if default above-ground & below-ground crop residues are not known), Tier 2 **cannot** run. But, if crop residue management is known (i.e., the percentage of crop residues left on field, incorporated, removed or burnt), Tier 1 could be selected instead.\n\n### Data recommendations\n\nThe Tier 2 model **cannot** run for years where the total carbon input to the soil is equal to 0 kg (as such a situation is not realistic and is beyond the bounds of the mathematics used by the model). This means that if the mass of each carbon source applied to the soil is not given in the upload and cannot be estimated using other information provided in the upload, the total carbon input will default to 0 kg, and Tier 2 will not run. A Tier 1 approach should be used instead, if possible.\n\n### Example\n\n*Site measurements*:\n\n|Measurement|Value|Unit|\n|-|-|-|\n|`sandContent`|25|%|\n|`temperatureMonthly`<sup>*</sup>|16|°C|\n|`precipitationMonthly`<sup>*</sup>|45|mm|\n|`potentialEvapotranspirationMonthly`<sup>*</sup>|88|mm|\n\n<sup>*</sup> Average value for brevity.\n\n*Carbon source properties*:\n\n|Carbon source|`carbonContent` (%)|`nitrogenContent` (%)|`ligninContent` (%)|\n|-|-|-|-|\n|`aboveGroundCropResidueIncorporated`|42|0.7|5.3|\n|`belowGroundCropResidue`|42|0.9|7.3|\n|`manureDryKgMass`|38.4|2.65|9.67|\n\n*Site measurements*:\n\n|Year|`IpccManagementCategory`|`belowGroundCropResidue` (kg ha<sup>-1</sup>)|`aboveGroundCropResidueIncorporated` (kg ha<sup>-1</sup>)|`manureDryKgMass` (kg ha<sup>-1</sup>)|Carbon input (kg C ha<sup>-1</sup>)|Avg. N content<sup>*</sup> (%)|Avg. lignin content<sup>*</sup> (%)|`organicCarbonPerHa` (kg C ha<sup>-1</sup>)|\n|-|-|-|-|-|-|-|-|-|\n|2014|`FULL_TILLAGE`|3570|0|0|1500|0.9|7.3|-|\n|2015|`FULL_TILLAGE`|3570|0|0|1500|0.9|7.3|-|\n|2016|`FULL_TILLAGE`|3570|0|0|1500|0.9|7.3|-|\n|2017|`FULL_TILLAGE`|3570|3570|0|3000|0.9|7.3|-|\n|2018|`FULL_TILLAGE`|3570|3570|0|3000|0.9|7.3|31409|\n|2019|`REDUCED_TILLAGE`|3570|3570|0|3000|0.9|7.3|32215|\n|2020|`REDUCED_TILLAGE`|3570|3570|7810|6000|1.8|8.5|34238|\n|2021|`REDUCED_TILLAGE`|3570|3570|7810|6000|1.8|8.5|35501|\n|2022|`REDUCED_TILLAGE`|3570|3570|7810|6000|1.8|8.5|36472|\n|2023|`REDUCED_TILLAGE`|3570|3570|7810|6000|1.8|8.5|37234|\n\n<sup>*</sup> Average of carbon sources, weighted by dry matter mass.\n\n![Graph displaying the Tier 2 SOC model outputs.](/assets/organicCarbonPerHa-figure10.png)\n\nGraph displaying the Tier 2 SOC model outputs.\n\n![Graph displaying the Tier 2 SOC model outputs disintegrated into the three carbon sub-pools - active, passive & slow.](/assets/organicCarbonPerHa-figure11.png)\n\nGraph displaying the Tier 2 SOC model outputs disintegrated into the three carbon sub-pools - active, passive & slow.\n\n### Discussion\n\nNew reporting standards require SOC models to be Tier 2 or above. Therefore, where possible (i.e., for croplands remaining croplands with reported annual yields), the Tier 2 methodology should be used instead of the Tier 1 methodology. While the Tier 2 methodology does have high data requirements, the Hestia platform will attempt to gap-fill missing data (e.g., missing monthly climate data and crop residue yields and properties) to help the model to run on as many Sites as possible.\n\nOther than the high data requirements, the model does have some additional flaws:\n* If `startDate` and `endDate` are not provided on Cycles' `waterRegime` practice nodes, the model will assume that irrigation is applied for the entirety of the Cycle's duration. This could result in SOC losses being underestimated (or SOC gains being overestimated) if irrigation was only applied during certain months.\n* Known issues with carbon inputs:\n  * Any discarded crops that remain on the field (`discardedCropIncorporated` and `discardedCropLeftOnField`) must have the properties `carbonContent`, `nitrogenContent` and `ligninContent` specified to be counted as a valid carbon source. If any of these properties are missing, the carbon input from these sources will **not** be counted. Therefore, for Sites where discarded crops remain on the field, SOC losses could be overestimated (see [issue 759](https://gitlab.com/hestia-earth/hestia-engine-models/-/issues/759)).\n  * Carbon inputs from cover crops are **not** currently counted as they are reported with units `% area` rather than with yield. Therefore, for Sites where cover crops are used, SOC losses could be overestimated (see [issue 758](https://gitlab.com/hestia-earth/hestia-engine-models/-/issues/758)).\n  * The average nitrogen and lignin contents of carbon inputs will be miscalculated if `organicFertilisers` are specified using fresh or liquid terms. This has a minimal impact on model results, but it is a known issue (see [issue 763](https://gitlab.com/hestia-earth/hestia-engine-models/-/issues/763)).\n\n**Finally, the model currently only outputs a `value`, but it does not calculate any descriptive statistics for its results (i.e., `sd`, `min` and `max`); however, it is a reporting requirement (TODO: add which reporting guidelines) to provide the min, max and uncertainty of modelled `organicCarbonPerHa` values if CO2 is reported to have been removed from the atmosphere via SOC stock changes. We are currently working to address this by running the model as a Monte Carlo simulation (see [issue 753](https://gitlab.com/hestia-earth/hestia-engine-models/-/issues/753)).**\n\n\n\n"
-}

package/dist/content/models/soilEmissions/organicCarbonPerHa/overview.json

@@ -1,14 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Florian Payen"
-    ],
-    "group": [
-      "Soil Emissions"
-    ],
-    "tab": [
-      "Overview"
-    ]
-  },
-  "content": "## Organic carbon (per ha)\n\nThis model calculates a Site's SOC stocks (`organicCarbonPerHa`) as a function of soil bulk density (`soilBulkDensity`), soil organic carbon concentration (`organicCarbonPerKgSoil`) and soil sampling depth (using `depthUpper` and `depthLower`).\n\nIt also rescales `organicCarbonPerHa` measurements from their source depth interval to a target depth interval of 0 - 30 cm.\n\n### Calculate `organicCarbonPerHa` from other measurements\n\n>$$\n>SOC stock(a, b) = {(b-a)*ρ*C_{OC}*100}\n>$$\n>\n>Where:\n>\n>* $SOC stock(a, b)$ = soil organic carbon stock per hectare for depth interval $a$ to $b$ (kg C / ha)\n>* $a$ = upper bound of soil sampling depth interval (cm)\n>* $b$ = lower bound of soil sampling depth interval (cm)\n>* $ρ$ = soil bulk density for depth interval $a$ to $b$ (g / cm<sup>3</sup>, which is the same as t / m<sup>3</sup>)\n>* $C_{OC}$ = concentration of organic carbon in soil for depth interval $a$ to $b$ (g C / kg soil)\n>\n>Source: [Payen _et al._ (2021)](https://doi.org/10.1016/j.jclepro.2020.125736)\n>\n\n### Rescale `organicCarbonPerHa` measurements to 0 - 30 cm depth\n\n_n.b._ `depthUpper` and `depthLower` for Hestia measurements are recorded in centimetres; however, the following equations use the units metres for the depth variables $a$, $b$ and $x$.\n\nSOC stocks can be rescaled using the following $C_{density}$ equation:\n\n>$$\n>C_{density}(x) =\n>        22.1 - 33.3x + 14.9x^2\n>$$\n>\n>Where:\n>\n>* $C_{density}(x)$ = density of carbon per cubic meter of soil at depth $x$ (kg C / m<sup>3</sup>)\n>* $x$ = depth of measurement between 0 and 1 (m)\n>\n>Source: [Smith _et al._ (2000)](https://doi.org/10.1111/j.1475-2743.2000.tb00214.x)\n\nBy calculating the definite integral of $C_{density}(x)$ between $a$ and $b$, we can estimate the proportion of carbon stored in the depth interval $a$ to $b$ compared to the total carbon stock in the depth interval 0 to 1 m:\n\n>$$\n>cdf(a, b) = \\frac{\\int_a^b C_{density}(x) d{x}}{\\int_0^1 C_{density}(x) d{x}}\n>$$\n>\n>$$\n>cdf(a, b) = \\frac{[22.1b - \\frac{33.3b^2}{2} + \\frac{14.9b^3}{3}]-[22.1a - \\frac{33.3a^2}{2} + \\frac{14.9a^3}{3}]}{10.41\\dot{6}}\n>$$\n>\n>Where:\n>\n>* $cdf(a, b)$ = cumulative distribution of organic carbon in soil for depth interval $a$ to $b$ compared to for depth interval 0 to 1 m.\n>* $a$  = the upper bound of the depth interval, must be between 0 and 1 (m).\n>* $b$  = the lower bound of the depth interval, must be between 0 and 1 and greater than or equal to $a$ (m).\n>\n>Source: [Abdalla _et al._ (2018)](https://doi.org/10.1016/j.agee.2017.10.023)\n>\n><small>_n.b._, the $cdf$ equation presented in Abdalla _et al._ (2018) features a typo - the equation presented in this wiki is the corrected version.</small>\n\n![A graph of the cdf from 0 - 1 m depth.](/assets/organicCarbonPerHa-depthLower.png)\n\nA graph of the cdf from 0 - 1 m depth. The x-axis is $b$, the depth lower of the `organicCarbonPerHa` measurement, and the y-axis is the value of the $cdf(0, b)$.\n\nWe can use the $cdf$ equation to rescale `organicCarbonPerHa` measurements from a source depth interval to a target depth interval. In our case, the target depth interval is 0 - 0.3 m:\n\n>$$\n>SOC stock(0, 0.3) = SOC stock(a, b) * \\frac{cdf(0, 0.3)}{cdf(a, b)}\n>$$\n>\n>Where:\n>\n>* $SOC stock_{0-0.3m}$ = rescaled SOC measurement for depth interval 0 - 0.3 m (kg C / ha)\n>* $SOC stock(a, b)$ = the source SOC measurement for depth interval $a$ to $b$ (kg C / ha)\n>* $a$  = the upper bound of the source depth interval, must be between 0 and 1 (m)\n>* $b$  = the lower bound of the source depth interval, must be between 0 and 1 and greater than or equal to $a$ (m)\n>\n>Source: [Abdalla _et al._ (2018)](https://doi.org/10.1016/j.agee.2017.10.023)\n\n![A graph of the scaling factor (cdf(0, 0.3)/cdf(0, source depth))](/assets/organicCarbonPerHa-sourceDepthLower.png)\n\nA graph of the scaling factor (cdf(0, 0.3)/cdf(0, source depth)). The x-axis is $b$, the depth lower of the source `organicCarbonPerHa` measurement, and the y-axis is the scaling factor required to rescale the measurement value from a source depth interval of 0 - $b$ to the target depth interval of 0 - 0.3 m.\n\n### Example\n\nIn this example, the model will estimate the SOC stock using other measurements and rescale the result to a 0 - 30 cm depth.\n\nThese fixtures have been simplified, [see the full fixtures here](https://gitlab.com/hestia-earth/hestia-engine-models/-/tree/develop/tests/fixtures/site/organicCarbonPerHa/calculate-and-rescale).\n\n#### Input\n```json\n{\n  \"@type\": \"Site\",\n  \"siteType\": \"cropland\",\n  \"measurements\": [\n    {\n      \"@type\": \"Measurement\",\n      \"term\": {\n        \"@type\": \"Term\",\n        \"@id\": \"soilBulkDensity\",\n      },\n      \"value\": [\n        1.55\n      ],\n      \"depthUpper\": 0,\n      \"depthLower\": 40,\n      \"methodClassification\": \"on-site physical measurement\"\n    },\n    {\n      \"@type\": \"Measurement\",\n      \"term\": {\n        \"@type\": \"Term\",\n        \"@id\": \"organicCarbonPerKgSoil\",\n      },\n      \"value\": [\n        24.05\n      ],\n      \"dates\": [\n        \"2020\"\n      ],\n      \"depthUpper\": 0,\n      \"depthLower\": 40,\n      \"methodClassification\": \"on-site physical measurement\"\n    }\n  ],\n}\n```\n\n#### Output\n```json\n[\n  {\n    \"@type\": \"Measurement\",\n    \"term\": {\n      \"@type\": \"Term\",\n      \"@id\": \"organicCarbonPerHa\"\n    },\n    \"value\": [\n      149110\n    ],\n    \"dates\": [\n      \"2020\"\n    ],\n    \"depthUpper\": 0,\n    \"depthLower\": 40,\n    \"methodClassification\": \"modelled using other measurements\"\n  },\n  {\n    \"@type\": \"Measurement\",\n    \"term\": {\n      \"@type\": \"Term\",\n      \"@id\": \"organicCarbonPerHa\"\n    },\n    \"value\": [\n      120906.95055847566\n    ],\n    \"dates\": [\n      \"2020\"\n    ],\n    \"depthUpper\": 0,\n    \"depthLower\": 30,\n    \"methodClassification\": \"modelled using other measurements\"\n  }\n]\n```\n\n### Discussion\n\nThe $C_{density}$ equation from [Smith _et al._ (2000)](https://doi.org/10.1111/j.1475-2743.2000.tb00214.x) used in this model is a quadratic regression of $C_{density}$ at various depths for 22 soil types found in [Batjes (1996)](https://doi.org/10.1111/j.1365-2389.1996.tb01386.x). It is important to note that the exact methodology of how this regression was calculated (i.e., where to find the carbon density data in the original paper and which of the 4 soil types out of the 26 overall presented in the original paper were excluded) and the standard error of the regression were not described. With this in mind, there is scope to recalculate this rescaling method using the higher volume of soil data that is available today, in comparison to 1996. This could be disaggregated by soil type or soil category for greater specificity.\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/Measurement\">Measurements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Measurement#term\">term</a> with <a href=\"https://hestia.earth/term/organicCarbonPerHa\">organicCarbonPerHa</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/ipcc2019\">ipcc2019</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#sd\">sd</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#min\">min</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#max\">max</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#statsDefinition\">statsDefinition</a> with <code>simulated</code></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#observations\">observations</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#dates\">dates</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#depthUpper\">depthUpper</a> with <code>0</code></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#depthLower\">depthLower</a> with <code>30</code></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#methodClassification\">methodClassification</a></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n\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/Site\">Site</a> with:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> = <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<li>a list of <a href=\"https://hestia.earth/schema/Site#management\">managements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Management#value\">value</a> and <a href=\"https://hestia.earth/schema/Management#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=landCover\">landCover</a></li>\n</ul>\n</li>\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> with <code>1</code> <strong>or</strong> <code>2</code> <strong>or</strong> <code>3</code> <strong>or</strong> <code>4</code> <strong>or</strong> <code>7</code> <strong>or</strong> <code>8</code> <strong>or</strong> <code>9</code> <strong>or</strong> <code>10</code> <strong>or</strong> <code>11</code> <strong>or</strong> <code>12</code> 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<li>optional:<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> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=soilType\">soilType</a> <strong>or</strong> <a href=\"https://hestia.earth/glossary?termType=usdaSoilType\">usdaSoilType</a></li>\n</ul>\n</li>\n<li>a list of <a href=\"https://hestia.earth/schema/Site#management\">managements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Management#value\">value</a> and <a href=\"https://hestia.earth/schema/Management#startDate\">startDate</a> and <a href=\"https://hestia.earth/schema/Management#endDate\">endDate</a> and <a href=\"https://hestia.earth/schema/Management#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=cropResidueManagement\">cropResidueManagement</a> and <a href=\"https://hestia.earth/schema/Term#name\">name</a> containing &quot;burnt,removed&quot;</li>\n<li><a href=\"https://hestia.earth/schema/Management#value\">value</a> and <a href=\"https://hestia.earth/schema/Management#startDate\">startDate</a> and <a href=\"https://hestia.earth/schema/Management#endDate\">endDate</a> and <a href=\"https://hestia.earth/schema/Management#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=landUseManagement\">landUseManagement</a></li>\n<li><a href=\"https://hestia.earth/schema/Management#value\">value</a> and <a href=\"https://hestia.earth/schema/Management#startDate\">startDate</a> and <a href=\"https://hestia.earth/schema/Management#endDate\">endDate</a> and <a href=\"https://hestia.earth/schema/Management#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=tillage\">tillage</a></li>\n<li><a href=\"https://hestia.earth/schema/Management#value\">value</a> and <a href=\"https://hestia.earth/schema/Management#startDate\">startDate</a> and <a href=\"https://hestia.earth/schema/Management#endDate\">endDate</a> and <a href=\"https://hestia.earth/schema/Management#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=waterRegime\">waterRegime</a> and <a href=\"https://hestia.earth/schema/Term#name\">name</a> containing &quot;deep water,irrigated&quot;</li>\n<li><a href=\"https://hestia.earth/schema/Management#value\">value</a> and <a href=\"https://hestia.earth/schema/Management#startDate\">startDate</a> and <a href=\"https://hestia.earth/schema/Management#endDate\">endDate</a> and <a href=\"https://hestia.earth/schema/Management#term\">term</a> with <a href=\"https://hestia.earth/term/amendmentIncreasingSoilCarbonUsed\">amendmentIncreasingSoilCarbonUsed</a></li>\n<li><a href=\"https://hestia.earth/schema/Management#value\">value</a> and <a href=\"https://hestia.earth/schema/Management#startDate\">startDate</a> and <a href=\"https://hestia.earth/schema/Management#endDate\">endDate</a> and <a href=\"https://hestia.earth/schema/Management#term\">term</a> with <a href=\"https://hestia.earth/term/animalManureUsed\">animalManureUsed</a></li>\n<li><a href=\"https://hestia.earth/schema/Management#value\">value</a> and <a href=\"https://hestia.earth/schema/Management#startDate\">startDate</a> and <a href=\"https://hestia.earth/schema/Management#endDate\">endDate</a> and <a href=\"https://hestia.earth/schema/Management#term\">term</a> with <a href=\"https://hestia.earth/term/inorganicNitrogenFertiliserUsed\">inorganicNitrogenFertiliserUsed</a></li>\n<li><a href=\"https://hestia.earth/schema/Management#value\">value</a> and <a href=\"https://hestia.earth/schema/Management#startDate\">startDate</a> and <a href=\"https://hestia.earth/schema/Management#endDate\">endDate</a> and <a href=\"https://hestia.earth/schema/Management#term\">term</a> with <a href=\"https://hestia.earth/term/organicFertiliserUsed\">organicFertiliserUsed</a></li>\n<li><a href=\"https://hestia.earth/schema/Management#value\">value</a> and <a href=\"https://hestia.earth/schema/Management#startDate\">startDate</a> and <a href=\"https://hestia.earth/schema/Management#endDate\">endDate</a> and <a href=\"https://hestia.earth/schema/Management#term\">term</a> with <a href=\"https://hestia.earth/term/shortBareFallow\">shortBareFallow</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li>none of:<ul>\n<li>a <a href=\"https://hestia.earth/schema/Site#siteType\">siteType</a> = <code>glass or high accessible cover</code></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n  <div class=\"collapsible-group\">\n    <div class=\"collapsible-header\">\n      <span>Lookups used</span>\n    </div>\n    <div class=\"collapsible-content\"><ul>\n<li><a href=\"https://hestia.earth/glossary/lookups/crop.csv\">crop.csv</a> -&gt; <code>IPCC_LAND_USE_CATEGORY</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/landCover.csv\">landCover.csv</a> -&gt; <code>IPCC_LAND_USE_CATEGORY</code>; <code>LOW_RESIDUE_PRODUCING_CROP</code>; <code>N_FIXING_CROP</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/landUseManagement.csv\">landUseManagement.csv</a> -&gt; <code>PRACTICE_INCREASING_C_INPUT</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/soilType.csv\">soilType.csv</a> -&gt; <code>IPCC_SOIL_CATEGORY</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/tillage.csv\">tillage.csv</a> -&gt; <code>IPCC_TILLAGE_MANAGEMENT_CATEGORY</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/usdaSoilType.csv\">usdaSoilType.csv</a> -&gt; <code>IPCC_SOIL_CATEGORY</code></li>\n<li><a href=\"https://hestia.earth/glossary/lookups/measurement.csv\">measurement.csv</a> -&gt; <code>siteTypesAllowed</code></li>\n</ul>\n</div>\n  </div>\n</div>"
-}

package/dist/content/models/soilMeasurements/soilMeasurement/content.json

@@ -1,17 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "James Bradbury"
-    ],
-    "contributor": [
-      "Guillaume Royer"
-    ],
-    "group": [
-      "Soil Measurements"
-    ],
-    "tab": [
-      "Site"
-    ]
-  },
-  "content": "## Soil Measurement\n\nThis model harmonises matching soil measurements into depth ranges of 0-30 and 0-50 and gap fills missing measurements.\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/Measurement\">Measurements</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Measurement#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#depthUpper\">depthUpper</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#depthLower\">depthLower</a> with <code>30</code> <strong>or</strong> <code>50</code></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#dates\">dates</a></li>\n<li><a href=\"https://hestia.earth/schema/Measurement#methodClassification\">methodClassification</a> with <code>modelled using other measurements</code></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n\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/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#depthUpper\">depthUpper</a> and <a href=\"https://hestia.earth/schema/Measurement#depthLower\">depthLower</a> and <a href=\"https://hestia.earth/schema/Measurement#value\">value</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/measurement.csv\">measurement.csv</a> -&gt; <code>depthSensitive</code></li>\n</ul>\n</div>\n  </div>\n</div>"
-}

package/dist/content/models/transformations/input/content.json

@@ -1,4 +0,0 @@
-{
-  "tags": {},
-  "content": "## Transformation Input"
-}

package/dist/content/models/transformations/input/excreta.json

@@ -1,14 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Guillaume Royer"
-    ],
-    "group": [
-      "Transformations"
-    ],
-    "tab": [
-      "Excreta"
-    ]
-  },
-  "content": "## Transformation Input\n\nCopy Cycle (or previous Transformation) `excreta` products into the Transformation inputs if they are missing.\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/Transformation\">Transformations</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Transformation#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=excreta\">excreta</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#fromCycle\">fromCycle</a> with <code>true</code></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n\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#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#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=excreta\">excreta</a></li>\n</ul>\n</li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#transformations\">transformations</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Transformation#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=excretaManagement\">excretaManagement</a> and a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a> and <a href=\"https://hestia.earth/schema/Input#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=excreta\">excreta</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n</div>"
-}

package/dist/content/models/transformations/input/max.json

@@ -1,14 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Guillaume Royer"
-    ],
-    "group": [
-      "Transformations"
-    ],
-    "tab": [
-      "Max"
-    ]
-  },
-  "content": "## Transformation Input\n\nThis model calculates the [Input max](https://hestia.earth/schema/Input#max) by taking the max of the same [Product](https://hestia.earth/schema/Product) of the previous Transformation (or Cycle if first Transformation) and applying the [share](https://hestia.earth/schema/Transformation/transformedShare).\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/Transformation\">Transformations</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#max\">max</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#statsDefinition\">statsDefinition</a> with <code>modelled</code></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n\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#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#max\">max</a></li>\n</ul>\n</li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#transformations\">transformations</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Transformation#transformedShare\">transformedShare</a> and a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n</div>"
-}

package/dist/content/models/transformations/input/min.json

@@ -1,14 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Guillaume Royer"
-    ],
-    "group": [
-      "Transformations"
-    ],
-    "tab": [
-      "Min"
-    ]
-  },
-  "content": "## Transformation Input\n\nThis model calculates the [Input min](https://hestia.earth/schema/Input#min) by taking the min of the same [Product](https://hestia.earth/schema/Product) of the previous Transformation (or Cycle if first Transformation) and applying the [share](https://hestia.earth/schema/Transformation/transformedShare).\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/Transformation\">Transformations</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#min\">min</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#statsDefinition\">statsDefinition</a> with <code>modelled</code></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n\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#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#min\">min</a></li>\n</ul>\n</li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#transformations\">transformations</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Transformation#transformedShare\">transformedShare</a> and a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n</div>"
-}

package/dist/content/models/transformations/input/properties.json

@@ -1,14 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Guillaume Royer"
-    ],
-    "group": [
-      "Transformations"
-    ],
-    "tab": [
-      "Properties"
-    ]
-  },
-  "content": "## Transformation Input\n\nThis model copies the [Product properties](https://hestia.earth/schema/Product#properties) of the Cycle to the first transformations [inputs](https://hestia.earth/schema/Transformation#inputs).\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/Transformation\">Transformations</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n\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#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#value\">value</a></li>\n</ul>\n</li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#transformations\">transformations</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a> and none of:<ul>\n<li><a href=\"https://hestia.earth/schema/Transformation#previousTransformationId\">previousTransformationId</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n</div>"
-}

package/dist/content/models/transformations/input/sd.json

@@ -1,14 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Guillaume Royer"
-    ],
-    "group": [
-      "Transformations"
-    ],
-    "tab": [
-      "SD"
-    ]
-  },
-  "content": "## Transformation Input\n\nThis model calculates the [Input sd](https://hestia.earth/schema/Input#sd) by taking the sd of the same [Product](https://hestia.earth/schema/Product) of the previous Transformation (or Cycle if first Transformation) and applying the [share](https://hestia.earth/schema/Transformation/transformedShare).\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/Transformation\">Transformations</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a> with:<ul>\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> with <code>modelled</code></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n\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#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#sd\">sd</a></li>\n</ul>\n</li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#transformations\">transformations</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Transformation#transformedShare\">transformedShare</a> and a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n</div>"
-}

package/dist/content/models/transformations/input/value.json

@@ -1,14 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Guillaume Royer"
-    ],
-    "group": [
-      "Transformations"
-    ],
-    "tab": [
-      "Value"
-    ]
-  },
-  "content": "## Transformation Input\n\nThis model calculates the [Input value](https://hestia.earth/schema/Input#value) by taking the value of the same [Product](https://hestia.earth/schema/Product) of the previous Transformation (or Cycle if first Transformation) and applying the [share](https://hestia.earth/schema/Transformation/transformedShare).\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/Transformation\">Transformations</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a></li>\n<li><a href=\"https://hestia.earth/schema/Input#statsDefinition\">statsDefinition</a> with <code>modelled</code></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n\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#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#value\">value</a></li>\n</ul>\n</li>\n<li>a list of <a href=\"https://hestia.earth/schema/Cycle#transformations\">transformations</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Transformation#transformedShare\">transformedShare</a> and a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n</div>"
-}

package/dist/content/models/transformations/product/content.json

@@ -1,14 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Guillaume Royer"
-    ],
-    "group": [
-      "Transformations"
-    ],
-    "tab": [
-      "Excreta"
-    ]
-  },
-  "content": "## Transformation Product\n\nThis model calculates the value of every `Product` by taking the value of the `Input` with the same `term`.\nIt also adds other variants of the same `Product` in different `units` (e.g. `kg N`, `kg VS` and `kg`).\nNote: this model also substract `Emissions` for `Input` with `units` = `kg 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/Product\">Products</a> with:<ul>\n<li><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=excreta\">excreta</a></li>\n<li><a href=\"https://hestia.earth/schema/Product#value\">value</a></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n\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/Transformation\">Transformation</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Transformation#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=excretaManagement\">excretaManagement</a></li>\n<li>a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</a> and <a href=\"https://hestia.earth/schema/Input#term\">term</a> of <a href=\"https://hestia.earth/schema/Term#termType\">termType</a> = <a href=\"https://hestia.earth/glossary?termType=excreta\">excreta</a></li>\n</ul>\n</li>\n<li>a list of <a href=\"https://hestia.earth/schema/Transformation#products\">products</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Product#value\">value</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>causesExcretaMassLoss</code></li>\n</ul>\n</div>\n  </div>\n</div>"
-}

package/dist/content/models/transformations/transformation/content.json

@@ -1,14 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Guillaume Royer"
-    ],
-    "group": [
-      "Transformations"
-    ],
-    "tab": [
-      "Cycle"
-    ]
-  },
-  "content": "## Cycle Transformations\n\nReturns the `Emission` from every `Transformation` to be added in the `Cycle`.\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#value\">value</a></li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n\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 list of <a href=\"https://hestia.earth/schema/Cycle#transformations\">transformations</a> with:<ul>\n<li>a list of <a href=\"https://hestia.earth/schema/Transformation#inputs\">inputs</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Input#value\">value</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>"
-}

package/dist/content/models/transport/distance/content.json

@@ -1,17 +0,0 @@
-{
-  "tags": {
-    "author": [
-      "Guillaume Royer"
-    ],
-    "contributor": [
-      "Tom Talbot"
-    ],
-    "group": [
-      "Transport"
-    ],
-    "tab": [
-      "Haversine formula"
-    ]
-  },
-  "content": "## Transport Value\n\nThis model calculates the `distance` of the [Transport](https://hestia.earth/schema/Transport) linked to the\n[Inputs of the Cycle](https://hestia.earth/schema/Cycle#inputs) by calculating the distance between the\ncountry of the Cycle and the country of origin of the Input (which must be different).\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#transport\">transports</a> with:<ul>\n<li><a href=\"https://hestia.earth/schema/Transport#methodModel\">methodModel</a> with <a href=\"https://hestia.earth/term/haversineFormula\">haversineFormula</a></li>\n<li><a href=\"https://hestia.earth/schema/Transport#distance\">distance</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n</div>\n  </div>\n\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 <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> and a list of <a href=\"https://hestia.earth/schema/Input#transport\">transports</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li>a <a href=\"https://hestia.earth/schema/Cycle#site\">site</a> with:<ul>\n<li>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</ul>\n</li>\n</ul>\n</div>\n  </div>\n</div>"
-}