pub struct AddedMass {
pub mass_kg: f64,
pub cg_aft_m: Option<f64>,
}Expand description
Mass a stage carries beyond what its parts weigh, such as glue and paint weighed on the finished rocket: a point mass added to the stage’s parts, motors not counted.
With parts of mass m_p whose center of mass is at station x_p, and an added mass m_a:
- No station (
cg_aft_misNone): the point sits at the parts’ center of mass. The stage weighsm_p + m_a; its center and its inertia about that center are the parts’. - A station
saft of the stage’s forward endx_0: the point sits atx_a = x_0 + salong the axis, as far off the axis as the parts’ center of mass is: on it when that center is, as on any rocket that is the same all the way round, and when the parts weigh nothing. The stage weighsm_p + m_a, its center is at(m_p x_p + m_a x_a) / (m_p + m_a), and its inertia about that center is the parts’ and the point’s by the parallel-axis theorem (MassProperties::combine).
The stage’s Overrides apply afterward, to the parts and the added mass together.
This is how OpenRocket 24.12 weighs a stage’s mass override that doesn’t cover the stage’s
parts (<overridesubcomponentsmass>false</overridesubcomponentsmass>, or no flag written). Its
user guide says such a value “is added to the calculated value” (Overrides and Surface
Finish); where the mass goes is measured on probe designs, which hold this rule’s mass,
center and inertia to OpenRocket’s structure (the decision record): at the center of the stage’s
own parts, or at the stage’s center of gravity override when that doesn’t cover the parts
either. A motor aboard doesn’t move it in OpenRocket, and a Layout holds no motor.
A parallel stage’s added mass is one point for the whole set of pods, not one for each: with no station at the pods’ center, and with one that far aft of the parallel stage’s forward end, as far off the axis as the pods’ center is. That is OpenRocket 24.12’s too, measured with three boosters and with one (the decision record).
The stage a parallel stage hangs on can carry an added mass at a station: a point among
that stage’s own parts. Rocket::layout refuses one there with no station, and one at a
station beside a parallel stage of one pod off the axis. OpenRocket weighs such a stage with
what hangs on it. With no station its point sits at the center of the stage and its pods
together, and moves when the pods drop. At a station beside one pod off the axis it sits as
far off the axis as that center, and on the axis once the pod is gone. A stage here is one
body that keeps its center.
An added mass of zero changes nothing. One above zero with no station, on a stage whose parts
weigh nothing, has no place to sit, and Rocket::layout refuses it.
Fields§
§mass_kg: f64The mass added, kg.
cg_aft_m: Option<f64>How far aft of the stage’s forward end it sits, m, as far off the axis as the center of
mass of the stage’s parts is: on the axis when that center is. None puts it at that
center.
Implementations§
Source§impl AddedMass
impl AddedMass
Sourcepub fn add_to(
&self,
parts: MassProperties,
fore_station_m: f64,
) -> Result<MassProperties, DesignError>
pub fn add_to( &self, parts: MassProperties, fore_station_m: f64, ) -> Result<MassProperties, DesignError>
parts with this mass added, a station measured from fore_station_m.
§Errors
DesignError::Domain for a negative or non-finite mass, a non-finite station, or a mass
with no station added to parts that weigh nothing.
Trait Implementations§
impl Copy for AddedMass
Source§impl<'de> Deserialize<'de> for AddedMass
impl<'de> Deserialize<'de> for AddedMass
Source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
Source§impl JsonSchema for AddedMass
impl JsonSchema for AddedMass
Source§fn schema_id() -> Cow<'static, str>
fn schema_id() -> Cow<'static, str>
Source§fn json_schema(generator: &mut SchemaGenerator) -> Schema
fn json_schema(generator: &mut SchemaGenerator) -> Schema
Source§fn inline_schema() -> bool
fn inline_schema() -> bool
$ref keyword. Read more