3.1.12.2. Uniform Excitation

The UniformExcitation pattern allows the user to apply a uniform excitation to a model acting in a certain direction. The command is as follows:

pattern UniformExcitation $patternTag $dof -accel $tsTag <-vel0 $vel0> <-fact $cFact>

Argument	Type	Description
$patternTag	integer	unique tag among load patterns
$dof	integer	dof direction the ground motion acts
$tsTag	integer	tag of the TimeSeries series defining the acceleration history.
$vel0	float	the initial velocity (optional: default=0.0)
$cFact	float	constant factor (optional: default=1.0)

Warning

The responses obtained from the nodes for this type of excitation are RELATIVE values, and not the absolute values obtained from a multiSupportPattern. This is a consequence of the equation of motion being solved:

\[M\ddot{U} + C\dot{U} + K U = P(t)\]

and how the loads are applied with this load pattern.

\[P(t) = -c_{Fact} M l \ddot{u_g}\]

where $l$’ is a vector of 1’s and 0’s, with a 1 corresponding to all matrix equations in the $dof degree-of-freedom direction and 0 for all other degrees-of-freedom. The $\ddot u_g$ is obtained from the time series.

Example:

The following example shows how to construct a UniformExcitation pattern with a tag of 2 acting in the 1 direction. The acceleration for the pattern comes from the Path TimeSeries with tag 3 which has been created using the contents of the elCentro.dat file, a $\delta t = 0.02$, and a scale factor given by the variable g, which has been set to 386.1.

Tcl Code

set g 386.1
timeSeries Path 3 -filePath elCentro.dat -dt 0.02 -factor $g
pattern UniformExcitation  2 1 -accel 3

Python Code

g = 386.1
timeSeries('Path', 3, '-dt', 0.005, '-filePath', 'A10000.dat', '-factor', g)
pattern('UniformExcitation', 2, 1, '-accel', 3)

Code Developed by: fmk