Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Feature of interest attributes

In the TERN Ontology, a Feature of Interest (FOI) is an ecological scale During a sampling event, observations (e.g. number of flowers, vegetation height, body mass) are performed on features of interest (foi). Features of interest are the “real world” objects that we are interested in sampling/measuring across different ecological scales (e.g. plant individual, animal population, soil , profile or climate). Observations are grouped by ecological scales and the FOI type and feature identifier are returned for each observation. TERN’s LinkedData site has more information about Features of Interest.

Every instance of a FOI may have has additional attributes related exclusively to that instance. For example, the FOI is an individual plant, and there can be multiple instances of the FOI such as a specific tree or plant (tree1, tree2, tree3, etc).

This information can be accessed via the /foi/attributes endpoint.

...

Code Block
curl -X POST "https://ecoplots.tern.org.au/api/v1.0/foi/attributes?dformat=ndjson" -H "accept: */*" -H "X-Api-Key: aAbBcC...xXyYzZ" -H "Content-Type: application/json" -d "{\"page_number\": 1, \"page_size\": 10, \"query\": {}}"

Response excerpt:

Code Block
{
   "attributeId":"http://linked.data.gov.au/dataset/ausplots/soil_characterisation-attr-lower_depth-122923",
   "featureId":"http://linked.data.gov.au/dataset/ausplots/site_visit_id-58580-soil_char_id-122923",
   "attributeName":"soil depth max",
   "attributeConceptId":"http://linked.data.gov.au/def/tern-cv/263d7143-e88d-4105-83e7-00d75035a2b3",
   "value":0.1,
   "valueId":"N/A",
   "valueUnit":"Metre",
   "valueUnitId":"http://qudt.org/vocab/unit/M"
}
{
   "attributeId":"http://linked.data.gov.au/dataset/ausplots/soil_characterisation-attr-upper_depth-122923",
   "featureId":"http://linked.data.gov.au/dataset/ausplots/site_visit_id-58580-soil_char_id-122923",
   "attributeName":"soil depth min",
   "attributeConceptId":"http://linked.data.gov.au/def/tern-cv/376efe60-0550-42b4-b90b-110015806dc7",
   "value":0.0,
   "valueId":"N/A",
   "valueUnit":"Metre",
   "valueUnitId":"http://qudt.org/vocab/unit/M"
}
...
{
   "attributeId":"http://linked.data.gov.au/dataset/ausplots/soil_characterisation-attr-layer_barcode-122923",
   "featureId":"http://linked.data.gov.au/dataset/ausplots/site_visit_id-58580-soil_char_id-122923",
   "attributeName":"voucher barcode",
   "attributeConceptId":"http://linked.data.gov.au/def/tern-cv/6d351831-45da-403c-919b-1cee41950488",
   "value":"NST004264",
   "valueId":"N/A",
   "valueUnit":"N/A",
   "valueUnitId":"N/A"
}

...

System attributes

When an a system (instrument) was used to measure the result of an observation, the type of instrumentsystem and the instrument system instance identifier was recorded along the observation data.

Information about additional Instrument system attributes that are related exclusively to an instance can be accessed via the /instrumentssystems/attributes endpoint.

Request example:

Code Block
curl -X POST "https://ecoplots.tern.org.au/api/v1.0/systems/attributes?dformat=ndjson" -H "accept: */*" -H "X-Api-Key: aAbBcC...xXyYzZ" -H "Content-Type: application/json" -d "{\"page_number\": 1, \"page_size\": 10, \"query\": {}}"

Response excerpt:

Code Block
{
   "attributeId":"http://linked.data.gov.au/dataset/ausplots/tern_basal_area-attr-basal_area_factor-475048",
   "instrumentIdsystemId":"http://linked.data.gov.au/dataset/ausplots/tern_basal_area-inst-basal_area-475048",
   "attributeName":"basal area factor",
   "attributeConceptId":"http://linked.data.gov.au/def/tern-cv/dd34fc05-012d-4092-9324-a4cbcf29bf0a",
   "value":0.1,
   "valueId":"N/A",
   "valueUnit":"Unitless",
   "valueUnitId":"http://qudt.org/vocab/unit/UNITLESS"
}
...
{
   "attributeId":"http://linked.data.gov.au/dataset/ausplots/tern_basal_area-attr-basal_area_factor-475069",
   "instrumentIdsystemId":"http://linked.data.gov.au/dataset/ausplots/tern_basal_area-inst-basal_area-475069",
   "attributeName":"basal area factor",
   "attributeConceptId":"http://linked.data.gov.au/def/tern-cv/dd34fc05-012d-4092-9324-a4cbcf29bf0a",
   "value":1.0,
   "valueId":"N/A",
   "valueUnit":"Unitless",
   "valueUnitId":"http://qudt.org/vocab/unit/UNITLESS"
}

...

Code Block
curl -X POST "https://ecoplots.tern.org.au/api/v1.0/taxon?dformat=ndjson" -H "accept: */*" -H "X-Api-Key: aAbBcC...xXyYzZ" -H "Content-Type: application/json" -d "{\"page_number\": 1, \"page_size\": 10, \"query\": {}}"

Response excerpt:

Code Block
{
   "taxonID":"https://id.biodiversity.org.au/taxon/apni/51612493",
   "scientificNameID":"https://id.biodiversity.org.au/name/apni/54714",
   "scientificName":"Boraginaceae Juss.",
   "scientificNameAuthorship":"Juss.",
   "acceptedNameID":"https://id.biodiversity.org.au/taxon/apni/51612493",
   "acceptedName":"Boraginaceae Juss.",
   "nameAccordingToID":"https://id.biodiversity.org.au/reference/apni/46762",
   "nameAccordingTo":"CHAH (2008), Australian Plant Census",
   "namePublishedInID":"None",
   "namePublishedIn":"None",
   "namePublishedInYear":"None",
   "originalNameUsageID":"None",
   "originalNameUsage":"None",
   "parentNameUsageID":"None",
   "parentNameUsage":"None",
   "conceptID":"https://id.biodiversity.org.au/instance/apni/650956",
   "nomenclaturalStatus":"nom. cons.",
   "nomenclaturalCode":"ICN",
   "taxonomicStatus":"accepted",
   "higherClassification":"Plantae|Charophyta|Equisetopsida|Magnoliidae|Asteranae|Boraginaceae",
   "kingdom":"Plantae",
   "class":"Equisetopsida",
   "order":"None",
   "family":"Boraginaceae",
   "subfamily":"None",
   "genus":"None",
   "subgenus":"None",
   "phylum":"None",
   "specificEpithet":"None",
   "cultivarEpithet":"None",
   "genericName":"None",
   "infragenericEpithet":"None",
   "infraspecificEpithet":"None",
   "taxonRank":"None",
   "taxonRemarks":"None",
   "verbatimTaxonRank":"None",
   "vernacularName":"None"
}{
   "taxonID":"https://id.biodiversity.org.au/node/apni/2892197",
   "scientificNameID":"https://id.biodiversity.org.au/name/apni/114499",
   "scientificName":"Eucalyptus crebra F.Muell.",
   "scientificNameAuthorship":"F.Muell.",
   "acceptedNameID":"https://id.biodiversity.org.au/node/apni/2892197",
   "acceptedName":"Eucalyptus crebra F.Muell.",
   "nameAccordingToID":"https://id.biodiversity.org.au/reference/apni/42942",
   "nameAccordingTo":"CHAH (2006), Australian Plant Census",
   "namePublishedInID":"None",
   "namePublishedIn":"None",
   "namePublishedInYear":"None",
   "originalNameUsageID":"None",
   "originalNameUsage":"None",
   "parentNameUsageID":"None",
   "parentNameUsage":"None",
   "conceptID":"https://id.biodiversity.org.au/instance/apni/612750",
   "nomenclaturalStatus":"",
   "nomenclaturalCode":"ICN",
   "taxonomicStatus":"accepted",
   "higherClassification":"Plantae|Charophyta|Equisetopsida|Magnoliidae|Rosanae|Myrtales|Myrtaceae|Eucalyptus|crebra",
   "kingdom":"Plantae",
   "class":"Equisetopsida",
   "order":"None",
   "family":"Myrtaceae",
   "subfamily":"None",
   "genus":"None",
   "subgenus":"None",
   "phylum":"None",
   "specificEpithet":"None",
   "cultivarEpithet":"None",
   "genericName":"None",
   "infragenericEpithet":"None",
   "infraspecificEpithet":"None",
   "taxonRank":"None",
   "taxonRemarks":"None",
   "verbatimTaxonRank":"None",
   "vernacularName":"None"
}

...