get_nodal_responses

opstool.post.get_nodal_responses(odb_tag, resp_type=None, node_tags=None, lazy_load=False, print_info=True)[source]

Read nodal responses data from a file.

Important

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

Parameters

odb_tag: Union[int, str], default: one

Tag of output databases (ODB) to be read.

resp_type: str, default: None

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.

  • If None, return all responses.

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.

node_tags: Union[list, tuple, int], default: 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.

lazy_load: bool, default: False, added since version 1.0.25.

Whether to lazy load the data. If True, the data will be loaded on demand, which can save memory for large datasets. If False, the data will be fully loaded into memory. If you have enough memory, it is recommended to set this parameter to False for faster and safer data access.

print_info: bool, default: True

Whether to print information

Returns

NodalResp: xarray.Dataset

Nodal responses’ data.

Note

The returned data can be viewed using “.data_vars,” .dims, .coords, and .attrs to view the dimension names and coordinates. You can further index or process the data.

rtype:

Dataset

Return type:

Dataset