gwexpy.interop.opensees_

Interoperate with OpenSeesPy recorder output.

Interoperability with OpenSeesPy recorder output.

OpenSeesPy writes node/element recorder data to text files with columns [time, n1_d1, n1_d2, ..., n2_d1, ...]. This module reads such files into TimeSeriesMatrix or TimeSeriesDict.

References

https://opensees.berkeley.edu/ https://openseespydoc.readthedocs.io/

Functions

from_opensees_recorder(cls, filepath, *, ...)

Read an OpenSeesPy recorder text file into a TimeSeriesMatrix.
gwexpy.interop.opensees_.from_opensees_recorder(cls: type, filepath: str | Path, *, nodes: list[int], dofs: list[int], response_type: str = 'disp', dt: float | None = None, has_time_column: bool = True) → Any[source]

Read an OpenSeesPy recorder text file into a TimeSeriesMatrix.

Parameters:

  • cls (type) – TimeSeriesMatrix or TimeSeriesDict.

  • filepath (str or Path) – Path to the recorder output file (space-delimited text).

  • nodes (list[int]) – Node numbers recorded (in order).

  • dofs (list[int]) – DOF numbers recorded per node (1-based, e.g. [1, 2, 3] for X, Y, Z).

  • response_type (str) – Response quantity for unit inference ("disp", "vel", "accel", "force").

  • dt (float, optional) – Time step. Required if has_time_column is False.

  • has_time_column (bool) – Whether the first column is a time vector (default True).

Return type:

TimeSeriesMatrix or TimeSeriesDict