Struct Weathercock 

pub struct Weathercock { /* private fields */ }

Second-order weathercock: the body axis relaxes toward the relative wind with natural frequency ωₙ² = q·A·Cnα·(CP−CG)/I and exponential damping 2ζωₙ. Positive static margin (CP aft of CG) is stable; negative margin diverges, as it should. The axis and rate are snapshot-able state, updated once per public step with an explicit first-order-in-dt scheme, so choose the public cadence well below the axis’s natural period.

Implementations

impl Weathercock

pub fn new( params: WeathercockParams, initial_axis: Vec3, atmosphere: Atmosphere, wind_mps: Vec3, ) -> Result<Self>

initial_axis is the pad orientation (normalized at construction). atmosphere and wind_mps should match the force model’s air.

pub fn with_wind_segments( self, zones: Vec<(f64, f64, f64, f64)>, ) -> Result<Self>

Sample downrange-segmented wind like the force model does: each zone applies until its downrange limit, then the next takes over.

pub fn with_turbulence( self, sigma_mps: f64, tau_s: f64, seed: u64, ) -> Result<Self>

Add the same deterministic frozen-field turbulence as the force model: with equal sigma/tau/seed the gusts are identical, so the axis responds to the same air the drag sees.

pub fn axis(&self) -> Vec3

Current body axis (unit vector) — snapshot state for replay.

pub fn rate(&self) -> Vec3

Current angular-rate vector, perpendicular to the axis.

pub fn set_state(&mut self, axis: Vec3, rate: Vec3) -> Result<()>

Restore a previously snapshotted axis/rate pair.

pub fn with_wind_field( self, field: Arc<dyn WindField + Send + Sync>, ) -> Result<Self>

Sample the same winds-engine field as the force model, so the axis responds to the same air the drag sees.

Trait Implementations

impl Clone for Weathercock

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Weathercock

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

Formats the value using the given formatter.

impl Guidance for Weathercock

fn command(&mut self, context: GuidanceContext<'_>) -> Result<ControlInput>

Produce a finite control command, or explain why control cannot be computed.