plot_nodal_responses

opstool.post.plot_nodal_responses(odb_tag, resp_type, resp_dof=None, node_tags=None, ax=None)[source]

Read nodal responses data from a file.

Added in opstool v1.0.25.

Important

You can use opstool.post.get_nodal_responses_info() to get valid response types and DOFs.

Parameters

odb_tag: int | str

Tag of output databases (ODB) to be read.

resp_type: Literal[“disp”, “vel”, “accel”, “reaction”, “reactionIncInertia”, “rayleighForces”, “pressure”]

Type of response to be read. Optional:

  • “disp” - Displacement at the node.

  • “vel” - Velocity at the node.

  • “accel” - Acceleration at the node.

  • “reaction” - Reaction forces at the node.

  • “reactionIncInertia” - Reaction forces including inertial effects.

  • “rayleighForces” - Forces resulting from Rayleigh damping.

  • “pressure” - Pressure applied to the node.

Note

If the nodes include fluid pressure dof, such as those used for **UP elements, the pore pressure should be extracted using resp_type="vel", and the value is placed in the degree of freedom RZ.

resp_dofLiteral[“UX”, “UY”, “UZ”, “RX”, “RY”, “RZ”]

Degree of freedom of response to be read. Optional:

  • “UX”, “UY”, “UZ” - Displacement/Velocity/Acceleration in X, Y, Z directions.

  • “RX”, “RY”, “RZ” - Rotational displacement/Velocity/Acceleration about X, Y, Z axes.

If None, no selection on DOF is applied. If resp_type is “pressure”, this parameter is ignored.

node_tags: list[int] | tuple[int, …] | int | None = None

Node tags to be read. Such as [1, 2, 3] or numpy.array([1, 2, 3]) or 1. If None, return all nodal responses.

Note

If some nodes are deleted during the analysis, their response data will be filled with numpy.nan.

ax: plt.Axes | None

Matplotlib Axes object to plot on. If None, a new figure and axes will be created.

Returns

plt.Axes

Matplotlib Axes object containing the plot.

rtype:

Axes

Return type:

Axes