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 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 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.