modelJoin_L2_Y

Join model extended from the ClaRa library

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.

V*rho*(dh/dt)=m_in*h_in+m_out1*h_out1+m_out2*h_out2

p_in-p=delta_p(m_flow_in)

p-p_out1=delta_p(m_flow_out1)

p-p_out2=delta_p(m_flow_out2)

drho/dt*V=m_flow_in+m_flow_out1+m_flow_out2

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

TypeNameDefaultDescription
BooleanshowExpertSummary (from JoinVLE_L2_Y)simCenter.showExpertSummary|Summary and Visualisation||True, if expert summary should be applied
BooleanshowData (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
BooleanpreciseTwoPhase (from JoinVLE_L2_Y)true|Expert Stettings||True, if two-phase transients should be capured precisely
Fundamental Definitions
TILMedia.VLEFluid.Types.BaseVLEFluidmedium (from JoinVLE_L2_Y)simCenter.fluid1Medium in the component
Initialisation
BooleanuseHomotopy (from JoinVLE_L2_Y)simCenter.useHomotopyTrue, if homotopy method is used during initialisation
Basics.Units.EnthalpyMassSpecifich_start (from JoinVLE_L2_Y)1e5Start value of sytsem specific enthalpy
Basics.Units.Pressurep_start (from JoinVLE_L2_Y)1e5Start value of sytsem pressure
ClaRa.Basics.Units.MassFraction[medium.nc - 1]xi_start (from JoinVLE_L2_Y)medium.xi_defaultStart value for mass fraction
IntegerinitOption (from JoinVLE_L2_Y)0Type of initialisation
General › Geometry
Basics.Units.Volumevolume (from JoinVLE_L2_Y)0.1System 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.Pressurep_nom (from JoinVLE_L2_Y)1e5Nominal pressure
Basics.Units.EnthalpyMassSpecifich_nom (from JoinVLE_L2_Y)1e5Nominal specific enthalpy

Connectors

TypeNameDefaultDescription
ClaRa.Basics.Interfaces.FluidPortIninlet1 (from JoinVLE_L2_Y)First inlet port
ClaRa.Basics.Interfaces.FluidPortOutoutlet (from JoinVLE_L2_Y)Outlet port
ClaRa.Basics.Interfaces.EyeOuteye (from JoinVLE_L2_Y)
ClaRa.Basics.Interfaces.FluidPortIninlet2 (from JoinVLE_L2_Y)First inlet port

Components

TypeNameDefaultDescription
Stringcomplexity (from ComplexityLevel)"??"
ClaRa.SimCentersimCenter (from JoinVLE_L2_Y)
Basics.Units.EnthalpyFlowRate[2]H_flow_in (from JoinVLE_L2_Y)
Basics.Units.EnthalpyFlowRateH_flow_out (from JoinVLE_L2_Y)
Basics.Units.EnthalpyMassSpecifich (from JoinVLE_L2_Y)
Basics.Units.Massmass (from JoinVLE_L2_Y)Total system mass
Realdrhodt (from JoinVLE_L2_Y)
Basics.Units.Pressurep (from JoinVLE_L2_Y)System pressure
ClaRa.Basics.Units.MassFlowRate[2,medium.nc - 1]Xi_flow_in (from JoinVLE_L2_Y)Mass fraction flows at inlet
ClaRa.Basics.Units.MassFlowRate[medium.nc - 1]Xi_flow_out (from JoinVLE_L2_Y)Mass fraction flows at outlet
ClaRa.Basics.Units.MassFraction[medium.nc - 1]xi (from JoinVLE_L2_Y)Mass fraction
Summarysummary (from JoinVLE_L2_Y)
PressureLossIn1pressureLossIn1 (from JoinVLE_L2_Y)
PressureLossIn2pressureLossIn2 (from JoinVLE_L2_Y)
PressureLossOutpressureLossOut (from JoinVLE_L2_Y)
TILMedia.VLEFluid.MixtureCompatible.VLEFluid_phfluidIn1 (from JoinVLE_L2_Y)
TILMedia.VLEFluid.MixtureCompatible.VLEFluid_phfluidIn2 (from JoinVLE_L2_Y)
TILMedia.VLEFluid.MixtureCompatible.VLEFluid_phfluidOut (from JoinVLE_L2_Y)