Skip to content
Python bindings to the pointcloud library (pcl)
Branch: master
Clone or download
Pull request Compare This branch is 172 commits ahead, 54 commits behind strawlab:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
examples
pcl
tests
.gitignore
.scrutinizer.yml
.travis.yml
.zenodo.json
CITATION.cff
HACKING.rst
LICENSE
Makefile
commit-to-gh-pages.sh
hash-tree.py
pcl_logo.png
readme.rst
setup.py

readme.rst

Travis Quality-score Coverage

Introduction

This is a small python binding to the pointcloud library. Currently, the following parts of the API are wrapped (all methods operate on PointXYZRGB) point types

  • I/O and integration; saving and loading PCD files
  • segmentation
  • SAC
  • smoothing
  • filtering

The code tries to follow the Point Cloud API, and also provides helper function for interacting with NumPy.

Point clouds can be viewed as NumPy arrays, so modifying them is possible using all the familiar NumPy functionality:

import numpy as np
import pcl
p = pcl.PointCloud(10)  # "empty" point cloud
a = np.asarray(p)       # NumPy view on the cloud
a[:] = 0                # fill with zeros
print(p[3])             # prints (0.0, 0.0, 0.0)
a[:, 0] = 1             # set x coordinates to 1
print(p[3])             # prints (1.0, 0.0, 0.0)

More samples can be found in the examples directory, and in the unit tests.

This library is developed for use in our Project Patty, see this repository for more interesting examples. Also, the reading and writing of LAS files is implemented there.

This work was supported by Strawlab and the Netherlands eScience Center

Requirements

This release has been tested on Linux Mint 17 with

  • Python 2.7.9
  • pcl 1.7.2
  • Cython 0.22

A note about types

Point Cloud is a heavily templated API, and consequently mapping this into Python using Cython is challenging.

It is written in Cython, and implements enough hard bits of the API (from Cythons perspective, i.e the template/smart_ptr bits) to provide a foundation for someone wishing to carry on.

API Documentation

For API documentation, look at our gh-pages branch For deficiencies in this documentation, please consult the PCL API docs, and the PCL tutorials.

Pointcloud class

.. automodule:: pcl
   :members:
   :undoc-members:
   :imported-members:


Registration functions

.. automodule:: pcl.registration
   :members:
   :undoc-members:

Boundary detection

.. automodule:: pcl.boundaries
   :members:
   :undoc-members:

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.