Struct ThrustCurve 

pub struct ThrustCurve { /* private fields */ }

A thrust curve: thrust in newtons against time in seconds from ignition, joined by straight lines.

Built through ThrustCurve::new, which checks the samples; it serializes as its samples and re-checks them when deserialized.

Implementations

impl ThrustCurve

pub fn new(times_s: Vec<f64>, thrusts_n: Vec<f64>) -> Result<Self, MotorError>

Builds a curve from sample times (s) and thrusts (N). A (0, 0) sample is prepended when the first time is after zero.

Errors

• MotorError::Inconsistent if the columns differ in length or are empty.
• MotorError::Domain for a time or thrust that is not finite, a negative time, or a negative thrust.
• MotorError::TimesDecreasing if a time is before its predecessor. Equal times are a step.
• MotorError::NoThrust if the total impulse or the NFPA 1125 burn time is not positive (no positive thrust, or thrust only at a single instant).

pub fn times_s(&self) -> &[f64]

The sample times, s, starting at 0 (including a prepended (0, 0)).

pub fn thrusts_n(&self) -> &[f64]

The thrust at each sample time, N.

pub fn end_time_s(&self) -> f64

The last sample time, s. The thrust is zero from here on, this instant included.

pub fn peak_thrust_n(&self) -> f64

The peak thrust, N: the largest delivered sample (see the module docs), which is the least upper bound of ThrustCurve::thrust_n over time. A sample the thrust steps past inside a run of three or more equal times does not count.

pub fn total_impulse_ns(&self) -> f64

The total impulse I = ∫ F dt, N·s.

pub fn thrust_n(&self, t: f64) -> f64

The thrust at time t (s after ignition), N: linear between samples, zero before ignition and from the last sample on. A NaN time gives NaN.

Like any step, the end of the curve takes the later value at its own instant: a curve that ends above zero thrust gives zero at its last sample time, when all the propellant is gone.

pub fn impulse_ns(&self, t: f64) -> f64

The impulse delivered by time t, I(t) = ∫₀ᵗ F dt, N·s: exact for the piecewise-linear thrust, zero before ignition and the total impulse after the last sample. A NaN time gives NaN.

pub fn burn_window_s(&self) -> (f64, f64)

The NFPA 1125 burn window (start, end), s: when the thrust first reaches, and last falls to, NFPA_1125_THRESHOLD of its peak, interpolated on the straight segments. Only delivered samples (see the module docs) are compared with the threshold.

pub fn burn_time_s(&self) -> f64

The NFPA 1125 burn time, s: the length of ThrustCurve::burn_window_s.

pub fn average_thrust_n(&self) -> f64

The average thrust, N: the total impulse over the NFPA 1125 burn time.

Trait Implementations

impl Clone for ThrustCurve

fn clone(&self) -> ThrustCurve

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThrustCurve

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ThrustCurve

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for ThrustCurve

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for ThrustCurve

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

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 ThrustCurve