NodeRecorder

NodeRecorder

NodeRecorder(**kwargs)

Bases: Recorder

Node recorder for recording nodal responses at every converged step.

NodeRecorder monitors nodal degrees of freedom throughout the analysis, exporting results such as displacements, velocities, accelerations, or reaction forces to files, XML, binary, or TCP streams.

Tcl form

recorder Node -file <fileName> -node <nodeTags...> -dof <dofs...> <respType>

Example

from femora.core.model import Model

model = Model()
# Record displacement at DOFs 1 and 2 for nodes 101 and 102
recorder = model.recorder.node(
    file_name="displacement.out",
    nodes=[101, 102],
    dofs=[1, 2],
    resp_type="disp",
)

Create a node recorder.

Parameters:

Name	Type	Description	Default
**kwargs		Key-value parameters: file_name: Optional file path for plain text output. xml_file: Optional file path for XML output. binary_file: Optional file path for binary output. inet_addr / port: Optional IP and port for TCP output. precision: Number of significant digits (default: 6). time_series: Optional TimeSeries tag. time: If True, includes time in the first column. delta_t: Optional time step recording interval. close_on_write: If True, opens/closes the output file on each write. nodes: Optional list of node tags. node_range: Optional start and end tag [start, end]. region: Optional target region tag or name. dofs: List of active degrees of freedom (required). resp_type: Response type, e.g. 'disp', 'vel', 'accel', 'reaction' (required).	{}

Raises:

Type	Description
ValueError	If output destination, node selection, DOFs, or response type validation fails.