Use Apple Watch’s movement disorder manager to monitor symptoms.
- Core Motion
Doctors and researchers can monitor the symptoms of movement disorders continuously using Apple Watch. The
CMMovement class provides a power-efficient approach to measuring and recording tremors and dyskinetic symptoms for Parkinson’s disease.
When you start monitoring the user, Apple Watch begins to gather motion data. To preserve battery life, the manager doesn’t perform calculations in real time. Instead, it periodically and opportunistically analyzes the raw data, saving the results on the user’s device. To preserve disk space, the manager only keeps results for seven days. During this time, you can use the manager to query for the results.
When using the
CMMovement, your app should:
Confirm the user’s diagnosis of Parkinson’s disease.
Only report on symptoms diagnosed by a clinician or self-reported by the user.
Remind the user to wear Apple Watch on their most affected arm in order to collect the most useful data.
While Apple does not intend to market movement disorder monitoring as a regulated medical device, depending on how your app uses the API, you may need to meet additional regulatory obligations. Seek the relevant regulatory advice as needed for your app.
To monitor Parkinson’s tremors or dyskinetic symptoms from a watchOS app:
Provide a motion usage description in your WatchKit extension’s
Ensure that movement disorder monitoring is available on the current device.
Begin monitoring the user.
Query for tremors or dyskinetic symptoms.
Provide the Motion Usage Description
Your watchOS app must provide an NSMotionUsageDescription key with a
String value in the WatchKit extension’s
Info file. The system displays the motion usage description whenever it asks a user for permission to record their data. The description string appears in the Motion and Fitness authorization prompt.
At a minimum, your description must contain the following text: “In addition, this app would like to access your tremor and dyskinetic symptom data. This is only intended for use in those already diagnosed with Parkinson’s disease.”
You can include additional information explaining why the user should grant your app permission, and what your app intends to do with the data after this text.
Monitor and Query for Results
Listing 1 shows how to set up your movement disorder manager, and begin monitoring the user’s symptoms.
After you start monitoring, the manager leverages the
CMSensor to record high-rate accelerometer data passively. When enabled, the
CMSensor records 100 Hz samples. The movement disorder algorithms then periodically and opportunistically use this data to calculate tremors and dyskinetic symptoms.
The results of these calculations are stored on the device for seven days. To access the results, use the manager to query for the desired results, as shown in Listing 2.
To extend the monitoring past the initial expiration date, call the
monitor method again.
Understand the Manager’s Limitations
CMMovement measures resting tremors from Parkinson’s disease in the 3-7 Hz range. It returns metrics about the presence and relative severity of resting tremor as a
CMTremor object. The
CMMovement also computes metrics about choreiform dyskinetic symptoms, measuring the likely presence or absence of dyskinetic symptoms as observed at the wrist where Apple Watch is worn. It returns the results as
CMMovement operates under the following constraints:
The user should wear Apple Watch on the most affected arm.
Employ dyskinetic symptom tracking only for users who have chorea on the affected arm, either self-reported or diagnosed by a clinician.
There are many types of tremors. The movement disorder manager explicitly tracks resting tremor; it does not track action tremor or postural tremor, and it may not track finger tremor.
The manager does not explicitly track dystonia.
The results may include false positives and false negatives. The user's activity, watch band fit, and concomitant conditions (such as restless legs syndrome and non-Parkinsonian tremor) can affect the quality of the results.
The manager only explicitly measures symptoms from the wrist wearing Apple Watch. However, Apple Watch may sense symptoms transmitted through the body from other affected body parts, possibly resulting in misleading or false metrics.