GeRoNa: Generic Robot Navigation
This project contains a set of ROS packages which provide a navigation suite, including path planning on a given map, controlling of the robot to follow this path and obstacle avoidance while driving.
The packages are build with the goal to get a modular, easily extensible framework, where new modules (e.g. kinematic model of a new robot, new obstacle avoidance algorithms, etc) can be added with minimal effort.
The following video demonstrates various supported robot kinematics:
Installation
First, install the dependencies. For example, from your workspace root directory:
cd src
git clone https://github.com/cogsys-tuebingen/cslibs_path_planning
git clone https://github.com/cogsys-tuebingen/cslibs_navigation_utilities
cd ..
rosdep install --from-paths -i -r -y src
Then you can either use catkin_make, catkin_make_isolated or catkin build to build the software.
Quick Start
This is only a really quick "quick start" guide. For more detailed explanations, see below.
Send goals from some ROS node
To start the complete navigation project as well as nodes for SLAM and obstacle detection (using 2d laser), simply run
roslaunch navigation_launch navigation.launch
Now everything is set up and your node can connect to the navigate_to_goal action server and send goals.
Set goals manually using Rviz
If you want to set goal poses manually using Rviz (e.g. for testing or demonstration purposes), run
roslaunch navigation_launch rviz_controlled.launch
Select robot controller/model
By default a controller for car-like robots is used (ackermann_purepursuit). To change this, simply set the environment variable ROBOT_CONTROLLER with the name of the contproller you want to use.
For example, to use the omni-drive orthexp controller:
export ROBOT_CONTROLLER=omni_orthexp
roslaunch navigation_launch navigation.launch
The controller can also be set via the ROS parameter
rosparam set path_follower/controller_type omni_orthexp
More Information
Please take a look at the example launch files for how to customize parameters in your launch files.
For more information please refer to the wiki.