plot_unstruct_responses_animation

opstool.vis.plotly.plot_unstruct_responses_animation(odb_tag=1, ele_tags=None, framerate=None, ele_type='Shell', resp_type=None, resp_dof=None, unit_symbol=None, unit_factor=None, style='surface', show_outline=False, show_values=False, show_defo=True, defo_scale=1.0, show_bc=True, bc_scale=1.0, show_mp_constraint=False, show_model=True)[source]

Unstructured element (Shell, Plane, Brick) response animation.

Note

The responses at all Gaussian points are averaged.

Parameters

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

Tag of output databases (ODB) to be visualized.

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

The tags of truss elements to be visualized. If None, all truss elements are selected.

ele_type: str, default: “Shell”

Element type, optional, one of [“Shell”, “Plane”, “Solid”].

framerate: int, default: None

Framerate for the display, i.e., the number of frames per second.

resp_type: str, default: None

Response type, which dependents on the element type ele_type.

  1. For Shell elements, one of [“sectionForces”, “sectionDeformations”].

    I.e., section forces and deformations at Gaussian integration points (per unit length). If None, defaults to “sectionForces”.

  2. For Plane elements, one of [“stresses”, “strains”].

    I.e., stresses and strains at Gaussian integration points. If None, defaults to “stresses”.

  3. For Brick or Solid elements, one of [“stresses”, “strains”].

    I.e., stresses and strains at Gaussian integration points. If None, defaults to “stresses”.

resp_dof: str, default: None

Dof to be visualized, which dependents on the element type ele_type.

Note

The resp_dof here is consistent with stress-strain (force-deformation), and whether it is stress or strain depends on the parameter resp_type.

  1. For Shell elements, one of [“FXX”, “FYY”, “FXY”, “MXX”, “MYY”, “MXY”, “VXZ”, “VYZ”].

    If None, defaults to “MXX”.

  2. For Plane elements, one of [“sigma11”, “sigma22”, “sigma12”, “p1”, “p2”, “sigma_vm”, “tau_max”].

    • “sigma11, sigma22, sigma12”: Normal stress and shear stress (strain) in the x-y plane.

    • “p1, p2”: Principal stresses (strains).

    • “sigma_vm”: Von Mises stress.

    • “tau_max”: Maximum shear stress (strains).

    • If None, defaults to “sigma_vm”.

  3. For Brick or Solid elements, one of [“sigma11”, “sigma22”, “sigma33”, “sigma12”, “sigma23”, “sigma13”, “p1”, “p2”, “p3”, “sigma_vm”, “tau_max”, “sigma_oct”, “tau_oct”]

    • “sigma11, sigma22, sigma33”: Normal stress (strain) along x, y, z.

    • “sigma12, sigma23, sigma13”: Shear stress (strain).

    • “p1, p2, p3”: Principal stresses (strains).

    • “sigma_vm”: Von Mises stress.

    • “tau_max”: Maximum shear stress (strains).

    • “sigma_oct”: Octahedral normal stress (strains).

    • “tau_oct”: Octahedral shear stress (strains).

    • If None, defaults to “sigma_vm”.

unit_symbol: str, default: None

Unit symbol to be displayed in the plot. This feature is added since v1.0.15.

unit_factor: float, default: None

This feature is added since v1.0.15. The multiplier used to convert units. For example, if you want to visualize stress and the current data unit is kPa, you can set unit_symbol="kPa" and unit_factor=1.0. If you want to visualize in MPa, you can set unit_symbol="MPa" and unit_factor=0.001.

style: str, default: surface

Visualization mesh style of surfaces and solids. One of the following: style=’surface’ or style=’wireframe’ Defaults to ‘surface’. Note that ‘wireframe’ only shows a wireframe of the outer geometry.

show_values: bool, default: False

Whether to display the response value by hover. Set to False can improve the performance of the visualization.

show_outline: bool, default: False

Whether to display the outline of the model.

show_defo: bool, default: False

Whether to display the deformed shape.

defo_scale: float, default: 1.0

Scales the size of the deformation presentation when show_defo is True.

show_bc: bool, default: False

Whether to display boundary supports. Set to False can improve the performance of the visualization.

bc_scale: float, default: 1.0

Scale the size of boundary support display.

show_mp_constraint: bool, default: False

Whether to show multipoint (MP) constraint. Set to False can improve the performance of the visualization.

show_model: bool, default: False

Whether to plot the all model or not. Set to False can improve the performance of the visualization.

Returns

fig: plotly.graph_objects.Figure

You can use fig.show() to display, You can also use fig.write_html(“path/to/file.html”) to save as an HTML file, see Interactive HTML Export in Python

rtype:

Figure

Return type:

Figure