Physical Models

Physical properties and correlations are the most variant and rapidly changing code chunks. This package contains different options for the following physical phenomena (and yielded parameters):

  • Hydraulic Friction (friction coefficient, f)

  • Single Phase Heat Transfer (heat transfer coefficient, htc)

  • Reactor Safety Thermohydraulic Thresholds

  • Residual Heat (power contributions, P)

Dimensionless Numbers

Several flow properties and equations are given here, including dimensionless parameters and corresponding correlations

Gr(rho, mu, beta, T, Twall, Dh, g=9.80665)[source]

The Grashof number (Gr) is an approximation of the ratio of buoyancy to viscous forces.

For vertical flat plates:

\[\text{Gr} = \rho^2 g\beta (T_\text{wall}-T_\text{bulk})\frac{L_h^3}{\mu^2}\]
Parameters:
  • rho (KgPerM3) – fluid density

  • mu (PaS) – dynamic viscosity of the fluid

  • beta (PerC) – fluid thermal expansion coefficient

  • T (Celsius) – fluid bulk temperature

  • Twall (Celsius) – wallsurface temperature

  • Dh (Meter) – Hydraulic diameter

  • g (MPerS2) – Gravitational acceleration constant

Returns:

Gr – The Grashof Number

Return type:

Value

Examples

>>> Gr(rho=1, mu=1, beta=1, T=50, Twall=50, Dh=1)
0.0
Nu(h, L, k)[source]

The Nusselt number (Nu) is defined as the ratio between convective and conductive heat transfer across the boundary. \(\text{Nu} = hL/k\)

Parameters:
  • h (WPerM2K) – heat transfer coefficient

  • L (Meter) – characteristic or equivalent length

  • k (WPerMK) – thermal conductivity of the fluid

Returns:

Nu – The Nusselt number

Return type:

Value

Examples

>>> Nu(h=1., L=1., k=1.)
1.0
Pe(rho, v, L, cp, k)[source]

The Peclet number (Pe) is defined as the ratio between advective and diffusive transport rates. For heat transfer, it is the product of \(\text{Pe} = \text{Re}\text{Pr}\)

Parameters:
  • rho (KgPerM3) – fluid density

  • v (MPerS) – characteristic or equivalent velocity

  • L (Meter) – characteristic or equivalent length

  • cp (JPerKgK) – specific heat of the fluid

  • k (WPerMK) – thermal conductivity of the fluid

Returns:

Pe – The Peclet Number

Return type:

Value

Examples

>>> Pe(rho=1., v=1., L=1., cp=1., k=1.)
1.0
Pr(cp, mu, k)[source]

The Prandtl number (Pr) is defined as the ratio between viscous diffusivity and thermal diffusivity. \(\text{Pr} = c_p \mu / k\)

Parameters:
  • cp (JPerKgK) – specific heat of the fluid

  • mu (PaS) – dynamic viscosity of the fluid

  • k (WPerMK) – thermal conductivity of the fluid

Returns:

Pr – The Prandtl number

Return type:

Value

Examples

>>> Pr(cp=0.5, mu=0.1, k=50)
0.001
Ra(rho, mu, cp, k, beta, T, Twall, Dh, g=9.80665)[source]

The Rayleigh number (Ra) is associated with heat transfer for natural convection. At low values, heat transfer is primarily conductive, and at high values it is primarily convective. \(\text{Ra} = \text{Gr}\text{Pr}\)

Parameters:
  • rho (KgPerM3) – fluid density

  • mu (PaS) – dynamic viscosity of the fluid

  • cp (JPerKgK) – specific heat of the fluid

  • k (WPerMK) – thermal conductivity of the fluid

  • beta (PerC) – fluid thermal expansion coefficient

  • T (Celsius) – fluid bulk temperature

  • Twall (Celsius) – wallsurface temperature

  • Dh (Meter) – Hydraulic diameter

  • g (MPerS2) – Gravitational acceleration constant

Returns:

Ra – The Rayleigh Number

Return type:

Value

Examples

>>> Ra(rho=1, mu=1, cp=1, k=1, beta=1, T=50, Twall=50, Dh=1)
0.0
Re(rho, u, L, mu)[source]

The Reynolds number (Re) is defined as the ratio between inertial forces and viscous forces. \(\text{Re} = \rho u L / \mu\)

Parameters:
  • rho (KgPerM3) – fluid density

  • u (MPerS) – characteristic or equivalent velocity

  • L (Meter) – characteristic or equivalent length

  • mu (PaS) – dynamic viscosity of the fluid

Returns:

Re – The Reynolds number

Return type:

Value

Examples

>>> Re(rho=0., u=1., L=1., mu=1.)
0.0
>>> Re(rho=1., u=np.arange(-2, 3), L=1., mu=1.)
array([2., 1., 0., 1., 2.])
>>> Re(rho=1., u=1., L=1., mu=np.inf)
0.0
Re_mdot(mdot, A, L, mu)[source]

The Reynolds number (Re) is defined as the ratio between inertial forces and viscous forces. If \(\dot{m} = \rho uA\) is known, one may write \(\text{Re} = \dot{m}(L / A) / \mu\)

Parameters:
  • mdot (KgPerS) – fluid mass current

  • A (Meter2) – flow area

  • L (Meter) – characteristic or equivalent length

  • mu (PaS) – dynamic viscosity of the fluid

Returns:

Re – The Reynolds number

Return type:

Value

Examples

>>> Re_mdot(mdot=1., A=1., L=1., mu=1.)
1.0
>>> Re_mdot(mdot=-1., A=1., L=1., mu=1.)
1.0
>>> Re_mdot(mdot=0., A=1., L=1., mu=1.)
0.0
flow_regimes(re, bounds)[source]

Turbulent, Laminar and Interim regimes are determined by the Reynolds No.

Parameters:
  • re (np.ndarray) – Reynolds numbers vector

  • bounds (tuple[Value, Value]) –

    boundaries depicting transition between the aforementioned regimes, such that:

    • Re <= bounds[0] is considered laminar.

    • bounds[0] < Re <= bounds[1] is considered interim.

    • bounds[1] < Re is considered turbulent.

Returns:

Numpy masks – Laminar, Interim, Turbulent

Return type:

tuple[np.ndarray, np.ndarray, np.ndarray]

Examples

>>> a, b, c = flow_regimes(np.arange(5), (2, 3))
>>> a
array([ True,  True,  True, False, False])
>>> b
array([False, False, False,  True, False])
>>> c
array([False, False, False, False,  True])