9.1. Modal Shapes

plotter.plot_modes(node_list, mode_shape_vectors, T, export_path=None)

Plots 2-D mode shape profiles in a square grid layout (2x2, 3x3 etc).

Each mode occupies one cell with two side-by-side profile plots: left = X-displacement vs Z (blue), right = Y-displacement vs Z (green). Normalised displacement values are annotated next to every node dot. A grey undeformed reference line (x=0) is drawn in every panel.

9.1. Sign convention

Eigenvectors have arbitrary sign. The method flips each mode so that the top-node displacement in the dominant horizontal direction is always positive.

9.1. Grid

ncols = ceil(sqrt(N)), nrows = ceil(N / ncols). Unused cells in the last row are hidden.

param node_list:

Ordered OpenSees node tags (base node first).

type node_list:

list of int

param mode_shape_vectors:

One array per mode; columns are [ux, uy, uz], pre-normalised by max abs value as returned by do_modal_analysis.

type mode_shape_vectors:

list of numpy.ndarray, shape (n_nodes, 3)

param T:

Natural periods [s] for each mode.

type T:

list of float

param export_path:

File path to save the figure. If None the figure is displayed.

type export_path:

str, optional

rtype:

None