Range of Motion Active Task Export Format
The Range of Motion Active Task is based on the ResearchKit Range of Motion task. The Range of Motion task can be configured for either the knee (left or right) or shoulder (left or right).
When your project uses the CSV export format for Survey Results, data for Active Tasks is exported in the file SurveyRangeOfMotionResults.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 Range of Motion result for each administration.
Data Fields
| Field | Description |
|---|---|
SurveyRangeOfMotionResultKey |
A unique, auto-generated observation ID for a single range of motion 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. |
Extended |
The degrees when extended. |
Flexed |
The degrees when bent. |
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
SurveyRangeOfMotionResultKey,SurveyStepResultKey,SurveyResultKey,ParticipantIdentifier,Extended,Flexed,StartDate,EndDate
aff37890-c285-eb11-88a8-001c426fd18d,9df37890-c285-eb11-88a8-001c426fd18d,91f37890-c285-eb11-88a8-001c426fd18d,123ac,139.38720151482508,7.1772059328310434,2021-03-15T15:13:52-04:00,2021-03-15T15:13:52-04:00
Sample JSON Export
{"SurveyResultKey":"cc2799d9-c185-eb11-88a8-001c426fd18d","SurveyKey":"63eb3308-c085-eb11-88a8-001c426fd18d","SurveyName":"knee","ParticipantIdentifier":"123ac","SurveyTaskKey":"4b1bd767-c085-eb11-88a8-001c426fd18d","Type":"Survey","SurveyVersion":0,"StartDate":"2021-03-15T15:07:45-04:00","EndDate":"2021-03-15T15:08:48-04:00","DevicePlatform":"iOS","DeviceName":"iPhone8,4","DeviceOSVersion":"14.3","InsertedDate":"2021-03-15T19:08:48Z","StepResults":[{"SurveyStepResultKey":"d32799d9-c185-eb11-88a8-001c426fd18d","StepIdentifier":"instruction","StartDate":"2021-03-15T15:07:45-04:00","EndDate":"2021-03-15T15:07:47-04:00","Results":[]},{"SurveyStepResultKey":"d42799d9-c185-eb11-88a8-001c426fd18d","StepIdentifier":"instruction1","StartDate":"2021-03-15T15:07:47-04:00","EndDate":"2021-03-15T15:08:07-04:00","Results":[]},{"SurveyStepResultKey":"d52799d9-c185-eb11-88a8-001c426fd18d","StepIdentifier":"instruction2","StartDate":"2021-03-15T15:08:07-04:00","EndDate":"2021-03-15T15:08:14-04:00","Results":[]},{"SurveyStepResultKey":"d62799d9-c185-eb11-88a8-001c426fd18d","StepIdentifier":"instruction3","StartDate":"2021-03-15T15:08:14-04:00","EndDate":"2021-03-15T15:08:29-04:00","Results":[]},{"SurveyStepResultKey":"d72799d9-c185-eb11-88a8-001c426fd18d","StepIdentifier":"touch.anywhere","StartDate":"2021-03-15T15:08:29-04:00","EndDate":"2021-03-15T15:08:39-04:00","Results":[]},{"SurveyStepResultKey":"d82799d9-c185-eb11-88a8-001c426fd18d","StepIdentifier":"knee.range.of.motion","StartDate":"2021-03-15T15:08:40-04:00","EndDate":"2021-03-15T15:08:44-04:00","Results":[{"Type":"RangeOfMotionResult","SurveyRangeOfMotionResultKey":"ea2799d9-c185-eb11-88a8-001c426fd18d",
"Extended":172.90661687264426,
"Flexed":173.82716356112269,
"StartDate":"2021-03-15T15:08:44-04:00",
"EndDate":"2021-03-15T15:08:44-04:00"
}