modelPipeFlowVLE_L4_Simple
Extends from ClaRa.Components.VolumesValvesFittings.Pipes.PipeFlowVLE_L4_Simple (A 1D tube-shaped control volume considering one-phase and two-phase heat transfer in a straight pipe with static momentum balance and simple energy balance.), TransiEnt.Basics.Icons.PipeFlow_L4_Simple.
Information
Purpose of model
A simple model of a pipe flow with a VLE-fluid (Vapor liquid equilibrium) based on the three balance equations of energy, momentum and mass. The mass and the energy balance are dynamic, while the momentum balance is considered static. The balance equations are discretized with a finite volume method. The model uses n+2 fluid models from the TIL media to compute the fluid states at the inlet, outlet, and inside the control volumes of the pipe. Moreover, it uses a replaceable pressure loss model and a replaceable heat transfer model. Therefore, heat and pressure losses are considered. Heat losses are transferred through a heat port if the heat port is connected. However, the heat port doesn’t have to be connected for the model to function. The pipe model can be connected to other models via two fluid ports, which pass the pressure, the specific enthalpy, the mass fraction and the mass flow rate as variables. The model allows reverse flow. In the model are instances of iCom and summary, which are not relevant for the physical understanding of the model.
Level of detail, physical effects considered, and physical insight
L4 (defined in the CodingConventions)
- Heat losses
- Pressure losses
- Thermal inertia
- Variable fluid properties
- Mass storage due to density changes
Limits of validity
The accuracy of the dynamic effects of the model depends on the number of control volumes. The thermal inertia of the pipe wall is neglected.
Interfaces

Governing Equations
The equations have been simplified for easier description of the model.
(for N_cv control volumes)
(for N_cv control volumes)
(for N_cv control volumes)
(The density change is calculated with the TIL media fluid model. Last term is alway zero as the mass fraction doesn't change)
T and rho are determined with the fluid models
References
This model is extended from the ClaRa library. Look at the documentation of the ClaRal library for more information.
Version History
Model was documented by Jan Westphal january 2025 (j.westphal@tuhh.de)
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Units.DensityMassSpecific[geo.N_cv] | rho_nom (from VolumeVLE_L4) | TILMedia.VLEFluid.MixtureCompatible.Functions.density_phxi(medium, p_nom, h_nom) | Nominal density |
| Fundamental Definitions | |||
| TILMedia.VLEFluid.Types.BaseVLEFluid | medium (from VolumeVLE_L4) | simCenter.fluid1 | Medium in the component |
| Boolean | frictionAtInlet (from VolumeVLE_L4) | false | True if pressure loss between first cell and inlet shall be considered |
| Boolean | frictionAtOutlet (from VolumeVLE_L4) | false | True if pressure loss between last cell and outlet shall be considered |
| Nominal Values | |||
| Units.Pressure[geo.N_cv] | p_nom (from VolumeVLE_L4) | ones(geo.N_cv)*1e5 | Nominal pressure |
| Units.EnthalpyMassSpecific[geo.N_cv] | h_nom (from VolumeVLE_L4) | ones(geo.N_cv)*1e5 | Nominal specific enthalpy for single tube |
| Units.MassFlowRate | m_flow_nom (from VolumeVLE_L4) | 100 | Nominal mass flow w.r.t. all parallel tubes |
| Units.PressureDifference | Delta_p_nom (from VolumeVLE_L4) | 1e4 | Nominal pressure loss w.r.t. all parallel tubes |
| Initialisation | |||
| Integer | initOption (from VolumeVLE_L4) | 0 | Type of initialisation |
| Units.EnthalpyMassSpecific[geo.N_cv] | h_start (from VolumeVLE_L4) | ones(geo.N_cv)*800e3 | Initial specific enthalpy for single tube |
| Units.Pressure[geo.N_cv] | p_start (from VolumeVLE_L4) | ones(geo.N_cv)*1e5 | Initial pressure |
| Units.MassFraction[medium.nc - 1] | xi_start (from VolumeVLE_L4) | zeros(medium.nc - 1) | Initial composition |
| Initialisation › Model Settings | |||
| Boolean | useHomotopy (from VolumeVLE_L4) | simCenter.useHomotopy | true, if homotopy method is used during initialisation |
| Summary and Visualisation | |||
| Boolean | showExpertSummary (from VolumeVLE_L4) | simCenter.showExpertSummary | True, if an extended summary shall be shown, else false |
| Boolean | showData (from VolumeVLE_L4) | false | True, if a data port containing p,T,h,s,m_flow shall be shown, else false |
| Boolean | contributeToCycleSummary (from PipeFlowVLE_L4_Simple) | simCenter.contributeToCycleSummary | True if component shall contribute to automatic efficiency calculation |
| Boolean | heatFlowIsLoss (from PipeFlowVLE_L4_Simple) | true | True if negative heat flow is a loss (not a process product) |
| Geometry | |||
| Basics.Units.Length | length (from PipeFlowVLE_L4_Simple) | 1 | Length of the pipe (one pass) |
| Basics.Units.Length | diameter_i (from PipeFlowVLE_L4_Simple) | 0.1 | Inner diameter of the pipe |
| Basics.Units.Length | z_in (from PipeFlowVLE_L4_Simple) | 0.1 | Height of inlet above ground |
| Basics.Units.Length | z_out (from PipeFlowVLE_L4_Simple) | 0.1 | Height of outlet above ground |
| Integer | N_tubes (from PipeFlowVLE_L4_Simple) | 1 | Number Of parallel pipes |
| Integer | N_passes (from PipeFlowVLE_L4_Simple) | 1 | Number of passes of the tubes |
| Integer | orientation (from PipeFlowVLE_L4_Simple) | 0 | Main orientation of tube bundle (N_passes>1) |
| Discretisation | |||
| Integer | N_cv (from PipeFlowVLE_L4_Simple) | 3 | Number of finite volumes |
| Basics.Units.Length[N_cv] | Delta_x (from PipeFlowVLE_L4_Simple) | ClaRa.Basics.Functions.GenerateGrid({0}, length*N_passes, N_cv) | Discretisation scheme |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| ClaRa.Basics.Interfaces.FluidPortIn | inlet (from VolumeVLE_L4) | Inlet port | |
| ClaRa.Basics.Interfaces.FluidPortOut | outlet (from VolumeVLE_L4) | Outlet port | |
| ClaRa.Basics.Interfaces.HeatPort_a[geo.N_cv] | heat (from VolumeVLE_L4) | ||
| Basics.Interfaces.EyeOut | eye (from PipeFlowVLE_L4_Simple) |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| String | complexity (from ComplexityLevel) | "??" | |
| ClaRa.SimCenter | simCenter (from VolumeVLE_L4) | ||
| Summary | summary (from VolumeVLE_L4) | ||
| PressureLoss | pressureLoss (from VolumeVLE_L4) | Pressure loss model | |
| HeatTransfer | heatTransfer (from VolumeVLE_L4) | heat transfer model | |
| Geometry | geo (from VolumeVLE_L4) | ||
| MechanicalEquilibrium | mechanicalEquilibrium (from VolumeVLE_L4) | Mechanical equilibrium model | |
| ClaRa.Basics.Interfaces.Connected2SimCenter | connected2SimCenter (from PipeFlowVLE_L4_Simple) |