STAR
Cal STAR — firmware, DAQ server, and engine design
Loading...
Searching...
No Matches
engine.pipeline.config_schemas.AblativeCoolingConfig Class Reference
Inheritance diagram for engine.pipeline.config_schemas.AblativeCoolingConfig:
[legend]
Collaboration diagram for engine.pipeline.config_schemas.AblativeCoolingConfig:
[legend]

Static Public Attributes

bool enabled = Field(default=False, description="Enable ablative cooling model")
float material_density = Field(default=1600.0, gt=0, description="Ablator (phenolic) density [kg/m³]")
float heat_of_ablation = Field(default=2.5e6, gt=0, description="Heat of ablation [J/kg]: energy per kg consumed beyond the sensible heat from ambient_temperature to ablation_surface_temperature (quasi-steady Landau balance)")
float thermal_conductivity = Field(default=0.35, gt=0, description="Ablator (phenolic) thermal conductivity [W/(m·K)]")
float specific_heat = Field(default=1500.0, gt=0, description="Ablator (phenolic) specific heat [J/(kg·K)]")
float initial_thickness = Field(default=0.01, gt=0, description="Initial ablative (phenolic) thickness [m]")
float surface_temperature_limit = Field(default=1200.0, gt=0, description="Allowable surface temperature [K]. A check only; the thermal model runs at ablation_surface_temperature")
float ablation_surface_temperature = Field(default=1986.0, gt=0, description="Char surface temperature while the liner ablates [K]. Default 1986 K is the SiO2 melting point (CRC Handbook), the bound on a silica-phenolic char surface; set it for the reinforcement actually used")
float coverage_fraction = Field(default=1.0, gt=0, le=1.0, description="Fraction of chamber surface protected by ablative liner")
float pyrolysis_temperature = Field(default=900.0, gt=0, description="Characteristic pyrolysis temperature of ablator [K]")
float blowing_efficiency = Field(default=0.8, ge=0, le=1, description="Effectiveness of ablative gases in blocking convective heat flux (legacy constant factor, used if use_physics_based_blowing=False)")
bool use_physics_based_blowing = Field(default=True, description="If True, use physics-based blowing parameter B = m_dot_pyrolysis/m_dot_external. If False, use constant blowing_efficiency factor.")
float blowing_coefficient = Field(default=0.5, gt=0, description="Blowing coefficient c in empirical function f(B) = 1/(1 + c*B). Typical range: 0.3-0.8. Higher values = stronger blowing effect.")
float blowing_min_reduction_factor = Field(default=0.1, ge=0, le=1, description="Minimum convective reduction factor (maximum blowing effectiveness). Prevents blowing from reducing convective heat transfer below this fraction. Default 0.1 means maximum 90% reduction. Lower values allow stronger blowing effect.")
float turbulence_reference_intensity = Field(default=0.08, gt=0, description="Unused: Bartz already carries the chamber's turbulence (kept so old configs load)")
float turbulence_sensitivity = Field(default=1.5, ge=0, description="Unused: Bartz already carries the chamber's turbulence (kept so old configs load)")
float turbulence_exponent = Field(default=1.0, gt=0, description="Unused: Bartz already carries the chamber's turbulence (kept so old configs load)")
float turbulence_max_multiplier = Field(default=3.0, gt=0, description="Unused: Bartz already carries the chamber's turbulence (kept so old configs load)")
Optional throat_recession_multiplier = Field(default=None, gt=0, description="Throat recession multiplier vs chamber (if None, calculated from flow conditions). Typically 1.2-2.0")
float char_layer_conductivity = Field(default=0.2, gt=0, description="Thermal conductivity of char layer [W/(m·K)]")
float char_layer_thickness = Field(default=0.001, gt=0, description="Thickness of protective char layer [m]")
float surface_emissivity = Field(default=0.85, ge=0, le=1, description="Surface emissivity for radiative heat transfer (0-1, typical 0.8-0.9 for charred ablators)")
float ambient_temperature = Field(default=300.0, gt=0, description="Liner temperature at ignition [K] (the wall starts at ambient)")
float radiative_sink_minimum_threshold = Field(default=400.0, gt=0, description="Unused: the hot face radiates only to the gas (kept so old configs load)")
float radiative_sink_fallback_temperature = Field(default=600.0, gt=0, description="Unused: the hot face radiates only to the gas (kept so old configs load)")
bool track_geometry_evolution = Field(default=True, description="Enable time-varying geometry tracking (L* evolution)")
bool nozzle_ablative = Field(default=False, description="If True, nozzle exit also recedes (A_exit grows). If False, only throat recedes (expansion ratio decreases)")

Detailed Description

Ablative cooling configuration for chamber liner (phenolic)

Definition at line 663 of file config_schemas.py.

Member Data Documentation

◆ ablation_surface_temperature

float engine.pipeline.config_schemas.AblativeCoolingConfig.ablation_surface_temperature = Field(default=1986.0, gt=0, description="Char surface temperature while the liner ablates [K]. Default 1986 K is the SiO2 melting point (CRC Handbook), the bound on a silica-phenolic char surface; set it for the reinforcement actually used")
static

Definition at line 672 of file config_schemas.py.

◆ ambient_temperature

float engine.pipeline.config_schemas.AblativeCoolingConfig.ambient_temperature = Field(default=300.0, gt=0, description="Liner temperature at ignition [K] (the wall starts at ambient)")
static

Definition at line 687 of file config_schemas.py.

◆ blowing_coefficient

float engine.pipeline.config_schemas.AblativeCoolingConfig.blowing_coefficient = Field(default=0.5, gt=0, description="Blowing coefficient c in empirical function f(B) = 1/(1 + c*B). Typical range: 0.3-0.8. Higher values = stronger blowing effect.")
static

Definition at line 677 of file config_schemas.py.

◆ blowing_efficiency

float engine.pipeline.config_schemas.AblativeCoolingConfig.blowing_efficiency = Field(default=0.8, ge=0, le=1, description="Effectiveness of ablative gases in blocking convective heat flux (legacy constant factor, used if use_physics_based_blowing=False)")
static

Definition at line 675 of file config_schemas.py.

◆ blowing_min_reduction_factor

float engine.pipeline.config_schemas.AblativeCoolingConfig.blowing_min_reduction_factor = Field(default=0.1, ge=0, le=1, description="Minimum convective reduction factor (maximum blowing effectiveness). Prevents blowing from reducing convective heat transfer below this fraction. Default 0.1 means maximum 90% reduction. Lower values allow stronger blowing effect.")
static

Definition at line 678 of file config_schemas.py.

◆ char_layer_conductivity

float engine.pipeline.config_schemas.AblativeCoolingConfig.char_layer_conductivity = Field(default=0.2, gt=0, description="Thermal conductivity of char layer [W/(m·K)]")
static

Definition at line 684 of file config_schemas.py.

◆ char_layer_thickness

float engine.pipeline.config_schemas.AblativeCoolingConfig.char_layer_thickness = Field(default=0.001, gt=0, description="Thickness of protective char layer [m]")
static

Definition at line 685 of file config_schemas.py.

◆ coverage_fraction

float engine.pipeline.config_schemas.AblativeCoolingConfig.coverage_fraction = Field(default=1.0, gt=0, le=1.0, description="Fraction of chamber surface protected by ablative liner")
static

Definition at line 673 of file config_schemas.py.

◆ enabled

bool engine.pipeline.config_schemas.AblativeCoolingConfig.enabled = Field(default=False, description="Enable ablative cooling model")
static

◆ heat_of_ablation

float engine.pipeline.config_schemas.AblativeCoolingConfig.heat_of_ablation = Field(default=2.5e6, gt=0, description="Heat of ablation [J/kg]: energy per kg consumed beyond the sensible heat from ambient_temperature to ablation_surface_temperature (quasi-steady Landau balance)")
static

Definition at line 667 of file config_schemas.py.

◆ initial_thickness

float engine.pipeline.config_schemas.AblativeCoolingConfig.initial_thickness = Field(default=0.01, gt=0, description="Initial ablative (phenolic) thickness [m]")
static

Definition at line 670 of file config_schemas.py.

◆ material_density

float engine.pipeline.config_schemas.AblativeCoolingConfig.material_density = Field(default=1600.0, gt=0, description="Ablator (phenolic) density [kg/m³]")
static

Definition at line 666 of file config_schemas.py.

◆ nozzle_ablative

bool engine.pipeline.config_schemas.AblativeCoolingConfig.nozzle_ablative = Field(default=False, description="If True, nozzle exit also recedes (A_exit grows). If False, only throat recedes (expansion ratio decreases)")
static

Definition at line 691 of file config_schemas.py.

◆ pyrolysis_temperature

float engine.pipeline.config_schemas.AblativeCoolingConfig.pyrolysis_temperature = Field(default=900.0, gt=0, description="Characteristic pyrolysis temperature of ablator [K]")
static

Definition at line 674 of file config_schemas.py.

◆ radiative_sink_fallback_temperature

float engine.pipeline.config_schemas.AblativeCoolingConfig.radiative_sink_fallback_temperature = Field(default=600.0, gt=0, description="Unused: the hot face radiates only to the gas (kept so old configs load)")
static

Definition at line 689 of file config_schemas.py.

◆ radiative_sink_minimum_threshold

float engine.pipeline.config_schemas.AblativeCoolingConfig.radiative_sink_minimum_threshold = Field(default=400.0, gt=0, description="Unused: the hot face radiates only to the gas (kept so old configs load)")
static

Definition at line 688 of file config_schemas.py.

◆ specific_heat

float engine.pipeline.config_schemas.AblativeCoolingConfig.specific_heat = Field(default=1500.0, gt=0, description="Ablator (phenolic) specific heat [J/(kg·K)]")
static

Definition at line 669 of file config_schemas.py.

◆ surface_emissivity

float engine.pipeline.config_schemas.AblativeCoolingConfig.surface_emissivity = Field(default=0.85, ge=0, le=1, description="Surface emissivity for radiative heat transfer (0-1, typical 0.8-0.9 for charred ablators)")
static

Definition at line 686 of file config_schemas.py.

◆ surface_temperature_limit

float engine.pipeline.config_schemas.AblativeCoolingConfig.surface_temperature_limit = Field(default=1200.0, gt=0, description="Allowable surface temperature [K]. A check only; the thermal model runs at ablation_surface_temperature")
static

Definition at line 671 of file config_schemas.py.

◆ thermal_conductivity

float engine.pipeline.config_schemas.AblativeCoolingConfig.thermal_conductivity = Field(default=0.35, gt=0, description="Ablator (phenolic) thermal conductivity [W/(m·K)]")
static

Definition at line 668 of file config_schemas.py.

◆ throat_recession_multiplier

Optional engine.pipeline.config_schemas.AblativeCoolingConfig.throat_recession_multiplier = Field(default=None, gt=0, description="Throat recession multiplier vs chamber (if None, calculated from flow conditions). Typically 1.2-2.0")
static

Definition at line 683 of file config_schemas.py.

◆ track_geometry_evolution

bool engine.pipeline.config_schemas.AblativeCoolingConfig.track_geometry_evolution = Field(default=True, description="Enable time-varying geometry tracking (L* evolution)")
static

Definition at line 690 of file config_schemas.py.

◆ turbulence_exponent

float engine.pipeline.config_schemas.AblativeCoolingConfig.turbulence_exponent = Field(default=1.0, gt=0, description="Unused: Bartz already carries the chamber's turbulence (kept so old configs load)")
static

Definition at line 681 of file config_schemas.py.

◆ turbulence_max_multiplier

float engine.pipeline.config_schemas.AblativeCoolingConfig.turbulence_max_multiplier = Field(default=3.0, gt=0, description="Unused: Bartz already carries the chamber's turbulence (kept so old configs load)")
static

Definition at line 682 of file config_schemas.py.

◆ turbulence_reference_intensity

float engine.pipeline.config_schemas.AblativeCoolingConfig.turbulence_reference_intensity = Field(default=0.08, gt=0, description="Unused: Bartz already carries the chamber's turbulence (kept so old configs load)")
static

Definition at line 679 of file config_schemas.py.

◆ turbulence_sensitivity

float engine.pipeline.config_schemas.AblativeCoolingConfig.turbulence_sensitivity = Field(default=1.5, ge=0, description="Unused: Bartz already carries the chamber's turbulence (kept so old configs load)")
static

Definition at line 680 of file config_schemas.py.

◆ use_physics_based_blowing

bool engine.pipeline.config_schemas.AblativeCoolingConfig.use_physics_based_blowing = Field(default=True, description="If True, use physics-based blowing parameter B = m_dot_pyrolysis/m_dot_external. If False, use constant blowing_efficiency factor.")
static

Definition at line 676 of file config_schemas.py.


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