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.13.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.13-cp311-cp311-win_amd64.whl (271.6 kB view details)

Uploaded CPython 3.11Windows x86-64

kiss_icp-0.0.13-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (364.1 kB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

kiss_icp-0.0.13-cp311-cp311-macosx_10_9_x86_64.whl (314.9 kB view details)

Uploaded CPython 3.11macOS 10.9+ x86-64

kiss_icp-0.0.13-cp311-cp311-macosx_10_9_universal2.whl (494.1 kB view details)

Uploaded CPython 3.11macOS 10.9+ universal2 (ARM64, x86-64)

kiss_icp-0.0.13-cp310-cp310-win_amd64.whl (271.8 kB view details)

Uploaded CPython 3.10Windows x86-64

kiss_icp-0.0.13-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (364.2 kB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64

kiss_icp-0.0.13-cp310-cp310-macosx_10_9_x86_64.whl (314.9 kB view details)

Uploaded CPython 3.10macOS 10.9+ x86-64

kiss_icp-0.0.13-cp310-cp310-macosx_10_9_universal2.whl (494.1 kB view details)

Uploaded CPython 3.10macOS 10.9+ universal2 (ARM64, x86-64)

kiss_icp-0.0.13-cp39-cp39-win_amd64.whl (271.8 kB view details)

Uploaded CPython 3.9Windows x86-64

kiss_icp-0.0.13-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (364.3 kB view details)

Uploaded CPython 3.9manylinux: glibc 2.17+ x86-64

kiss_icp-0.0.13-cp39-cp39-macosx_10_9_x86_64.whl (315.1 kB view details)

Uploaded CPython 3.9macOS 10.9+ x86-64

kiss_icp-0.0.13-cp39-cp39-macosx_10_9_universal2.whl (494.4 kB view details)

Uploaded CPython 3.9macOS 10.9+ universal2 (ARM64, x86-64)

kiss_icp-0.0.13-cp38-cp38-win_amd64.whl (271.7 kB view details)

Uploaded CPython 3.8Windows x86-64

kiss_icp-0.0.13-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (364.0 kB view details)

Uploaded CPython 3.8manylinux: glibc 2.17+ x86-64

kiss_icp-0.0.13-cp38-cp38-macosx_10_9_x86_64.whl (314.9 kB view details)

Uploaded CPython 3.8macOS 10.9+ x86-64

kiss_icp-0.0.13-cp38-cp38-macosx_10_9_universal2.whl (494.1 kB view details)

Uploaded CPython 3.8macOS 10.9+ universal2 (ARM64, x86-64)

kiss_icp-0.0.13-cp37-cp37m-win_amd64.whl (271.8 kB view details)

Uploaded CPython 3.7mWindows x86-64

kiss_icp-0.0.13-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (367.1 kB view details)

Uploaded CPython 3.7mmanylinux: glibc 2.17+ x86-64

kiss_icp-0.0.13-cp37-cp37m-macosx_10_9_x86_64.whl (313.7 kB view details)

Uploaded CPython 3.7mmacOS 10.9+ x86-64

kiss_icp-0.0.13-cp36-cp36m-win_amd64.whl (271.6 kB view details)

Uploaded CPython 3.6mWindows x86-64

kiss_icp-0.0.13-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (366.9 kB view details)

Uploaded CPython 3.6mmanylinux: glibc 2.17+ x86-64

kiss_icp-0.0.13-cp36-cp36m-macosx_10_9_x86_64.whl (313.6 kB view details)

Uploaded CPython 3.6mmacOS 10.9+ x86-64

File details

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

File metadata

  • Download URL: kiss_icp-0.0.13.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.13.tar.gz
Algorithm Hash digest
SHA256 0471b9b5158dac52633b831f5f73a141ffedbab76073feb7bd39572d078f47cb
MD5 8449fc3c71a4567af66a167b523218d4
BLAKE2b-256 621bc9fbf3fb8bfd1879181243a460dde0dcf578dab18d4d5ed344f825581af8

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: kiss_icp-0.0.13-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 271.6 kB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.13

File hashes

Hashes for kiss_icp-0.0.13-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 e9ac1a42ddfdf01d6e61982ad9b4920733097d02a5cbaca04443d8a34167d4fe
MD5 187fee0f25358fba227ae7cad5197616
BLAKE2b-256 9189bddcab16052458822d0af5166d3f9ab2007d2e4b2124840482194093060b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 91aed859067daae4a0b61e61de1ccba3b87eaa537fea21862bac9be67cd7e642
MD5 51ccc3f99e304d97784ec19f4b02fb44
BLAKE2b-256 923e96c00d70fa2b7ea51214bee73d829c2ceffe6ae2209e7c58aed620af3604

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp311-cp311-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp311-cp311-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 08d43b0858411b638b1316d0f476849c69896c83d9524fad558578a78349b65b
MD5 7e1b8b96b3381fd0202ffd34b43af779
BLAKE2b-256 2c10fd7482bfe1ac0635bf654902389c241248c335ec9f512a6d3e8a79c8a0d2

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp311-cp311-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp311-cp311-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 504c31259899958eb14d210a4e9a239f4e8c27d74c18808741de5e4151035991
MD5 23dff5906c494b7d0acee131c7d1d0bf
BLAKE2b-256 32cc00431209f708a24722d8ada8cb682dddabc74a8c1bbce2c3b0004c1b1d02

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: kiss_icp-0.0.13-cp310-cp310-win_amd64.whl
  • Upload date:
  • Size: 271.8 kB
  • Tags: CPython 3.10, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.13

File hashes

Hashes for kiss_icp-0.0.13-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 7f6d8750235e3241751bdaece75d0a04235a23686b03f5852ddd334ed74568c9
MD5 4ee936cf3a50d2a5218ddc106dcf12ea
BLAKE2b-256 cbecebb10709b9492d3a16b91576394062aeb13bc9d34f7c774add4a2f4e81dc

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 83ee656d4f924bf07416f6cddb93474affde44ec54ccf0c4caa073b027f0ff63
MD5 503f06024da6b17ffe5951c7b1f070ec
BLAKE2b-256 7f289035e979dd20305c91b19a511fc17d76b4ec157421041b0aa764056a999e

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp310-cp310-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp310-cp310-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 b444608d9e1bbcd3ffab276e41f2d466a93db145bcc11972546a756f4891b6a1
MD5 f04b247d1ec883dfcfef1619ed68ffc5
BLAKE2b-256 1025d5631d1cded03c7a0da23536e20ae089f4fb3951084f5557349ba360d30f

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp310-cp310-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp310-cp310-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 15e0d0f1f39cdc818ae7ded89e3f12f5f7baf5e48094059489c8d8ca86080472
MD5 98b683bd3007757d9e2663f1de4b4486
BLAKE2b-256 f156f27a688b3483d88bc725a429c2c452dfeab896540da0b0158b2e3bfbf22c

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp39-cp39-win_amd64.whl.

File metadata

  • Download URL: kiss_icp-0.0.13-cp39-cp39-win_amd64.whl
  • Upload date:
  • Size: 271.8 kB
  • Tags: CPython 3.9, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.13

File hashes

Hashes for kiss_icp-0.0.13-cp39-cp39-win_amd64.whl
Algorithm Hash digest
SHA256 b890c20d43bba138739cf0623a4c8668127046f996768fedd4b2ccc81a83ea42
MD5 4d0e1d7b7a826f7e8236d2af9794ddb1
BLAKE2b-256 2b1512f94e062e30eefc1487ed9ded9dc2cdf2c826f38f511ac6f09e55942c37

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 39cf12555ccec79ea4f60b438383c2c0fcec5211636e32423f8b1451c2f94c08
MD5 2b8da70dd18b1b85be288fd8f35c4501
BLAKE2b-256 2b19d0d2dcf9eace1d4c15df38e9c4c3c70da1c3156b095e2e69cd2ea0db09bf

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp39-cp39-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp39-cp39-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 eb3590825340c5b046cb3346a3462d05f446ebf2f92270452fdd02669bffa7ac
MD5 291d959ff9ffe6b4c4ca10f18cc77410
BLAKE2b-256 1907b01dbf38e9fa6dd7cbc7ce5f47bf4ef6f7e1eb61a42f83f21f4874fdd83a

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp39-cp39-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp39-cp39-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 3179697beefa6fea2c7930263a84a500eb1c002340e349d147a7651463154021
MD5 8ed5c403cf055fcbb0a7ecd0ac16e384
BLAKE2b-256 4bd10ecbff568cb45c40e63a207fbbf6bb9b8d733c6ceb044a1337b435e02121

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp38-cp38-win_amd64.whl.

File metadata

  • Download URL: kiss_icp-0.0.13-cp38-cp38-win_amd64.whl
  • Upload date:
  • Size: 271.7 kB
  • Tags: CPython 3.8, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.13

File hashes

Hashes for kiss_icp-0.0.13-cp38-cp38-win_amd64.whl
Algorithm Hash digest
SHA256 6d793cda86570cdac617d5f7019c833b538ff8c90800554cc6509f751fd4f7f3
MD5 e62bb6d34d5f7e770ac0e64398ed6f36
BLAKE2b-256 9f08683762f82e6ea9e19ee0d8dfb9f27d3508aa5ebd84d727ea5d8e17873679

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 808b949b3059b00c6e1759e61f74e318cd2eba7b89b0e35ba397cdbd68202606
MD5 1c380f61fa53c619e1fa99c5a01a0cd6
BLAKE2b-256 22b92e70d388104acd6f1e37b2e0aaec0954d36bea2605e89d6334cd985d785b

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp38-cp38-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp38-cp38-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 da8400ea0c0b6fa4f837fa449bcdbb32aeaa86c385f8f72ee361662c85ff7727
MD5 602536d14a1a564036f9e8be981c0fd8
BLAKE2b-256 4565697b5d870e73da6332113b4bae6bc2be57afac524c179b356401be2bf6bf

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp38-cp38-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp38-cp38-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 ca4e29da8fcce696c5f8ce015b3c3b06f727788e39648fe378edae7b8f7e41f3
MD5 12d35f4e2e1d2966a3b04957f86ba507
BLAKE2b-256 93b219f44bb83e6e644f4fd10a0292f033338d53df5e80ace95852dbe2ed724f

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp37-cp37m-win_amd64.whl.

File metadata

  • Download URL: kiss_icp-0.0.13-cp37-cp37m-win_amd64.whl
  • Upload date:
  • Size: 271.8 kB
  • Tags: CPython 3.7m, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.13

File hashes

Hashes for kiss_icp-0.0.13-cp37-cp37m-win_amd64.whl
Algorithm Hash digest
SHA256 b3e3437864d7b0e57585d620a16485f3ec9eefbf1b43a7af7efea6651fbf5d70
MD5 0ab0b2612d249dbeb58f1c41323fe614
BLAKE2b-256 a756b3867b55fda86ac357af821fde2cd6eff6ee3081485af5c7050175e3b3c2

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 15e9cd063f99c5fad9c81991c99fd0936301985783b47b34cba55556a52e7c52
MD5 d5ad73c2254fb323196dbcf6ec1c0dd1
BLAKE2b-256 30a62d3ac88080d795b6412150b001b716a5ae81af3631b782695c699b3c449f

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp37-cp37m-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp37-cp37m-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 93ac666c82c2ed836358cb4bdf8be72b713c21ecd08444eb2ab5f88e142b43df
MD5 aacdb947addc094d064997ca0f8e20fc
BLAKE2b-256 a9d99a6da595e494e8a6325382c2c0385690b3cb30ac791ebbae7ff93e85b00a

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp36-cp36m-win_amd64.whl.

File metadata

  • Download URL: kiss_icp-0.0.13-cp36-cp36m-win_amd64.whl
  • Upload date:
  • Size: 271.6 kB
  • Tags: CPython 3.6m, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.13

File hashes

Hashes for kiss_icp-0.0.13-cp36-cp36m-win_amd64.whl
Algorithm Hash digest
SHA256 65f9c225626582a9f58b7b74e12cbd0b0481f7e12f5b1fdaf261052dab9be624
MD5 ff6fb9a98f3b85e8c8a20703db983661
BLAKE2b-256 d22dc660b4f869266d0797b5f1f451c27db3c3134df5971498aa994a12ea81a9

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 55f52cddcf543bf17a149368dea88d0def86c58934926c08c15e0904b4d12b08
MD5 37173eaede0089f7a8075d023a531e76
BLAKE2b-256 71f68e8df313e4f25f037cafa5192018b6dd0b57d83cbf34fd9913efb4385b03

See more details on using hashes here.

File details

Details for the file kiss_icp-0.0.13-cp36-cp36m-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for kiss_icp-0.0.13-cp36-cp36m-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 16442d3cb5c7e89705b02016dacf8ff68e998aeacff82e61ba690a17e24e9872
MD5 167b0d51c4c055881ea3a99a66b30457
BLAKE2b-256 97e1c6952b9bbbafb11a3be95e4d2402d47f6e327ae84a4852d0a096b1308c39

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