Argo vocabulary server

The NVS

The NERC Vocabulary Server (NVS) provides access to lists of standardised terms that cover a broad spectrum of the oceanographic domain and associated communities. The NVS is technically-managed and hosted by the British Oceanographic Data Centre (BODC), a national facility part of the UK’s National Oceanography Centre (NOC). Key funding sources for the NVS include the UK’s Natural Environment Research Council (NERC) as well as European Union’s initiatives such as the Open Network for Marine Environmental Data (NETMAR) programme, the SeaDataNet / SeaDataCloud projects and the Horizons 2020 ENVRI-FAIR project.

The NVS conforms to a set of standards designed to be compatible with Semantic Web tools and technologies, allowing its content to support the interoperability of datasets on the Web known as Linked Data. The NVS can be accessed via content negotiation (as RDF/XML), SPARQL endpoint or SOAP web services, upon which browser access is built.

How to request a new entry in Argo vocabularies

To propose a new Argo code in a vocabulary, you should open a ticket on:

• https://github.com/nvs-vocabs/ArgoVocabs/issues 

The ticket is then assigned to the editor in charge of the vocabulary table.
When approved, the new code is published on NVS, the Argo NetCDF file format checker is updated, and the ticket closed.

All Argo vocabulary tickets are visible on the AVTT project board:

• https://github.com/orgs/nvs-vocabs/projects/2 

 Moreover, ADMT action list items related to the NVS are tracked on another GitHub project board:

• https://github.com/orgs/nvs-vocabs/projects/10

VocPrez

The NVS web user interface is called VocPrez, and can be accessed through the link vocab.nerc.ac.uk. VocPrez hosts general information on controlled vocabularies, a complete list of NVS collections (under ‘Vocabularies’) and Simple Knowledge Organization System (SKOS) concept schemes (under ‘Thesauri’), an interactive SPARQL endpoint to allow for machine-readable NVS query responses, and link to other tools hosted on the BODC website.

One of the most useful features of VocPrez is the NVS Search interface. This allows a user to search for a term (aka ‘concept’) in a vocabulary collection; search for a term across vocabulary collections; search for vocabulary collections; and explore mappings (i.e. relationships) of terms linking different collections. Search results may be downloaded in tab-delimited (tsv) as well as comma-delimited (csv) formats; moreover, search queries produce search results links that may be bookmarked and shared.

Argo vocabularies

Argo vocabularies, originally known as reference tables, are used extensively to constrain the contents of the Argo NetCDF files, and to enhance the interoperability of the Argo data system. The transfer of existing reference tables to NVS collections, as well as the creation of new ones, is an ongoing effort managed by the Argo Vocabulary Task Team and supported by BODC.

Argo vocabularies on the NVS can be extracted in the VocPrez NVS Search interface by typing ‘argo’ in the vocabulary collections search bar and ticking ‘Governance’ only. The search result can be accessed through this link: vocab.nerc.ac.uk/search_nvs/cvl/?searchstr=argo&options=governance, and will display a list of all the Argo collections created to date.

Please see below a list of all original Argo reference tables extracted from the Argo User Manual (‘No.’), their corresponding NVS collection IDs (‘Vocab’) and links to the NVS collections themselves as VocPrez search results (‘Search URL’):

Please note that each collection also has a static URL, linked in the ‘Vocabularies’ page on VocPrez: vocab.nerc.ac.uk/collection/?filter=argo.

Argo Vocabulary Task Team (AVTT)

The Argo NVS collections are overseen by a sub-group of the Argo Data Management Team called the Argo Vocabulary Task Team (AVTT). Each AVTT member is responsible for a subset of Argo tables/collections, based on their interest and contributions.

The AVTT team is organised in sub-teams, reflecting the thematic groupings of collections for which sub-team members are responsible. Each sub-team is linked to a list of NVS collection-specific repositories, called after collection IDs (e.g. ‘R01’, ‘RR2’, ‘R03’, etc.). This organisation is reflected in the AVTT GitHub space (see below).

Vocabs discussions & submitting new terms

Anyone can initiate a discussion about an existing concept or collection, or submit the case for the creation of new ones.

The best platform for doing so is the AVTT GitHub space. This is set up so that AVTT members are notified of discussions pertaining the groupings of collections they are responsible for, while transparency, traceability and visibility is maintained due to the public nature of the web platform. Anyone may follow and contribute to a discussion by subscribing to the issue of interest to receive notifications.

• For collection-specific queries, discussions, updates etc., please contribute to an existing issue or open a new one in the appropriate collection-specific repository. The complete list of GitHub repositories is hosted in the AVTT parent organization, the ‘nvs-vocabs’ page, and can be viewed by searching for ‘argo’.
• For general Argo vocabularies discussions, or those pertaining more than one collection, please use the ArgoVocabs repository, which is linked to the whole AVTT.

If the discussion concerns a specific sub-team, the tagging GitHub functionality may be used (e.g. ‘@nvs-vocabs/reference-tables’)

To ensure that the discussion is picked up, the Argo data management mailing list may be contacted, providing the link to the GitHub issue in question. Alternatively, a GitHub ticket should be created to ensure discussions that take place via email are kept public and visible.

It is advisable to observe a two-week time limit to progress a discussion; if no comments or feedback ensue in that time frame, the decision can be considered approved by the AVTT and may brought to the attention of the ADMT executive committee.

Updating the NVS

It is important to receive final approval by the ADMT executive committee before carrying out edits to existing Argo NVS terms and collections. Once that has been granted, Argo Vocabulary Editors can update the Argo NVS collections they are responsible for by using the NVS Vocab Editor. Registration on the BODC and VocPrez websites are necessary before updates can be made. Please contact the BODC Vocabulary Management team at vocab.services@bodc.ac.uk for support.