Skip to content

Connectors

Module: xfea.model.connectors

ConnectorBase(nodes: list[ForwardRef(Node)] | ForwardRef(NodesGroup), **kwargs)

A connector: a link between two nodes of different parts, registered to a model.

Parameters

Name Type Description
nodes list[Node] | NodesGroup The two nodes connected, each in a different part. On a rigid part, its reference node. For two nodes of the same part, use a SpringElement.
Properties
keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

modelread-only

The model the connector is registered to, or None.

namestr

The object’s name.

nodeslist[ForwardRef(Node)]

The two nodes connected.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

uidUUID | Noneread-only

The object’s unique id, a UUID.

LinearConnector(master, slave, section, dofs: str = 'beam', **kwargs)

A connector between a master and a slave node whose behaviour a connector section sets.

Parameters

Name Type Description
master Node The master node.
slave Node The slave node, in a different part from the master.
section ConnectorSection The connector’s behaviour; its values are used as given, in the active unit system.
dofs str, optional The degrees of freedom linked, e.g. "beam" or "bar". Default "beam".
Properties
dofsstrread-only

The degrees of freedom linked, e.g. "beam".

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

master

The master node.

modelread-only

The model the connector is registered to, or None.

namestr

The object’s name.

nodeslist[ForwardRef(Node)]

The two nodes connected.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

sectionread-only

The connector section that sets the behaviour.

slave

The slave node.

uidUUID | Noneread-only

The object’s unique id, a UUID.

RigidLinkConnector(
    nodes: list[ForwardRef(Node)] | ForwardRef(NodesGroup),
    dofs: str = 'beam',
    **kwargs,
)

A rigid link between two nodes of different parts.

Parameters

Name Type Description
nodes list[Node] | NodesGroup The two nodes connected, each in a different part. For nodes of one part, use model.add_rigid_coupling.
dofs str, optional The degrees of freedom linked: "beam" (translations and rotations), "bar" or a list of integers. Default "beam".
Properties
dofsstrread-only

The degrees of freedom linked, e.g. "beam".

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

modelread-only

The model the connector is registered to, or None.

namestr

The object’s name.

nodeslist[ForwardRef(Node)]

The two nodes connected.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

uidUUID | Noneread-only

The object’s unique id, a UUID.

SpringConnector(
    nodes: list[ForwardRef(Node)] | ForwardRef(NodesGroup),
    section,
    yielding: dict[str, float] | None = None,
    failure: dict[str, float] | None = None,
    **kwargs,
)

A spring between two nodes of different parts, its stiffness from a section.

Parameters

Name Type Description
nodes list[Node] | NodesGroup The two nodes connected, each in a different part.
section SpringSection The spring’s stiffness and behaviour.
yielding dict[str, float], optional Yield thresholds, forces in the active unit system: {"c": compression, "t": tension}.
failure dict[str, float], optional Failure thresholds, forces in the active unit system: {"c": compression, "t": tension}.
Properties
failuredict[str, float] | None

The failure thresholds, {"c": compression, "t": tension}, or None.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

modelread-only

The model the connector is registered to, or None.

namestr

The object’s name.

nodeslist[ForwardRef(Node)]

The two nodes connected.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

sectionread-only

The spring section.

uidUUID | Noneread-only

The object’s unique id, a UUID.

yieldingdict[str, float] | None

The yield thresholds, {"c": compression, "t": tension}, or None.

ZeroLengthConnector(
    nodes: list[ForwardRef(Node)] | ForwardRef(NodesGroup),
    direction,
    **kwargs,
)

A zero-length connector between two coincident nodes of different parts.

Parameters

Name Type Description
nodes list[Node] | NodesGroup The two nodes connected, each in a different part.
direction Any The direction the connector acts in, as the solver plugin reads it.
Properties
directionread-only

The direction the connector acts in, as the solver plugin reads it.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

modelread-only

The model the connector is registered to, or None.

namestr

The object’s name.

nodeslist[ForwardRef(Node)]

The two nodes connected.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

uidUUID | Noneread-only

The object’s unique id, a UUID.

ZeroLengthContactConnector(
    nodes: list[ForwardRef(Node)] | ForwardRef(NodesGroup),
    direction,
    Kn: float,
    Kt: float,
    mu: float,
    **kwargs,
)

A zero-length contact between two coincident nodes of different parts: normal and tangential springs.

Parameters

Name Type Description
nodes list[Node] | NodesGroup The two nodes connected, each in a different part.
direction Any The contact direction, as the solver plugin reads it.
Kn float Normal contact stiffness, force per length (N/mm for N and mm).
Kt float Tangential contact stiffness, force per length like Kn.
mu float Friction coefficient (dimensionless).
Properties
Knfloatread-only

The normal contact stiffness, force per length.

Ktfloatread-only

The tangential contact stiffness, force per length.

directionread-only

The direction the connector acts in, as the solver plugin reads it.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

modelread-only

The model the connector is registered to, or None.

mufloatread-only

The friction coefficient (dimensionless).

namestr

The object’s name.

nodeslist[ForwardRef(Node)]

The two nodes connected.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

uidUUID | Noneread-only

The object’s unique id, a UUID.

ZeroLengthSpringConnector(
    nodes: list[ForwardRef(Node)] | ForwardRef(NodesGroup),
    direction,
    section,
    yielding: dict[str, float] | None = None,
    failure: dict[str, float] | None = None,
    **kwargs,
)

A zero-length spring between two coincident nodes of different parts.

Parameters

Name Type Description
nodes list[Node] | NodesGroup The two nodes connected, each in a different part.
direction Any The direction the spring acts in, as the solver plugin reads it.
section SpringSection The spring’s stiffness and behaviour.
yielding dict[str, float], optional Yield thresholds, forces in the active unit system: {"c": compression, "t": tension}.
failure dict[str, float], optional Failure thresholds, forces in the active unit system: {"c": compression, "t": tension}.
Properties
directionread-only

The direction the connector acts in, as the solver plugin reads it.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

modelread-only

The model the connector is registered to, or None.

namestr

The object’s name.

nodeslist[ForwardRef(Node)]

The two nodes connected.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

uidUUID | Noneread-only

The object’s unique id, a UUID.

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