SpectraSim Documentation
Wizard step

Boundary Conditions

One card per patch: the inlet's velocity or flow rate and turbulence, the outlet's pressure, the walls' roughness and (with heat transfer) their thermal condition, the perforated walls' loss model, the absorptive backing (packing) and, with acoustics on, the acoustic port of each inlet and outlet.

Last updated

What this step does

The patches are the groups of CAD faces assigned on the Geometry step. The list on the left groups them as inlets, outlets, outer walls, perforated walls and internal walls, followed by one entry per absorptive backing (Absorptive backing 1, 2, ...: the packing regions of the Geometry step, smallest region number first). Choosing a patch shows its card and highlights its faces in the model view; choosing a backing highlights the boundary faces of its region. Clicking a face in the model opens its card: a face of a backing's region opens the backing, unless it belongs to an inlet, outlet or perforated wall, which keep their own cards; a second click on a face of the entry already shown opens the face's other owner, so both can be reached from the model.

Inlets. The inlet mode (Inlet mode) imposes a uniform velocity normal to the inlet, a volume flow, a mass flow (Inlet density converts it for the incompressible solver) or a velocity vector. A flow rate is exact whatever the meshed area; a velocity delivers its flow through the meshed area. The inlet turbulence is estimated for fully developed pipe flow or set from an intensity and a mixing length (Inlet turbulence). A compressible case also needs the inlet temperature (Inlet temperature). The card shows the estimated inlet Mach number; saving asks for confirmation above 0.3 (incompressible) or 0.6 (compressible).

Outlets. A fixed static pressure relative to the ambient pressure of the Material step (Outlet gauge pressure); the absolute value is shown below it (Outlet absolute pressure).

Walls. All walls are no-slip with wall functions: Spalding's law for the turbulent viscosity, continuous from the viscous sublayer to the log layer (Spalding, 1961), with kk and ω\omega wall functions. The low-Re treatment of the Mesh step switches to the low-Re forms. A roughness height (Wall roughness height, Roughness constant) switches the wall to the rough-wall function.

An internal wall (a zero-thickness baffle) becomes two wall patches in the mesh, <name> and <name>_slave; both sides receive the same settings and both are no-slip. With heat transfer, each outer wall has a thermal condition (Thermal condition of a wall): adiabatic, a fixed temperature, or heat loss through a shell and insulation to still or moving air, with radiation. Internal walls remain adiabatic.

Perforated walls. A perforated tube or plate is a zero-thickness porous jump on a cyclic baffle pair. The pressure drop across it follows a loss coefficient K, either typed or computed from the open-area ratio and the flow regime (Perforation type, Open-area ratio). For a perforated tube, K is updated from the solved flow (grazing correction). With acoustics on, the card also holds the wall's acoustic impedance model; a micro-perforated wall can take its non-linear (high-level) resistance from the hole velocity at the inlets' level (Non-linear resistance of a micro-perforate).

Absorptive backing. A packing is a fluid region ticked on the Geometry step's Domains tab; its card holds the material.

The flow resistivity is entered at room temperature; the flow and acoustic solutions scale it with the viscosity of the local gas. A packing is best bounded by perforated walls: an open interface between packing and gas follows the mesh resolution only. When the Kirby and Cummings impedance model is chosen, a perforated wall with packing on one side receives that model's porous-backing correction (Kirby and Cummings, 1998).

Acoustic ports. With acoustics on, every inlet and outlet card has an acoustic port: whether the inlet is excited, by an amplitude or a power and a phase (Excite this inlet), the outlet termination used for the insertion loss (Outlet: compute a radiation domain), and how the port absorbs the waves leaving the model: multimodal (default), plane-wave only, or a PML stub that also absorbs the evanescent modes (Anechoic termination). In an acoustics-only case the step shows only the ports, the perforated walls, the internal walls and the absorptive backing.

All settings are validated when the step is saved. The boundary conditions written to OpenFOAM's 0/ files are those documented for its boundary-condition types (OpenFOAM user guide, 2026).

Source

The boundary-condition types written to the solver are OpenFOAM's (OpenFOAM user guide, 2026); the wall law for the turbulent viscosity is Spalding's (Spalding, 1961).

Validation results of the program for the absorptive backing:

  • Straight two-body pipe: the packing's pressure drop Δp=R U L\Delta p = R\,U\,L is reproduced within 1.1 % (R=500R = 500 Pa·s/m², 10 m/s, 0.3 m).
  • Packed annulus in the 3-D acoustic solver: within 0.45 dB of a 1-D coupled-line solution with the same equivalent fluid, while absorbing up to 73 % of the incident power.

Valid range

Patch names

Inlets, outlets and perforated walls are numbered (inlet_1, outlet_1, perforate_1); unassigned outer faces are merged into the patch wall.

Saved mesh

Changing a patch's type after meshing (for example a perforated wall set back to open) makes the saved mesh unusable; Start run then asks to mesh again.

Packing cells

The packing takes the mesh cells whose centre lies inside its surface; a packing thinner than a few cells is represented coarsely.

JCA / JCAL

Checked in a full acoustic run (2026-11-11); every quality check passes.

Fields in this step 87

FieldSymbolUnitDefault
Acoustic (poroacoustic) model of the packingMiki
Acoustic impedance model of a perforated wallζp\zeta_pElnady 2010 (new walls); old case files keep the global model they stored
Ambient temperatureTaT_a°Cauto: 20 °C
Anechoic terminationMultimodal (port modes)
Bias (through-hole) Mach numberMbM_bauto: from the CFD in a flow + acoustics run (cross-flow model: net through-flow / (σA), or Q / (σA)); 0 in an acoustics-only run
Bulk densityρb\rho_bkg/m³30 kg/m³ (shown when the bulk-density estimate is selected)
Darcy coefficient DDD1/m²0
Defined by (perforated plate)open-area ratio (a new perforated wall); resistance coefficient K (a case file that stores no mode)
Discharge coefficient C_D (acoustics)CDC_DAuto: bilinear interpolation in the hole-diameter × wall-thickness table
Discharge coefficient C_D0CD0C_{D0}Auto: interpolated in the hole-diameter × wall-thickness table
Emissivityε\varepsilonauto: the wall-material library's value (0.8 for a user-defined material)
End-correction factor (thin plate)ϵ\epsilon× d0.85 (Rayleigh)
Excitation input (amplitude or power)amplitude
Excite this inleton for inlets
Fibre typeglass wool
Flow resistivityRRPa·s/m²20 000 Pa·s/m²
Grazing correctionon
Grazing factor of a slit micro-perforateβ\beta0.08 (derived from Kabral et al. 2014 Fig. 6, not printed in the paper)
Grazing Mach number (acoustics)MgM_gauto: from the CFD (mapped field, else the perforate samples), else the entered flow through the tube, else 0
Grazing Mach number (flow)MM0.1 (shown when nothing is stored)
Grazing velocityCFD, tube core
Hole diameterddmm (stored in m)none stored; the card pre-fills 3 mm
Hole diameter (acoustics)ddmm3.0 mm shown on a new wall (the case file stores none until the card is saved)
Hole edges of a micro-perforateα\alphaAs in Maa 1998 (α = 1/2)
Hole interaction (thin plate)fintf_{int}none
Incident amplitude∣A∣|A|Pa1 Pa
Incident powerWinW_{in}W1 W
Include bias flowMbM_boff
Inertial (Forchheimer) factorff1/m0 (pure Darcy)
Inlet densityρin\rho_{in}kg/m³the density of the Material step
Inlet modeVelocity (uniform_velocity)
Inlet temperatureTinT_{in}Kthe Material temperature (stored as 'follow the material')
Inlet turbulenceFully developed
Inlet velocity / flow rateU, Q, m˙U,\ Q,\ \dot mm/s, m³/s or kg/s (kg/h shown on request)10 m/s (velocity mode)
Inlet velocity vector, x componentUxU_xm/sthe x component of the current inlet velocity along the inward normal
Inlet velocity vector, y componentUyU_ym/sthe y component of the current inlet velocity along the inward normal
Inlet velocity vector, z componentUzU_zm/sthe z component of the current inlet velocity along the inward normal
Insulation conductivitykinsk_{ins}W/(m K)0.06 W/(m K)
Insulation thicknesstinst_{ins}mm (stored in m)0 mm (no insulation)
Jet loss K0 (read-only)K0K_0computed: 1/(σ C_D0)²
K check intervaliterations100
K relaxationαK\alpha_K1.0
Maximum K evaluationsnmaxn_{max}5
Micro-perforate flow resistanceΔp\Delta pPacomputed from the hole size, thickness and open-area ratio
Micro-perforation: hole diameter or slit widthmm0.2 mm
Micro-perforation: holes or slitscircular holes
Mixing lengthℓ\ellmblank = 0.07 D_h of the inlet
Non-linear resistance of a micro-perforate∣u^h∣|\hat u_h|Off (linear impedance)
Open-area ratioσ\sigma0.1
Open-area ratio for acousticsσ\sigmathe wall's open-area ratio when it has one; otherwise as entered
Outer environmentStill air
Outer heat-transfer coefficienthhW/(m² K)10 W/(m² K) in the box (environment 'Manual h' only)
Outlet absolute pressurepabsp_{abs}Paambient pressure + gauge pressure
Outlet gauge pressurepgp_gPa0 Pa (discharge to the ambient)
Outlet: compute a radiation domainoff (the radiation impedance is chosen in Results)
Perforation typeperforated tube (a new perforated wall); perpendicular plate (a case file that does not store the key)
Phase of the incident waveϕ\phi°0°
Plate / wall thicknessttmm (stored in m)1 mm
Plate formulathick plate (a new perforated wall); thin sharp-edged (a case file that stores none)
Porosity (JCA / JCAL)ϕ\phi0.95
Resistance coefficient KKK6.89
Resistivity inputflow resistivity
Roughness constantCsC_s0.5
Shell conductivitykkW/(m K)20 W/(m K) in the box (material 'User defined' only)
Shell thicknessttmm (stored in m)1.5 mm
Single-hole resistance (Sullivan & Crocker)rrrayl2.4 rayl (kg m⁻² s⁻¹)
Slit widthbbmm0.2 mm
Static thermal permeability (JCAL)k0′k'_0m²blank = φ Λ'² / 8 (the JCA value)
Thermal characteristic length (JCA / JCAL)Λ′\Lambda'µm (stored in m)blank = 2 × viscous length
Thermal condition of a wallAdiabatic
Thin plate: use C_DCDC_Doff
Tortuosity (JCA / JCAL)α∞\alpha_\infty1.0
Turbulence intensityIIMedium, 0.05 (used only with 'Intensity and length')
User constant C1C1C_10.122 (Miki's value)
User constant C2C2C_20.618 (Miki's value)
User constant C3C3C_30.18 (Miki's value)
User constant C4C4C_40.618 (Miki's value)
User constant C5C5C_50.079 (Miki's value)
User constant C6C6C_60.632 (Miki's value)
User constant C7C7C_70.12 (Miki's value)
User constant C8C8C_80.632 (Miki's value)
Variable X of the user constantsXXρ₀ f / R (Delany-Bazley, Miki form)
Vehicle speedVVm/s15 m/s in the box (environment 'Vehicle moving' only)
Viscous characteristic length (JCA / JCAL)Λ\Lambdaµm (stored in m)blank = estimated from the flow resistivity
Wall materialStainless steel 304 / 409 (k 20 W/(m K), emissivity 0.5)
Wall roughness heightksk_sm0 m (smooth wall)
Wall temperatureTwT_w°C200 °C (shown when 'Fixed temperature' is chosen)

References 3

  1. Kirby, R. and Cummings, A. (1998). The impedance of perforated plates subjected to grazing gas flow and backed by porous media. Journal of Sound and Vibration, 217(4), 619-636. DOI 10.1006/jsvi.1998.1811
  2. OpenCFD Ltd. (2026). OpenFOAM user guide. openfoam.com. Web page
  3. Spalding, D. B. (1961). A single formula for the law of the wall. Journal of Applied Mechanics, 28(3), 455-458. DOI 10.1115/1.3641728