v2026.11.16174
Reference / Input deck / model / boundary conditions / wall / fsi

fsi

Fluid-structure interaction model that couples this wall's motion to a structural solve.

support radius
float·default 1·> 0

RBF support radius, also the mode-shape deformation scale used when normalising mode shapes for morphing

Used inshockplatefsi
Guidance: Fluid–structure interaction →
fixed zones
list of int·not set by default

Zones held in place while the moving zones deform.

Used inshockplatefsi
basismodal_model, rbf_multiscale / generic_fsi only
default c2

RBF function type

Options
ValueWhat it doesWhen to use it
tps

A thin-plate spline in the distance scaled by support_radius; it is never zero, so the system is dense.

Small surfaces where a global, smooth deformation is wanted.

thin_plate_spline
rbf_multiscale only

Not implemented under this name; the run stops with an unknown-basis error.

Never; the thin-plate spline is tps.

multiquadric
rbf_multiscale only

Not implemented; the run stops with an unknown-basis error.

Never; use c2.

inverse_multiquadric
rbf_multiscale only

Not implemented; the run stops with an unknown-basis error.

Never; use c2.

gaussian

A Gaussian whose width is support_radius; it is never zero, so every pair of points interacts and the system is dense.

Small surfaces only, as the dense system grows with the square of the number of points.

linear
rbf_multiscale only

Not implemented; the run stops with an unknown-basis error.

Never; use c2.

cubic
rbf_multiscale only

Not implemented; the run stops with an unknown-basis error.

Never; use c2.

quintic
rbf_multiscale only

Not implemented; the run stops with an unknown-basis error.

Never; use c2.

c0

A Wendland C0 function that is zero beyond support_radius; the deformation is continuous but its slope is not.

Rarely; c2 gives a smoother deformation with the same sparsity.

c2 default

A Wendland C2 function that is zero beyond support_radius, so only nearby points interact and the system is sparse.

The default, and the appropriate choice for most cases.

c4

Selects a Wendland C4 function, but the matrix assembly and the volume deformation evaluate c2, so the interpolation is inconsistent.

Not at present; use c2.

c6
rbf_multiscale only

Not implemented; the run stops with an unknown-basis error.

Never; use c2.

Guidance: Fluid–structure interaction →
base point fractionrequiredmodal_model, rbf_multiscale / generic_fsi only
float·required

Fraction of points to use as base points

Used inshockplatefsi
Guidance: Fluid–structure interaction →
file formatrequiredmodal_model only
required

Structural file format

Options
ValueWhat it doesWhen to use it
nastran

Reads the structural grid from <nastran_casename>.bdf and the mode shapes and frequencies from <nastran_casename>.op2.

Always; it is the only format supported.

Used inshockplatefsi
Guidance: Fluid–structure interaction →
nastran casenamerequiredmodal_model only
str·required

Nastran case name (without extension)

Used inshockplatefsi
scalemodal_model only
list of float·not set by default

Scaling factors [x, y, z]

Used inshockplatefsi
mode mapping max distancerequiredmodal_model only
float·required

Max distance for mode mapping

Used inshockplatefsi
mode mapping poweradvancedmodal_model only
float·default 1·> 0

Inverse-distance power for mapping mode shapes to the surface

mode mapping pure idwadvancedmodal_model only
bool·default True

Use pure inverse-distance weighting for the mode mapping

mode mapping n nearestadvancedmodal_model only
int·default 4·>= 1

Number of nearest structural points used per surface point

recalculate rbfs alpha fractionadvancedmodal_model only
float·default 0·>= 0.0

Deformation fraction of the RBF support radius at which the base-point set is rebuilt; 0 never rebuilds it

newmark alphaadvancedmodal_model only
float·default 0.25

Newmark integrator alpha parameter

newmark deltaadvancedmodal_model only
float·default 0.5

Newmark integrator delta parameter

update frequencyadvancedmodal_model only
int·default 1·>= 1

Cycles between structural updates: the modes are marched and the mesh deformed once every this many solver cycles. With several modal models the smallest value applies to all of them.

fluid force scalingrequiredmodal_model only
float·required

Scaling factor for fluid forces

Used inshockplatefsi
mode listrequiredmodal_model only
list of int·required

List of modes to include

Used inshockplatefsi
type
not set by default·'type' only applies when zones is not []

The structural coupling: modal_model uses the built-in Nastran modal model, generic_fsi couples to an external structural solver.

Options
ValueWhat it does
modal_model

Selects the built-in Nastran modal-model coupling.

generic_fsi

Selects the generic external-solver coupling.

Used inshockplatefsi
Guidance: Fluid–structure interaction →
transform type
not set by default

Mesh deformation transform used for the coupling

Options
ValueWhat it doesWhen to use it
rbf_multiscale

Deforms the volume mesh using the multiscale RBF scheme.

idw

Deforms the volume mesh using inverse distance weighting.

rbf

Deforms the volume mesh with a single-level RBF, adding surface points one at a time, worst-interpolated first, until each is within tol.

Where an error-controlled choice of points is preferred to the fixed base_point_fraction of rbf_multiscale.

Used inshockplatefsi
Guidance: Fluid–structure interaction →
powerrequiredmodal_model, idw / generic_fsi only
float or list of float·required

Power parameters for IDW

Used inshockplatefsi
Guidance: Fluid–structure interaction →
stencil sizeidw only
int·not set by default·>= 1

Maximum stencil size (number of nearest neighbors)

n nearestmodal_model, idw / generic_fsi only
int·default 100·>= 1

Number of nearest points for IDW

Used inshockplatefsi
deformation distancemodal_model, idw / generic_fsi only
float·default 1·> 0

Maximum deformation distance

Used inshockplatefsi
blending stiffnessmodal_model, idw / generic_fsi only
float·default 0.5·0 to 1

Blending stiffness parameter

Used inshockplatefsi
zonerequiredgeneric_fsi only
list of zone ids·required

Zone IDs coupled to the external solver

tolgeneric_fsi only
float·default 0.01

RBF solve tolerance

max errorgeneric_fsi only
float·default 0.1

Maximum allowed RBF interpolation error

user variablesgeneric_fsi only
settings block·not set by default

Arbitrary variables passed to the external coupling solver (genuinely open-ended — not enumerable).