Site>Measurement

Measurement


Type:Blank Node


A soil or climate Measurement on a Site. For example, the soil pH on 3 January 2020. The method used to take the Measurement often changes the results, and it should ideally be specified. Each Measurement must be unique, and the fields which determine uniqueness are defined in the measurements field of the Site.


FieldTypeRequiredDefinition
term
TermYes

A reference to the Term describing the Measurement.

This field has additional validation rules when set:

  • the term.termType must have one of the following values: measurement, soilTexture, soilType, usdaSoilType.

description
stringNo

A short description of the Measurement.

value
array[number|boolean]No

The quantity of the Measurement. If an average, it should always be the mean. Can be a single number (array of length one), an array of numbers with associated dates (e.g., representing multiple Measurements over time) or a boolean (e.g., Heavy winter precipitation can be either `true` or `false`).

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, replications, 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 (and times) of the Measurements in ISO 8601 format (YYYY-MM-DD, YYYY-MM, YYYY, --MM-DD, --MM, or YYYY-MM-DDTHH:mm:ssZ).

startDate
stringNo

For period Measurements, the start date of the Measurement in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY).

endDate
stringNo

For period Measurements, the end date of the Measurement in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY).

measurementDuration
numberNo

The duration of the Measurement in days.

depthUpper
numberNo

For soil Measurements, the upper (shallower) depth of the Measurement interval in centimeters, using positive numbers.

depthLower
numberNo

For soil Measurements, the lower (deeper) depth of the Measurement interval in centimeters.

latitude
numberNo

The latitude of the Measurement if different from the centroid of the Site (-90 to 90, WGS84 datum).

longitude
numberNo

The longitude of the Measurement if different from the centroid of the Site (-90 to 90, WGS84 datum).

methodClassification
stringYes

  • An on-site physical measurement is based on weather stations or indoor climate monitoring units on the Site or on soil samples taken from the Site.
  • A physical measurement on nearby site is based on data from nearby weather stations or indoor climate monitoring units or on soil samples from nearby Sites which can be assumed to represent the current Site.
  • modelled using other measurements means the data are estimated by applying a statistical or process based model, which is associated with some error, to other measurements.
  • A tier 1 model quantifies the Measurement using activity data (i.e., data on Inputs, Practices, etc.) using a simple equation with parameters which are not country or region specific.
  • A tier 2 model quantifies the Measurement from activity data using a simple equation, often of the same form as the tier 1 model, but with geographically specific parameters (e.g., other Site Measurements).
  • A tier 3 model quantifies the Measurement from activity data but uses equations or algorithms that differ from the tier 1 model and tier 2 model approaches. Tier 3 approaches include process based models and statistical models with various forms.
  • A geospatial dataset is data in raster or vector format with sub-regional and sub-national spatial resolution.
  • regional statistical data are soil or climate measurements representative of the region.
  • country-level statistical data are soil or climate measurements representative of the country.
  • expert opinion is a soil or climate measurement estimated by an individual or organisation with context-specific knowledge.
  • An unsourced assumption is a soil or climate measurement estimated by pure assumption or provided without any information on its source.

Possible values are: on-site physical measurement, modelled using other measurements, tier 3 model, tier 2 model, tier 1 model, physical measurement on nearby site, geospatial dataset, regional statistical data, country-level statistical data, expert opinion, unsourced assumption

methodClassificationDescription
stringNo

Further description or justification of the methodClassification.

method
TermNo

For physical measurements, a reference to the Term describing the method used to acquire the measurement.

This field has additional validation rules when set:

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

methodDescription
stringNo

A free text field describing the method used to acquire the Measurement.

source
SourceNo

A reference to the Source of these data, if different from the defaultSource of the 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 Measurement, 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

Measurement

percentile10th
number

The 10th percentile of value.

percentile90th
number

The 90th percentile of value.

schemaVersion
string

Version of the schema when the data was 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 Sites.

aggregatedVersion
array[string]

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


Example 1

{
  "@type": "Measurement",
  "term": {
    "@id": "sandSoilTexture",
    "@type": "Term",
    "name": "Sand (soil texture)",
    "termType": "soilTexture"
  },
  "methodClassification": "geospatial dataset"
}

Example 2

{
  "@type": "Measurement",
  "term": {
    "@id": "organicCarbonPerKgSoil",
    "@type": "Term",
    "name": "Organic carbon (per kg soil)",
    "units": "g C / kg soil",
    "termType": "measurement"
  },
  "method": {
    "@id": "chromicAcidWetOxidation",
    "@type": "Term",
    "name": "Chromic acid wet oxidation",
    "termType": "methodMeasurement"
  },
  "methodClassification": "on-site physical measurement",
  "dates": [
    "1989-01",
    "1989-01-01",
    "1989-01-01T20:20:39"
  ],
  "value": [
    0.1916,
    0.197,
    0.6794
  ],
  "distribution": [
    [
      0.039,
      0.24,
      0.269,
      0.342,
      0.068
    ],
    [
      0.097,
      0.654,
      0.161,
      0.064,
      0.009
    ],
    [
      0.98,
      0.755,
      0.923,
      0.269,
      0.47
    ]
  ],
  "statsDefinition": "replications"
}