Struct WaypointPath 

pub struct WaypointPath { /* private fields */ }

A connected sequence of waypoints for distance, speed, and elevation analysis.

Implementations

impl WaypointPath

pub fn new(points: Vec<Waypoint>) -> Self

Creates a path from an owned list of waypoints.

pub fn from_slice(points: &[Waypoint]) -> Self

Creates a path from a slice of waypoints.

pub fn with_options(self, options: AnalysisOptions) -> Self

Returns a copy of this path with custom analysis thresholds.

pub fn from_track(track: &Track) -> Vec<WaypointPath>

One WaypointPath per track segment, preserving GPX gap semantics.

pub fn points(&self) -> &[Waypoint]

Ordered waypoints in this path.

pub fn len(&self) -> usize

Number of waypoints in this path.

pub fn is_empty(&self) -> bool

Whether this path contains no waypoints.

pub fn total_distance(&self) -> f64

Total horizontal distance along the path, in meters.

pub fn duration(&self) -> Option<Duration>

Elapsed time from the first to the last timestamped point.

pub fn moving_duration(&self) -> Option<Duration>

Time spent moving (legs at or above the moving-speed threshold).

pub fn average_speed(&self) -> Option<f64>

Average speed over the full duration, in m/s.

pub fn average_moving_speed(&self) -> Option<f64>

Average speed over moving time only, in m/s.

pub fn speeds(&self) -> Vec<Option<f64>>

Instantaneous speed for each leg (length = points - 1), in m/s.

pub fn max_speed(&self) -> Option<f64>

Maximum leg speed, in m/s.

pub fn min_speed(&self) -> Option<f64>

Minimum leg speed, in m/s.

pub fn speed_profile(&self) -> Vec<SpeedProfilePoint>

Timestamp versus speed at the start of each timed leg.

pub fn elevations(&self) -> Vec<Option<f64>>

Per-point elevation values, when present.

pub fn average_elevation(&self) -> Option<f64>

Mean elevation over points that have elevation data.

pub fn max_elevation(&self) -> Option<f64>

Highest elevation among points with elevation data.

pub fn min_elevation(&self) -> Option<f64>

Lowest elevation among points with elevation data.

pub fn elevation_difference(&self) -> Option<f64>

Elevation range from lowest to highest point with elevation data.

pub fn diff_elevation(&self) -> Option<f64>

Alias for elevation_difference.

pub fn total_ascent(&self) -> Option<f64>

Total uphill elevation gain between consecutive points with elevation data.

pub fn total_descent(&self) -> Option<f64>

Total downhill elevation loss between consecutive points with elevation data.

pub fn elevation_profile(&self) -> Vec<ProfilePoint>

Distance versus elevation for points with elevation data.

Distance is accumulated only between consecutive elevation-known points.

Trait Implementations

impl Clone for WaypointPath

fn clone(&self) -> WaypointPath

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WaypointPath

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

Formats the value using the given formatter.

impl From<&Route> for WaypointPath

fn from(route: &Route) -> Self

Converts to this type from the input type.

impl From<&TrackSegment> for WaypointPath

fn from(segment: &TrackSegment) -> Self

Converts to this type from the input type.

impl<'a> IntoIterator for &'a WaypointPath

type Item = &'a Waypoint

The type of the elements being iterated over.

type IntoIter = Iter<'a, Waypoint>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for WaypointPath

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl StructuralPartialEq for WaypointPath