uos / pluto_robot

ROS driver for the Pluto robot
41 stars 13 forks source link
mesh-navigation outdoor robot ros

Pluto Robot

pluto_robot_1 pluto_robot_1

Maintainer: Sebastian Pütz
Author: Sebastian Pütz

Installation

Please use the official released ros package or install more recent versions from source.

sudo apt install ros-melodic-pluto-robot

Installation from source
All dependencies can be installed using rosdep
rosdep install pluto_robot

As explicit dependencies for navigation we refer to the following ROS packages, which are also developed by us:

Software Stack

This pluto_robot software stack provides software to use the outdoor robot in simulation and in the real world. Furthermore, example HDF5 map datasets are provided to use Pluto with the mesh_navigation software stack. This package has been used to evaluate the mesh navigation stack. Thus, a couple of experiments are provided. Additionally mesh navigation path planning and motion control with Pluto can be run in the provided Gazebo simulation.

This https://github.com/uos/pluto_robot software stack contains the following packages:

Simulation

You can use Pluto in an outdoor simulation environment. We provides several datasets and the corresponding environments for the Gazebo simulation. For navigation purposes the corresponding navigation launch file should be started, too. The following simulation environments are currently available:

Mesh Navigation

The mesh_navigation stack provides a navigation server for Move Base Flex. It provides a couple of configuration files and launch files to start the navigation server with the configured layer plugins for the layered mesh map, and the configured planners and controller to perform path planning and motion control in 3D (or more specifically on 2D-manifold).

See the Demo Video:
Mesh Navigation with Pluto

Experiments

We provide experiments consisting of starting positions and goals to test the navigation. To run an experiment you first need to launch the navigation stack with the chosen Environment Dataset and then publish the experiments poses:

roslaunch pluto_navigation experiment.launch experiment:={experiment_name}

Replace {experiment_name} with the name of the experiment you choose. Available experiments for each dataset can be found in the Environment Dataset Section in the description of the correspoiding dataset.

How to get our datasets

To manage our datasets we use a git extension called "Git Large File Storage" or for short git LFS. This allows us to keep this repository small while also embedding our datasets inside this repository.

To download our datasets you first need to install git LFS on your system. After installing the git extension you will be able to clone this repository like any other git repository and the datasets will be downloaded.

If you already cloned this repository without having git LFS installed, the dataset files will just be placeholders on your local copy. To download the datasets you again need to install git LFS on your system. After installing the Extension you need to install the git LFS configuration locally. This needs to be ran just once per system and repository inside the directory of your local copy of this repository.

git lfs install

Now simply fetch all available git LFS resources for your local copy of this repository. This will download all datasets and make them available locally.

git lfs fetch --all

Environment Datasets

The following environment dataset are available:

Dataset # Vertices # Triangles BB x[m] BB y[m] BB z[m] Overview
Botanical Garden Osnabrück 714 760 1 430 188 39.05 49.25 6.67 BotanicalGardenOsnabrueckOverview
Stone Quarry Brockum 992 879 1 904 178 100.58 100.58 23.94 StoneQuarryBrockumOverview
Physics Campus Westerberg 719 080 1 617 772 166.02 83.61 26.33 PhysicsCampusWesterbergOverview
Farmer's Pit Stemwede 401 036 794 509 122.23 104.57 14.84 FarmersPitStemwedeOverview
Market Garden Ibbenbüren All 1 361 308 2 656 283 174.33 149.61 24.58 MarketGardenIbbenbuerenAllOverview

Botanical Garden Osnabrück

in progress, description coming soon.

Experiments

The following experiments are available for the physics campus dataset. For every experiment there is one option to use the dijkstra planner and one option to use the vector field planner (vfp). To run the experiment, follow the instructions from Experiments.

Name Description Overview
botanical_garden_1_vfp
or
botanical_garden_1_dijkstra
BotanicalGardenOsnabrueckExperiment1
botanical_garden_2_vfp
or
botanical_garden_2_dijkstra
BotanicalGardenOsnabrueckExperiment2
botanical_garden_3_vfp
or
botanical_garden_3_dijkstra
BotanicalGardenOsnabrueckExperiment3
botanical_garden_4_vfp
or
botanical_garden_4_dijkstra
BotanicalGardenOsnabrueckExperiment4

Stone Quarry Brockum

in progress, description coming soon.

Experiments

The following experiments are available for the physics campus dataset. For every experiment there is one option to use the dijkstra planner and one option to use the vector field planner (vfp). To run the experiment, follow the instructions from Experiments.

Name Description Overview
stone_quarry__1_vfp
or
stone_quarry_1_dijkstra
StoneQuarryBrockumExperiment1
stone_quarry_2_vfp
or
stone_quarry_2_dijkstra
StoneQuarryBrockumExperiment2
stone_quarry_3_vfp
or
stone_quarry_3_dijkstra
StoneQuarryBrockumExperiment3
stone_quarry_4_vfp
or
stone_quarry_4_dijkstra
StoneQuarryBrockumExperiment4

Physics Campus Westerberg

in progress, description coming soon.

Experiments

The following experiments are available for the physics campus dataset. For every experiment there is one option to use the dijkstra planner and one option to use the vector field planner (vfp). To run the experiment, follow the instructions from Experiments.

Name Description Overview
phyics_campus_1_vfp
or
physics_campus_1_dijkstra
Plan from the entrance of the building through the tunnel to the parking lot below PhysicsCampusWesterbergExperiment1
phyics_campus_2_vfp
or
physics_campus_2_dijkstra
Like physics_campus_1, but with another goal which results in the shortest path not passing the tunnel PhysicsCampusWesterbergExperiment2
phyics_campus_3_vfp
or
physics_campus_3_dijkstra
Uses the same starting position as the first examples but the goal is not at the bottom parking lot PhysicsCampusWesterbergExperiment3

Farmer's Pit Stemwede

in progress, description coming soon.

Experiments

The following experiments are available for the physics campus dataset. For every experiment there is one option to use the dijkstra planner and one option to use the vector field planner (vfp). To run the experiment, follow the instructions from Experiments.

Name Description Overview
farmers_pit_1_vfp
or
farmers_pit_1_dijkstra
FarmersPitStemwedeExperiment1
farmers_pit_2_vfp
or
farmers_pit_2_dijkstra
FarmersPitStemwedeExperiment2
farmers_pit_3_vfp
or
farmers_pit_3_dijkstra
FarmersPitStemwedeExperiment3
farmers_pit_4_vfp
or
farmers_pit_4_dijkstra
FarmersPitStemwedeExperiment4

Market Garden Ibbenbüren

in progress, description coming soon.

Experiments

The following experiments are available for the physics campus dataset. For every experiment there is one option to use the dijkstra planner and one option to use the vector field planner (vfp). To run the experiment, follow the instructions from Experiments.

Name Description Overview
market_garden_inner_1_vfp
or
market_garden_inner_1_dijkstra
Market GardenIbbenbuerenInnerExperiment1