Struct MmapTerrain 

pub struct MmapTerrain<'a> { /* private fields */ }

Memory-mappable terrain reader backed by a terrain store byte span.

Scalar and batch terrain lookups return orthometric metres, H, above the EGM96 mean sea level geoid. Use Self::ellipsoidal_height_m or OrthometricHeightM::to_ellipsoidal_height_deg for the explicit h = H + N conversion to WGS84 ellipsoidal height.

Implementations

impl MmapTerrain<'static>

pub fn from_vec(bytes: Vec<u8>) -> Result<Self, TerrainStoreError>

Parse an owned terrain store byte vector.

pub fn from_path(path: impl AsRef<Path>) -> Result<Self, TerrainStoreError>

Read and parse a terrain store file.

This reads the file into memory. Applications that already manage an mmap should pass the mmap slice to MmapTerrain::from_bytes to avoid the file read copy.

impl<'a> MmapTerrain<'a>

pub fn from_bytes(bytes: &'a [u8]) -> Result<Self, TerrainStoreError>

Parse a borrowed terrain store byte span.

The reader keeps the byte span in place and indexes posting payloads by offset. Passing an mmap-backed slice gives a zero-copy reader.

pub fn as_bytes(&self) -> &[u8]

Borrow the original terrain store bytes.

pub const fn vertical_datum(&self) -> VerticalDatum

Return the store’s file-level vertical datum.

pub fn tile_index(&self) -> &[TerrainStoreTileIndex]

Borrow the parsed tile index records.

pub fn checksum64(&self) -> u64

Return an FNV-1a checksum of the full terrain store byte span.

pub fn to_bytes(&self) -> Vec<u8>

Re-serialize this parsed terrain store into canonical bytes.

A store accepted by Self::from_bytes is already canonical, so this returns bytes identical to Self::as_bytes.

pub fn height_m(&mut self, longitude_deg: f64, latitude_deg: f64) -> Result<f64>

Return the bilinearly interpolated orthometric height H in metres at a longitude-first geodetic position in degrees.

pub fn height_m_with_options( &mut self, longitude_deg: f64, latitude_deg: f64, options: DtedLookupOptions, ) -> Result<f64>

Return the orthometric height H in metres at a longitude-first geodetic position in degrees using explicit lookup options.

pub fn orthometric_height_m( &self, longitude_deg: f64, latitude_deg: f64, ) -> Result<OrthometricHeightM>

Return the bilinearly interpolated orthometric height H in metres as a typed value at a longitude-first geodetic position in degrees.

pub fn orthometric_height_m_with_options( &self, longitude_deg: f64, latitude_deg: f64, options: DtedLookupOptions, ) -> Result<OrthometricHeightM>

Return the orthometric height H in metres as a typed value at a longitude-first geodetic position in degrees using explicit lookup options.

pub fn height_batch( &mut self, points: &[(f64, f64)], options: DtedLookupOptions, ) -> Vec<Result<f64>>

Evaluate (longitude_deg, latitude_deg) points in order as orthometric heights H in metres.

The tuple order is longitude-first, matching Self::height_m. Each output element is independent, so an invalid point or parse failure is returned only for that element.

pub fn orthometric_height_batch( &self, points: &[(f64, f64)], options: DtedLookupOptions, ) -> Vec<Result<OrthometricHeightM>>

Evaluate (longitude_deg, latitude_deg) points in order as typed orthometric heights H in metres.

The tuple order is longitude-first. Each output element is independent, so an invalid point or parse failure is returned only for that element.

pub fn ellipsoidal_height_m( &self, longitude_deg: f64, latitude_deg: f64, ) -> Result<EllipsoidalHeightM, TerrainDatumError>

Return ellipsoidal height h in metres using the embedded EGM96 1-degree grid for h = H + N.

The input position is terrain order (longitude_deg, latitude_deg). Internally, the geoid call is made with (latitude_deg, longitude_deg). The embedded EGM96 1-degree grid agrees with the full EGM96 15-arcminute grid to about 0.4 m RMS.

pub fn ellipsoidal_height_m_with_options( &self, longitude_deg: f64, latitude_deg: f64, options: DtedLookupOptions, ) -> Result<EllipsoidalHeightM, TerrainDatumError>

Return ellipsoidal height h in metres using the embedded EGM96 1-degree grid for h = H + N and explicit terrain lookup options.

The input position is terrain order (longitude_deg, latitude_deg). Internally, the geoid call is made with (latitude_deg, longitude_deg).

pub fn ellipsoidal_height_m_with_model( &self, longitude_deg: f64, latitude_deg: f64, options: DtedLookupOptions, geoid: TerrainGeoidModel<'_>, ) -> Result<EllipsoidalHeightM, TerrainDatumError>

Return ellipsoidal height h in metres using an explicit geoid tier for h = H + N.

The input position is terrain order (longitude_deg, latitude_deg). Internally, the geoid call is made with (latitude_deg, longitude_deg). Choosing TerrainGeoidModel::Egm96FifteenMinute requires a loaded WW15MGH.DAC grid and never falls back to the embedded EGM96 1-degree grid.

Trait Implementations

impl<'a> Clone for MmapTerrain<'a>

fn clone(&self) -> MmapTerrain<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for MmapTerrain<'a>

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

Formats the value using the given formatter.