Skip to content

Examples

Complete, runnable scripts take real recordings from common motion-capture systems all the way to a valid BIDS dataset. Each script is self-contained: on first run it downloads a small sample recording into a data/ folder next to the script, builds the channel metadata, validates, and exports the BIDS files. A final, shorter script focuses on a single piece of metadata: describing the reference frame the data are expressed in.

  • Optical motion capture — Vicon

    Convert 3D marker trajectories from a Vicon .c3d recording.

    Vicon (C3D)

  • Inertial sensors — Movella DOT

    Batch-convert Movella DOT IMU streams from .xdf files.

    Movella DOT (XDF)

  • Multi-IMU with task markers

    Convert multiple unsynchronized IMU streams and merge task markers into *_events.tsv.

    Multi-IMU with events (XDF)

  • Reference frame description

    Describe where the axes of a coordinate system point in channels.json.

    Reference frame

Run them directly

All scripts live in the examples/ folder of the repository:

python examples/from_c3d_vicon.py          # optical mocap (Vicon, .c3d)
python examples/from_xdf_movella.py        # IMU sensors (Movella DOT, .xdf)
python examples/from_xdf_events.py         # multi-IMU + task markers (.xdf)
python examples/reference_frame_optical.py # reference frame in channels.json