Struct geodesy::Plain

pub struct Plain { /* private fields */ }

A context provider, supporting built in and run-time defined operators, external grids, and macros. Sufficient for most uses, especially geodetic grid development. May get somewhat clunky when working with large numbers of grids or macros, as each reside in its own file.

Implementations

impl Plain

pub fn clear_grids()

To avoid having the heap allocated collection of grids stored in GRIDS growing through the roof, we may clear it occasionally. As the grids are behind an Arc reference counter, this is safe to do even though they may still be in use by some remaining operator instantiations.

Trait Implementations

impl Context for Plain

fn op(&mut self, definition: &str) -> Result<OpHandle, Error>

Instantiate an operator. Recognizes PROJ syntax and converts it to Geodesy syntax. Bear in mind, however, that Geodesy does not support all PROJ operators, and that the input/output conventions differ.

fn get_grid(&self, name: &str) -> Result<Arc<dyn Grid>, Error>

Access grid resources by identifier

fn new() -> Plain

In general, implementations should make sure that new differs from default only by adding access to the builtin adaptors (geo:in, gis:out etc.)

fn apply( &self, op: OpHandle, direction: Direction, operands: &mut dyn CoordinateSet ) -> Result<usize, Error>

Apply operation op to operands

fn steps(&self, op: OpHandle) -> Result<&Vec<String>, Error>

Definitions of steps

fn params(&self, op: OpHandle, index: usize) -> Result<ParsedParameters, Error>

Parsed parameters of a specific step

fn globals(&self) -> BTreeMap<String, String>

Globally defined default values (typically just ellps=GRS80)

fn register_op(&mut self, name: &str, constructor: OpConstructor)

Register a new user-defined operator

fn get_op(&self, name: &str) -> Result<OpConstructor, Error>

Helper for the Op instantiation logic in Op::op(...)

fn register_resource(&mut self, name: &str, definition: &str)

Register a new user-defined resource (macro, ellipsoid parameter set…)

fn get_resource(&self, name: &str) -> Result<String, Error>

Helper for the Op instantiation logic in Op::op(...)

fn get_blob(&self, name: &str) -> Result<Vec<u8>, Error>

Access blob-like resources by identifier

impl Debug for Plain

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

Formats the value using the given formatter.

impl Default for Plain

fn default() -> Plain

Returns the “default value” for a type.