Semantic group is a form of a container which enables you to group your data (sensors’ feeds/actuators/alarms) by your own logic.
For example, device 1 has two feeds/sensors: temperature and humidity, device 2 has one feed/sensor: pressure. Both of the devices are located in the living room. Therefore, you can put these three feeds in the same semantic container and name it Living Room.
There are two different ways in which semantic group is presented in WolkAbout IoT web application:
Data semantics module which is one of the modules in the main application menu.
Dashboard data semantics widget enables you to see real-time data of certain device(s) on a dashboard.
For more information, please see Dashboard/Data semantics widget section of this user guide.
Structure of Semantic Group
Semantic groups are organised in form of tiles where the main semantic group (parent group) can contain an infinite number of semantic subgroups (child groups) in which you can add data (sensor’s feeds, actuators, alarms and attributes) you want.
For example, one house can be a semantic group having first and second floor as its subgroups which can further comprise of subsubgroups: living room, kitchen, bathroom…etc. Sensor’s feeds, actuators, alarms and attributes placed in the same semantic group can be added from different devices (e.g. temperature from device 1 and pressure from device 2 in living room semantic group).
Data Semantics Main Page
To clarify how to apply Data Semantics, we have to go back to Create device step in managing IoT Platform. After you have successfully created your device (for further information on how to create your device, please refer to Device Management section of this guide), it will be displayed on the main Devices page, as well as in the Data Semantics module of the Platform as a default semantic group.
To navigate through Data Semantics page:
- Go to Data Semantics in the main navigation menu
- It consists of two tabs: Data Semantics and Templates
In Data Semantics tab, there is Data view box which displays default mapping i.e. lists all the devices and their sensors, actuators and hardware alarms you have created and/or have the access to on the Platform.
If you click on the button next to the device name label in the view box, it will expand/collapse a list of sensors, actuators and hardware alarms of that particular device.
Semantic groups view box is the space in which you create your hierarchy by organising data of one or more devices into semantic groups defined by your own criteria (e.g. sensors’ physical place - living room).
Above these two view boxes are Search data and Search groups boxes which help you search the data and the groups by typing their name in the search boxes. Additionally to that, there are two tabs on the main page of the module Data Semantics and Templates. You will be directed to Data Semantics tab initially when you enter the module for the first time.
Templates tab displays all the templates you have created or have the access to. Both in Data Semantics and Templates tab, semantic groups are in form of tiles.