ImposedMotion

ImposedMotion(node_tag: int, dof: int, ground_motion: GroundMotion)

OpenSees imposedMotion entry used inside MultipleSupport excitation patterns.

This class represents one support boundary constraint that applies a prescribed ground motion to a specific node degree-of-freedom within a MultipleSupportPattern.

Tcl form

imposedMotion <nodeTag> <dof> <groundMotionTag>

Note

Create this entry through MultipleSupportPattern.add_imposed_motion(...) rather than by direct construction in normal workflows.

Example

from femora.core.model import Model

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

Create an imposed support motion constraint.

Parameters:

Name	Type	Description	Default
`node_tag`	`int`	Tag of the node where the motion is prescribed.	required
`dof`	`int`	1-based degree-of-freedom direction (e.g., 1 for X, 2 for Y, 3 for Z).	required
`ground_motion`	`GroundMotion`	Managed ground motion that defines the boundary excitation history.	required

Raises:

Type	Description
`ValueError`	If node_tag or dof are not positive integers, or if ground_motion is unmanaged.