Struct Device 

#[non_exhaustive]
pub struct Device {
    pub name: String,
    pub drag: DeviceDrag,
    pub trigger: Trigger,
    pub lag_s: f64,
    pub inflation: Inflation,
    pub released_by: Option<usize>,
    pub body: usize,
}

A recovery device: a drag area, when it opens, and how it fills.

Build one with Device::new and the builders: the struct is #[non_exhaustive] so that streamers (M1.7b) and separation (M1.7c) can add fields without breaking callers.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

A name for reports.

drag: DeviceDrag

What gives it its drag area.

trigger: Trigger

When its charge fires.

lag_s: f64

Seconds from the trigger to line stretch, when the canopy starts to fill (RocketPy’s lag).

inflation: Inflation

How its drag area grows from line stretch.

released_by: Option<usize>

The device whose opening releases this one, by its index in the flight’s list: a drogue cut away once the main is fully open. A device released before its own charge fires never deploys.

body: usize

Which body it is attached to, after a separation (Separation) or an ejection (crate::Ejection): body 0 keeps the nose, body 1 is the separation’s aft stages, and each ejection’s piece the next number, in the order given, so with no separation the first ejection makes body 1. Without either there is only body 0.

Implementations

impl Device

pub fn new(name: impl Into<String>, drag: DeviceDrag, trigger: Trigger) -> Self

A device with no lag, opening at once and never released.

pub fn with_lag_s(self, lag_s: f64) -> Self

The same device with lag_s seconds from the trigger to line stretch.

pub fn with_inflation(self, inflation: Inflation) -> Self

The same device with an inflation law.

pub fn with_release_by(self, index: usize) -> Self

The same device, released when device index is fully open.

pub fn on_body(self, index: usize) -> Self

The same device, carried by body index after a separation (Separation) or an ejection (crate::Ejection); Self::body has the numbering. It acts only once that body flies on its own.

Trait Implementations

impl Clone for Device

fn clone(&self) -> Device

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Device

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Device

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Device

fn eq(&self, other: &Device) -> 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 Serialize for Device

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Device