Inheritance diagram for engine.pipeline.config_schemas.CombustionEfficiencyConfig:

Collaboration diagram for engine.pipeline.config_schemas.CombustionEfficiencyConfig:

Static Public Attributes
Literal	model
float	C = Field(default=0.3, ge=0, le=1, description="Vaporization loss for the constant and linear models only.")
float	K = Field(default=0.15, ge=0, description="[DEPRECATED — no effect] Read by no model.")
bool	use_spray_correction = Field(default=False, description="[DEPRECATED — no effect] Read by no model.")
float	spray_penalty_factor = Field(default=0.8, ge=0, le=1, description="[DEPRECATED — no effect] Read by no model.")
bool	use_mixture_coupling
bool	use_cooling_coupling
bool	use_turbulence_coupling
float	Em_peak
float	mixing_sigma
float	rupe_Em_opt
float	rupe_Em_curvature
Literal	mixing_distribution
Literal	droplet_blowing_model
float	rupe_M_opt
Optional	R_opt
float	spray_size_spread_q
float	mixture_efficiency_floor = Field(default=0.25, ge=0, le=1, description="[DEPRECATED] No longer used")
float	cooling_efficiency_floor
float	turbulence_efficiency_floor = Field(default=0.3, ge=0, le=1, description="[DEPRECATED] No longer used")
Optional	target_turbulence_intensity
Optional	turbulence_penalty_exponent
Optional	target_smd_microns
Optional	xstar_limit_mm
Optional	xstar_penalty_exponent
Optional	we_reference
Optional	we_penalty_exponent
Optional	smd_penalty_exponent
bool	use_advanced_model
float	Pc_gate
bool	use_finite_rate_chemistry
bool	use_shifting_equilibrium
float	tau_ref = Field(default=1e-5, gt=0, description="[DEPRECATED — no effect] Retired kinetics surrogate [s].")
float	tau_ref_P = Field(default=4.0e6, gt=0, description="[DEPRECATED — no effect] Retired kinetics surrogate [Pa].")
float	tau_ref_T = Field(default=3500.0, gt=0, description="[DEPRECATED — no effect] Retired kinetics surrogate [K].")
float	n_pressure = Field(default=0.8, ge=0, description="[DEPRECATED — no effect] Retired kinetics surrogate.")
Optional	tau_Tc_floor_K = Field(default=None, description="[DEPRECATED — no effect] Retired kinetics surrogate [K].")
float	T_star_fuel_cap_K
float	A0_hydrocarbon
float	Ea_hydrocarbon
float	n_pre_hydrocarbon
float	A0_ethanol
float	Ea_ethanol
float	n_pre_ethanol
float	A0_hydrogen
float	Ea_hydrogen
float	n_pre_hydrogen

Detailed Description

c* efficiency: eta_c* = eta_vap * eta_mix * eta_HL (engine/pipeline/combustion_physics.py,
combustion_eff.py). Chemical kinetics carry no chamber c* loss.

Definition at line 1005 of file config_schemas.py.

Member Data Documentation

◆ A0_ethanol

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.A0_ethanol

static

Initial value:

=  Field(
        default=5e7,
        gt=0,
        description="[Progress diagnostic only: reaction_chemistry, time-varying solver; no effect on c*] Pre-exponential factor for ethanol [1/s]. Default 5e7 (faster than RP-1)."
    )

Definition at line 1178 of file config_schemas.py.

◆ A0_hydrocarbon

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.A0_hydrocarbon

static

Initial value:

=  Field(
        default=1e7,
        gt=0,
        description="[Progress diagnostic only: reaction_chemistry, time-varying solver; no effect on c*] Pre-exponential factor for hydrocarbon fuels (RP-1, Kerosene) [1/s]. Default 1e7."
    )

Definition at line 1163 of file config_schemas.py.

◆ A0_hydrogen

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.A0_hydrogen

static

Initial value:

=  Field(
        default=1e9,
        gt=0,
        description="[Progress diagnostic only: reaction_chemistry, time-varying solver; no effect on c*] Pre-exponential factor for hydrogen [1/s]. Default 1e9 (much faster than hydrocarbons)."
    )

Definition at line 1193 of file config_schemas.py.

◆ C

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.C = Field(default=0.3, ge=0, le=1, description="Vaporization loss for the constant and linear models only.")

static

Definition at line 1014 of file config_schemas.py.

◆ cooling_efficiency_floor

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.cooling_efficiency_floor

static

Initial value:

=  Field(
        default=0.25, ge=0, le=1,
        description="Floor on the chamber solver's legacy cooling_efficiency diagnostic only; the c* "
                    "heat-loss factor has none."
    )

Definition at line 1091 of file config_schemas.py.

◆ droplet_blowing_model

Literal engine.pipeline.config_schemas.CombustionEfficiencyConfig.droplet_blowing_model

static

Initial value:

=  Field(
        default="abramzon_sirignano",
        description="Stefan-flow corrections in the vaporization march while a drop evaporates: "
                    "Nu* = 2 + (Nu0 - 2)/F(B) (Abramzon & Sirignano 1989) and C_D (1+B)^-0.2 "
                    "(Yuen & Chen 1976). 'none' = uncorrected Ranz-Marshall and solid-sphere drag, "
                    "which do not hold at the transfer numbers here (B_T 16-80)."
    )

Definition at line 1067 of file config_schemas.py.

◆ Ea_ethanol

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.Ea_ethanol

static

Initial value:

=  Field(
        default=140000.0,
        gt=0,
        description="[Progress diagnostic only: reaction_chemistry, time-varying solver; no effect on c*] Activation energy for ethanol [J/mol]. Default 140 kJ/mol (higher than RP-1)."
    )

Definition at line 1183 of file config_schemas.py.

◆ Ea_hydrocarbon

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.Ea_hydrocarbon

static

Initial value:

=  Field(
        default=80000.0,
        gt=0,
        description="[Progress diagnostic only: reaction_chemistry, time-varying solver; no effect on c*] Activation energy for hydrocarbon fuels (RP-1, Kerosene) [J/mol]. Default 80 kJ/mol."
    )

Definition at line 1168 of file config_schemas.py.

◆ Ea_hydrogen

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.Ea_hydrogen

static

Initial value:

=  Field(
        default=40000.0,
        gt=0,
        description="[Progress diagnostic only: reaction_chemistry, time-varying solver; no effect on c*] Activation energy for hydrogen [J/mol]. Default 40 kJ/mol (lower than hydrocarbons)."
    )

Definition at line 1198 of file config_schemas.py.

◆ Em_peak

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.Em_peak

static

Initial value:

=  Field(
        default=0.96, ge=0.5, le=1.0,
        description="[DEPRECATED — no effect] Was an assumed c* mixing efficiency; E_m is not a c* "
                    "efficiency. Mixing is now rupe_Em_opt through the stream-tube c* integral."
    )

Definition at line 1034 of file config_schemas.py.

◆ K

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.K = Field(default=0.15, ge=0, description="[DEPRECATED — no effect] Read by no model.")

static

Definition at line 1015 of file config_schemas.py.

◆ mixing_distribution

Literal engine.pipeline.config_schemas.CombustionEfficiencyConfig.mixing_distribution

static

Initial value:

=  Field(
        default="gaussian",
        description="Shape of the O/F spread that reproduces E_m in the stream-tube c* integral: "
                    "normal in oxidizer mass fraction (default) or two equal-mass tubes. The other "
                    "shape's eta_mix is reported beside it; at E_m 0.8 on LOX/ethanol they differ "
                    "by ~1.3 points (two tubes lose less)."
    )

Definition at line 1060 of file config_schemas.py.

◆ mixing_sigma

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.mixing_sigma

static

Initial value:

=  Field(
        default=1.5, gt=0.0,
        description="[DEPRECATED — no effect] Width of the retired log-Gaussian mixing falloff; the "
                    "falloff is Rupe's correlation (rupe_Em_curvature)."
    )

Definition at line 1039 of file config_schemas.py.

◆ mixture_efficiency_floor

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.mixture_efficiency_floor = Field(default=0.25, ge=0, le=1, description="[DEPRECATED] No longer used")

static

Definition at line 1090 of file config_schemas.py.

◆ model

Literal engine.pipeline.config_schemas.CombustionEfficiencyConfig.model

static

Initial value:

=  Field(
        default="exponential",
        description="Vaporization term. exponential (legacy name): the Priem-Heidmann spray march, "
                    "eta_vap = fraction vaporized at the throat. constant: eta_vap = 1 - C. "
                    "linear: eta_vap = 1 - C (1 - L*/1 m)."
    )

Definition at line 1008 of file config_schemas.py.

Referenced by feedtwin.model.component.ComponentInstance.to_dict().

◆ n_pre_ethanol

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.n_pre_ethanol

static

Initial value:

=  Field(
        default=0.25,
        ge=0,
        description="[Progress diagnostic only: reaction_chemistry, time-varying solver; no effect on c*] Pre-exponential pressure exponent for ethanol. Default 0.25."
    )

Definition at line 1188 of file config_schemas.py.

◆ n_pre_hydrocarbon

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.n_pre_hydrocarbon

static

Initial value:

=  Field(
        default=0.3,
        ge=0,
        description="[Progress diagnostic only: reaction_chemistry, time-varying solver; no effect on c*] Pre-exponential pressure exponent for hydrocarbons. Default 0.3."
    )

Definition at line 1173 of file config_schemas.py.

◆ n_pre_hydrogen

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.n_pre_hydrogen

static

Initial value:

=  Field(
        default=0.2,
        ge=0,
        description="[Progress diagnostic only: reaction_chemistry, time-varying solver; no effect on c*] Pre-exponential pressure exponent for hydrogen. Default 0.2."
    )

Definition at line 1203 of file config_schemas.py.

◆ n_pressure

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.n_pressure = Field(default=0.8, ge=0, description="[DEPRECATED — no effect] Retired kinetics surrogate.")

static

Definition at line 1154 of file config_schemas.py.

◆ Pc_gate

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.Pc_gate

static

Initial value:

=  Field(
        default=1000000.0,
        ge=0,
        description="[DEPRECATED — no effect] Read by no model."
    )

Definition at line 1134 of file config_schemas.py.

◆ R_opt

Optional engine.pipeline.config_schemas.CombustionEfficiencyConfig.R_opt

static

Initial value:

=  Field(
        default=None,
        description="[DEPRECATED — no effect] The mixing optimum is rupe_M_opt; the resultant-tilt "
                    "momentum ratio no longer enters c*."
    )

Definition at line 1079 of file config_schemas.py.

◆ rupe_Em_curvature

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.rupe_Em_curvature

static

Initial value:

=  Field(
        default=6.07, ge=0.0,
        description="Fall-off of E_m away from the optimum, E_m = rupe_Em_opt (1 - a (N_R - N_opt)^2), "
                    "N_R = M/(1+M): a = 6.07 fitted to Rupe's mean line digitized from JPL TR 32-1546 "
                    "Fig. 1 (N_R 0.26-0.78, within 2.4 points; data scatter +-5)."
    )

Definition at line 1054 of file config_schemas.py.

◆ rupe_Em_opt

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.rupe_Em_opt

static

Initial value:

=  Field(
        default=0.80, gt=0.0, le=1.0,
        description="Rupe mixing factor E_m (cold-flow mixture-ratio uniformity, 0-1; JPL TR 32-1546 "
                    "eq. 1) of the element at its optimum M. Circular 1-on-1 unlike doublets with "
                    "fully developed jets: 0.75-0.85 (Rupe, as summarized in Hoehn, Rupe & Sotter, "
                    "JPL TR 32-1546, 1972, p. 1); Rupe's correlation peaks at 0.82 and JPL's "
                    "noncavitating orifices at 0.815 (ibid. p. 10); short or cavitating orifices "
                    "0.70 (Nurick & McHale, ibid.). 0.80 is the middle of the band: replace it with "
                    "a cold-flow measurement of the element."
    )

Definition at line 1044 of file config_schemas.py.

◆ rupe_M_opt

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.rupe_M_opt

static

Initial value:

=  Field(
        default=1.0, gt=0.0,
        description="Elverum-Morey mixing parameter at which mixing is best: 1.0 for a 1-on-1 unlike "
                    "doublet (SP-8089 Table IV; 2-on-1 1.6, 3-on-1 3.5)."
    )

Definition at line 1074 of file config_schemas.py.

◆ smd_penalty_exponent

Optional engine.pipeline.config_schemas.CombustionEfficiencyConfig.smd_penalty_exponent

static

Initial value:

=  Field(
        default=None,
        description="[DEPRECATED] No longer used"
    )

Definition at line 1125 of file config_schemas.py.

◆ spray_penalty_factor

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.spray_penalty_factor = Field(default=0.8, ge=0, le=1, description="[DEPRECATED — no effect] Read by no model.")

static

Definition at line 1017 of file config_schemas.py.

◆ spray_size_spread_q

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.spray_size_spread_q

static

Initial value:

=  Field(
        default=3.0, gt=1.0,
        description="ASSUMED Rosin-Rammler spread q of each stream's drop sizes (volume basis, "
                    "X = D32 Gamma(1 - 1/q)) in the vaporization march. Lefebvre: 1.5-4 for most "
                    "sprays; larger q is a narrower spray."
    )

Definition at line 1084 of file config_schemas.py.

◆ T_star_fuel_cap_K

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.T_star_fuel_cap_K

static

Initial value:

=  Field(
        default=1000.0,
        gt=0,
        description="[DEPRECATED — no effect] Drops now evaporate at their saturation temperature at Pc "
                    "(Clausius-Clapeyron from fluids.*.boiling_point) [K]."
    )

Definition at line 1156 of file config_schemas.py.

◆ target_smd_microns

Optional engine.pipeline.config_schemas.CombustionEfficiencyConfig.target_smd_microns

static

Initial value:

=  Field(
        default=None,
        description="[DEPRECATED] Design target only, not used in efficiency calculation"
    )

Definition at line 1105 of file config_schemas.py.

◆ target_turbulence_intensity

Optional engine.pipeline.config_schemas.CombustionEfficiencyConfig.target_turbulence_intensity

static

Initial value:

=  Field(
        default=None,
        description="[DEPRECATED] Design target only, not used in efficiency calculation"
    )

Definition at line 1097 of file config_schemas.py.

◆ tau_ref

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.tau_ref = Field(default=1e-5, gt=0, description="[DEPRECATED — no effect] Retired kinetics surrogate [s].")

static

Definition at line 1151 of file config_schemas.py.

◆ tau_ref_P

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.tau_ref_P = Field(default=4.0e6, gt=0, description="[DEPRECATED — no effect] Retired kinetics surrogate [Pa].")

static

Definition at line 1152 of file config_schemas.py.

◆ tau_ref_T

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.tau_ref_T = Field(default=3500.0, gt=0, description="[DEPRECATED — no effect] Retired kinetics surrogate [K].")

static

Definition at line 1153 of file config_schemas.py.

◆ tau_Tc_floor_K

Optional engine.pipeline.config_schemas.CombustionEfficiencyConfig.tau_Tc_floor_K = Field(default=None, description="[DEPRECATED — no effect] Retired kinetics surrogate [K].")

static

Definition at line 1155 of file config_schemas.py.

◆ turbulence_efficiency_floor

float engine.pipeline.config_schemas.CombustionEfficiencyConfig.turbulence_efficiency_floor = Field(default=0.3, ge=0, le=1, description="[DEPRECATED] No longer used")

static

Definition at line 1096 of file config_schemas.py.

◆ turbulence_penalty_exponent

Optional engine.pipeline.config_schemas.CombustionEfficiencyConfig.turbulence_penalty_exponent

static

Initial value:

=  Field(
        default=None,
        description="[DEPRECATED] No longer used"
    )

Definition at line 1101 of file config_schemas.py.

◆ use_advanced_model

bool engine.pipeline.config_schemas.CombustionEfficiencyConfig.use_advanced_model

static

Initial value:

=  Field(
        default=False,
        description="Lets the numba accelerator run the chamber solve (engine/accel can_handle_chamber). "
                    "The physics is the same either way."
    )

Definition at line 1129 of file config_schemas.py.

◆ use_cooling_coupling

bool engine.pipeline.config_schemas.CombustionEfficiencyConfig.use_cooling_coupling

static

Initial value:

=  Field(
        default=True,
        description="Charge heat lost through the chamber wall to c*: eta_HL = sqrt(1 - Q/(mdot cp Tc)) "
                    "(c* ~ sqrt(T0), Sutton eq. 3-32). Regenerative and film heat stay with the propellant."
    )

Definition at line 1022 of file config_schemas.py.

◆ use_finite_rate_chemistry

bool engine.pipeline.config_schemas.CombustionEfficiencyConfig.use_finite_rate_chemistry

static

Initial value:

=  Field(
        default=True,
        description="[DEPRECATED — no effect] Chamber kinetics carry no c* loss (products relax in "
                    "~1 us against a ~1 ms stay time); nozzle kinetics are bracketed by CEA's Cf."
    )

Definition at line 1139 of file config_schemas.py.

◆ use_mixture_coupling

bool engine.pipeline.config_schemas.CombustionEfficiencyConfig.use_mixture_coupling

static

Initial value:

=  Field(
        default=False,
        description="[DIAGNOSTICS ONLY] Enable mixture diagnostics logging (does NOT affect efficiency calculation)"
    )

Definition at line 1018 of file config_schemas.py.

◆ use_shifting_equilibrium

bool engine.pipeline.config_schemas.CombustionEfficiencyConfig.use_shifting_equilibrium

static

Initial value:

=  Field(
        default=True,
        description="[DEPRECATED — no effect] The iterative shifting-equilibrium nozzle was retired; "
                    "exit-composition shift is captured exactly by CEA's Cf_vac table "
                    "(RPA delivered thrust). Kept for config compatibility only."
    )

Definition at line 1144 of file config_schemas.py.

◆ use_spray_correction

bool engine.pipeline.config_schemas.CombustionEfficiencyConfig.use_spray_correction = Field(default=False, description="[DEPRECATED — no effect] Read by no model.")

static

Definition at line 1016 of file config_schemas.py.

◆ use_turbulence_coupling

bool engine.pipeline.config_schemas.CombustionEfficiencyConfig.use_turbulence_coupling

static

Initial value:

=  Field(
        default=False,
        description="[DEPRECATED] Turbulence is folded into eta_mixing; the standalone eta_turbulence penalty was removed (non-physical/double-counted)."
    )

Definition at line 1027 of file config_schemas.py.

◆ we_penalty_exponent

Optional engine.pipeline.config_schemas.CombustionEfficiencyConfig.we_penalty_exponent

static

Initial value:

=  Field(
        default=None,
        description="[DEPRECATED] No longer used"
    )

Definition at line 1121 of file config_schemas.py.

◆ we_reference

Optional engine.pipeline.config_schemas.CombustionEfficiencyConfig.we_reference

static

Initial value:

=  Field(
        default=None,
        description="[DEPRECATED] Design target only, not used in efficiency calculation"
    )

Definition at line 1117 of file config_schemas.py.

◆ xstar_limit_mm

Optional engine.pipeline.config_schemas.CombustionEfficiencyConfig.xstar_limit_mm

static

Initial value:

=  Field(
        default=None,
        description="[DEPRECATED] No longer used"
    )

Definition at line 1109 of file config_schemas.py.

◆ xstar_penalty_exponent

Optional engine.pipeline.config_schemas.CombustionEfficiencyConfig.xstar_penalty_exponent

static

Initial value:

=  Field(
        default=None,
        description="[DEPRECATED] No longer used"
    )

Definition at line 1113 of file config_schemas.py.

The documentation for this class was generated from the following file:

EngineDesign/engine/pipeline/config_schemas.py

Static Public Attributes

Detailed Description

Member Data Documentation

◆ A0_ethanol

◆ A0_hydrocarbon

◆ A0_hydrogen

◆ C

◆ cooling_efficiency_floor

◆ droplet_blowing_model

◆ Ea_ethanol

◆ Ea_hydrocarbon

◆ Ea_hydrogen

◆ Em_peak

◆ K

◆ mixing_distribution

◆ mixing_sigma

◆ mixture_efficiency_floor

◆ model

◆ n_pre_ethanol

◆ n_pre_hydrocarbon

◆ n_pre_hydrogen

◆ n_pressure

◆ Pc_gate

◆ R_opt

◆ rupe_Em_curvature

◆ rupe_Em_opt

◆ rupe_M_opt

◆ smd_penalty_exponent

◆ spray_penalty_factor

◆ spray_size_spread_q

◆ T_star_fuel_cap_K

◆ target_smd_microns

◆ target_turbulence_intensity

◆ tau_ref

◆ tau_ref_P

◆ tau_ref_T

◆ tau_Tc_floor_K

◆ turbulence_efficiency_floor

◆ turbulence_penalty_exponent

◆ use_advanced_model

◆ use_cooling_coupling

◆ use_finite_rate_chemistry

◆ use_mixture_coupling

◆ use_shifting_equilibrium

◆ use_spray_correction

◆ use_turbulence_coupling

◆ we_penalty_exponent

◆ we_reference

◆ xstar_limit_mm

◆ xstar_penalty_exponent