Skip to content

Sim Vicon Tracker v1.1.0

Choose a tag to compare

@ManeeshW ManeeshW released this 26 Mar 02:52
· 2 commits to main since this release

We are excited to announce the initial release of Sim Vicon Tracker v1.1.0, a lightweight simulation tool designed to emulate a Vicon motion capture system using the VRPN protocol. This release provides a robust foundation for developers to test and develop Vicon-dependent software without the need for physical Vicon hardware, making it perfect for offline development, debugging, and deployment on various platforms, including embedded systems.

Key Features

  • VRPN-Based Simulation: Emulates a Vicon tracker, broadcasting synthetic 6DOF pose data (position and quaternion) over the VRPN protocol.
  • Configurable via INI: Customize tracker name, server IP, update frequency, position, and orientation (Euler angles) through a simple sim_vicon.ini file.
  • Flexible Update Rate: Adjustable frequency (default 200 Hz) set via configuration, replacing the original fixed 50 Hz rate.
  • Rotation Utilities: Includes a dedicated RotationUtils module for converting Euler angles to quaternions and rotation matrices, ensuring accurate orientation handling.
  • Cross-Platform: Runs on any machine with VRPN support (e.g., Jetson, PC), requiring only a C++17 compiler and CMake.
  • Structured Codebase: Organized into include/ and src/ directories for maintainability and extensibility.

Highlights

  • Launches a Vicon server at Origins@10.0.0.200:3883 by default, fully configurable via sim_vicon.ini.
  • Provides detailed console output of position, quaternion, and rotation matrix for easy debugging.
  • Correctly aligns quaternion output with VRPN’s [qx, qy, qz, qw] convention for seamless integration with Vicon receivers.

Installation

  • Requires: C++17, CMake ≥ 3.10, VRPN library (libvrpn-dev, libquat-dev).
  • Build: mkdir build && cd build && cmake .. && make.
  • Run: ./sim_vicon_tracker (ensure sim_vicon.ini is in the build directory).

Known Limitations

  • Static pose data only (no dynamic motion simulation yet).
  • Assumes a right-handed Z-up coordinate system; adjustments may be needed for systems with different conventions.

Next Steps

Future releases will explore dynamic pose generation, multi-tracker support, and enhanced coordinate system configurability. Feedback and contributions are welcome!

Author

Developed by Maneesha Wickramasuriya (Maneesh), Graduate Researcher at George Washington University.