Repository navigation
Sim Vicon Tracker v1.1.0
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.inifile. - Flexible Update Rate: Adjustable frequency (default 200 Hz) set via configuration, replacing the original fixed 50 Hz rate.
- Rotation Utilities: Includes a dedicated
RotationUtilsmodule 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/andsrc/directories for maintainability and extensibility.
Highlights
- Launches a Vicon server at
Origins@10.0.0.200:3883by default, fully configurable viasim_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(ensuresim_vicon.iniis 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.