Versions Compared

Key

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

...

Generally speaking: everything is an item in sensor.awi.de, covering the whole range from of platform-like items, such as . Examples of items in sensor.awi.de are not only vessels, AUVs, or stations via toolsmeasuring stations, but also collecting instruments, such as fish nets, pumps, or grabbing systems to sensors , and the sensor itself, such as methane sensorssensor, piezometerspiezometer, and nutrient analysersanalyser.

We always strive to use standardized vocabularies to describe items in sensor.awi.de, such as NERC (BODC 2021). Thus, for instance, the item "losgatos_awi_1303" can be attributed as to one of the cavity enhanced absorption spectrometers operated at AWI (http://vocab.nerc.ac.uk/collection/L05/current/LAB38/2/). Nonetheless, items cannot always be attributed with standardized vocables.

Every item must be assigned to a type (see table below). In the example, the LosGatos AWI 3K430000001303 is of type cavity enhanced absorption spectrometers. Its parent item is the station Radartower Helgoland , a station.


Overview tab of LosGatos AWI 3K430000001303 (4044) – Labversion of Greenhouse Gas Analyzer – at sensor.awi.de.

Short names and URN syntax

Short names are the semantical foundation of every item. They are required to be as unique as possible, so it has proven to be good practise to attach the serial or asset number to the item, e.g. losgatos_awi_1303.

Even if there are numerous examples, short names shall be lower case only. Technically it is possible to set them upper case, but there are other places in the process chain that are case-sensitive. Be also aware that you cannot create items with the same short name under one parent item.

The respective setup of an item can be derived from the full URN (Uniform Resource Locator). It is the concatenation of all participating items, e.g.:

  • station:radar_tower_helgoland:losgatos_awi_1303: the item losgatos_awi_1303 is mounted to the station:radar_tower_helgoland
  • vessel:mya_ii:fb_741202:fsi_9999a: the FSI_9999a (type: thermosalinograph) is attached to FB_741202, and in return that is mounted to Mya_II

The topmost item in the URN hierarchy is also stated with its item type, such as vessel.

Occasionally items are not assigned to a specific parental item, e.g when drifters are deployed somewhere. Then the URN reads without parental item, e.g. drifter:drifter_gmr_bgcd01 (6070) and it is a free-floating item with a URN syntax derived from the item type.

Recently the development of sensor.awi.de brought UUIDs for everything. The item station:radar_tower_helgoland:losgatos_awi_1303 has the UUID af127496-b8a6-4c4d-9b95-8c42f6a22afe. As of today (2021-06-17 15:18:15) UUIDs are only available via API.


...