⚠⚠ This repository has been archived as is it is no longer maintained. Please see https://github.com/strawlab/python-pcl/issues/395 for details. ⚠⚠

.. raw:: html

<a href="https://github.com/strawlab/python-pcl">
<img style="position: absolute; top: 0; right: 0; border: 0;" src="https://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub"></a>

<script type="text/javascript">
  var _gaq = _gaq || [];
  _gaq.push(['_setAccount', 'UA-3707626-7']);
  _gaq.push(['_trackPageview']);
  (function() {
    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
  })();
</script>

<div align="center"><img src="https://github.com/strawlab/python-pcl/raw/master/docs/image/pcl_logo_958x309.png" width="309"/></div>

Introduction

This is a small python binding to the pointcloud <http://pointclouds.org/>_ library. Currently, the following parts of the API are wrapped (all methods operate on PointXYZ) point types

I/O and integration; saving and loading PCD files
segmentation
SAC
smoothing
filtering
registration (ICP, GICP, ICP_NL)

The code tries to follow the Point Cloud API, and also provides helper function for interacting with NumPy. For example (from tests/test.py)

.. code-block:: python

import pcl
import numpy as np
p = pcl.PointCloud(np.array([[1, 2, 3], [3, 4, 5]], dtype=np.float32))
seg = p.make_segmenter()
seg.set_model_type(pcl.SACMODEL_PLANE)
seg.set_method_type(pcl.SAC_RANSAC)
indices, model = seg.segment()

or, for smoothing

.. code-block:: python

import pcl
p = pcl.load("C/table_scene_lms400.pcd")
fil = p.make_statistical_outlier_filter()
fil.set_mean_k (50)
fil.set_std_dev_mul_thresh (1.0)
fil.filter().to_file("inliers.pcd")

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

.. code-block:: python

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 <https://github.com/strawlab/python-pcl/tree/master/examples>, and in the unit tests <https://github.com/strawlab/python-pcl/blob/master/tests/test.py>.

This work was supported by Strawlab <http://strawlab.org/>_.

Requirements

This release has been tested on Linux Ubuntu 16.04 with

Python 2.7.6, 3.5.x
pcl 1.7.2(apt install)
Cython <= 0.25.2

This release has been tested on Linux Ubuntu 18.04 with

Python 2.7.6, 3.5.x
pcl 1.8.1(apt install)
Cython <= 0.25.2

and MacOS with

Python 2.7.6, 3.5.x
pcl 1.9.1(use homebrew)
Cython <= 0.25.2

and Windows with

(Miniconda/Anaconda) - Python 3.4
pcl 1.6.0(VS2010)
Cython <= 0.25.2
Gtk+

and Windows with

(Miniconda/Anaconda) - Python 3.5
pcl 1.8.1(VS2015)
Cython <= 0.25.2
Gtk+

and Windows with

(Miniconda/Anaconda) - Python 3.6
pcl 1.8.1(VS2017[Priority High]/VS2015[not VS2017 Install])
Cython == 0.25.2
Gtk+

Installation

Linux(Ubuntu)

before Install module ^^^^^^^^^^^^^^^^^^^^^

Ubuntu16.04/18.04 (use official package)

    1. Install PCL Module.

    .. code-block:: bash

        $ sudo apt-get update -y

        $ sudo apt-get install libpcl-dev -y

        Reference `here <https://packages.ubuntu.com/search?keywords=libpcl-dev>`_.

PCL 1.8.x/1.9.x and Ubuntu16.04/18.04(build module)([CI Test Timeout])

    1. Build Module

        Reference `here <https://askubuntu.com/questions/916260/how-to-install-point-cloud-library-v1-8-pcl-1-8-0-on-ubuntu-16-04-2-lts-for>`_.

MacOSX

before Install module ^^^^^^^^^^^^^^^^^^^^^

    Case1. use homebrew(PCL 1.9.1 - 2018/12/25 current)

    1. Install PCL Module.

        .. code-block:: bash

        $ brew tap homebrew/science

        $ brew install pcl

    Case1. use old homebrew(PCL 1.8.1 - 2017/11/13 current)

    1. Check git log.

        .. code-block:: bash

        $ cd /usr/local/Library/Formula

        $ git log ...

    2. git checkout (target hash) pcl.rb

        .. code-block:: bash

        write after.

Warning:

Current Installer (2017/10/02) Not generated pcl-2d-1.8.pc file.(Issue #119)

Reference PointCloudLibrary Issue.

   `Pull request 1679 <https://github.com/PointCloudLibrary/pcl/pull/1679>`_.

   `Issue 1978 <https://github.com/PointCloudLibrary/pcl/issues/1978>`_.

circumvent:

copy travis/pcl-2d-1.8.pc file to /usr/local/lib/pkgconfig folder.

Windows

Using pip with a precompiled wheel ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

This is the simpliest method on windows. The wheel contains the PCL binaries _ 
and thus you do not need to install the original PCL library.

1. Go in the history on the `appveyor page <https://ci.appveyor.com/project/Sirokujira/python-pcl-iju42/history>`_
2. Click on the last successful revision (green) and click on the job corresponding to your python version 
3. Go in the artfacts section for that job and download the wheel (the file with extension whl)
4. In the command line, move to your download folder and run the following command (replacing XXX by the right string)

.. code-block:: bat

        pip install python_pcl-XXX.whl

Compiling the binding from source ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If the method using the procompiled wheel does not work you can compile the binding from the source.

before Install module


        Case1. use PCL 1.6.0 

            `Windows SDK 7.1 <http://www.microsoft.com/download/en/details.aspx?id=8279>`_

            `PCL All-In-One Installer <http://pointclouds.org/downloads/windows.html>`_

                `32 bit <http://sourceforge.net/projects/pointclouds/files/1.6.0/PCL-1.6.0-AllInOne-msvc2010-win32.exe/download>`_

                `64 bit <http://sourceforge.net/projects/pointclouds/files/1.6.0/PCL-1.6.0-AllInOne-msvc2010-win64.exe/download>`_

            OpenNI2[(PCL Install FolderPath)\\3rdParty\\OpenNI\\OpenNI-(win32/x64)-1.3.2-Dev.msi]

        Case2. use 1.8.1/1.9.1

            `Visual Studio 2015 C++ Compiler Tools(use Python 2.7/3.5/3.6/3.7) <https://www.visualstudio.com/vs/older-downloads/>`_ 

            `Visual Studio 2017 C++ Compiler Tools(use Python 3.6.x/3.7.x) <http://landinghub.visualstudio.com/visual-cpp-build-tools>`_ 

            `PCL All-In-One Installer <https://github.com/PointCloudLibrary/pcl/releases/>`_

                1.8.1

                `Visual Studio 2015 - 32 bit <https://github.com/PointCloudLibrary/pcl/releases/download/pcl-1.8.1/PCL-1.8.1-AllInOne-msvc2015-win32.exe>`_

                `Visual Studio 2017 - 32 bit <https://github.com/PointCloudLibrary/pcl/releases/download/pcl-1.8.1/PCL-1.8.1-AllInOne-msvc2017-win32.exe>`_

                `Visual Studio 2015 - 64 bit <https://github.com/PointCloudLibrary/pcl/releases/download/pcl-1.8.1/PCL-1.8.1-AllInOne-msvc2015-win64.exe>`_

                `Visual Studio 2017 - 64 bit <https://github.com/PointCloudLibrary/pcl/releases/download/pcl-1.8.1/PCL-1.8.1-AllInOne-msvc2017-win64.exe>`_

                1.9.1

                `Visual Studio 2017 - 32 bit <https://github.com/PointCloudLibrary/pcl/releases/download/pcl-1.9.1/PCL-1.9.1-AllInOne-msvc2017-win32.exe>`_

                `Visual Studio 2017 - 64 bit <https://github.com/PointCloudLibrary/pcl/releases/download/pcl-1.9.1/PCL-1.9.1-AllInOne-msvc2017-win64.exe>`_

            OpenNI2[(PCL Install FolderPath)\\3rdParty\\OpenNI2\\OpenNI-Windows-(win32/x64)-2.2.msi]

        Common setting

            `Windows Gtk+ Download <http://www.tarnyko.net/dl/gtk.htm>`_                            Download file unzip. Copy bin Folder to pkg-config Folder
                Download file unzip. Copy bin Folder to pkg-config Folder

                or execute powershell file [Install-GTKPlus.ps1].

`Python Version use VisualStudio Compiler <https://wiki.python.org/moin/WindowsCompilers>`_

set before Environment variable

1. PCL_ROOT

.. code-block:: bat

    set PCL_ROOT=(PCL Install/Build_Binary FolderPath)

2. PATH

.. code-block:: bat

    (pcl 1.6.0)
    set PATH=%PCL_ROOT%/bin/;%OPEN_NI_ROOT%/Tools;%VTK_ROOT%/bin;%PATH%

    (pcl 1.8.1/1.9.1)
    set PATH=%PCL_ROOT%/bin/;%OPEN_NI2_ROOT%/Tools;%VTK_ROOT%/bin;%PATH%

Common setting

pip module install.

.. code-block:: none

pip install --upgrade pip

pip install cython

pip install numpy

install python module

.. code-block:: none

python setup.py build_ext -i

python setup.py install

install python-pcl with conda (solved)

.. code-block:: none

conda create -n ipk # create a new conda env. 
conda activate ipk  # activate env.

conda update -n base -c defaults conda # update conda

conda config --add channels conda-forge # add conda-forge channels
conda install -c sirokujira python-pcl # pcl installation
conda install -c jithinpr2 gtk3 # Gtk+ Gui dependency
conda install -y ipython #  install ipython
conda install -y jupyter # install jupyter

After that, run jupyter notebook or ipython shell to test pcl installation.

Build & Test Status

windows(1.6.0/1.8.1/1.9.1)

.. image:: https://ci.appveyor.com/api/projects/status/w52fee7j22q211cm/branch/master?svg=true :target: https://ci.appveyor.com/project/Sirokujira/python-pcl-iju42

Mac OSX(1.9.1)/Ubuntu16.04(1.7.2)

.. image:: https://travis-ci.org/strawlab/python-pcl.svg?branch=master
    :target: https://travis-ci.org/strawlab/python-pcl

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

Read the docs <https://python-pcl-fork.readthedocs.io/en/latest/>_.

For deficiencies in this documentation, please consult the PCL API docs <http://docs.pointclouds.org/trunk/index.html>, and the PCL tutorials <http://pointclouds.org/documentation/tutorials/>.

strawlab / python-pcl

readme

Introduction

Requirements

Installation

Linux(Ubuntu)

MacOSX

Windows

Common setting

Build & Test Status

A note about types

API Documentation