Struct geod_types::AccurateDegree

pub struct AccurateDegree { /* fields omitted */ }

The implementation can accurately store either decimal fractions of the degree (with the 10^-6 degrees precision) or degree, minute, second (with the 10^-2 arcsecond precision).

Implementations

impl AccurateDegree

pub fn with_dms(
    degree: u16,
    minutes: u8,
    seconds: u8,
    centi_seconds: u8
) -> Result<Self, AngleNotInRange>

Degree, minute, second, centisecond.

Errors

When some part of the angle is out of scope (e.g. minutes > 60 or degree > 360), the AngleNotInRange returned.

pub fn degrees(self) -> u16

The whole number of degrees in the angle

pub fn deg_fract(self) -> u32

The microdegrees (10^-6 degrees) component of the angle

pub fn arc_minutes(self) -> u8

The arc minutes component of the angle.

pub fn arc_seconds(self) -> u8

The arc seconds component of the angle.

pub fn centi_arc_seconds(self) -> u8

The centi arc seconds (1/100-th of the arc second) component of the angle.

Use with caution! The overflow of 0.999_999 degrees intentionally handled incorrectly to keep the degrees value valid. To get the accurate value in such a boundary condition, use deg_min_sec_cas instead.

pub fn deg_min_sec_cas(self) -> (u16, u8, u8, u8)

Parts of the angle as in the DMS scheme.

There is a corner case when the degree part returned is not the same as the result of degrees(): when the angle’s value is too close to a whole degree in terms of internal representation, but still slightly less than it.

However, in terms of the DMS, it is already represented as a whole degree since the distance is too small to be represented in DMS scheme.

 let a = AccurateDegree::try_from(35.999999).unwrap();

 assert_eq!(a.degrees(), 35);
 assert_eq!(a.arc_minutes(), 59);
 assert_eq!(a.arc_seconds(), 59);
 assert_eq!(a.centi_arc_seconds(), 99);

 // the value is closer to 36 than to 35 59'59.99"
 // and therefore rounds up
 assert_eq!(a.deg_min_sec_cas(), (36, 0, 0, 0));

pub fn almost_equal(self, rhs: Self) -> bool

Since the DMS and decimal representation have different granularity, when comparing one with the other we should consider a gap of the half of larger granularity.

Trait Implementations

impl Add<AccurateDegree> for AccurateDegree

type Output = Self

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl Angle for AccurateDegree

type NumErr = AngleNotInRange

The error that can appear when representing some part of the angle with a number

type ParseErr = ParseAngleError

The error that can appear while parsing the angle from a string

fn obtuse_err() -> Self::NumErr

Produce an error variant indicating an angle is more than the right one

fn reflex_err() -> Self::NumErr

Produce an error variant indicating an angle is reflex

fn turn_err() -> Self::NumErr

Produce an error variant indicating an angle does not fall into full circle

fn complement(self) -> Option<Self>

Adjacent angle which sum to a right angle

fn supplement(self) -> Option<Self>

Adjacent angle which sum to a straight angle

fn explement(self) -> Self

Adjacent angle which sum to a complete angle

fn abs_diff(self, rhs: Self) -> Self

Difference between the angles by modulo independent of the order

fn turn_eq(self, other: Self) -> bool

Is the other angle differs by an exact multiple of a full turn

fn and_not_obtuse(self) -> Result<Self, Self::NumErr>

Check the angle is less than or equal to the right one

fn and_not_reflex(self) -> Result<Self, Self::NumErr>

Check the angle is less than or equal to the straight one

impl AngleNames for AccurateDegree

fn zero() -> Self

No angle

fn right() -> Self

The angle made of perpendicular rays

fn straight() -> Self

The angle made of two exactly opposite direction

fn complete() -> Self

The angle made of full circle (perigon)

fn is_zero(self) -> bool

No angle

fn is_acute(self) -> bool

Is the angle sharp?

fn is_right(self) -> bool

Are the lines perpendicular?

fn is_obtuse(self) -> bool

Is the angle blunt?

fn is_straight(self) -> bool

Is the angle forms a straight line?

fn is_reflex(self) -> bool

Is the angle more than a straight line?

fn is_complete(self) -> bool

Is the angle full round?

impl CheckedAdd for AccurateDegree

fn checked_add(&self, rhs: &Self) -> Option<Self>

Adds two numbers, checking for overflow. If overflow happens, None is returned.

impl CheckedSub for AccurateDegree

fn checked_sub(&self, rhs: &Self) -> Option<Self>

Subtracts two numbers, checking for underflow. If underflow happens, None is returned.

impl Clone for AccurateDegree

fn clone(&self) -> AccurateDegree

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for AccurateDegree

impl Debug for AccurateDegree

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

Formats the value using the given formatter.

impl Default for AccurateDegree

fn default() -> AccurateDegree

Returns the “default value” for a type.

impl Display for AccurateDegree

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

Formats the value using the given formatter.

impl Eq for AccurateDegree

impl FromStr for AccurateDegree

type Err = ParseAngleError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Into<f64> for AccurateDegree

fn into(self) -> f64

Performs the conversion.

impl Ord for AccurateDegree

fn cmp(&self, other: &AccurateDegree) -> Ordering

This method returns an Ordering between self and other.

#[must_use]

pub fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]

pub fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]

pub fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl PartialEq<AccurateDegree> for AccurateDegree

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<AccurateDegree> for AccurateDegree

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

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

#[must_use]

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

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

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

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

#[must_use]

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

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

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

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

impl StructuralEq for AccurateDegree

impl StructuralPartialEq for AccurateDegree

impl Sub<AccurateDegree> for AccurateDegree

type Output = Self

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl TryFrom<[u16; 2]> for AccurateDegree

type Error = AngleNotInRange

The type returned in the event of a conversion error.

fn try_from(value: [u16; 2]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<[u16; 3]> for AccurateDegree

type Error = AngleNotInRange

The type returned in the event of a conversion error.

fn try_from(value: [u16; 3]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<[u16; 4]> for AccurateDegree

type Error = AngleNotInRange

The type returned in the event of a conversion error.

fn try_from(value: [u16; 4]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<(u16, u8, u8, u16)> for AccurateDegree

type Error = AngleNotInRange

The type returned in the event of a conversion error.

fn try_from(value: (u16, u8, u8, u16)) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<(u16, u8, u8)> for AccurateDegree

type Error = AngleNotInRange

The type returned in the event of a conversion error.

fn try_from(value: (u16, u8, u8)) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<(u16, u8)> for AccurateDegree

type Error = AngleNotInRange

The type returned in the event of a conversion error.

fn try_from(value: (u16, u8)) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<f64> for AccurateDegree

type Error = AngleNotInRange

The type returned in the event of a conversion error.

fn try_from(value: f64) -> Result<Self, Self::Error>

Use with caution: the floating numbers has bad precision in the fraction part

impl TryFrom<u16> for AccurateDegree

type Error = AngleNotInRange

The type returned in the event of a conversion error.

fn try_from(value: u16) -> Result<Self, Self::Error>

Performs the conversion.