pub struct Coord<T = f64>
where T: CoordNum,
{ pub x: T, pub y: T, }
Expand description

A lightweight struct used to store coordinates on the 2-dimensional Cartesian plane.

Unlike Point (which in the future may contain additional information such as an envelope, a precision model, and spatial reference system information), a Coord only contains ordinate values and accessor methods.

This type implements the vector space operations: Add, Sub, Neg, Zero, Mul<T>, and Div<T> traits.

Semantics

This type does not represent any geospatial primitive, but is used in their definitions. The only requirement is that the coordinates it contains are valid numbers (for eg. not f64::NAN).

Fields§

§x: T§y: T

Implementations§

§

impl<T> Coord<T>
where T: CoordNum,

pub fn x_y(&self) -> (T, T)

Returns a tuple that contains the x/horizontal & y/vertical component of the coordinate.

Examples
use geo_types::coord;

let c = coord! {
    x: 40.02f64,
    y: 116.34,
};
let (x, y) = c.x_y();

assert_eq!(y, 116.34);
assert_eq!(x, 40.02f64);
§

impl<T> Coord<T>
where T: CoordNum,

Create a coordinate at the origin.

Examples

use geo_types::Coord;
use num_traits::Zero;

let p: Coord = Zero::zero();

assert_eq!(p.x, 0.);
assert_eq!(p.y, 0.);

pub fn zero() -> Coord<T>

Trait Implementations§

§

impl<T> AbsDiffEq for Coord<T>
where T: CoordNum + AbsDiffEq, <T as AbsDiffEq>::Epsilon: Copy,

§

type Epsilon = <T as AbsDiffEq>::Epsilon

Used for specifying relative comparisons.
§

fn default_epsilon() -> <T as AbsDiffEq>::Epsilon

The default tolerance to use when testing values that are close together. Read more
§

fn abs_diff_eq( &self, other: &Coord<T>, epsilon: <T as AbsDiffEq>::Epsilon ) -> bool

A test for equality that uses the absolute difference to compute the approximate equality of two numbers.
§

fn abs_diff_ne(&self, other: &Rhs, epsilon: Self::Epsilon) -> bool

The inverse of [AbsDiffEq::abs_diff_eq].
§

impl<T> Add for Coord<T>
where T: CoordNum,

Add two coordinates.

Examples

use geo_types::coord;

let p = coord! { x: 1.25, y: 2.5 };
let q = coord! { x: 1.5, y: 2.5 };
let sum = p + q;

assert_eq!(sum.x, 2.75);
assert_eq!(sum.y, 5.0);
§

type Output = Coord<T>

The resulting type after applying the + operator.
§

fn add(self, rhs: Coord<T>) -> Coord<T>

Performs the + operation. Read more
§

impl<T> Clone for Coord<T>
where T: Clone + CoordNum,

§

fn clone(&self) -> Coord<T>

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
§

impl<T> Debug for Coord<T>
where T: Debug + CoordNum,

§

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

Formats the value using the given formatter. Read more
§

impl<T> Default for Coord<T>
where T: Default + CoordNum,

§

fn default() -> Coord<T>

Returns the “default value” for a type. Read more
§

impl<T> Div<T> for Coord<T>
where T: CoordNum,

Divide coordinate wise by a scalar.

Examples

use geo_types::coord;

let p = coord! { x: 5., y: 10. };
let q = p / 4.;

assert_eq!(q.x, 1.25);
assert_eq!(q.y, 2.5);
§

type Output = Coord<T>

The resulting type after applying the / operator.
§

fn div(self, rhs: T) -> Coord<T>

Performs the / operation. Read more
§

impl<T> From<[T; 2]> for Coord<T>
where T: CoordNum,

§

fn from(coords: [T; 2]) -> Coord<T>

Converts to this type from the input type.
§

impl<T> From<(T, T)> for Coord<T>
where T: CoordNum,

§

fn from(coords: (T, T)) -> Coord<T>

Converts to this type from the input type.
§

impl<T> From<Coord<T>> for Point<T>
where T: CoordNum,

§

fn from(x: Coord<T>) -> Point<T>

Converts to this type from the input type.
§

impl From<GeoPoint> for Coord

§

fn from(field: GeoPoint) -> Coord

Converts to this type from the input type.
§

impl<T> From<Point<T>> for Coord<T>
where T: CoordNum,

§

fn from(point: Point<T>) -> Coord<T>

Converts to this type from the input type.
§

impl<T> Hash for Coord<T>
where T: Hash + CoordNum,

§

fn hash<__H>(&self, state: &mut __H)
where __H: Hasher,

Feeds this value into the given Hasher. Read more
1.3.0 · source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
§

impl<T> Mul<T> for Coord<T>
where T: CoordNum,

Multiply coordinate wise by a scalar.

Examples

use geo_types::coord;

let p = coord! { x: 1.25, y: 2.5 };
let q = p * 4.;

assert_eq!(q.x, 5.0);
assert_eq!(q.y, 10.0);
§

type Output = Coord<T>

The resulting type after applying the * operator.
§

fn mul(self, rhs: T) -> Coord<T>

Performs the * operation. Read more
§

impl<T> Neg for Coord<T>
where T: CoordNum + Neg<Output = T>,

Negate a coordinate.

Examples

use geo_types::coord;

let p = coord! { x: 1.25, y: 2.5 };
let q = -p;

assert_eq!(q.x, -p.x);
assert_eq!(q.y, -p.y);
§

type Output = Coord<T>

The resulting type after applying the - operator.
§

fn neg(self) -> Coord<T>

Performs the unary - operation. Read more
§

impl<T> PartialEq for Coord<T>
where T: PartialEq + CoordNum,

§

fn eq(&self, other: &Coord<T>) -> bool

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

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

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

impl<T> Point for Coord<T>
where T: Float + RTreeNum,

§

type Scalar = T

The number type used by this point type.
§

const DIMENSIONS: usize = 2usize

The number of dimensions of this point type.
§

fn generate( generator: impl FnMut(usize) -> <Coord<T> as Point>::Scalar ) -> Coord<T>

Creates a new point value with given values for each dimension. Read more
§

fn nth(&self, index: usize) -> <Coord<T> as Point>::Scalar

Returns a single coordinate of this point. Read more
§

fn nth_mut(&mut self, index: usize) -> &mut <Coord<T> as Point>::Scalar

Mutable variant of nth.
§

impl<T> RelativeEq for Coord<T>
where T: CoordNum + RelativeEq, <T as AbsDiffEq>::Epsilon: Copy,

§

fn default_max_relative() -> <T as AbsDiffEq>::Epsilon

The default relative tolerance for testing values that are far-apart. Read more
§

fn relative_eq( &self, other: &Coord<T>, epsilon: <T as AbsDiffEq>::Epsilon, max_relative: <T as AbsDiffEq>::Epsilon ) -> bool

A test for equality that uses a relative comparison if the values are far apart.
§

fn relative_ne( &self, other: &Rhs, epsilon: Self::Epsilon, max_relative: Self::Epsilon ) -> bool

The inverse of [RelativeEq::relative_eq].
§

impl<T> Sub for Coord<T>
where T: CoordNum,

Subtract a coordinate from another.

Examples

use geo_types::coord;

let p = coord! { x: 1.5, y: 2.5 };
let q = coord! { x: 1.25, y: 2.5 };
let diff = p - q;

assert_eq!(diff.x, 0.25);
assert_eq!(diff.y, 0.);
§

type Output = Coord<T>

The resulting type after applying the - operator.
§

fn sub(self, rhs: Coord<T>) -> Coord<T>

Performs the - operation. Read more
§

impl<T> UlpsEq for Coord<T>
where T: CoordNum + UlpsEq, <T as AbsDiffEq>::Epsilon: Copy,

§

fn default_max_ulps() -> u32

The default ULPs to tolerate when testing values that are far-apart. Read more
§

fn ulps_eq( &self, other: &Coord<T>, epsilon: <T as AbsDiffEq>::Epsilon, max_ulps: u32 ) -> bool

A test for equality that uses units in the last place (ULP) if the values are far apart.
§

fn ulps_ne(&self, other: &Rhs, epsilon: Self::Epsilon, max_ulps: u32) -> bool

The inverse of [UlpsEq::ulps_eq].
§

impl<T> Zero for Coord<T>
where T: CoordNum,

§

fn zero() -> Coord<T>

Returns the additive identity element of Self, 0. Read more
§

fn is_zero(&self) -> bool

Returns true if self is equal to the additive identity.
source§

fn set_zero(&mut self)

Sets self to the additive identity element of Self, 0.
§

impl<T> Copy for Coord<T>
where T: Copy + CoordNum,

§

impl<T> Eq for Coord<T>
where T: Eq + CoordNum,

§

impl<T> StructuralEq for Coord<T>
where T: CoordNum,

§

impl<T> StructuralPartialEq for Coord<T>
where T: CoordNum,

Auto Trait Implementations§

§

impl<T> RefUnwindSafe for Coord<T>
where T: RefUnwindSafe,

§

impl<T> Send for Coord<T>
where T: Send,

§

impl<T> Sync for Coord<T>
where T: Sync,

§

impl<T> Unpin for Coord<T>
where T: Unpin,

§

impl<T> UnwindSafe for Coord<T>
where T: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<T> CallHasher for T
where T: Hash + ?Sized,

§

fn get_hash<H, B>(value: &H, build_hasher: &B) -> u64
where H: Hash + ?Sized, B: BuildHasher,

source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> FromRef<T> for T
where T: Clone,

§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoRequest<T> for T

source§

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
§

impl<P> PointDistance for P
where P: Point,

§

fn distance_2(&self, point: &P) -> <P as Point>::Scalar

Returns the squared euclidean distance between an object to a point.
§

fn contains_point( &self, point: &<<P as RTreeObject>::Envelope as Envelope>::Point ) -> bool

Returns true if a point is contained within this object. Read more
§

fn distance_2_if_less_or_equal( &self, point: &<<P as RTreeObject>::Envelope as Envelope>::Point, max_distance_2: <<<P as RTreeObject>::Envelope as Envelope>::Point as Point>::Scalar ) -> Option<<P as Point>::Scalar>

Returns the squared distance to this object, or None if the distance is larger than a given maximum value. Read more
§

impl<P> RTreeObject for P
where P: Point,

§

type Envelope = AABB<P>

The object’s envelope type. Usually, [AABB] will be the right choice. This type also defines the object’s dimensionality.
§

fn envelope(&self) -> AABB<P>

Returns the object’s envelope. Read more
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more