get_element_responses

opstool.post.get_element_responses(odb_tag, ele_type, resp_type=None, ele_tags=None, lazy_load=False, print_info=True)[source]

Read nodal responses data from a file.

Important

You can use opstool.post.get_element_responses_info() to get valid response types and DOFs for each element type.

Parameters

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

Tag of output databases (ODB) to be read.

ele_type: str, default: Frame

Type of element to be read. Optional: “Frame”, “FiberSection”, “Truss”, “Link”, “Shell”, “Plane”, “Solid”, “Contact

resp_type: str, default: disp

The response type, which depends on the parameter ele_type. If None, return all responses to that ele_type.

  1. For Frame:

    • “localForces”: Local forces in the element local coordinate system.

    • “basicForces”: Basic forces in the element basic coordinate system.

    • “basicDeformations”: Basic deformations in the element basic coordinate system.

    • “plasticDeformation”: Plastic deformations in the element basic coordinate system.

    • “sectionForces”: Section forces in the element coordinate system.

    • “sectionDeformations”: Section deformations in the element coordinate system.

    • “sectionLocs”: Section locations, 0.0 to 1.0.

  2. For FiberSection:

    • “Stresses”: Stress.

    • “Strains”: Strain.

    • “ys”: y coords.

    • “zs”: z coords.

    • “areas”: Fiber point areas.

    • “matTags”: Mat tags in OpenSees.

    • “secDefo”: Section deformations.

    • “secForce”: Section forces.

  3. For Truss:

    • “axialForce”: Axial force.

    • “axialDefo”: Axial deformation.

    • “Stress”: Stress of material.

    • “Strain”: Strain of material.

  4. For Link:

    • “basicDeformation”: Basic deformation, i.e., pure deformation.

    • “basicForce”: Basic force.

  5. For Shell:

    • “sectionForces”: Sectional forces at Gauss points (per unit length).

    • “sectionDeformations”: Sectional deformation at Gauss points (per unit length).

    • “Stresses”: The stresses of each fiber layer at each Gauss point.

    • “Strains”: The strains of each fiber layer at each Gauss point.

  6. For Plane:

    • “stresses”: Stresses at Gauss points.

    • “strains”: Strains at Gauss points.

  7. For Brick or ‘Solid’:

    • “stresses”: Stresses at Gauss points.

    • “strains”: Strains at Gauss points.

  8. For Contact:

    • “localForces”: Local forces in the element local coordinate system (normal and tangential).

    • “localDisp”: Local displacements in the element local coordinate system (normal and tangential).

    • “slips”: Slips in the element local coordinate system (tangential).

ele_tags: Union[list, tuple, int], default: None

Element 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 elements 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

EleResp: xarray.Dataset

Element 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