Cycle>Transformation

Transformation


Type:Blank Node


The Transformation of one Product to a new Product in the same Cycle. One Transformation can follow another and they can be linked using transformationId. Environmental impacts created during Transformations are then included in the Impact Assessment. This means that Transformations should be used to represent any processes which are required to get the Product to its marketable form or to manage any waste that is created during production. In general, any essential grain drying, crop grading, and animal excreta management should be represented using Transformations.


FieldTypeRequiredDefinition
transformationId
stringYes

An identifier for each Transformation which must be unique within the Cycle.

term
TermYes

A reference to the Term describing the process or operation for transforming the Product.

This field has additional validation rules when set:

  • the term.termType must have one of the following values: excretaManagement, wasteManagement, operation.

description
stringNo

A description of the Transformation process or operation, including information not captured with other fields.

startDate
stringNo

The start date of the Transformation if different from the start date of the Cycle in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY).

endDate
stringNo

The end date of the Transformation if different from the end date of the Cycle in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY).

transformationDuration
numberNo

The duration of the Transformation in days. Defaulting to cycleDuration when not provided.

previousTransformationId
stringNo

The transformationId of the previous Transformation. This is used to link Transformations, so that a share of the products from the previous Transformation become the inputs of the current Transformation. If this field is not specified, the inputs of the Transformation come from the Cycle.

transformedShare
numberNo

The share of Products from the Cycle or the previous Transformation that enter the current Transformation. This field is useful when the physical quantities of Products being transformed are unknown, but the share transformed is known. For example, if Excreta, dairy cattle (kg mass) is a Product of a Cycle, transformedShare = 50, and Excreta, dairy cattle (kg mass) is an Input into this Transformation, 50% of the excreta is an Input to this Transformation. If there are more than one Product being transformed, transformedShare applies equally to all Products.

site
SiteNo

If the Cycle occurred on multiple Sites, the Site where this Transformation occurred. Use transformedShare to apportion the transformed Product across each Site.

properties
List[Property]No

A list of Properties of the Transformation.

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

inputs
List[Input]No

The Inputs into the Transformation.

inputs cannot be duplicated. The following fields determine whether a Input is unique: term.@id, dates, startDate, endDate, fromCycle, transport.term.@id, operation.@id, country.@id, region.@id, impactAssessment.id

This field has additional validation rules when set:

  • fromCycle must also be set.
  • producedInCycle must not be set.

emissions
List[Emission]No

The Emissions created from the Transformation.

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

This field has additional validation rules when set:

  • transformation must not be set.

products
List[Product]No

The Products created from the Transformation.

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

practices
List[Practice]No

The Practices used during the Transformation.

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

This field has additional validation rules when set:

  • the practices.term.termType must have none of the following values: excretaManagement, wasteManagement.


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

Transformation

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.


Example 1

{
  "@type": "Transformation",
  "transformationId": "second-transformation",
  "term": {
    "@id": "compostingInVessel",
    "@type": "Term",
    "name": "Composting - In Vessel",
    "termType": "excretaManagement"
  },
  "transformationDuration": 300,
  "previousTransformationId": "first-transformation",
  "transformedShare": 100,
  "inputs": [
    {
      "@type": "Input",
      "term": {
        "@id": "excretaBeefCattleFeedlotFedKgN",
        "@type": "Term",
        "name": "Excreta, beef cattle, feedlot fed (kg N)",
        "units": "kg N",
        "termType": "excreta"
      },
      "value": [
        150
      ],
      "fromCycle": true
    },
    {
      "@type": "Input",
      "term": {
        "@id": "rapeseedStraw",
        "@type": "Term",
        "name": "Rapeseed, straw",
        "units": "kg",
        "termType": "crop"
      },
      "value": [
        25
      ],
      "fromCycle": false
    }
  ],
  "emissions": [
    {
      "@type": "Emission",
      "term": {
        "@id": "ch4ToAirExcreta",
        "@type": "Term",
        "name": "CH4, to air, excreta",
        "units": "kg CH4",
        "termType": "emission"
      },
      "value": [
        8.7
      ],
      "methodModel": {
        "@id": "emepEea2019",
        "@type": "Term",
        "name": "EMEA-EEA (2019)",
        "termType": "model"
      },
      "methodTier": "tier 2"
    }
  ],
  "products": [
    {
      "@type": "Product",
      "term": {
        "@id": "excretaMixturesKgN",
        "@type": "Term",
        "name": "Excreta mixtures (kg N)",
        "units": "kg N",
        "termType": "excreta"
      },
      "value": [
        160
      ]
    }
  ]
}