Struct las::header::Header

pub struct Header { /* fields omitted */ }

Metadata describing the layout, source, and interpretation of the points.

Headers include all las metadata, including regular and extended variable length records and any file padding (e.g. extra bytes after the header).

Methods

impl Header

fn from_raw(raw_header: Header) -> Result<Header>

Creates a new header from a raw header.

Examples

use las::{raw, Header};
let raw_header = raw::Header::default();
let header = Header::from_raw(raw_header).unwrap();

fn clear(&mut self)

Clears this header's point counts and bounds.

Examples

use las::{Header, Point, Bounds};
let mut header = Header::default();
header.add_point(&Point { return_number: 1, ..Default::default() });
assert_eq!(1, header.number_of_points());
assert_eq!(1, header.number_of_points_by_return(1).unwrap());
header.clear();
assert_eq!(0, header.number_of_points());
assert_eq!(None, header.number_of_points_by_return(1));
assert_eq!(Bounds::default(), header.bounds());

fn add_point(&mut self, point: &Point)

Adds a point to this header, incrementing the point counts and growing the bounds.

Examples

use las::Header;
let mut header = Header::default();
header.add_point(&Default::default());
assert_eq!(1, header.number_of_points());

fn file_source_id(&self) -> u16

Returns this header's file source id.

For airborne data, this is often the flight line number.

Examples

use las::Header;
assert_eq!(0, Header::default().file_source_id());

fn gps_time_type(&self) -> GpsTimeType

Returns the gps time type.

This affects what the gps time values on points means. GpsTimeType::Week means that the time values are seconds from the start of the week. GpsTimeType::Standard means that the time values are standard GPS time (satellite gps time) minus 10e9.

Examples

use las::{GpsTimeType, Header};
assert_eq!(GpsTimeType::Week, Header::default().gps_time_type());

fn has_synthetic_return_numbers(&self) -> bool

Returns true if the return numbers on the point data records have been synthetically generated.

Only supported in later las versions.

Examples

use las::Header;
assert!(!Header::default().has_synthetic_return_numbers());

fn guid(&self) -> Uuid

Returns this header's guid.

Examples

use las::Header;
let guid = Header::default().guid();

fn version(&self) -> Version

Returns this header's version.

Examples

use las::{Header, Version};
assert_eq!(Version::new(1, 2), Header::default().version());

fn system_identifier(&self) -> &str

Returns this header's system identifier.

Describes the source of the data, whether it is a sensor or a processing operation.

Examples

use las::Header;
println!("{}", Header::default().system_identifier());

fn generating_software(&self) -> &str

Returns this header's generating software.

Examples

use las::Header;
assert!(Header::default().generating_software().starts_with("las-rs"));

fn date(&self) -> Option<Date<Utc>>

Returns this header's file creation date.

Can be None, which is against spec but happens with files in the wild.

Examples

use las::Header;
let date = Header::default().date().unwrap();

fn padding(&self) -> &Vec<u8>

Returns this header's padding.

These are bytes that are after the header but before the vlr. Not recommended to use.

Examples

use las::Header;
assert!(Header::default().padding().is_empty());

fn point_format(&self) -> Format

Returns this header's point format.

Point formats are used to describe the attributes and extra bytes of each point.

Examples

use las::Header;
let header = Header::default();
assert_eq!(0, header.point_format().to_u8().unwrap());

fn transforms(&self) -> Vector<Transform>

Returns this header's transforms.

The transforms are the scales and offsets used to convert floating point numbers to i16. Las data stores point coordinates as i16s internally.

Examples

use las::Header;
let header = Header::default();
let transforms = header.transforms();
assert_eq!(0.001, transforms.x.scale);

fn bounds(&self) -> Bounds

Returns the bounds of this header.

The bounds describe the min and max values in each dimension.

Examples

use las::Header;
let bounds = Header::default().bounds();

fn number_of_points(&self) -> u64

Returns this header's number of points.

Examples

use las::Header;
let header = Header::default();
assert_eq!(0, header.number_of_points());

fn number_of_points_by_return(&self, n: u8) -> Option<u64>

Returns this header's number of points for a given return number.

Note that return numbers are 1-indexed.

Examples

use las::Header;
let header = Header::default();
assert_eq!(None, header.number_of_points_by_return(1));

fn vlr_padding(&self) -> &Vec<u8>

Returns a reference to this header's vlr padding.

These are bytes after the vlrs but before the points. Again, not recommended for use.

Examples

use las::Header;
assert!(Header::default().vlr_padding().is_empty());

fn point_padding(&self) -> &Vec<u8>

Returns a reference to this header's point padding.

These are the bytes after the points but before eof/any evlrs. Not recommended.

Examples

use las::Header;
assert!(Header::default().point_padding().is_empty());

fn vlrs(&self) -> &Vec<Vlr>

Returns a reference to this header's vlrs.

Examples

use las::{Vlr, Builder};
let mut builder = Builder::default();
builder.vlrs.push(Vlr::default());
let header = builder.into_header().unwrap();
assert_eq!(1, header.vlrs().len());

fn evlrs(&self) -> &Vec<Vlr>

Returns a reference to header's extended variable length records.

Examples

use las::{Vlr, Builder};
let mut builder = Builder::from((1, 4));
builder.evlrs.push(Vlr::default());
let header = builder.into_header().unwrap();
assert_eq!(1, header.evlrs().len());

fn all_vlrs(&self) -> Vlrs

Returns an iterator over all this header's vlrs, both extended and regular.

Examples

use las::{Vlr, Builder};
let mut builder = Builder::from((1, 4));
builder.vlrs.push(Vlr::default());
builder.evlrs.push(Vlr::default());
let header = builder.into_header().unwrap();
assert_eq!(2, header.all_vlrs().count());

fn into_raw(self) -> Result<Header>

Converts this header into a raw header.

Examples

use las::Header;
let raw_header = Header::default().into_raw().unwrap();

Trait Implementations

impl Clone for Header

fn clone(&self) -> Header

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Header

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl PartialEq for Header

fn eq(&self, __arg_0: &Header) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &Header) -> bool

This method tests for !=.

impl Default for Header

fn default() -> Header

Returns the "default value" for a type.

impl<V: Into<Version>> From<V> for Header

fn from(version: V) -> Header

Performs the conversion.