ethz-asl / polygon_coverage_planning

Coverage planning in general polygons with holes.
GNU General Public License v3.0
522 stars 154 forks source link
boustrophedon cleaning coverage drone mapping mav navigation obstacles path photogrammetry planning polygon robotics ros uav zag zig

polygon_coverage_planning

This package contains implementations to compute coverage patterns and shortest paths in general polygon with holes. Please cite our accompanying publication when using it.

Bähnemann, Rik, et al.
"Revisiting boustrophedon coverage path planning as a generalized traveling salesman problem."
Field and Service Robotics. Springer, Singapore, 2021.

Coverage Planning in RVIZ

Watch the application video:

Watch the video

Installation on Ubuntu 20.04 and ROS noetic

Install ROS noetic. Install mono.

Create a workspace and download the package.

cd ~
mkdir -p catkin_ws/src
cd catkin_ws
catkin init
catkin config --cmake-args -DCMAKE_BUILD_TYPE=Release
catkin config --extend /opt/ros/noetic
cd src
git clone git@github.com:ethz-asl/polygon_coverage_planning.git

Install all remaining dependencies:

cd polygon_coverage_planning/install
./prepare-jenkins-slave.sh

Finally, build the workspace.

catkin build

Getting Started

The package has a ROS interface for shortest path planning and coverage planning. First source your workspace to execute any of the nodes.

source ~/catkin_ws/devel/setup.bash

Coverage Planning

roslaunch polygon_coverage_ros coverage_planner.launch

The polygon can be set via

The plan is generated via

The resulting waypointlist is published as geometry_msgs/PoseArray on topic /waypoint_list.

To publish the waypoint list

Euclidean Shortest Path Planning

roslaunch polygon_coverage_ros shortest_path_planner.launch

Setting the polygon and planning the path is the same as for Coverage Planning.

Licensing

This repository is subject to GNU General Public License version 3 or later due to its dependencies.

CGAL dependencies

The underlying (exact) geometric operations rely on CGAL 5.0.3 which is restricted by GNU General Public License version 3 or later. In particular the dependencies are:

Fogel, Efi, Dan Halperin, and Ron Wein. CGAL arrangements and their applications: A step-by-step guide. Vol. 7. Springer Science & Business Media, 2012. Bungiu, Francisc, et al. "Efficient computation of visibility polygons." arXiv preprint arXiv:1403.3905 (2014).

GTSP solver

The underlying optimization uses the memetic solver presented in

Gutin, Gregory, and Daniel Karapetyan.
"A memetic algorithm for the generalized traveling salesman problem."
Natural Computing 9.1 (2010): 47-60.

It is free of charge for non-commercial purposes only.