|
STAR
Cal STAR — firmware, DAQ server, and engine design
|
Physical and engineering constants used throughout the pintle engine pipeline.
This module centralizes all magic numbers and default values to improve maintainability
and make the physical meaning of constants explicit.
⚠️ IMPORTANT: DEPRECATED DEFAULT/FALLBACK CONSTANTS ⚠️
===========================================================
Many constants in this file with names starting with DEFAULT_* or FALLBACK_*
are DEPRECATED and should NOT be used to hide missing values or failed calculations.
WRONG usage (DO NOT DO THIS):
gamma = cea_props.get("gamma", DEFAULT_GAMMA_ND) # WRONG!
density = max(calculated_density, MIN_DENS_KG_M3) # WRONG!
CORRECT usage:
if "gamma" not in cea_props:
raise KeyError("Missing gamma in CEA properties")
gamma = cea_props["gamma"]
if not (1.0 < gamma < 2.0):
raise ValueError(f"Invalid gamma: {gamma}")
These constants should only be used for:
1. Physical limits (e.g., GRAVITATIONAL_ACCEL_M_S2)
2. Model parameters explicitly chosen by design (not fallbacks)
3. Testing with explicit test data
===========================================================
Naming Convention:
- All constants include units in their names (e.g., _K, _PA, _M, _M_S)
- Dimensionless constants use _ND suffix (non-dimensional)
- This prevents unit confusion and makes conversions explicit
| float engine.pipeline.constants.ACTIVATION_ENERGY_H2_J_MOL = 40000.0 |
Definition at line 173 of file constants.py.
| float engine.pipeline.constants.ACTIVATION_ENERGY_HC_J_MOL = 80000.0 |
Definition at line 172 of file constants.py.
| float engine.pipeline.constants.CRITICAL_DAMPING_RATIO_ND = 0.05 |
Definition at line 310 of file constants.py.
| float engine.pipeline.constants.DEFAULT_ABLATOR_BLOWING_EFF_ND = 0.8 |
Definition at line 206 of file constants.py.
| float engine.pipeline.constants.DEFAULT_ABLATOR_CHAR_LAYER_COND_W_M_K = 0.2 |
Definition at line 207 of file constants.py.
| float engine.pipeline.constants.DEFAULT_ABLATOR_CHAR_LAYER_THICK_M = 0.001 |
Definition at line 208 of file constants.py.
| float engine.pipeline.constants.DEFAULT_ABLATOR_DENS_KG_M3 = 1600.0 |
Definition at line 200 of file constants.py.
| float engine.pipeline.constants.DEFAULT_ABLATOR_INIT_THICK_M = 0.01 |
Definition at line 203 of file constants.py.
| float engine.pipeline.constants.DEFAULT_ABLATOR_PYROLYSIS_TEMP_K = 900.0 |
Definition at line 205 of file constants.py.
| float engine.pipeline.constants.DEFAULT_ABLATOR_SPEC_HEAT_J_KG_K = 1500.0 |
Definition at line 202 of file constants.py.
| float engine.pipeline.constants.DEFAULT_ABLATOR_SURF_TEMP_LIMIT_K = 1200.0 |
Definition at line 204 of file constants.py.
| float engine.pipeline.constants.DEFAULT_ABLATOR_THERMAL_COND_W_M_K = 0.35 |
Definition at line 201 of file constants.py.
| float engine.pipeline.constants.DEFAULT_CHAMBER_DIAM_M = 0.08 |
Definition at line 152 of file constants.py.
| float engine.pipeline.constants.DEFAULT_CHAMBER_LEN_M = 0.1 |
Definition at line 148 of file constants.py.
| float engine.pipeline.constants.DEFAULT_CHAMBER_PRESS_PA = 4.0e6 |
Definition at line 87 of file constants.py.
| float engine.pipeline.constants.DEFAULT_CHAMBER_TEMP_K = 3500.0 |
Definition at line 73 of file constants.py.
| float engine.pipeline.constants.DEFAULT_CHAMBER_TIME_CONST_S = 0.01 |
Definition at line 318 of file constants.py.
| float engine.pipeline.constants.DEFAULT_COOLANT_DENS_KG_M3 = 700.0 |
Definition at line 96 of file constants.py.
| float engine.pipeline.constants.DEFAULT_COOLANT_SPEC_HEAT_J_KG_K = 2000.0 |
Definition at line 94 of file constants.py.
| float engine.pipeline.constants.DEFAULT_COOLANT_TEMP_K = 300.0 |
Definition at line 97 of file constants.py.
| float engine.pipeline.constants.DEFAULT_COOLANT_THERMAL_COND_W_M_K = 0.1 |
Definition at line 95 of file constants.py.
| float engine.pipeline.constants.DEFAULT_CSTAR_IDEAL_M_S = 1800.0 |
Definition at line 79 of file constants.py.
| float engine.pipeline.constants.DEFAULT_DECAY_CONST_ND = 3.0 |
Definition at line 337 of file constants.py.
| float engine.pipeline.constants.DEFAULT_EFFICIENCY_C_ND = 0.3 |
Definition at line 326 of file constants.py.
| float engine.pipeline.constants.DEFAULT_EFFICIENCY_K_ND = 0.15 |
Definition at line 327 of file constants.py.
| float engine.pipeline.constants.DEFAULT_EMISSIVITY_ND = 0.8 |
Definition at line 116 of file constants.py.
| float engine.pipeline.constants.DEFAULT_EVAP_FACTOR_ND = 0.5 |
Definition at line 379 of file constants.py.
| float engine.pipeline.constants.DEFAULT_EVAPORATION_LEN_M = 0.1 |
Definition at line 250 of file constants.py.
| float engine.pipeline.constants.DEFAULT_FEED_DIAMETER_M = 0.01 |
Definition at line 314 of file constants.py.
| float engine.pipeline.constants.DEFAULT_FEED_LENGTH_M = 1.0 |
Definition at line 313 of file constants.py.
| float engine.pipeline.constants.DEFAULT_FILM_BLOWING_EXP_ND = 0.6 |
Definition at line 237 of file constants.py.
| float engine.pipeline.constants.DEFAULT_FILM_DECAY_LEN_M = 0.1 |
Definition at line 235 of file constants.py.
| float engine.pipeline.constants.DEFAULT_FILM_EFF_REF_ND = 0.4 |
Definition at line 234 of file constants.py.
| float engine.pipeline.constants.DEFAULT_FILM_MASS_FRAC_ND = 0.05 |
Definition at line 233 of file constants.py.
| float engine.pipeline.constants.DEFAULT_FILM_REF_BLOWING_RATIO_ND = 0.5 |
Definition at line 236 of file constants.py.
| float engine.pipeline.constants.DEFAULT_FILM_REF_WALL_TEMP_K = 1100.0 |
Definition at line 238 of file constants.py.
| float engine.pipeline.constants.DEFAULT_FROZEN_FLOW_PARAM_ND = 0.1 |
Definition at line 330 of file constants.py.
| float engine.pipeline.constants.DEFAULT_FUEL_BOILING_POINT_K = 489.0 |
Definition at line 101 of file constants.py.
| float engine.pipeline.constants.DEFAULT_FUEL_DENS_KG_M3 = 810.0 |
Definition at line 100 of file constants.py.
| float engine.pipeline.constants.DEFAULT_GAMMA_ND = 1.2 |
Definition at line 60 of file constants.py.
| float engine.pipeline.constants.DEFAULT_GAS_CONST_J_KG_K = 350.0 |
Definition at line 67 of file constants.py.
| float engine.pipeline.constants.DEFAULT_GRAPHITE_CHAR_LAYER_COND_W_M_K = 5.0 |
Definition at line 226 of file constants.py.
| float engine.pipeline.constants.DEFAULT_GRAPHITE_CHAR_LAYER_THICK_M = 0.0005 |
Definition at line 227 of file constants.py.
| float engine.pipeline.constants.DEFAULT_GRAPHITE_DENS_KG_M3 = 1800.0 |
Definition at line 221 of file constants.py.
| int engine.pipeline.constants.DEFAULT_GRAPHITE_OXIDATION_RATE_M_S = 1e-6 |
Definition at line 225 of file constants.py.
| float engine.pipeline.constants.DEFAULT_GRAPHITE_OXIDATION_TEMP_K = 800.0 |
Definition at line 224 of file constants.py.
| float engine.pipeline.constants.DEFAULT_GRAPHITE_SURF_TEMP_LIMIT_K = 2500.0 |
Definition at line 223 of file constants.py.
| float engine.pipeline.constants.DEFAULT_GRAPHITE_THERMAL_COND_W_M_K = 100.0 |
Definition at line 222 of file constants.py.
| float engine.pipeline.constants.DEFAULT_HEAT_ABLATION_J_KG = 2.5e6 |
Definition at line 212 of file constants.py.
| float engine.pipeline.constants.DEFAULT_HOT_GAS_PRANDTL_ND = 0.7 |
Definition at line 109 of file constants.py.
| float engine.pipeline.constants.DEFAULT_HOT_GAS_THERMAL_COND_W_M_K = 0.1 |
Definition at line 108 of file constants.py.
| float engine.pipeline.constants.DEFAULT_HOT_GAS_VISC_PA_S = 4.0e-5 |
Definition at line 107 of file constants.py.
| float engine.pipeline.constants.DEFAULT_LOX_DENS_KG_M3 = 1140.0 |
Definition at line 104 of file constants.py.
| float engine.pipeline.constants.DEFAULT_MIXING_EFFICIENCY_ND = 1.0 |
Definition at line 374 of file constants.py.
| float engine.pipeline.constants.DEFAULT_MIXTURE_RATIO_ND = 2.5 |
Definition at line 83 of file constants.py.
| float engine.pipeline.constants.DEFAULT_POWER_EXP_ND = 2.0 |
Definition at line 340 of file constants.py.
| float engine.pipeline.constants.DEFAULT_PROGRESS_INJECTION_ND = 0.0 |
Definition at line 386 of file constants.py.
| float engine.pipeline.constants.DEFAULT_PROGRESS_MID_ND = 0.5 |
Definition at line 387 of file constants.py.
| float engine.pipeline.constants.DEFAULT_PROGRESS_THROAT_ND = 1.0 |
Definition at line 388 of file constants.py.
| float engine.pipeline.constants.DEFAULT_REACTION_TIME_REF_S = 0.005 |
Definition at line 187 of file constants.py.
| float engine.pipeline.constants.DEFAULT_RECOVERY_FACTOR_ND = 0.94 |
Definition at line 139 of file constants.py.
| float engine.pipeline.constants.DEFAULT_SMD_FACTOR_ND = 0.5 |
Definition at line 378 of file constants.py.
| int engine.pipeline.constants.DEFAULT_SMD_M = 100e-6 |
Definition at line 246 of file constants.py.
| int engine.pipeline.constants.DEFAULT_THROAT_AREA_M2 = 1e-3 |
Definition at line 156 of file constants.py.
| float engine.pipeline.constants.DEFAULT_THROAT_DIAM_M = 0.033 |
Definition at line 160 of file constants.py.
| float engine.pipeline.constants.DEFAULT_THROAT_RECESSION_MULT_ND = 1.3 |
Definition at line 215 of file constants.py.
| float engine.pipeline.constants.DEFAULT_TURBULENCE_EFFICIENCY_ND = 0.9 |
Definition at line 375 of file constants.py.
| float engine.pipeline.constants.DEFAULT_TURBULENCE_INTENSITY_COOLANT_ND = 0.05 |
Definition at line 122 of file constants.py.
| float engine.pipeline.constants.DEFAULT_TURBULENCE_INTENSITY_ND = 0.08 |
Definition at line 121 of file constants.py.
| float engine.pipeline.constants.DEFAULT_VIEW_FACTOR_ND = 1.0 |
Definition at line 117 of file constants.py.
| float engine.pipeline.constants.DEFAULT_WEBER_MIN_ND = 15.0 |
Definition at line 253 of file constants.py.
| float engine.pipeline.constants.EA_NORM_FUEL_RICH_ND = 12.0 |
Definition at line 191 of file constants.py.
| float engine.pipeline.constants.EA_NORM_OXIDIZER_RICH_ND = 8.0 |
Definition at line 193 of file constants.py.
| float engine.pipeline.constants.EA_NORM_STOICHIOMETRIC_ND = 10.0 |
Definition at line 192 of file constants.py.
| int engine.pipeline.constants.EPSILON_SMALL = 1e-6 |
Definition at line 260 of file constants.py.
| int engine.pipeline.constants.EPSILON_TINY = 1e-8 |
Definition at line 261 of file constants.py.
| float engine.pipeline.constants.FALLBACK_DENS_KG_M3 = 1.0 |
Definition at line 298 of file constants.py.
| float engine.pipeline.constants.FALLBACK_MACH_NUMBER_ND = 0.01 |
Definition at line 301 of file constants.py.
| float engine.pipeline.constants.FALLBACK_RESIDENCE_TIME_S = 0.001 |
Definition at line 302 of file constants.py.
| float engine.pipeline.constants.FALLBACK_REYNOLDS_NUMBER_ND = 10000.0 |
Definition at line 303 of file constants.py.
| float engine.pipeline.constants.FALLBACK_SOUND_SPEED_M_S = 1000.0 |
Definition at line 299 of file constants.py.
| float engine.pipeline.constants.FALLBACK_VELOCITY_M_S = 50.0 |
Definition at line 300 of file constants.py.
| tuple engine.pipeline.constants.FEED_LINE_D_3_8_IN_NOMINAL_M = (3.0 / 8.0) * 25.4e-3 |
Definition at line 404 of file constants.py.
| float engine.pipeline.constants.FEED_LINE_DUAL_3_8_EQUIVALENT_A_HYDRAULIC_M2 |
Definition at line 414 of file constants.py.
| tuple engine.pipeline.constants.FEED_LINE_DUAL_3_8_EQUIVALENT_D_INLET_M = FEED_LINE_D_3_8_IN_NOMINAL_M * (2.0 ** 0.5) |
Definition at line 411 of file constants.py.
| float engine.pipeline.constants.FEET_TO_METERS = 0.3048 |
Definition at line 354 of file constants.py.
| float engine.pipeline.constants.GRAVITATIONAL_ACCEL_M_S2 = 9.80665 |
Definition at line 49 of file constants.py.
| float engine.pipeline.constants.K_ENTRANCE_SHARP_ND = 0.5 |
Definition at line 347 of file constants.py.
| float engine.pipeline.constants.LB_S_PER_IN2_TO_PA_S = 6894.76 |
Definition at line 367 of file constants.py.
| float engine.pipeline.constants.LBM_PER_IN_S_TO_PA_S = 0.45359237 / 0.0254 |
Definition at line 365 of file constants.py.
| int engine.pipeline.constants.MIN_AREA_M2 = 1e-6 |
Definition at line 295 of file constants.py.
| float engine.pipeline.constants.MIN_DENS_KG_M3 = 0.01 |
Definition at line 291 of file constants.py.
| int engine.pipeline.constants.MIN_PRESS_PA = 1e5 |
Definition at line 293 of file constants.py.
| float engine.pipeline.constants.MIN_TEMP_K = 1.0 |
Definition at line 292 of file constants.py.
| float engine.pipeline.constants.MIN_VELOCITY_M_S = 0.0 |
Definition at line 294 of file constants.py.
| float engine.pipeline.constants.NU_LAMINAR_ND = 4.36 |
Definition at line 126 of file constants.py.
| float engine.pipeline.constants.NU_TURBULENT_COEFFICIENT_ND = 0.023 |
Definition at line 130 of file constants.py.
| float engine.pipeline.constants.NU_TURBULENT_PR_EXPONENT_ND = 0.4 |
Definition at line 132 of file constants.py.
| float engine.pipeline.constants.NU_TURBULENT_RE_EXPONENT_ND = 0.8 |
Definition at line 131 of file constants.py.
| int engine.pipeline.constants.PRE_EXPONENTIAL_H2_1_S = 1e9 |
Definition at line 178 of file constants.py.
| int engine.pipeline.constants.PRE_EXPONENTIAL_HC_1_S = 1e7 |
Definition at line 177 of file constants.py.
| float engine.pipeline.constants.PRESSURE_EXPONENT_H2_ND = 0.5 |
Definition at line 182 of file constants.py.
| float engine.pipeline.constants.PRESSURE_EXPONENT_HC_ND = 0.8 |
Definition at line 181 of file constants.py.
| float engine.pipeline.constants.PRESSURE_EXPONENT_PRE_FACTOR_ND = 0.3 |
Definition at line 183 of file constants.py.
| float engine.pipeline.constants.RANKINE_PER_KELVIN = 1.8 |
Definition at line 358 of file constants.py.
| float engine.pipeline.constants.REF_PRESS_PA = 1.0e6 |
Definition at line 167 of file constants.py.
| float engine.pipeline.constants.REF_TEMP_K = 3500.0 |
Definition at line 168 of file constants.py.
| float engine.pipeline.constants.STANDARD_AMBIENT_TEMP_K = 300.0 |
Definition at line 396 of file constants.py.
| float engine.pipeline.constants.STANDARD_ATMOSPHERE_PRESS_PA = 101325.0 |
Definition at line 395 of file constants.py.
| float engine.pipeline.constants.STEFAN_BOLTZMANN_W_M2_K4 = 5.670374419e-8 |
Definition at line 41 of file constants.py.
| float engine.pipeline.constants.UNIVERSAL_GAS_CONST_J_KMOL_K = 8314.462618 |
Definition at line 45 of file constants.py.