Annotating your logged recordings with button events


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 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 from when the button was pressed and the ID of the Opal whose button was pressed.

Configuring the buttons for annotating your logged recording

Note: If you are using Mobility Lab or Moveo Explorer, you can access Motion Studio functionality by clicking on View->"Motion Studio View" in the menu bar. You can then return to your standard application interface by clicking on View->"Mobility View".

  • Click on the "Configure" icon in the toolbar to bring up the Motion Studio configuration dialog.
  • In the configuration dialog, navigate to the "Sensors" tab.
    • Use the "Select Sensor" drop down to select the sensor whose buttons you wish to configure.
    • Enter the labels that will be associated with the button presses in the "Button Event Labels" area. 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 "Started task Y at time Z".
    • You can assign annotations to multiple Opals by selecting additional Opals through the "Select Sensor" drop down.

Note: You must click on the "Configure" button to have the changes take effect.

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. These annotations are displayed in the raw data plot views.

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 in the Logged Data Conversion Manager, first select 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


Article is closed for comments.