installation.md

Installation

Rust

Umbrella crate (recommended)

Includes core, algorithms, I/O, and simplification by default:

[dependencies]
threecrate = "0.8.0"

Individual crates (minimal dependencies)

Pick only what you need:

[dependencies]
threecrate-core = "0.8.0"
threecrate-algorithms = "0.8.0"
threecrate-io = "0.8.0"
threecrate-reconstruction = "0.8.0"
threecrate-simplification = "0.8.0"
threecrate-gpu = "0.8.0"
threecrate-visualization = "0.8.0"

Feature flags

[dependencies]
threecrate = { version = "0.8.0", features = ["all"] }

Feature	Description	Default
core	Core data structures	✅ always
algorithms	Point cloud processing algorithms	✅
io	File format support (PLY, OBJ, PCD, XYZ)	✅
simplification	Mesh simplification	✅
reconstruction	Surface reconstruction	❌ opt-in
gpu	GPU-accelerated compute and rendering	❌ opt-in
visualization	Interactive 3D viewer	❌ opt-in
all	Everything above	❌ opt-in

I/O opt-in features

These formats require extra dependencies and must be enabled explicitly:

threecrate-io = { version = "0.8.0", features = ["las_laz", "e57", "io-mmap"] }

Feature	Formats	Notes
las_laz	LAS, LAZ (LiDAR)	via pasture
e57	E57	via e57 crate
io-mmap	Memory-mapped binary reads	large file optimization

Python

Pre-built wheels — no Rust required:

pip install threecrate

Supported: Python 3.8+, Linux / macOS / Windows.

Build from source

Requires Rust 1.75+ and maturin 1.x:

pip install maturin
cd threecrate-python
maturin develop --release