PyMoCapViewer 0.0.15

A once-simple 3D motion capture visualizer that is becoming more advanced over time.

PyMoCapViewer Documentation

PyMoCapViewer is a Python package designed to visualize motion capture data in a user-friendly and interactive manner. It allows you to load various mocap file formats, animate the skeleton, and control the viewing experience with keyboard shortcuts.

Installation

You can install PyMoCapViewer using pip:

pip install PyMoCapViewer

Keyboard Shortcuts

The following keyboard shortcuts are available for interacting with PyMoCapViewer:

Key	Action
Space	Play/pause animation
s	Capture screenshot
Enter	Capture Screenvideo
i	Print current frame number
0	Jump to first frame
Left/Right Arrow	Previous/Next frame
Left Mouse Button	Interact with scene
q	Quit application

Example Usage

Load the kinematic data as a Pandas Dataframe. The columns should contain the joints in the following format: J1 (x), J1 (y), J1 (z), ..., JN (x), JN (y), JN (z).

from PyMoCapViewer import MoCapViewer
from PyMoCapViewer.examples import get_azure_data, get_vicon_data

df_pos, df_ori = get_azure_data()
viewer = MoCapViewer(sphere_radius=0.01, sampling_frequency=30)
viewer.add_skeleton(df_pos, skeleton_connection="azure", skeleton_orientations=df_ori, orientation="quaternion")
viewer.show_window()

df = get_vicon_data()
viewer = MoCapViewer(sphere_radius=0.01, sampling_frequency=100)
viewer.add_skeleton(df, skeleton_connection="vicon", color="red")
viewer.show_window()