Struct unit_sphere::Arc

pub struct Arc { /* private fields */ }

An Arc of a Great Circle on a unit sphere.

Implementations

impl Arc

pub const fn new( a: Vector3d, pole: Vector3d, length: Radians, half_width: Radians, ) -> Self

Construct an Arc

• a - the start point of the Arc.
• pole - the right hand pole of the Great Circle of the Arc.
• length - the length of the Arc.
• half_width - the half width of the Arc.

pub fn from_lat_lon_azi_length( a: &LatLong, azimuth: Angle, length: Radians, ) -> Self

Construct an Arc

• a - the start position
• azimuth - the azimuth at a.
• length - the length of the Arc.

pub fn between_positions(a: &LatLong, b: &LatLong) -> Self

Construct an Arc from the start and end positions.
Note: if the points are the same or antipodal, the pole will be invalid.

• a, b - the start and end positions

pub fn set_half_width(&mut self, half_width: Radians) -> &mut Self

Set the half_width of an Arc

• half_width - the half width of the Arc.

pub const fn a(&self) -> Vector3d

The start point of the Arc.

pub const fn pole(&self) -> Vector3d

The right hand pole of the Great Circle at the start point of the Arc.

pub const fn length(&self) -> Radians

The length of the Arc.

pub const fn half_width(&self) -> Radians

The half width of the Arc.

pub fn azimuth(&self) -> Angle

The azimuth at the start point.

pub fn direction(&self) -> Vector3d

The direction vector of the Arc at the start point.

pub fn position(&self, distance: Radians) -> Vector3d

pub fn b(&self) -> Vector3d

The end point of the Arc.

pub fn mid_point(&self) -> Vector3d

The mid point of the Arc.

pub fn perp_position(&self, point: &Vector3d, distance: Radians) -> Vector3d

The position of a perpendicular point at distance from the Arc.

• point a point on the Arc’s great circle.
• distance the perpendicular distance from the Arc’s great circle.

returns the point at perpendicular distance from point.

pub fn angle_position(&self, angle: Angle) -> Vector3d

The position of a point at angle from the Arc start, at Arc length.

• angle the angle from the Arc start.

returns the point at angle from the Arc start, at Arc length.

pub fn end_arc(&self, at_b: bool) -> Self

The Arc at the end of an Arc, just the point if half_width is zero. @param at_b if true the Arc at b, else the Arc at a.

@return the end Arc at a or b.

pub fn calculate_atd_and_xtd(&self, point: &Vector3d) -> (Radians, Radians)

Calculate great-circle along and across track distances of point from the Arc.

• point - the point.

returns the along and across track distances of the point in Radians.

Trait Implementations

impl Clone for Arc

fn clone(&self) -> Arc

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Arc

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

Formats the value using the given formatter.

impl PartialEq for Arc

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

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

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 TryFrom<(&LatLong, &LatLong)> for Arc

fn try_from(params: (&LatLong, &LatLong)) -> Result<Self, Self::Error>

Construct an Arc from a pair of positions.

• params - the start and end positions

type Error = &'static str

The type returned in the event of a conversion error.

impl Validate for Arc

fn is_valid(&self) -> bool

Test whether an Arc is valid. I.e. both a and pole are on the unit sphere and are orthogonal and both length and half_width are >= 0.0.

impl Copy for Arc

impl StructuralPartialEq for Arc