# pointcloudlibrary/pcl architecture

> Architecture diagram of the GitHub repository pointcloudlibrary/pcl, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pointcloudlibrary/pcl
- Repository: https://github.com/pointcloudlibrary/pcl

## Overview

PCL is a standalone library for 2D/3D image and point-cloud processing. A typical user supplies point-cloud or sensor data, processes it through representation, search and analysis algorithms, then consumes results in applications or visualization. The tree also shows distinct algorithm domains and GPU, stereo, and sensor capabilities. Most algorithm relationships are inferred from product structure rather than inspected call sites, so those links are dashed; the OpenNI device-manager relationship is visible in the sampled source.

Main entry points: [`common/include/pcl/point_cloud.h`](https://github.com/pointcloudlibrary/pcl/blob/master/common/include/pcl/point_cloud.h) (Cloud data model), [`features`](https://github.com/pointcloudlibrary/pcl/tree/master/features) (Feature extraction), [`io`](https://github.com/pointcloudlibrary/pcl/tree/master/io) (Data I/O), [`io/src/openni2/openni2_device_manager.cpp`](https://github.com/pointcloudlibrary/pcl/blob/master/io/src/openni2/openni2_device_manager.cpp) (OpenNI2 devices)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data and I/O"]
  node_io["Data I/O"]
  node_openni["OpenNI2 devices"]
  node_openni_device["OpenNI2 device<br/>[openni2_device.h]"]
  node_realsense["RealSense devices"]
  node_cloud["Cloud data model<br/>[point_cloud.h]"]
end

subgraph group_processing["Point Processing"]
  node_common["Common operations"]
  node_filters["Cloud filters"]
  node_search["Spatial search<br/>[search.h]"]
  node_features["Feature extraction"]
  node_keypoints["Keypoint detection"]
end

subgraph group_analysis["Analysis and Modeling"]
  node_registration["Registration"]
  node_segmentation["Segmentation"]
  node_recognition["Recognition"]
  node_surface["Surface modeling"]
  node_stereo["Stereo matching"]
end

subgraph group_render["Visualization and Apps"]
  node_visualization["Visualization"]
  node_apps["User applications"]
end

subgraph group_accelerated["Specialized Processing"]
  node_gpu["GPU algorithms"]
  node_cuda["CUDA search"]
  node_ml["Machine learning"]
end

node_user(("Library user"))

node_user -.->|"supplies data"| node_io
node_io -.->|"loads clouds"| node_cloud
node_openni -->|"creates device"| node_openni_device
node_user -.->|"selects sensor"| node_openni
node_realsense -.->|"returns capture"| node_user
node_cloud -.->|"processes geometry"| node_common
node_cloud -.->|"filters points"| node_filters
node_cloud -.->|"queries neighbors"| node_search
node_search -.->|"supports estimation"| node_features
node_cloud -.->|"extracts descriptors"| node_features
node_cloud -.->|"detects points"| node_keypoints
node_features -.->|"matches features"| node_registration
node_cloud -.->|"aligns clouds"| node_registration
node_cloud -.->|"partitions points"| node_segmentation
node_features -.->|"classifies objects"| node_recognition
node_cloud -.->|"builds surfaces"| node_surface
node_cloud -.->|"matches images"| node_stereo
node_cloud -.->|"renders clouds"| node_visualization
node_user -.->|"uses tools"| node_apps
node_apps -.->|"displays results"| node_visualization
node_cloud -.->|"accelerates processing"| node_gpu
node_cloud -.->|"searches neighbors"| node_cuda
node_features -.->|"provides features"| node_ml

click node_io "https://github.com/pointcloudlibrary/pcl/tree/master/io"
click node_openni "https://github.com/pointcloudlibrary/pcl/blob/master/io/src/openni2/openni2_device_manager.cpp"
click node_openni_device "https://github.com/pointcloudlibrary/pcl/blob/master/io/include/pcl/io/openni2/openni2_device.h"
click node_realsense "https://github.com/pointcloudlibrary/pcl/blob/master/io/src/real_sense/real_sense_device_manager.cpp"
click node_cloud "https://github.com/pointcloudlibrary/pcl/blob/master/common/include/pcl/point_cloud.h"
click node_common "https://github.com/pointcloudlibrary/pcl/tree/master/common/include/pcl/common"
click node_filters "https://github.com/pointcloudlibrary/pcl/tree/master/filters"
click node_search "https://github.com/pointcloudlibrary/pcl/blob/master/search/include/pcl/search/search.h"
click node_features "https://github.com/pointcloudlibrary/pcl/tree/master/features"
click node_keypoints "https://github.com/pointcloudlibrary/pcl/tree/master/keypoints"
click node_registration "https://github.com/pointcloudlibrary/pcl/tree/master/registration"
click node_segmentation "https://github.com/pointcloudlibrary/pcl/tree/master/segmentation"
click node_recognition "https://github.com/pointcloudlibrary/pcl/tree/master/recognition"
click node_surface "https://github.com/pointcloudlibrary/pcl/tree/master/surface"
click node_stereo "https://github.com/pointcloudlibrary/pcl/tree/master/stereo"
click node_visualization "https://github.com/pointcloudlibrary/pcl/tree/master/visualization"
click node_apps "https://github.com/pointcloudlibrary/pcl/tree/master/apps"
click node_gpu "https://github.com/pointcloudlibrary/pcl/tree/master/gpu"
click node_cuda "https://github.com/pointcloudlibrary/pcl/blob/master/cuda/nn/organized_neighbor_search.hpp"
click node_ml "https://github.com/pointcloudlibrary/pcl/tree/master/ml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_io,node_openni,node_openni_device,node_realsense,node_cloud,node_user toneBlue
class node_common,node_filters,node_search,node_features,node_keypoints toneAmber
class node_registration,node_segmentation,node_recognition,node_surface,node_stereo toneMint
class node_visualization,node_apps toneRose
class node_gpu,node_cuda,node_ml toneIndigo
```

## Components

### Data and I/O

- [Data I/O](https://github.com/pointcloudlibrary/pcl/tree/master/io): `io`
- [OpenNI2 devices](https://github.com/pointcloudlibrary/pcl/blob/master/io/src/openni2/openni2_device_manager.cpp): `io/src/openni2/openni2_device_manager.cpp`
- [OpenNI2 device](https://github.com/pointcloudlibrary/pcl/blob/master/io/include/pcl/io/openni2/openni2_device.h): `io/include/pcl/io/openni2/openni2_device.h`
- [RealSense devices](https://github.com/pointcloudlibrary/pcl/blob/master/io/src/real_sense/real_sense_device_manager.cpp): `io/src/real_sense/real_sense_device_manager.cpp`
- [Cloud data model](https://github.com/pointcloudlibrary/pcl/blob/master/common/include/pcl/point_cloud.h): `common/include/pcl/point_cloud.h`

### Point Processing

- [Common operations](https://github.com/pointcloudlibrary/pcl/tree/master/common/include/pcl/common): `common/include/pcl/common`
- [Cloud filters](https://github.com/pointcloudlibrary/pcl/tree/master/filters): `filters`
- [Spatial search](https://github.com/pointcloudlibrary/pcl/blob/master/search/include/pcl/search/search.h): `search/include/pcl/search/search.h`
- [Feature extraction](https://github.com/pointcloudlibrary/pcl/tree/master/features): `features`
- [Keypoint detection](https://github.com/pointcloudlibrary/pcl/tree/master/keypoints): `keypoints`

### Analysis and Modeling

- [Registration](https://github.com/pointcloudlibrary/pcl/tree/master/registration): `registration`
- [Segmentation](https://github.com/pointcloudlibrary/pcl/tree/master/segmentation): `segmentation`
- [Recognition](https://github.com/pointcloudlibrary/pcl/tree/master/recognition): `recognition`
- [Surface modeling](https://github.com/pointcloudlibrary/pcl/tree/master/surface): `surface`
- [Stereo matching](https://github.com/pointcloudlibrary/pcl/tree/master/stereo): `stereo`

### Visualization and Apps

- [Visualization](https://github.com/pointcloudlibrary/pcl/tree/master/visualization): `visualization`
- [User applications](https://github.com/pointcloudlibrary/pcl/tree/master/apps): `apps`

### Specialized Processing

- [GPU algorithms](https://github.com/pointcloudlibrary/pcl/tree/master/gpu): `gpu`
- [CUDA search](https://github.com/pointcloudlibrary/pcl/blob/master/cuda/nn/organized_neighbor_search.hpp): `cuda/nn/organized_neighbor_search.hpp`
- [Machine learning](https://github.com/pointcloudlibrary/pcl/tree/master/ml): `ml`

### Other components

- **Library user**

## Connections

- Library user → Data I/O: supplies data
- Data I/O → Cloud data model: loads clouds
- OpenNI2 devices → OpenNI2 device: creates device (evidence: `io/src/openni2/openni2_device_manager.cpp`)
- Library user → OpenNI2 devices: selects sensor
- RealSense devices → Library user: returns capture
- Cloud data model → Common operations: processes geometry
- Cloud data model → Cloud filters: filters points
- Cloud data model → Spatial search: queries neighbors
- Spatial search → Feature extraction: supports estimation
- Cloud data model → Feature extraction: extracts descriptors
- Cloud data model → Keypoint detection: detects points
- Feature extraction → Registration: matches features
- Cloud data model → Registration: aligns clouds
- Cloud data model → Segmentation: partitions points
- Feature extraction → Recognition: classifies objects
- Cloud data model → Surface modeling: builds surfaces
- Cloud data model → Stereo matching: matches images
- Cloud data model → Visualization: renders clouds
- Library user → User applications: uses tools
- User applications → Visualization: displays results
- Cloud data model → GPU algorithms: accelerates processing
- Cloud data model → CUDA search: searches neighbors
- Feature extraction → Machine learning: provides features
