Skip to content

Map and configuration files to perform path planning in 3D on a mesh surface.

Notifications You must be signed in to change notification settings

naturerobots/pluto_maps

Repository files navigation

Pluto Maps

This package includes mesh maps and configuration files for the mesh navigation stack, as well as experiment files that define sample start and finish poses on the surface. It is called Pluto Maps because these maps were created as part of the mesh navigation with the robot Pluto.

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

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

Software Stack

This pluto_maps software stack provides example HDF5 map datasets for the mesh mesh_navigation software stack. The pluto_maps package has been used to evaluate the mesh navigation stack. Thus, a couple of experiments are provided.

This package contains dataset, map and navigation configurations to run the mesh navigation stack with different environment maps. Additionally, it contains mesh navigation experiments using developed planners from the mesh navigation stack. See Mesh Navigation for more details.

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).

Demo Videos:

Mesh Navigation with Pluto in the Botanical Garden, Osnabrück

Mesh Navigation with Pluto in the Botanical Garden, Osnabrück

Mesh Navigation with Acorn in the Stone Quarry, Brockum

Mesh Navigation with Acorn in the Stone Quarry, Brockum

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_maps 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:

  • Botanical Garden at Osnabrück University:
    roslaunch pluto_maps botanical_garden_osnabrueck.launch
  • Stone Quarry in the forest in Brockum:
    roslaunch pluto_maps stone_quarry_brockum.launch
  • Physics building at Campus Westerberg, Osnabrück University:
    roslaunch pluto_maps physics_campus_westerberg.launch
  • Farmer's Pit in Stemwede:
    roslaunch pluto_maps farmers_pit_stemwede.launch
  • Market Garden (complete) in Ibbenbüren:
    roslaunch pluto_maps market_garden_ibbenbueren_all.launch
  • Market Garden (beds) in Ibbenbüren:
    roslaunch pluto_maps market_garden_ibbenbueren_inner.launch
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

About

Map and configuration files to perform path planning in 3D on a mesh surface.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published