Cycle>Emission

Emission


Type:Blank Node


A chemical flow into water, soil, or air occurring during a Cycle or Transformation. Each Emission must be unique and the fields which determine uniqueness are defined in the emissions field of the Cycle or Transformation.


FieldTypeRequiredDefinition
term
TermYes

A reference to the Term describing the Emission.

This field has additional validation rules when set:

  • the term.termType must have one of the following values: emission.

description
stringNo

A description of the Emission.

key
TermNo

For certain emissions (`Pesticide, to ...`, `Ionising compounds, to`, and `Heavy metals, to...`) the element or compound that was emitted.

This field has additional validation rules when set:

  • the key.termType must have one of the following values: fuel, material, waste, inorganicFertiliser, otherInorganicChemical, otherOrganicChemical, pesticideAI, soilAmendment, veterinaryDrug.

value
array[number|null]Yes

The quantity of the Emission. If an average, it should always be the mean. Can be a single number (array of length one) or an array of numbers with associated dates (e.g., representing multiple measurements over time).

distribution
array[number]|array[array[number]]No

An array of up to 1000 random samples from the posterior distribution of valuedates field.

sd
array[number|null]No

The standard deviation of value.

This field has additional validation rules when set:

  • statsDefinition must also be set.

min
array[number|null]No

The minimum of value.

This field has additional validation rules when set:

  • statsDefinition must also be set.

max
array[number|null]No

The maximum of value.

This field has additional validation rules when set:

  • statsDefinition must also be set.

statsDefinition
stringNo

What the descriptive statistics (sd, min, max, and value) are calculated across, or whether they are simulated or the output of a model. spatial refers to descriptive statistics calculated across spatial units (e.g., pixels) within a region or country. time refers to descriptive statistics calculated across units of time (e.g., hours).

Possible values are: sites, cycles, replications, animals, other observations, time, spatial, regions, simulated, modelled

This field has additional validation rules when set:

  • one of the following must be valid:
    • value must also be set.
    • min must also be set.
    • max must also be set.
    • sd must also be set.

observations
array[number|null]No

The number of observations the descriptive statistics are calculated over.

dates
array[string]No

A corresponding array to value, representing the dates of the Emissions in ISO 8601 format (YYYY-MM-DD, YYYY-MM, YYYY, --MM-DD, --MM, or YYYY-MM-DDTHH:mm:ssZ).

startDate
stringNo

For Emissions over periods, the start date of the Emission if different from the start date of the Cycle in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY).

endDate
stringNo

For Emissions over periods, the end date of the Emission if different from the end date of the Cycle in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY).

emissionDuration
numberNo

The duration of the Emissions in days, particularly used for measured Emissions.

depthUpper
numberNo

For soil Emissions, the upper (shallower) depth at which the Emission was recorded in centimeters, using positive numbers.

depthLower
numberNo

For soil Emissions, the lower (deeper) depth at which the Emission was recorded in centimeters, using positive numbers.

methodTier
stringYes

  • background data refer to emissions which do not occur in the current Cycle. They are either drawn from external, secondary, and often aggregated datasets such as ecoinvent or are drawn from a linked Impact Assessment.
  • measured refers to emissions which are quantified using physical measurement. Terms to describe the measurement technique are contained in the measurement glossary.
  • tier 1 models quantify emissions from activity data (i.e., data on Inputs, Practices, etc.) using a simple equation with parameters which are not country or region specific.
  • tier 2 models quantify emissions from activity data using a simple equation, often of the same form as the tier 1 model, but with geographically specific parameters.
  • tier 3 models quantify emissions from activity data but use equations or algorithms that differ from tier 1 and tier 2 approaches. These approaches include process based models and statistical models with various forms.
  • not relevant means this emission is not relevant and in this case value = 0.

Possible values are: background, measured, tier 1, tier 2, tier 3, not relevant

methodModel
TermYes

A reference to the Term describing the method for measuring the Emission or the model used to calculate it.

This field has additional validation rules when set:

  • the methodModel.termType must have one of the following values: model, methodEmissionResourceUse.

methodModelDescription
stringNo

A free text field, describing the method for measuring the Emission or the model used to calculate it.

properties
List[Property]No

A list of Properties of the Emission, which would override any default properties specified in the term.

properties cannot be duplicated. The following fields determine whether a Property is unique: term.@id, key.@id, date, startDate, endDate

inputs
List[Term]No

For background Emissions, the Term(s) describing the Inputs they are associated with. This is a required field for background Emissions.

inputs cannot be duplicated. The following fields determine whether a Term is unique: @id

This field has additional validation rules when set:

  • the inputs.termType must have one of the following values: biologicalControlAgent, electricity, feedFoodAdditive, fuel, material, inorganicFertiliser, organicFertiliser, biochar, fertiliserBrandName, pesticideAI, pesticideBrandName, seed, soilAmendment, substrate, veterinaryDrug, water, transport, animalProduct, crop, aquaticCrop, forage, cropResidue, liveAnimal, liveAquaticSpecies, processedFood, excretaManagement, wasteManagement, operation, otherOrganicChemical, otherInorganicChemical.

animals
List[Term]No

For background Emissions, the Term(s) describing the Animal(s) they are associated with.

animals cannot be duplicated. The following fields determine whether a Term is unique: @id

This field has additional validation rules when set:

  • the animals.termType must have one of the following values: liveAnimal, liveAquaticSpecies.

transport
List[Term]No

For Emissions created by transport, the Term(s) describing the transport.

transport cannot be duplicated. The following fields determine whether a Term is unique: @id

operation
TermNo

For Emissions created by an operation, the Term describing the operation.

transformation
TermNo

For Emissions created during a Transformation, the Term describing the Transformation.

site
SiteNo

If the Cycle occurred on multiple Sites, the Site where this Emission occurred.

country
TermNo

The country from the Glossary, following GADM naming conventions. This is for background emissions (emissions from inputs production) only.

This field has additional validation rules when set:

  • the country.termType must have one of the following values: region.
  • methodTier must also be set.

source
SourceNo

A reference to the Source of these data, if different from the defaultSource of the Cycle.

otherSources
List[Source]No

A list of references to any other sources of these data.


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.

FieldTypeDefinition
@context

The location of the JSON-LD context file.

@id

The unique ID assigned to the Node by HESTIA.

@type

Emission

percentile10th
number

The 10th percentile of value.

percentile90th
number

The 90th percentile of value.

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
array[string]

A list of fields that have been 'aggregated' using data from multiple Cycles.

aggregatedVersion
array[string]

A list of versions of the aggregation engine corresponding to each aggregated field.

deleted
boolean

Indicates if this emission has been marked as deleted from the original dataset.


Example 1

{
  "@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": "yyu8v5",
    "@type": "Source",
    "name": "Murwira (1993)"
  }
}

Example 2

{
  "@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"
  },
  "methodModelDescription": "version 3.1.2",
  "methodTier": "background",
  "inputs": [
    {
      "@id": "electricityGridMarketMix",
      "@type": "Term",
      "name": "Electricity, grid, market mix",
      "termType": "electricity"
    }
  ],
  "country": {
    "@id": "GADM-FRA",
    "@type": "Term",
    "name": "France"
  },
  "source": {
    "@id": "yyu8v5",
    "@type": "Source",
    "name": "Wernet et al (2016)"
  }
}

Example 3

{
  "@type": "Emission",
  "term": {
    "@id": "co2ToAirUreaHydrolysis",
    "@type": "Term",
    "name": "CO2, to air, urea hydrolysis",
    "units": "kg CO2",
    "termType": "emission"
  },
  "value": [
    32
  ],
  "methodModel": {
    "@id": "ipcc2006",
    "@type": "Term",
    "name": "IPCC (2006)",
    "termType": "model"
  },
  "methodTier": "tier 1"
}

Example 4

{
  "@type": "Emission",
  "term": {
    "@id": "pesticideToWaterInputsProduction",
    "@type": "Term",
    "name": "Pesticide, to water, inputs productions",
    "units": "kg active ingredient",
    "termType": "emission"
  },
  "key": {
    "@id": "CAS-1071-83-6",
    "@type": "Term",
    "name": "Glyphosate",
    "units": "kg active ingredient",
    "termType": "pesticideAI"
  },
  "inputs": [
    {
      "@id": "rapeseedSeedWhole",
      "@type": "Term",
      "name": "Rapeseed, seed (whole)",
      "termType": "crop"
    }
  ],
  "value": [
    0.00622
  ],
  "methodModel": {
    "@id": "usetoxV2-1",
    "@type": "Term",
    "name": "USEtox v2.1",
    "termType": "model"
  },
  "methodTier": "background"
}