Skip to content

Supports, releases and joints

A model has to be held, and its parts have to be joined. xfea keeps the two apart: a support holds nodes against the ground; a joint connects parts to each other. Parts never share nodes; where they meet, an interface, a coupling, a spring or a connector says how.

model.add_fix_bc(nodes=base) # all six held
model.add_pin_bc(nodes=ends) # translations held, rotations free
model.add_rollerXZ_bc(nodes=sym) # held in y only: a plane of symmetry for solids
model.add_bcs(MechanicalBCField(nodes, GeneralBC(y=True, xx=True, zz=True))) # any set of directions

Every support can be given a frame, to hold along local axes instead of global ones. Beams and shells on a plane of symmetry need the rotations in that plane held too, which GeneralBC does.

Elastic supports put nodes on springs to the ground: model.add_spring_supports(nodes, stiffness, direction). With only="compression" a spring bears and lifts off, like a footing on soil.

A frame’s joints are rigid unless a beam end is released:

part.add_beams_releases_fields(elements=braces, end="both", release=BeamEndPinRelease(m1=True))
part.add_beams_releases_fields(elements=[beam], end="start",
release=BeamEndSemiRigidRelease(m1_stiffness=5e9)) # N mm/rad

A pin releases a rotation; a semi-rigid release puts a rotational spring there, for joints that are neither pinned nor rigid. At a joint, release all the members but one: if every end there is released, nothing holds the node’s rotation.

Joint What it does For
Tie (TieConstraint) One surface’s nodes follow the other’s welds, glued or cast-in parts, meshes that don’t match
Contact (HardContactNoFriction, HardContactFrictionPenalty) Surfaces push on each other when pressed, part when pulled, slide or stick bearing plates, stacked blocks, anything that can lift off
Rigid coupling (model.add_rigid_coupling) A group of nodes moves as one rigid body with a reference node a beam end on a plate, a load or moment at a point
Springs between nodes (model.add_spring_links) A spring of given stiffness between pairs of nodes bolts, bearings, elastic connections

Ties and contact are found by geometry: model.detect_interfaces finds where parts touch and makes an interface for each pair.

model.detect_interfaces(
behavior=HardContactFrictionPenalty(mu=0.3, tol=1),
method="face_intersection", # meshes that don't match at the faces
part_pairs=[(column, plate)], # (master, slave): the support side first
)

Three cubes stacked with frictional contact between them, coloured by stress: self-weight builds up towards the base

Three cubes stacked with frictional contact: the stress grows towards the base as the weight above builds up.

Bolts are often springs: one-sided (only="tension") links from the plate to the flange, spread over the nodes under the washer. Contact and one-sided springs make a step nonlinear: the solver iterates to find what is in contact and which springs act.

The model picture shows the supports as black markers and the loads as red arrows (in the 3D viewer, supports red and loads blue), and lists every interface with its parts: render_model, or the viewer. model.check() flags joints a solver would get wrong without saying so, such as a support on a tie’s slave face. See Checking a model.

The API reference has supports, interfaces and constraints.

© 2026 Francesco Ranaudo · Text and pictures CC BY 4.0 · Code Elastic License 2.0 · how to reuse them