Preview Sensor Data

Sensor data can be previewed in OpenSim to verify that preprocessing was done correctly and that data is in agreement with the intended model. In some cases, you can also use OpenSim's feature for Associating Data with a Motion. For example, if you've already run IK and you want to visualize sensor data or ground reaction forces in sync with the inverse kinematics trial you should use the Associate Data motion feature.

If you have multiple files representing different pieces of data, this tool allows you to verify that the data was transformed consistently. Since the goal is to ensure that the data is consistent with an OpenSim model for further analysis, this module handles data files in the format accepted by OpenSim tools. The sensor data need to be represented as (.sto) file containing Quaternions. Each Quaternion is represented as a triad in the 3D window.

The preview functionality is accessible through the menu File→Preview Sensor Data...

Upon selecting this option, the user is prompted to browse for the .sto file containing quaternion data, an example file is provided within the OpenSense example files.

Since sensor orientation data typically do not have "translation/position" information, the user is prompted to choose a placement to position the triads corresponding to the quaternions from the data file in the 3D window. The following figure shows the dialog and the corresponding options to customize sensor data visualization.

Layout Options:

  • At Origin: All triads are overlaid at the origin (overlapping).
  • Evenly Spaced along X/Y/Z: The triads are spread out in a straight line along the corresponding axis
  • Half Circle in Y-Z Plane: The triads are evenly placed along the perimeter of a half-circle in the vertical Y-Z plane
  • Place at matching segments on current model: This is likely the most useful layout if you have a model with segments that match (based on name) the sensors in the data file. The current model is used to provide the translation/placement of the corresponding triads.

The dialog also allows for applying Rotations around X, Y, and/or Z to help users decide the transform between sensor data frame and OpenSim frame.

Once loaded, the sensor data "motion" is treated uniformly as other motions in the OpenSim application, in that it can be animated using the motion slider and/or synchronized with other motions if desired. 


OpenSim is supported by the Mobilize Center , an NIH Biomedical Technology Resource Center (grant P41 EB027060); the Restore Center , an NIH-funded Medical Rehabilitation Research Resource Network Center (grant P2C HD101913); and the Wu Tsai Human Performance Alliance through the Joe and Clara Tsai Foundation. See the People page for a list of the many people who have contributed to the OpenSim project over the years. ©2010-2024 OpenSim. All rights reserved.