The SensorWeb serves as a metadata base for your device(s) and is e. g. linked with the MOSAiC Central data Storage (MCS) where the data can be found by the MOSAiC community before the public release date in 2023 and is accordingly important. PID (Persistent Identifiers) can be generated for configurations of your device and linked with your data publication in PANGAEA, hereby complementing your metadata.
One of the duties of the SensorWeb is to act as an interface for metadata to the Dashboard opportunity. The Dashboard is important not only for you to see a quicklook of your data during the mission, but even more for other teams, too, who might want to plan further actions!!
Please learn more about this opportunity, e. g. the Near Real Time Data Format, by visiting: DASHBOARD
The parameter and (parameter) properties are important metadata for the Dashboard to work properly.
Within the sensor.awi.de web pages described below, don't forget to use the 'Save' button at the bottom whenever needed for some of the frames discussed. I don't mention it explicitly in most cases.
May be you have to ask our IT O2A-Support team via sensor@awio2a-support(at)awi.de to prepare something for your needs. The email address sensor@awi.de is depreciated. It will work currently but will be turned off some time in the future. Please start using O2A Support <o2a-support@awi.de> instead.
Recipe for editing:
1) Please go to https://sensor.awi.de (it will be http://sensor.fs-polarstern.de/ while being on Polarstern). You should have got a notification by email about your account. Login is in the upper right corner (dark blue field).
...
8) You can also check whether you are happy with the "type" declaration. This is from a predefined list. If another term in the predefined list matches your device better, please choose that one. If you are unhappy with all available options please contact contact o2a-support@awisupport(at)awi.de for a desired new entry. Save button (lower right corner)!
9) Next the "Contacts" should be updated by clicking on the "Contacts"-Tab. Currently, there are 8 differentroles of contacts in a predefined list available (see later on):
Data Provider: Has write permission in the device directories of the MOSAiC Central data Storage (MCS)
Data Scientist
Device Contact: Depreciated. Will be deleted sometime in the future.
dship connector: Important for internal data management reasons.dship connector: Only devices with the contact 'Polarstern DSHIP' with the role dship connectort will appear in DSHIP
Editor: Is able to edit the SensorWeb entry and has write permission in the device directories of the MOSAiC Central data Storage (MCS)
Engineer in Charge
Owner: Actually institute name (affiliation)
...
Important for your team are correct and enough settings of theroles Editor , Data Provider, and dship connector. Only those persons listed as Editor or Data Provider will be able to write your data into the MCS!!
In addition we, i. e. AWI, demand entries for Owner/Affiliation and PI. All other Roles - if specified - are useful information for any other users to get quickly in contact to the right persons if needed.
...
- The device editor listed as an editor (presumably you). (Done by the AWI IT team)
- Myself as an editor (chief editor)Chief Editor. (Done by the AWI IT team)
...
- Read "owner" as "affiliation", here. The naming will change sometime in the future.- *** In case the owner/affiliation is distinct to me, I will do the job and you should check it. ***
- If your affiliation is not listed in the predefined list please ask o2a-support@awisupport(at)awi.de to implement it.
- The PI of the device (may be you, too).
- *** Name "polarstern dship" connected to the role "dship connector" for data management reasonsto import the device in DSHIP. ***
10. Next the "Parameters" should be added, which are actually measured. For that click on the "Parameters"-Tab (in the second row). For each parameter "+ Add" it.
Here we look for user-friendly output variables. We can't cover every aspect with this system. We also have to leave the decision whether to mention all derived quantities or only a selected important subset to you. With this decision please keep in mind what other users onboard or offline might be interested in. Your data can be presented in real-time or near-real-time on dashboards during the mission inside Polarstern. They might influence the planning of other activities! It's up to you how easy you can make it and want to make it to the general user.
First have a look whether your parameter Type as well as your desired Unit is listed in the two predefined lists.
If anything (Type and/or Unit) is not in the list, please ask o2a-support@awisupport(at)awi.de to implement it and stop editing this parameter at this point and do something different. (I am sorry, that this is somewhat complicated.)
...
14. After everything is set and before the first data is measured, we have to set the state from "Construction" to "Public" and create a version (within the "Overview"-Tab, which should be easy) and to set a first Action (within the "Action"-Tab environment) to initialize the versioning.
- For the latter act click on the Tab
- Again: "+ Add"
- Set the Label: PS122-Leg_nr, e. g. PS122-2 in case the first measurement will happen during leg 2. (PS122 denotes that MOSAiC will be the 122nd Polarstern campaign.)
- Event Type: Commissioned (Ignore the advice under the Help button "?")
- For the time frame (From/Until) setting I got the advice to set the same date in the "From:"-field as well as in the "Until:"-field, e. g. the start date of your first leg.
From . From now on, this metadata and version can't be deleted, but only overwritten by a new version. (Old versions are stored "forever"!)
Special thanks to Peter von der Gathen for providing the original version of this manual!