Nodes
Module: xfea.model.nodes
Node(
xyz: Sequence[float],
mass: float | list[float] | None = None,
temperature: float | None = None,
**kwargs,
)
A point of the model, at global coordinates, that elements join and supports and loads act on.
Parameters
| Name | Type | Description |
|---|---|---|
| xyz | sequence of 3 floats | Point |
The location of the node in the global coordinate system, in the model’s length unit. |
| mass | float | sequence of float, optional | A lumped mass at the node, in the model’s mass unit (t for mm and N), or None for none. A float is used in x, y and z; 3 values are (mx, my, mz); 6 values add the rotary inertias (ixx, iyy, izz). An int is refused: write 10.0. |
| temperature | float, optional | An initial temperature at the node, in the model’s temperature unit, or None for none. |
| name | str, optional | A unique name; generated if not given. Set one for a more readable input file. |
Attributes
| Name | Type | Description |
|---|---|---|
| name | str | The unique name. |
| key | int | None, read-only | The node’s number in the model, set when the model numbers its nodes. |
| part_key | int | None, read-only | The node’s number in its part. |
| xyz | list[float] | The location of the node in the global coordinate system. |
| x, y, z | float | The coordinates. |
| point | Point |
The location as a point. |
| mass | list[float] | The lumped mass, 6 values (mx, my, mz, ixx, iyy, izz), in the model’s mass unit. |
| t0 | float | None | The initial temperature at the node, in the model’s temperature unit. |
| gkey | str, read-only | The geometric key of the node, from its coordinates rounded to settings.PRECISION. |
| on_boundary | bool | None, read-only | True if the node is on the boundary mesh of its part, False if not, None if not worked out. |
| is_reference | bool, read-only | True if the node is the reference point of a RigidPart. |
| part | PartBase | None, read-only |
The part the node belongs to. |
| model | Model | None, read-only |
The model of that part. |
Properties
connected_elementsdict | Noneread-only
The part’s elements grouped by whether they use this node: {True: elements, False: elements}.
None if the part has no elements; raises ValueError if the node is in no part.
gkeystr | Noneread-only
The geometric key of the node: its coordinates rounded to settings.PRECISION, as a string.
is_referenceboolread-only
Whether the node is the reference point of a RigidPart.
keyAny | Noneread-only
The object’s key (its number) in what it is registered to; None until it is given one.
massSequence[float]
The lumped mass, 6 values (mx, my, mz, ixx, iyy, izz), in the model’s mass unit; all 0 for none.
modelModel | Noneread-only
The model of the node’s part, None if it is in no part or the part in no model.
namestr
The object’s name.
on_boundarybool | Noneread-only
Whether the node is on the boundary mesh of its part; None if not worked out.
partPartBase | Noneread-only
The part the node belongs to, None if it is in none.
part_keyint | Noneread-only
The node’s number in its part.
pointPointread-only
The node’s location as a new Point.
registrationAny | None
The object this one is registered to (a part, a model, a step, …), or None.
t0float | None
The initial temperature at the node, in the model’s temperature unit; None for none.
uidUUID | Noneread-only
The object’s unique id, a UUID.
xfloat
The x coordinate, in the model’s length unit.
xyzlist[float]
The coordinates [x, y, z], in the model’s length unit.
yfloat
The y coordinate, in the model’s length unit.
zfloat
The z coordinate, in the model’s length unit.
Methods
displacement(step)
The node’s displacement at the end of a solved step.
Parameters
| Name | Type | Description |
|---|---|---|
| step | StepBase |
The step for which to get the displacement. |
Returns
| Name | Type | Description |
|---|---|---|
class:xfea.results.DisplacementResult |
The displacement result at the node for the given step. |
displacements(problem)→List[DisplacementResult]
The node’s displacement at the end of each step of a solved problem, in step order.
reaction(step)→ReactionResult | None
The reaction at the node at the end of a solved step.
Parameters
| Name | Type | Description |
|---|---|---|
| step | StepBase |
The step for which to get the reaction. |
Returns
| Name | Type | Description |
|---|---|---|
class:xfea.results.ReactionResult |
The reaction result at the node for the given step. |
reactions(problem)→List[ReactionResult]
The reaction at the node at the end of each step of a solved problem, in step order.
temperature(step)
The node’s temperature at the end of a solved step.
Parameters
| Name | Type | Description |
|---|---|---|
| step | StepBase |
The step for which to get the temperature. |
Returns
| Name | Type | Description |
|---|---|---|
class:xfea.results.TemperatureResult |
The temperature result at the node for the given step. |
temperatures(problem)→List[TemperatureResult]
The node’s temperature at the end of each step of a solved problem, in step order.
transform(transformation)
Move the node in place by a transformation.
Parameters
| Name | Type | Description |
|---|---|---|
| transformation | Transformation | list |
The transformation, or its 4x4 matrix. |
transformed(transformation)
A copy of the node moved by a transformation; this node is left in place.
Parameters
| Name | Type | Description |
|---|---|---|
| transformation | Transformation | list |
The transformation, or its 4x4 matrix. |
Returns
| Name | Type | Description |
|---|---|---|
class:xfea.model.Node |
A new node object with the transformed coordinates. |
© 2026 Francesco Ranaudo · Text and pictures CC BY 4.0 · Code Elastic License 2.0 · how to reuse them