How robovision2210/spiderx_ws works
SpiderX is a ROS 2 workspace for a 12-DOF quadruped. Its verified user-facing workflow launches the robot in Gazebo Fortress, publishes robot/joint state and lidar data, and supports simulation-only posture and kinematics validation. The controller also contains offline gait analysis, but gait playback and locomotion are not implemented. Localization, mapping, and navigation are configured future layers, documented as blocked pending locomotion and odometry. Some package capabilities are documented but their runtime wiring is not shown in the sampled source, so those links are cited to the README.
Main entry points: m4_5_gait_analysis.py Offline gait analysis · fortress.launch.py Fortress launch · trajectory_client.py Trajectory client · global_localization.launch.py Localization
Components 29
Robot model
- Robot description
src/spiderx_description
Simulation and bringup
- Fortress launch
src/spiderx_bringup/launch/fortress.launch.py - Gazebo Fortress
- Real robot launch
src/spiderx_bringup/launch/real_robot.launch.py - Posture hold launch
src/spiderx_bringup/launch/fortress_posture_hold.launch.py - Joint control launch
src/spiderx_bringup/launch/fortress_control.launch.py
Control and analysis
- Controller config checks
src/spiderx_controller/spiderx_controller/config_check.py - Leg kinematics
src/spiderx_controller/spiderx_controller/leg_kinematics.py - Pose targets and validation
src/spiderx_controller/spiderx_controller/m4_pose_targets.py - Pose runtime validation
src/spiderx_controller/spiderx_controller/m4_pose_validation.py - Posture configuration
src/spiderx_controller/spiderx_controller/posture_config.py - Trajectory client
src/spiderx_controller/spiderx_controller/trajectory_client.py - Gait configuration
src/spiderx_controller/spiderx_controller/gait_config.py - Offline gait analysis
src/spiderx_controller/spiderx_controller/m4_5_gait_analysis.py - Gait trajectory
src/spiderx_controller/spiderx_controller/gait_trajectory.py - Gait kinematics
src/spiderx_controller/spiderx_controller/gait_kinematics.py - Gait metrics
src/spiderx_controller/spiderx_controller/gait_metrics.py - Gait reports
src/spiderx_controller/spiderx_controller/gait_report.py
Sensors and diagnostics
- Lidar launch
src/spiderx_firmware/launch/lidar.launch.py - Sensor diagnostics
src/spiderx_scripts/spiderx_scripts/read_lidar.py - Joint-state reader
src/spiderx_scripts/spiderx_scripts/read_joint_states.py
Autonomy configuration
- Localization
src/spiderx_localization/launch/global_localization.launch.py - SLAM mapping
src/spiderx_mapping/launch/slam.launch.py - Nav2 navigation
src/spiderx_navigation/launch/navigation.launch.py
Other components
- Operator
- Joint states
- Lidar scan
- TF tree
- Joint trajectory controller
Connections 34
- Operator → Fortress launch: launches
README.md - Fortress launch → Gazebo Fortress: starts simulation
README.md - Fortress launch → Robot description: loads model
README.md - Gazebo Fortress → Joint states: publishes
README.md - Gazebo Fortress → Lidar scan: publishes
README.md - Gazebo Fortress → TF tree: publishes
README.md - Operator → Real robot launch: launches
README.md - Real robot launch → Lidar launch: starts lidar
README.md - Operator → Joint control launch: launches
README.md - Joint control launch → Joint trajectory controller: configures
README.md - Operator → Posture hold launch: launches
- Posture hold launch → Gazebo Fortress: uses simulation
- Operator → Controller config checks: checks configuration
README.md - Controller config checks → Robot description: validates against
src/spiderx_controller/spiderx_controller/config_check.py - Leg kinematics → Robot description: reads geometry
src/spiderx_controller/spiderx_controller/leg_kinematics.py - Pose targets and validation → Leg kinematics: solves IK
src/spiderx_controller/spiderx_controller/m4_pose_targets.py - Pose runtime validation → Pose targets and validation: validates targets
src/spiderx_controller/spiderx_controller/m4_pose_validation.py - Pose runtime validation → Trajectory client: sends trajectory
src/spiderx_controller/spiderx_controller/m4_pose_validation.py - Trajectory client → Joint states: reads
src/spiderx_controller/spiderx_controller/trajectory_client.py - Trajectory client → Joint trajectory controller: sends goal
src/spiderx_controller/spiderx_controller/trajectory_client.py - Posture configuration → Controller config checks: reuses safety checks
src/spiderx_controller/spiderx_controller/posture_config.py - Offline gait analysis → Gait configuration: loads gait specs
src/spiderx_controller/spiderx_controller/m4_5_gait_analysis.py - Offline gait analysis → Gait metrics: evaluates gaits
src/spiderx_controller/spiderx_controller/m4_5_gait_analysis.py - Offline gait analysis → Gait reports: writes reports
src/spiderx_controller/spiderx_controller/m4_5_gait_analysis.py - Gait trajectory → Gait kinematics: provides samples
src/spiderx_controller/spiderx_controller/gait_kinematics.py - Gait kinematics → Gait metrics: provides IK samples
src/spiderx_controller/spiderx_controller/gait_metrics.py - Lidar launch → Lidar scan: publishes
README.md - Sensor diagnostics → Lidar scan: reads
README.md - Joint-state reader → Joint states: reads
README.md - Localization → Joint states: uses state
README.md - Localization → TF tree: publishes odometry TF
README.md - SLAM mapping → Lidar scan: uses scans
README.md - SLAM mapping → Localization: uses localization
README.md - Nav2 navigation → SLAM mapping: uses map
README.md