modelTeeJunctionVolumeLoss

Tee/wye junction (mixing volume) with angle-dependent Crane dividing/combining losses

Extends from TRANSFORM.Fluid.Volumes.BaseClasses.PartialVolume (Base class for volume models).

Information

A tee/wye junction with a central ideal-mixing volume (like TeeJunctionVolume) plus angle-dependent junction losses on the run and branch legs, using the Crane TP-410 correlations. This captures the loss of a pipe taking off the run at an angle (e.g. a 90° branch) including its dependence on take-off angle, area ratio and flow split – which a simple area-change resistance on the leg cannot.

Ports & convention

  • port_1 – combined leg (run inlet for dividing flow / run outlet for combining flow), diameter d_run;
  • port_2 – run / straight-through leg, diameter d_run;
  • port_3 – branch leg at angle to the run, diameter d_branch.

The branch and run loss coefficients are referenced to the combined-leg velocity head ½ρw_c² (with w_c the velocity in port_1). Both the dividing (port_1.m_flow > 0) and combining (port_1.m_flow < 0) correlation sets are evaluated and blended smoothly about zero combined flow with spliceTanh, so flow reversal is supported. Note that the run and combined diameters are assumed equal (Crane model); the branch may be a different size. Loss coefficients can be slightly negative (pressure recovery), consistent with the correlations.

References

Crane Co. Flow of Fluids Through Valves, Fittings, and Pipe (Technical Paper No. 410), 2009. Closures: ClosureRelations...Functions.Tees.

Parameters

TypeNameDefaultDescription
SI.AngleangleModelica.Constants.pi/2Angle the branch makes with the straight-through run (tee=90 deg, wye<90 deg)
Advanced › Dynamics
DynamicsenergyDynamics (from PartialVolume)Dynamics.DynamicFreeInitialFormulation of energy balances
DynamicsmassDynamics (from PartialVolume)energyDynamicsFormulation of mass balances
DynamicssubstanceDynamics (from PartialVolume)massDynamicsFormulation of substance balances
DynamicstraceDynamics (from PartialVolume)massDynamicsFormulation of trace substance balances
Initialization › Start Value: Absolute Pressure
SI.AbsolutePressurep_start (from PartialVolume)Medium.p_defaultPressure
Initialization › Start Value: Temperature
Booleanuse_T_start (from PartialVolume)trueUse T_start if true, otherwise h_start
SI.TemperatureT_start (from PartialVolume)Medium.T_defaultTemperature
Initialization › Start Value: Specific Enthalpy
SI.SpecificEnthalpyh_start (from PartialVolume)Medium.specificEnthalpy_pTX(p_start, T_start, X_start)Specific enthalpy
Initialization › Start Value: Species Mass Fraction
SI.MassFraction[Medium.nX]X_start (from PartialVolume)Medium.X_defaultMass fraction
Initialization › Start Value: Trace Substances
SIadd.ExtraProperty[Medium.nC]C_start (from PartialVolume)fill(0, Medium.nC)Mass-Specific value
Visualization
BooleanshowName (from PartialVolume)true
Visualization › Color Coding
BooleanshowColors (from IconColorMap)falseToggle dynamic color display
Integern_colors (from IconColorMap)64Number of colors in the colorMap, multiples of 4 is best
Advanced
SI.MassFlowRatem_flow_reg1e-4Mass flow rate width for smoothing the dividing<->combining transition
RealRnom1e5Nominal linear resistance used only for homotopy initialization

Connectors

TypeNameDefaultDescription
TRANSFORM.Fluid.Interfaces.FluidPort_Flowport_1Combined leg (run inlet for dividing flow)
TRANSFORM.Fluid.Interfaces.FluidPort_Flowport_2Run leg (straight-through)
TRANSFORM.Fluid.Interfaces.FluidPort_Flowport_3Branch leg

Components

TypeNameDefaultDescription
TRANSFORM.Fluid.SystemTFsystemTF (from PartialVolume)
SI.VolumeV (from PartialVolume)Volume
Medium.BasePropertiesmedium (from PartialVolume)
SI.Massm (from PartialVolume)Mass
SI.InternalEnergyU (from PartialVolume)Internal energy
SI.Mass[Medium.nXi]mXi (from PartialVolume)Species mass
SIadd.ExtraPropertyExtrinsic[Medium.nC]mC (from PartialVolume)Trace substance extrinsic value
SIadd.ExtraPropertyExtrinsicmC_scaled (from PartialVolume)Scaled trace substance for improved numerical stability
SIadd.ExtraProperty[Medium.nC]C (from PartialVolume)Trace substance mass-specific value
SI.MassFlowRatemb (from PartialVolume)0Mass flow rate source/sinks within volumes
SI.HeatFlowRateUb (from PartialVolume)0Energy source/sinks within volumes (e.g., ohmic heating, external convection)
SI.MassFlowRate[Medium.nXi]mXib (from PartialVolume)zeros(Medium.nXi)Species mass flow rates source/sinks within volumes
SIadd.ExtraPropertyFlowRate[Medium.nC]mCb (from PartialVolume)zeros(Medium.nC)Trace flow rate source/sinks within volumes (e.g., chemical reactions, external convection)
Realval (from IconColorMap)Color map input variable
Realval_min (from IconColorMap)val <= val_min is mapped to colorMap[1,:]
Realval_max (from IconColorMap)val >= val_max is mapped to colorMap[end,:]
Real[3]dynColor (from IconColorMap)Modelica.Mechanics.MultiBody.Visualizers.Colors.scalarToColor(val, val_min, val_max, colorMapData_)
SI.Lengthd_run0.05Run (straight-through) pipe inner diameter {port_1,port_2}
SI.Lengthd_branch0.05Branch pipe inner diameter {port_3}
Units.NonDimK_runApplied run loss coefficient (ref. combined velocity head)
Units.NonDimK_branchApplied branch loss coefficient (ref. combined velocity head)