STAR
Cal STAR — firmware, DAQ server, and engine design
Loading...
Searching...
No Matches
engine.pipeline.tank_capacity Namespace Reference

Functions

float resolve_propellant_tank_fill_factor (Any config)
float resolve_cylindrical_tank_volume_m3 (Any tank_section, *, str height_attr, str radius_attr)
Tuple[float, float, float, bool] resolve_max_propellant_mass_kg (Any config, *, str branch, float density_kg_m3, Any tank_section, str height_attr, str radius_attr, str capacity_kg_attr)
Tuple[float, float, float, bool] resolve_lox_tank_limits (Any config, float density_kg_m3)
Tuple[float, float, float, bool] resolve_fuel_tank_limits (Any config, float density_kg_m3)

Variables

float DEFAULT_PROPELLANT_TANK_FILL_FACTOR = 0.90

Detailed Description

Propellant tank capacity helpers for flight simulation.

Max loadable propellant mass is resolved from config — not a hardcoded fill fraction.
Priority:
  1. design_requirements.{lox,fuel}_tank_capacity_kg (explicit mass cap)
  2. tank_volume_m3 × density × fill_factor
  3. π r² h × density × fill_factor

Fill factor comes from design_requirements.propellant_tank_fill_factor (default 0.90).

Function Documentation

◆ resolve_cylindrical_tank_volume_m3()

float engine.pipeline.tank_capacity.resolve_cylindrical_tank_volume_m3 ( Any tank_section,
* ,
str height_attr,
str radius_attr )

Definition at line 32 of file tank_capacity.py.

Referenced by resolve_max_propellant_mass_kg().

◆ resolve_fuel_tank_limits()

Tuple[float, float, float, bool] engine.pipeline.tank_capacity.resolve_fuel_tank_limits ( Any config,
float density_kg_m3 )

Definition at line 100 of file tank_capacity.py.

References resolve_max_propellant_mass_kg().

◆ resolve_lox_tank_limits()

Tuple[float, float, float, bool] engine.pipeline.tank_capacity.resolve_lox_tank_limits ( Any config,
float density_kg_m3 )

Definition at line 88 of file tank_capacity.py.

References resolve_max_propellant_mass_kg().

◆ resolve_max_propellant_mass_kg()

Tuple[float, float, float, bool] engine.pipeline.tank_capacity.resolve_max_propellant_mass_kg ( Any config,
* ,
str branch,
float density_kg_m3,
Any tank_section,
str height_attr,
str radius_attr,
str capacity_kg_attr )
Return (max_mass_kg, volume_m3, fill_factor, used_explicit_capacity).

If design_requirements.{branch}_tank_capacity_kg is set, that mass is used directly
(fill_factor still reported for diagnostics).

Definition at line 54 of file tank_capacity.py.

References resolve_cylindrical_tank_volume_m3(), and resolve_propellant_tank_fill_factor().

Referenced by resolve_fuel_tank_limits(), and resolve_lox_tank_limits().

◆ resolve_propellant_tank_fill_factor()

float engine.pipeline.tank_capacity.resolve_propellant_tank_fill_factor ( Any config)
Fill fraction of internal tank volume used for flight-sim mass caps (0–1).

Definition at line 20 of file tank_capacity.py.

Referenced by resolve_max_propellant_mass_kg().

Variable Documentation

◆ DEFAULT_PROPELLANT_TANK_FILL_FACTOR

float engine.pipeline.tank_capacity.DEFAULT_PROPELLANT_TANK_FILL_FACTOR = 0.90

Definition at line 17 of file tank_capacity.py.