SpectraSim Documentation
Parameter · 05 Boundary Conditions

Inlet velocity vector, z component

velocity_inlet.Uz Unit: m/s Step 05 · Boundary Conditions

The z component, in the global axes of the model, of the inlet velocity when the inlet mode is "Velocity vector". The three components are imposed as given, so the flow can enter at an angle to the inlet face.

Last updated

Theory

With the vector mode the program writes fixedValue with (Ux,Uy,Uz)(U_x, U_y, U_z) into 0/U for the inlet patch (OpenFOAM user guide, 2026): every face of the inlet gets the same vector. Only the component along the inward normal of the inlet carries flow into the domain, equation (1); the inward normal is minus the area-weighted mean outward normal of the exported inlet surface. The card shows that normal, the normal component, the angle between the vector and the normal, and the resulting volume flow.

Where the program needs a single inlet velocity, it uses:

  • the normal component for the flow rate (transient flow-through time, flow-rate bookkeeping);
  • the magnitude ∣U∣|\mathbf{U}| for the Mach number, the turbulence estimate and the first-layer plan of the mesh.

Where no normal is known, ∣U∣A|\mathbf{U}|A is used as an upper bound of the flow. A flow-rate sweep keeps the direction and scales the vector to the inlet's share of the total flow.

When the vector mode is first selected, the three boxes start from the current setting converted into a vector: the current velocity (or flow rate divided by the area and density) along the inward normal.

Equations

un=−U⋅n=−(Uxnx+Uyny+Uznz),Q=unA,θ=arccos⁡un∣U∣u_n = -\mathbf{U}\cdot\mathbf{n} = -(U_x n_x + U_y n_y + U_z n_z), \qquad Q = u_n A, \qquad \theta = \arccos\frac{u_n}{\lvert\mathbf{U}\rvert}
(1)
wheremeaningunit
U\mathbf{U}Inlet velocity vector (Ux,Uy,Uz)(U_x, U_y, U_z)m/s
n\mathbf{n}Area-weighted mean OUTWARD unit normal of the inlet patch-
unu_nVelocity component into the domainm/s
QQVolume flow rate into the domainm³/s
AAInlet patch aream²
θ\thetaAngle between the vector and the inward normal°

Default and rule

Default
the z component of the current inlet velocity along the inward normal
Rule

The current inlet velocity along the inward normal, split into its components.

Source

The boundary condition is OpenFOAM's fixedValue (OpenFOAM user guide, 2026); the conversion to a normal component and a flow rate is the program's own.

Valid range any; the vector must point into the domain (inward normal component > 0)

Pointing outwards

A vector whose inward normal component is zero or negative is refused when the case is built (it would be an outlet); the card warns while typing.

Uniform over the face

The same vector is imposed on every face of the inlet; a swirl or a profile cannot be entered.

Verified

Solved on a straight pipe (2026-11-11): the inlet mass flow equals that of the normal inlet with the same normal component; the cross-flow adds its kinetic energy to the inlet total pressure.

References 1

  1. OpenCFD Ltd. (2026). OpenFOAM user guide. openfoam.com. Web page