9.4. Nonlinear Time-History Animation

plotter.animate_nrha(control_nodes, acc, dts, nrha_disps, nrha_accels, drift_thresholds=None, export_path=None, frame_step=5, dpi=100, collapse_time=None, true_peak_drift=None, true_peak_accel=None)

Animate the seismic response for a nonlinear time-history analysis (NRHA).

9.4. Four-panel layout (self.figsize_anim)

Panel 1 - Floor displacement profile [m] vs. elevation. Panel 2 - Storey drift profile [%] vs. elevation (staircase style,

matching plot_demand_profiles).

Panel 3 - Floor acceleration profile [g] vs. elevation. Panel 4 - Input ground motion time-history with elapsed portion highlighted.

If collapse_time is provided, an ‘X’ marker is drawn at that instant to indicate when the MinMax material limit was exceeded.

Line colours update cumulatively based on worst damage state reached so far (blue -> green -> yellow -> orange -> red) when drift_thresholds given.

param control_nodes:

type control_nodes:

array-like of int

param acc:

type acc:

array-like of float [g]

param dts:

type dts:

array-like of float [s]

param nrha_disps:

type nrha_disps:

ndarray (n_steps, n_nodes) [m]

param nrha_accels:

type nrha_accels:

ndarray (n_steps, n_nodes) [m/s^2]

param drift_thresholds:

type drift_thresholds:

list of float or None

param export_path:

type export_path:

str or None

param frame_step:

Render every N-th timestep. Default 5.

type frame_step:

int, optional

param dpi:

Export resolution. Default 100.

type dpi:

int, optional

param collapse_time:

Time [s] at which the MinMax material limit was exceeded (i.e. the last recorded timestep when conv_index turned -1). When provided, a red ‘X’ marker is drawn on the ground-motion panel at that instant.

type collapse_time:

float or None, optional

param true_peak_drift:

True peak IDR per storey [ratio] from the full-resolution time-step loop (peak_drift[:,0] from do_nrha_analysis). When provided the peak drift annotation shows this value instead of the subsampled max.

type true_peak_drift:

ndarray (n_storeys,) or None, optional

param true_peak_accel:

True peak absolute floor acceleration per node [g] from the full- resolution loop (peak_accel[:,0] from do_nrha_analysis). When provided the peak accel annotation shows this value instead of the subsampled max.

type true_peak_accel:

ndarray (n_nodes,) or None, optional

returns:

ani

rtype:

FuncAnimation