• This repository has been archived on 31/Dec/2023
  • Stars
    star
    2,011
  • Rank 23,025 (Top 0.5 %)
  • Language Cython
  • License
    Other
  • Created over 12 years ago
  • Updated 11 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Python bindings to the pointcloud library (pcl)

⚠⚠ A new maintainer for this library is sought. Please see #395. ⚠⚠

Fork me on GitHub

Introduction

This is a small python binding to the pointcloud 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)

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

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:

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 work was supported by Strawlab.

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.
$ 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.

MacOSX

before Install module

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

  1. Install PCL Module.

    $ brew tap homebrew/science

    $ brew install pcl

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

  1. Check git log.

    $ cd /usr/local/Library/Formula

    $ git log ...

  2. git checkout (target hash) pcl.rb

    write after.

Warning:

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

Reference PointCloudLibrary Issue.

Pull request 1679.

Issue 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
  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)
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

Β Β Β Β Β Β Β Β Β Β Β  PCL All-In-One Installer

Β Β Β Β Β Β Β Β Β Β Β  32 bit

64 bit

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)

Β Β Β Β Β Β Β Β Β Β Β  Visual Studio 2017 C++ Compiler Tools(use Python 3.6.x/3.7.x)

Β Β Β Β Β Β Β Β Β Β Β  PCL All-In-One Installer

1.8.1

Β Β Β Β Β Β Β Β Β Β Β  Visual Studio 2015 - 32 bit

Β Β Β Β Β Β Β Β Β Β Β  Visual Studio 2017 - 32 bit

Β Β Β Β Β Β Β Β Β Β Β  Visual Studio 2015 - 64 bit

Β Β Β Β Β Β Β Β Β Β Β  Visual Studio 2017 - 64 bit

1.9.1

Β Β Β Β Β Β Β Β Β Β Β  Visual Studio 2017 - 32 bit

Β Β Β Β Β Β Β Β Β Β Β  Visual Studio 2017 - 64 bit

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

Β Β Β Β Β Β Β Β Common setting

Windows Gtk+ Download Β Β Β Β Β Β Β Β Β Β Β  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

set before Environment variable
  1. PCL_ROOT
    set PCL_ROOT=(PCL Install/Build_Binary FolderPath)

2. PATH
(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

  1. pip module install.
pip install --upgrade pip

pip install cython

pip install numpy
  1. install python module
python setup.py build_ext -i

python setup.py install
  1. install python-pcl with conda (solved)

-> 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)

https://ci.appveyor.com/api/projects/status/w52fee7j22q211cm/branch/master?svg=true

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

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

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.

For deficiencies in this documentation, please consult the PCL API docs, and the PCL tutorials.

More Repositories

1

MultiCamSelfCal

multiple camera self calibration Toolbox
MATLAB
189
star
2

best

Bayesian estimation supersedes the t test
Python
145
star
3

pymvg

Python Multi-View Geometry
Python
88
star
4

pyopy

Python bindings to interesting matlab libraries for data analysis
Python
85
star
5

adskalman-rs

Kalman filter implementation in Rust
Rust
60
star
6

flydra

live, low-latency markerless multi-camera 3D animal tracking system
Python
57
star
7

strand-braid

Live, low-latency 2D and 3D tracking from single or multiple high-speed cameras
Rust
49
star
8

cam-geom

πŸ“· πŸ“ Geometric models of cameras for photogrammetry
Rust
45
star
9

iana-time-zone

Rust crate to get the IANA time zone for the current system
Rust
38
star
10

pylon-cxx

Rust wrapper of the Pylon libraries for Basler cameras
Rust
25
star
11

less-avc

less Advanced Video Coding (H.264) encoding
Rust
23
star
12

opengl-hz

OpenGL seen through Hartley-Zisserman camera model
C++
21
star
13

bag2hdf5

Convert ROS bag files to HDF5
Python
19
star
14

freemovr_engine

perspective-correct VR for freely moving animals engine
Python
17
star
15

ros_sql

Log arbitrary ROS messages to an SQL database
Python
16
star
16

triggerbox

camera triggering for synchronized multi-camera setups
Rust
16
star
17

py_amira_file_reader

Python
15
star
18

camera_aravis

ROS package for Aravis GigEVision library
C++
12
star
19

ros_comm

Python
11
star
20

py4science-vbc

repository for Py4Science VBC website and talks
Python
11
star
21

opencv-ros-camera

Geometric models of OpenCV/ROS cameras for photogrammetry
Rust
11
star
22

drosophila_eye_map

Viewing directions (eye map) of each Drosophila ommatidium
Python
9
star
23

flymad

system for targeting freely walking flies (Drosophila) with lasers
Python
9
star
24

tilta-n2-control

bare-minimum firmware to control Tilta Nucleus Nano 2 motor
C
7
star
25

arduino-udev

Get and set information by querying serial devices
Python
7
star
26

navigation

C++
7
star
27

image_pipeline

mirror of ROS package with build fixes
C++
6
star
28

cgkit1

fork of the Python cgkit 1.x library
Cython
6
star
29

ros-freeze

convert entire python-based ROS package to a python source or binary distribution
Python
5
star
30

nalgebra-lapack

Outdated. See https://github.com/rustsim/nalgebra/tree/dev/nalgebra-lapack
Rust
5
star
31

pykmlocal

Python wrapper for fast K-means library by Kanungo, Mount, Netanyahu, Piatko, Silverman, and Wu
C++
5
star
32

lagtest-old

How slow is your display?
C++
4
star
33

fsee

fly-eye view and neural processing simulation code
Python
4
star
34

perception_pcl

mirror of ROS package with our local changes
C++
3
star
35

strawlab-ansible-roles

recipes to install strawlab software
Shell
3
star
36

joystick_drivers

mirror of ROS stack with our local changes
Python
3
star
37

msectrax

source code and PCB files for "Millisecond insect tracking system"
Jupyter Notebook
3
star
38

cython_ipp

Cython definitions for the Intel Integrated Performance Primitives (Intel IPP) library
Python
3
star
39

asymmetric-motion

models of asymmetric motion processing in the fly
Python
3
star
40

flystockdb

A free web-database for keeping Drosophila melanogaster stocks.
JavaScript
2
star
41

fview_SphereTrax

Python
2
star
42

visualization_common

mirror of ROS package with our local changes
C++
2
star
43

laser_pan_tilt

laser-pan-tilt
Python
2
star
44

machine-vision-formats

Type definitions for working with data from machine vision cameras
Rust
2
star
45

image_transport_plugins

mirror of ROS package with build fixes
C++
2
star
46

dlt

DLT (direct linear transform) algorithm for camera calibration
Rust
2
star
47

lstsq

Return the least-squares solution to a linear matrix equation (rustlang, nalgebra)
Rust
2
star
48

flo

Fast Lock-On (FLO) tracking
Rust
1
star
49

axum-token-auth

middleware to authenticate requests to axum
Rust
1
star
50

strawlab_freeflight_experiments

Python
1
star
51

neuron-catalog

A simple web database for keeping track of neurons.
JavaScript
1
star
52

ethotimer

Rust
1
star
53

rosgobject

Python
1
star
54

roschart

Python
1
star
55

environment_monitor

C++
1
star
56

postcluster

postcluster
MATLAB
1
star
57

image_common

mirror of ROS package with our local changes
C++
1
star
58

apriltag-sys

Rust
1
star
59

pm21-tiger

PM-21: Python fΓΌr die Biowissenschaften. WiSe 2022-2023. Uni Freiburg.
Jupyter Notebook
1
star
60

strawlab_styleguide

scientific communication in the Straw Lab style
Python
1
star
61

ros_robot_model

fork of ROS stack "robot_model"
C++
1
star
62

braincode

supplemental data and code for the braincode paper
Python
1
star
63

phidgets

phidgets utility classes
Python
1
star
64

microfview

A lighter, pure opencv rewrite of fview
Python
1
star
65

dlt-april-cal

Demonstrate the use of April Tags to perform a camera calibration
Jupyter Notebook
1
star
66

light_measurement

utilities for measuring light
Python
1
star
67

wm01-tiger

course material for WM-01, Summer Semester 2022 (year of the Tiger), Faculty of Biology, University of Freiburg
Jupyter Notebook
1
star
68

common_rosdeps

mirror of ROS package with our local changes
1
star
69

freemovr

virtual reality for freely moving animals
1
star
70

ros_flydra

ROS support for flydra
Python
1
star
71

lagtest

how slow is your display?
Python
1
star
72

pylibusb

Python libusb-0.1 ctypes wrapper
Python
1
star
73

nextgen-camera-users

next generation camera software from the Straw Lab
1
star
74

stage

mirror of ROS package with our local changes
C++
1
star
75

bullet

mirror of ROS package with our local changes
C++
1
star
76

fsee_utils

Thin wrapper for using fsee in another process, another host, or another language (Matlab)
Python
1
star
77

strawlab_arduino_libs

C++
1
star
78

pretty-print-nalgebra

Rust
1
star
79

flo-hardware

build instructions and manual for the FLO BYO-camera insect tracking/filming setup
G-code
1
star