How adambanaszczyk/head_trajectory works
This repository is an experimental workflow for measuring VR-headset positioning accuracy against robot and motion-capture trajectories. Users collect headset and robot poses, estimate their time offset, prepare synchronized calibration inputs, solve the hand-eye transform, convert and trim trajectories, then compare them with trajectory-evaluation tools. The graph also preserves the documented Unity capture and robot trajectory-generation capabilities. Several subsystems are documented but not sampled; those relationships are shown only where the README explicitly describes the workflow.
Main entry points: experiments Experiment recordings · compare_traj_peaks.py Peak time offset · match_poses_by_time.py Calibration CSV preparation · trajectory_TUM_match_by_tool_time.py Synchronized TUM conversion
Components 16
Pose capture
- Unity pose capture
unity_tracking_app - TCP pose publisher
utility/tool_pose_publisher.py - Experiment recordings
data/experiments - Head motion recordings
data/real_world_head_trajectories
Calibration preparation
- Peak time offset
prepare_calibration_data/compare_traj_peaks.py - Calibration CSV preparation
prepare_calibration_data/match_poses_by_time.py - Hand-eye solver
HandEyeCalibration/trajectory_alignment.cpp - Unity-to-OptiTrack transform
HandEyeCalibration
Trajectory processing
- Robot trajectory calculation
determining_robot_motions/calculate_robot_trajectory.py - Synchronized TUM conversion
evaluation/trajectory_TUM_match_by_tool_time.py - Aligned trajectories
data/experiments/linked_tum - Idle and brake trimming
evaluation/auto_remove_idle_and_brake.py
Accuracy evaluation
- Trimmed trajectories
data/experiments/linked_tum - Trajectory comparison
- Comparison results
data/experiments/linked_tum
Other components
- Researcher
Connections 20
- Researcher → Unity pose capture: runs capture
README.md - Researcher → TCP pose publisher: runs publisher
README.md - Unity pose capture → Experiment recordings: records poses
README.md - TCP pose publisher → Experiment recordings: publishes TCP poses
utility/tool_pose_publisher.py - Researcher → Peak time offset: estimates offset
README.md - Experiment recordings → Peak time offset: provides recordings
prepare_calibration_data/compare_traj_peaks.py - Peak time offset → Calibration CSV preparation: informs synchronization
README.md - Experiment recordings → Calibration CSV preparation: provides poses
prepare_calibration_data/match_poses_by_time.py - Calibration CSV preparation → Hand-eye solver: supplies CSV inputs
README.md - Hand-eye solver → Unity-to-OptiTrack transform: writes transform
HandEyeCalibration/trajectory_alignment.cpp - Researcher → Robot trajectory calculation: calculates robot motion
README.md - Head motion recordings → Robot trajectory calculation: provides head path
determining_robot_motions/calculate_robot_trajectory.py - Unity-to-OptiTrack transform → Robot trajectory calculation: provides transform
- Researcher → Synchronized TUM conversion: converts recordings
README.md - Experiment recordings → Synchronized TUM conversion: provides trajectories
evaluation/trajectory_TUM_match_by_tool_time.py - Synchronized TUM conversion → Aligned trajectories: writes TUM files
evaluation/trajectory_TUM_match_by_tool_time.py - Aligned trajectories → Idle and brake trimming: provides trajectories
evaluation/auto_remove_idle_and_brake.py - Idle and brake trimming → Trimmed trajectories: writes filtered files
evaluation/auto_remove_idle_and_brake.py - Trimmed trajectories → Trajectory comparison: compares trajectories
README.md - Trajectory comparison → Comparison results: saves metrics
README.md