Inheritance diagram for engine.pipeline.config_schemas.DischargeConfig:

Collaboration diagram for engine.pipeline.config_schemas.DischargeConfig:

Static Public Attributes
float	Cd_inf
float	a_Re = Field(ge=0, description="Reynolds number correction parameter")
float	Cd_min = Field(default=0.2, ge=0, le=1, description="Minimum Cd")
bool	use_geometry_cd
float	d_ref_m
float	cd_small_hole_exponent
float	cd_large_hole_log_gain
float	cd_inf_max
float	cd_inf_min_geom
Optional	inlet_geometry
Optional	inlet_radius_ratio
Optional	orifice_l_over_d
Literal	l_over_d_source
Literal	length_model
Optional	approach_beta
float	d_min_m
bool	use_pressure_correction = Field(default=False, description="Enable pressure-dependent Cd (compressibility effects)")
float	P_ref = Field(default=5.0e6, gt=0, description="Reference pressure for pressure correction [Pa]")
float	a_P = Field(default=0.0, description="Pressure correction coefficient")
bool	use_temperature_correction = Field(default=False, description="Enable temperature-dependent Cd (viscosity effects)")
float	T_ref = Field(default=300.0, gt=0, description="Reference temperature for temperature correction [K]")
float	a_T = Field(default=0.0, description="Temperature correction coefficient")

Detailed Description

Discharge coefficient configuration

Definition at line 694 of file config_schemas.py.

Member Data Documentation

◆ a_P

float engine.pipeline.config_schemas.DischargeConfig.a_P = Field(default=0.0, description="Pressure correction coefficient")

static

Definition at line 822 of file config_schemas.py.

◆ a_Re

float engine.pipeline.config_schemas.DischargeConfig.a_Re = Field(ge=0, description="Reynolds number correction parameter")

static

Definition at line 704 of file config_schemas.py.

◆ a_T

float engine.pipeline.config_schemas.DischargeConfig.a_T = Field(default=0.0, description="Temperature correction coefficient")

static

Definition at line 825 of file config_schemas.py.

◆ approach_beta

Optional engine.pipeline.config_schemas.DischargeConfig.approach_beta

static

Initial value:

=  Field(
        default=None, gt=0.0, lt=1.0,
        description=(
            "Orifice / feed-passage diameter ratio d/D when the orifice is fed from a "
            "counterbore, not a plenum. Applies the velocity of approach and a sharp entrance "
            "(K = 0.5, Idelchik) into the counterbore: Cd_eff = 1/sqrt((1-b^4)/Cd^2 + "
            "b^4 (1+K)). Set by l_over_d_source='plate'; None => fed from a plenum."
        ),
    )

Definition at line 805 of file config_schemas.py.

◆ Cd_inf

float engine.pipeline.config_schemas.DischargeConfig.Cd_inf

static

Initial value:

=  Field(
        gt=0,
        le=1,
        description=(
            "Baseline Cd at infinite Re for the reference orifice diameter d_ref_m "
            "(thin-plate sharp hole, typically 0.60 for machined impinging jets)."
        ),
    )

Definition at line 696 of file config_schemas.py.

◆ cd_inf_max

float engine.pipeline.config_schemas.DischargeConfig.cd_inf_max

static

Initial value:

=  Field(
        default=0.62,
        gt=0,
        le=1,
        description="Upper cap on geometry-based Cd_inf (slightly radiused / large-hole asymptote).",
    )

Definition at line 733 of file config_schemas.py.

◆ cd_inf_min_geom

float engine.pipeline.config_schemas.DischargeConfig.cd_inf_min_geom

static

Initial value:

=  Field(
        default=0.48,
        gt=0,
        le=1,
        description="Lower floor on geometry-based Cd_inf for very small holes.",
    )

Definition at line 739 of file config_schemas.py.

◆ cd_large_hole_log_gain

float engine.pipeline.config_schemas.DischargeConfig.cd_large_hole_log_gain

static

Initial value:

=  Field(
        default=0.015,
        ge=0.0,
        description="For d > d_ref: Cd_inf += gain * ln(d/d_ref), capped at cd_inf_max.",
    )

Definition at line 728 of file config_schemas.py.

◆ Cd_min

float engine.pipeline.config_schemas.DischargeConfig.Cd_min = Field(default=0.2, ge=0, le=1, description="Minimum Cd")

static

Definition at line 705 of file config_schemas.py.

◆ cd_small_hole_exponent

float engine.pipeline.config_schemas.DischargeConfig.cd_small_hole_exponent

static

Initial value:

=  Field(
        default=0.0,
        ge=0.0,
        le=1.0,
        description=(
            "For d < d_ref: Cd_inf scales as Cd_inf * (d/d_ref)^exponent. 0 (default): the thin-plate "
            "asymptote holds below d_ref; ISO 5167 and Sutton & Biblarz Table 8-2 have small sharp "
            "holes flowing slightly more, not less, so the old 0.2 penalty had the wrong sign."
        ),
    )

Definition at line 718 of file config_schemas.py.

◆ d_min_m

float engine.pipeline.config_schemas.DischargeConfig.d_min_m

static

Initial value:

=  Field(
        default=0.0004,
        gt=0,
        description="Minimum diameter used in Cd_geom [m] (below this, clamp to d_min_m).",
    )

Definition at line 814 of file config_schemas.py.

◆ d_ref_m

float engine.pipeline.config_schemas.DischargeConfig.d_ref_m

static

Initial value:

=  Field(
        default=0.002,
        gt=0,
        description="Reference hole diameter [m] where Cd_inf equals the Cd_inf baseline (default 2 mm).",
    )

Definition at line 713 of file config_schemas.py.

◆ inlet_geometry

Optional engine.pipeline.config_schemas.DischargeConfig.inlet_geometry

static

Initial value:

=  Field(
        default=None,
        description=(
            "Orifice inlet treatment: sharp (0.80) | chamfered (0.84) | conical (0.86) | "
            "rounded_light (0.85) | rounded (0.88) | bellmouth (0.95). Short-tube values at "
            "Re > 1e4 and L/d ~ 2-5 (engine.core.discharge.INLET_GEOMETRY_CD); the thin-plate "
            "0.61 is recovered by orifice_l_over_d -> 0. Overrides the "
            "diameter-scaled Cd_inf when set. Use inlet_radius_ratio instead for a "
            "continuous r/d."
        ),
    )

Definition at line 751 of file config_schemas.py.

◆ inlet_radius_ratio

Optional engine.pipeline.config_schemas.DischargeConfig.inlet_radius_ratio

static

Initial value:

=  Field(
        default=None,
        ge=0.0,
        le=1.0,
        description=(
            "Inlet fillet radius / orifice diameter (r/d). Continuous alternative to "
            "inlet_geometry: 0 = sharp (Cd 0.80 short tube), 0.125 = Cd 0.88, >= 0.2 = Cd 0.95 and "
            "saturating. Nurick (1976): cavitation inception margin also rises with inlet "
            "roundness, so this buys flow AND cavitation headroom."
        ),
    )

Definition at line 762 of file config_schemas.py.

◆ l_over_d_source

Literal engine.pipeline.config_schemas.DischargeConfig.l_over_d_source

static

Initial value:

=  Field(
        default="declared",
        description=(
            "Where the orifice L/d comes from. 'declared' (default, previous behaviour): "
            "orifice_l_over_d as typed. 'plate': derived from the injector plate -- "
            "layer1_injector_plate_thickness_m and layer1_injector_counterbore_dia_m -- for the "
            "current hole: with a counterbore the land is min(orifice_l_over_d * d, t/cos theta); "
            "without one the small drill runs the whole passage, L/d = t / (d cos theta). Also "
            "applies the counterbore's velocity of approach and entrance loss (approach_beta)."
        ),
    )

Definition at line 785 of file config_schemas.py.

◆ length_model

Literal engine.pipeline.config_schemas.DischargeConfig.length_model

static

Initial value:

=  Field(
        default="lichtarowicz",
        description=(
            "Cd vs L/d. 'lichtarowicz' (default): the published sharp-inlet fit Cd_u = 0.827 - "
            "0.0085 L/d (Lichtarowicz, Duggins & Markland 1965, valid 2 <= L/d <= 10), "
            "normalised so the inlet table's short-tube value sits at L/d 3.18. 'piecewise' "
            "(legacy, unsourced): flat over L/d 2-5, linear roll-off above."
        ),
    )

Definition at line 796 of file config_schemas.py.

◆ orifice_l_over_d

Optional engine.pipeline.config_schemas.DischargeConfig.orifice_l_over_d

static

Initial value:

=  Field(
        default=None,
        gt=0.0,
        description=(
            "Orifice length / diameter. Lichtarowicz et al. (1965): Cd peaks near L/d ~ 2 "
            "where expansion past the vena contracta recovers dynamic pressure, falls below "
            "~1 (thin-plate, no recovery) and above ~10 (wall friction). Only applied when "
            "an inlet geometry is set. None => no length correction. With "
            "l_over_d_source='plate' this is the LAND the counterbore leaves, and the L/d the "
            "Cd model uses is what the plate actually gives."
        ),
    )

Definition at line 773 of file config_schemas.py.

◆ P_ref

float engine.pipeline.config_schemas.DischargeConfig.P_ref = Field(default=5.0e6, gt=0, description="Reference pressure for pressure correction [Pa]")

static

Definition at line 821 of file config_schemas.py.

◆ T_ref

float engine.pipeline.config_schemas.DischargeConfig.T_ref = Field(default=300.0, gt=0, description="Reference temperature for temperature correction [K]")

static

Definition at line 824 of file config_schemas.py.

◆ use_geometry_cd

bool engine.pipeline.config_schemas.DischargeConfig.use_geometry_cd

static

Initial value:

=  Field(
        default=True,
        description=(
            "When True, Cd_inf is scaled from jet/orifice diameter d_hyd via cd_inf_from_orifice_diameter "
            "before the Re correction (impinging jets; pintle orifice OD / fuel gap hydraulic diameter)."
        ),
    )

Definition at line 706 of file config_schemas.py.

◆ use_pressure_correction

bool engine.pipeline.config_schemas.DischargeConfig.use_pressure_correction = Field(default=False, description="Enable pressure-dependent Cd (compressibility effects)")

static

Definition at line 820 of file config_schemas.py.

◆ use_temperature_correction

bool engine.pipeline.config_schemas.DischargeConfig.use_temperature_correction = Field(default=False, description="Enable temperature-dependent Cd (viscosity effects)")

static

Definition at line 823 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

◆ a_P

◆ a_Re

◆ a_T

◆ approach_beta

◆ Cd_inf

◆ cd_inf_max

◆ cd_inf_min_geom

◆ cd_large_hole_log_gain

◆ Cd_min

◆ cd_small_hole_exponent

◆ d_min_m

◆ d_ref_m

◆ inlet_geometry

◆ inlet_radius_ratio

◆ l_over_d_source

◆ length_model

◆ orifice_l_over_d

◆ P_ref

◆ T_ref

◆ use_geometry_cd

◆ use_pressure_correction

◆ use_temperature_correction