ROS Motion Planning

Robot Motion planning is a computational problem that involves finding a sequence of valid configurations to move the robot from the source to the destination. Generally, it includes Path Searching and Trajectory Optimization.

• Path Searching: Based on path constraints (e.g., avoiding obstacles), to find the optimal sequence for the robot to travel from the source to the destination without collision.

• Trajectory Optimization: Based on kinematics, dynamics and obstacles, to optimize the trajectory of the motion state from the source to the destination according to the path.

This repository provides the implementation of common Motion Planning algorithms. The theory analysis can be found at motion-planning. Furthermore, we provide Python and MATLAB version.

Your stars, forks and PRs are welcome!

Contents

• Quick Start within 3 Minutes
• Document
• Tool Chains
• Version
• Acknowledgments
• License
• Maintenance

0. Quick Start within 3 Minutes

Tested on ubuntu 20.04 LTS with ROS Noetic.

1. Install ROS (Desktop-Full Install Recommended).

2. Install git.

   sudo apt install git
   

3. Install dependence

   • conan

     pip install conan==1.59.0
     conan remote add conancenter https://center.conan.io
     

   • Other dependence.

     sudo apt install python-is-python3 \
     ros-noetic-amcl \
     ros-noetic-base-local-planner \
     ros-noetic-map-server \
     ros-noetic-move-base \
     ros-noetic-navfn \
     libgoogle-glog-dev
     

4. Clone the reposity.

   git clone https://github.com/ai-winter/ros_motion_planning.git
   

5. Compile the code.

   NOTE: Please refer to #48 if you meet libignition dependency error.

   cd scripts/
   ./build.sh  # you may need to install catkin-tools using: sudo apt install python-catkin-tools
   

6. Execute the code.

   NOTE: You should open a new terminal or source ~/.bashrc after the first time you run build.sh.

   cd scripts/
   ./main.sh
   

   NOTE: Modifying launch files may not have any effect, because they are regenerated by a Python script based on src/user_config/user_config.yaml when you run main.sh. Therefore, you should modify configurations in user_config.yaml instead of launch files.

7. Use 2D Nav Goal in RViz to select the goal.

8. Moving!

9. You can use the other script to shutdown them rapidly.

   cd scripts/
   ./killpro.sh
   

10. Multi agents

    # 1. Replace with user_config_multi.yaml in main.sh
    # 2. Wait for initialization
    # 3. Publish goals
    rosrun sim_env goal_publisher.py
    

1. Document

The overall file structure is shown below.

ros_motion_planner
├── 3rd
├── docs
├── docker
├── assets
├── scripts
└── src
    ├── core
    │   ├── common
    │   ├── path_planner
    │   └── controller
    ├── sim_env             # simulation environment
    │   ├── config
    │   ├── launch
    │   ├── maps
    │   ├── meshes
    │   ├── models
    │   ├── rviz
    │   ├── urdf
    │   └── worlds
    ├── plugins
    │   ├── dynamic_rviz_config
    │   ├── dynamic_xml_config
    │   ├── gazebo_plugins
    │   ├── map_plugins
    │   └── rviz_plugins
    └── user_config         # user configure file

To better understand the project code, detailed interface documentation can be generated using the doxygen tool. First install doxygen and graphviz.

sudo apt-get install doxygen graphviz

Then start the doxygen and you can find the documentation in ./docs/html/index.html.

doxygen

For more information about the project usage, please refer to the following table.

02. Tool Chains

For the efficient operation of the motion planning system, we provide a series of user-friendly simulation tools that allow for on-demand selection of these lightweight repositories.

03. Version

Global Planner

Local Planner

Curve Generation

04. Acknowledgments

• Our robot and world models are from Dataset-of-Gazebo-Worlds-Models-and-Maps and aws-robomaker-small-warehouse-world. Thanks for these open source models sincerely.

• Pedestrians in this environment are using social force model(sfm), which comes from https://github.com/robotics-upo/lightsfm.

• A ROS costmap plugin for dynamicvoronoi presented by Boris Lau.

05. License

The source code is released under GPLv3 license.

06. Maintenance

Feel free to contact us if you have any question.