How dyumanaditya/quad-stack works
Project type and purpose
• QuadStack is a ROS 2-based software stack for quadruped robots (MAB Silver/Honey Badger and Unitree A1/Go1/Go2).
• It integrates neural locomotion, visual‐inertial‐kinematic odometry, SLAM, navigation/planning/exploration, simulation (Gazebo), and teleoperation.
File structure
• Top–level workspace containing:
• legged_kinematics_odometry (pure C++ ROS 2 package publishing odometry from leg kinematics)
• mab_ros (several ROS 2 packages: hb40_commons, mab_control, mab_locomotion, mab_utils)
• quad_stack (the core bringup, gazebo, contact, keyboard teleop, localization, navigation, stand, utils packages)
• robots (URDF/Xacro descriptions for supported robots)
• unitree_ros (control, locomotion, utils for Unitree robots)
• Each package has its own CMakeLists.xml / package.xml, source code (C++ or Python), launch files, message/service definitions, and resources (meshes, models, configuration YAML).
README for insights
• The README describes four major functional pillars:
a. Neural locomotion
b. Visual-Inertial-Kinematic Aided Odometry (VIO)
c. Velocity-constrained SLAM
d. Navigation, planning & exploration
• It also walks through launching each subsystem via ROS 2 launch files under quad_stack_bringup.
Elements
• Blue for perception (VIO, kinematics odometry, SLAM)
• Green for motion (locomotion, control, teleop)
• Orange for planning (navigation, exploration)
• Gray for simulation/hardware (Gazebo, URDF)