The Timed Walk Active Task is based on the ResearchKit Timed Walk task. Instead of shaking the device in response to the stimulus, however, the participant simply lifts their finger and taps the stimulus when it appears.
When your project uses the CSV export format for Survey Results, data for Active Tasks is exported in the fileSurveyTimedWalkResults.csv. When your project uses the JSON export format, Active Task data is included in the fileSurveyResults.json.
For a typical survey using this task, you'll expect to see:
- One survey result each time the participant completes the survey.
- One Timed Walk result for each segment of the activity (one for the walk out; one for the walk back).
Table of Contents
Data Fields
| Field | Description |
|---|---|
SurveyTimedWalkResultKey |
A unique, auto-generated observation ID for a single timed walk 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. |
Time Limit |
The time limit to complete the trials. (Set within MyDataHelps Designer.) |
Duration |
The trial duration (that is, the time taken to do the walk). |
DistanceInMeters |
The timed walk distance in meters. |
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
SurveyTimedWalkResultKey,SurveyStepResultKey,SurveyResultKey,ParticipantIdentifier,TimeLimit,Duration,DistanceInMeters,StartDate,EndDate
fe1a740d-0981-eb11-88a8-001c426fd18d,eb1a740d-0981-eb11-88a8-001c426fd18d,e01a740d-0981-eb11-88a8-001c426fd18d,123ac,180,20.429930875,100,2021-03-09T13:55:44-05:00,2021-03-09T13:55:44-05:00
011b740d-0981-eb11-88a8-001c426fd18d,ec1a740d-0981-eb11-88a8-001c426fd18d,e01a740d-0981-eb11-88a8-001c426fd18d,123ac,180,5.9254299579999996,100,2021-03-09T13:55:50-05:00,2021-03-09T13:55:50-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":"e01a740d-0981-eb11-88a8-001c426fd18d","SurveyKey":"0f6d828d-0781-eb11-88a8-001c426fd18d","SurveyName":"timedwalk","ParticipantIdentifier":"123ac","SurveyTaskKey":"c903a59b-0781-eb11-88a8-001c426fd18d","Type":"Survey","SurveyVersion":0,"StartDate":"2021-03-09T13:54:56-05:00","EndDate":"2021-03-09T13:55:53-05:00","DevicePlatform":"iOS","DeviceName":"iPhone8,4","DeviceOSVersion":"14.3","InsertedDate":"2021-03-09T18:55:54Z","StepResults":[{"SurveyStepResultKey":"e71a740d-0981-eb11-88a8-001c426fd18d","StepIdentifier":"instruction","StartDate":"2021-03-09T13:54:56-05:00","EndDate":"2021-03-09T13:55:01-05:00","Results":[]},{"SurveyStepResultKey":"e81a740d-0981-eb11-88a8-001c426fd18d","StepIdentifier":"timed.walk.form","StartDate":"2021-03-09T13:55:01-05:00","EndDate":"2021-03-09T13:55:13-05:00","Results":[{"Type":"QuestionResult","QuestionResultKey":"f61a740d-0981-eb11-88a8-001c426fd18d","ResultIdentifier":"timed.walk.form.afo","Answers":["False"],"StartDate":"2021-03-09T13:55:03-05:00","EndDate":"2021-03-09T13:55:03-05:00"},{"Type":"QuestionResult","QuestionResultKey":"f71a740d-0981-eb11-88a8-001c426fd18d","ResultIdentifier":"timed.walk.form.assistance","Answers":["None"],"StartDate":"2021-03-09T13:55:13-05:00","EndDate":"2021-03-09T13:55:13-05:00"}]},{"SurveyStepResultKey":"e91a740d-0981-eb11-88a8-001c426fd18d","StepIdentifier":"instruction1","StartDate":"2021-03-09T13:55:13-05:00","EndDate":"2021-03-09T13:55:18-05:00","Results":[]},{"SurveyStepResultKey":"ea1a740d-0981-eb11-88a8-001c426fd18d","StepIdentifier":"countdown","StartDate":"2021-03-09T13:55:18-05:00","EndDate":"2021-03-09T13:55:23-05:00","Results":[]},{"SurveyStepResultKey":"eb1a740d-0981-eb11-88a8-001c426fd18d","StepIdentifier":"timed.walk.trial1","StartDate":"2021-03-09T13:55:23-05:00","EndDate":"2021-03-09T13:55:44-05:00","Results":[{"Type":"TimedWalkResult","SurveyTimedWalkResultKey":"fe1a740d-0981-eb11-88a8-001c426fd18d",
"TimeLimit":180.0,
"Duration":20.429930875,
"DistanceInMeters":100.0,
"StartDate":"2021-03-09T13:55:44-05:00",
"EndDate":"2021-03-09T13:55:44-05:00"
},
{
"TimeLimit":180.0,
"Duration":5.9254299579999996,
"DistanceInMeters":100.0,
"StartDate":"2021-03-09T13:55:50-05:00",
"EndDate":"2021-03-09T13:55:50-05:00
}