How do I load my own PCD file in CloudPeek?

Pass the file path as a command-line argument when running the application, similar to the example in run.sh with the sample KITTI PCD file. Ensure the PCD file uses supported fields like x, y, z, or RGB.

Is CloudPeek better than PCL for visualization?

CloudPeek is lighter and faster for pure visualization with minimal dependencies, but PCL offers extensive processing features. Choose CloudPeek for quick, embeddable viewing without the overhead of a full library.

Can CloudPeek handle real-time data from a LiDAR sensor?

No, CloudPeek is designed for static PCD files and does not support real-time streaming or dynamic data updates out of the box, limiting its use for live sensor applications.

How to change the point size or color scheme in CloudPeek?

Modify configuration constants in PointCloudViewer.h, such as POINT_SIZE, or adjust the color mapping based on distance. The README lists these settings under the Configuration section for customization.

What are the minimum system requirements for CloudPeek?

Requires a C++17 compiler, CMake 3.10+, OpenGL 3.3 Core Profile or higher, and GLFW/GLEW for cross-platform support, as specified in the prerequisites. This ensures compatibility with modern graphics hardware.

Does CloudPeek work with RGB point clouds?

Yes, it supports RGB and RGBA color fields from PCD files, automatically colorizing points based on distance or using the provided color data, as mentioned in the Color Mapping feature.

Open-Awesome

CloudPeek

C++

A lightweight, cross-platform, single-header C++ point cloud viewer for visualizing LiDAR, photogrammetry, and 3D datasets.

GitHub

125 stars5 forks0 contributors

What is CloudPeek?

CloudPeek is a lightweight, cross-platform, single-header C++ point cloud viewer designed for visualizing and interacting with 3D data from sources like LiDAR and photogrammetry. It provides high-performance rendering and intuitive camera controls without requiring heavy external libraries, making it ideal for quick exploration and analysis of point cloud datasets.

Target Audience

Developers and researchers working with 3D point cloud data, such as LiDAR scans or photogrammetry outputs, who need a simple, efficient visualization tool without the overhead of large libraries like PCL or Open3D.

Value Proposition

CloudPeek offers a minimalistic, dependency-light alternative to heavier point cloud libraries, delivering real-time visualization and interaction in a single-header C++ package that is easy to integrate and cross-platform compatible.

Overview

CloudPeek is a lightweight, cross-platform, single-header C++ point cloud viewer. It’s designed for simplicity and efficiency, requiring no heavy libraries like PCL or Open3D. Ideal for visualizing and interacting with 3D data from LiDAR, photogrammetry, or other datasets, CloudPeek delivers powerful, real-time exploration in a minimalistic package

Use Cases

Best For

Visualizing LiDAR point cloud data from autonomous vehicle datasets
Quick inspection of photogrammetry outputs in 3D
Embedding a lightweight point cloud viewer in C++ applications
Educational projects teaching 3D data visualization with OpenGL
Prototyping point cloud processing pipelines without heavy dependencies
Cross-platform 3D data exploration on Windows, Linux, and macOS

Not Ideal For

Projects requiring advanced point cloud processing like segmentation or feature extraction
Applications needing real-time streaming or dynamic updates from live sensors
Integration with game engines or complex 3D pipelines requiring more than basic OpenGL rendering

Pros & Cons

Pros

High-Performance Rendering

Uses OpenGL to efficiently render large point clouds with dynamic point sizes and distance-based color mapping, as detailed in the README's features section.

Intuitive Camera Controls

Implements an Arcball camera model with smooth zoom, pan, rotate, and reset view, providing seamless navigation for 3D data exploration.

Single-Header Design

Packages all functionality into a single header file, minimizing dependencies and simplifying integration into C++ projects for reduced bloat.

Cross-Platform Compatibility

Built with GLFW for window management, ensuring it runs on Windows, Linux, and macOS without platform-specific code changes.

Cons

Limited Data Format Support

Only natively supports PCD files, lacking built-in handling for common formats like PLY or LAS, which restricts data source flexibility.

Setup Complexity

Requires manual installation of OpenGL, GLFW, and GLEW dependencies, which can be challenging for developers unfamiliar with graphics programming toolchains.

Basic Functionality Focus

Solely focused on visualization without tools for point cloud manipulation, analysis, or export, making it inadequate for comprehensive processing workflows.

Open Source Alternative To

CloudPeek is an open-source alternative to the following products:

PCL

A standalone C++ library for point cloud processing, providing algorithms for filtering, segmentation, registration, and surface reconstruction.

Open3D

Open3D is an open-source library for 3D data processing, providing tools for 3D reconstruction, visualization, and geometric analysis.

Frequently Asked Questions

Related Projects

GitHub repository

Visualize, query, and stream to train on multimodal robotics data.

The open source mesh processing system

Stars5,885

Forks920

Last commit1 month ago

Semantic Segmentation Editor

Web labeling tool for bitmap images and point clouds

Stars1,975

Forks446

Last commit2 years ago

Pcx

Point cloud importer & renderer for Unity

Stars1,520

Forks212

Last commit4 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub