Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ethz-asl/voxblox
A library for flexible voxel-based mapping, mainly focusing on truncated and Euclidean signed distance fields.
https://github.com/ethz-asl/voxblox
mapping robotics voxblox
Last synced: 3 months ago
JSON representation
A library for flexible voxel-based mapping, mainly focusing on truncated and Euclidean signed distance fields.
- Host: GitHub
- URL: https://github.com/ethz-asl/voxblox
- Owner: ethz-asl
- License: bsd-3-clause
- Created: 2016-04-13T09:07:07.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-04-18T15:12:15.000Z (about 1 year ago)
- Last Synced: 2024-01-20T19:31:59.733Z (6 months ago)
- Topics: mapping, robotics, voxblox
- Language: C++
- Homepage:
- Size: 37.5 MB
- Stars: 1,204
- Watchers: 94
- Forks: 329
- Open Issues: 69
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-voxel - voxblox
- awesome-robotics-libraries - [github - asl/voxblox.svg?style=flat&label=Star&maxAge=86400)] ([Libraries](#awesome-robotics-libraries) / [Motion Planning and Control](#awesome-robotics-libraries))
- awesome-stars - ethz-asl/voxblox - A library for flexible voxel-based mapping, mainly focusing on truncated and Euclidean signed distance fields. (C++)
- awesome-robotics-libraries - [github - asl/voxblox.svg?style=flat&label=Star&maxAge=86400)] ([Libraries](#awesome-robotics-libraries) / [Motion Planning and Control](#awesome-robotics-libraries))
README
# Voxblox
[](https://github.com/ethz-asl/voxblox/actions/workflows/build_test.yml)
Voxblox is a volumetric mapping library based mainly on Truncated Signed Distance Fields (TSDFs). It varies from other SDF libraries in the following ways:
* CPU-only, can be run single-threaded or multi-threaded for some integrators
* Support for multiple different layer types (containing different types of voxels)
* Serialization using protobufs
* Different ways of handling weighting during merging
* Different ways of inserting pose information about scans
* Tight ROS integration (in voxblox_ros package)
* Easily extensible with whatever integrators you want
* Features an implementation of building Euclidean Signed Distance Fields (ESDFs, EDTs) directly from TSDFs.
**If you're looking for skeletonization/sparse topology or planning applications, please refer to the [mav_voxblox_planning](https://github.com/ethz-asl/mav_voxblox_planning) repo.**
**If you want to create ground truth maps from meshes or gazebo environments, please check out the [voxblox_ground_truth](https://github.com/ethz-asl/voxblox_ground_truth) pakage!**
# Documentation
* All voxblox documentation can be found on [our readthedocs page](https://voxblox.readthedocs.io/en/latest/index.html)
## Table of Contents
* [Paper and Video](#paper-and-video)
* [Credits](#credits)
* [Example Outputs](https://voxblox.readthedocs.io/en/latest/pages/Example-Outputs.html)
* [Performance](https://voxblox.readthedocs.io/en/latest/pages/Performance.html)
* [Installation](https://voxblox.readthedocs.io/en/latest/pages/Installation.html)
* [Running Voxblox](https://voxblox.readthedocs.io/en/latest/pages/Running-Voxblox.html)
* [Using Voxblox for Planning](https://voxblox.readthedocs.io/en/latest/pages/Using-Voxblox-for-Planning.html)
* [Transformations in Voxblox](https://voxblox.readthedocs.io/en/latest/pages/Transformations.html)
* [Contributing to Voxblox](https://voxblox.readthedocs.io/en/latest/pages/Modifying-and-Contributing.html)
* [Library API](https://voxblox.readthedocs.io/en/latest/api/library_root.html)
# Paper and Video
A video showing sample output from voxblox can be seen [here](https://www.youtube.com/watch?v=PlqT5zNsvwM).
A video of voxblox being used for online planning on-board a multicopter can be seen [here](https://youtu.be/lrGSwAPzMOQ).
If using voxblox for scientific publications, please cite the following paper, available [here](http://helenol.github.io/publications/iros_2017_voxblox.pdf):
Helen Oleynikova, Zachary Taylor, Marius Fehr, Juan Nieto, and Roland Siegwart, “**Voxblox: Incremental 3D Euclidean Signed Distance Fields for On-Board MAV Planning**”, in *IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS)*, 2017.
```latex
@inproceedings{oleynikova2017voxblox,
author={Oleynikova, Helen and Taylor, Zachary and Fehr, Marius and Siegwart, Roland and Nieto, Juan},
booktitle={IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS)},
title={Voxblox: Incremental 3D Euclidean Signed Distance Fields for On-Board MAV Planning},
year={2017}
}
```
# Credits
This library was written primarily by Helen Oleynikova and Marius Fehr, with significant contributions from Zachary Taylor, Alexander Millane, and others. The marching cubes meshing and ROS mesh generation were taken or heavily derived from [open_chisel](https://github.com/personalrobotics/OpenChisel). We've retained the copyright headers for the relevant files.
