TR.31.4 Definition of Time History Load
This set of commands may be used to define parameters for time history loading on the structure. The time history data may be specified using either explicit definition, function specification, a spectrum specification, or time history data provided in an external file.
General Format
DEFINE TIME HISTORY (DT x) ( MISSING MASS )
TYPE i { ACCELERATION | FORCE | MOMENT } (SCALE f7) (SAVE)
{ t1 p1 t2 p2 … tn pn | function-spec | spectrum-spec | READ filename (f8) }
Repeat
TYPE
and Amplitude vs Time sets until all are entered,
then:
ARRIVAL TIME
a1 a2 a3 … an
{ DAMPING d | CDAMP | MDAMP }
Entering
the
MISSING MASS
parameter will include the missing mass
procedure in the time history analysis.
The time history data can be explicitly defined using pairs of time and values of acceleration, force, or moment, where:
-
ACCELERATION
indicates that the time varying load type is a ground motion. -
FORCE
indicates that it is a forcing function. -
MOMENT
indicates that it is a moment forcing function.
Variable or Command | Default Value | Description |
---|---|---|
DT x | - | Solution time step used in the
step-by-step integration of the uncoupled equations. Values smaller than
0.00001 will be reset to the default
DT value of 0.0013888 seconds.
|
TYPE i | - | Type number of time varying load (integer). Up to 136 types may be provided. This number should be sequential. |
SCALE f7 | 1.0 | The scale factor option multiplies all forces, accelerations, and amplitudes entered, read or generated within this Type. Primarily used to convert acceleration in g’s to current units (9.80665, 386.08858, etc.). |
SAVE | - |
The save option results in the creation of two files (input file name with .TIM and .FRC file extensions). The .TIM file contains the history of the displacements of every node. The .FRC file contains the history of the 12 end forces of every member of the structure at every time step, and the 6 reactions at each support at every step. Syntax:
|
t1 p1 t2 p2 | - |
Values of time (in sec.) and corresponding force (current force unit) or acceleration (current length unit/sec2) depending on whether the time varying load is a forcing function or a ground motion. If the first point is not at zero time, then the
forces before the first time (but after the arrival time) will be determined by
extrapolation using the first two points entered. If the first point has a
nonzero force, there will be a sudden application of that force over a single
integration step ( |
a1 a2 a3 ... an | - |
Values of the various possible arrival times (seconds) of the various dynamic load types. Arrival time is the time at which a load type begins to act at a joint (forcing function) or at the base of the structure (ground motion). The same load type may have different arrival times for different joints and hence all those values must be specified here. The arrival times and the times from the time-force pairs will be added to get the times for a particular set of joints in the TIME LOAD data (see TR.32.10.2 Time Varying Load for Response HistoryAnalysis). The arrival times and the time-force pairs for the load types are used to create the load vector needed for each time step of the analysis. Refer to TR.32.10.2 Time Varying Load for Response HistoryAnalysis for information on input specification for application of the forcing function and/or ground motion loads. Up to 999 arrival time values may be specified. |
DAMPING d | 0.05 |
The damping ratio.
Specify a value of exactly 0.0000011 to ignore damping.
|
The function-spec option can be used to specify harmonic loads. Both sine and cosine harmonic functions may be specified. The program will automatically calculate the harmonic load time history based on the following specifications.
For the function and amplitude option (:
function-spec =
{ SINE | COSINE }
AMPLITUDE f0 { FREQUENCY | RPM } f2 (PHASE f3) CYCLES f4 { SUBDIV f5 | STEP f6 }
DT
) at that time. Where:
Variable or Command | Default Value | Description |
---|---|---|
DT x | - | Solution time step used in the
step-by-step integration of the uncoupled equations. Values smaller than
0.00001 will be reset to the default
DT value of 0.0013888 seconds.
|
TYPE i | - | Type number of time varying load (integer). Up to 136 types may be provided. This number should be sequential. |
SCALE f7 | 1.0 | The scale factor option multiplies all forces, accelerations, and amplitudes entered, read or generated within this Type. Primarily used to convert acceleration in g’s to current units (9.80665, 386.08858, etc.). |
SAVE | - |
The save option results in the creation of two files (input file name with .TIM and .FRC file extensions). The .TIM file contains the history of the displacements of every node. The .FRC file contains the history of the 12 end forces of every member of the structure at every time step, and the 6 reactions at each support at every step. Syntax:
|
AMPLITUTDE f0 | - | Max. Amplitude of the forcing function in current units. |
FREQ | RPM f2 | - |
If
If
|
PHASE f3 | 0 | Phase Angle in degrees. |
CYCLES f4 | - | No. of cycles of loading. |
SUBDIV f5 | 3 |
Used to subdivide a ¼ cycle into this many integer time steps. Note: Only used to
digitize the forcing function. It is not the DT used to integrate for the
responses. More subdivisions will make the digitized force curve more closely
match a sine wave. The default is usually adequate.
|
STEP f6 | (p/12) |
Time step of loading. Default is equal to one twelfth of the period corresponding to the frequency of the harmonic loading. (It is best to use the default) Note: Only used to
digitize the forcing function. It is not the DT used to integrate for the
responses. More subdivisions or smaller step size will make the digitized
force curve more closely match a sine wave.
|
a1 a2 a3 ... an | - |
Values of the various possible arrival times (seconds) of the various dynamic load types. Arrival time is the time at which a load type begins to act at a joint (forcing function) or at the base of the structure (ground motion). The same load type may have different arrival times for different joints and hence all those values must be specified here. The arrival times and the times from the time-force pairs will be added to get the times for a particular set of joints in the TIME LOAD data (see TR.32.10.2 Time Varying Load for Response HistoryAnalysis). The arrival times and the time-force pairs for the load types are used to create the load vector needed for each time step of the analysis. Refer to TR.32.10.2 Time Varying Load for Response HistoryAnalysis for information on input specification for application of the forcing function and/or ground motion loads. Up to 999 arrival time values may be specified. |
DAMPING d | 0.05 |
The damping ratio.
Specify a value of exactly 0.0000011 to ignore damping.
|
The spectrum-spec option can be used to specify a synthetic ground motion acceleration time history based statistically on a user supplied acceleration spectrum.
The program will automatically calculate the acceleration time history based on the following specifications. Enter f12, f13, and f14 to indicate the rise, steady, & decay times, respectively.
For the spectrum option:
spectrum-spec =
SPECTRUM (TMAX f9) (DTI f10) (DAMP f11) (T1 f12) (T2 f13) (T3 f14) (SEED f15)
OPTIONS NF f16 NITR f17 ( THPRINT f18 ) ( SPRINT f19 ) ( FREQ )
Starting on the next line, enter Spectra in the following input form:
P1, V1; P2, V2; … ; Pn, Vn
Where:
Variable or Command | Default Value | Description |
---|---|---|
DT x | - | Solution time step used in the
step-by-step integration of the uncoupled equations. Values smaller than
0.00001 will be reset to the default
DT value of 0.0013888 seconds.
|
TYPE i | - | Type number of time varying load (integer). Up to 136 types may be provided. This number should be sequential. |
SCALE f7 | 1.0 | The scale factor option multiplies all forces, accelerations, and amplitudes entered, read or generated within this Type. Primarily used to convert acceleration in g’s to current units (9.80665, 386.08858, etc.). |
SAVE | - |
The save option results in the creation of two files (input file name with .TIM and .FRC file extensions). The .TIM file contains the history of the displacements of every node. The .FRC file contains the history of the 12 end forces of every member of the structure at every time step, and the 6 reactions at each support at every step. Syntax:
|
TMAX f9 | 20 seconds | The Max. time (in seconds) in the generated time history. This value must be greater than f14 (T3). |
DTI f10 | 0.2 | Delta time step (in seconds) in the generated time history. |
DAMP f11 | 0.05 | Damping ratio (5% is entered as 0.05) associated with the input spectrum. |
T1 f12 | 4 seconds | Ending time of the acceleration rise time. This value must be greater than zero. |
T2 f13 | 9 seconds | Ending time of the steady acceleration. This value must be greater than zero and greater than f12 (T1). |
T3 f14 | 14 seconds | Ending time of the acceleration decay. This value must be greater than f13 (T2). |
SEED f15 | Optional random Seed. Enter
a positive integer (in the range of 1 to 2,147,483,647) to be
used as a unique random number generation seed.A unique time history will be produced for each seed value. Change this value when you want to produce a different (from the time history generated with the prior seed value)but statistically equivalent time history. Omit this entry to get the default value (normal option). |
|
NF f16 | The input shock spectrum will be
re-digitized at
NF equally spaced frequencies by interpolation.
Default is the greater of 35 or the number of points in the input spectrum.
|
|
NITR f17 | 10 | The number of iterations which will be used to perfect the computed time history. |
THPRINT f18 | 1 |
Print the time history that is generated. Omit
the
|
SPRINT f19 | 1 | Print the spectrum generated from
the time history that is generated. Omit the
SPRINT parameter to avoid printing
|
FREQ | If entered, then frequency-spectra pairs are entered rather than period-spectra pairs. | |
P1, V1 P2, V2 … Pn, Vn |
Data is part of input, immediately following
Value pairs (separated by semi colons) are entered to describe the Spectrum curve. Enter the period in seconds (or frequency in Hz.) and the corresponding Value is in acceleration (current length unit/sec2) units. Continue the curve data onto as many lines as needed (up to 999 spectrum pairs). Spectrum pairs must be in ascending or descending order of period (or frequency). Note: If data is
in g acceleration units, then set
SCALE to a conversion factor to the current
length unit (9.807, 386.1, etc.). Also note, do not end these lines with a
hyphen. Commas and semi-colons are optional.
|
|
a1 a2 a3 ... an | - |
Values of the various possible arrival times (seconds) of the various dynamic load types. Arrival time is the time at which a load type begins to act at a joint (forcing function) or at the base of the structure (ground motion). The same load type may have different arrival times for different joints and hence all those values must be specified here. The arrival times and the times from the time-force pairs will be added to get the times for a particular set of joints in the TIME LOAD data (see TR.32.10.2 Time Varying Load for Response HistoryAnalysis). The arrival times and the time-force pairs for the load types are used to create the load vector needed for each time step of the analysis. Refer to TR.32.10.2 Time Varying Load for Response HistoryAnalysis for information on input specification for application of the forcing function and/or ground motion loads. Up to 999 arrival time values may be specified. |
DAMPING d | 0.05 |
The damping ratio.
Specify a value of exactly 0.0000011 to ignore damping.
|
DT
) at that time.
The time history data can also be defined in an external file, where:
Variable or Command | Default Value | Description |
---|---|---|
DT x | - | Solution time step used in the
step-by-step integration of the uncoupled equations. Values smaller than
0.00001 will be reset to the default
DT value of 0.0013888 seconds.
|
TYPE i | - | Type number of time varying load (integer). Up to 136 types may be provided. This number should be sequential. |
SCALE f7 | 1.0 | The scale factor option multiplies all forces, accelerations, and amplitudes entered, read or generated within this Type. Primarily used to convert acceleration in g’s to current units (9.80665, 386.08858, etc.). |
SAVE | - |
The save option results in the creation of two files (input file name with .TIM and .FRC file extensions). The .TIM file contains the history of the displacements of every node. The .FRC file contains the history of the 12 end forces of every member of the structure at every time step, and the 6 reactions at each support at every step. Syntax:
|
READ filename | Filename for an external file containing
time varying load history data. An example data can be found at
C:\Users\Public\Public Documents\STAAD.Pro
2024\Samples
Sample Models\US\EQDATA.TXT (typical
location). This file
contains North-South time and acceleration values for the
1940 |
|
f8 | The optional delta time spacing used for the external file when the data file includes only acceleration values. | |
a1 a2 a3 ... an | - |
Values of the various possible arrival times (seconds) of the various dynamic load types. Arrival time is the time at which a load type begins to act at a joint (forcing function) or at the base of the structure (ground motion). The same load type may have different arrival times for different joints and hence all those values must be specified here. The arrival times and the times from the time-force pairs will be added to get the times for a particular set of joints in the TIME LOAD data (see TR.32.10.2 Time Varying Load for Response HistoryAnalysis). The arrival times and the time-force pairs for the load types are used to create the load vector needed for each time step of the analysis. Refer to TR.32.10.2 Time Varying Load for Response HistoryAnalysis for information on input specification for application of the forcing function and/or ground motion loads. Up to 999 arrival time values may be specified. |
DAMPING d | 0.05 |
The damping ratio.
Specify a value of exactly 0.0000011 to ignore damping.
|
Example 1 - Using Force and Acceleration options
UNIT …
DEFINE TIME HISTORY
TYPE 1 FORCE
0.0 1.0 1.0 1.2 2.0 1.8 3.0 2.2
4.0 2.6 5.0 2.8
TYPE 2 ACCELERATION SCALE 9.80665
0.0 1.0 1.0 1.2 2.0 1.8 3.0 2.2
4.0 2.6 5.0 2.8
ARRIVAL TIME
0.0 1.0 1.8 2.2 3.5 4.4
DAMPING 0.075
Example 2 - Using the Spectrum option
UNIT …
DEFINE TIME HISTORY
TYPE 1 ACCELERATION SCALE 9.80665
SPECTRUM TMAX 19 DTI 0.01 DAMP 0.03
OPTIONS NF 40
0.03 1.00 ; 0.05 1.35
0.1 1.95 ; 0.2 2.80
0.5 2.80 ; 1.0 1.60
ARRIVAL TIME
0.0 1.0 1.8 2.2 3.5 4.4
DAMPING 0.075
Example 3 - Using the Harmonic Loading Generator
UNIT …
DEFINE TIME HISTORY
TYPE 1 FORCE
*Following lines for Harmonic Loading Generator
FUNCTION SINE
AMPLITUDE 6.2831 FREQUENCY 60 CYCLES 100 STEP 0.02
ARRIVAL TIME
0.0
DAMPING 0.075
To define more than one sinusoidal load, the input specification is as follows:
DEFINE TIME HISTORY
TYPE 1 FORCE
FUNCTION SINE
AMPLITUDE 1.925 RPM 10794.0 CYCLES 1000
TYPE 2 FORCE
FUNCTION SINE
AMPLITUDE 1.511 RPM 9794.0 CYCLES 1000
TYPE 3 FORCE
FUNCTION SINE
AMPLITUDE 1.488 RPM 1785.0 CYCLES 1000
ARRIVAL TIME
0.0 0.0013897 0.0084034
DAMPING 0.04
Example 4 - Data in Input file
The data in the external file must be provided as one or more time-force pairs per line as shown in the following example.
UNIT …
DEFINE TIME HISTORY
TYPE 1 FORCE
READ THFILE.dat
ARRIVAL TIME
0.0
DAMPING 0.075
Data in the External file THFILE.dat:
0.0 1.0
1.0 1.2
2.0 1.8
3.0 2.2
4.0 2.6
Notes
- By default
the response (displacements, forces etc.) will contain the contribution of only
those modes whose frequency is less than or equal to 108 cps. Use the
CUT OFF FREQUENCY
command to change this limit. Contributions of modes with frequency greater than the Cut Off Frequency are not considered. - Results are the individual maximums over the time period. Thus, derived quantities such as section forces and stresses, plate surface stresses and principal stresses should not be used.
- Results from harmonic input are the maximum over the time period including the start-up transient period. These results are not the steady-state results.
- By default,
the results do not include the time period after the time loads end. Use the
CUT OFF TIME
command to lengthen (or shorten) the time period. If an intense short-term loading is used, the loading should be continued until after the expected peak response is reached. - The
READ filename
command is to be provided only if the history of the time varying load is to be read from an external file. filename is the file name and may be up to 72 characters long. If the data on the file consists only of amplitudes, then enter f8 as the delta time spacing.
Mass Model
- load specified in the first dynamic load case entered, otherwise
- if the first dynamic load case does include any load data, then all
reference load cases defined as
LOADTYPE MASS
will be used, otherwise - then all reference load cases defined as
LOADTYPE GRAVITY
will be used, otherwise - then all load cases defined as
LOADTYPE DEAD
andLIVE
. At least one load case must be defined asDEAD
Refer to G.17.3.2 Mass Modeling for additional details.