Struct Reader 

pub struct Reader { /* private fields */ }

Reads LAS data.

Implementations

impl Reader

pub fn new<R: Read + Seek + Send + Sync + 'static>(read: R) -> Result<Reader>

Creates a new reader with default options.

This does not wrap the Read in a BufRead, so if you’re concerned about performance you should do that wrapping yourself (or use from_path).

Examples

use std::io::BufReader;
use std::fs::File;
let file = File::open("tests/data/autzen.las").unwrap();
let reader = Reader::new(BufReader::new(file)).unwrap();

pub fn with_options<R: Read + Seek + Send + Sync + 'static>( read: R, options: ReaderOptions, ) -> Result<Reader>

Creates a new reader with custom options.

This does not wrap the Read in a BufRead, so if you’re concerned about performance you should do that wrapping yourself (or use from_path).

Examples

use std::io::BufReader;
use std::fs::File;
let file = File::open("tests/data/autzen.las").unwrap();
let reader = Reader::with_options(BufReader::new(file), ReaderOptions::default()).unwrap();

pub fn from_path<P: AsRef<Path>>(path: P) -> Result<Reader>

Creates a new reader from a path.

The underlying File is wrapped in a BufReader for performance reasons.

Examples

let reader = Reader::from_path("tests/data/autzen.las").unwrap();

pub fn header(&self) -> &Header

Returns a reference to this reader’s header.

Examples

use las::Reader;
let reader = Reader::from_path("tests/data/autzen.las").unwrap();
let header = reader.header();

pub fn read_point(&mut self) -> Result<Option<Point>>

Reads a point.

Examples

let mut reader = Reader::from_path("tests/data/autzen.las").unwrap();
let point = reader.read_point().unwrap().unwrap();

pub fn read_points(&mut self, n: u64) -> Result<Vec<Point>>

Reads n points into a vector.

Examples

let mut reader = Reader::from_path("tests/data/autzen.las").unwrap();
let points = reader.read_points(10).unwrap();
assert_eq!(points.len(), 10);

pub fn read_points_into( &mut self, n: u64, points: &mut Vec<Point>, ) -> Result<u64>

Reads n points into a provided vector, returning the number of points read.

Examples

let mut reader = Reader::from_path("tests/data/autzen.las").unwrap();
let mut points = Vec::new();
let count = reader.read_points_into(10, &mut points).unwrap();

pub fn read(&mut self) -> Option<Result<Point>>

👎Deprecated since 0.9.0: Use read_point() instead, which returns a Result<Option<Point>>

Reads a point.

Examples

let mut reader = Reader::from_path("tests/data/autzen.las").unwrap();
let point = reader.read().unwrap().unwrap();

pub fn read_n(&mut self, n: u64) -> Result<Vec<Point>>

👎Deprecated since 0.9.0: Use read_points() instead

Reads n points into a vector.

pub fn read_n_into(&mut self, n: u64, points: &mut Vec<Point>) -> Result<u64>

👎Deprecated since 0.9.0: Use read_points_into() instead

Reads n points into the vec

pub fn read_all_points_into(&mut self, points: &mut Vec<Point>) -> Result<u64>

Reads all points into a vector.

Examples

let mut reader = Reader::from_path("tests/data/autzen.las").unwrap();
let mut points = Vec::new();
let count = reader.read_all_points(&mut points).unwrap();
assert_eq!(points.len(), count.try_into().unwrap());

pub fn read_all_points(&mut self, points: &mut Vec<Point>) -> Result<u64>

👎Deprecated since 0.9.0: Use read_all_points_into() instead

Reads all points into a vector.

pub fn seek(&mut self, position: u64) -> Result<()>

Seeks to the given point number, zero-indexed.

Note that seeking on compressed (LAZ) data can be expensive as the reader will have to seek to the closest chunk start and decompress all points up until the point seeked to.

Examples

use las::Reader;
let mut reader = Reader::from_path("tests/data/autzen.las").unwrap();
reader.seek(1).unwrap(); // <- seeks to the second point
let the_second_point = reader.read().unwrap().unwrap();

pub fn points(&mut self) -> PointIterator<'_>

Returns an iterator over this reader’s points.

Examples

let mut reader = Reader::from_path("tests/data/autzen.las").unwrap();
let points = reader.points().collect::<Result<Vec<_>, _>>().unwrap();

Trait Implementations

impl Read for Reader

fn header(&self) -> &Header

👎Deprecated since 0.9.0: This interface has been refactored so that importing Read is no longer required

Returns a reference to this reader’s header.

fn read(&mut self) -> Option<Result<Point>>

👎Deprecated since 0.9.0: This interface has been refactored so that importing Read is no longer required

Reads a point.

fn seek(&mut self, position: u64) -> Result<()>

👎Deprecated since 0.9.0: This interface has been refactored so that importing Read is no longer required

Seeks to the given point number, zero-indexed.

fn points(&mut self) -> PointIterator<'_>

👎Deprecated since 0.9.0: This interface has been refactored so that importing Read is no longer required

Returns an iterator over this reader’s points.

fn read_n(&mut self, n: u64) -> Result<Vec<Point>>

👎Deprecated since 0.9.0: This interface has been refactored so that importing Read is no longer required

Reads n points.

fn read_n_into(&mut self, n: u64, points: &mut Vec<Point>) -> Result<u64>

👎Deprecated since 0.9.0: This interface has been refactored so that importing Read is no longer required

Reads n points into the vec

fn read_all_points(&mut self, points: &mut Vec<Point>) -> Result<u64>

👎Deprecated since 0.9.0: This interface has been refactored so that importing Read is no longer required

Reads all points left into the vec