Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleLine Chart Question Type Configuration

In the CMS, the options for the LineChart appear as shown below.

The first option is to select a Question in the Study. The requirement for the LineChart is that the Responses from the Question have numeric values. If they do not, the Line Chart will show an empty graph.

Valid Question Types for showing Line Charts data: Radio with numerical Values, Dropdown with numerical Values, Slider, Continuous Slider, BT iCO Breath Sample

Note

Question Types that are not for Line Charts: Checkbox, Text Field, Text Area

The default Line Chart for a Question uses all Responses for the Question over the course of the entire Study.

Other options are as follows:

Show Axis Labels - This is an Enable / Disable slider. Data Labels will be visible along the Y-axis at fixed increments.

Y-Axis Increment Label - A typed-in element of units (such as “Drinks“ or “ppm“) will be added to the Y-axis increments if “Show Axis Labels“ is enabled. Does not show if “show Axis Labels“ is Disabled.

Show Threshold - sets a second line on the graph at a fixed Y-value. Displays the graph data value overlaid the Threshold value. If the Threshold is significantly higher than the highest point of Data, the graph is stretched vertically to show both the data and the Threshold.

Threshold Value - If “Show Threshold“ is Enabled, this is a number input for the Threshold Value to be rendered against the data values from the selected Question.

Show Cumulative Sum - The Linear Chart is able to show a linear sum of Question Data over multiple days, as opposed to showing a linear plot of data. Each Response value is summed with the previous data point value, starting with just the first point and ending with the Response value from the last Response.

Number of Days - Line Charts can designate a number of days to use instead of all Responses over the course of the Study. Inputting a positive number of Days, the displayed Cumulative Sum Line Chart will show the Response Data for the last number of allocated Days. Leaving the Number of Days blank will show all of the Responses over the course of the Study.

Single Line Chart
Visible Axis labels
Data collected > 30 days
Y-Axis Label → Ppm

Line Chart w/ Threshold line
No Axis label
Data collected > 30 days

Cumulative Sum Line Chart
Visible Axis labels
Y-Axis → test

Cumulative Sum Line Chart with Threshold Line
No Axis label

...

Note

Type in the formula for branching logic instead of copying and pasting formulas.

Copying and Pasting formulas have the potential to carry over hidden characters or HTML tags that are not seen in web browsers.

Info

If it is a Rich Text question type the question text will be limited to displaying 50 characters.

Expand
titleExamples: Branching Logic

How to use the last response to a question or a previous survey to direct the current survey

Single Value Field (Dropdown, Radio, Slider, etc)

formula example:

The Last Response option is used to pull a participant’s last response to a particular question. This enables researchers to use data from previous surveys to inform algorithms and formulas. See example below.

The example below referencing question “sex” there are two (2) values being shown: 0 = Female, 1 = Male. In this case, the participant has answered this question multiple times. Using the formula “last([sex])” will pull the last response which is one (1) in this case.

Code Block
last([sex])
Info

Variable: sex

values: [0 = Female, 1 = Male]

Multi Value Field (checkbox)

Info

Not currently supported for last(), will currently match on any prior matching values

How to only show a question if previous response is a given value

Instructions:

Click the Assessment tab, select desired assessment, then open the question that needs to be shown or hidden based upon data from a previous survey. In the “Formula” area, add the desired logic, examples are below.

Single Value Field (Dropdown, Radio, Slider, etc)

formula example:
Code Block
[variablename] == 1
Info

values: [1,3,2]

result: 1

The question will only be asked if the response to this prior question = 1.

Multi Value Field (Checkbox)

formula example:
Code Block
[variablename(2)] == 1
Info

Check all that apply:

Dog = 1

Cat = 2

Frog = 3

When the second option is closer, this question will be asked

...

Expand
titleAndroid Wear Set Up
Note

Follow the Android Wear instructions in the order listed on this page. Doing any of these steps out of order may result in data being skewed or other set up errors!

Note

To download the necessary apps from the Google Play Store and to continue to get updates, a participant must have a Google account (participant can use any email to sign up for a Google account). We recommend that participants use their own account. Do not delete the Google account. Insight (or any app) cannot update without a Google account active on the phone.

Info

Note: Connect to Wi-Fi

1. Download Wear OS from the Google Play Store

  • Choose the Google Play Store app from the participant’s phone

  • Search Wear OS by Google

  • Choose INSTALL


2. Connect Wear OS Watch to Phone

This section will require both the watch and the phone.

Status
colourPurple
titleWear os Setup

  1. Tap on the watch screen when it says Tap to begin

  2. Select English (United States) as your language

  3. Press the check mark to agree to the Terms of Use

  4. The watch will then prompt you to open the Wear OS app on your phone. Scroll down and you’ll see the watch name. Take note of the watch name as you’ll use this as a reference to it later during the phone setup.

Status
colourPurple
titlephone setup

  1. Press Start Setup

  2. Press Agree for Terms of Service

  3. Press Agree for Make Wear OS better

  4. The phone will then attempt to link with your watch. Turn on Bluetooth if the phone prompts you to turn it on.

  5. Match the watch name seen on the watch with the watch name on the phone and click on it.

  1. A pass key will appear on the watch. Make sure it matches the one on your phone and press

OK to pair the phone with the watch.

  1. Under Choose which Google Accounts to copy to your watch, make sure the slider is on (slider will be blue if it’s set to on) next to the participant’s google account. Click on Next

  1. Press Copy to copy the google account to the watch

  1. Under Stay connected to Wi-Fi, press Connect

10. Press Next under Chat with your friends

11. Press Allow for all 4 of the permissions.

12. Under Check your calendar, press Next and press Allow for the calendar permission

13. Under Get notifications at a glance, press Allow

14. Tap on the slider next to Wear OS by Google (it’ll turn blue)

15. Press Allow on the Allow Wear OS by Google pop up

16. Press Next under Location notice

17. The phone will then continue to set up on its own (may take up to 5 minutes).

18. Once you see the You’re all set screen, press Done

3. Sign in to Google Fit on the Watch

  • Swipe from right to left on the watch

  • Tap the screen to sign in to Google Fit and use the Google account that you copied over to the watch

  • Fill in all the details and accept all the permissions

Note

At this point, the watch should be paired with the phone. A good way to know is to try and change the watch face by going into the Wear OS app on the phone and picking a different face. The face change should get reflected in the watch too.

4. Download Insight from the Google Play Store

  • Choose the Google Play Store app from the participant’s phone

  • Search for Insight mHealth Platform

  • Choose Install

  • After the app downloads, choose ACCEPT

  • Open the Insight app

  • Click Allow to all permissions

  • At the “Do not optimize battery usage” prompt, choose YES

  • Create a participant in the CMS and set up the participant on the Insight app. Click here for instructions on participant set up.

Info

We recommend using the Code Method for setting up participants.

Note

After you setup a participant on the Insight app, please wait for 15-20 minutes for all the setup to finish. If you start setting up participant on the Outsight app too soon, the connection might not be created correctly.

5. Download mHealth Outsight from Google Play Store

  • Choose the Google Play Store app from the participant’s phone

  • Search mHealth Outsight

Info

If the mHealth Outsight app does not pull up in the search result, use the following link on the phones’s Google Chrome browser and press Open in app when it prompts you: https://play.google.com/store/apps/details?id=com.mhealth.corehardware

  • Click on Install

  • Click on Open to open the Outsight app

  • Press Allow on all the permissions

6. Download mHealth OutsightAndroidWear app on the Fossil Watch

  • On the Fossil watch, press the middle dial to open up the watch’s list of apps.

  • Click on Play Store

  • Scroll down until you see Outsight under Apps on your phone and click on the download button

  • Open OutsightAndroidWear in your list of apps, and accept the sensor permission

Note: The Fossil Watch will need to update it’s Play Store. Ensure that there is a good Wi-Fi connection and allow it to update while the watch is charging. This process may take 5-15 minutes. Typically, OutsightAndroidWear will automatically download to it. If it does not, a search through the watch’s Play Store as described above will work.

Troubleshooting

  1. Ensure WEAR OS, Insight, and Outsight remain open and running in the background.

    1. If the app is open, Click the “Home” button (typically located at the bottom, center of the phone) to allow the app to run in the background. Example of a Recent window below:

      Galaxy S7 Recent Window Displays Insight and Wear OS
    2. Note: If the app(s) are not displayed in the “Recent” window then the app(s) are closed; this prevents any background operations which hinder collecting sensor data.

  2. Verify there is a connection between the smartwatch and phone.

    1. Open the WEAR OS app on the phone → under the watch name “connected” will appear if the phone and watch are paired.

      1. If WEAR OS signifies there is no connection, reestablish the connection by hitting reconnect

  3. If there appears to be no connection, open Outsight and Insight on the phone.

    1. This can reestablish a connection between Outsight to Insight to allow sensor readings.

  4. Restart the phone and watch if the above methods do not produce the expected results.

    1. Restarting Phone: hold down the power button (typically on the side of the phone) until Restart Phone appears → Click Restart Phone

    2. Restarting Watch: hold down the large middle dial on the side until Restart appears → Click Restart

  5. Attempt to pair multiple phones and watches while thoroughly reading the instructions (starting from 1. Download Wear OS) to gain more experience; doing this can reduce quantity of errors when pairing the phone and watch.

Supported Devices:

  • Fossil Smartwatch 5th Generation

...

Expand
titleCreating a Sensor Event
  1. Create a new Event and set the Schedule Type to “Sensor Data“

    • Sensor Data can be scheduled to start at a specific time or any of the time offset (e.g., before sleep time)

  2. Add a Setting ('+') to the “Sensor Data“ Event, also called “Sensor Data”

    1. Device: “Android Wear”

    2. Choose a Sensor Type

      1. Pedometer

      2. HeartRate

      3. Accelerometer

    3. Repeat Count and Sensor Read Frequency (milliseconds)

      • These values are tied with the Schedule Type/Time to schedule the start of sensor data collection and set how long the delay between readings should be, and how many times the readings should repeat (a repeat of 0 means there will be 1 reading, a repeat of 1 means 2 readings, …).

      • “Repeat Count“ is the number of times per day that this Sensor Event will trigger. The time increment between Sensor Events = T / 1440 (There are 1440 minutes in a day), where T is the value of the “Repeat Count“ field. T = 480 means that the Sensor Event triggers every 3 minutes for the entire 24 hour day.

      • Frequency is the length of time between Sensor Events, in milliseconds (0.001 sec). Repeat Count is the number of times that the Sensor Data event will trigger during each 24-hour cycle, based on the Select Time which is the start of the first Sensor Event. It is the responsibility of the Study designer to ensure that (Frequency * Repeat Count) total is less than or equal to 1440 minutes, which is 1 calendar day.

      • It is recommended to not have multiple sensors firing at the same time. If you need heart rate and pedometer readings, they should be set at least a minute apart as readings (particularly HR) may take time to complete and requests may be dropped if a service is busy with another reading.

      • There is a max of number of “events”, subdivided by day, that can be scheduled. This is a platform limitation, and may vary by vendor but any study scheduling more than 200 events per day should take caution. There is a convention that will leverage “repeating” sensor events and will allow more data to be collected. However, no assessments can be associated with a repeating sensor event (ie, follow ups).

      • If you wanted sensor readings every 10 minutes all day, you would set:

        1. Schedule Type = Specific Time

        2. Select Time = 12:01am

        3. Repeat Count = 143 ((60 mins * 24 hrs / 10) = 144 -1 for initial offset)

        4. Sensor Read Frequency = 600,000 (milliseconds)

  3. Post-Sensor Reading Logic (cannot be used for “repeating events, see above)

a. If this formula evaluates to true, the Selected Assessments will trigger

  • Events will only trigger if it is during the participant’s waking hours.

b. If left blank or if the formula evaluates to false, the event will passively collect sensor data.

c. This formula is not limited to sensor specific formulas. The usual question based formulas work here as well if you need to reference other data.

  • Refer below for formula options.

Sensor Specific Formulas

  • GetStepsPerMinute(n)

    • Gets the average steps per minute over a given duration

    • Ex: GetStepsPerMinute(30) < 8 would get the average steps per minute from the last 30 minutes and trigger an assessment if that value is less than 8. (less than ~8.33 steps per minute is sedentary)

Using Sensor Data in a Follow Up Event

  • Additionally sensor readings can be generated through a “Follow Up” schedule type. For more information on how to setup Follow Up events, click here. Then start at the Step 2 of Creating a Sensor Event to configure the Sensor Data setting.

...

Expand
titleBluetooth (BT) iCO Sensor Configuration

Creating BT iCO Question Type + Assigning to an Assessment

  1. Create a Question with the Question Type iCO Bluetooth LE

    1. Fill out the associated fields for the question (Field Name, Required, and Description).

    2. Click Save (blue star) once finished inputting information

  2. Add the previously created iCO Bluetooth LE question to an existing assessment or create a new one.

  3. (Optional) Facial Recognition

    1. (Question Tab) If the study has the “Facial Recognition setting enabled, and facial recognition verification is desired, create another question with the Question Type Face Verification

      1. Fill out the associated fields for the question (Field Name, Required, and Description).

    2. (Assessment Tab) If the study has the “Facial Recognition” setting enabled and facial recognition verification is desired for the assessment, add the Face Verification question type to the assessment immediately following the iCO Bluetooth LE question type added in Step 2.

Note

Always click the save button after changes are made to the study. All work will be lost if the save button is not pressed.

How to use the Bluetooth (BT) iCO

Info

Ensure Bluetooth is enabled on the phone. The Bluetooth (BT) iCO will not be able to connect and a chance of the assessment crashing when the Bluetooth setting is disabled.

When a participant reaches the iCO Bluetooth LE type question, the following will transpire:

The Insight app screen prompts the participant to connect the BT iCO device. When this screen is displayed, the participant should press and hold the power button on the iCO device until the LED ring at the base of the device flashes blue. Once the device is properly connected, the app screen shows Begin; the phone is ready for the participant to take the breath test.

Instruct the participant to press the Begin button → the screen will prompt them to hold their breath; a countdown is displayed to the participant. Once Exhale displays on the screen, advise the participant to exhale for the full length of the countdown.

Note

A response value of -998 appears if the iCO could not successfully be connected during the assessment.

Note

A response value of -997 appears if the iCO was unable to capture stable readings from the breath test.

Info

While using the iCOquit® device in an assessment with facial recognition, the participant should be informed by the research staff to hold the phone in a manner consistent with taking a selfie while completing the assessment. This will ensure the photos taken during the assessment are useful for face verification.

Branching Logic

Branching logic is added under the Assessments tab; open the desired assessment then select Edit Formula for a question which will be conditionally presented to the participant.

Fill out the desired logic in the formula editor to determine whether the question will be presented.

For example, a basic check for results between 0 through 20 carbon monoxide concentration parts per million would look like this: [iCOBT] >= 0 and [iCOBT] < 500, where iCOBT is the “Field Name” of the iCO Bluetooth LE question.

Note

Always click the save button after changes are made to the study. All work will be lost if the save button is not pressed.

Info

For Google Pixel Users: If there an issue with timing starting the iCO device relative to starting the iCO BlueTooth question during an Assessment and the device is not able to connect, then after the Assessment is finished, re-starting the Assessment with the iCO BlueTooth question should allow the BlueTooth iCO device to connect.

This will result in an Assessment with a recorded value of -998 when the device failed to connect, and the correct iCO value during the next Assessment.

PHONES THAT HAVE BEEN TESTED WITH BLUETOOTH iCO DEVICES

Device Make and Model

BlueTooth iCO Supported and Tested with Insight app

Samsung Galaxy S5

Yes

Samsung On5

Yes

Samsung Galaxy S7

Yes

Samsung Galaxy S8

Yes

Samsung Galaxy S9

Yes

Samsung Galaxy J3 VYes

Yes3901 Rainbow Blvd, MS 1008, Kansas City, KS 61600

Samsung Galaxy J3 Prime

Yes

Samsung A10s

Yes

Samsung Galaxy Note8

Not Supported

Pocophone F1

Yes

Motorola Moto e5 Play

Not Supported

ASUS Zenphone A 006

Yes

Nokia 8.3 5G

Yes

LG K40

Yes

LG Stylo 5

Not Supported

Google Pixel 3a

Yes - see note above

Blu Pure View

Not Supported

...

Below is an EMA Pivoted Report Data Dictionary:

Column Name

Description

1

ParticipantId

Database Id of the participant in study.

2

CustomId

Id assigned to the study participant by the researchers.

Image Modified
3

ParticipantStatus

Status of the participant (one of Active, Completed, Test, Archived)

Image Modified
4

StageNumber

Database Id of the stage associated with the entry in the report.

5

StageName

Name given to the stage during study setup.

Image Modified
6

ScheduleID

Database Id of the Schedule/Event within the stage.

7

ScheduleType

Type of schedule (one of Fixed, Random, ParticipantInitiated, FollowUp, Phone Call, Sensor Data, GPS Tracking, Call Monitoring). Please note that not all of the schedule type maybe available for a given study.

8

ScheduleName

Name of the schedule/event.

Image Modified
9

ScheduledEventId

Database Id of the specific event (the schedule taking scheduled for a particular participant on a particular time).

10

FirstDate

Date when this participant started in the study (first day of the first stage).

11

LocalTimeOffsetInMinutes

Information about participant’s timezone (if the LocalOffsetInMinutes is -300 it implies that the participant is in (-300/60 = -5 Hrs from UTC).

12

ScheduledTimestamp

Date and Time at which the event was scheduled for.

13

ScheduledUTCTimestamp

Same as ScheduledTimestamp but in Coordinated Universal Time (UTC).

14

WeeksInStudy

Number of weeks in the study as of the time of the assessment.

15

ScheduledDay

Number of days in the study as of the time of the assessment.

16

ScheduledTime

Date and time at which the assessment was scheduled.

17

ScheduledTimeDecimal

Time of the day represented as decimal (14.25 hrs = 2 PM and 15 Minutes).

18

NotificationTimestamp

When was the notification sent out for the assessment.

19

NotificationUTCTimestamp

The notification in UTC time.

20

NotificationDay

Days since the participant started in the study and when the participant was notified.

21

NotificationTime

Time of notification.

22

NotificationTimeDecimal

Time in decimal format.

23

StartTimestamp

Date and Time when the assessment started.

24

StartTimeUTCTimestamp

Date and Time in UTC timezone.

25

StartDay

Number of days between when the participant started the study and when this assessment was started.

26

StartTime

Time when the assessment started.

27

StartTimeDecimal

Time in decimal format.

28

CompletedTimestamp

Date and Time when the assessment was completed.

29

CompletedUTCTimestamp

Date and Time when the assessment was completed in UTC timezone.

30

CompletedDay

Days between when the participant started the study and when the assessment was complete.

31

CompletedTime

Time of the day when the assessment was completed.

32

CompletedTimeDecimal

Time of the day when the assessment completed in represented as a decimal.

33

LastInteractionTimestamp

The last interaction of the participant with any question in the assessment in the participant’s timezone.

34

LastInteractionUTCTimestamp

The last interaction of the participant with any question in the assessment in UTC timezone.

35

LastInteractionDay

Days between when the participant started the study and when participant last interacted with the assessment.

36

LastInteractionTime

Time of day when the last interaction happened.

37

LastInteractionTimeDecimal

Time in decimal format.

38

TotalSnoozeMinutes

Total number of minutes an assessment was snoozed.

39

SnoozeCounter

Total number of times an assessment was snoozed.

40

Latitude

Latitude when the assessment was attempted by the participant.

41

Longitude

Longitude when the assessment was attempted by the participant.

42

GPSAccuracy

Estimated GPS accuracy in meters.

Info

Any columns that follow the GPSAccuracy column are names of questions and their responses associated with that assessment.

...

iii. Greenphire Participant – type in the 8 digit Greenphire Master Card number on the card that is given to this participant.

iv. Rich Text Setting – 

v. Pedometer Goals  – Participant specific goals; if the setting is present at the question and participant level, the participant level setting will take precedence. More information about Pedometer Configuration here.

...