PlainGroundMotion

PlainGroundMotion(accel: Optional[TimeSeries] = None, vel: Optional[TimeSeries] = None, disp: Optional[TimeSeries] = None, integrator: Optional[str] = None, integrator_args: Optional[List[Union[int, float, str]]] = None, factor: float = 1.0)

Bases: GroundMotion

Plain ground motion built from managed time series histories.

A plain ground motion references one or more managed TimeSeries objects for acceleration, velocity, and displacement. OpenSees uses the supplied histories to prescribe support motion through imposedMotion entries in multiple-support patterns.

Tcl form

groundMotion <tag> Plain <-accel tsTag> <-vel tsTag> <-disp tsTag> <-int integratorType ...> <-fact cFactor>

Note

At least one of accel, vel, or disp must be provided.
Time series must be created through model.time_series.* before being passed to model.ground_motion.plain(...).

Attributes:

Name	Type	Description
`accel`		Optional acceleration time series.
`vel`		Optional velocity time series.
`disp`		Optional displacement time series.
`integrator`		Optional OpenSees integration method for derived histories.
`integrator_args`		Optional arguments appended after `integrator`.
`factor`		Constant scale factor for the ground motion.

Example

from femora.core.model import Model

model = Model()
accel = model.time_series.path(dt=0.01, filePath="support.acc")
disp = model.time_series.path(dt=0.01, filePath="support.disp")
gm = model.ground_motion.plain(accel=accel, disp=disp)
pattern = model.pattern.multiple_support()
pattern.add_imposed_motion(node_tag=1, dof=1, ground_motion=gm)
print(gm.tag)

Create a plain ground motion.

Parameters:

Name	Type	Description	Default
`accel`	`Optional[TimeSeries]`	Acceleration time series. Optional if `vel` or `disp` is provided.	`None`
`vel`	`Optional[TimeSeries]`	Velocity time series. Optional if `accel` or `disp` is provided.	`None`
`disp`	`Optional[TimeSeries]`	Displacement time series. Optional if `accel` or `vel` is provided.	`None`
`integrator`	`Optional[str]`	Optional OpenSees integration method, such as `"Trapezoidal"` or `"Simpson"`.	`None`
`integrator_args`	`Optional[List[Union[int, float, str]]]`	Optional arguments appended after `integrator` in the `-int` option.	`None`
`factor`	`float`	Constant scale factor for the ground motion.	`1.0`

Raises:

Type	Description
`ValueError`	If no time series is provided, a supplied time series is not a `TimeSeries` object, `integrator_args` is not a sequence, or `factor` is not numeric.