Connectors
Module: xfea.model.connectors
ConnectorBase
Section titled “ConnectorBase”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
Section titled “LinearConnector”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
Section titled “RigidLinkConnector”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
Section titled “SpringConnector”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
Section titled “ZeroLengthConnector”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
Section titled “ZeroLengthContactConnector”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
Section titled “ZeroLengthSpringConnector”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