NEW!  Version 3 of iPi Motion Capture is available. iPi Motion Capture 3 delivers new features for improved workflow including support of Kinect 2, improved arms tracking, simplified calibration and others. Read more >>

This documentation corresponds to version 2 of iPi Motion Capture. The latest documentation for version 3 can be found at https://docs.ipisoft.com/

Biomechanical Analysis

From iPiSoft Wiki
(Difference between revisions)
Jump to: navigation, search
(Introduction)
(Introduction)
Line 17: Line 17:
 
** Linear: Absolute (relative to floor), Relative to parent joint, Relative to center of mass
 
** Linear: Absolute (relative to floor), Relative to parent joint, Relative to center of mass
 
** Angular: Absolute (relative to floor), Relative to parent joint
 
** Angular: Absolute (relative to floor), Relative to parent joint
* Select [http://en.wikipedia.org/wiki/Euler_angles#Conventions Euler angles system]
+
* Select '''[http://en.wikipedia.org/wiki/Euler_angles#Conventions Euler angles system]'''
 
* '''Plot''' values of selected metrics
 
* '''Plot''' values of selected metrics
 
* '''Export''' bones motion data to file
 
* '''Export''' bones motion data to file

Revision as of 20:39, 13 February 2014

Contents

Introduction

Starting from version 2.6, iPi Mocap Studio includes iPi Biomech Add-on.

iPi Biomech Add-on is a convenient tool for in-depth biomechanical analysis of tracking data. It includes visualization of tracking data and its export to various formats. It can be used for:

  • Gait analysis and rehabilitation
  • Sports motion analysis
  • Research in 3D human kinematics

Markerless tracking technology does not require clumsy suits, and work in real-life environments like regular office.

With iPi Biomech Add-on you can:

  • Get Linear and Angular Quantities for selected bones, including
    • Linear coordinate, velocity, acceleration
    • Euler angles, angular velocity and acceleration
  • Select convenient coordinate systems
    • Linear: Absolute (relative to floor), Relative to parent joint, Relative to center of mass
    • Angular: Absolute (relative to floor), Relative to parent joint
  • Select Euler angles system
  • Plot values of selected metrics
  • Export bones motion data to file
  • Export point clouds obtained from depth sensors to file
IPi-Biomech-1-1.jpg
Note. iPi Biomech Add-on requires separate license key, which you need to activate in addition to iPi Mocap Studio license key. 30-days free trial provided.

Glossary

Linear quantities
Quantities derived from linear coordinate of joint in which bone is connected to parent bone, include:
  • Coordinate
  • Velocity
  • Acceleration
Angular quantities
Quantities derived from Euler angle of bone, include:
Linear coordinate system
Coordinate system used for linear quantities, can be:
  • Absolute (relative to ground) - axis are shown by selecting Move tool; center is automatically set during calibration (it's z-coordinate is always 0)
  • Relative to center of mass - axis are shown by selecting Move tool; center is in the actor model center of mass
  • Relative to parent joint - axis are shown by selecting Move tool; center coincides with the coordinates of parent bone
Angular coordinate system
Coordinate system used for angular quantities, can be:
  • Absolute (relative to ground) - in this system rotations are defined relative to ground
  • Local (Relative to parent bone) - in this system rotations are defined relative to parent bone
Euler angles system
Set of rotations which defines Euler angles, see here
Unit
Measurement unit of physical quantity

License and Trial

iPi Biomech Extension requires separate license key, which you need to activate in addition to iPi Mocap Studio license key. You can order your license here, or activate 30-days free trial. As soon as you install (or auto-update to) version 2.6 or higher, Biomech tab will appear in iPi Mocap Studio control panel. Follow the steps below to start working with iPi Biomech Extension

  1. Switch to Biomech tab.
  2. Press Activate button
  3. Press Start 30-days Free Trial Period or Enter Biomech License Key and follow further on-screen instructions
    IPi-Biomech-2-1.png
Note. If you do not have iPi Mocap Studio license key, you can order it here or activate 30-days free trial. If your Studio trial has expired, you will not be able to export biomech data as well as animation. But you can still plot biomech data.

Select Data for Analysis

First you need to select data that you will analyze

  1. Select bones
    • (1) Check corresponding bones to include them in analysis
    • (2) On the top of the list you can see "special" bones - Center of mass, Center of mass projection to the ground. The rest of the list are bones from internal iPi rig.
    • (3) You can include finger bones into analysis by expanding hand bone (RHand and / or LHand). However, fingers are not tracked due to insufficient resolution of off-the-shelf cameras, so they just keep attached to hand joint (RHand or LHand), remaining in default position related to hand
    • (4) You can select all bones by clicking to checkbox in the header. Fingers will be included only if hand bone is expanded.
    • (5) You can change bones listbox height using splitter at the bottom.
    IPi-Biomech-2-2.png
  2. Select linear quantities for analysis
  3. Select output units for each quantity
  4. Select linear coordinate system
  5. Select angular quantities for analysis
  6. Select output units for each quantity
  7. Select angular coordinate system
  8. Select Euler angles system
    IPi-Biomech-2-3.png

Plot Data

You can plot values of selected quantities for selected bones within Region-of-Interest (except Quaternions and Rotation matrices, which makes no sense to see on plots due to their physical meaning).

  1. Select Region-of-Interest
  2. Press Plot Selected Data button
    Plot window will be opened. If it is already opened it's contents will be updated. In Plot window you see Bones in rows and Quantities in columns. Plot controls:
  3. Plot controls button shows plot control keys (focus should be set to Plot window).
    Mouse wheel - zoom in / out for the horizontal axis
    'Page Up' key - zoom in for the horizontal axis
    'Page Down' key - zoom out for the horizontal axis
    Right mouse button drag over plots - horizontal shift of all plots
    Left mouse button drag over table header title - change columns order
    'Right arrow' key - shift all plots to the left
    'Left arrow' key - shift all plots to the right
    Left mouse key click - show plot values for particular frame
    'A' key - cancel zoom and shift, restore initial state of all plots
  4. Reload plot data reloads plots data. Useful when selection of Bones, Quantities, Region-of-Interest changed or any tracking / refined / filtering applied. The same effect as if you press Plot button.
  5. Scroll to current frame button shifts all plots along horizontal axis, in order current frame to be in visible plot area. Nothing happens, if current frame is already visible on plots.
  6. Show / hide series button allows to select particular components of corresponding Quantity that will be shown on graph.
    IPi-Biomech-2-4.png

Export Motion Data

To export values of selected quantities for selected bones within Region-of-Interest:

  1. Select Region-of-Interest
  2. Press Export Selected Data button
  3. Select export option:
    • Tab-separated text file: text format easily importable to Excel. Header will contain information on parameters such as coordinate systems and units
    • Copy to clipboard / paste to Excel: text data will be copied to clipboard. You just need to open empty Excel sheet and paste. Information on parameters such as coordinate systems and units will be in top rows.
    • MATLAB file: binary file in MATLAB format.
    IPi-Biomech-2-5.png

Export Point Cloud

To export point cloud captured with depth sensors within Region-of-Interest:

  1. Select Region-of-Interest
  2. Select cameras you want to export point cloud from (if you select several cameras, you will get one aggregate point cloud)
  3. Turn on / off background subtraction (if it is checked background will be included in point cloud)
  4. Turn on / off RGB export (if it is checked color information will be added to point cloud's points)
  5. Press Export Selected Data button
  6. Select export option:
    • One point cloud from current frame (PCD): export single point cloud from current frame to file in PCD format
    • All frames of ROI (multiple PCD files): export multiple point clouds (one point cloud from each frame of Region-of-Interest) to PCD format, each point cloud is saved to separate file
    • One point cloud from current frame (MAT): export single point cloud from current frame to file in MATLAB format
    • All frames of ROI (multiple PCD files): export multiple point clouds (one point cloud from each frame of Region-of-Interest) to file in MATLAB format
    IPi-Biomech-2-6.png

Biomech Export Profile

You can save all interface settings (1) to xml file, and later load them from file (2). Settings stored:

  • Selected bones, bones list view height
  • Selected quantities, coordinate systems, euler angles system, units
  • Settings of point cloud export
  • Plot window settings (order on columns, visible series, window size and position)
IPi-Biomech-2-7.png
Personal tools