Struct Latitude 

pub struct Latitude(/* private fields */);

Latitude in [-90°, 90°], north positive.

Implementations

impl Latitude

pub const EQUATOR: Self

The equator.

pub const NORTH_POLE: Self

The north pole.

pub const SOUTH_POLE: Self

The south pole.

pub fn from_degrees(value: f64) -> Result<Self>

Latitude from decimal degrees, north positive.

Errors

crate::KernelError::NotFinite for NaN or infinity; crate::KernelError::OutOfRange outside [-90.0, 90.0].

pub fn from_degrees_minutes( degrees: u16, minutes: f64, hemisphere: NorthSouth, ) -> Result<Self>

Latitude from whole degrees and decimal minutes.

Errors

As Latitude::from_degrees, after combining.

pub const fn degrees(self) -> f64

Degrees, north positive.

pub fn radians(self) -> f64

Radians.

pub fn hemisphere(self) -> NorthSouth

Hemisphere; the equator counts as north.

pub fn to_degrees_minutes(self) -> (u16, f64, NorthSouth)

Whole degrees, decimal minutes and hemisphere.

pub fn is_polar(self) -> bool

Whether at a pole, where longitude is undefined.

pub fn meridional_parts(self) -> Result<f64>

Meridional parts: Mercator y-coordinate in minutes of arc, on the WGS 84 ellipsoid.

At 45° it gives 3013.6 (a sphere gives 3029.9).

kinavis::sailings::rhumb_line uses a spherical model and will not match a Mercator sailing computed from these values exactly; use kinavis::sailings::geodesic when the ellipsoid matters.

Errors

crate::KernelError::Indeterminate at a pole (infinite).

pub fn isometric_minutes(self) -> f64

Spherical isometric latitude, minutes of arc.

The Mercator y-coordinate on a sphere, used by the rhumb-line sailings in kinavis::sailings. Infinite at the poles.

Trait Implementations

impl Clone for Latitude

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Latitude

impl Debug for Latitude

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

Formats the value using the given formatter.

impl Default for Latitude

fn default() -> Self

Returns the “default value” for a type.

impl Display for Latitude

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

Formats as 50°45.3'N.

impl FromStr for Latitude

fn from_str(input: &str) -> Result<Self>

Parses 50°45.3'N, N50 45 18, -33.9 etc.

Hemisphere letter or sign, not both. See crate::position for accepted forms.

Errors

crate::KernelError::Parse for unreadable input or a non-N/S hemisphere; crate::KernelError::OutOfRange beyond the poles.

type Err = KernelError

The associated error which can be returned from parsing.

impl PartialEq for Latitude

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Latitude

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Latitude