https://github.com/aaronjs99/datacollect
DataCollect: Data Collection from OptiTrack Motion Capture Cameras
https://github.com/aaronjs99/datacollect
3d-visualization center-of-mass marker-tracking motion-capture motive optitrack python rigid-body trajectory-analysis
Last synced: about 1 month ago
JSON representation
DataCollect: Data Collection from OptiTrack Motion Capture Cameras
- Host: GitHub
- URL: https://github.com/aaronjs99/datacollect
- Owner: aaronjs99
- License: mit
- Created: 2025-07-16T22:13:18.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-08-04T23:57:22.000Z (10 months ago)
- Last Synced: 2025-09-08T22:25:37.194Z (9 months ago)
- Topics: 3d-visualization, center-of-mass, marker-tracking, motion-capture, motive, optitrack, python, rigid-body, trajectory-analysis
- Language: Python
- Homepage:
- Size: 7.81 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Data Collection from OptiTrack Motion Capture Cameras
This repository provides tools for visualizing the motion of a rigid body tracked by an optical motion capture system. It reads CSV data exported from Motive, extracts `robot_link` marker trajectories, computes the center of mass (CoM), and renders a 3D plot with initial and final configurations outlined.
## Structure
```
datacollect/
├── data/
├── main.py # Main visualization script
├── LICENSE
└── README.md
```
## Usage
Make sure your CSV file is placed in the `./data/` directory. Then run:
```bash
python main.py
```
## Features
- Parses and filters only `robot_link:Marker` columns
- Removes duplicated markers
- Computes center of mass across frames
- Visualizes:
- Marker trajectories
- Center of Mass trajectory
- Polygon mesh at the initial and final marker positions
## Dependencies
Make sure the following Python libraries are installed:
```bash
pip install pandas numpy matplotlib
```
## Output Example
- Each marker trajectory is drawn in a light color.
- The CoM is shown in black.
- Start shape (polygon): green
- End shape (polygon): red
## Notes
- CSV format must follow Motive’s export style with metadata in the first few rows.
- Only `robot_link:Marker` entries are used to compute rigid body motion.
## License
MIT License (2025) – Aaron John Sabu