General information about OctoMap is available at and in the publication "OctoMap: An Efficient Probabilistic 3D Mapping Framework Based on Octrees" by A. Hornung, K. M. Wurm, M. Bennewitz, C. Stachniss, and W. Burgard (Autonomous Robots Journal, 2013).


  author = {Armin Hornung and Kai M. Wurm and Maren Bennewitz and Cyrill
  Stachniss and Wolfram Burgard},
  title = {{OctoMap}: An Efficient Probabilistic {3D} Mapping Framework Based
  on Octrees},
  journal = {Autonomous Robots},
  year = 2013,
  url = {},
  doi = {10.1007/s10514-012-9321-0},
  note = {Software available at \url{}}

Please cite our paper if you use OctoMap in your research.

Doxygen documentation based on the latest OctoMap release is available online.

Up to ROS electric, the octomap package contained in the octomap_mapping stack provides the OctoMap library by downloading a released tarball. Since fuerte, this was replaced with a regular library (see the other version tabs at the top of the page).

If you want to use OctoMap in ROS, octomap_ros and octomap_msgs provide messages, wrappers and conversion methods. octomap_server provides map building and serving capabilities. A visualization tool is available at octovis.

Using OctoMap


sudo apt-get install ros-$ROS_DISTRO-octomap

to install OctoMap as stand-alone libraries with no ROS dependencies (so the package can also be used in a non-ROS setting).

This means that you compile against OctoMap without requiring any ROS-specific build tools or catkin macros (in fact, they won't work). For convenience, the system install includes CMake config files for easily finding and configuring OctoMap in your CMakeLists.txt using the regular find_package() macro:

find_package(octomap REQUIRED)

(Add link_directories(${OCTOMAP_LIBRARY_DIRS}) only if required - usually it's not needed).

Finally, add to your package.xml:


Finally, add <rosdep name="octomap" />  to stack.xml

Report a Bug

Report bugs or request features on GitHub. For questions and discussions, use the mailing list at

Wiki: octomap (last edited 2021-05-12 14:36:13 by AdamAllevato)