modelLoopBreaker

Loop breaker model - Underdetermined (1 equation)

Extends from ThermofluidStream.Utilities.DropOfCommonsPlus (Extend this to use 'dropOfCommons', 'instanceName', 'displayInstanceName' and 'displayParameters').

Information

Combination of ThermofluidStream.Source with Sink_free to artificially close a loop. Cyclic loops without a loop breaker lead to algebraic loops which can make the system unsolvable. The loop-breaker acts as both a source and a sink, defining a beginning (source) and an end (sink) in the loop, breaking the algebraic equations.

The model is locally underdetermined (1 equation missing) and therefore must be connected to an overdetermined one (e.g., MassFlowRate) to ensure that the overall system is balanced.

Inlet and outlet states of the loop breaker are independent of each other. The outlet state of the loop breaker is prescribed, while the user must ensure that the inlet state is consistent. Any deviation is indicated by a warning.

Parameters

TypeNameDefaultDescription
StringinstanceName (from DropOfCommonsPlus)getInstanceName()Instance name
StringnamegetInstanceName()
Layout
BooleandisplayInstanceName (from DropOfCommonsPlus)dropOfCommons.displayInstanceNames= true, if instance name is displayed
BooleandisplayParameters (from DropOfCommonsPlus)dropOfCommons.displayParameters= true, if displaying parameters is enabled
Pressure
ValueSpecificationpSpecThermofluidStream.Types.ValueSpecification.FixedSpecifies whether the outlet pressure is fixed or prescribed
Medium.AbsolutePressurep_out_fixedMedium.p_defaultFixed outlet pressure
Thermal
ThermalSpecificationthermalSpecThermofluidStream.Types.ThermalSpecification.TemperatureThermal quantity used to define the outlet state
ValueSpecificationthermalValueSpecThermofluidStream.Types.ValueSpecification.FixedSpecifies whether the outlet thermal quantity is fixed or prescribed
Medium.TemperatureT_out_fixedMedium.T_defaultFixed outlet temperature
Medium.SpecificEnthalpyh_out_fixedMedium.h_defaultFixed outlet specific enthalpy
Mass fractions
ValueSpecificationXiSpecThermofluidStream.Types.ValueSpecification.FixedSpecifies whether the outlet mass fractions are fixed or prescribed
Medium.MassFraction[Medium.nXi]Xi_out_fixedMedium.X_default[1:Medium.nXi]Fixed outlet mass fractions
Advanced
BooleanconsiderInertancedropOfCommons.considerInertance=true, if transient momentum (inertance) term is considered; disable only for advanced use
ThermofluidStream.Utilities.Units.InertanceLdropOfCommons.LInertance
Advanced › Accepted errors
AssertionLevelassertionLevelAssertionLevel.warningAssertion level
SI.PressureDifferencetol_p1e-5*Medium.p_defaultAbsolute tolerance for pressure p_in, p_out
SI.SpecificEnthalpytol_h500Absolute tolerance for specific enthalpy h_in, h_out
SI.MassFlowRatetol_m_flow1e-3Absolute tolerance for mass flow rate m_flow_in, m_flow_out
SI.MassFlowRatetol_Xi1e-5Absolute tolerance for mass fractions Xi_in, Xi_out
Layout › Display parameters
BooleanshowPressuretrue= true to show the fixed outlet pressure value p_out_fixed
BooleanshowThermalSpecificationtrue= true to show the fixed outlet thermal specification value (either T_out_fixed or h_out_fixed)
BooleanshowMassFractionsfalse= true to show the fixed outlet mass fraction values Xi_out_fixed

Connectors

TypeNameDefaultDescription
Modelica.Blocks.Interfaces.RealInputp_out_prescribedPrescribed outlet pressure [Pa]
Modelica.Blocks.Interfaces.RealInputT_out_prescribedPrescribed outlet temperature [K]
Modelica.Blocks.Interfaces.RealInputh_out_prescribedPrescribed outlet specific enthalpy [J/kg]
Modelica.Blocks.Interfaces.RealInput[Medium.nXi]Xi_out_prescribedPrescribed outlet mass fractions [kg/kg]
ThermofluidStream.Interfaces.Inletinlet
ThermofluidStream.Interfaces.Outletoutlet

Components

TypeNameDefaultDescription
SI.MassFlowRatem_flow_ininlet.m_flowMass flow rate
Medium.AbsolutePressurep_inMedium.pressure(inlet.state)Inlet pressure
Medium.SpecificEnthalpyh_inMedium.specificEnthalpy(inlet.state)Inlet specific enthalpy
Medium.MassFraction[Medium.nXi]Xi_inMedium.massFraction(inlet.state)Inlet mass fractions
SI.MassFlowRatem_flow_out-outlet.m_flowMass flow rate outlet
SI.MassFlowRatedm_flowMass flow rate difference
SI.PressuredpPressure difference
SI.SpecificEnthalpydhSpecific enthalpy difference
ThermofluidStream.Units.MassFractionDifference[Medium.nXi]dXiMass fraction difference

Contents

NameDescription
MediumMedium model

Revisions

  • 2026, by Raphael Gebhart (raphael.gebhart@dlr.de):
    Initial version.