Skip to main content

Simple yet effective 3D LiDAR-Odometry registration pipeline

Project description

KISS-ICP



Demo   •   Install   •   ROS 2   •   ROS Demo   •   Paper   •   Contact Us

KISS-ICP is a LiDAR Odometry pipeline that just works on most of the cases withouth tunning any parameter.

KISS-ICP Demo


Install

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]"

Running the system

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 Python API (developer mode)

If you plan to modify the code then you need to setup the dev dependencies, luckily, the only real requirements are a modern C++ compiler and the pip package manager, nothing else!, in Ubuntu-based systems 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
make editable

Install Python API (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

Citation

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

@article{vizzo2023ral,
  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   = {IEEE Robotics and Automation Letters (RA-L)},
  pages     = {1029--1036},
  doi       = {10.1109/LRA.2023.3236571},
  volume    = {8},
  number    = {2},
  year      = {2023},
  codeurl   = {https://github.com/PRBonn/kiss-icp},
}

Contributing

We envision KISS-ICP as a comunity-driven project, we love to see how the project is growing thanks to the contributions from the comunity. We would love to see your face in the list below, just open a Pull Request!

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.4.0.tar.gz (33.9 kB view hashes)

Uploaded Source

Built Distributions

kiss_icp-0.4.0-cp312-cp312-win_amd64.whl (330.5 kB view hashes)

Uploaded CPython 3.12 Windows x86-64

kiss_icp-0.4.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (409.0 kB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ x86-64

kiss_icp-0.4.0-cp312-cp312-macosx_11_0_arm64.whl (310.8 kB view hashes)

Uploaded CPython 3.12 macOS 11.0+ ARM64

kiss_icp-0.4.0-cp312-cp312-macosx_10_14_x86_64.whl (369.8 kB view hashes)

Uploaded CPython 3.12 macOS 10.14+ x86-64

kiss_icp-0.4.0-cp311-cp311-win_amd64.whl (330.6 kB view hashes)

Uploaded CPython 3.11 Windows x86-64

kiss_icp-0.4.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (410.5 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

kiss_icp-0.4.0-cp311-cp311-macosx_11_0_arm64.whl (311.0 kB view hashes)

Uploaded CPython 3.11 macOS 11.0+ ARM64

kiss_icp-0.4.0-cp311-cp311-macosx_10_14_x86_64.whl (368.5 kB view hashes)

Uploaded CPython 3.11 macOS 10.14+ x86-64

kiss_icp-0.4.0-cp310-cp310-win_amd64.whl (329.7 kB view hashes)

Uploaded CPython 3.10 Windows x86-64

kiss_icp-0.4.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (409.2 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

kiss_icp-0.4.0-cp310-cp310-macosx_11_0_arm64.whl (309.8 kB view hashes)

Uploaded CPython 3.10 macOS 11.0+ ARM64

kiss_icp-0.4.0-cp310-cp310-macosx_10_14_x86_64.whl (367.1 kB view hashes)

Uploaded CPython 3.10 macOS 10.14+ x86-64

kiss_icp-0.4.0-cp39-cp39-win_amd64.whl (327.3 kB view hashes)

Uploaded CPython 3.9 Windows x86-64

kiss_icp-0.4.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (409.5 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

kiss_icp-0.4.0-cp39-cp39-macosx_11_0_arm64.whl (309.9 kB view hashes)

Uploaded CPython 3.9 macOS 11.0+ ARM64

kiss_icp-0.4.0-cp39-cp39-macosx_10_14_x86_64.whl (367.3 kB view hashes)

Uploaded CPython 3.9 macOS 10.14+ x86-64

kiss_icp-0.4.0-cp38-cp38-win_amd64.whl (329.7 kB view hashes)

Uploaded CPython 3.8 Windows x86-64

kiss_icp-0.4.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (409.3 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

kiss_icp-0.4.0-cp38-cp38-macosx_11_0_arm64.whl (309.8 kB view hashes)

Uploaded CPython 3.8 macOS 11.0+ ARM64

kiss_icp-0.4.0-cp38-cp38-macosx_10_14_x86_64.whl (367.1 kB view hashes)

Uploaded CPython 3.8 macOS 10.14+ x86-64

kiss_icp-0.4.0-cp37-cp37m-win_amd64.whl (330.3 kB view hashes)

Uploaded CPython 3.7m Windows x86-64

kiss_icp-0.4.0-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (410.8 kB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.17+ x86-64

kiss_icp-0.4.0-cp37-cp37m-macosx_10_14_x86_64.whl (366.1 kB view hashes)

Uploaded CPython 3.7m macOS 10.14+ x86-64

Supported by

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