modelHeatExchanger_TubeBundle_L2
Extends from ClaRa.Components.HeatExchangers.TubeBundle_L2 (A flexible 0D tube bundle model), TransiEnt.Basics.Icons.Heat_Exchanger.
Information
Purpose of model
A model of a tube bundle heat exchanger with one control volume. It is based on the fluid volume L2 from the ClaRa library. Therefore, it is based on the three balance equations of mass, energy and momentum. The model uses a dynamic energy and mass balance and a static momentum balance. It contains two fluid ports for the transport of a heat carrier medium through the heat exchanger and a heat port. The transported heat is transferred through the heat port. In the geometry model, the areas are calculated. The model uses three fluid models from the TIL media to compute the states of the fluid at the inlet, outlet and inside the control volumes of the heat exchanger.
Level of detail, physical effects considered, and physical insight
L2 (defined in the CodingConventions)
- Thermal inertia
- Pressure loss
- Physical or generic heat transfer
- Mass (density) changes
- variable fluid properties
Limits of validity
(Purely technical component without physical modeling.)
Interfaces
Governing Equations
Simplified equations for an easier description of the model.




dp and alpha are calculated by the chosen pressure loss and the chosen heat transfer model.
References
The model was extended from the ClaRa library. Look there for further documentation or verification.
Version History
The model was documented by Jan Westphal (j.westphal@tuhh.de) in January 2025
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Fundamental Definitions | |||
| TILMedia.VLEFluid.Types.BaseVLEFluid | medium (from VolumeVLE_L2) | simCenter.fluid1 | Medium in the component |
| Initialisation | |||
| Boolean | useHomotopy (from VolumeVLE_L2) | simCenter.useHomotopy | True, if homotopy method is used during initialisation |
| ClaRa.Basics.Units.EnthalpyMassSpecific | h_start (from VolumeVLE_L2) | 1e5 | Start value of system specific enthalpy |
| ClaRa.Basics.Units.Pressure | p_start (from VolumeVLE_L2) | 1e5 | Start value of system pressure |
| ClaRa.Basics.Units.MassFraction[medium.nc - 1] | xi_start (from VolumeVLE_L2) | medium.xi_default | Start value for mass fraction |
| Integer | initOption (from VolumeVLE_L2) | 0 | Type of initialisation |
| General › Nominal Values | |||
| ClaRa.Basics.Units.MassFlowRate | m_flow_nom (from VolumeVLE_L2) | 10 | Nominal mass flow rates at inlet |
| Nominal Values | |||
| ClaRa.Basics.Units.Pressure | p_nom (from VolumeVLE_L2) | 1e5 | Nominal pressure |
| ClaRa.Basics.Units.EnthalpyMassSpecific | h_nom (from VolumeVLE_L2) | 1e5 | Nominal specific enthalpy |
| ClaRa.Basics.Units.MassFraction[medium.nc - 1] | xi_nom (from VolumeVLE_L2) | medium.xi_default | Nominal mass fraction |
| Summary and Visualisation | |||
| Boolean | showExpertSummary (from VolumeVLE_L2) | simCenter.showExpertSummary | True, if expert summary should be applied |
| Boolean | showData (from TubeBundle_L2) | true | True, if a data port containing p,T,h,s,m_flow shall be shown, else false |
| Boolean | contributeToCycleSummary (from TubeBundle_L2) | simCenter.contributeToCycleSummary | True if component shall contribute to automatic efficiency calculation |
| Boolean | heatFlowIsLoss (from TubeBundle_L2) | true | True if heat flow is a loss (not a process product) |
| Geometry | |||
| Integer | heatSurfaceAlloc (from VolumeVLE_L2) | 1 | Heat transfer area to be considered |
| Modelica.Units.SI.Length | length (from TubeBundle_L2) | 1 | Length of the volume in flow direction |
| Modelica.Units.SI.Length | diameter (from TubeBundle_L2) | 0.1 | Diameter of the single tube |
| Integer | N_tubes (from TubeBundle_L2) | 1 | Number of prallel tubes |
| Integer | N_passes (from TubeBundle_L2) | 1 | Number of passes of the internal tubes |
| Modelica.Units.SI.Length | z_in (from TubeBundle_L2) | length/2 | Inlet position from bottom |
| Modelica.Units.SI.Length | z_out (from TubeBundle_L2) | length/2 | Outlet position from bottom |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| ClaRa.Basics.Interfaces.FluidPortIn | inlet (from VolumeVLE_L2) | Inlet port | |
| ClaRa.Basics.Interfaces.FluidPortOut | outlet (from VolumeVLE_L2) | Outlet port | |
| ClaRa.Basics.Interfaces.HeatPort_a | heat (from VolumeVLE_L2) | ||
| ClaRa.Basics.Interfaces.EyeOut | eye (from TubeBundle_L2) |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| String | complexity (from ComplexityLevel) | "??" | |
| ClaRa.SimCenter | simCenter (from VolumeVLE_L2) | ||
| ClaRa.Basics.Units.Mass | mass (from VolumeVLE_L2) | Total system mass | |
| ClaRa.Basics.Units.Pressure | p (from VolumeVLE_L2) | System pressure | |
| Summary | summary (from VolumeVLE_L2) | ||
| TILMedia.VLEFluid.MixtureCompatible.VLEFluid_ph | fluidIn (from VolumeVLE_L2) | ||
| TILMedia.VLEFluid.MixtureCompatible.VLEFluid_ph | fluidOut (from VolumeVLE_L2) | ||
| HeatTransfer | heattransfer (from VolumeVLE_L2) | ||
| Geometry | geo (from VolumeVLE_L2) | ||
| PhaseBorder | phaseBorder (from VolumeVLE_L2) | ||
| PressureLoss | pressureLoss (from VolumeVLE_L2) | ||
| ClaRa.Basics.Interfaces.Connected2SimCenter | connected2SimCenter (from TubeBundle_L2) |