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. 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. |
treatment | string | No |
A description of the treatment administered by researchers to the experimental unit. E.g., a Site is divided into four and each part is 'treated' with a different fertiliser type to see which produces the most maize (Easton & McColl (1997)). Use the numberOfReplications field to specify the number of replicates for each treatment. |
site | Site | Yes |
A reference to the Site describing the primary location 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 on the primary site in days. For a single Site, this is equal to cycleDuration. |
otherSitesDuration | array[number] | No |
If a Cycle occurs on multiple Sites, a corresponding array to otherSites representing the number of days on each Site. |
harvestedArea | number | No |
For crops, the area harvested in hectares. Area harvested is the same as area under cultivation if the entire cultivated area is harvested, but less if crops fail or are not harvested for economic or other reasons. |
defaultSource | Source | No |
The default Source for all data in the Cycle which can be overridden by specifying a source for each blank node. Required for all public uploads (dataPrivate = `false`). |
endDate | string | Yes |
The end date or year of the Cycle in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY). If startDate is specified to month or day precision, endDate should be too. For crops, endDate is always the harvest date. For continually harvested crops, it should be the end of the year. |
startDate | string | No |
The start date of the Cycle in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY). Use the startDateDefinition field to define what this represents. For consistency with FAOSTAT, this should ideally be the date of harvest of the previous crop (a fallow period of greater than a year but less than five years is counted as a crop). However other start dates can be specified, such as the sowing date or soil preparation date. For continually harvested crops it should be the start of the year. |
startDateDefinition | string | No |
A definition of what the start date is. This is a required field if startDate is provided. Possible values are: |
cycleDuration | number | No | |
functionalUnit | string | Yes |
The units that the inputs, emissions, products, and transformations are expressed 'per'. Can either be: '1 ha' (one hectare) or 'relative' (meaning that the quantities of Inputs and Emissions correspond to the quantities of Products). For agricultural land, the functional unit can only be '1 ha'. Possible values are: |
functionalUnitDetails | string | No |
Further information on the functional unit (e.g. 'one batch'). |
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. |
numberOfReplications | integer | No |
In experimental studies, the number of replicates for the treatment. |
dataCompleteness | Completeness | Yes | |
inputs | List[Input] | No |
The Inputs used.
inputs
cannot be duplicated.
The following fields determine whether an Input is unique:
|
emissions | List[Emission] | No |
The Emissions created.
emissions
cannot be duplicated.
The following fields determine whether an Emission is unique:
|
products | List[Product] | No |
The Products created.
products
cannot be duplicated.
The following fields determine whether an Product is unique:
|
practices | List[Practice] | No |
The Practices used.
practices
cannot be duplicated.
The following fields determine whether an Practice is unique:
|
transformations | List[Transformation] | No |
The Transformations applied to products generated from this Cycle.
transformations
cannot be duplicated.
The following fields determine whether an Transformation is unique:
|
dataPrivate | boolean | Yes |
If these data are private. |
Internal Properties
Field | Type | Definition |
---|---|---|
@context | string | The location of the JSON-LD context file. |
@id | string | The unique ID assigned to the Node by Hestia. |
@type | string | Cycle |
name | string |
An automatically generated name for the Cycle composed of: primary product name, "-", site.region "," site.country, "-", endDate, "-", treatment and/or description. |
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. |
aggregatedVersion | string |
A version of the aggregation engine corresponding to this Cycle. |
JSON-LD Example 1