Struct WindSock 

pub struct WindSock { /* private fields */ }

Wind condition handler for trajectory calculations

Implementations

impl WindSock

pub fn new(segments: Vec<WindSegment>) -> Self

Create a new WindSock from wind segments.

Legacy/unchecked entry point (MBA-1338): this constructor is infallible for API compatibility — a malformed segment is captured as a deferred error that the solver consumes at its pre-integration validation boundary, but a direct library consumer gets a constructed sock with no structured signal. Prefer WindSock::try_new (or TryFrom<Vec<WindSegment>>), which rejects malformed segments up front.

Args: segments: List of (speed_kmh, angle_deg, until_distance_m) tuples

pub fn try_new(segments: Vec<WindSegment>) -> Result<Self, WindSegmentError>

Create a new WindSock, rejecting malformed segments with a typed error (MBA-1338).

Validation runs before sorting and wind-vector precomputation, and the error’s index refers to the caller’s own segment ordering. Rejects non-finite or negative speed_kmh, non-finite angle_deg, non-finite or non-positive until_m, and non-finite vertical_mps.

pub fn max_speed_mps(&self) -> f64

Upper bound (m/s) on the wind speed any segment can contribute, horizontal plus vertical. Feeds the solver’s integration divergence guard (MBA-1293).

pub fn vector_for_range(&mut self, range_m: f64) -> Vector3<f64>

Get wind vector for a given range

Note: This modifies internal state and expects monotonically increasing ranges For trajectory integration, we need a stateless version

pub fn vector_for_range_stateless(&self, range_m: f64) -> Vector3<f64>

Get wind vector for a given range (stateless version)

This version doesn’t modify internal state and is safe for numerical integration where the same range might be queried multiple times or out of order

Trait Implementations

impl Clone for WindSock

fn clone(&self) -> WindSock

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WindSock

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

Formats the value using the given formatter.

impl TryFrom<Vec<WindSegment>> for WindSock

Checked conversion mirroring WindSock::try_new (MBA-1338).

type Error = WindSegmentError

The type returned in the event of a conversion error.

fn try_from(segments: Vec<WindSegment>) -> Result<Self, Self::Error>

Performs the conversion.