Skip to main content

Python interface of C3Dserver software for reading and editing C3D motion capture files.

Project description


Python interface of C3Dserver software for reading and editing C3D motion capture files.


PyC3Dserver is a python inteface of C3Dserver using PyWin32.


PyC3Dserver can be installed from PyPI using pip on Python>=3.7.

pip install pyc3dserver


C3Dserver x64 edition (for Windows x64 platforms) installation:


Most of numerical inputs and outputs for PyC3Dserver will be in the form of NumPy arrays. So let's import NumPy module.

import numpy as np

After the installation of PyC3Dserver, you can import it as follows:

import pyc3dserver as c3d

You can get the COM object of C3Dserver like this. You need to use this COM object while you are working with PyC3Dserver module.

# Get the COM object of C3Dserver
itf = c3d.c3dserver()

Then, you can open a C3D file.

# Open a C3D file
ret = c3d.open_c3d(itf, "sample_file.c3d")

Following functions are the most useful ones to extract the information from a C3D file. All the outputs are python dictionary types.

# For the information of header
dict_header = c3d.get_dict_header(itf)
# For the information of all groups
dict_groups = c3d.get_dict_groups(itf)
# For the information of all markers(points)
dict_markers = c3d.get_dict_markers(itf)
# For the information of all forces/moments
dict_forces = c3d.get_dict_forces(itf)
# For the information of all analogs(excluding or including forces/moments)
dict_analogs = c3d.get_dict_analogs(itf)

If you made any modification in the C3Dserver and want to save it, you need to use the following function explicitly.

# Save the C3D file from C3Dserver
ret = c3d.save_c3d(itf, "new_file.c3d")

After all your processes, it is recommended to close the C3D file from C3Dserver.

# Close the C3D file from C3Dserver
ret = c3d.close_c3d(itf)


There are more functions to get the information of individual markers and analogs. Also there are other functions for editing C3D files. You can find some examples here.


PyC3Dserver tries to implement some useful functions using C3Dserver internally, but it does not cover full potential features of C3Dserver. You can develop your own functions using the COM object of C3Dserver in Python.

And PyC3Dserver is under heavy development so that many things may change during this period.



Python IDE recommendation


This work was funded by the European Union's Horizon 2020 research and innovation programme (Project EXTEND - Bidirectional Hyper-Connected Neural System) under grant agreement No 779982.

How to cite this work




Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyc3dserver-0.2.0.tar.gz (28.8 kB view hashes)

Uploaded source

Built Distribution

pyc3dserver-0.2.0-py3-none-any.whl (28.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page