get_element_responses

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

Read nodal responses data from a file.

Return type:

Dataset

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.

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.