The Inputs, Emissions, Products, and Practices created or used during a period. A Cycle also includes a Completeness assessment, describing how complete the Inputs and Products data are, and Transformations, which allow Products to be transformed into new Products in the same Cycle. For animal production Cycles, the types of Animal present can also be specified. A Cycle occurs on a Site.
| Field | Type | Required | Definition |
|---|---|---|---|
description | string | No | A description of the Cycle, including information that cannot be captured with other fields. |
functionalUnit | string | Yes | The units that the Possible values are: |
functionalUnitDetails | string | No | Further information on the functional unit (e.g., 'one batch'). |
endDate | string | Yes | |
startDate | string | No | The start date of the Cycle in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY). It is calculated as This field has additional validation rules when set:
|
startDateDefinition | string | No | A definition of what the start date is. This is a required field if Possible values are: |
cycleDuration | number | No | The duration of the Cycle in days, equal to This field has additional validation rules when set:
|
site | Site | Yes | A reference to the Site where this Cycle occurred. |
otherSites | List[Site] | No | If the Cycle occurred on multiple Sites, a list of the other Sites. |
siteDuration | number | No | The duration the Site is used for this Cycle in days. For temporary crops, the use period is defined as including the short fallow period and is therefore the period from harvest of the previous crop to harvest of the current crop ( |
otherSitesDuration | array[number|null] | No | If a Cycle occurred on multiple Sites, a corresponding array to This field has additional validation rules when set:
|
siteUnusedDuration | number | No | During a Cycle, or over a number of Cycles, Sites are often unused for production for a period of time (e.g., the long fallow duration in crop production systems or periods when animals have been rotated to a different field). The unused duration is included in land occupation calculations. For cropping Cycles, |
otherSitesUnusedDuration | array[number|null] | No | If a Cycle occurred on multiple Sites, a corresponding array to |
siteArea | number | No | The area of the site in hectares per |
otherSitesArea | array[number|null] | No | If a Cycle occurred on multiple Sites, a corresponding array to This field has additional validation rules when set:
|
harvestedArea | number | No | For crops, the area harvested per |
numberOfCycles | integer | No | If data on multiple Cycles are aggregated and represented as a single Cycle, the number of Cycles. For example, Cycles occurred on the same Site in multiple growing seasons might be represented as a single Cycle with standard deviations across Cycles. |
treatment | string | No | A description of the treatment administered by researchers to the experimental unit. Use the This field has additional validation rules when set:
|
commercialPracticeTreatment | boolean | No | Whether this treatment is representative of typical commercial practice. Required if |
numberOfReplications | integer | No | In experimental studies, the number of replicates for the |
sampleWeight | integer | No | In surveys, the sample weight for this Cycle relative to all other Cycles included in the Source. |
defaultMethodClassification | string | Yes | The default classification of the method used to acquire or estimate all Input, Product, Practice, and Transport data in the Cycle. It can be overridden by specifying a
Possible values are: |
defaultMethodClassificationDescription | string | Yes | A justification of the |
defaultSource | Source | No | |
completeness | Completeness | Yes | |
practices | List[Practice] | No | The Practices used.
practices
cannot be duplicated.
The following fields determine whether a
Practice is unique:
|
animals | List[Animal] | No | The types of Animal present.
animals
cannot be duplicated.
The following fields determine whether a
Animal is unique:
|
inputs | List[Input] | No | The Inputs used.
inputs
cannot be duplicated.
The following fields determine whether a
Input is unique:
This field has additional validation rules when set:
|
products | List[Product] | No | The Products created.
products
cannot be duplicated.
The following fields determine whether a
Product is unique:
|
transformations | List[Transformation] | No | The Transformations applied to
transformations
cannot be duplicated.
The following fields determine whether a
Transformation is unique:
|
emissions | List[Emission] | No | The Emissions created.
emissions
cannot be duplicated.
The following fields determine whether a
Emission is unique:
|
dataPrivate | boolean | Yes | If these data are private. Private means that HESTIA administrators can access these data and you can grant access to other platform users, but these data will not be made available to any other users of the platform or distributed to third parties. |
Internal Properties
The following properties are automatically set when data are uploaded to the HESTIA platform. If they are included in a file which is uploaded, they will be overwritten.
| Field | Type | Definition | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
@context | The location of the JSON-LD context file. | ||||||||||||||||
@id | The unique ID assigned to the Node by HESTIA. | ||||||||||||||||
@type | Cycle | ||||||||||||||||
name | string | An automatically generated name for the Cycle composed of: primary product name, "-", | |||||||||||||||
originalId | string | The identifier for these data in the source database (e.g., if the data were converted from openLCA or ecoinvent, the id field from that database). | |||||||||||||||
schemaVersion | string | The version of the schema when these data were created. | |||||||||||||||
added | array[string] | A list of fields that have been added to the original dataset. | |||||||||||||||
addedVersion | array[string] | A list of versions of the model used to add these fields. | |||||||||||||||
updated | array[string] | A list of fields that have been updated on the original dataset. | |||||||||||||||
updatedVersion | array[string] | A list of versions of the model used to update these fields. | |||||||||||||||
aggregated | boolean | If this Cycle has been 'aggregated' using data from multiple Cycles. | |||||||||||||||
aggregatedDataValidated | boolean | If this aggregated Cycle has been validated by the HESTIA team. | |||||||||||||||
aggregatedVersion | string | A version of the aggregation engine corresponding to this Cycle. | |||||||||||||||
aggregatedQualityScore | integer | A data quality score for aggregated data. The points depend on the primary Product of the aggregation. One point is awarded for each of the categories satisfied, according to the table below. For global aggregations, an additional point is awarded for both farm-stage and processing aggregations if the aggregation includes countries representing over 75% of production of the farm-gate product. The global aggregation is then scored out of 4 or 5 for processing and crop respectively.
| |||||||||||||||
aggregatedQualityScoreMax | integer | The maximum value for the aggregated quality score. | |||||||||||||||
aggregatedCycles | List[Cycle] | Cycles used to aggregated this Cycle. | |||||||||||||||
aggregatedSources | List[Source] | Sources used to aggregated this Cycle. | |||||||||||||||
covarianceMatrixIds | array[string] | An array of strings which are the column column/row headers of the This field has additional validation rules when set:
| |||||||||||||||
covarianceMatrix | array[array[number|null]] | For aggregated cycles only, a covariance matrix, represented using the lower triangle only. The covariance matrix describes the covariance between all data items in the Cycle. It is used to generate the distributions of Impact Assessment Indicators. E.g., it contains the covariance between one emission and another. It controls for the fact that data items in the Cycle often covary with another. This covariance generally reduces the variability in the distributions of Indicators. This field has additional validation rules when set:
| |||||||||||||||
createdAt | date | Date created on HESTIA in ISO 8601 format (YYYY-MM-DD). | |||||||||||||||
updatedAt | date | Last update date on HESTIA in ISO 8601 format (YYYY-MM-DD). |
Example 1
{
"@context": "https://DOMAIN/schema/Cycle.jsonld",
"@id": "cycle",
"@type": "Cycle",
"name": "Wheat, grain - Forbach, France - 1989",
"site": {
"@id": "site",
"@type": "Site",
"name": "Field 1",
"siteType": "cropland",
"country": {
"@id": "GADM-FRA",
"@type": "Term",
"name": "France",
"termType": "region"
}
},
"defaultMethodClassification": "verified survey data",
"defaultMethodClassificationDescription": "Data from a postal survey of 200 farms where researchers followed up with on-site visits to validate the data.",
"defaultSource": {
"@id": "source",
"@type": "Source",
"name": "Gigou (1990)"
},
"endDate": "1989-12-31",
"startDate": "1989-06-01",
"startDateDefinition": "harvest of previous crop",
"cycleDuration": 214,
"siteDuration": 214,
"siteArea": 1,
"description": "50N treatment",
"commercialPracticeTreatment": false,
"functionalUnit": "1 ha",
"completeness": {
"@type": "Completeness",
"animalPopulation": true,
"freshForage": true,
"ingredient": true,
"otherChemical": true,
"operation": false,
"electricityFuel": false,
"material": true,
"transport": true,
"fertiliser": true,
"soilAmendment": true,
"pesticideVeterinaryDrug": true,
"water": true,
"animalFeed": true,
"liveAnimalInput": true,
"seed": false,
"product": true,
"cropResidue": false,
"excreta": true,
"waste": false
},
"inputs": [
{
"@type": "Input",
"term": {
"@id": "CAS-34494-04-7",
"@type": "Term",
"name": "Glyphosate",
"units": "g active ingredient",
"termType": "pesticideAI"
},
"value": [
400
],
"sd": [
180
],
"statsDefinition": "replications",
"observations": [
10
]
},
{
"@type": "Input",
"term": {
"@id": "ureaKgN",
"@type": "Term",
"name": "Urea (kg N)",
"units": "kg N",
"termType": "inorganicFertiliser"
},
"value": [
40
],
"transport": [
{
"@type": "Transport",
"term": {
"@id": "freightLorry32MetricTon",
"@type": "Term",
"name": "Freight, lorry, >32 metric ton",
"units": "tkm",
"termType": "transport"
},
"value": 8,
"returnLegIncluded": false,
"methodClassification": "estimated with assumptions",
"methodClassificationDescription": "Distance estimated using approximate road distance to likely supplier, assuming 100% load factor.",
"emissions": [
{
"@type": "Emission",
"term": {
"@id": "co2ToAirFuelCombustion",
"@type": "Term",
"name": "CO2, to air, fuel combustion",
"units": "kg CO2",
"termType": "emission"
},
"value": [
0.7
],
"methodModel": {
"@id": "emepEea2019",
"@type": "Term",
"name": "EMEA-EEA (2019)",
"termType": "model"
},
"methodTier": "tier 1"
}
]
}
]
},
{
"@type": "Input",
"term": {
"@id": "electricityGridMarketMix",
"@type": "Term",
"name": "Electricity, grid, market mix",
"units": "kWh",
"termType": "electricity"
},
"value": [
600
]
},
{
"@type": "Input",
"term": {
"@id": "fixedNitrogenFromPreviousCropKgN",
"@type": "Term",
"name": "Fixed nitrogen, from previous crop (kg N)",
"units": "kg N",
"termType": "organicFertiliser"
},
"value": [
40
],
"methodClassification": "modelled",
"methodClassificationDescription": "Modelled using a simple model which links nitrogen fixation to nitrogen fertiliser input (Jensen, 1987, Plant and Soil)."
}
],
"emissions": [
{
"@type": "Emission",
"term": {
"@id": "no3ToGroundwaterSoilFlux",
"@type": "Term",
"name": "NO3, to groundwater, soil flux",
"units": "kg NO3",
"termType": "emission"
},
"value": [
60.75,
70.5
],
"dates": [
"1989-06-16",
"1989-08-01"
],
"methodModel": {
"@id": "percolationLysimeter",
"@type": "Term",
"name": "Percolation lysimeter",
"termType": "methodEmissionResourceUse"
},
"methodTier": "measured",
"source": {
"@id": "source-8v5",
"@type": "Source",
"name": "Murwira (1993)"
}
},
{
"@type": "Emission",
"term": {
"@id": "n2OToAirInorganicFertiliserDirect",
"@type": "Term",
"name": "N2O, to air, inorganic fertiliser, direct",
"units": "kg N2O",
"termType": "emission"
},
"value": [
0.628
],
"methodModel": {
"@id": "ipcc2006",
"@type": "Term",
"name": "IPCC (2006)",
"termType": "model"
},
"methodTier": "tier 1"
},
{
"@type": "Emission",
"term": {
"@id": "so2ToAirInputsProduction",
"@type": "Term",
"name": "SO2, to air, inputs production",
"units": "kg SO2",
"termType": "emission"
},
"value": [
2.11
],
"methodModel": {
"@id": "ecoinventV3",
"@type": "Term",
"name": "ecoinvent v3",
"termType": "model"
},
"methodTier": "background",
"inputs": [
{
"@id": "electricityGridMarketMix",
"@type": "Term",
"name": "Electricity, grid, market mix",
"termType": "electricity"
}
]
}
],
"products": [
{
"@type": "Product",
"term": {
"@id": "wheatGrain",
"@type": "Term",
"name": "Wheat, grain",
"units": "kg",
"termType": "crop"
},
"value": [
7282
],
"primary": true,
"economicValueShare": 94.8,
"properties": [
{
"@type": "Property",
"term": {
"@id": "dryMatter",
"@type": "Term",
"name": "Dry matter",
"units": "%",
"termType": "property"
},
"value": 80
}
]
},
{
"@type": "Product",
"term": {
"@id": "wheatStraw",
"@type": "Term",
"name": "Wheat, straw",
"units": "kg",
"termType": "crop"
},
"value": [
40
],
"economicValueShare": 5.2
}
],
"practices": [
{
"@type": "Practice",
"term": {
"@id": "croppingDuration",
"@type": "Term",
"name": "Cropping duration",
"units": "days",
"termType": "landUseManagement"
},
"value": [
163
]
},
{
"@type": "Practice",
"term": {
"@id": "shortFallowDuration",
"@type": "Term",
"name": "Short fallow duration",
"units": "days",
"termType": "landUseManagement"
},
"value": [
50
]
},
{
"@type": "Practice",
"term": {
"@id": "seedTreated",
"@type": "Term",
"name": "Seed treated",
"termType": "cropEstablishment"
}
}
],
"dataPrivate": false
}Example 2
{
"@context": "https://DOMAIN/schema/Cycle.jsonld",
"@id": "cycle",
"@type": "Cycle",
"name": "Cattle (beef) - Rondônia, Brazil - 2013",
"site": {
"@id": "site",
"@type": "Site",
"name": "Pasture - Brazil"
},
"otherSites": [
{
"@id": "7aalbii",
"@type": "Site",
"name": "Animal Housing - Brazil"
}
],
"endDate": "2013",
"cycleDuration": 365,
"startDateDefinition": "one year prior",
"siteDuration": 300,
"siteArea": 33.12,
"otherSitesDuration": [
65
],
"otherSitesArea": [
0.28
],
"siteUnusedDuration": 65,
"otherSitesUnusedDuration": [
300
],
"defaultMethodClassification": "non-verified survey data",
"defaultMethodClassificationDescription": "A telephone survey of 50 farms.",
"defaultSource": {
"@id": "source",
"@type": "Source",
"name": "Alvarez et al (2021)"
},
"functionalUnit": "relative",
"completeness": {
"@type": "Completeness",
"animalPopulation": true,
"freshForage": false,
"otherChemical": true,
"ingredient": true,
"operation": false,
"electricityFuel": false,
"material": false,
"transport": false,
"fertiliser": true,
"soilAmendment": true,
"pesticideVeterinaryDrug": true,
"water": true,
"animalFeed": true,
"liveAnimalInput": true,
"seed": true,
"product": true,
"cropResidue": false,
"excreta": true,
"waste": false
},
"inputs": [
{
"@type": "Input",
"term": {
"@id": "lime",
"@type": "Term",
"name": "Lime",
"units": "kg CaCO3",
"termType": "soilAmendment"
},
"value": [
250
]
},
{
"@type": "Input",
"term": {
"@id": "beefCattleCalfWeaned",
"@type": "Term",
"name": "Beef cattle, calf (weaned)",
"units": "number",
"termType": "liveAnimal"
},
"value": [
4
]
}
],
"animals": [
{
"@type": "Animal",
"animalId": "young beef cattle heifer",
"term": {
"@id": "beefCattleHeifer",
"@type": "Term",
"name": "Beef cattle, heifer",
"units": "number",
"termType": "liveAnimal"
},
"value": 15,
"referencePeriod": "average",
"properties": [
{
"@type": "Property",
"term": {
"@id": "age",
"@type": "Term",
"name": "Age",
"units": "days",
"termType": "property"
},
"value": 730
},
{
"@type": "Property",
"term": {
"@id": "liveweightPerHead",
"@type": "Term",
"name": "Liveweight per head",
"units": "kg liveweight / head",
"termType": "property"
},
"value": 200
}
]
},
{
"@type": "Animal",
"animalId": "mature beef cattle heifer",
"term": {
"@id": "beefCattleHeifer",
"@type": "Term",
"name": "Beef cattle, heifer",
"units": "number",
"termType": "liveAnimal"
},
"value": 10,
"referencePeriod": "average",
"properties": [
{
"@type": "Property",
"term": {
"@id": "age",
"@type": "Term",
"name": "Age",
"units": "days",
"termType": "property"
},
"value": 1095
},
{
"@type": "Property",
"term": {
"@id": "liveweightPerHead",
"@type": "Term",
"name": "Liveweight per head",
"units": "kg liveweight / head",
"termType": "property"
},
"value": 250
}
]
},
{
"@type": "Animal",
"animalId": "beef cattle cow",
"term": {
"@id": "beefCattleCow",
"@type": "Term",
"name": "Beef cattle (cow)",
"units": "number",
"termType": "liveAnimal"
},
"value": 20,
"referencePeriod": "average",
"properties": [
{
"@type": "Property",
"term": {
"@id": "liveweightPerHead",
"@type": "Term",
"name": "Liveweight per head",
"units": "kg liveweight / head",
"termType": "property"
},
"value": 430
}
]
},
{
"@type": "Animal",
"animalId": "beef cattle bull",
"term": {
"@id": "beefCattleBull",
"@type": "Term",
"name": "Beef cattle, bull",
"units": "number",
"termType": "liveAnimal"
},
"value": 1,
"referencePeriod": "average",
"properties": [
{
"@type": "Property",
"term": {
"@id": "liveweightPerHead",
"@type": "Term",
"name": "Liveweight per head",
"units": "kg liveweight / head",
"termType": "property"
},
"value": 500
}
]
}
],
"products": [
{
"@type": "Product",
"term": {
"@id": "beefCattle",
"@type": "Term",
"name": "Beef cattle",
"units": "number",
"termType": "liveAnimal"
},
"value": [
10
],
"properties": [
{
"@type": "Property",
"term": {
"@id": "processingConversionLiveweightToColdDressedCarcassWeight",
"@type": "Term",
"name": "Processing conversion, liveweight to cold dressed carcass weight",
"units": "%",
"termType": "property"
},
"value": 48
}
]
},
{
"@type": "Product",
"term": {
"@id": "excretaBeefCattleExceptFeedlotFedKgMass",
"@type": "Term",
"name": "Excreta, beef cattle, except feedlot fed (kg mass)",
"units": "kg",
"termType": "excreta"
},
"value": [
1050
]
}
],
"transformations": [
{
"@type": "Transformation",
"transformationId": "excreta-on-pasture",
"term": {
"@id": "pastureRangePaddockExcretaManagement",
"@type": "Term",
"name": "Pasture/Range/Paddock (excreta management)",
"termType": "excretaManagement"
},
"inputs": [
{
"@type": "Input",
"term": {
"@id": "excretaBeefCattleExceptFeedlotFedKgMass",
"@type": "Term",
"name": "Excreta, beef cattle, except feedlot fed (kg mass)",
"units": "kg",
"termType": "excreta"
},
"value": [
840
],
"fromCycle": false
}
],
"transformedShare": 80
},
{
"@type": "Transformation",
"transformationId": "pit-storage",
"term": {
"@id": "pitStorageBelowAnimalConfinements",
"@type": "Term",
"name": "Pit storage below animal confinements",
"termType": "excretaManagement"
},
"inputs": [
{
"@type": "Input",
"term": {
"@id": "excretaBeefCattleExceptFeedlotFedKgMass",
"@type": "Term",
"name": "Excreta, beef cattle, except feedlot fed (kg mass)",
"units": "kg",
"termType": "excreta"
},
"value": [
210
],
"fromCycle": false
}
],
"transformedShare": 20
},
{
"@type": "Transformation",
"transformationId": "lagoon",
"term": {
"@id": "liquidSlurry",
"@type": "Term",
"name": "Liquid/Slurry",
"termType": "excretaManagement"
},
"inputs": [
{
"@type": "Input",
"term": {
"@id": "excretaBeefCattleExceptFeedlotFedKgMass",
"@type": "Term",
"name": "Excreta, beef cattle, except feedlot fed (kg mass)",
"units": "kg",
"termType": "excreta"
},
"fromCycle": false
}
],
"transformedShare": 100,
"previousTransformationId": "pit-storage"
}
],
"dataPrivate": false
}Example 3
{
"@context": "https://www.hestia.earth/schema/Cycle.jsonld",
"@type": "Cycle",
"@id": "africanAubergineFruit-cote-divoire-2010-2025-20250427",
"name": "African aubergine, fruit - Côte d'Ivoire - 2010-2025",
"startDate": "2010",
"startDateDefinition": "start of year",
"endDate": "2025",
"functionalUnit": "1 ha",
"defaultSource": {
"@type": "Source",
"name": "HESTIA Team (2023)",
"@id": "pu2wmwp8yfv7"
},
"aggregatedQualityScore": 1,
"aggregatedQualityScoreMax": 4,
"aggregated": true,
"defaultMethodClassification": "modelled",
"defaultMethodClassificationDescription": "aggregated data",
"site": {
"@id": "africanAubergineFruit-cote-divoire-2010-2025-20250427",
"@type": "Site"
},
"completeness": {
"animalFeed": true,
"animalPopulation": true,
"cropResidue": false,
"electricityFuel": true,
"excreta": true,
"fertiliser": true,
"freshForage": true,
"ingredient": true,
"liveAnimalInput": true,
"material": true,
"operation": false,
"otherChemical": true,
"pesticideVeterinaryDrug": true,
"product": true,
"seed": true,
"soilAmendment": true,
"transport": false,
"waste": false,
"water": true,
"@type": "Completeness"
},
"covarianceMatrixIds": [
"practices.croppingIntensity",
"practices.longFallowRatio",
"products.africanAubergineFruit",
"emissions.noxToAirInputsProduction",
"emissions.co2ToAirOrganicSoilCultivation",
"emissions.no3ToGroundwaterCropResidueDecomposition"
],
"covarianceMatrix": [
[
20,
0,
0,
0,
0,
0
],
[
30,
40,
0,
0,
0,
0
],
[
10,
60,
90,
0,
0,
0
],
[
4,
-25,
-88,
10,
0,
0
],
[
0.6,
-10,
-90,
11,
30,
0
],
[
75,
20,
-15,
-70,
2,
35
]
],
"practices": [
{
"term": {
"@type": "Term",
"name": "Cropping intensity",
"termType": "landUseManagement",
"@id": "croppingIntensity",
"units": "ratio"
},
"value": [
0.26170096
],
"@type": "Practice"
},
{
"term": {
"@type": "Term",
"name": "Long fallow ratio",
"termType": "landUseManagement",
"@id": "longFallowRatio",
"units": "ratio"
},
"value": [
1.14453049
],
"@type": "Practice"
}
],
"products": [
{
"term": {
"@type": "Term",
"termType": "crop",
"name": "African aubergine, fruit",
"units": "kg",
"@id": "africanAubergineFruit"
},
"value": [
16923
],
"economicValueShare": 99.98,
"primary": true,
"@type": "Product"
}
],
"emissions": [
{
"term": {
"@type": "Term",
"name": "NOx, to air, inputs production",
"termType": "emission",
"@id": "noxToAirInputsProduction",
"units": "kg NOx"
},
"value": [
0.124
],
"methodTier": "not relevant",
"methodModel": {
"@type": "Term",
"name": "Aggregated models",
"termType": "model",
"@id": "aggregatedModels"
},
"@type": "Emission"
},
{
"term": {
"@type": "Term",
"name": "CO2, to air, organic soil cultivation",
"termType": "emission",
"@id": "co2ToAirOrganicSoilCultivation",
"units": "kg CO2"
},
"value": [
509
],
"methodTier": "not relevant",
"methodModel": {
"@type": "Term",
"name": "Aggregated models",
"termType": "model",
"@id": "aggregatedModels"
},
"@type": "Emission"
},
{
"term": {
"@type": "Term",
"name": "NO3, to groundwater, crop residue decomposition",
"termType": "emission",
"@id": "no3ToGroundwaterCropResidueDecomposition",
"units": "kg NO3"
},
"value": [
3.18
],
"methodTier": "not relevant",
"methodModel": {
"@type": "Term",
"name": "Aggregated models",
"termType": "model",
"@id": "aggregatedModels"
},
"@type": "Emission"
}
],
"dataPrivate": false
}