[Documentation] [TitleIndex] [WordIndex

Package Summary

PCL - Point Cloud Library: a comprehensive open source library for n-D Point Clouds and 3D geometry processing. The library contains numerous state-of-the art algorithms for: filtering, feature estimation, surface reconstruction, registration, model fitting and segmentation, etc.

This is the unstable package! The used namespace is pcl17.



The Point Cloud Library (PCL) is a stand-alone C++ library for 3D point cloud processing. You can learn more about PCL by visiting its website, pointclouds.org. The documentation on ROS.org will help you get started using PCL in your ROS applications.

In particular, if you're just getting started with PCL in ROS, we encourage you to make use of the following resources:

For new users of PCL, those resources will provide you with most of the information you'll need to get familiar with the library. Additional information pertaining to using PCL in your ROS applications can be found here on this wiki.

Compilation and update

The makefile in this package checkouts the original PCL repository (https://github.com/PointCloudLibrary/pcl.git) and patches the source code, to be compatible with ROS and to have his own namespace (pcl17). The revision is coded in the Makefile. This revision is tested (It should compile, but it is still unstable.) with the ROS package and updated continuously. You can use the argument r to overwrite this presetting, e.g. r=8026 or r=head. You can update the used revision to the presetted revision with

make GIT_UP

,to a specific revision with


and to the head with

make GIT_UP r=head

Using PCL in ROS

For information about how to use PCL's ROS-specific data types and how to publish and subscribe to point cloud data, please consult the PCL/ROS overview.

Using KinfuLS (Kinect Fusion Large Scale) in ROS

You can checkout a experimental KinfuLS-ROS-Wrapper from

svn http://fsstud.is.uni-due.de/svn/ros/is/kinfu/

You have to launch openni and run kinfuLS from the kinfu package. The rendered model image is published as /camera/kinfuLS/depth. Please make sure, that you have activated the compilation of kinfu in pcl17/Makefile:


and that you are using a compatible PCL revision (see the wrapper's svn log):

roscd pcl17 && make GIT_UP r=5aac0cbe8f4a82df18a13ca554f949b9bee848f8


You can find numerous code examples on PCL's tutorials page.

For examples of how to include PCL code in a ROS node, please refer to the Tutorials page.


For a detailed reference of PCL's classes and functions, please consult the online API documentation.

For a reference guide to PCL's ROS-specific APIs, see the API documentation for the pcl_ros package.

Using pre compiled PCL 1.7

To use the pcl 1.7 standalone pre compiled follow this link

2024-06-22 13:13