Skip to main content

Range of Motion Active Task Export Format

  • Updated

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.

Table of Contents

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"
}

Was this article helpful?