copc_converter

A fast, memory-efficient converter that turns LAS/LAZ point cloud files into COPC (Cloud-Optimized Point Cloud) files.

Features

Produces spec-compliant COPC 1.0 files (LAS 1.4, point format 6, 7, or 8 — automatically chosen from input)
Merges multiple input files into a single COPC output
Out-of-core processing with a configurable memory budget — handles datasets larger than RAM
Parallel reading, octree construction, and LAZ compression via rayon
Preserves WKT CRS from input files
Optional temporal index for GPS-time-based filtering (spec)

Installation

Requires Rust 1.85+.

From crates.io

cargo install copc_converter

From source

git clone https://github.com/360-geo/copc-converter.git
cd copc-converter
cargo install --path .

This installs the copc_converter binary to ~/.cargo/bin/, which should be on your PATH.

Pre-built binaries

Download pre-built binaries from the GitHub releases page. These are built for broad compatibility and run on any machine.

For best performance, prefer installing from source via cargo install — this automatically compiles with target-cpu=native, optimizing for your specific CPU's instruction set (AVX2, NEON, etc.).

Usage

# Single file
copc_converter input.laz output.copc.laz

# Directory of LAZ/LAS files
copc_converter ./tiles/ merged.copc.laz

Options

Flag	Description	Default
`--memory-limit`	Max memory budget (`16G`, `4096M`, etc.)	auto-detected
`--threads`	Max parallel threads	all cores
`--temp-dir`	Directory for intermediate files	system temp
`--temporal-index`	Write a temporal index EVLR for time-based queries	off
`--temporal-stride`	Sampling stride for the temporal index (every n-th point)	`1000`
`--progress`	Progress output format: `bar`, `plain`, or `json`	`bar`

Examples

copc_converter ./my_survey/ survey.copc.laz --memory-limit 8G

# With temporal index (useful for multi-pass mobile mapping data)
copc_converter ./my_survey/ survey.copc.laz --temporal-index

Library usage

The crate exposes a typestate pipeline API that enforces correct step ordering at compile time:

use copc_converter::{Pipeline, PipelineConfig, collect_input_files};

let files = collect_input_files("./tiles/".into())?;
let config = PipelineConfig {
    memory_budget: 12_884_901_888,
    temp_dir: None,
    temporal_index: false,
    temporal_stride: 1000,
    progress: None, // or Some(Arc::new(your_observer))
};

Pipeline::scan(&files, config)?
    .validate()?
    .distribute()?
    .build()?
    .write("output.copc.laz")?;

Tools

Optional analysis tools are available behind the tools feature:

cargo build --release --features tools

compare_copc

Side-by-side comparison of two COPC files over HTTP (headers + hierarchy only, no point data):

compare_copc <url_a> <url_b>

Prints node counts, point distribution, compressed sizes, and compression ratios per octree level.

inspect_temporal

Inspect the temporal index EVLR of a COPC file:

inspect_temporal <url>

Prints GPS time range, per-level temporal coverage, a time histogram showing node overlap across time windows, and sample density stats.

How it works

Scan — reads headers from all input files in parallel to determine bounds, CRS, point format, and point count.
Validate — checks that all input files share the same CRS and point format, and selects the appropriate COPC output format (6, 7, or 8).
Distribute — reads every point, assigns it to an octree leaf voxel, and writes it to a temporary file on disk.
Build — constructs the octree bottom-up, thinning points at each level to produce multi-resolution LODs.
Write — encodes and compresses nodes in parallel into a single COPC file with a hierarchy EVLR for spatial indexing.

License

MIT

copc_converter 0.7.1