Schema

Cycle

Type: Node


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.

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.

commercialPracticeTreatment boolean No

Whether this treatment is representative of typical commercial practice. Required if treatment is specified.

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: harvest of previous crop, sowing date, transplanting date, soil preparation date, orchard or vineyard establishment date, first bearing year, stocking date, start of year

cycleDuration number No

The duration of the Cycle in days. Calculated from startDate and endDate if provided.

Defaults to: 365

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.

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). If the primary product is a crop, the functional unit can only be 1 ha.

Possible values are: 1 ha, relative

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.

sampleWeight integer No

In surveys, the sample weight for this Cycle relative to all other Cycles included in the Source.

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.

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 methodClassification for each Input, Product, Practice, or Transport stage.

  • physical measurement means the amount is quantified using weighing, volume measurement, metering, chemical methods, or other physical approaches.
  • verified survey data means the data are initially collected through surveys; all or a subset of the data are verified using physical methods; and erroneous survey data are discarded or corrected.
  • non-verified survey data means the data are collected through surveys that have not been subjected to verification.
  • modelled means a previously calibrated model is used to estimate this data point from other data points describing this Cycle.
  • estimated with assumptions means a documented assumption is used to estimate this data point from other data points describing this Cycle.
  • consistent external sources means the data are taken from external datasets referring to different producers/enterprises:
    • Using the same technology (defined as the same System or the same key Practices as those specified in the Cycle);
    • At the same date (defined as occurring within the startDate and endDate of the Cycle); and
    • In the same region or country.
    Modelling or assumptions may have also been used to transform these data.
  • inconsistent external sources means the data are taken from external datasets referring to different producers/enterprises:
    • Using a different technology (defined as a different System or using different key Practices to those specified in the Cycle);
    • At a different date (defined as occurring within the startDate and endDate of the Cycle); or
    • In a different region or country.
    Modelling or assumptions may have also been used to transform these data.
  • expert opinion means the data have been estimated by experts in the field.
  • unsourced assumption means the data do not have a clear source and/or are based on assumptions only.

Possible values are: physical measurement, verified survey data, non-verified survey data, modelled, estimated with assumptions, consistent external sources, inconsistent external sources, expert opinion, unsourced assumption

defaultMethodClassificationDescription string Yes

A justification of the defaultMethodClassification used. If the data were estimated with assumptions this field should also describe the assumptions.

defaultSource Source No

The default Source for all data in the Cycle which can be overridden by specifying a source for each Input, Emission, Product, or Practice. Required for public uploads (i.e., where dataPrivate is false).

completeness Completeness Yes

A specification of how complete the inputs and products data are. If an area of activity data is marked as complete, then the associated Inputs and Products represent a complete description of the Cycle.

practices List[Practice] No

The Practices used.

practices cannot be duplicated. The following fields determine whether a Practice is unique: term.@id, key.@id, dates, startDate, endDate, areaPercent, ownershipStatus

animals List[Animal] No

The types of Animal present.

animals cannot be duplicated. The following fields determine whether an Animal is unique: term.@id, properties.term.@id, properties.value

inputs List[Input] No

The Inputs used.

inputs cannot be duplicated. The following fields determine whether an Input is unique: term.@id, dates, startDate, endDate, isAnimalFeed, transport.@id, operation.@id, country.@id, impactAssessment.id, properties.term.@id, properties.value

products List[Product] No

The Products created.

products cannot be duplicated. The following fields determine whether a Product is unique: term.@id, dates, startDate, endDate, variety, fate

transformations List[Transformation] No

The Transformations applied to products generated from this Cycle.

transformations cannot be duplicated. The following fields determine whether a Transformation is unique: transformationId

emissions List[Emission] No

The Emissions created.

emissions cannot be duplicated. The following fields determine whether an Emission is unique: term.@id, dates, startDate, endDate, depth, inputs.@id, transport.@id, operation.@id, transformation.@id

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.

Defaults to: False


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 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.

aggregatedQualityScore integer

A data quality score for aggregated data. Multiple points can be awarded for: no Emissions are missing from the system boundary; the aggregation is based on data from over fifty Cycles; the difference between FAOSTAT yield and the aggregated yield for the primary product is less than ±20% (crop only); countries representing at least 75% of global production are included (Global aggregation only); and data Completeness is true for all areas.

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.

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

Example 2