Department of Music

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, 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. It has been tested on Matlab version 7.4-7.14 running on Macintosh OS X v10.4-10.6. 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) is employed at the Department of Music of the University of Jyväskylä, Finland. He is the head of the Finnish Centre of Excellence in Interdisciplinary Music Research, which investigates various issues related with music cognition, music motorics, and music and emotions.

Birgitta Burger is a PhD student at the Finnish Centre of Excellence in Interdisciplinary Music Research, investigating the influence of musical features and the emotional content of music on music-induced movement.

 

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

 

» Download

 

» 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.4) (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 Matlab 7.4.-7.14 for Macintosh. (Tested on Mac OS X v10.4-10.6)
  • Linux/Windows: Currently not tested but should be compatible.

 

» Extensions

WiiDataCapture 2.1

WiiDataCapture LogoWiiDataCapture 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.

» 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