Coordinates and Utilities

The topics covered in this section include:

Laboratory Coordinates

Every set of (x, y, z) coordinates obtained from a motion capture system is given relative to some coordinate system. Typically, this coordinate system is called the laboratory coordinate system, or simply laboratory coordinates. The laboratory coordinate system is generally an inertial frame fixed to the Earth. Before inputting any coordinates from motion capture into OpenSim, it is your responsibility to ensure that all (x, y, z) coordinates have been transformed from the laboratory coordinate system to the model coordinate system used in OpenSim. Although you can define an arbitrary model coordinate system, the standard convention used in OpenSim is as follows: Assume that the model is a full-body musculoskeletal model of the human body, standing in an upright position on the ground. The origin of the model coordinate system is halfway between its feet. The x-axis of the model coordinate system points forward from the model, the y-axis points upward, and the z-axis points to the right of the model.

If all positions and distances are converted to meters, then all (x, y, z) coordinates can be mapped from the laboratory coordinate system to the model coordinate system by an orthonormal transformation. An orthonormal transformation can be represented by a 3 X 3 rotation matrix whose rows (and columns) are a set of orthogonal vectors of length one,. This matrix represents the orientation of the laboratory coordinate frame in the model coordinate frame. So, to transform the coordinates of a point ^labP = (x, y, z) given in the laboratory coordinate frame to its coordinates ^modelP = (x', y', z') in the model coordinate frame, you would employ the following transformation, where ^model_labR is the matrix whose columns are the vectors of the laboratory coordinate frame specified in the model coordinate frame:
^modelP = ^model_labR * ^labP

External forces and moments are usually given in the coordinate system of a particular force sensor, such as a force plate, which may be different than the laboratory coordinate system. In this case, the force and moment data must be transformed from the appropriate force sensor's coordinate system to the model coordinate system.

OpenSim Utilities

Example Matlab scripts for converting certain specific types of motion capture data into a form recognized by OpenSim are provided in the OpenSim Utilities project on Simtk.org (https://simtk.org/home/opensim-utils). We provide these utilities as examples that have been applied successfully to data sets from the Center for Gait and Motion Analysis at Gillette Children's Specialty Healthcare in St. Paul, MN, USA, and the Human Performance Laboratory at Stanford University in Stanford, CA, USA. However, it is difficult to anticipate lab-specific formats and conventions, so it is your responsibility to adapt these examples to the needs of your individual laboratories and motion capture systems.