Table of Contents

cosinuss° Health Platform

Remote vital signs monitoring using c-med° alpha or cosinuss° Two with the Gateway and the cosinuss° Health Platform.

Important notes to start with monitoring vital signs

  1. First off, please read the instructions of c-med° alpha and Gateway here or cosinuss° Two and Gateway here.
  2. Make sure the Gateway is connected to the internet and a power supply.
  3. The in-ear sensor, c-med° alpha or cosinuss° Two, should be switched on and inserted inside the ear canal.

Requirements for the visualization of vital parameters in the web interface dash

In order to have the vital sign data displayed in the web interface dash, the following prerequisites must be met:

If you need additional information or if still no data points are being presented, please take a look here.

Login to the cosinuss° Health Platform

WEB INTERFACE TABS

The web interface tabs can be found in the upper menu bar displayed below. These options allow navigation within the system. A detailed explanation of each menu option is provided below.

DASH

The dashboard shows the vital signs card for each patient with an assigned Gateway and sensor. The card contains 4 vital parameters and 2 quality indices, a deviation score, as well as sensor information and time since the data was received. The measured parameters are explained here, the rest of the card is explained in more detail in the subsections below.

cos-support-vitalsigncard-labelled-xxxx-v01.jpg

Numeric legend Displayed information
1 Patient pseudonym
2 Serial number of sensor
3 Battery level
4 Time of the last measurement
5 Deviation score
6 Vital sign parameters
7 Quality indicators

The displayed data is calculated as follows:

If the default setting is used, then the median of the last measurement would be based on this 3 minute time interval.


Patient ID (person pseudonym):

The pseudonym of a person is written in a bold blue abbreviation and is located in the upper-left corner of the diagram. Click on abbreviation to display the vital sign graphs (with all values from the current day 0-24 h). Click through different days for the history. The options of the daily view are described in the corresponding section.


Battery:

The current battery level of the sensor is illustrated here. When the battery level reaches 5 percent, the battery status will be highlighted in orange lettering. Please be aware that battery life in default configuration is approximately 24 hours and the charging time is approximately 1 hour.


Time:

This is the time, which has passed since the last measurement. If the clock is displayed in green, then the sensor is connected to the Gateway and a measurement is in progress.

Possible reasons if the timer raises above 15 min in the Gateway's default configuration may be:

Only when the clock is displayed in green are these correct person-related values. Since the very latest update, information about the sensor is also displayed, even if no connection has yet been established with the Gateway. This includes, battery level, signal strength and temperature values. These are sensor-specific data and do not represent vital signs of an individual.


Deviation Score:

It is displayed in the colored area and based on the four vital parameters (please see the table below):

Parameter / Score 3 2 1 0 1 2 3
SpO2 (%) ≤ 91 92 - 93 94 ≥ 95
Respiratory rate (1/min) ≤ 8 9 - 11 12 - 20 21 - 24 ≥ 25
Heart rate (1/min) ≤ 40 41 - 50 51 - 90 91 – 110 111 - 130 ≥ 131
Temperature (°C) ≤ 35.0 35.1 – 36.0 36.1 – 37.9 38.0 - 39.0 ≥ 39.1

Then the four individual scores are summed up to generate the overall deviation score:

Deviation Score Magnitude
0-3 Low
4-5 Intermediate
≥ 6 High

—-

Quality value:

Q is an indicator only for the Heart Rate data quality.

Quality value Grading
< 30 Poor measurement quality
30 - 45 Alright
45 - 60 Good values
> 60 Excellent values

Perfusion Index:

The Perfusion Index is a quality indicator for SpO2 measurement. It is influenced by different factors: blood circulation, ambient temperature, body position (sitting/lying), skin color, etc.

Perfusion Index Grading
< 0,1Poor / Unreliable
≥ 0,1 Good
0,2 - 2 Very good
> 2 Poor / Unreliable

Further information about whether the received data has been affected by distortion and which data set characteristics indicate an adequate data validity and accuracy is available here.


Temperature (T):

Displays the current body temperature of the user (provided the sensor is well-positioned in the ear). Temperature indication is also an indication of a possible poor fit of the sensor:

In these cases, the other values must be questioned!


Other values:

Heart rate is very stable and accurate. Fluctuations in the values ​​are possible and normal. Possible causes for fluctuations can be moving, speaking, or chewing.


You can access the sidebar of a person by clicking on its corresponding tile in the DASH view. In the sidebar it is possible to observe live data and the historical development of vital parameters. The selected user's tile will be grayed out as shown in the following illustration. Via the PERSONS and DEVICES tabs within the sidebar, settings of the devices and user data can be logged.

By clicking on a persons' pseudonym, you will not arrive at the Daily View anymore. Instead, click on the chart inside the sidebar to arrive at the new combined view, the Data View.

Display of data in the sidebar

In the sidebar you will see the recorded data of the last six hours as bar diagrams of:

The time intervals of the diagrams are divided into 30 minutes slots.

The quality indicator bars (Perfusion Index and Quality) fill up to show how reliable the corresponding measurements are. A low quality indicator is also indicated by the background color of the vital signs bar diagram. It can occur that the vital value is displayed with orange background due to low quality indicator, although the plotted value is in the optimal range. In this case, the value has to be nonetheless questioned. Values with a low quality indicator will be shown in lighter gray in the bar diagram itself.

If the upper and lower limits of the vital parameters are exceeded, a change in the deviation score will be the result.

At the bottom of the sidebar, there is the possibility to start a live measurement of that person by clicking on the play button. Please note that the initialization of the measurement may start a few seconds. The live measurement will run as long as you click on the stop button. During the live measurements vital parameter values are renewed every 10 seconds and you will also see an animated PPG (infrared) signal of the selected person.

Clicking on the time diagrams or on the data icon in the lower right corner of the sidebar, you will arrive at the Data View.

DATA VIEW

The new Data View of the cosinuss° Health platform enables an even more comprehensive and compact display of the measured data. The functionality, which was originally split into two different views, the Day View and the Detailed View, has now been combined into one single Data View.

Operation of the Data View

By clicking on a section of the measured data, the temporal axis can be enlarged. By clicking again on a subset of the data, you get the data displayed as a graph.

The calendar in the Data View bar can be used to select a specific day for which the data is to be displayed. The adjustable time indicates the start time from which the data for the day will be displayed. By using the arrows next to the time setting, you can jump to the previous or next day.

Display options The data format can be selected as well. You can choose between raw data and aggregated data. With aggregated data, you can select either to have the median or a Boxplot of all measured values displayed.

The export button allows you to download the vital data. You can use the settings just explained to adapt the data set to your needs.

DATA

Hover the mouse over Data in the menu bar to get the options Data CSV Download and Data Calendar displayed.

DATA CSV DOWNLOAD

Here you can find an overview of all requested ZIP files that can be downloaded at the moment. The generated ZIP files get all encrypted and the related passwords for the decryption process are listed in the table. It is recommended to use 7-Zip to unzip the files, as this tool performs the decryption of the files properly.

# 7-Zip is free software with open source. The most of the code is under the GNU LGPL license. Some parts of the code are under the BSD 3-clause License.
# Also there is unRAR license restriction for some parts of the code. Read 7-Zip License information.
 
# installing 7-Zip
 
# MS Windows
download: https://www.7-zip.org/
# Apple macOS
download: https://www.7-zip.org/download.html
 
# macOS MacPorts
sudo port install 7zip
# macOS brew
brew install p7zip
 
# Debian / Ubuntu
sudo apt install p7zip-full p7zip-rar
# Fedora or CentOS / RHEL
sudo yum install p7zip p7zip-plugins
# Arch
sudo pacman -S p7zip

Before you can download the CSV data, you need to request the according data file.

QUERY DATA

After clicking CSV Download, select QUERY DATA. Here you can consecutively select projects, persons, data types that you want to download as compressed CSV data. Once your query is specified enough, click on the “download csv” button.

In the next view, provide a description for your zip file. You may also choose if you want the time values of each data point relative to the start of the data file (in the CSV file: date_time_start) or as unix timestamps. When you are done, click “Confirm” and wait until the zip file is prepared for download.

After the data request, the zip files will stay there for 14 days. If you see no zip files or if you want to download expired data again, you can go to “query for data”.

You can also start a data request in this view. For this, click on Query for data. Again, you can pre-filter the file and add a description.

DATA CALENDAR

Calendar view of all data for a selected project (a project list drop-down menu on the top right is available once you have more than one project).

When you click on a day, you will get a list of all persons with measurements on that selected day. Here you can click “DATA” to jump to the day view. To download the data for the selected day, select the DATA CSV Download menu item.

You can also click on the name of the month to see which person was recorded on which day. From here you can jump directly to the day view of the selected person

PEOPLE

Select PEOPLE in the menu bar to see a list of all person IDs (pseudonyms) and the assignment to the sensors and Gateways. A list of the possible actions is provided below:

Create a person:

A subject needs to be assigned to a Gateway and a sensor. Also, a project needs to be connected with a subject. Therefore, please follow the instructions below:

  1. Select PEOPLE in the menu bar.
  2. Choose the correct project with SWITCH PROJECT and then Click on CREATE NEW to create a new person.
  3. After this, an automatically generated pseudonym has been created and assigned to the person.
  4. An input field will then open, and person settings can now be entered. These setting options are explained in detail in the following section.

For more information about the CSV data download, click here. However, it is not a prerequisite for creating a person. User data can be downloaded subsequently.

Edit a person:

In some cases, it might be necessary to reallocate sensors and Gateways or change subject information retrospectively. For example, if a different sensor size is needed or a subject is no longer part of a study. For this, select PEOPLE in the menu bar and click on the pseudonym, which is displayed in blue font and also known as the hash ID of the person. Then you enter the person detailed view. Here, more details about one person are listed, and subsequent adjustments can be made. This is the same dialog box that opens automatically after a new person is created, so all the settings described above can also be edited retrospectively. Possible actions are as follows:

The available and displayed setting options depend on what user rights have been assigned and what settings have been set. The data that may be entered can be adjusted in the project settings. You can find an overview of the different user rights here and how to set up a project here.

Further setting and display options:

After selecting PEOPLE in the menu bar, the following options appear when you hover over the row of one particular user.

GATEWAYS

Select Receiver in the menu bar to receive a list of all Gateways with their serial numbers, release id, and assigned persons. Click on the serial number to obtain additional information about one particular Gateway.

Gateway detailed overview

The detailed overview of one particular Gateway includes further details like time since the last synchronization with the server, network status, and much more additional information.

It is also possible to enable Wi-Fi for this Gateway (release ID > 29).

DEVICES

Select Devices in the menu bar to receive a list of all sensors with their serial, release id, and assigned persons. Click on the serial number to obtain additional information about one particular device.

Device detailed view

A Gateway which is assigned and in close proximity to the sensor will periodically send information about the sensor's last found advertising status, which can be seen here. This can be useful to receive feedback about, when the sensor was last seen and what battery level was reported at this point in time.

ADMIN

You will be provided with an admin account for your domain. With this account, it is possible to create new users with different roles and rights. Moreover, different projects within your domain can be created. If you are logged in with an admin account, you will see the ADMIN tab in the menu bar, as shown in the following image.

User

In the user overview, you can see a list of all users, create a new one, edit them or change their password. When clicking on the username, you can see more details of this user.

The following user roles can be assigned to a user upon creation or by editing:

When creating a new user or by editing existing users, users can be assigned to projects within the domain and can be disabled or activated.

Projects

In the user overview, you can see a list of all projects, create a new one, edit them or see all the data recorded in this project. When clicking on the project's hash ID, you can see more details of this project.

In the project's detailed view, you have some details listed, and you can add new event labels.

Event labels for Person Events can be created for each project. They may be used for a study setting when a person will do different actions (e.g. “Sleeping”, “Sitting”, “Experiment - Step 1”, …) to store the time when this event happened. You have to predefine these labels by editing the project. After adding the labels to the project, go to the detailed view of a (person), where you can select and confirm an event once it is happening. You may download them later using the API.

Help

This link leads to the cosinuss public WIKI start page.

EventLogs

All Events (users/persons/projects/observations created or changed etc.) can be found under this section.

Data presentation in the web interface dash

In the web interface dash, the measured vital sign data gets displayed. The different settings and graphic options are described below. The default recording setting is a 3-minute measuring duration in which data points are acquired for a 3-minute time window. Hereafter, the average of the measured data will be presented in the dash data view. The data gets updated in a 15-minute interval. For Example, the default measuring interval can be broken down as follows: One measuring interval is 15 minutes long and consists of a 3-minute default measuring duration and a 12-minute period in which no new data is being measured or updated. Independently of this, a subdivision takes place into 15-minutes chunk intervals, which are used as the basis for the coloring highlighting scheme down below.

New updates

Manually update the devices

Automatically update the devices

Troubleshooting

FAQs → See cosinuss° website / support https://support.cosinuss.com