Study Participants¶

The study participant management has its own Study application icon in the left-hand menu bar as displayed below:

Overview¶

This section covers the assignment and monitoring of participant data in clinical studies:

• How to use the participants list
• How to use the source devices list
• Register a new participant
• Assign a device to a participant
• End a device-to-participant assignment
• Edit a device-to-participant assignment
• How to visualize participant data
• How to visualize device data
• How to use the participant overview dashboard

Participants List¶

The participants list is located in the Study application and allows you to perform the following actions:

1. Add a new participant by registering its participand ID
2. Search for participants using the search field
3. Sort participants according to their state (Active = ongoing device assignment, Inactive = no ongoing device assignment)
4. Change the number of participants displayed per page
5. Check the time and date of the last available data for a participant
6. Open the detail view for a participant to assign a device or edit a device assignment
7. Copy the participant ID
8. Open the data dashboard to visualize all gathered data for a participant

Source Devices List¶

The source devices list is located in the Study application allows you to perform the following actions:

1. Search for a source device based on the device name or device ID
2. Change the number of devices displayed per page
3. Check for the currently assigned participant ID
4. Check the time and date of the last available data for a source device
5. Check the battery status of the device. By hovering over the battery icon, you see additional information about the charging state.
6. Open the device state view in the Data application
7. Copy the device UUID
8. Open the data dashboard to visualize all gathered data for a source device

Register a new participant¶

Go to the Participants list and click the button Add Participant.

Enter the participant ID in the field PID and click the save button. If the participant ID does already exist, you will get the error "Participant with ID xy already exists" and need to choose a different ID.

After saving, you will directly see the Device Assignment tab in the participant detail view and can proceed with the next step below to assign the new device to a participant.

Assign a device to a participant¶

To open the Device Assignment tab for a participant, go to the Participants list and open the detail view of a participant by directly clicking on the row in the list or on the information button in the Actions column.

Click the button Add Device Assignment

Fill in the device assignment form as displayed below:

1. Choose the Start Time of the assignment. You can leave the End Time field either free to define it later or already define it now for any time in the future.
2. You can search for a device name or device ID in the list of available devices.
3. Check the battery status to ensure a device is ready to be assigned. By hovering over the battery symbol you get more information about its charging state.
4. Click the checkbox for the device you want to assign. The chosen device is marked by a green checkmark.
5. Click the Save button.

End a device assignment¶

There are two ways to end a device assignment:

1. First option is to click the End Now button for the assignment you want to end in the participant detail view. A dialogue box will pop up, in which you need to confirm your choice.
   
2. Second option is to edit a device assignment by adding or changing the End Time.

Edit a device assignment¶

You can edit a device assignment by clicking directly on the corresponding row in the Device Assignment tab of the participant's detail view or by clicking on the information button at the end of that same row:

In the edit assignment form, you have the following options:

1. Change Start Time and/or End Time of the assignment
2. Swap the device to a different one that is available within the defined time
3. Delete the assignment

Visualize participant data¶

To open the data dashboard for a participant, click on the Open Data Dashboard button in the Participants list.

This opens a new tab in your browser with the participant dashboard, which allows you to perform the following actions:

1. The time range can be selected in the top right corner. If you choose a long time range, it can take a while for the graph to load.
2. The participant_id can be selected from the dropdown to show the data of a different participant.
3. The interval controls the time resolution of the graph. Reduce it to display all the data-points but be aware, that this will increase the loading time accordingly. It is therefore recommended to first reduce the displayed time range.
4. You can zoom into the graph by selecting a range in the graph while holding down the left mouse button, and zoom out again using the magnifying lens icon in the top right corner.

Participant overview dashboard¶

To monitor the data availability from all registered participants in your study, you can navigate to the overview dashboard as follows:

1. Click on the Dashboards button in the navigation bar on the left side of the screen.
2. Click on Participant Overview in the list of available dashboards.

On the Participant Overview dashboard, you get a filterable overview of all registered participants in your study:

1. Choose the time range for which you want to display study participants.
2. Choose true to filter for active participants (=ongoing device assignment), false for inactive participants or all for all participants in the chosen time range.
3. Each column can be sorted by clicking on the blue column title.
4. Click on a participant ID to visualize the participant's data.

Visualize device data¶

To open the data dashboard for a device, click the Open Data Dashboard button in the Source Devices list.

This opens a new tab in your browser with the device dashboard, which allows you to perform the following actions:

1. The time range can be selected in the top right corner. If you choose a long time range, it can take a while for the graph to load.
2. The device_id can be selected from the dropdown to show the data of a different device. Devices are identified with their UUID. If you do not know the UUID of the device you want, then the fastest way is to go back to the Source Devices list and use the Open Data Dashboard button for the other device.
3. The interval controls the time resolution of the graph. Reduce it to display all the data-points but be aware, that this will increase the loading time accordingly. It is therefore recommended to first reduce the displayed time range.
4. You can zoom into the graph by selecting a range in the graph while holding down the left mouse button, and zoom out again using the magnifying lens icon in the top right corner.