ICP-Lab / README.md
devkumarhf's picture
docs: link the complementary engineering workbench and collection
b40a097 verified
|
Raw History Blame Contribute Delete
3.8 kB
metadata
title: ICP Lab - 3D Point Cloud Alignment
emoji: 🎯
colorFrom: green
colorTo: gray
sdk: static
app_file: index.html
pinned: false
license: mit
tags:
  - robotics
  - computer-vision
  - point-cloud
  - education
short_description: Explore 3D point-cloud alignment step by step.

ICP Lab: 3D point-cloud alignment

An interactive, CPU-friendly educational demonstration of rigid point-to-point Iterative Closest Point (ICP), inspired by Dev Kumar's 3D Point Cloud Registration with ICP project. It generates a synthetic asymmetric surface, applies a known perturbation and lets visitors inspect the iterative alignment.

Drag to rotate the 3D view. Adjust rotation, translation and Gaussian noise; run the algorithm or advance one iteration at a time. The chart shows nearest-neighbour root mean square error (RMSE) in arbitrary units. The UI uses a perspective-projected view, while ICP itself fits a full 3D rigid transformation.

Method and limits

Each iteration finds Euclidean nearest-neighbour correspondences by brute force, then estimates the least-squares rigid transformation via Horn's unit-quaternion formulation. This implementation is a new, independent educational adaptation, not an exact execution of the source notebook or Open3D. It does not benchmark hardware, reconstruct a real scene, or claim globally optimal alignment. ICP is local: initialization, point-cloud geometry and noise can produce incorrect correspondences and local minima. RMSE here is measured against the current nearest neighbours, not a guarantee of recovery of the true pose.

All points are generated in the browser; the demo requires no account, GPU, model downloads, or server-side inference. No data is uploaded. No libraries are needed.

Run locally

Serve the directory with any static server; for example:

python3 -m http.server 8000

Then open http://localhost:8000. For an optional algorithm check, run node test.mjs (Node.js 18+).

Publish as a Hugging Face Space

Create a Static Space and upload the contents of this folder at its root, preserving README.md, index.html, style.css, app.js, and icp.js. The YAML header configures the Space. No paid hardware is needed for a static Space. Inspect the finished public page before sharing.

Further reading

License

The demo code is available under the MIT License. The referenced original project has its own MIT license.

Related engineering work

Explore the Engineering Workbench for twelve source-linked projects, live RST synthesis and the original UR7e training-log explorer. The Hugging Face collection connects the interactive labs and documented data.