Skip to main content

Your First Study

In the following sections, we'll guide you through setting up your study in Avicenna, programming Surveys, adding data sources, enrolling participants, and checking the incoming data.

Each of these steps has tons of details to discuss, but we will skip over those. You can check the Reference documentation for a more in-depth look at these topics.

We still may use a term here or there that might be unfamiliar. In this case, please check our Terminology to find out what they mean.

Create Your First Study

After creating a Researcher Account, you can navigate to My Studies located on the Researcher Dashboard. There you will see the Create Study button. Click on it to create your first study.

Creating a new study in Avicenna - First Page

You will be asked a few questions regarding your study. Start by picking a name for the study, for example, My Health Pal. Then enter the name of your organization, for example, Avicenna Research.

Then enter the consent materials you want to be presented to the participants before joining the study. Avicenna asks participants to consent to these before they can register for your study.

Then you can choose what time you expect participants to start their participation, what time their participation is expected to end, and how many days they are expected to be part of the study (Participation Duration). You can read more details in the Participation Period article on how the combination of these values allows you to configure the participation period of your participants.

In this case, we want our participants to start their participation as soon as they join the study, and continue their participation for 14 days. We don't want to have a specific end date for our enrollment either. So leave the Participation Start Time and Participation End Time blank, and set the Participation Duration to 14 days.

When done, click on Start to create your study:

Review Study Settings before creating your study

When your study is created you will be taken to your study's Basics page. Here you can modify the values you entered above, add your colleagues to the study, or other basic configurations.

Basics page of the study

Add Data Sources

Your study likely will collect survey responses, sensor data, and other components. We discuss these in the following pages. For now, let's add a few data sources to our study.

For this example, we want to collect GPS and pedometer data. So click on the Data Sources on the left panel, and then click on Add New Data Source:

Add a new data source to your study

In the list, find GPS and click on it. On the next page, specify whether providing this data is mandatory for your participants, or they can opt out as well:

New data source Settings

You can also enter a name and a description to be shown to the participants.

Follow the same steps to add a Pedometer as well. When done, your list of data sources should look like the following. Note that by clicking on the three dots you can edit and remove the selected data sources, and go to the Data Export page.

The Final list of data sources for your study

Enroll Participants

Now you are ready to enroll participants in your new study. You can read about different ways to enroll participants in the Enrollment section. Here we send the study URL to the new participants.

To begin enrolling your participants, click on the Invite Participants and select the Copy Registration URL. The URL for our study is (yours will be different):

Below, we pretend to be a participant who uses an Android device. Note that similar steps are true if a participant uses Avicenna for iOS or Avicenna for Web.

As a participant, I receive the study Registration URL, and open it on my phone's browser:

Participate in the study

If the participant does not have the Avicenna app installed, clicking on Participate will take them to the Google Play Store app and asks them to install the Avicenna app:

Avicenna app in the Google Play Store

When the participant installs the app and opens it, Avicenna asks them to either login or sign up to join in your study:

Welcome to the Avicenna page

After the sign-up and going through the introduction pages, the participant will see the study registration page in the app. This page shows different information about your study, such as name and organization, participation duration, and consent materials.

Register in the study

Clicking on Register will enroll the participant in the study to start their participation:

Avicenna participant app

The top banner on the homepage of the app asks the participants to perform some additional steps to complete their enrollment. These steps depend on your study settings. As here we wanted to collect GPS and Pedometer, the steps ask participants to grant permissions for GPS and pedometer data collection, as well as adjusting the phone battery settings to allow Avicenna to run in the background.

Disable battery optimizationGrant GPS permission

After completing these additional steps, the participant can close the app. The app continuously runs in the background, collects the data as instructed by the study, and uploads it to your researcher dashboard. You can check back after some time to see the received data.