modelJoin_L2_Y
Extends from ClaRa.Components.VolumesValvesFittings.Fittings.JoinVLE_L2_Y (A join for two inputs).
Information
Purpose of model
A model of a split/join that is used to split or join mass flow rates in a hydraulic circuit. It is based on the three balance equations of mass, energy, and momentum. It is not discretized and only features one control volume. No heat losses are considered, but a replaceable pressure loss model is implemented. It contains four fluid models from the TIL media that are used to determine the states of the fluid from the specific enthalpy, the mass fractions of the components of the fluid, and the pressure.
Level of detail, physical effects considered, and physical insight
L2 (defined in the CodingConventions)
- pressure loss
- thermal intertia
- variable fluid properties
- mass storages due to density changes
Limits of validity
The volume of the split has to be known. Moreover, the chosen pressure loss model has to fit the investigation purpose.
Interfaces
The model of the split and the join are similiar.

Governing Equations
The equations have been simplified for an easier description of the model.





delta_p is calculated according to the chosen pressure loss model and depends on the mass flow through the inlet/outlet.
References
The model was extended from the ClaRa library.
Version History
Model was documented by Jan Westphal (j.westphal@tuhh.de) in January 2025
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Boolean | showExpertSummary (from JoinVLE_L2_Y) | simCenter.showExpertSummary | |Summary and Visualisation||True, if expert summary should be applied |
| Boolean | showData (from JoinVLE_L2_Y) | true | |Summary and Visualisation||True, if a data port containing p,T,h,s,m_flow shall be shown, else false |
| Boolean | preciseTwoPhase (from JoinVLE_L2_Y) | true | |Expert Stettings||True, if two-phase transients should be capured precisely |
| Fundamental Definitions | |||
| TILMedia.VLEFluid.Types.BaseVLEFluid | medium (from JoinVLE_L2_Y) | simCenter.fluid1 | Medium in the component |
| Initialisation | |||
| Boolean | useHomotopy (from JoinVLE_L2_Y) | simCenter.useHomotopy | True, if homotopy method is used during initialisation |
| Basics.Units.EnthalpyMassSpecific | h_start (from JoinVLE_L2_Y) | 1e5 | Start value of sytsem specific enthalpy |
| Basics.Units.Pressure | p_start (from JoinVLE_L2_Y) | 1e5 | Start value of sytsem pressure |
| ClaRa.Basics.Units.MassFraction[medium.nc - 1] | xi_start (from JoinVLE_L2_Y) | medium.xi_default | Start value for mass fraction |
| Integer | initOption (from JoinVLE_L2_Y) | 0 | Type of initialisation |
| General › Geometry | |||
| Basics.Units.Volume | volume (from JoinVLE_L2_Y) | 0.1 | System Volume |
| General › Nominal Values | |||
| Basics.Units.MassFlowRate[2] | m_flow_in_nom (from JoinVLE_L2_Y) | {10, 10} | Nominal mass flow rates at inlet |
| Nominal Values | |||
| Basics.Units.Pressure | p_nom (from JoinVLE_L2_Y) | 1e5 | Nominal pressure |
| Basics.Units.EnthalpyMassSpecific | h_nom (from JoinVLE_L2_Y) | 1e5 | Nominal specific enthalpy |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| ClaRa.Basics.Interfaces.FluidPortIn | inlet1 (from JoinVLE_L2_Y) | First inlet port | |
| ClaRa.Basics.Interfaces.FluidPortOut | outlet (from JoinVLE_L2_Y) | Outlet port | |
| ClaRa.Basics.Interfaces.EyeOut | eye (from JoinVLE_L2_Y) | ||
| ClaRa.Basics.Interfaces.FluidPortIn | inlet2 (from JoinVLE_L2_Y) | First inlet port |