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.
| Field | Type | Required | Definition |
|---|---|---|---|
term | Term | Yes | A reference to the Term describing the Measurement. This field has additional validation rules when set:
|
description | string | No | 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 | |
sd | array[number|null] | No | The standard deviation of This field has additional validation rules when set:
|
min | array[number|null] | No | The minimum of This field has additional validation rules when set:
|
max | array[number|null] | No | The maximum of This field has additional validation rules when set:
|
statsDefinition | string | No | What the descriptive statistics ( Possible values are: This field has additional validation rules when set:
|
observations | array[number|null] | No | The number of observations the descriptive statistics are calculated over. |
dates | array[string] | No | |
startDate | string | No | For period Measurements, the start date of the Measurement in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY). |
endDate | string | No | For period Measurements, the end date of the Measurement in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY). |
measurementDuration | number | No | The duration of the Measurement in days. |
depthUpper | number | No | For soil Measurements, the upper (shallower) depth of the Measurement interval in centimeters, using positive numbers. |
depthLower | number | No | For soil Measurements, the lower (deeper) depth of the Measurement interval in centimeters. |
latitude | number | No | The latitude of the Measurement if different from the centroid of the Site (-90 to 90, WGS84 datum). |
longitude | number | No | The longitude of the Measurement if different from the centroid of the Site (-90 to 90, WGS84 datum). |
methodClassification | string | Yes |
Possible values are: |
methodClassificationDescription | string | No | Further description or justification of the methodClassification. |
method | Term | No | For physical measurements, a reference to the Term describing the method used to acquire the measurement. This field has additional validation rules when set:
|
methodDescription | string | No | A free text field describing the method used to acquire the Measurement. |
source | Source | No | 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:
|
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 | 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 |
percentile90th | number | The 90th percentile of |
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"
}