Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/unr-arl/mbplanner_ros
Motion-primitives Based Planner for Fast & Agile Exploration
https://github.com/unr-arl/mbplanner_ros
Last synced: about 1 month ago
JSON representation
Motion-primitives Based Planner for Fast & Agile Exploration
- Host: GitHub
- URL: https://github.com/unr-arl/mbplanner_ros
- Owner: ntnu-arl
- License: bsd-3-clause
- Created: 2020-06-28T01:48:20.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-04-19T14:51:49.000Z (over 1 year ago)
- Last Synced: 2024-08-09T20:06:12.992Z (about 1 month ago)
- Language: C++
- Size: 88.3 MB
- Stars: 311
- Watchers: 20
- Forks: 83
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-resources - [Link
- awesome-robotic-tooling - mb planner - Aerial vehicle planner for tight spaces. Used in DARPA SubT Challenge. (Planning and Control / Vector Map)
README
# mbplanner_ros
## Install and run:
- Follow the instructions in [mbplanner_ws](https://github.com/unr-arl/mbplanner_ws.git) for installation.
- Launch the planner:
```bash
roslaunch mbplanner mbplanner_m100_sim.launch
```
This will launch the planner with the rviz visualizer with the UI which can be used to trigger the planner.
Alternately, the planner can be triggered by calling the respective rosservices as follows:
Start planner: ```rosservice call /planner_control_interface/std_srvs/automatic_planning "{}" ```
Stop planner: ```rosservice call /planner_control_interface/std_srvs/stop ```
- We provide 4 different gazebo simulation environments which can be found in the planner_gazebo_sim package. The world file for the desired environment needs to be specified in the mbplanner_m100_sim.launch file here:
```xml
```
We also support the environments published by DARPA for the Subterranean Challenge - Cave Circuit. In order to use those environments, the models and worlds need to be downloaded from another package: [subt_cave_sim](https://github.com/unr-arl/subt_cave_sim.git). To compile this package:
```bash
catkin build subt_cave_sim
```
And use the ```mbplanner/launch/mbplanner_m100_sim_cave.launch``` file:
```bash
roslaunch mbplanner mbplanner_m100_sim_cave.launch
```
### Select the mapping framework
The planner supports two mapping frameworks: Voxblox and Octomap
#### Voxblox
By default, the planner is compiled with Voxblox. Voxblox can be used with two mapping modes, Euclidean Signed Distance Fields (ESDF) and Truncated Signed Distance Fields (TSDF). By default TSDF is used in which the distance (to the closest occupied voxel) of a voxel is truncated to a fixed value.
In order to switch to ESDF make the following changes:
In the file ``` planner_common/include/planner_common/map_manager_voxblox_impl.h``` comment the following line:
```C++
#define TSDF
```
In the file ```mbplanner/launch/mbplanner_m100_sim.launch``` comment the following line:
```xml
```
Uncomment the following line:
```xml
```
#### Octomap
To compile with Octomap, set the flag USE_OCTOMAP to 1:
```
catkin build -DCMAKE_BUILD_TYPE=Release -DUSE_OCTOMAP=1 mbplanner
```
Also change the config to Octomap in the ```mbplanner/launch/mbplanner_m100_sim.launch``` file
Replace:
```xml
```
With:
```xml
```
## Tutorial:
You could find a short tutorial on the plannning algorithm and the overall architecture on our website: [Link](https://www.autonomousrobotslab.com/subtplanning.html)
## Reference:
If you use this work in your research, please cite the following publication.
```
@inproceedings{mbplanner2020,
title={Motion Primitives-based Agile Exploration Path Planning for Aerial Robotics},
author={Dharmadhikari, Mihir and Dang, Tung and Solanka, Lukas and Loje, Johannes and Nguyen, Huan and Khedekar, Nikhil and Alexis, Kostas},
booktitle={2020 IEEE International Conference on Robotics and Automation (ICRA)},
year={2020},
organization={IEEE}
}
```
Please contact us for any question:
* [Mihir Dharmadhikari](mailto:[email protected])
* [Tung Dang](mailto:[email protected])
* [Kostas Alexis](mailto:[email protected])