MoCap Toolbox

MCTlogo_smallThe MoCap Toolbox is a Matlab® toolbox that contains functions for the analysis and visualization of motion capture data. The toolbox is mainly aimed for the analysis of music-related movement, but might be useful in other areas of study as well. It supports the generic .c3d file format, the .tsv data format produced by the Qualisys Motion Capture system, the .mat file format produced by the Qualisys Motion Capture system, the .bvh format, and the .wii format produced by the WiiDataCapture software.

To use the toolbox, you need the Matlab software. Before using it, the toolbox has to be added in the Matlab path variable. The toolbox should be compatible with most versions of Matlab and most platforms. The latest implementations and developments have been made on Matlab version 8.4 (R2014b) running on Macintosh OS X v10.10. The MoCap Toolbox comes with no warranty. It is free software, and you are welcome to redistribute it under certain conditions. See the file License.txt provided with the toolbox for details of GNU General Public License.


» Authors

Petri Toiviainen (Professor) and Birgitta Burger (Postdoctoral researcher) are employed at the Department of Music, Art and Culture Studies of the University of Jyväskylä, Finland. Both are members of the Finnish Centre for Interdisciplinary Music Research, which investigates various issues related with music cognition, music motorics, and music and emotions. 

If you have any comments or problems to report, please contact the authors (firstname.lastname at jyu.fi).


» Download

  • Go to Download Form
      • Version 1.5 (released 7/10/2015)
      • Old versions - if you wish to have access to an older version of the toolbox, please get in touch with the authors.


» Extensions

Periodic quantity of motion by Rodrigo Schramm & Federico Visi. You need MoCap Toolbox to run the functions. See the Manual and the function help how to use it. Download (zip, 1.1 mb). 

See also: Visi, Federico, Schramm, Rodrigo and Miranda, Eduardo. Gesture in Performance with Traditional Musical Instruments and Electronics: Use of Embodied Music Cognition and Multimodal Motion Capture to Design Gestural Mapping Strategies. Proceedings of the International Workshop on Movement and Computing. MOCO '14, p. 100-105, ACM, Paris, 2014.


» Mailing List

Please register to the mailing list to stay informed about new releases, bug reports, and bug fixes. It also serves as a general discussion board for users, so feel free to post anything motion capture- and toolbox-related that might be of interest to other users and developers.

You can either register by just keeping the corresponding check box ticked when downloading the Toolbox or by using the link below:

Subscribe to mailing list

The email address to send messages to the list is mocaptoolbox at freelists.org (requires registration to send).


» Documentation and Reference

The documentation provides a general description of the Toolbox (Chapter 1) and examples (Chapter 2). Chapter 3 and 4 contain the data and parameter structure, and function reference respectively.

Download User's Manual (v. 1.5) (pdf, 2mb)


To cite the MoCap Toolbox, please use the following reference:

  • APA entry:
    Burger, B. & Toiviainen, P. (2013). MoCap Toolbox – A Matlab toolbox for computational analysis of movement data. In R. Bresin (Ed.), Proceedings of the 10th Sound and Music Computing Conference, (SMC). Stockholm, Sweden: KTH Royal Institute of Technology.
  • Bibtex entry:
    Bibtex entry: @inproceedings{BurgerToiviainen2013,
    address = {Stockholm, Sweden},
    author = {Burger, Birgitta and Toiviainen, Petri},
    booktitle = {Proceedings of the 10th Sound and Music Computing Conference},
    editor = {Bresin, Roberto},
    pages = {172--178},
    publisher = {KTH Royal Institute of Technology},
    title = {{MoCap Toolbox -- A Matlab toolbox for computational analysis of movement data}},
    year = {2013}}

Download the article (pdf)


» Installation

Unpack the MoCap Toolbox file package you have downloaded. This will create a directory called mocaptoolbox. Secondly, a version of the Matlab program needs to be installed (see www.mathworks.com). Thirdly, the Toolbox needs to be defined in the Matlab path variable. Under the File menu, select Set Path Under the Path menu, select Add to Path. Write here the name of the directory where this toolbox has been installed. Then click OK. Finally, under the File menu, select Save Path, and then Exit.


» Compatibility

  • Macintosh (OS X): The MoCap Toolbox is compatible with most recent Matlab versions and has been tested with 8.4. (R2014b) running on Macintosh OS X v10.10 and higher. 
  • Linux/Windows: Currently not tested but should be compatible.


» Extensions

WiiDataCapture 2.1

WiiDataCapture is a software that displays and saves acceleration data of up to 8 Nintendo Wiimotes. Version 2.1 also features audio playback (from line in input or computer) and audio recording.

Download WiiDataCapture 2.1

» Compatibility

The WiiDataCapture 2.1 utility runs on Mac OS X v10.4-10.6.

» System Requirements

WiiDataCapture 2.1 requires OSCulator (http://www.osculator.net)!
Old versions of WiiDataCapture: please contact authors for older versions.



connection matrix for mocap toolbox workshop at RPPW 2017:

ap.conn = [1,2; 2,4; 3,4; 3,1; 5,6; 9,10; 10,12; 11,12; 11,9; 8,9; 8,10; 8,5; 8,6; 5,9; 5,11; 6,10; 6,12; 7,11; 7,12; 7,5; 7,6; 5,13; 13,15; 13,16; 16,19; 15,19; 6,14; 14,17; 14,18; 17,20; 18,20; 9,21; 11,21; 10,22; 12,22; 21,23; 23,25; 23,26; 25,26; 22,24; 24,27; 24,28; 27,28];