Struct CartesianConverter 

pub struct CartesianConverter { /* private fields */ }

CARTESIAN / GEODETIC CONVERSIONS

This material follows:

Bernhard Hofmann-Wellenhof & Helmut Moritz: Physical Geodesy, 2nd edition. Springer, 2005.

chapter 5.6: Coordinate transformations (HM, below),

and

Wikipedia: Geographic Coordinate Conversion, https://en.wikipedia.org/wiki/Geographic_coordinate_conversion

(WP, below).

The cartesian-to-geodetic conversion is based on Bowring’s celebrated method:

B. R. Bowring: Transformation from spatial to geographical coordinates Survey Review 23(181), pp. 323-327, 1976

(BB, below),

but could probably use some TLC from a newer and faster algorithm:

Toshio Fukushima: Transformation from Cartesian to Geodetic Coordinates Accelerated by Halley’s Method Journal of Geodesy, February 2006

(TF, below).

Close to the poles, we avoid singularities by switching to an approximation requiring knowledge of the geocentric radius at the given latitude. For this, we use an adaptation of the formula given in:

Wikipedia: Earth Radius https://en.wikipedia.org/wiki/Earth_radius#Radius_at_a_given_geodetic_latitude (Derivation and commentary at https://gis.stackexchange.com/q/20200)

(WP2, below)

These routines are probably not as robust at those in geocent.c, at least they haven’t been through as heavy use as their geocent sisters. Some care has been taken to avoid singularities, but extreme cases (e.g. setting es, the squared eccentricity, to 1), will cause havoc.

Trait Implementations

impl Clone for CartesianConverter

fn clone(&self) -> CartesianConverter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CoordinateStep for CartesianConverter

fn forward<P: TransformCoordinates>(&self, coords: &mut P)

Geographical to geocentric

fn inverse<P: TransformCoordinates>(&self, coords: &mut P)

Geocentric to geographical

fn new(proj: Rc<RefCell<Proj>>) -> Self

Create a new Converter

impl Debug for CartesianConverter

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

Formats the value using the given formatter.

impl From<CartesianConverter> for ProjectionTransform

fn from(c: CartesianConverter) -> ProjectionTransform

Converts to this type from the input type.

impl PartialEq for CartesianConverter

fn eq(&self, other: &CartesianConverter) -> 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 ProjectCoordinates for CartesianConverter

fn code(&self) -> i64

ESPG code for this projection

fn name(&self) -> &'static str

Projection name

fn names() -> &'static [&'static str]

Returns the list of canonical names for this projection. This is an associated function, similar to a static method.

fn datum_type() -> u8

get the datum type. Defaults to no datum

impl StructuralPartialEq for CartesianConverter