Cross-Junction (TL)

Cross-junction in a thermal liquid network

Since R2022b

Libraries:
Simscape / Fluids / Thermal Liquid / Pipes & Fittings

Description

The Cross-Junction (TL) block represents a four-way junction in a thermal liquid network. The block abstracts the fluid interactions depending on the direction of flow at each port, where ports A and C are the main line and ports B and D are the branch line.

Mass, Momentum, and Energy Balance

The block conserves mass such that

${\dot{m}}_{A} + {\dot{m}}_{B} + {\dot{m}}_{C} + {\dot{m}}_{D} = 0,$

where ṁ_i is the mass flow rate for a given port, i.

The block determines which coefficient and vector element to use, then computes the pressure difference to conserve momentum such that

$p_{i} - p_{1} = I_{i} + \frac{\frac{k_{i}}{2} {\dot{m}}_{i} \sqrt{{\dot{m}}_{i}^{2} + {\dot{m}}_{t h r e s h o l d}^{2}}}{\bar{ρ} A_{i}^{2}},$

where:

$\bar{ρ}$ is the average fluid density.
p_i is the pressure for a given port, i.
p₁ is the pressure at node 1.
k_i is the flow coefficient that the block assigns to a given port, i. The Loss coefficient model parameter specifies the block method used to calculate k_i.
I_i is the fluid inertia for a given port, i.

The block calculates the inertia for each port as

$\begin{array}{l} I_{A} = {\ddot{m}}_{A} \frac{\sqrt{π A_{s i d e}}}{A_{m a i n}} \\ I_{B} = {\ddot{m}}_{B} \frac{\sqrt{π A_{m a i n}}}{A_{s i d e}} \\ I_{C} = {\ddot{m}}_{C} \frac{\sqrt{π A_{s i d e}}}{A_{m a i n}} \\ I_{D} = {\ddot{m}}_{D} \frac{\sqrt{π A_{m a i n}}}{A_{s i d e}} \end{array}$

where A_main is the value of the Main line area (A,C) parameter and A_side is the value of the Branch line area (B,D) parameter.

The block conserves energy such that

$φ_{A} + φ_{B} + φ_{C} + φ_{D} = 0.$

Idel'chik Correlation Coefficient Model

When you set the Loss coefficient model parameter to Idel'chik correlation, the block calculates the pipe loss coefficients according to [1]. The Idel'chik model only supports flow converging to port C or flow diverging from port C. To achieve expected results, orient the block appropriately to the expected flow configuration of the model fluid network.

The block treats the junction as symmetrical about both the horizontal and vertical planes such that A_A = A_C is the value of the Main line area (A,C) parameter, and A_B = A_D is the value of the Branch line area (B,D) parameter, where A_A,B,C,D is the area of the corresponding port.

Diagram of the two Idel'chik flow configurations: diverging flow and converging flow

In the case of a prohibited flow geometry, you can control the block behavior by using the Report when flow configuration is invalid parameter. If the Report when flow configuration is invalid parameter is None or Warning, the model continues to run in the prohibited flow configuration, but the results may not be correct.

Converging Flow to Port C

When the flow is converging to port C, the loss coefficients for ports A and C are

$\begin{array}{l} k_{A} = (1 + {(\frac{{\dot{m}}_{A}}{{\dot{m}}_{C}})}^{2} - {(\frac{{\dot{m}}_{A}}{{\dot{m}}_{C}})}^{2} \frac{1 + \frac{{\dot{m}}_{A}}{{\dot{m}}_{C}}}{{(0.75 + 0.25 \frac{{\dot{m}}_{A}}{{\dot{m}}_{C}})}^{2}}) {(\frac{{\dot{m}}_{A}}{{\dot{m}}_{C}} \frac{A_{C}}{A_{A}})}^{- 2} \\ k_{C} = 0 \end{array}$

The converging flow loss coefficients for ports B and D are

$\begin{array}{l} k_{B} = (1 + {(\frac{{\dot{m}}_{B}}{{\dot{m}}_{C}} \frac{A_{C}}{A_{B}})}^{2} - 8 {(\frac{{\dot{m}}_{B}}{{\dot{m}}_{C}})}^{2} \frac{{[\frac{{\dot{m}}_{C}}{{\dot{m}}_{B}} - (1 + \frac{{\dot{m}}_{D}}{{\dot{m}}_{B}})]}^{2}}{4 - (1 + \frac{{\dot{m}}_{D}}{{\dot{m}}_{B}}) \frac{{\dot{m}}_{B}}{{\dot{m}}_{C}}}) {(\frac{{\dot{m}}_{B}}{{\dot{m}}_{C}} \frac{A_{C}}{A_{B}})}^{- 2} \\ k_{D} = (1 + {(\frac{{\dot{m}}_{D}}{{\dot{m}}_{C}} \frac{A_{C}}{A_{D}})}^{2} - 8 {(\frac{{\dot{m}}_{D}}{{\dot{m}}_{C}})}^{2} \frac{{[\frac{{\dot{m}}_{C}}{{\dot{m}}_{D}} - (1 + \frac{{\dot{m}}_{B}}{{\dot{m}}_{D}})]}^{2}}{4 - (1 + \frac{{\dot{m}}_{B}}{{\dot{m}}_{D}}) \frac{{\dot{m}}_{D}}{{\dot{m}}_{C}}}) {(\frac{{\dot{m}}_{D}}{{\dot{m}}_{C}} \frac{A_{C}}{A_{D}})}^{- 2} \end{array}$

Diverging Flow From Port C

When the flow diverges from port C, the loss coefficients for ports A and C are

$\begin{array}{l} k_{A} = 0.4 {(\frac{{\dot{m}}_{C}}{{\dot{m}}_{A}} - 1)}^{2} \\ k_{C} = 0 \end{array}$

The diverging flow loss coefficients for ports B and D are

$\begin{array}{l} k_{B} = A' {(\frac{{\dot{m}}_{C}}{{\dot{m}}_{B}} \frac{A_{B}}{A_{C}} + 1)}^{2} \\ k_{D} = A' {(\frac{{\dot{m}}_{C}}{{\dot{m}}_{D}} \frac{A_{D}}{A_{C}} + 1)}^{2} \end{array}$

where A'=1 when $\frac{{\dot{m}}_{B}}{{\dot{m}}_{C}} \frac{A_{C}}{A_{B}} \leq 0.8 or \frac{{\dot{m}}_{D}}{{\dot{m}}_{C}} \frac{A_{C}}{A_{D}} \leq 0.8$ and A'≈0.9 when $\frac{{\dot{m}}_{B}}{{\dot{m}}_{C}} \frac{A_{C}}{A_{B}} > 0.8 or \frac{{\dot{m}}_{D}}{{\dot{m}}_{C}} \frac{A_{C}}{A_{D}} > 0.8$ . The block smooths the transition between A' = 1 and A' = 0.9 using a hyperbolic tangent function.

According to [1], these loss coefficients are only applicable for diverging flow when the ratio of the side branch diameter to the main branch diameter is less than or equal to 2/3. However, the expected error for ratios above 2/3 is generally low enough that the block continues to use the above loss coefficients.

Custom Cross-Junction

When you set the Loss coefficient model parameter to Custom, the block uses the user-defined loss parameters to describe the pipe loss coefficient at each port.

For a custom cross-junction, the block allows four configurations diverging flow, converging flow, perpendicular flow, and colliding flow:

Diverging flow — Flow enters at node 1 and exits at nodes 2, 3, and 4.
Converging flow — Flow enters at nodes 1, 2, and 4 and exits at node 3.
Perpendicular flow — Flow enters at nodes 1 and 2 and exits at nodes 3 and 4.
Colliding flow — Flow enters at nodes 1 and 3 and exits at nodes 2 and 4.

This figure demonstrates these configurations.

Diagram of the four flow configurations: diverging flow, converging flow, perpendicular flow, and colliding flow

The block treats the junction as symmetrical about both the horizontal and vertical planes such that A₁ = A₃ and A₂ = A₄, where A_1,2,3,4 is the area of the corresponding port in the figure. Using this symmetry, the block assumes the loss coefficients from 1 to 2 and from 1 to 4 are identical during diverging, converging, and colliding flow.

During simulation, the block continually checks the direction of flow at each port and compares the result to the four possible flow configurations. When the block determines the flow configuration, it adjusts the node that each port corresponds to. For example, when the block experiences diverging flow where the fluid enters at port A and exits at ports B, C, and D, it assigns node 1 to port A as in the first panel of the figure. The other panels show the assigned nodes for diverging flow entering at ports other than A.

The four possible orientations of diverging flow, where the entry point is the reference node and can occur at any port.

For the custom cross-junction, all four flow configurations can occur in the same block during a simulation. You only need to supply parameters for each condition that the block experiences. If you use two-element vectors to specify the flow coefficients, the block uses the first or second element depending on whether node 1 aligns with the main line or the branch line. The first element corresponds to node 1 at port A or C, and the second element corresponds to node 1 at port B or D.

This table describes the conditions and coefficients for each operational mode used to determine the loss coefficients.

Flow Scenario	ṁ_A	ṁ_B	ṁ_C	ṁ_D	k_A	k_B	k_C	k_D
Diverging from node A	>ṁ_thresh	<-ṁ_thresh	<-ṁ_thresh	<-ṁ_thresh	0	k_{div,turning,main}	k_{div,straight,main}	k_{div,turning,main}
Diverging from node B	<-ṁ_thresh	>ṁ_thresh	<-ṁ_thresh	<-ṁ_thresh	k_{div,turning,side}	0	k_{div,turning,side}	k_{div,straight,side}
Diverging from node C	<-ṁ_thresh	<-ṁ_thresh	>ṁ_thresh	<-ṁ_thresh	k_{div,straight,main}	k_{div,turning,main}	0	k_{div,turning,main}
Diverging from node D	<-ṁ_thresh	<-ṁ_thresh	<-ṁ_thresh	>ṁ_thresh	k_{div,turning,side}	k_{div,straight,side}	k_{div,turning,side}	0
Converging to node A	<-ṁ_thresh	>ṁ_thresh	>ṁ_thresh	>ṁ_thresh	0	k_{conv,turning,main}	k_{conv,straight,main}	k_{conv,turning,main}
Converging to node B	>ṁ_thresh	<-ṁ_thresh	>ṁ_thresh	>ṁ_thresh	k_{conv,turing,side}	0	k_{conv,turing,side}	k_{conv,straight,side}
Converging to node C	>ṁ_thresh	>ṁ_thresh	<-ṁ_thresh	>ṁ_thresh	k_{conv,straight,main}	k_{conv,turning,main}	0	k_{conv,turning,main}
Converging to node D	>ṁ_thresh	>ṁ_thresh	>ṁ_thresh	<-ṁ_thresh	k_{conv,turing,side}	k_{conv,straight,side}	k_{conv,turing,side}	0
Perpendicular with main entry A	>ṁ_thresh	>ṁ_thresh	<-ṁ_thresh	<-ṁ_thresh	0	k_{perp,turning in,main}	k_{perp,straight,main}	k_{perp,turning out,main}
Perpendicular with main entry B	<-ṁ_thresh	>ṁ_thresh	>ṁ_thresh	<-ṁ_thresh	k_{perp,turning out,side}	0	k_{perp,turning in,side}	k_{perp,turning straight,side}
Perpendicular with main entry C	<-ṁ_thresh	<-ṁ_thresh	>ṁ_thresh	>ṁ_thresh	k_{perp,straight,main}	k_{perp,turning out,main}	0	k_{perp,turning in,main}
Perpendicular with main entry D	>ṁ_thresh	<-ṁ_thresh	<-ṁ_thresh	>ṁ_thresh	k_{perp,turning in,side}	k_{perp,turning straight,side}	k_{perp,turning out,side}	0
Colliding from main to branch	>ṁ_thresh	<-ṁ_thresh	>ṁ_thresh	<-ṁ_thresh	0	k_{coll,turning,main}	k_{coll,straight,main}	k_{coll,turning,main}
Colliding from branch to main	<-ṁ_thresh	>ṁ_thresh	<-ṁ_thresh	>ṁ_thresh	k_{coll,turning,side}	0	k_{coll,turning,side}	k_{coll,straight,side}
Stagnant	–	–	–	–	1 or last valid	1 or last valid	1 or last valid	1 or last valid

The flow is stagnant when the mass flow rate conditions do not match any defined flow scenario. The block uses these parameters to calculate the flow coefficients:

k_{div,straight,main} and k_{div,straight,side} are the first and second elements of the Diverging flow straight loss coefficient parameter, respectively.
k_{div,turning,main} and k_{div,turning,side} are the first and second elements of the Diverging flow turning loss coefficient parameter, respectively.
k_{conv,straight,main} and k_{conv,straight,side} are the first and second elements of the Converging flow straight loss coefficient parameter, respectively.
k_{conv,turning,main} and k_{conv,turning,side} are the first and second elements of the Converging flow turning loss coefficient parameter, respectively.
k_{perp,straight,main} and k_{perp,straight,side} are the first and second elements of the Perpendicular flow straight loss coefficient parameter, respectively.
k_{perp,turning in,main} and k_{perp,turning in,side} are the first and second elements of the Perpendicular flow straight loss coefficient parameter, respectively.
k_{perp,turning out,main} and k_{perp,turning out,side} are the first and second elements of the Perpendicular flow straight loss coefficient parameter, respectively.
k_{coll,straight,main} and k_{coll,straight,side} are the first and second elements of the Colliding flow straight loss coefficient parameter, respectively.
k_{coll,turning,main} and k_{coll,turning,side} are the first and second elements of the Colliding flow turning loss coefficient parameter, respectively.

Variables

To set the priority and initial target values for the block variables prior to simulation, use the Initial Targets section in the block dialog box or Property Inspector. For more information, see Set Priority and Initial Target for Block Variables.

Nominal values provide a way to specify the expected magnitude of a variable in a model. Using system scaling based on nominal values increases the simulation robustness. Nominal values can come from different sources, one of which is the Nominal Values section in the block dialog box or Property Inspector. For more information, see Modify Nominal Values for a Block Variable.

Ports

Conserving

expand all

A — Liquid port
thermal liquid

Thermal liquid conserving port associated with the liquid port.

B — Liquid port
thermal liquid

Thermal liquid conserving port associated with the liquid port.

C — Liquid port
thermal liquid

Thermal liquid conserving port associated with the liquid port.

D — Liquid port
thermal liquid

Thermal liquid conserving port associated with the liquid port.

Parameters

expand all

Junction Properties

Main line area (A,C) — Area of main path
`0.01` `m^2` (default) | positive scalar

Cross-sectional area of the main flow path from port A to port C.

Branch line area (B,D) — Area of branch path
`0.01` `m^2` (default) | positive scalar

Cross-sectional area of the branch flow path from port B to port D.

Critical Reynolds number — Upper Reynolds number limit for laminar flow
`150` (default) | positive scalar

Upper Reynolds number limit for laminar flow through the junction.

Zero-flow threshold Reynolds number — Reynolds number that corresponds to stagnant flow
`10` (default) | positive scalar

Reynolds number that the block uses to calculate the threshold beneath which the flow is stagnant. The block uses this threshold to reduce numerical chatter during simulation. This parameter does not have a physical meaning, but must be small in comparison to the expected mass flow rate values.

Loss coefficient configuration change time constant — Time scale of smoothing function
`0.0001 s` (default) | positive scalar

Time scale of the smoothing function. Use this parameter to ensure smooth transitions by tuning the block dynamic behavior during flow reversals.

Minimum valid flow ratio for coefficient calculation — Limit on flow ratios for coefficient calculations
`0.2` (default) | positive scalar

Minimum value for any flow ratio that the block uses to calculate loss coefficients. If the flow ratio is below this limit, it saturates at this value. The block uses this parameter to limit the impact of differences in flow magnitude between branches and to increase numerical stability if one branch has significantly less flow than others.

Only adjust this setting if your model has numerical stability problems.

Dependencies

To enable this parameter, set Loss coefficient model to Idel'chik correlation.

Smoothing factor — Numerical smoothing factor
`0.01` (default) | scalar between 0 and 1

Continuous smoothing factor that introduces a layer of gradual change to the flow response when it approaches the limit specified by the Minimum valid flow ratio for coefficient calculation parameter. Set this parameter to a nonzero value less than one to increase the stability of your simulation.

Only adjust this setting if your model has numerical stability problems.

Dependencies

To enable this parameter, set Loss coefficient model to Idel'chik correlation.

Fluid inertia — Option to model fluid inertia
`off` (default) | `on`

Whether to model fluid inertia, which lowers the risk of a block numerical issue during flow reversals. Avoid modeling fluid inertia unless it is numerically necessary, because it increases the computational cost.

Loss coefficient model — Loss coefficient type
`Idel'chik correlation` (default) | `Custom`

Junction loss coefficient model. Set this parameter to Custom to specify individual diverging and converging loss coefficients for each flow path segment.

Report when flow configuration is invalid — Simulation warning mode for invalid flow configurations
`None` (default) | `Warning` | `Error`

Simulation warning mode for operating conditions outside the valid flow configurations. If you select Warning, the block generates a warning for conditions outside the valid flow configurations. The warning does not cause simulation to stop. If you select Error, the simulation will stop for conditions outside the valid flow configurations.

Dependencies

To enable this parameter, set Loss coefficient model to Idel'chik correlation.

Diverging flow loss coefficients — Option to specify loss coefficients for diverging flow
`on` (default) | `off`

Whether to specify loss coefficients for diverging flow.

Dependencies

To enable this parameter, set Loss coefficient model to Custom.

Converging flow loss coefficients — Option to specify loss coefficients for converging flow
`on` (default) | `off`

Whether to specify loss coefficients for converging flow.

Dependencies

To enable this parameter, set Loss coefficient model to Custom.

Perpendicular flow loss coefficients — Option to specify loss coefficients for perpendicular flow
`off` (default) | `on`

Whether to specify loss coefficients for perpendicular flow.

Dependencies

To enable this parameter, set Loss coefficient model to Custom.

Colliding flow loss coefficients — Option to specify loss coefficients for colliding flow
`off` (default) | `on`

Whether to specify loss coefficients for colliding flow.

Dependencies

To enable this parameter, set Loss coefficient model to Custom.

Diverging Flow Coefficients

Diverging flow straight loss coefficient — Diverging flow straight loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Loss coefficient for the straight portion of the diverging flow. When you specify this parameter as a vector, the first element represents the loss coefficient when ports A or C align to node 1. The second element represents when ports B or D align to node 1. The block behaves the same for all orientations when you use a scalar.

Dependencies

To enable this parameter, set Loss coefficient model to Custom and select Diverging flow loss coefficients.

Diverging flow turning loss coefficient — Diverging flow turning loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Loss coefficient for the turning portions of the diverging flow. When you specify this parameter as a vector, the first element represents the loss coefficient when ports A or C align to node 1. The second element represents when ports B or D align to node 1. The block behaves the same for all orientations when you use a scalar.

Dependencies

To enable this parameter, set Loss coefficient model to Custom and select Diverging flow loss coefficients.

Converging Flow Coefficients

Converging flow straight loss coefficient — Converging flow straight loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Loss coefficient for the straight portion of the converging flow. When you specify this parameter as a vector, the first element represents the loss coefficient when ports A or C align to node 1. The second element represents when ports B or D align to node 1. The block behaves the same for all orientations when you use a scalar.

Dependencies

To enable this parameter, set Loss coefficient model to Custom and select Converging flow loss coefficients.

Converging flow turning loss coefficient — Converging flow turning loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Loss coefficient for the turning portions of the converging flow. When you specify this parameter as a vector, the first element represents the loss coefficient when ports A or C align to node 1. The second element represents when ports B or D align to node 1. The block behaves the same for all orientations when you use a scalar.

Dependencies

To enable this parameter, set Loss coefficient model to Custom and select Converging flow loss coefficients.

Perpendicular Flow Coefficients

Perpendicular flow straight loss coefficient — Perpendicular flow straight loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Loss coefficient for the straight portion of the perpendicular flow. When you specify this parameter as a vector, the first element represents the loss coefficient when ports A or C align to node 1. The second element represents when ports B or D align to node 1. The block behaves the same for all orientations when you use a scalar.

Dependencies

To enable this parameter, set Loss coefficient model to Custom and select Perpendicular flow loss coefficients.

Perpendicular flow turning to inflow loss coefficient — Perpendicular flow turning to inflow loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Loss coefficient for the flow turning to inflow in the perpendicular flow. When you specify this parameter as a vector, the first element represents the loss coefficient when ports A or C align to node 1. The second element represents when ports B or D align to node 1. The block behaves the same for all orientations when you use a scalar.

Dependencies

To enable this parameter, set Loss coefficient model to Custom and select Perpendicular flow loss coefficients.

Perpendicular flow turning to outflow loss coefficient — Perpendicular flow turning to outflow loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Loss coefficient for the flow turning to outflow in the perpendicular flow. When you specify this parameter as a vector, the first element represents the loss coefficient when ports A or C align to node 1. The second element represents when ports B or D align to node 1. The block behaves the same for all orientations when you use a scalar.

Dependencies

To enable this parameter, set Loss coefficient model to Custom and select Perpendicular flow loss coefficients.

Colliding Flow Coefficients

Colliding flow straight loss coefficient — Colliding flow straight loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Loss coefficient for the straight portion of the colliding flow. When you specify this parameter as a vector, the first element represents the loss coefficient when ports A or C align to node 1. The second element represents when ports B or D align to node 1. The block behaves the same for all orientations when you use a scalar.

Dependencies

To enable this parameter, set Loss coefficient model to Custom and select Colliding flow loss coefficients.

Colliding flow turning loss coefficient — Colliding flow turning loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Loss coefficient for the turning portion of the colliding flow. When you specify this parameter as a vector, the first element represents the loss coefficient when ports A or C align to node 1. The second element represents when ports B or D align to node 1. The block behaves the same for all orientations when you use a scalar.

Dependencies

To enable this parameter, set Loss coefficient model to Custom and select Colliding flow loss coefficients.

References

[1] Idel’chik, I. E. Handbook of hydraulic resistance: Coefficients of local resistance and of friction. Jerusalem: Israel Program for Scientific Translations, 1966.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2022b

expand all

R2024b: Robustness improvements enable block to more smoothly switch between mode chart states

The Cross-Junction (TL) block has new parameters and functionality that enable the block to more smoothly switch between states in mode charts. Adjust the Loss coefficient configuration change time constant parameter to control the time scale of the smoothing function. Use the Zero-flow threshold Reynold number parameter to calculate a non-zero mass flow rate threshold for stagnant flow. You can also now optionally model fluid inertia, which lowers the risk of a block numerical issue during flow reversals.

Results during flow reversals may be different than in previous releases. The behavior at steady-state conditions has not changed.

R2023b: New loss coefficient models

Use the Loss coefficient model parameter to control the junction loss coefficient model. Set Loss coefficient model to Idel'chik correlation to use the new analytical loss coefficient model. To use the same block behavior from previous releases, set Loss coefficient model to Custom.

Cross-Junction (TL)

Description

Mass, Momentum, and Energy Balance

Idel'chik Correlation Coefficient Model

Custom Cross-Junction

Variables

Ports

Conserving

A — Liquid port thermal liquid

B — Liquid port thermal liquid

C — Liquid port thermal liquid

D — Liquid port thermal liquid

Parameters

Junction Properties

Main line area (A,C) — Area of main path 0.01 m^2 (default) | positive scalar

Branch line area (B,D) — Area of branch path 0.01 m^2 (default) | positive scalar

Critical Reynolds number — Upper Reynolds number limit for laminar flow 150 (default) | positive scalar

Zero-flow threshold Reynolds number — Reynolds number that corresponds to stagnant flow 10 (default) | positive scalar

Loss coefficient configuration change time constant — Time scale of smoothing function 0.0001 s (default) | positive scalar

Minimum valid flow ratio for coefficient calculation — Limit on flow ratios for coefficient calculations 0.2 (default) | positive scalar

Dependencies

Smoothing factor — Numerical smoothing factor 0.01 (default) | scalar between 0 and 1

Dependencies

Fluid inertia — Option to model fluid inertia off (default) | on

Loss coefficient model — Loss coefficient type Idel'chik correlation (default) | Custom

Report when flow configuration is invalid — Simulation warning mode for invalid flow configurations None (default) | Warning | Error

Dependencies

Diverging flow loss coefficients — Option to specify loss coefficients for diverging flow on (default) | off

Dependencies

Converging flow loss coefficients — Option to specify loss coefficients for converging flow on (default) | off

Dependencies

Perpendicular flow loss coefficients — Option to specify loss coefficients for perpendicular flow off (default) | on

Dependencies

Colliding flow loss coefficients — Option to specify loss coefficients for colliding flow off (default) | on

Dependencies

Diverging Flow Coefficients

Diverging flow straight loss coefficient — Diverging flow straight loss coefficient [1.12, 1.12] (default) | positive scalar or vector

Dependencies

Diverging flow turning loss coefficient — Diverging flow turning loss coefficient [1.12, 1.12] (default) | positive scalar or vector

Dependencies

Converging Flow Coefficients

Converging flow straight loss coefficient — Converging flow straight loss coefficient [1.12, 1.12] (default) | positive scalar or vector

Dependencies

Converging flow turning loss coefficient — Converging flow turning loss coefficient [1.12, 1.12] (default) | positive scalar or vector

Dependencies

Perpendicular Flow Coefficients

Perpendicular flow straight loss coefficient — Perpendicular flow straight loss coefficient [1.12, 1.12] (default) | positive scalar or vector

Dependencies

Perpendicular flow turning to inflow loss coefficient — Perpendicular flow turning to inflow loss coefficient [1.12, 1.12] (default) | positive scalar or vector

Dependencies

Perpendicular flow turning to outflow loss coefficient — Perpendicular flow turning to outflow loss coefficient [1.12, 1.12] (default) | positive scalar or vector

Dependencies

Colliding Flow Coefficients

Colliding flow straight loss coefficient — Colliding flow straight loss coefficient [1.12, 1.12] (default) | positive scalar or vector

Dependencies

Colliding flow turning loss coefficient — Colliding flow turning loss coefficient [1.12, 1.12] (default) | positive scalar or vector

Dependencies

References

Extended Capabilities

C/C++ Code Generation Generate C and C++ code using Simulink® Coder™.

Version History

R2024b: Robustness improvements enable block to more smoothly switch between mode chart states

R2023b: New loss coefficient models

See Also

Topics

A — Liquid port
thermal liquid

B — Liquid port
thermal liquid

C — Liquid port
thermal liquid

D — Liquid port
thermal liquid

Main line area (A,C) — Area of main path
`0.01` `m^2` (default) | positive scalar

Branch line area (B,D) — Area of branch path
`0.01` `m^2` (default) | positive scalar

Critical Reynolds number — Upper Reynolds number limit for laminar flow
`150` (default) | positive scalar

Zero-flow threshold Reynolds number — Reynolds number that corresponds to stagnant flow
`10` (default) | positive scalar

Loss coefficient configuration change time constant — Time scale of smoothing function
`0.0001 s` (default) | positive scalar

Minimum valid flow ratio for coefficient calculation — Limit on flow ratios for coefficient calculations
`0.2` (default) | positive scalar

Smoothing factor — Numerical smoothing factor
`0.01` (default) | scalar between 0 and 1

Fluid inertia — Option to model fluid inertia
`off` (default) | `on`

Loss coefficient model — Loss coefficient type
`Idel'chik correlation` (default) | `Custom`

Report when flow configuration is invalid — Simulation warning mode for invalid flow configurations
`None` (default) | `Warning` | `Error`

Diverging flow loss coefficients — Option to specify loss coefficients for diverging flow
`on` (default) | `off`

Converging flow loss coefficients — Option to specify loss coefficients for converging flow
`on` (default) | `off`

Perpendicular flow loss coefficients — Option to specify loss coefficients for perpendicular flow
`off` (default) | `on`

Colliding flow loss coefficients — Option to specify loss coefficients for colliding flow
`off` (default) | `on`

Diverging flow straight loss coefficient — Diverging flow straight loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Diverging flow turning loss coefficient — Diverging flow turning loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Converging flow straight loss coefficient — Converging flow straight loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Converging flow turning loss coefficient — Converging flow turning loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Perpendicular flow straight loss coefficient — Perpendicular flow straight loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Perpendicular flow turning to inflow loss coefficient — Perpendicular flow turning to inflow loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Perpendicular flow turning to outflow loss coefficient — Perpendicular flow turning to outflow loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Colliding flow straight loss coefficient — Colliding flow straight loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

Colliding flow turning loss coefficient — Colliding flow turning loss coefficient
`[1.12, 1.12]` (default) | positive scalar or vector

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.