Annotating your logged recordings with button events

Overview

Whether configured for streaming or logging, your Opals will record all movement data to its internal storage when it is undocked an powered on. These logged recordings can be converted to HDF format (the same format used when streaming) at a later time using the "Logged Data Conversion Manager" in our Motion Studio software. See the Motion Studio User Guide for more details about using the "Logged Data Conversion Manager".

It is possible to annotate these logged recordings using the buttons on your Opals. These annotations are then added to the HDF file that is generated. Each annotated event consists of a word or phrase along with an associated timestamp of when the button was pressed and the ID of the Opal whose button was pressed.

Configuring the buttons for annotating your logged recording

In the Motion Studio configuration dialog, navigate to the "Sensors" tab. This enables you to configure the word or phrase that will be logged along with the time of the corresponding button press. For example, you may want button #1 to log "Took medication W at time X" and button #2 to log "Experienced symptom Y at time Z". If more than 2 unique words or phrases are needed, you can assign annotations to multiple Opals.

Putting your Opal into event annotation mode

When you opal is undocked and powered on, hold button #1 for 3s to enter the event annotation mode. When in this mode, the word "Event" will appear at the top of the display. The word or phrase you specified for button #1 will appear directly to the left of the button. Similar for button #2. When you press one of the buttons when in the event annotation mode, you will see a check icon appear in the middle of the display to confirm the logging of the event.

Viewing the annotations

During conversion from the logged data format to HDF format using the "Logged Data Conversion Manager", button presses are added to the Annotations data group off of the root of the HDF data structure. You can find more information about how to work with APDM's HDF format in the Technical Guide.

Segmenting Logged Recordings Based on Button Events

You can use the button events to segment your logged recordings. For example, you may want one button to indicate the beginning of period of the logged recording that you wish to extract, and to use the other button to indicate the end of this period. To use these button events, first click on the logged recordings that you wish to convert. Next, click on the "Custom Start Time" or "Custom End Time" options, followed by clicking on the "Marker" button. This will bring up a table of detected button events from any of the selected recordings. Only events that are within the overlapping period of all selected logged recordings will be presented. You can choose button events from these lists to use to crop the start and/or end times of your recordings.

 

Have more questions? Submit a request

0 Comments

Article is closed for comments.