MStudio

Markerless/Marker-based Motion Capture Data Visualization & Editing Tool

Seamlessly visualize, analyze, and edit 3D marker data from motion capture systems

Getting Started • Features • Installation • Support

---

What is MStudio?

MStudio is a user-friendly application designed for researchers, biomechanists, and motion capture professionals. It provides an intuitive interface to:

• Visualize 3D marker trajectories in real-time
• Analyze movement patterns and joint&segment angles
• Edit and filter motion capture data
• Export processed data for further analysis

Compatible with popular tools like Pose2Sim and Sports2D.

---

Installation

Option 1: Install from PyPI (Recommended)

# Create a virtual environment (recommended)
conda create -n mstudio python=3.10 -y
conda activate mstudio

# Install MStudio
pip install mstudio

Option 2: Install from Source

git clone https://github.com/hunminkim98/MStudio.git
cd MStudio
pip install .

---

Getting Started

1. Launch MStudio

mstudio

The application will open with an intuitive interface ready for your motion capture data.

You can see the initial launch screen with the main interface

2. Load Your Data

Open File your TRC/C3D file or Choose JSON Folder for 2D marker data

File Selection Interface

3. Basic Navigation & Controls

Action	Control
Play/Pause Animation	Spacebar or Enter
Stop Animation	Spacebar or Enter or Esc
Next/Previous Frame	→ / ← Arrow keys
Rotate View	Left click + drag
Pan View	Right click + drag
Zoom	Mouse wheel

Play.Control.mp4

Play/Mouse Controls Demonstration

4. Analysis Mode

1. Click the "Analysis" button to activate
2. Select markers by left-clicking in the 3D view:
   • 2 markers: Shows distance measurement and segment angle (relative to virtual horizontal line)
     • Left-click to cycle through reference axes (X, Y, Z)
   • 3 markers: Shows joint angle (middle marker = vertex)
3. Results display directly in the 3D viewport

5. Data Processing

• Filter data: Use the filter panel to apply Butterworth, median, or speed-based filters
• Interpolate gaps: Select problematic markers and use pattern-based interpolation
• Export results: File → Save As → Choose TRC or C3D format

---

Key Features

3D Visualization

• 3D Rendering of marker data with interactive controls
• Camera Navigation (rotate, pan, zoom) with smooth navigation
• Coordinate System Switching (Y-up/Z-up) for different conventions
• Customizable Marker Appearance Color, size, opacity, and more

Skeleton Models

Comprehensive support for industry-standard skeleton formats:

• Support for OpenPose, MediaPipe, COCO, HALPE, MPII, and custom skeletons: BODY_25B, BODY_25, BODY_135, BLAZEPOSE, HALPE_26, HALPE_68, HALPE_136, COCO_133, COCO_17, MPII
• Custom skeleton definitions with flexible joint configurations

Analysis Tools

• Trajectory visualization with complete motion paths and data completeness indicators
• Biomechanical measurements:
  • Distance calculation between any 2 markers
  • Segment angle analysis (relative to coordinate axes)
  • Joint angle calculation using 3-point
• Advanced data analysis:
  • Velocity and acceleration computation
  • Outlier detection with visual highlighting
  • Frame-by-frame navigation with precise timeline control
  • Multi-axis coordinate plotting

Analysis Reports

• Comprehensive PDF reports with biomechanical styling
• Multi-section analysis:
  • Dataset statistics and data quality metrics
  • Marker coordinate analysis with statistical summaries
  • Velocity & acceleration analysis with component breakdowns
  • Segment angle analysis with orientation data
  • Joint angle analysis with biomechanical parameters

Data Processing

• Advanced filtering options:
  • Butterworth filter with customizable cutoff frequencies
  • Butterworth on speed for motion-based filtering
  • Median filter for noise reduction
• Smart interpolation with pattern matching algorithms
• Interactive editing tools for manual data correction
• Original data preservation with non-destructive workflow
• Real-time preview of all processing operations

---

Support

Getting Help

• Documentation: GitHub Wiki (Coming Soon)
• Bug Reports: Issue Tracker
• Discussions: GitHub Discussions
• Contact: [email protected]

Supported File Formats

• Input: TRC, C3D, JSON
• Output: TRC, C3D

---

Roadmap

Completed Features

• 3D Visualization: Real-time marker rendering with smooth 60 FPS animation
• Skeleton Support: Multiple skeleton models (OpenPose, MediaPipe, COCO, etc.)
• Analysis Tools: Distance measurement, joint angles, segment angles
• Data Processing: Advanced filtering and interpolation
• File Support: TRC/C3D import/export functionality
• Customization: Adjustable marker size, color, and opacity
• Analysis Report: Export comprehensive analysis results to PDF format

In Development

• Multi-Selection: Drag-and-drop selection for multiple markers
• View Planes: Click-to-set orthogonal views (inspired by OpenSim)
• Performance: Enhanced rendering for large datasets

Planned Features

• Multi-Person Support: Simultaneous visualization and analysis of multiple subjects
• Gait Analysis Mode: Specialized tools and metrics for gait analysis

---

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Acknowledgments

• Compatible with Pose2Sim and Sports2D
• Built with Python, OpenGL, and CustomTkinter
• Inspired by the biomechanics and motion capture community

---