How hkust-aerial-robotics/fuel works
FUEL is a ROS-based UAV exploration framework. The principal workflow starts when an operator triggers exploration: the system incrementally updates a frontier information structure from the online map, plans frontier coverage, refines viewpoints, and generates trajectories for the vehicle. The repository also contains map/sensor simulation and trajectory optimization components. The README documents the high-level planning sequence; the available source excerpts do not establish every internal call, so unsampled implementation links are omitted.
Main entry points: fast_exploration_manager.cpp Coverage planning · planner_manager.cpp Trajectory planning · fast_exploration_fsm.cpp Exploration control · bspline_optimizer.cpp B-spline optimizer
Components 21
Mapping and perception
- Map ingestion
fuel_planner/plan_env/src/map_ros.cpp - SDF map
fuel_planner/plan_env/src/sdf_map.cpp - Frontier structure
fuel_planner/active_perception/src/frontier_finder.cpp
Exploration planning
- Exploration control
fuel_planner/exploration_manager/src/fast_exploration_fsm.cpp - Coverage planning
fuel_planner/exploration_manager/src/fast_exploration_manager.cpp - Viewpoint refinement
fuel_planner/active_perception/src/heading_planner.cpp - Coverage search
fuel_planner/active_perception/include/active_perception/graph_search.h - Tour solver
fuel_planner/utils/lkh_tsp_solver/src/lkh_interface.cpp - Path search
fuel_planner/path_searching/src/kinodynamic_astar.cpp
Trajectory generation
- Trajectory planning
fuel_planner/plan_manage/src/planner_manager.cpp - B-spline optimizer
fuel_planner/bspline_opt/src/bspline_optimizer.cpp - B-spline representation
fuel_planner/bspline/src/non_uniform_bspline.cpp - Polynomial trajectories
fuel_planner/poly_traj/src/polynomial_traj.cpp - Trajectory execution
fuel_planner/plan_manage/src/traj_server.cpp - Planning visualization
fuel_planner/traj_utils/src/planning_visualization.cpp
Simulation and vehicle
- Map source
uav_simulator/map_generator/src/map_publisher.cpp - Local sensing
uav_simulator/local_sensing/src/depth_render_node.cpp - Quadrotor dynamics
uav_simulator/so3_quadrotor_simulator/src/dynamics/Quadrotor.cpp - SO3 control
uav_simulator/so3_control/src/SO3Control.cpp - Position command
uav_simulator/Utils/multi_map_server/quadrotor_msgs/msg_gen/cpp/include/quadrotor_msgs/PositionCommand.h
Other components
- Operator
Connections 21
- Operator → Exploration control: starts exploration
- Map source → Local sensing: supplies environment
- Local sensing → Map ingestion: provides observations
- Map ingestion → SDF map: updates map
fuel_planner/plan_env/src/sdf_map.cpp - SDF map → Frontier structure: informs frontier search
- Exploration control → Coverage planning: requests coverage plan
- Coverage planning → Frontier structure: uses frontier structure
- Coverage planning → Coverage search: plans coverage paths
- Coverage planning → Tour solver: orders coverage
- Coverage planning → Viewpoint refinement: refines viewpoints
- Coverage planning → Trajectory planning: requests trajectories
- Trajectory planning → Path search: searches paths
- Trajectory planning → B-spline optimizer: optimizes trajectory
- B-spline optimizer → SDF map: queries distances
fuel_planner/bspline_opt/src/bspline_optimizer.cpp - B-spline optimizer → B-spline representation: optimizes spline
- Trajectory planning → Polynomial trajectories: generates trajectory
- Trajectory planning → Trajectory execution: provides trajectory
- Trajectory execution → Position command: publishes commands
- Position command → Quadrotor dynamics: drives vehicle
- Quadrotor dynamics → SO3 control: models controlled vehicle
- Exploration control → Planning visualization: displays plans