modelDynamicOnePhaseFlowShell

Dynamic one-phase flow shell
Diagram of DynamicOnePhaseFlowShell

Information

## Copyright © EDF 2002 - 2026  
## ThermoSysPro Version 4.2  
This component model is documented in Sect. 9.4.3 of the ThermoSysPro book.   
Nota: component model name in title of Sect. 9.4.3.3 in book is incorrectly given as DynamicTwoPhaseFlowShell, instead of DynamicOnePhaseFlowShell.   
# Dynamic one phase flow shell  

This component is a heat exchanger shell.  
The space between the tube bundle and the shell is filled with liquid water, which exchanges heat with the fluids in the tubes.  
The shell model represents the fluid circulating outside the tube bundle and the thermal exchange between fluid and tubes.  
It can be used for single- and two-phase flow.  

## Modelica component model  

The equations mentioned below are implemented in the component *DynamicOnePhaseFlowShell*, located in the *WaterSteam.HeatExchangers* sub-library.  
This component has 3 connectors:  
- C1: fluid inlet,  
- CTh: thermal port,  
- C2: fluid outlet.  

![modelica://ThermoSysPro/UsersGuide/Documentation/ThermoSysPro.WaterSteam.HeatExchangers.DynamicOnePhaseFlowShell.svg](modelica://ThermoSysPro/UsersGuide/Documentation/ThermoSysPro.WaterSteam.HeatExchangers.DynamicOnePhaseFlowShell.svg)  

## Nomenclature  

| Symbol| Description| Unit| Definition| Modelica name |  
| :--------------------------- | :----------------------------------------------------------------------------------- | :-------------------------------------------- | :------------------------------------------------------------------------------------------------------------- | :----------- |  
| \\(A\\)| Cross-sectional area of the fluid flow that is perpendicular to the pipes| \\(\mathrm{m}^{2}\\)| \\(\pi \cdot D\_{s}^{2} / 4-N\_{\mathrm{t}} \cdot \pi \cdot D\_{\mathrm{e}}^{2} / 4\\)| A |  
| \\(A\_{s}\\)| Maximum cross-sectional area of the fluid that is parallel to the pipes| \\(\mathrm{m}^{2}\\)| \\(D\_{\mathrm{s}} \cdot L\_{\mathrm{c}} \cdot\left\(\frac{S\_{\mathrm{L}}-D\_{\mathrm{e}}}{S\_{\mathrm{L}}}\right\)\\) | As |  
| \\(c\_{p, l, i}\\)| Specific heat capacity of the liquid phase for cell \\(i\\)| \\(\mathrm{J} / \mathrm{K} / \mathrm{kg}\\)|| cp[i] |  
| \\(D\_{\mathrm{e}}\\)| External diameter of one pipe| \\(\mathrm{m}\\)|| De |  
| \\(D\_{\mathrm{s}}\\)| Shell internal diameter| \\(\mathrm{m}\\)|| Ds |  
| \\(L\_{\mathrm{c}}\\)| Distance between two plates in the shell \(support plate spacing in the cooling zone\) | \\(\mathrm{m}\\)|| B |  
| \\(Pr\_{l, i}\\)| Prandtl number of the liquid phase for thermal cell \\(i\\)|| \\(\frac{c\_{p, 1, i} \cdot \mu\_{l, i}}{\lambda\_{l, i}}\\)| Pr[i] |  
| \\(q\_{S, i:i+1}\\)| Surface mass flow rate for hydraulic cell \\(i: i+1\\)| \\(\mathrm{kg} / \mathrm{s} / \mathrm{m}^{2}\\) | \\(\frac{\dot{m}\_{i:i+1}}{A\_{s}}\\)| - |  
| \\(R e\_{l, i:i+1}\\)| Reynolds number of the liquid phase for hydraulic cell \\(i: i+1\\)| \\(-\\)|| Re2[i] |  
| \\(R e\_{l, i}\\)| Reynolds number of the liquid phase for thermal cell \\(i\\)| \\(-\\)|| Re1[i] |  
| \\(S\_{\mathrm{L}}\\)| Longitudinal step| \\(\mathrm{m}\\)|| dc |  
| \\(S\_{\mathrm{T}}\\)| Transverse step| \\(\mathrm{m}\\)|| - |  
| \\(\theta\\)| Average bend angle \(pipe triangular step\)| Degree|| - |  
| \\(\lambda\_{l, i}\\)| Liquid thermal conductivity for thermal cell \\(i\\)| \\(\mathrm{W} / \mathrm{m} / \mathrm{K}\\)|| k[i] |  
| \\(\mu\_{l, i:i+1}\\)| Liquid dynamic viscosity for hydraulic cell \\(i: i+1\\)| Pa \\(\mathrm{s}\\)|| mu2[i] |  
| \\(\mu\_{l\mathrm{T}, i:i+1}\\) | Liquid dynamic viscosity at the wall temperature for hydraulic cell \\(i: i+1\\)| Pa \\(\mathrm{s}\\)|| - |  
| \\(\mu\_{l, i}\\)| Liquid dynamic viscosity for thermal cell \\(i\\)| Pa s|| mu1[i] |  


## Governing equations  

The shell equations are similar to the tube bundle heat exchanger (see [Tube bundle heat exchanger](modelica://ThermoSysPro.WaterSteam.HeatExchangers.DynamicTwoPhaseFlowPipe), except the friction correlation in the momentum balance equations.  

### Dynamic momentum balance equations  

- Validity domain:  

\\(\forall \dot{m}\_{i:i+1}\\) and \\(400<R e\_{l, i:i+1}<10^{6}\\)|  

- Mathematical formulation:  

$$\frac{1}{A\_{s}} \cdot \frac{\mathrm{d} \dot{m}\_{i:i+1}}{\mathrm{d} t} \cdot \Delta x\_{2}=P\_{i}-P\_{i+1}-\(\Delta P\)\_{i:i+1}^{\mathrm{a}}-\(\Delta P\)\_{i:i+1}^{\mathrm{f}}-\(\Delta P\)\_{i:i+1}^{\mathrm{g}}$$  

$$\(\Delta P\)\_{i:i+1}^{\mathrm{a}}=\frac{\dot{m}\_{i:i+1} \cdot\left|\dot{m}\_{i:i+1}\right|}{A\_{\mathrm{s}}^{2}} \cdot\left\(\frac{1}{\rho\_{i+1}}-\frac{1}{\rho\_{i}}\right\)$$  

$$\(\Delta P\)\_{i:i+1}^{\mathrm{f}}=\frac{\Lambda\_{i:i+1} \cdot \dot{m}\_{i} \cdot\left|\dot{m}\_{i}\right| \cdot\left\(D\_{\mathrm{s}} / S\_{\mathrm{T}}\right\) \cdot\left\(L / L\_{\mathrm{c}}+1\right\)}{2 \cdot A\_{\mathrm{s}}^{2} \cdot \rho\_{i:i+1} \cdot N}$$  

$$\(\Delta P\)\_{i:i+1}^{\mathrm{g}}=\rho\_{i:i+1} \cdot g \cdot\left\(z\_{i+1}-z\_{i}\right\)$$  

- Comments::  

The friction coefficient \\(\Lambda\_{i}\\) is computed using \\(\Lambda\_{i:i+1}=e^{0.576-0.19 \ln R\_{e i, i t}+1}\\).  
The Reynolds number for the liquid phase is given by: \\(R e\_{l, i:i+1}=\frac{q\_{S, i:i+1} \cdot D\_{\mathrm{e}}}{\mu\_{l, i:i+1}}\\).  

### Convective heat exchanged between the fluid and the wall  


- Validity domain:  

\\(\forall T\_{\mathrm{w}, i}\\) and \\(\forall T\_{i}\\)  

- Mathematical formulation:   

$$\Delta W\_{i}=h\_{\mathrm{c}, \mathrm{i}} \cdot \Delta A\_{i} \cdot\left\(T\_{\mathrm{w}, i}-T\_{i}\right\)$$  

- Comments:   

The convection heat transfer coefficient \\(h\_{\mathrm{c}, \mathrm{i}}\\)between the fluid and the wall is computed using:  

$$ h\_{\mathrm{c}, \mathrm{i}}=\frac{\lambda\_{l}}{D\_{\mathrm{e}}} \cdot 0.5 \cdot R e\_{l, i}^{0,507} \cdot P r\_{l, i}^{0,33} $$ for  \\(R e\_{l, i}<2000\\)  

$$ h\_{\mathrm{c}, \mathrm{i}}=\frac{\lambda\_{l}}{D\_{\mathrm{e}}} \cdot 0.36 \cdot R e\_{l, i}^{0,55} \cdot P r\_{l, i}^{0,33} \cdot \left(\frac{\mu\_{l, i}}{\mu\_{\mathrm{Tr}, i}}\right)^{0,14}$$ for  \\(2000<R e\_{l, i}<10^{6}\\)  

For the sake of simplicity, \\(R e\_{l, i}=R e\_{l, i:i+1}\\).  

## References  

El Hefni, Baligh and Bouskela, Daniel (2019). [Modeling and Simulation of Thermal Power Plants with ThermoSysPro](https://link.springer.com/book/10.1007/978-3-030-05105-1), sect. 9.4.3. Springer Nature Switzerland AG.

Parameters

TypeNameDefaultDescription
Integeroption_arrangement11:triangle - 2: square
Units.SI.LengthL12Shell length
Units.SI.DiameterDs1shell internal diameter
Units.SI.DiameterDe0.019tube external diameter
Units.SI.Distancedc0.030Central distance of two tubes
Units.SI.LengthB1.2distance between two plates in the shell
Realrugosrel0.0007Pipe relative roughness
Integerntubes500Number of pipes in parallel
Units.SI.Positionz10Pipe inlet altitude
Units.SI.Positionz20Pipe outlet altitude
RealdpfCorr1.00Corrective term for the friction pressure loss (dpf) for each node
RealhcCorr1.00Corrective term for the heat exchange coefficient (hc) for each node
IntegerNs10Number of segments
Units.SI.Temperature[Ns]T0fill(290, Ns)Initial fluid temperature (active if steady_state = false and option_temperature = 1)
Units.SI.SpecificEnthalpy[Ns]h0fill(1e5, Ns)Initial fluid specific enthalpy (active if steady_state = false and option_temperature = 2)
Booleaninertiatruetrue: momentum balance equation with inertia - false: without inertia
Booleanadvectionfalsetrue: momentum balance equation with advection terme - false: without advection terme
Booleandynamic_mass_balancetruetrue: dynamic mass balance equation - false: static mass balance equation
Booleandynamic_energy_balancetruetrue: dynamic energy balance equation - false: static energy balance equation
Booleansimplified_dynamic_energy_balancetruetrue: simplified dynamic energy balance equation - false: full dynamic energy balance equation (active if dynamic_energy_balance=true)
Booleansteady_statetruetrue: start from steady state - false: start from T0 (if option_temperature=1) or h0 (if option_temperature=2)
Integeroption_temperature11:initial temperature is fixed - 2:initial specific enthalpy is fixed (active if steady_state = false)
Booleancontinuous_flow_reversaltruetrue: continuous flow reversal - false: discontinuous flow reversal
Integermode0IF97 region. 1:liquid - 2:steam - 4:saturation line - 0:automatic
Units.SI.AreaAsB*Ds*dt/dcmaximum cross sectional area of flow in shell
Units.SI.AreaApi*Ds^2/4 - ntubes*pi*De^2/4Liquid cross sectional in shell

Connectors

TypeNameDefaultDescription
Connectors.FluidInletC1
Connectors.FluidOutletC2
ThermoSysPro.Thermal.Connectors.ThermalPort[Ns]CTh

Components

TypeNameDefaultDescription
Units.SI.AbsolutePressure[N + 1]PFluid pressure in node i
Units.SI.MassFlowRate[N]QMass flow rate in node i
Units.SI.SpecificEnthalpy[N + 1]hFluid specific enthalpy in node i
Units.SI.SpecificEnthalpy[N]hbFluid specific enthalpy at the boundary of node i
Units.SI.Density[N - 1]rho1Fluid density in thermal node i
Units.SI.Density[N]rho2Fluid density in hydraulic node i
Units.SI.Density[N + 1]rhocFluid density at the boudary of node i
Units.SI.Power[N - 1]dW1Thermal power exchanged on the water side for node i
Units.SI.PowerW1tTotal power exchanged on the water side
Units.SI.Temperature[N - 1]TpWall temperature in node i
Units.SI.CoefficientOfHeatTransfer[N - 1]hcFluid heat exchange coefficient in node i
Units.SI.ReynoldsNumber[N - 1]Re1Fluid Reynolds number in thermal node i
Units.SI.ReynoldsNumber[N]Re2Fluid Reynolds number in hydraulic node i
Real[N - 1]PrFluid Prandtl number in node i
Units.SI.ThermalConductivity[N - 1]kFluid thermal conductivity in node i
Units.SI.DynamicViscosity[N - 1]mu1Fluid dynamic viscosity in thermal node i
Units.SI.DynamicViscosity[N]mu2Fluid dynamic viscosity in hydraulic node i
Units.SI.SpecificHeatCapacity[N - 1]cpFluid specific heat capacity
Units.SI.Temperature[N - 1]T1Fluid temperature in thermal node i
Units.SI.Temperature[N]T2Fluid temperature in hydraulic node i
ThermoSysPro.Units.SI.PressureDifference[N]dpaAdvection term for the mass balance equation in node i
ThermoSysPro.Units.SI.PressureDifference[N]dpfFriction pressure loss in node i
ThermoSysPro.Units.SI.PressureDifference[N]dpgGravity pressure loss in node i
Real[N]lambdaFriction pressure loss coefficient in node i
Units.SI.DiameterDeq1
ThermoSysPro.Properties.WaterSteam.Common.ThermoProperties_ph[N - 1]pro1
ThermoSysPro.Properties.WaterSteam.Common.ThermoProperties_ph[2]proc
ThermoSysPro.Properties.WaterSteam.Common.ThermoProperties_ph[N]pro2
ThermoSysPro.Properties.WaterSteam.Common.PropThermoSat[N - 1]lsat
ThermoSysPro.Properties.WaterSteam.Common.PropThermoSat[N - 1]vsat

Revisions

Authors  

Baligh El Hefni  
Daniel Bouskela  
Jiahui Lu