Struct GeoidGrid 

pub struct GeoidGrid { /* private fields */ }

A regular latitude/longitude grid of geoid undulation samples (metres) with bilinear interpolation.

Samples are stored row-major with latitude ascending (outer) and longitude ascending (inner): values_m[i * n_lon + j] is the undulation at latitude lat_min_deg + i * dlat_deg and longitude lon_min_deg + j * dlon_deg.

Latitude inputs are clamped to the grid’s latitude span. Longitude inputs are normalized to [-180, 180) and then, when the grid spans a full 360 degrees of longitude, wrapped across the antimeridian; otherwise they are clamped to the grid’s longitude span (so a regional grid does not wrap).

Implementations

impl GeoidGrid

pub fn new( lat_min_deg: f64, lon_min_deg: f64, dlat_deg: f64, dlon_deg: f64, n_lat: usize, n_lon: usize, values_m: Vec<f64>, ) -> Result<Self, GeoidError>

Build a geoid grid from its origin, spacing, dimensions, and row-major samples (metres).

Returns GeoidError when a dimension is zero, the sample count does not equal n_lat * n_lon, a spacing/origin is non-finite or a spacing is non-positive, or a sample is non-finite.

pub fn from_text(text: &str) -> Result<Self, GeoidError>

Parse a geoid grid from a simple, documented text format (the data-loading hook for full EGM grids).

The format is whitespace-delimited with # line comments. The first non-comment token sequence is a six-field header:

lat_min lon_min dlat dlon n_lat n_lon

followed by exactly n_lat * n_lon undulation samples in metres, in row-major order (latitude ascending outer, longitude ascending inner). All angles are in degrees. This is deliberately a minimal, line-oriented format; a caller converting a vendor grid (EGM .gri/.ndp, a GeoTIFF, etc.) lowers it to this shape or builds a GeoidGrid via new.

pub fn undulation_rad(&self, lat_rad: f64, lon_rad: f64) -> f64

Bilinearly interpolated undulation N (metres) at a geodetic position in radians (latitude positive north, longitude positive east).

pub fn undulation_deg(&self, lat_deg: f64, lon_deg: f64) -> f64

Bilinearly interpolated undulation N (metres) at a geodetic position in degrees (latitude positive north, longitude positive east).

Trait Implementations

impl Clone for GeoidGrid

fn clone(&self) -> GeoidGrid

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GeoidGrid

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

Formats the value using the given formatter.

impl PartialEq for GeoidGrid

fn eq(&self, other: &GeoidGrid) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for GeoidGrid