Struct CopcReader 

pub struct CopcReader { /* private fields */ }

A parsed COPC file ready for spatial queries.

Example

use oxigdal_copc::copc_reader::CopcReader;
use oxigdal_copc::point::BoundingBox3D;

let data = std::fs::read("my_file.copc.laz").expect("read file");
let reader = CopcReader::from_bytes(&data).expect("parse COPC");
let bbox = BoundingBox3D::new(0.0, 0.0, 0.0, 100.0, 100.0, 50.0).expect("valid bbox");
let points = reader.query_points_in_bbox(&bbox).expect("query");

Implementations

impl CopcReader

pub fn from_bytes(data: &[u8]) -> Result<Self, CopcError>

Parse a COPC file from an in-memory byte slice.

Parses the LAS header, walks the VLR chain to extract the COPC info and hierarchy VLR, and stores the raw data for later queries.

Errors

Returns CopcError when the data is not a valid COPC file (bad magic, missing VLRs, truncated data, etc.).

pub fn header(&self) -> &LasHeader

Return a reference to the parsed LAS header.

pub fn copc_info(&self) -> &CopcInfo

Return a reference to the parsed COPC info.

pub fn vlrs(&self) -> &[Vlr]

Return a reference to the VLR list.

pub fn octree_bounds(&self) -> BoundingBox3D

Return the full octree bounding box as a BoundingBox3D.

pub fn query_points_in_bbox( &self, bbox: &BoundingBox3D, ) -> Result<Vec<Point3D>, CopcError>

Query all points whose positions fall within the given 3D bounding box.

Traverses the COPC hierarchy to find octree nodes that intersect bbox, reads the corresponding point data chunks and deserializes them, then filters to only those points geometrically inside bbox.

Errors

Returns CopcError on hierarchy traversal or point deserialization errors.

pub fn all_points(&self) -> Result<Vec<Point3D>, CopcError>

Query all points within the entire file (no spatial filter).

Walks the hierarchy and reads all point data chunks.

Errors

Returns CopcError on hierarchy or point deserialization errors.

pub fn count_intersecting_chunks( &self, bbox: &BoundingBox3D, ) -> Result<Vec<HierarchyEntry>, CopcError>

Return the total number of hierarchy entries (data chunks) that intersect the given bounding box, without reading point data.

Useful for estimating query cost before fetching actual points.

pub fn entries_at_depth( &self, depth: i32, ) -> Result<Vec<HierarchyEntry>, CopcError>

Return all hierarchy entries at a given depth level.

This traverses the full hierarchy and filters by depth.

Trait Implementations

impl Debug for CopcReader

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.