Struct Rocket 

pub struct Rocket {
    pub name: String,
    pub stages: Vec<Stage>,
    pub reference_diameter: ReferenceDiameter,
    pub configurations: Vec<Configuration>,
}

A rocket design: its stages, how its reference diameter is chosen, and its motor configurations.

Fields

name: String

Name.

stages: Vec<Stage>

Stages from the nose aft. The first holds the nose cone. A parallel stage comes after the stage it hangs on (Stage::parallel).

reference_diameter: ReferenceDiameter

How the reference diameter is chosen.

configurations: Vec<Configuration>

Motor configurations.

Implementations

impl Rocket

pub fn configuration(&self, id: &str) -> Option<&Configuration>

The configuration with id id.

pub fn check_configuration_ids(&self) -> Result<(), DesignError>

Checks that configuration ids are unique and non-empty.

Errors

DesignError::DuplicateId for the first empty or repeated id.

pub fn assemble(&self, configuration_id: &str) -> Result<Assembly, DesignError>

Resolves the tree and places the motors of configuration configuration_id.

Errors

• As Rocket::layout and Layout::place_motors.
• DesignError::DuplicateId for an empty or repeated configuration id.
• DesignError::UnknownId for a configuration that doesn’t exist.

pub fn lay_out(&self) -> Result<LaidOut, DesignError>

Lays the design out once (Rocket::layout), to check it (LaidOut::check) and assemble it (LaidOut::into_assembly) without laying it out again: the layout is most of the cost of either, and a Monte Carlo run builds a flight thousands of times.

Errors

As Rocket::check_configuration_ids and Rocket::layout.

impl Rocket

pub fn layout(&self) -> Result<Layout, DesignError>

Resolves the tree: checks its structure, fills in automatic dimensions, places every part, and computes the mass properties with overrides.

Errors

• DesignError::DuplicateId for an empty or repeated stage or component id.
• DesignError::Tree for a rocket with no stages, an empty stage, a part in the wrong place (an attached part in a stage’s list, a body component attached anywhere but in a pod set, anything else in a pod set, fins or pods on anything but a body tube, a pod set in a pod, children under anything but a body component, inner tube or pod set), a pod set with an override that doesn’t cover its pods, a missing or unexpected position, an automatic dimension that doesn’t apply or can’t be resolved, or a motor mount on anything but a body tube or inner tube.
• DesignError::Domain for a pod set of no pods or more than PodSet::MAX_COUNT, a radial offset or angle out of range, or a body component of no length in a stage.
• Any part’s geometry, material or numerical error, a custom finish’s negative or non-finite roughness, and override errors.

pub fn unresolvable_body_radii(&self) -> Vec<UnresolvableRadius>

The automatic body radii that layout cannot resolve, forward to aft.

These are the radii on a chain of automatic radii with no fixed radius anywhere along it: a nose cone whose base looks back at a tube that looks forward at it, or a stage of tubes that all say “automatic”. Neighbours are followed by the rule each AutoDimension documents. layout refuses a design for which this list is not empty; what such a radius should be is not in the design, so an importer that knows its source program’s convention fills them in first (fill_unresolvable_body_radii).

A parallel stage’s body components are not listed: they take their radii from one another, as a pod’s do, and layout refuses one it can’t resolve.

Only the body components’ own radii are listed. An automatic shoulder with no body tube beside it, or an automatic dimension a part does not have, is refused by layout with its own error instead.

pub fn fill_unresolvable_body_radii( &mut self, radius_m: f64, ) -> Vec<UnresolvableRadius>

Gives every radius unresolvable_body_radii lists the fixed radius radius_m, drops its automatic mark, and returns what it filled.

Every radius on such a chain is listed, so the whole chain takes the one radius. Radii the neighbour rule could already reach are left as they are and resolve as before. The design no longer records that the filled radii were automatic, which is the point: it now says what they are.

Trait Implementations

impl Clone for Rocket

fn clone(&self) -> Rocket

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Rocket

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Rocket

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Rocket

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 Rocket

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

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 Rocket