How luxonis/factory-calibration-depthai works
Project Type and Purpose
• This is an open-source robotics calibration tool built on ROS Melodic. It combines two CATKIN workspaces:
• python3_ws for DepthAI camera capture and automatic Charuco-board calibration nodes (Python-3)
• interbotix_ws for controlling the Interbotix ViperX-300 6DOF arm via MoveIt (Python-2/C++)
• The primary use case is to automate stereo calibration of a DepthAI camera mounted on a 6DOF robot arm, running on Ubuntu 18.04.
File Structure Analysis
• Top level: two ROS workspaces (interbotix_ws and python3_ws), plus utility scripts (server.py, enable_cm4_oak.py).
• interbotix_ws splits into:
• interbotix_descriptions (URDF/XACRO, meshes, RViz configs)
• interbotix_gazebo (Gazebo launch, textures, controller YAMLs)
• interbotix_moveit (MoveIt SRDF, planners, launch files)
• interbotix_moveit_interface (C++/Python wrapper, ROS services, Python scripts for capture and planning)
• interbotix_sdk (low-level SDK: message definitions, C++ nodes, Python API, PID configs)
• python3_ws contains the calibration package: ROS node (depthai_calibrator), launch files, Python helpers, Charuco resources, custom ROS services.
README Insights
• One ROS Master orchestrates both workspaces.
• DepthAI node publishes image streams and exposes services (/capture_checkerboard, /calibrate_stereo).
• MoveIt interface node offers a /MoveItPlan service, subscribes to planning result, and publishes JointCommands.
• SDK node subscribes to JointCommands, communicates over USB to robot hardware.
• There is optional Gazebo simulation in interbotix_gazebo for offline testing.