modelTeeJunctionVolumeLoss
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), diameterd_run;port_2– run / straight-through leg, diameterd_run;port_3– branch leg atangleto the run, diameterd_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
| Type | Name | Default | Description |
|---|---|---|---|
| SI.Angle | angle | Modelica.Constants.pi/2 | Angle the branch makes with the straight-through run (tee=90 deg, wye<90 deg) |
| Advanced › Dynamics | |||
| Dynamics | energyDynamics (from PartialVolume) | Dynamics.DynamicFreeInitial | Formulation of energy balances |
| Dynamics | massDynamics (from PartialVolume) | energyDynamics | Formulation of mass balances |
| Dynamics | substanceDynamics (from PartialVolume) | massDynamics | Formulation of substance balances |
| Dynamics | traceDynamics (from PartialVolume) | massDynamics | Formulation of trace substance balances |
| Initialization › Start Value: Absolute Pressure | |||
| SI.AbsolutePressure | p_start (from PartialVolume) | Medium.p_default | Pressure |
| Initialization › Start Value: Temperature | |||
| Boolean | use_T_start (from PartialVolume) | true | Use T_start if true, otherwise h_start |
| SI.Temperature | T_start (from PartialVolume) | Medium.T_default | Temperature |
| Initialization › Start Value: Specific Enthalpy | |||
| SI.SpecificEnthalpy | h_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_default | Mass fraction |
| Initialization › Start Value: Trace Substances | |||
| SIadd.ExtraProperty[Medium.nC] | C_start (from PartialVolume) | fill(0, Medium.nC) | Mass-Specific value |
| Visualization | |||
| Boolean | showName (from PartialVolume) | true | |
| Visualization › Color Coding | |||
| Boolean | showColors (from IconColorMap) | false | Toggle dynamic color display |
| Integer | n_colors (from IconColorMap) | 64 | Number of colors in the colorMap, multiples of 4 is best |
| Advanced | |||
| SI.MassFlowRate | m_flow_reg | 1e-4 | Mass flow rate width for smoothing the dividing<->combining transition |
| Real | Rnom | 1e5 | Nominal linear resistance used only for homotopy initialization |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| TRANSFORM.Fluid.Interfaces.FluidPort_Flow | port_1 | Combined leg (run inlet for dividing flow) | |
| TRANSFORM.Fluid.Interfaces.FluidPort_Flow | port_2 | Run leg (straight-through) | |
| TRANSFORM.Fluid.Interfaces.FluidPort_Flow | port_3 | Branch leg |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| TRANSFORM.Fluid.SystemTF | systemTF (from PartialVolume) | ||
| SI.Volume | V (from PartialVolume) | Volume | |
| Medium.BaseProperties | medium (from PartialVolume) | ||
| SI.Mass | m (from PartialVolume) | Mass | |
| SI.InternalEnergy | U (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.ExtraPropertyExtrinsic | mC_scaled (from PartialVolume) | Scaled trace substance for improved numerical stability | |
| SIadd.ExtraProperty[Medium.nC] | C (from PartialVolume) | Trace substance mass-specific value | |
| SI.MassFlowRate | mb (from PartialVolume) | 0 | Mass flow rate source/sinks within volumes |
| SI.HeatFlowRate | Ub (from PartialVolume) | 0 | Energy 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) |
| Real | val (from IconColorMap) | Color map input variable | |
| Real | val_min (from IconColorMap) | val <= val_min is mapped to colorMap[1,:] | |
| Real | val_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.Length | d_run | 0.05 | Run (straight-through) pipe inner diameter {port_1,port_2} |
| SI.Length | d_branch | 0.05 | Branch pipe inner diameter {port_3} |
| Units.NonDim | K_run | Applied run loss coefficient (ref. combined velocity head) | |
| Units.NonDim | K_branch | Applied branch loss coefficient (ref. combined velocity head) |