/3dmr

3D Multi-Robot Exploration, Patrolling and Navigation.

Primary LanguageC++GNU General Public License v3.0GPL-3.0

3DMR

3D Multi-Robot Exploration, Patrolling and Navigation.

Maintainer: Luigi Freda

The 3DMR framework provides tools for 3D multi-robot exploration, patrolling and navigation tasks with different robots under different simulators. It provides the core C++ implementation behind our papers:

This repository allows testing our proposed multi-robot strategies within V-REP and gazebo. It extends and improves our previous framework 3dpatrolling. Here, you can find a list of new features we added.

V-REP simulation 3d exploration V-REP simulation 3D exploration

Main features

Tasks: 3D exploration, 3D patrolling, and 3D navigation.

3DMR system

Robots: tracked UGV, jackal UGV, pioneer 3-DX, and AscTec Firefly.

TRADR system TRADR system

TRADR system TRADR system

TRADR system TRADR system

Simulators: V-REP and gazebo.

GUIs: our PyQt GUIs offer a convenient entry point for quickly launching exploration, patrolling and navigation systems.


Prerequisites

3DMR requires ROS noetic under Ubuntu 20.04. Python3 is required in order to start our PyQt GUIs. If you do not have this Ubuntu version, you can use rosdocker.

Quick install and build

Here, you can find a quick install procedure (tested under Ubuntu 20.04). Open a new terminal and get into the root folder of this repo. Run the following commands:

  • automagically install V-REP, gazebo, ROS dependencies and everything else is required:
    $ ./install.sh
  • build all the workspaces in this repo:
    $ ./build_all.sh
  • source all the 3DMR workspaces:
    $ source source_all.bash
    Now, you're ready to test our exploration, patrolling and navigation systems. See the next sections for further details.

If you do not have Ubuntu 20.04, you can use rosdocker.

Refer to INSTALL.md if you need a manual installation.


Repo organization

Workspaces

3DMR is a stack of ROS packages organized in different workspace folders (with suffix _ws):

  • mapping_ws collects volumetric mapping tools integrated in our system (octomap, voxblox, robot-centric elavation mapping).
  • nav_ws collects the packages that allow path planning, trajectory control, navigation, and V-REP simulation with the tracked robots.
  • patrolling_ws collects our main patrolling packages imported from 3dpatrolling.
  • exploration_ws collects packages used for multi-robot exploration and a port of the nbvplanner packages (exploration for drones) to ROS noetic.
  • jackal_ws collects gazebo packages and launch files for multi-robot navigation and exploration with a team of jackal robots equipped with LIDAR.
  • pioneer_ws collects packages used for multi-robot navigation and exploration with a team of pioneer robots equipped with RGBD cameras.
  • teb_ws collects the TEB tools that we integrated into our system.

In each workspace, you can use the scriptcompile_with_catkin_build.sh to separately build the workspace with catkin build.

Main scripts

Open a new terminal and from the root folder of this repo you can:

  • build all the workspaces
    $ ./build_all.sh
  • source the workspaces by using the command
    $ source source_all.bash
    Once you have sourced the workspaces, you're ready to test the patrolling and exploration systems, or the path planner (see the next sections).
  • if needed, clean the workspaces by running
    $ ./clean_all.sh

See the GUIs section below on how to use our main_*.py GUI scripts.


3D Multi-robot exploration

Refer to this README.exploration.md for testing the exploration system.

V-REP simulation 3d exploration V-REP simulation 3D exploration


3D Multi-robot patrolling

Refer to this README.patrolling.md for testing the patrolling system.

V-REP simulation 3dpatrolling V-REP simulation 3dpatrolling TRADR system


3D Multi-robot path planner

RVIZ and V-REP


GUIs

We have different PyQt GUIs for launching exploration, patrolling and path planner systems on the different robot systems. You can run:

  • $ ./main.py for TRADR UGVs equipped with rotating laser-scanners
  • $ ./main_pioneer.py for pioneer robots equipped with RGBD cameras
  • $ ./main_jackal.py for jackal UGVs equipped with LIDARs, IMUs and cameras
  • $ ./main_uav.py for a team of UAVs equipped with stereo/depth cameras and IMUs (nbvplanner)

RVIZ and V-REP RVIZ and V-REP RVIZ and V-REP RVIZ and V-REP

The buttons and tooltips should be self-explanatory. Start playing with them and refer to the following README files for further details:


SLAM integration

On the TRADR tracked robots, we initially used the LIDAR SLAM frameworks laser-slam and segmap. On the pioneer 3-DX robots with RGBD cameras, we used RTAB-Map.

If you have robots with 3D LIDARs, you may want to take a look at this cool paper for alternative SLAM tools: Present and Future of SLAM in Extreme Underground Environments


Project webpages

TRADR EU project

This work started during the TRADR EU project. You can find a presentation of the TRADR project on its website.

3D Patrolling project

Videos and further information about our previous 3dpatrolling framework can be found on our 3D patrolling project webpage.

TRADR system TRADR system TRADR system


License

The 3DMR stack contains different ROS packages. Each package comes with its license. Where nothing is specified, a GPLv3 license applies to the software.

Please cite our works (referred above) if you use our system in your projects.


Contributing to 3DMR

You can contribute to the code base by using pull requests, reporting bugs, leaving comments, and proposing new features through issues. Feel free to get in touch: luigifreda(at)gmail(dot)com. Thank you!


Credits

  • Some of the packages in the folders nav_ws/src/robot and nav_ws/src/msgshave been developed by the TRADR team. Thanks to all the guys that shared with us cold tents, hot coffee and wonderful life moments during TRADR demos, integrations, exercises and reviews!

  • We implemented our patrolling agent in the ROS package patrolling3d_sim. We used the package patrolling_sim as a starting point (further details in our 3D patrolling paper). We would like to thank the Authors for their great work.

  • Our exploration agent is implemented in the ROS package expl_planner. The package nbvplanner was used as a starting point (further details in our 3D exploration paper). We sincerely express our gratitude to the Authors for their great work.

  • The jackal workspace contains tools from https://github.com/jackal/jackal. Many thanks to the Authors of that repository.