Skip to content

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