Struct HeightOffset 

pub struct HeightOffset<F> { /* private fields */ }

Reads a field at a shifted height, so a field and its caller can use different height datums: wind(t, p) is the inner field’s wind at p.y + offset_m, with time and the horizontal position unchanged.

offset_m is the height of the caller’s y = 0 in the field’s datum. Convert in one place only: wrapping twice, or also shifting a profile’s levels, moves every wind by the offset again. The usual cases:

• y is height above sea level, as in rockets-engine: a LogProfile or EkmanProfile, which measure height from the ground, takes - the ground elevation. A sounding ProfileField in metres above sea level needs no wrapper there.
• y = 0 is the ground at elevation E: a sea-level sounding ProfileField takes +E.
• this crate’s TrajectorySolver, whose y = 0 is the level muzzle_height is measured from and whose ground runs along the line of sight: its ground_threshold check and its built-in boundary-layer shear (see crate::wind_shear) both take the shot-frame y as the height. So a LogProfile or EkmanProfile takes the bore’s real height above the ground minus muzzle_height on a level or an inclined shot alike: 0 when muzzle_height is that real height, the real height when muzzle_height is left at 0, as BallisticInputs::default() leaves it. Sea level stays level, so a sea-level sounding takes + the AtmosphericConditions::altitude on a level shot, where the solver’s own air puts y = 0. On an inclined shot (shooting angle θ) no constant offset fits: read the sounding at the altitude the solver’s air uses, altitude + x·sin θ + y·cos θ. Fields return winds in level axes; rotate them into the shot frame before comparing them with solver output.

Elevations are those of the place the positions are, not of the station that measured a sounding.

Implementations

impl<F> HeightOffset<F>

pub fn new(field: F, offset_m: f64) -> Result<HeightOffset<F>, WindFieldError>

Wrap field so it is read offset_m metres higher. The offset must be finite.

pub fn field(&self) -> &F

The wrapped field.

pub fn offset_m(&self) -> f64

The height added to every query, metres.

pub fn into_inner(self) -> F

Unwrap the field.

Trait Implementations

impl<F> Clone for HeightOffset<F>

where F: Clone,

fn clone(&self) -> HeightOffset<F>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<F> Copy for HeightOffset<F>

where F: Copy,

impl<F> Debug for HeightOffset<F>

where F: Debug,

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

Formats the value using the given formatter.

impl<F> PartialEq for HeightOffset<F>

where F: PartialEq,

fn eq(&self, other: &HeightOffset<F>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<F> StructuralPartialEq for HeightOffset<F>

where F: PartialEq,

impl<F> WindField for HeightOffset<F>

where F: WindField,

fn wind( &self, time_s: f64, position_m: Matrix<f64, Const<3>, Const<1>, ArrayStorage<f64, 3, 1>>, ) -> Matrix<f64, Const<3>, Const<1>, ArrayStorage<f64, 3, 1>>

World-frame air velocity (m/s) at a time and position.