Cycle>Practice

Practice


Type:Blank Node


A Practice used during a Cycle or Transformation. Each Practice must be unique, and the fields which determine uniqueness are defined in the practices field of the Cycle or Transformation.


FieldTypeRequiredDefinition
term
TermYes

A reference to the Term describing the Practice. This can be replaced by a description instead if the Term isn't available in the Glossary.

This field has additional validation rules when set:

  • the term.termType must have one of the following values: animalBreed, animalManagement, aquacultureManagement, cropEstablishment, cropResidueManagement, excretaManagement, landCover, landUseManagement, pastureManagement, standardsLabels, system, tillage, waterRegime, wasteManagement, operation.

description
stringNo

A description of the Practice. This is a required field if term is not provided.

variety
stringNo

For Land cover terms only, the variety (cultivar) of a crop. Standardised variety names are defined in external glossaries, such as the OECD, GEVES, PLUTO, or CPVO glossaries.

This field has additional validation rules when set:

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

key
TermNo

If the data associated with the Practice are in key:value form, the key.

This field has additional validation rules when set:

  • the key.termType must have one of the following values: crop, aquaticCrop, forage, biologicalControlAgent, inorganicFertiliser, organicFertiliser, biochar, otherInorganicChemical, otherOrganicChemical, pesticideAI, soilAmendment, landCover.

value
array[number|string|boolean|null]No

The value associated with the Practice. If an average, it should always be the mean.

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 Practice in ISO 8601 format (YYYY-MM-DD, YYYY-MM, YYYY, --MM-DD, --MM, or YYYY-MM-DDTHH:mm:ssZ).

startDate
stringNo

The start date of the Practice if different from the start date of the Cycle in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY). The start date is the first date the practice is carried out. The practice will continue without stopping until the end date is reached. Alternatively, use the `dates` term to specify practices which occur on a number of different dates.

endDate
stringNo

The end date of the Practice if different from the end date of the Cycle in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY). The end date is the last date the practice is carried out. The practice will continue without stopping until the end date is reached. Alternatively, use the `dates` term to specify practices which occur on a number of different dates.

methodClassification
stringNo

A classification of the method used to acquire or estimate the term and value. Overrides the defaultMethodClassification specified in the Cycle. methodClassification should be specified separately for properties (see Property).

  • 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

This field has additional validation rules when set:

  • methodClassificationDescription must also be set.

methodClassificationDescription
stringNo

A justification of the methodClassification used. If the data were estimated with assumptions this field should also describe the assumptions. This is a required field if methodClassification is specified.

model
TermNo

A reference to the Term describing the model used to estimate these data.

This field has additional validation rules when set:

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

modelDescription
stringNo

A free text field, describing the model used to estimate these data.

areaPercent
numberNo

The area of the Site that Practice occurred on, specified as a percentage of Site area. If the units of the term are already in % area, do not use this field and use value instead to record these data.

price
numberNo

The price paid for this Practice. The price should be expressed per the units defined in the term. The currency must be specified. The price of the inputs associated with this practice should be included in the inputs rather than here.

This field has additional validation rules when set:

  • currency must also be set.

priceSd
numberNo

The standard deviation of price.

This field has additional validation rules when set:

  • priceStatsDefinition must also be set.

priceMin
numberNo

The minimum of price.

This field has additional validation rules when set:

  • priceStatsDefinition must also be set.

priceMax
numberNo

The maximum of price.

This field has additional validation rules when set:

  • priceStatsDefinition must also be set.

priceStatsDefinition
stringNo

What the descriptive statistics for price are calculated across.

Possible values are: cycles, time, cycles and time

cost
numberNo

The total cost of this Practice (price x quantity), expressed as a positive value. The currency must be specified. The cost of the inputs associated with this practice should be included in the inputs rather than here.

This field has additional validation rules when set:

  • currency must also be set.

costSd
numberNo

The standard deviation of cost.

This field has additional validation rules when set:

  • costStatsDefinition must also be set.

costMin
numberNo

The minimum of cost.

This field has additional validation rules when set:

  • costStatsDefinition must also be set.

costMax
numberNo

The maximum of cost.

This field has additional validation rules when set:

  • costStatsDefinition must also be set.

costStatsDefinition
stringNo

What the descriptive statistics for cost are calculated across.

Possible values are: cycles, time, cycles and time

currency
stringNo

The three letter currency code in ISO 4217 format.

ownershipStatus
stringNo

For operations, the ownership status of the equipment used to perform the operation.

Possible values are: owned, rented, borrowed

This field has additional validation rules when set:

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

primaryPercent
numberNo

For primary processing operations in food processing Cycles, the percent of primary Product produced with the operation. For example, if the Cycle represents Oil palm, oil (crude) produced only with the operation Pressing, with screw press, the primaryPercent would be 100.

site
SiteNo

If the Cycle occurred on multiple Sites, the Site where this Practice was used.

source
SourceNo

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

otherSources
List[Source]No

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

properties
List[Property]No

A list of Properties of the Practice, 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


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

Practice

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.


Example 1

{
  "@type": "Practice",
  "term": {
    "@id": "soilAssociationOrganicStandard",
    "@type": "Term",
    "name": "Soil Association Organic Standard",
    "termType": "standardsLabels"
  },
  "startDate": "1996-01-01"
}

Example 2

{
  "@type": "Practice",
  "term": {
    "@id": "croppingDuration",
    "@type": "Term",
    "name": "Cropping Duration",
    "units": "days",
    "termType": "landUseManagement"
  },
  "value": [
    163
  ]
}

Example 3

{
  "@type": "Practice",
  "term": {
    "@id": "cloverPlant",
    "@type": "Term",
    "name": "Clover plant",
    "termType": "landCover"
  },
  "variety": "Small leafed clover",
  "startDate": "1996-01-01",
  "endDate": "1996-01-01",
  "value": [
    100
  ]
}