You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Accurate ground surface representation is crucial for ground-based robots in complex terrains. The [ROS2 Navigation Stack](https://docs.nav2.org/), which uses voxel maps for 3D navigation, often loses detail and accuracy, especially in multi-storey environments, due to its discrete voxelization and separate costmaps for each floor.
15
+
16
+
We propose ugv_nav4d, a path planner that enhances environmental representation with [Multi-Layered Surface Maps](https://github.com/envire/slam-maps) (MLS) and a 3D [Traversability Map](https://github.com/dfki-ric/traversability_generator3d.git). Ugv_nav4d avoids the "stepping" effect of voxel maps by using a continuous grid and detailed vertical information, providing smoother and more accurate terrain modeling.
17
+
18
+
Unlike nav2, ugv_nav4d simplifies planning with a single TraversabilityMap3D, which contains detailed ground surface data, offering a superior alternative to nav2’s 3D costmaps. For users, MLS maps provide a smoother, more realistic view of terrain compared to the blocky voxel maps, enhancing navigation and decision-making in complex environments.
19
+
13
20
## Installation
14
21
15
22
Follow the steps to peform a standalone build of the library.
16
23
17
24
### System Requirements
18
25
19
26
```
20
-
OS: Ubuntu 20.04, Ubuntu 22.04 (Recommended)
27
+
OS: Ubuntu 20.04, Ubuntu 22.04, Ubuntu 24.04
21
28
22
29
```
23
30
See [install_os_dependencies.bash](source_dependencies/install_os_dependencies.bash) for further os dependencies.
@@ -64,15 +71,8 @@ make install
64
71
#### Compiling inside a ROCK environment [Only for ROCK users]
65
72
See the `manifest.xml` for an up to date list of dependencies. If you are ROCK user then include the package_set which contains the ```dfki-ric/orogen-ugv_nav4d``` package in your autoproj manifest file.
66
73
67
-
#### Generate API Documentation
68
-
The API documentation is generated based on doxygen. You do not need to install doxygen because it is installed as part of the ```install_os_dependencies.bash``` script used in the previous step.
69
-
70
-
You just need to run the ```make doc``` command in the ugv_nav4d build folder. The doxygen documentation will be automatically generated in the ```build/doc``` folder.
71
-
72
-
```
73
-
cd build/
74
-
make doc
75
-
```
74
+
#### API Documentation
75
+
The API documentation can be found at https://dfki-ric.github.io/ugv_nav4d/
76
76
77
77
#### GUI Usage & Tests
78
78
@@ -123,8 +123,6 @@ At the end you should see the output
123
123
### Planning
124
124
The planner is based on SBPL (http://www.sbpl.net/). I.e. it uses the SBPLs ARA* planner to plan in a custom environment.
125
125
126
-
TODO parallellism
127
-
128
126
#### Environment
129
127
SBPL internally uses states (identified by an id only) and associated costs (a unitless integer). The state ids reference states of an environment. That environment has to be defined by the user.
130
128
The planner contains the `EnvironmentXYZTheta`. This environment implements all interfaces needed by SBPL to enable ARA* planning (other planning algorithms might require additional interfaces).
0 commit comments