Skip to main content

Simple yet effective 3D LiDAR-Odometry registration pipeline

Project description

KISS-ICP: In Defense of Point-to-Point ICP – Simple, Accurate, and Robust Registration If Done the Right Way

ubuntu windows macos

overview

Point cloud maps (blue) generated online by our proposed odometry pipeline on different datasets with the same set of parameters. We depict the latest scan in yellow. The scans are recorded using different sensors with different point densities, different orientations, and different shooting patterns. The automotive example stems from the MulRan dataset. The drone of the Voxgraph dataset and the segway robot used in the NCLT dataset show a high acceleration motion profile. The handheld mechanical LiDAR of LOAM Livox has a completely different shooting pattern than the commonly used rotating mechanical LiDAR.

Install

We released a python-package supported on macos, windows, and ubuntu.

To get started, just run

pip install kiss-icp

If you also want to install all the (optional) dependencies, like Open3D for running the visualizer:

pip install "kiss-icp[all]"

Next, follow the instructions on how to run the system by typing:

kiss_icp_pipeline --help

This should print the following help message: out

Install (developer mode)

If you plan to modify the code then you need to setup the dev dependencies, luckilly, the only real requirements are a modern C++ compiler and the pip package manager, nothing else!, in Ubuntu-based sytems this can be done with:

sudo apt install g++ python3-pip

After that you can clone the code and install the python api:

git clone https://github.com/PRBonn/kiss-icp.git
cd kiss-icp
pip install --verbose .

Install (expert mode)

If you want to have more controll over the build, you should then install cmake, ,ninja, tbb, Eigen, and pybind11 as extra dependencies in your system, the ubuntu-way of doing this is:

sudo apt install build-essential libeigen3-dev libtbb-dev pybind11-dev ninja-build

Teaser Video

https://user-images.githubusercontent.com/38326482/189950820-030fd9e4-406b-4d14-8171-43b134344223.mp4

Authors

  • Ignacio Vizzo
  • Tiziano Guadagnino
  • Benedikt Mersch
  • Louis Wiesmann
  • Jens Behley
  • Cyrill Stachniss

Citation

If you use this library for any academic work, please cite our original paper.

@article{vizzo2022arxiv,
  author    = {Vizzo, Ignacio and Guadagnino, Tiziano and Mersch, Benedikt and Wiesmann, Louis and Behley, Jens and Stachniss, Cyrill},
  title     = {{KISS-ICP: In Defense of Point-to-Point ICP -- Simple, Accurate, and Robust Registration If Done the Right Way}},
  journal   = {arXiv preprint},
  eprint    = {2209.15397v1},
  doi       = {10.48550/ARXIV.2209.15397},
  url       = {https://arxiv.org/pdf/2209.15397.pdf},
  year      = {2022},
  codeurl   = {https://github.com/PRBonn/kiss-icp},
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kiss_icp-0.0.12.tar.gz (48.0 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

kiss_icp-0.0.12-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (365.2 kB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

kiss_icp-0.0.12-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (365.3 kB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64

kiss_icp-0.0.12-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (365.4 kB view details)

Uploaded CPython 3.9manylinux: glibc 2.17+ x86-64

kiss_icp-0.0.12-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (365.1 kB view details)

Uploaded CPython 3.8manylinux: glibc 2.17+ x86-64

kiss_icp-0.0.12-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (367.9 kB view details)

Uploaded CPython 3.7mmanylinux: glibc 2.17+ x86-64

kiss_icp-0.0.12-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (367.8 kB view details)

Uploaded CPython 3.6mmanylinux: glibc 2.17+ x86-64

File details

Details for the file kiss_icp-0.0.12.tar.gz.

File metadata

  • Download URL: kiss_icp-0.0.12.tar.gz
  • Upload date:
  • Size: 48.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.16

File hashes

Hashes for kiss_icp-0.0.12.tar.gz
Algorithm Hash digest
SHA256 16eaa135821eb41550b0a34f4e1f255548c08ab8a40cd116ebe18dc9fa515dc4
MD5 55c6a37a9bbffb4ea08f17f1242f8a1d
BLAKE2b-256 b661126530de3cda482fd7cb1ee7f9a6025d6abe9f5515f44f228da9f1c33ff2

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.12-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.12-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 b0b802eaffa340ac03d6f830c6d2e403500c0039f70809e9a2dbb82bf33b0632
MD5 8fd58fa374a109178cb085da5d1f7a35
BLAKE2b-256 4298367f8894a5917c98ebd50aed7d50d4a7a17861eff73fc7bcf66de82eceda

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.12-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.12-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 b29a0251a4a38ed868712bf5feb9c96541390a8f57f1debce3a02fce293f9ee4
MD5 74e511d03b00d31005f68dd6a6f2bd06
BLAKE2b-256 289b9c95b2c5d006d93ded09477d8944ee098f028345ff87e263b2c85aa524cd

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.12-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.12-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 5951335a7c8f2b6e0e39c0b8fecf795f16d60e72cc895af0c28e10da63b6706a
MD5 9b65cff801de72a44c4b6861ce6da537
BLAKE2b-256 7472d4ad047a511ff80da7b2612d9f7958fbb4dbc360dd3c93ac9665a5e030c9

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.12-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.12-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 c95b745161890c49e67869fc4b5c31c941ae90822da0f9761d1d64b013a2340c
MD5 c04efeee086a01738a4f22bfcf5d5ffa
BLAKE2b-256 d31e5fb91b632e5081cc72b72e51d735999925239f53cba4705ef98c1ed7c1be

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.12-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.12-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 503090c2669e5d0abca45947f16667da25363d28a48cd1b0966f650cbbadad87
MD5 be006de6dd28a11ca1699e3a5ae77845
BLAKE2b-256 4516934e4cbbaf0e3fc8b8d16b0f6b98bd880f0da77e42fa7c030d105d4b574c

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.12-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.12-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 796f5a14497f641e6357619a70c4efa1c4e18abb2b525853d7379099d3bbc801
MD5 22d6b7aaf133630971d0e0f43384e654
BLAKE2b-256 e9c4eb5d9e63a7c494d65e0df154596e203f8efe03d3e8ec0642cc393a73d690

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page