Articles in this section

See more

Reaction Time Active Task Export Format

  • Updated
Follow

The Reaction Time Active Task is based on the ResearchKit Reaction Time task.

When your project uses the CSV export format for Survey Results, data for Active Tasks is exported in the file SurveyReactionTimeResults.csv. When your project uses the JSON export format, Active Task data is included in the file SurveyResults.json.

For a typical survey using this task, you'll expect to see:

  • One survey result each time the participant completes the survey.
  • One reaction time result for each reaction prompt, totally up to 3 per assessment.
Field Description
SurveyReactionTimeResultKey

A unique, auto-generated observation ID for a single reaction time attempt.
SurveyStepResultKey A unique, auto-generated key for this step result. Can be used to cross reference with other survey results.
SurveyResultKey The key for the survey result which this step result is contained in. Can be used to cross reference with other survey results.
ParticipantIdentifier The identifier of the participant this task was for. Can be used to cross reference with Participants.
ReactionTime

Time elapsed between the stimulus appearing on screen and the participant shaking the device.

[Note: This value is zero if the device is not shaken before the timeout after the stimulus appears.]
StartDate The timestamp for when the participant started the test, in ISO 8601 format. Includes timezone offset information.
EndDate The timestamp for when the participant completed the test, in ISO 8601 format. Includes timezone offset information.

 

Sample CSV Export

SurveyReactionTimeResultKey,SurveyStepResultKey,SurveyResultKey,ParticipantIdentifier,ReactionTime,StartDate,EndDate
34fd9b8c-0881-eb11-88a8-001c426fd18d,28fd9b8c-0881-eb11-88a8-001c426fd18d,1ffd9b8c-0881-eb11-88a8-001c426fd18d,123ac,555.78632487499999,2021-03-09T13:51:49-05:00,2021-03-09T13:51:49-05:00
35fd9b8c-0881-eb11-88a8-001c426fd18d,28fd9b8c-0881-eb11-88a8-001c426fd18d,1ffd9b8c-0881-eb11-88a8-001c426fd18d,123ac,563.35303295833342,2021-03-09T13:51:56-05:00,2021-03-09T13:51:56-05:00
36fd9b8c-0881-eb11-88a8-001c426fd18d,28fd9b8c-0881-eb11-88a8-001c426fd18d,1ffd9b8c-0881-eb11-88a8-001c426fd18d,123ac,574.53156912500003,2021-03-09T13:52:08-05:00,2021-03-09T13:52:08-05:00

Sample JSON Export

Note that since the JSON export is included in the SurveyResults.json file, some of the reference keys either do not apply, or are part of the overall survey step data.

{"SurveyResultKey":"1ffd9b8c-0881-eb11-88a8-001c426fd18d","SurveyKey":"615f7d37-0281-eb11-88a8-001c426fd18d","SurveyName":"reactiontime","ParticipantIdentifier":"123ac","SurveyTaskKey":"40713765-0781-eb11-88a8-001c426fd18d","Type":"Survey","SurveyVersion":0,"StartDate":"2021-03-09T13:51:35-05:00","EndDate":"2021-03-09T13:52:11-05:00","DevicePlatform":"iOS","DeviceName":"iPhone8,4","DeviceOSVersion":"14.3","InsertedDate":"2021-03-09T18:52:12Z","StepResults":[{"SurveyStepResultKey":"26fd9b8c-0881-eb11-88a8-001c426fd18d","StepIdentifier":"instruction","StartDate":"2021-03-09T13:51:35-05:00","EndDate":"2021-03-09T13:51:38-05:00","Results":[]},{"SurveyStepResultKey":"27fd9b8c-0881-eb11-88a8-001c426fd18d","StepIdentifier":"instruction1","StartDate":"2021-03-09T13:51:38-05:00","EndDate":"2021-03-09T13:51:44-05:00","Results":[]},{"SurveyStepResultKey":"28fd9b8c-0881-eb11-88a8-001c426fd18d","StepIdentifier":"reactionTime","StartDate":"2021-03-09T13:51:44-05:00","EndDate":"2021-03-09T13:52:08-05:00","Results":[{"Type":"ReactionTimeResult","SurveyReactionTimeResultKey":"34fd9b8c-0881-eb11-88a8-001c426fd18d",
"ReactionTime":555.78632487499999,
"StartDate":"2021-03-09T13:51:49-05:00",
"EndDate":"2021-03-09T13:51:49-05:00"}
},
"ReactionTime":563.35303295833342,
"StartDate":"2021-03-09T13:51:56-05:00",
"EndDate":"2021-03-09T13:51:56-05:00"
},
{
"ReactionTime":574.53156912500003,
"StartDate":"2021-03-09T13:52:08-05:00",
"EndDate":"2021-03-09T13:52:08-05:00"
}

Related articles