copc-lib is a library which provides an easy-to-use reader and writer interface for COPC point clouds. This project provides a complete interface for handling COPC files, so that no additional LAZ or LAS libraries are required.

Note: This library is in beta and API may change

copc-lib depends on laz-perf 2.1.0 or greater. See the laz-perf repo for installation instructions.

With the dependencies installed, we can now build copc-lib:

git clone https://github.com/RockRobotic/copc-lib.git
cd copc-lib
mkdir build && cd build
cmake ..
make
sudo make install

The Reader and Writer objects provide the primary means of interfacing with your COPC files. For more complex use cases, we also provide additional objects such as LAZ Compressors and Decompressors (see example/example-writer.cpp).

For common use cases, see the example and test folders for full examples.

copc-lib is compatible with CMake. Assuming copc-lib and lazperf are installed on the system, you can link with them in your CMakeLists.txt:

find_package(copc-lib REQUIRED)
find_package(lazperf REQUIRED)

add_executable(funfile fun-main.cpp)
target_link_libraries(funfile copc-lib LAZPERF::lazperf)

If other library functionality is needed, feel free to open an issue to see about getting it added.

• Basic C++ Reader Interface
• Return Point structures from the reader rather than raw char* arrays, to support a more familiar laspy-like interface.
• Add writer for COPC data
• Spatial querying for nodes (given spatial coordinates, retrieve the appropriate Entry object)
• Python bindings
• Javascript (emscripten) bindings

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Please see LICENSE.md

copc-lib is created and maintained by Chris Lee, Leo Stanislas and other members of RockRobotic.

The COPC file format is created and maintained by HOBU Inc. Some code has been adopted from PDAL and lazperf, both of which are maintained by HOBU Inc.