plot_srf#

plot_srf(result_obj, component='Mx', loadcase=None, backend='plotly', **kwargs)#

Plot a contour field over the shell mesh.

Visualises shell element data as an interpolated contour over the deck slab mesh of a shell_beam model. Three families of component are supported:

  • Shell forces — Vx, Vy, Vz, Mx, My, Mz. Element end forces averaged at shared nodes.

  • Displacements — Dx, Dy, Dz. Nodal translations read directly from the displacements array.

  • Stress resultants — N11, N22, N12, M11, M22, M12, Q13, Q23. Section stress resultants averaged across the 4 Gauss points per element, then averaged at shared nodes.

The returned Plotly figure can be composed with beam force diagrams by passing it as ax= to plot_bmd() etc.:

fig = og.plot_srf(results, "Mx", backend="plotly", show=False)
og.plot_bmd(proxy, results, backend="plotly", ax=fig)

Parameters#

result_objxarray.Dataset

Results dataset. Must contain ele_nodes_shell and node_coordinates. Depending on component, also requires forces_shell (shell forces), displacements (displacement components), or stresses_shell (stress resultants).

componentstr, default "Mx"

Component to plot. One of:

  • Shell forces: "Vx", "Vy", "Vz", "Mx", "My", "Mz"

  • Displacements: "Dx", "Dy", "Dz"

  • Stress resultants: "N11", "N22", "N12", "M11", "M22", "M12", "Q13", "Q23"

loadcasestr or None, default None

Load case name to plot. None uses the first load case.

backendstr, default "plotly"

"plotly" for interactive 3-D or "matplotlib" for 2-D.

colorscalestr, default "RdBu_r"

Plotly colorscale name (or matplotlib cmap name). Use a diverging scale (e.g. "RdBu_r") for signed data and a sequential scale (e.g. "Viridis") for displacements.

showbool

Display the plot immediately. Default True for plotly, False for matplotlib.

kwargsdict, optional

Forwarded to the backend renderer. Accepted keys include figsize, title, opacity, show_colorbar, averaging, and ax / fig for composing onto an existing figure.

Returns#

plotly.graph_objects.Figure or matplotlib.axes.Axes

The figure object, or None when show is True (plotly backend only).

Raises#

ValueError

If the dataset does not contain the required data variables for the requested component.