Professional Documents
Culture Documents
Ruaumoko2D PDF
Ruaumoko2D PDF
Induction Book
Ruaumoko Manual
Volume 2:
User Manual for the 2:Dimensional Version
Ruaumoko2D
Author:
Athol J. Carr
Program type:
Inelastic Dynam ic Analysis
Author:
Athol J Carr
Program code:
ANSI Fortran77
Date:
27 Novem ber 2008
RUAUMOKO
The Maori God of Volcanoes and Earthquakes
After the m odal analysis is com plete the user is asked if the m ode shapes are to be displayed in an anim ated
display. Respond by typing the m ode num ber followed by RETURN. Five and a quarter cycles of vibration
are displayed unless a different num ber of cycles is specified. The default response END term inates the
plotting of m ode shapes and starts the tim e-history analysis.
During the tim e-history, on-screen pictures of the deform ed shape of the structure showing the locations of
inelastic behaviour are presented but require no user action because the pictures are replaced autom atically
as soon as a new picture is ready. Excessive use of the screen capture during the tim e-history m ay cause the
system to crash.
local scratch directory on each workstation. If the program s are being run on a single personal com puter
there is no necessity to set the environm ent variables.
On the latest personal com puter version of RUAUMO KO-2D m ost of the scratch file is em ulated in m em ory
which has increased the execution speed of the program by factors of up to 8. However, should the num ber
of sectors required for the scratch file exceed the m em ory allocated the rem ainder of the disk sectors will be
written to the hard disk file m entioned above. In all cases, even if it is not used, the file RUAUM OKO.SCR will
be created at the start of the program execution and deleted at the end of the analysis. (This disk in m em ory
approach has been successfully used in VMS and unix workstations since 1989).
Do not attem pt to carry out sim ultaneous executions of the program unless they are run from different
directories and the environm ent variable are not set as the scratch file would be accessed by the different
analyses with great confusion as the result.
Note: In the following user guide, each line of required data is indicated by a box containing the data item s.
Below each box is a description of the data item s. The data item s on each line m ay be separated by com m as
or blank spaces. The form at for the item s are indicated by the letter at the end of each descriptive line with A
indicating a character string, I indicating an integer value and F indicating a floating point num ber. A floating
point num ber m ay or m ay not have a decim al point and m ay also take a scientific or exponent form such as
1.5E6 which could also be expressed as 1500000.0. Character strings will be upper-cased unless enclosed in
double or single quotes and will term inate at the first blank space unless the string is enclosed in quotes.
Iteration and Travelling wave param eters - one line - see section 5
PROPS - one line - see sections 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22 23 and 24.
This is followed by lines for each of the sections in the properties table together with data on strength
and stiffness degradation covered in Appendices A and B.
10
W EIGHTS - one line - see section 30- Except for static analyses this section MUST be provided.
This is followed by one line for each node that has a specified point, or lum ped, weight for the m ass
m atrix. If there are no nodal weights supply a line for the first and last nodes with only the node num bers
on each of the lines.
11
12
13
EQUAKE - one line - see section 33. This is only required if dynam ic excitation is applied.
This is followed by a line with the param eters for the accelerogram or the loading history.
This then m ay be followed by the accelerogram or loading history though in m ost cases the
accelerogram is read from a separate file.
14
EQUAKE - one line - see section 33. This is only required if there are two com ponents of the
accelerogram or loading history.
This is followed by a line with the param eters for the accelerogram or the loading history.
This then m ay be followed by the accelerogram or loading history though in m ost cases the
accelerogram is read from a separate file.
15
EQUAKE - one line - see section 34. This data is only required for a Cyclic Adaptive Pushover Analysis.
This is followed by a line with the param eters for the application of the displacem ent history.
This then m ay be followed by the displacem ent history though in m any cases the history m ay be read
from a separate file.
16
SPECTRA - one line - see section 35. This is only required if the analysis is for a Response Spectra
Analysis.
This is followed by a line with the param eters for the Acceleration Response Spectra.
This then m ay be followed by the data for the response spectra though the spectra could be read from a
separate file.
IPANAL IFM T IPLAS IPCONM ICTYPE IPVERT INLGEO IPNF IZERO ORTHO IM ODE
IPANAL
IFM T
IPLAS
IPCONM
ICTYPE
IPVERT
INLGEO
IPNF
IZERO
ORTHO
IM ODE
= 0
= 1
= 2
= 3
= 4
= 5
= 6
= 7
= 8
= 9
=10
= 0
= 1
= 0
= 1
= 0
= 1
= 2
= 0
= 1
= 2
= 3
= 4
= 5
= 6
= 7
= 0
= 1
= 2
= -n
= n
= 0
= 1
= 2
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
;
=
=
=
=
=
=
=
=
=
;
;
;
;
;
;
;
;
;
0
1
2
0
0
1
0
1
2
I
I
I
I
I
I
Notes: If IPANAL is greater than 0, a static analysis is carried out if any static loads are specified and then
the m odal analysis is perform ed unless suppressed, or the order of the operations is reversed, by the
variable IPNF.
Lim its on valid ranges for variable IPVERT
If IPANAL = 1,2,3,4 or 5,
IPVERT
If IPANAL = 6 or 7,
IPVERT
If IPANAL = 8 or 9,
IPVERT
If IPANAL = 10,
IPVERT
=
=
<
=
0,1 or 2, or >-100
-1
100
0,1 or 2
For IPANAL = 4 or 5. Degrees of Freedom flagged as for travelling wave input are treated as fixed for
the static and m odal analyses and are then released at the start of the relative displacem ent tim e
history integration.
For IPANAL = 9. Degrees of Freedom flagged as input nodal displacem ent degrees of freedom are
fixed for the static and m odal analyses and are then released at the start of the total displacem ent
tim e history integration.
IPANAL = 6 is for an Adaptive Push-Over Analysis where the input load pattern is adapted as the
structure deform s and the analysis will term inate when the lim it displacem ent is reached, the factored
elastic displacem ent is reached or the structure stiffness reduces to 0.1% of the initial stiffness.
IPANAL = 7 is for a Cyclic Adaptive Push-Over Analysis where the input load pattern is adapted as
the structure deform s and when the change points in the prescribed displacem ent history is reached
the loading again reverts to the initial loading pattern but in the opposite direction and the adaptive
loading again continues until the next reversal point in the displacem ent history is reach. The analysis
will term inate when the displacem ent history is com pleted or the structure stiffness reduces to 0.1% of
the initial stiffness.
IPANAL = 8 is for the case for sim ulating a laboratory excitation where a displacem ent is applied to
the structure at a particular degree of freedom or a set of degrees of freedom . In this case the
degrees of freedom where the displacem ents are to be applied are treated as free for the static and
m odal analyses, i.e. gravity and free-vibration cases and then the displacem ent histories are applied
to these degrees of freedom . The analysis is a Relative Displacem ent form ulation.
IPANAL = 9 is for the case for the analysis of a structure where the ground is to be subjected to a set
of specified ground displacem ent histories. This would be appropriate if the different m otions are to
be applied at different parts of the foundation or at different depths in the foundation. For the static
and m odal analyses these degrees of freedom need to be fixed to prevent rigid body displacem ents
of the structure. The analysis is a Total Displacem ent form ulation
IPANAL = 10 is for the case for the analysis of a structure where the ground m otion is based on an
acceleration response spectra. The data for a norm al dynam ic analysis is read but then the analysis
is reset to linear elastic, the dam ping m odel is reset to Rayleigh dam ping, the m ass m atrix is reset to
diagonal and the analysis is set to sm all displacem ent theory. There m ay be separate spectra for the
each earthquake direction or the sam e spectra m ay be use for all earthquake com ponent. The
analysis is a Relative Displacem ent form ulation.
ORTHO is a flag that enables the user to show the orthogonality of the m ode shapes com puted with
respect to the m ass m atrix. Ideally the diagonal term s of the orthogonality m atrix should be 1.0 and
the off-diagonal term s should be 0.0.. This check is norm ally only used if, for som e reason, there is a
suspicion that the m odes com puted are not orthogonal with respect to the m ass or stiffness m atrices.
IM ODE is used to select the eigenvalue algorithm used to com pute the natural frequencies and m ode
shapes of free-vibration. The default is the Householder and QR algorithm that has been used since
the m id-1960s. This is reliable but som e instances were reported where non-orthogonal m odes were
com puted The Jacobi algorithm is the m ost stable algorithm available but is slow, and if any m ode
shapes are required they all have to be found, recom m ended for sm all problem s only. The Subspace iteration m ethod is suitable for very large problem s but m ust be used with care if parts of the
structure have very sm all m asses with sm all stiffnesses to m atch as the iteration process m ay then
be unpredictable. The iteration uses a generalised Jacobi eigenvalue routine.
ICTYPE = 0 m eans that the dam ping m atrix is based on a Rayleigh dam ping m odel and uses the
stiffness of the structure at the beginning of the tim e-history. The com puted dam ping m atrix is
constant throughout the tim e-history analysis. The tangent, secant and elastic dam ping m atrices are
identical. This m eans that as the structure softens, by yielding etc., the effective dam ping increases
because the Rayleigh coefficients " and $ were com puted for the initial natural frequencies of freevibration and som e of the frequencies have now decreased. It m ust be noted that the Rayleigh
dam ping m odel shows that the level of dam ping in the higher m odes of free-vibration can be very
large.
ICTYPE = 1 m eans that the dam ping m atrix is based on a Rayleigh dam ping m odel and uses current
stiffness of the structure at any tim e step as the tangent dam ping m atrix. If the structure is inelastic
then the tangent dam ping m atrix changes together with the stiffness m atrix throughout the tim e
history. The dam ping forces in the structure are adjusted in the tim e step with the increm ent of the
dam ping forces being the product of the tangent dam ping m atrix m ultiplied by the increm ental
velocities in the structure. The increm ental dam ping forces are then added to the dam ping forces
existing in the structure at the beginning of the tim e step to give the dam ping forces at the end of the
tim e-step.
ICTYPE = 2 m eans that the dam ping m atrix is based on the W ilson-Penzien dam ping m odel and is
based on the frequencies and m odes of free-vibration at the beginning of the tim e-history analysis.
The levels of dam ping associated with each m ode varies linearly with frequency. The com puted
dam ping m atrix is constant throughout the tim e-history analysis. The tangent, secant and elastic
dam ping m atrices are identical. This m eans that as the structure softens, by yielding etc., the effective
dam ping will increase. However, as the dam ping in the higher m odes of free-vibration is m uch less
than that im plied in the Rayleigh dam ping m odel this does not appear to have significant
consequences.
ICTYPE = 3 is a variation of the W ilson-Penzien dam ping m odel where the levels of dam ping
associated with each m ode varies in a tri-linear m anner with frequency. This m odel was initially used
to com pare the results with the Rayleigh dam ping model where the dam ping in the highest m odes
was set to be the sam e as those found in the Rayleigh dam ping m odel. It can also be used to set
high, low (or zero) levels of dam ping in the high m odes of free-vibration.
ICTYPE = 4 is a variation of the W ilson-Penzien dam ping m odel where there is a little m ore control of
the dam ping levels set for the different m odes of free-vibration.
ICTYPE = 5 is a variant of the Rayleigh dam ping m odel where the Rayleigh coefficients " and $ are
specified separately for every m em ber in the structural system . This enables different dam ping levels
to be specified in different parts of the structural system , i.e. a pounding study with buildings of
different types exhibiting different levels of dam ping or for a building on a soil foundation which
probably exhibits different dam ping to that shown by the building. The Rayleigh coefficients " and $
need to be com puted separately for each structural system and then specified in the section
properties for each m em ber type. If only initial stiffness dam ping $ is used then the analysis is sim ilar
to ICTYPE = 0 above and if tangent stiffness dam ping $ is specified than the effect id sim ilar to
ICTYPE = 1 above. If there are nodal m asses input as well as m em ber m ass then the contribution of
these nodal m asses to the dam ping m atrix can be achieved by specifying M ODE1 = M O DE2 = 0 and
by supplying C1 as " in the Fram e Control data line below. The dam ping m atrix com puted is the
tangent dam ping m atrix.
ICTYPE = 6 is a variation of the Rayleigh dam ping m odel where the the tangent stiffness m atrices are
used to form the secant dam ping m atrix. In this case the dam ping forces at a tim e-step are the
product of the secant dam ping m atrix tim es the current velocities of the structure. For the dynam ic
increm ental stiffness m atrix the tangent dam ping m atrix is assum ed to be the sam e as the secant
dam ping m atrix and the forces are then adjusted to match those from the secant dam ping m atrix.
This m odel m atches what som e users believe is the Rayleigh m odel with tangent stiffness dam ping
where others believe that ICTYPE = 1 fits that m odel. There is a potential problem with this dam ping
m odel for structures containing non-linear dash-pot m em bers.
ICTYPE = 7 is the equivalent of ICTYPE = 6 for structures using the ICTYPE = 5 m em ber specific
Rayleigh dam ping m odel and again assum es that the dam ping m atrix is the secant dam ping m atrix.
10
NNP
NM EM
NTYPE
M
M ODE1
M ODE2
GRAV
C1
C2
DT
TIM E
FACTOR
I
I
I
I
I
I
F
F
F
F
F
F
Note:
If both M ODE1 and M ODE2 above are zero then the coefficients C1 and C2 are to be taken as the
constants " and $ of the Rayleigh dam ping m odel.
If there is only one dynam ic degree of freedom then if M O DE1=1 and M ODE2=0 then m ass
proportional dam ping is m odelled.
If there is only one dynam ic degree of freedom then if M ODE1=0 and M ODE2=1 then stiffness
proportional dam ping is m odelled.
If ICTYPE = 4, User specified Modal dam ping, then M ODE1 is the num ber of m odes for which
dam ping is specified, 1 # M ODE1 # 10. Note that M ODE2, C1 and C2 should be zero.
KP
KPA
KPLOT
JOUT
DSTORT
DFACT
XM AX
YM AX
NLEVEL
NUP
IRESID
KDUM P
Note:
=
0; Tim e-history output suppressed
=
k; Tim e-history output every k tim e-steps
=
0; Post-processor DYNAPLOT output suppressed
=
k; Post-processor DYNAPLOT output every k tim e-steps
=
0; Plastic Hinges plotted at every status change
=
k; Plastic Hinges plotted every k tim e-steps
Not used any longer, supply 0 (zero)
Not used any longer, supply 1.0 (one)
Displacem ent m ultiplying scale factor for on-screen graphics. $ 1.0
Maxim um X displacem ent for use in the on-screen graphics
Maxim um Y displacem ent for use in the on-screen graphics
Num ber of levels for com puted inter-storey drifts, i.e. num ber of storeys+1
If NLEVEL is less than 2 then inter-storey drifts are not output.
Vertical axis for inter-storey drifts, 1=X axis or 2=Y axis.
=
1,
Residual displacem ents and forces output at end of tim e-history output.
=
0,
Residual displacem ents and forces not output.
=
0;
Mass and Stiffness m atrices output suppressed
=
k;
Mass and Stiffness m atrices output every k tim e-steps
I
I
I
I
F
F
F
F
I
I
I
I
The variables JOUT and D ST OR T are no longer used in Ruaum oko but are retained to m aintain
backwards com patibility of the data files.
If KP is zero for a response spectra analysis (IPANAL=10) then only the com bined m odal response
will be output whereas if KP is greater than zero each m odal response will also be output.
11
M AXIT
M AXIT
M AXCIT
FTEST
W AVEX
W AVEY
THETA
DXM AX
DYM AX
D
OM EGA
F
Notes: 1.
2.
3.
4
5
7
8
9.
M AXCIT
FTEST
F
F
F
F
F
I
F
F
If IPVERT is negative then travelling wave m odels are not perm itted.
If the ground wave velocities W AVEX and/or W AVEY are input as zero they are treated as
infinite.
W hen the Central Difference m arching m ethod is being used for the tim e-history integration
then the actual tim e-step DT/M AXIT m ust be less than half the shortest natural period of the
structure if num erical instability is to be avoided in the tim e-history integration.
The Displacem ent lim its are absolute values in that only positive num bers are used.
The default value for FTEST used when either one or both of M AXIT and/or M AXCIT are
specified is 0.00001. Note that the squares of the vector norm s are used in the test so that
0.001 im plies a 3% tolerance and 0.0001 im plies a 1% tolerance.
If the variable M AXCIT is applicable the m axim um num ber should lie in the range of 1 to 3.
As a rule, experience has shown that very seldom is m ore than one cycle of iteration
required.
As a general observation not m ore than about 5 Newton Raphson iterations should be
needed in any tim e-step
If Dispersion is applied to the travelling wave, then the am ount of dispersion applied to the
accelerogram applied to nodes after the first node to receive the input depends on the wave
velocity, the distance between the nodes (i.e. the tim e delay) and the dispersion param eter D
and the characteristic earthquake frequency OM EGA. The dispersion is in the form of a
white noise which is designed not to significantly alter the response spectra of the input
ground m otion. The first node to receive the input m otion has no dispersion applied to its
input m otion. The dispersion is a strictly random process which m eans that the input at the
nodes is never able to be repeated m eaning that subsequent analyses with the sam e data
are not repeateable. If D is supplied as a negative num ber then a pseudo-random process is
used m eaning that a re-run with the sam e data will produce the sam e results. This m ay be
useful for param eter studies where one does not want the effects of the param eter variation
to be clouded by the default strictly random nature of the dispersion.
The dispersion am plitude m ay be scaled by the factor F.
12
5a
M ODEi
DAM Pi
M ODEn DAM Pn
I
F
Notes:
1.
Num ber of Modes n specified m ust equal M ODE1 of line 2, Principal analysis options.
2.
Dam ping for m odes less than the first m ode above is taken as DAM P1 and dam ping for m odes
greater than the last above is taken as DAM Pn. This m odel m ay be considered as a variation of the
trilinear dam ping m odel.
3.
For m odes with num bers in-between the m odes specified, the Percentage of Critical dam ping is
interpolated with respect to the m odal frequencies of the m odes at the beginning and end of the gap
in the m ode num bers.
Output control during the tim e-history integration is under the control of the param eters KP and KPA on the
Section 4 above. If the param eter KP is non-zero, = J, the results are written to the output file, or device, every
J tim e steps starting at step 0. Likewise, if KPA is non-zero, = I, then results go to the post-processing
DYNAPLOT disk file every I tim e steps starting at step zero.
The control of which nodes or m em bers have their results output is determ ined by the param eter IOUT
associated with each of the nodes or m em bers in the following data sections.
The value of IOUT lies in the range of 0 to 3;
IOUT
=
=
=
=
0;
1;
2;
3;
if required, the results will be sent to both the output file and written to the DYNAPLOT file.
if required, will only be written to the DYNAPLOT file
if required, will only be sent to the output file.
will neither be printed or written to the DYNAPLOT file or to the output file.
Default values of IOUT are set on the lines with the words NODES or M EM BERS in Sections 7 or 8 below
and these values will apply for all nodes or m em bers unless over-ridden by new values on the data for that
node or m em ber. Interpolated nodes or m em bers take the value for the first node or m em ber in the
sequence.
At every tim e step the following inform ation m ay be written to the DYNAPLOT post-processing file.
1.
The tim e, ground accelerations and the inertia, dam ping and elastic energies, the external work done
by the applied loads and the plastic work.
2.
For every requested node, the nodal displacem ents, velocities, accelerations, dam ping forces, inertia
forces and applied forces.
3.
For every requested m em ber, the m em ber forces, the m em ber deform ations, the m em ber action
stiffness flags as a percentage of the elastic stiffness. (axial, flexure at end 1, flexure at end 2) or
(longitudinal displacem ent, transverse displacem ent and m om ent). For the four-hinge beam m em bers
the m om ents, curvatures and stiffness flags for the internal hinges are also output. For Fram e and
W all m em bers the shear forces at each end are also output.
13
NODES IOUT
IOUT
One input line required per nodal point, except that the presence of sequential nodal points with equally
spaced nodal point coordinates need only be im plied by the presence of the first and last nodal points of the
sequence. Boundary conditions will be taken (except for the last nodal point in the sequence) as being
identical to those of first nodal point in the sequence. Coupling nodes will also be interpolated between the
first and last nodal points in the sequence.
N
X(N)
Y(N)
NF1
NF2
NF3
KUP1
KUP2
KUP3
IOUT
Note:
I
F
F
I
I
I
I
There is no restriction of the ordering of m aster and slave nodes in the program and daisy chaining of
slaving has also been used. However, care must be exercised to ensure that circular chaining does
not occur, i.e. that the node is not effectively slaved back to itself. The unconstrained equations are
num bered and then the program works out the equation num bers of the slaved nodes. Once the
m em ber data has been input the equations are autom atically renum bered to m axim ise the execution
speed in the subsequent equation solving. This m eans that if one later wishes to apply foundation
com pliance to what was a fixed-base structure then the original node num bering does not have to be
changed, the new num bers for the foundation nodes are just appended to the existing node
sequence. Sim ilarly, adjoining fram es in a pounding study can be num bered sequentially rather than
num bering across floors of both structures to minim ise band-width. Dum m y nodes m ay be left in the
data set as long as they are fully fixed.
14
7a.
DRIFT ANGLE
The default case is that the inter-storey drifts are the differences in the storey displacem ents.
If the word DRIFT is followed by the word ANGLE (minim um of letter A) then the inter-storey drifts will be
com puted as the difference in the storey displacem ents divided by the inter-storey height as an angle
(radians). If the word ANGLE or the letter A is om itted then the inter-storey drifts are the differences in the
displacem ents over the level.
This is followed by a line or lines with a list of a list of NLEVEL nodal point num bers starting with a node point
at the ground level and then with a node point at each storey progressing upwards from the bottom of the
structure. If the nodes cannot be listed on one line then take as m any lines as is necessary. The program will
continue reading data lines until all NLEVEL num bers have been read.
N1 N2 N3 . . . Ntop
N1
N2
N3
...
Ntop
Nodal
Nodal
Nodal
Nodal
Nodal
point
point
point
point
point
I
I
I
I
I
Notes: The total num ber of nodes must be NLEVEL where NLEVEL (see section 4 on page 11) is the
num ber of storeys+1
If inter-storey drifts are requested the envelopes of inter-storey drifts are listed in the output file.
If Residual displacem ents and forces are also requested then the Residual inter-storey drifts are also
listed in the output file.
If inter-storey drifts are requested and the excitation is an earthquake (IPVERT $ 1) then the
envelopes of the Total Acceleration at each level are also listed in the output file.
15
16
One input line with the word ELEM ENTS starting in colum n 1.
IOUT
One input line is required per m em ber in ascending order, except that sequential m em bers with a nodal point
num bering that uniform ly increm ents m ay be im plied by the provision of the first and last m em ber in the
sequence. The m em ber type for all interpolated m em bers will be taken as that for the first m em ber in the
sequence.
MT
N
MT
NODE1
NODE2
NODE3
NODE4
IOUT
I
I
I
I
I
I
I
Notes: The 4-node m em bers are connected to NODE1 and NODE2 only with no stiffness contributions to
nodes NODE3 and NODE4. These latter two nodes NODE3 and NODE4 are purely for a geom etric
definition (they are assum ed to be connected to nodes NODE1 and NODE2 respectively by rigid links
with the flexible section of the m em ber lying between the inner nodes). The boundary conditions for
the inner nodes NODE3 and NODE4 m ust be fully fixed.
In a large displacem ent analysis the coordinates of nodes NODE3 and NODE4 are updated from the
increm ental displacem ents and rotations of nodes NODE1 and NODE2.
All four nodal points are required and m ust be distinct for the quadrilateral finite elem ents and the
m asonry panel elem ents. The nodal points m ust be given in an anti-clockwise sequence around the
elem ent.
17
10
One set of input for every different cross-section type (this m ay be due to the different initial load conditions
etc.). These m ust be arranged in ascending section num ber order and each m ust be one of the following
section types;
N M TYPE LABEL
N
M TYPE
LABEL
I
A
The M TYPE m ay be supplied with just enough letters to be distinct , in m ost cases just the first letter is
sufficient.
The above line for each section shall be followed by the rem aining data for the appropriate m em ber types.
See the following sections.
SECTION
SECTION
SECTION
SECTION
SECTION
SECTION
SECTION
SECTION
SECTION
SECTION
SECTION
SECTION
SECTION
SECTION
11
12
13
14
15
16
17
18
19
20
21
22
23
24
=
=
=
=
=
=
=
=
=
=
=
=
=
=
18
11
Frame Member
Order of all of the com ponents required for Fram e Mem bers are:
1
2
3
4
5
6
7
8
9
10
19
20
11a.
ITYPE IPIN
ITYPE
IPIN
ICOND
IHYST
ILOS
IDAM G
ICOL
IGA
IDUCT
Note:
1.
2.
3.
4.
5.
ICOND
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
1;
2;
3;
4;
5;
6;
7;
8;
0;
1;
2;
3;
0;
1;
n;
0;
1;
2;
3;
4;
5;
6;
7;
=
=
=
=
=
=
=
=
=
=
=
0;
m;
0;
1;
2;
3;
0;
1;
2;
0;
1;
IHYST
ILOS IDAM G
I
I
I
I
I
If ITYPE above is 6 or 7 then IHYST m ay not be 1, 5, 18 or 19, IPIN m ust be 0 and the bi-linear factor
RF in section 11c m ust have a value greater than or equal to 0.01.
If the m em ber is linearly elastic then there is no effective distinction between m em bers ITYPE 1 to 6.
To represent truss m em bers either IPIN = 3 or I (in section 11b) is set equal to zero. The latter option
is preferred as then all beam hysteresis rules can be used for the truss behaviour. If the first option is
used then only the elasto-plastic and bi-linear rules m ay be used.
The value of IDAM G is used as a weight when com puting the weighted dam age index for the whole
structure. Only integer values are accepted. If all dam age index flags are 1 then the weighted dam age
index for the structure is the average dam age index.
If IDUCT=1 the stiffness EI is taken as the stiffness under pure flexure.
21
11b.
E G
E
G
A
AS
I
W GT
END1
END2
FJ1
FJ2
A AS I W GT
F
F
F
F
F
F
F
F
F
F
Note:
The weight/unit length is used to com pute the m em ber m ass and does not contribute to the static loads
on the m em ber or the structure.
The end-block lengths END1 and END2 are within the beam between nodes NODE3 and NODE4.
11c.
M ember Bi-linear Factors and Hinge Properties (only if IHYST above not equal 0)
RA RF H1 H2 H3 H4 H5 H6 H7
RA
RF
H1
H2
H3
H4
H5
H6
H7
F
F
F
F
F
F
F
F
F
Notes:
1.
For One-Com ponent and Four-Hinge Beam s and all Beam -Colum ns the plastic hinge lengths are reset
to 1.0 if 0.0 is specified m aking the plastic curvature the sam e as the plastic hinge rotation.
2.
The plastic hinge lengths are not used for the Two-Com ponent Beam m em bers.
3.
The plastic hinge lengths for Variable Flexibility Beam s should be between 0.1 and 0.5 of the m em ber's
clear span.
4.
The Fractions of length to the interior plastic hinges of the Four-Hinge Beam m em ber should be between
0.1 and 0.4, the default is 0.3.
5.
The Central Stiffness ratio is the fraction of the end stiffnesses that is used by the central region between
hinges 3 and 4. The m inim um is 0.1. All stiffness quantities, AE, EI and GA are adjusted by the sam e
scale factor.
22
11d.
This option allows different sections to have their own values of ALPHA and BETA for Rayleigh Dam ping. This
is useful if one is m odelling a pounding study between two adjoining buildings where the buildings have different
dam ping characteristics or where different parts of the system have different dam ping characteristics, i.e. in soilstructure interaction studies. Dam ping m atrix C is given by
where M = Mass,
BETA0
BETAT
ALPHA
23
F
F
F
11e.
M1
M2
V1
V2
AXIAL
AXPS
IOP
Note:
F
F
F
F
F
F
I
The prestress force which is Tension positive affects only the internal m em ber axial force used in the
determ ination of yield states and has no effect on the static analysis of the structure.
The Axial force applied to the m em ber is positive if it acts in the direction NODE3 to NODE4 and one half
of this force is applied to each of the nodes at the ends of the m em ber.
Positive m em ber m om ents cause tensile stresses on the bottom fibres and positive shear forces act in the local
y direction on the positive local x face of the beam section. Tensile axial forces are positive. As an exam ple if
a downward load is applied to the above m em ber M 1, M 2 and V1 are negative while V2 is positive.
24
11f.
PYT
PYT
PYC
M Y1+
M Y1M Y2+
M Y2M Y3+
M Y3M Y4+
M Y4-
Note:
(
(
(
(
(
(
(
(
(
(
$
#
$
#
$
#
$
#
$
#
0.0)
0.0)
0.0)
0.0)
0.0)
0.0)
0.0)
0.0)
0.0)
0.0)
F
F
F
F
F
F
F
F
F
F
Yield m om ents for hinges 3 and 4 are only required for the Four-hinge BEAM m em bers. If both yield
m om ents at a hinge are zero then the hinge rem ains elastic. If both PYC and PYT are zero then axial
yield is suppressed. If both positive and negative yield m om ents at a hinge are zero then yield at that
hinge is suppressed.
There is no interaction between axial forces and the yield m om ents.
25
11g.
PYC
PB
MB
M 1B
M 2B
MO
PYT
IEND
Note:
F
F
F
F
F
F
F
I
If M 1B = M 2B = 0.0 then a straight line is used between the points (PB, M B) and (0.0, M O) and not the
cubic curve.
The interaction is sym m etric about the M = 0.0 axis.
26
11h.
PYC
PB
MB
MO
PC
MC
PYT
IEND
Note:
27
F
F
F
F
F
F
F
I
11i.
PYC
PYC
PB
MB
PC
MC
PYT
IEND
PB
MB
PC M C
PYT
IEND
28
F
F
F
F
F
F
I
11ii.
PYC+
PYC+
PYCPB
MB
PC
MC
PYT+
PYTIEND
PYC- PB
MB
PC
MC
29
F
F
F
F
F
F
F
F
I
11j.
One line for in-elastic shear for flexure about the local z-z axis.
Vy
Vcr
Vcc
Alfa
R
Duct1
Duct2
Vres
Phi1
Phi2
Pres
Ido
F
F
F
F
F
F
F
F
F
F
F
I
Notes: The flexural ductility used for the strength degradation is based on the flexural ductilities at the hinges at
the ends of the m em ber.
The action taken on the reaching of the shear yield strength follows the rules of Satyarno in his study on
the behaviour of shear-flexure interaction in fram ed structures.
The in-elastic shear follows the SINA hysteresis rule. Please see the Appendices.
Beta = Alfa and the rule assum es sym m etry in both force and displacem ent axes.
If Vy, the shear area or the shear m odulus are less than or equal to 0.0 then in-elastic shear is disabled
SINA Hysteresis
30
11k.
One line for in-elastic shear for flexure about the local z-z axis.
Flex Bear V1 V2 V3
Flex
Bear
V1
V2
V3
Shear
Shear
Shear
Shear
Shear
(
(
(
(
(
>
<
>
>
>
0.0)
Flex)
0.0)
1.1*V1)
0.0)
F
F
F
F
F
Notes: The joint flexibilities specified at the ends of the m em ber are com plem ented by the shear link flexibility
com puted for the shear link. The shear force at each end of the m em ber is used to adjust the joint
flexibility at that end of the m em ber.
31
11l.
11m.
For those rules which require sets of data such as SINA or Muto etc., then there are 2 sets of such data:
1: Flexure at End 1
2: Flexure at End 2
11n.
M UT
M UT
M UC
M U1+
M U1M U2+
M U2M U3+
M U3M U4+
M U4BETA1
BETA2
M UC M U1+ M U1- M U2+ M U2- M U3+ M U3- M U4+ M U4- BETA1 BETA2
(End 1)
(End 1)
(End 2)
(End 2)
(Hinge 3)
(Hinge 3)
(Hinge 4)
(Hinge 4)
(Default = 0.05)
(Default = 0.05)
F
F
F
F
F
F
F
F
F
F
F
F
Notes: Ductility data for hinges 3 and 4 is to be provided only for the Four-hinge Beam m em bers.
All ultim ate ductilities m ust be greater than 1.0.
The ultim ate ductilities have no effect on the dynam ic analysis but are only used at the end of the analysis
to com pute the dam age indices.
See Appendix B for inform ation on which hysteresis rules can allow dam age indices to be com puted.
32
12
Spring M ember
Order of all of the com ponents required for Spring Mem bers.
1
2
3
4
5
6
33
12a.
ITYPE IHYST ILOS IDAM G KX KY GJ W GT RF RT PSX PSY PSZ THETA ITRUSS IOP SL
ITYPE
IHYST
ILOS
IDAM G
KX
KY
GJ
W GT
RF
RT
PSX
PSY
PSZ
THETA
ITRUSS
IOP
SL
= 1;
= 2;
I
I
I
F
F
F
F
F
F
F
F
F
F
I
I
Notes:
1.
The weight/unit length is used to com pute the m em ber m ass and does not contribute to the static loads
on the m em ber or the structure.
2.
If the length of the m em ber is zero then the local X and Y axes coincide with the global axes.
3.
The ITYPE=2 m odel m ay be used to m odel the horizontal x and y behaviour of say a bridge pier where
the bridge is m odelled in plan and the pier acts in flexure with the vertical axis in the z direction
perpendicular to the m odel of the structure. The behaviour of the pier represents the yield force
interaction in the x and y directions where the yield forces would be the yield m om ents about the y-y and
x-x axes at the base of the pier m ultiplied by the height of the pier.
34
4.
The pre-load forces are internal to the m em ber and have no contribution to the forces acting on the
structure. They affect only the initial m em ber deform ation before any structure deform ations are im posed.
This m em ber m ay be used to represent truss mem bers where the local X-direction represents the truss
action. The stiffness KX should equal the AE/L of the truss m em ber.
If the Crisafulli hysteresis rule 33 is to be used to m odel in-fill panels then the AREAs asked for by the
rule, (see IHYST=33, Appendix B), are used to set up the stiffness of the spring at each tim e step.
However, the spring m em ber does not use the length of the strut in form ing the stiffness and so the
AREAs should be the strut cross-sectional areas divided by the strut length. Also, the stiffness KX is used
for the initial stiffness of the strut until the stiffness is checked to find its status in the hysteresis rule
behaviour, this is in the static analysis, where static loads are applied or at tim e = 0.0 if not. This m eans
that an initial estim ate of KX should be m ade. In general the Crisafulli m odel does not carry significant
tensile forces which m eans that norm ally two strut m em bers are required acting along opposite diagonals
and each would only act in the longitudinal, or X, direction.
IDAM G, m is used as a weight when adding m em ber damage indices to obtain structure dam age index,
see notes for Fram e m em bers , section 11a.
If ITYPE= 5 then the transverse yield force is a function of the axial force. The transverse hysteresis is
elasto-plastic representing the transverse friction. The other actions in the axial direction and rotation are
linearly elastic. There m ust be axial and transverse stiffness but the rotational stiffness m ay be zero.
The transverse dashpots will generate m om ents at Nodes 3 and 4 by rigid lever arm s whose length will
depend on the length of the m em ber and the param eter SL
5.
6.
7.
8.
9.
12b.
This option allows different sections to have their own values of ALPHA and BETA for Rayleigh Dam ping. This is
useful if one is m odelling a pounding study between two adjoining buildings where the buildings have different
dam ping characteristics or where different parts of the system have different dam ping characteristics, i.e. in soilstructure interaction studies. Dam ping m atrix C is given by
where M = Mass,
BETA0 BETAT
BETA0
BETAT
ALPHA
ALPHA
35
F
F
F
12c.
FX+
FXFY+
FYM Z+
M ZNote:
F
F
F
F
F
F
There is no interaction between torsion and spring yield and there is no interaction between the spring
yield in the rotation, x or y directions.
FX1
FY1
FX2
FY2
M Z+
M ZRX1
RY1
RX2
RY2
Note:
F
F
F
F
F
F
F
F
F
F
There is an elliptic interaction curve between x and y yield force in each quadrant of the diagram below.
The force-displacem ent curve in this case is tri-linear, it is m odelled by two elasto-plastic m em bers and
one elastic m em ber in parallel. The yield forces are sym m etric about the origin. There is no interaction
between yield in rotation and the x and y directions. The rotational com ponent follows a bi-linear
hysteresis rule.
36
12e. Yield Surface ( ITYPE = 3 ) Flexure-Shear interaction. (Not if IHYST = 0, 18, 19, 33 or 37)
FX+ FX- FY+ FY- M Z+ M Z- FCRY FCCY ALFA HINGE DUCT1 DUCT2 RES DUCT3 I
FX+
FXFY+
FYM Z+
M ZFCRY
FCCY
ALFA
HINGE
DUCT1
DUCT2
RES
DUCT3
I
F
F
F
F
F
F
F
F
F
F
F
F
F
F
I
Notes:
1.
The SINA hysteresis rule governs the Shear (or Y action). The cracking forces in the Y direction are
sym m etric about the origin. The strength loss in the Y direction is based on the absolute values of the
rotational com ponent ductility.
2.
The Shear Stiffness KY = G AS / L where G is the shear m odulus, A S is the Shear Area and L is the plastic
hinge length. The Flexural Stiffness GJ = E I / L where E is the elastic m odulus and I is the second
m om ent of area of the equivalent beam section. To get curvatures from the rotations divide the rotations
by the plastic hinge length L.
3.
If I above is non-zero then shear strength degradation will also occur with shear ductility. A line with the
degradation data as for Appendix A of this m anual m ust im m ediately follow this line. The norm al strength
degradation controlled by the variable ILOS will apply to the x and rotational actions in the spring m em ber.
The case of I above is 2 is for colum ns where retrofit is assum ed to have been applied and the sequence
of shear failure is to be shown. W hen I is 3 is the case where retrofit is assum e not to occur and shear
failure in a colum n im plies failure of the structure.
4.
These last two cases of I = 2 or 3 are really applicable to colum ns, 2 inform s the user that shear yield has
occurred but im plies a retrofit has been applied so one can see where the next yield will occur. Option 3
covers the case for colum ns without retrofit where failure of a colum n im plies failure of the structure.
37
12f. Yield Surface ( ITYPE = 4 ) Axial Force - Yield Mom ent interaction (Not if IHYST = 0, 18, 19, 33 or 37)
PYT
PYC
FY+
FYPB
MB
M 1B
M 2B
MO
Note:
(
(
(
(
(
(
(
(
(
>
<
>
<
<
>
>
>
>
0.0)
0.0)
0.0)
0.0)
0.0)
0.0)
0.0)
0.0)
0.0)
F
F
F
F
F
F
F
F
F
38
12g. Yield Surface ( ITYPE = 5 ) Axial Force - Transverse Force interaction (Not if IHYST = 0,18,19,33 or 37)
F0 M U IOP
F0
MU
IOP
Note:
The axial force is the local x com ponent action. The friction force acts in the local y direction.
12h.
12i.
F
F
I
(See Appendix A)
For those rules which require sets of data, such as SINA or Muto, then there are 2 sets of such data.
ITYPE=1
1: Longitudinal or X direction action. (The sam e param eters are used for rotational action)
2: Transverse or Y direction action.
ITYPE=3
1: Longitudinal or X direction action.
2: Rotation or Theta-Z action.
For the W idodo hysteresis (IHYST = 19) a third set of data is used for the rotational action.
12j.
M UX+
M UXM UY+
M UYM UR+
M URBETA1
BETA2
F
F
F
F
F
F
F
F
39
13
W all M ember
13a.
NSECT
NSECT
NIP
ICOND
IHYST
W GT
AM AX
IM AX
H1
H2
NIP ICOND
IHYST
W GT
AM AX IM AX H1 H2
I
I
I
I
F
F
F
F
F
Notes:
1.
The weight/unit length is used to com pute the m em ber m ass and does not contribute to the static loads
on the m em ber or the structure.
2.
W all m em bers usually require sm aller tim e-steps than m ost other structures, i.e. 0.001 to 0.0001 seconds
com pared with 0.01 seconds and Newton-Raphson iteration, say 3 cycles, should be provided. Changes
in the flexural stiffness also lead to large changes in the axial stiffness and the m ovem ent of the neutral
axis im plies coupling between the axial and flexural actions as well.
3.
If the m em ber is in-elastic and Newton-Raphson iteration has not been enabled the variable M AXIT is
autom atically reset to a m axim um of 3 cycles of iteration and FTEST to 0.10. It has been found that a
sm aller value of FTEST would be m ore appropriate.
4.
The original Taylor elem ent had a m id-length node with an hierarchical axial degree of freedom so that
40
5.
6.
7.
8.
9.
the longitudinal strains due to the axial displacem ents had a quadratic variation with length as do the
longitudinal strains due to the beam -like cubic flexural displacem ent with length. It has been found that
the m id-length degree of freedom was never excited in the analyses and this seventh deform ation degree
of freedom has been deleted.
At each section along the length the centre-line axial strain is com puted, the curvature com puted as a
function of the end rotations and assum ing that the cross-section rem ains plane the longitudinal strain in
each segm ent of the section is com puted. For each segm ent in the cross-section the concrete and steel
stresses and tangent m odulii are com puted and then the m om ent and axial force on the section are
calculated and the new effective cross-sectional area, second m om ent of area and the location of the
neutral axis is com puted.
The section properties are integrated along the length using a Lobatto integration rule to get the m em ber
stiffnesses. Three point Lobatto integration is identical to a three point Sim psons rule.
Taylor som etim es used up to three elem ents to represent the wall over a single storey height.
IM AX < 1 is accounted for by intially cracking the section from both extrem e segm ents inwards so that
the effective I is less than or equal to IM AX*IGROSS. AM AX is no longer used but as the flexural stiffness
reduces with the pre-cracking of the section the effective cross-sectional area also reduces.
NSECT = 2 is for an Giberson type beam -colum n m odel with an elastic central region with the plastic
hinge zones m odelled by a Taylor-like segm ental section. This allows for the neutral axis to m ove within
the hinge zone.
W a ll M e m b e r S ig n C o n v e n tio n
41
13b.
EM ODC
EM ODC
EM ODS
SIGA
SIGB
EPSB
SIGCR
SIGYS
SBILIN
ALFA
EPSB
SIGCR
SIGYS SBILIN
ALFA
F
F
F
F
F
F
F
F
F
Notes:
1.
The concrete is assum ed to carry no tensile stress once the m aterial has cracked and the concrete is
assum ed to carry no tensile stress once the com pressive strain has exceeded EPSB.
2.
IHYST = 0, The uncracked section properties are used for all tim e-steps.
3.
IHYST = 1, The concrete elastic m odulus is assum ed to be a constant EM ODC until the stress SIGA is
reached. The peak strain EPSA = SIGA/EM ODC. The steel assum es a bi-linear stress-strain hysteresis.
This follows the original Taylor Elem ent-A m odel
4.
IHYST = 2, The concrete stress-strain law follows a quadratic rule until the stress SIGA is reached. The
peak strain EPSA = 2.0*(SIGA/EM ODC). The steel hysteresis rule has an elasto-plastic first yield
excursion but subsequent cycles follow the Al-Berm ani Bounding Surface rule with "=$=0.3 to m odel the
Bauschinger effect. This default value of ALFA m ay be overridden by specifying a different value in the
range 0.0 to 1.0 in the data above where ALFA = 1.0 im plies a bi-linear hysteresis. The steel bi-linear
factor SBILIN, used to define the in-elastic bounding surface, takes a m inim um of 0.0001 for the Bounding
Surface algorithm to work.
42
43
13c
This option allows different sections to have their own values of ALPHA and BETA for Rayleigh Dam ping. This is
useful if one is m odelling a pounding study between two adjoining buildings where the buildings have different
dam ping characteristics or where different parts of the system have different dam ping characteristics, ie.e. in soilstructure interaction studies. Dam ping m atrix C is given by
where M = Mass,
BETA0
BETAT
ALPHA
44
F
F
F
13d.
B
D
B1
B2
D1
D2
D3
D4
AS1
AS2
AS3
Note:
F
F
F
F
F
F
F
F
F
F
F
All distances D1, D2, D3 and D4 are m easured from the left side of the wall when the section is viewed
down the m em ber in the -X direction
The structural axis of the m em ber is assum ed to be at D/2
45
13e.
I
X(I)
AS(I)
AC(I)
Note:
I
F
F
F
46
14
Dashpot M ember
ITYPE
C1
C2
C3
GAP+
GAPALFA
C4
C5
C6
ALFATHETA
LIM IT
SL
=0
=1
=2
Linear Dashpot
Non-Linear Dashpot
Non-Linear Dashpot with different properties in Positive and Negative
directions.
=3
Different dam ping coefficients when increm ental velocity and velocity have
opposite signs than when they have the sam e sign
Longitudinal coefficient
Transverse coefficient
Rotational coefficient
Positive Gap
Negative Gap
Velocity Power Factor (ALFA > 0.0)
(Default=1.0)
(ITYPE > 0)
Longitudinal coefficient (negative direction)
(ITYPE > 1)
Transverse coefficient (negative direction)
(ITYPE > 1)
Rotational coefficient (negative direction)
(ITYPE > 1)
Velocity Power Factor ALFA in the negative direction.
(ITYPE > 1)
Angle between Global X and Local x axes (Degrees)
=0
No lim its set on Dashpot Forces and Mom ent
=1
Lim its set on Dashpot Forces and Mom ent
Shift of position of Transverse Dashpot. (-0.5 # SL # 0.5))
(0.0 im plies that the Transverse dashpot is located m idway between Nodes 3 and 4
where SL = -0.5 m oves dashpot to Node 4 and +0.5 m oves dashpot to Node 4)
F
F
F
F
F
F
F
F
F
F
F
I
F
Notes:
1.
C1, C2 and C3 are the dash-pot coefficients (force / unit velocity) for the different actions in the m em ber.
These act in the positive direction only if ITYPE = 2.
2.
These m em bers are only included in the tim e-history analysis if IPANAL = 2 or m ore when their
contributions are added to the dam ping m atrix of the structure.
4.
Sign Conventions are the sam e as those for the SPRING m em ber types, see section 12.
5.
If the length of a DAM PER type m em ber is zero then the local X and Y axes coincide with the global axes
unless a non-zero value has been specified for THETA above.
6.
If the m em ber deform ation is within the range of the gap then the dashpot has no resisting force.
7.
If ITYPE = 3 then C1, C2 and C3 are used when the velocity and increm ental velocity have the sam e sign
and C4, C5 and C6 apply when the signs are not the sam e.
47
8.
For Non-linear dash-pots all com ponents use the sam e ALFA. The dash-pots show no hysteresis in their
Force-Velocity relationship, it is a non-linear elastic force-velocity relationship. The dash-pot force for
com ponent i is related to the dash-pot velocity by the following equation
9.
If ITYPE = 2 the dashpot has different properties in the positive and negative directions and the rules
for the data in the negative direction are the sam e as those for the positive direction com ponents.
If IPLAS = 0, Elastic tim e-history analyses only, (see section 2, Principal analysis options), then the initial
gaps are reset to zero and ITYPE is reset to 0 after all the input data has been read.
The transverse dashpot will generate m om ents at Nodes 3 and 4 by rigid lever arm s whose length will
depend on the length of the m em ber and the param eter SL
10.
11.
FXM AX
FXM IN
FYM AX
FYM IN
FZM AX
FZM IN
Maxim um
Minim um
Maxim um
Minim um
Maxim um
Minim um
local
local
local
local
local
local
x
x
y
y
z
z
direction
direction
direction
direction
direction
direction
Force
Force
Force
Force
Mom ent
Mom ent
(Axial)
(Axial)
(Transverse)
(Transverse)
(Out-of-plane)
(Out-of-plane)
48
F
F
F
F
F
F
15
Tendon M ember
ITYPE
FPP
FPN
FNN
FNP
GAP+
GAPTHETA
I
F
F
F
F
F
F
F
Notes:
1.
These m em bers are only included in the tim e-history analysis IPANAL > 1 when they are considered in
the dynam ic equilibrium equations.
2.
Sign Convention: This is the sam e as for the SPRING m em bers. Tensile forces and m em ber elongations
are positive.
3.
If the m em ber is of zero length then the TENDON local m em ber axis is assum ed to coincide with the
global x axis unless a non-zero has been specified for THETA above. THETA is only used for zero length
m em bers.
49
ITYPE DELAY
ITYPE
DELAY
THETA
FPP
IH
BETA
THETA FPP IH
BETA
I
F
F
F
I
Notes: The tim e delay is internally converted to an integer num ber of tim e-steps
If IH > 0 then the saturation force FPP must be supplied
NODE
NDOF
NTYPE
FACTOR
I
I
Notes:
1.
These m em bers are only included in the tim e-history analysis IPANAL > 1 when they are considered in
the dynam ic equilibrium equations.
2.
Sign Convention: Tensile forces and m em ber elongations are positive.
3.
If the m em ber is of zero length then the local m em ber axis is assum ed to coincide with the global x axis
unless a non-zero value has been specified for THETA above. THETA is only used for zero length
m em bers.
4.
Care m ust be taken when setting out the m agnitude and sign of the m ultiplier as an inept choice m ay
lead to very large displacem ents and loss of precision and failure of the analysis. The deform ation and
force in the m em ber is tension positive. The tendon m em ber in tension pulls on both joints with equal and
opposite forces. It is worth noting that if the displacem ent of the structure has an equivalent circular
frequency T (radians/sec) then the m agnitude of the velocities are of the order of T tim es the m agnitude
of the displacem ents and the m agnitude of the accelerations is T 2 tim es the m agnitude of the
displacem ents.
5.
If IH = 1 or 2 the equivalent stiffness used in the hysteresis rule is 1.0 and the force com puted by the
com ponents described above is used as the displacem ent in the loop. This differs from the behaviour
when ITYPE = -1 or -3 respectively for in those cases the controlling displacem ent is the elongation of
the tendon while in this case the controlling input is com puted from the contributions described above.
50
ITYPE
STIFF
FPP
DELAY
THETA
THETA
I
F
F
F
F
Notes:
1.
These m em bers are only included in the tim e-history analysis IPANAL > 1 when they are considered in
the dynam ic equilibrium equations.
2.
Sign Convention: Tensile forces and m em ber elongations are positive.
3.
If the m em ber is of zero length then the local m em ber axis is assum ed to coincide with the global x axis
unless a non-zero value has been specified for THETA above. Theta is only used for zero length
m em bers.
4.
The force displacem ent relationship follows the Resettable Actuator Hysteresis rule IHYST = 43
5.
The equivalent yield values are Fy+ = +FPP and Fy- = -FPP where FPP is the Saturation Force.
6.
FPP m ust be greater than 0.0
7.
The tim e-delay is internally converted to an integer num ber of tim e-steps
51
ITYPE STIFF
ITYPE
STIF
ALFA
DAM P
BETA
FPP
ALFA
DAM P
BETA FPP
= -2
Equivalent stiffness coefficient
(Force per unit displacem ent)
Power factor for elem ent displacem ent (ALFA > 0.0)
Equivalent dam ping coefficient
(Force per unit velocity)
Power factor for elem ent velocity
(BETA > 0.0)
Saturation Force (Tendon force lies between +FPP and -FPP if FPP > 0.0
If FPP = 0.0 then the force is unbounded (equivalent of FPP = infinity)
I
F
F
F
F
F
Notes:
1.
These m em bers are only included in the tim e-history analysis IPANAL > 1 when they are considered in
the dynam ic equilibrium equations.
2.
Sign Convention: Tensile forces and m em ber elongations are positive.
3.
The force in the mem ber is given by the following relationship. The displacem ent is the elongation of the
m em ber and the velocity is the rate of change of m em ber length.
4.
This m em ber is very useful where a dam per or spring m em ber is required where the power factors ALFA
and BETA are less than 1.0. In these cases the equivalent tangent stiffness or dam ping coefficients tend
to infinity when the displacem ent or the velocity tend to zero leading to num erical difficulties in the
analyses. In these lim iting cases the forces are usually sm all and large stiffness or dam ping coefficients
are not a problem as the tendon m em ber has neither stiffness or dam ping coefficients
52
ITYPE
STIFF
BETA
FPP
DELAY
THETA
THETA
I
F
F
F
F
Notes:
1.
These m em bers are only included in the tim e-history analysis IPANAL > 1 when they are considered in
the dynam ic equilibrium equations.
2.
Sign Convention: Tensile forces and m em ber elongations are positive.
3.
If the m em ber is of zero length then the local m em ber axis is assum ed to coincide with the global x axis
unless a non-zero value has been specified for THETA above. Theta is only used for zero length
m em bers.
4.
The force displacem ent relationship follows the Two-Four Dam per Hysteresis rule IHYST = 51, please
see Appendix B.
5.
The equivalent yield values are Fy+ = +FPP and Fy- = -FPP where FPP is the Saturation Force.
6.
FPP m ust be greater than 0.0
7.
The tim e-delay is internally converted to an integer num ber of tim e-steps
53
16
Contact M ember
16a.
ITYPE
IHYST
KX
CX
MU
FL
M1
M2
THETA
INIT
SL
SL
I
F
F
F
F
F
F
F
I
F
Notes:
1.
If the length of the m em ber is zero then the local X and Y axes coincide with the global axes unless a
non-zero value has been specified for THETA above.
2.
These m em bers stiffness and dam ping m atrices are only included in the tim e-history part of the analysis
when IPANAL = 2 or 3.
3.
The Coefficient of restitution r (supplied as CX above) is related to the Percentage of Critical dam ping
8 by the following form ula
4.
5.
6.
7.
The Effective End m asses are only required if ITYPE is 1 or 2 and are used to generate the equivalent
fraction of critical dam ping in the m em ber. The m asses are usually taken as the m ass in the fram e at
the floor at that end of the m em ber.
The transverse friction force is proportional to the transverse displacem ent since the onset of contact or
the reversal of transverse displacem ent and is lim ited to M U tim es the contact force.
The friction forces only exist if there is a non-zero contact force.
The friction spring will generate m om ents at Nodes 3 and 4 by rigid lever arm s whose length will depend
on the length of the m em ber and the param eter SL
54
The Fractions of Critical Dam ping (for ITYPE = 1, or 2 using 8 in note 3) are related to the Dam ping
Coefficient c in the axial deform ation m ode of the m em ber by the following expression where k is the
current m em ber tangent stiffness and the m asses m 1 and m 2 are the m asses at the ends of the m em ber
(W hen ITYPE is 0 the dam ping coefficient c is CX)
8.
PX+
PXRTEN
F
F
F
16c. Hysteresis data . See section 14 for the data required. This will com plete the data for this m em ber type.
55
17
Order of all of the com ponents required for Quadrilateral Mem bers.
1.
2.
56
17a.
ITYPE E NU THICK W GT
ITYPE
E
NU
THICK
W GT
= 0; Plane Stress
= 1; Plane Strain
Elastic Modulus
Poisson's Ratio
Thickness of the elem ent
W eight/(unit volum e) of the elem ent
I
F
F
F
F
Notes:
1.
The weight/(unit volum e) is used to com pute the m em ber m ass and does not contribute to the static
loads on the m em ber or the structure.
2.
The elem ent is a Hybrid Stress Type 2 quadrilateral finite elem ent. All four nodes m ust be distinct (i.e.
no triangles). The stress distribution is assum ed to have a cubic variation in both the x and y directions
and the elem ent edge displacem ents are assum ed to vary linearly along the elem ent edge for the
tangential displacem ent and to have a cubic variation along the edge for the norm al displacem ent. The
elem ent actually assum es a linear variation of thickness between nodes but in the application within the
program a constant thickness is assum ed. Three point Guass quadrature is used in each direction to
integrate the flexibility m atrix and three point Guass quadrature is used for the integrals along the
elem ent edges. Any reduction of the order of integration gives inaccurate integrals and a higher order
gives no change in the integrals.
3.
The elem ent is assum ed, at present, to be linearly elastic.
17b.
This option allows different sections to have their own values of ALPHA and BETA for Rayleigh Dam ping. This
is useful if one is m odelling a pounding study between two adjoining buildings where the buildings have different
dam ping characteristics or where different parts of the system have different dam ping characteristics, i.e. in soilstructure interaction studies. Dam ping m atrix C is given by
where M = Mass,
BETA0 BETAT
BETA0
BETAT
ALPHA
ALPHA
57
F
F
F
18
These elem ents are designed to represent the behaviour of an unreinforced m asonry panel infill in a reinforced
concrete fram e. The m odel assum es that the infill is such that there are no gaps between the fram e and the
panel. As generally constructed in South Am erica the fram e is often placed after the panel is erected (Crisafulli,
1997).
The panel is m odelled with two parallel struts in each diagonal to represent the thrust carried across the panel
in diagonal com pression. A fifth strut, which acts between the two opposite diagonal carriers on the diagonal
carrying com pression, transfers the shear force between the top and bottom of the panel.
In general, the panel elem ents are rectangular but other geom etries are perm itted .
Four or Three lines of data required. An extra line will be required if the Material Specific Dam ping m odel is being
used.
1.
2.
3.
4.
58
18a.
Geometric Data
IHYST
IHYST
HZ
XO1
YO1
XO2
YO2
XO3
YO3
XO4
YO4
HZ XO 1 YO 1 XO 2 YO 2 XO 3 YO 3 XO 4 YO 4
59
I
F
F
F
F
F
F
F
F
F
18b.
Properties 18a
TO
MU
TM AX
SSF
KTF
TH
W GT
F
F
F
F
F
F
F
Notes:
The input data required for the application of the panel elem ent includes the param eters described in for defining
the cyclic axial behaviour of m asonry and the properties of the equivalent strut. In addition, the following variables
need to be defined in relation to the shear behaviour of the m asonry panel:
Vertical separation betw een struts, h z : values of h z between z/3 and z/2 seem s to lead to adequate results,
where z is the contact length between the panel and the fram e.
Horizontal and vertical offset, x o i and y o i: these param eters define the horizontal and vertical distance,
respectively, m easured from the external nodes to the internal nodes. This is intended to represent the reduction
of the dim ensions of the panel due to the depth of the fram e m em bers.
Bond shear strength,
and coefficient of friction, :: these param eters are usually obtained from direct shear
tests or following design specifications. It is recom m ended, however, the use of the reduced values resulting from
the m odified shear theory proposed by Crisafulli. This theory takes into account the com plex stress state in the
panel due to the com posite nature of m asonry.
M aximum shear stress,
: this is the m axim um shear stress perm issible in the m asonry panel, whose value
can be selected from the shear failure envelope of m asonry. This is to avoid a large shear strength due to high
axial forces in the struts.
Shear stress factor, " s : this param eter defines the ratio of the m axim um shear stress to the average stress in
the m asonry panel. It norm ally varies from 1.40 to 1.65.
Shear stiffness factor, ( s : this factor represents the fraction of the total stiffness assigned to the shear spring,
usually ranging from 0.5 to 0.75 but should not exceed 0.85 to 0.90. The rem aining part,
, is assigned to
the struts. The total stiffness of the panel elem ent is controlled by the strut area and the elastic m odulus.
Thickness of the panel, t: this is assum ed to be constant over the panel.
W eight per unit volum e: this is used to calculate the m ass of the panel and is used only to form the structure
m ass m atrix. It does not contribute to loads on the structure.
60
18c.
FC FT
FC
FT
UC
UUL
UCL
EM O
GUN
ARE
18.d
UC
UUL UCL EM O
GUN ARE
F
F
F
F
F
F
F
F
Strut areas
AREA1
AREA2
R1
R2
IENV
F
F
F
F
I
or Elastic Properties
EM O
EM O
AREA1
AREA1
Elastic m odulus
Initial area of strut
F
F
61
Notes:
FC
The com pressive strength f 'm 2 is the m ain param eter controlling the resistance of the strut. It m ust be
noted that FC does not represent the standard com pressive stress of m asonry but should be adopted
taking into account the inclination of the com pressive principal stresses and the m ode of failure expected
in the m asonry panel. See Crisafulli 1997.
FT
Tensile strength f't represents the tensile strength of the m asonry or the bond strength of the panel-fram e
interface, whichever is sm allest. The consideration of the tensile strength has been introduced in the
m odel in order to gain generality. However, results obtained from different examples indicate that the
tensile strength, which is generally m uch sm aller than the com pressive strength, has no significant
influence on the overall response. Therefore, in the absence of m ore detailed inform ation, the tensile
strength can be assum ed to be zero.
UC
The strain at m axim um stress g'm usually varies between -0.002 and -0.005 and its m ain effect on the
overall response of the infilled fram e is the m odification of the secant stiffness of the ascending branch
of the stress-strain curve.
UUL
The ultim ate strain g u is used to control the descending branch of the stress-strain relationship. W hen
a large value is adopted for, exam ple g u = 20 g'm , a sm ooth decrease of the com pressive stress is
obtained.
UCL
The closing strain g cl defines the lim it strain at which the cracks partially close and com pressive stresses
can be developed. Values of the closing strain ranging between 0 and 0.003 lead to results which agree
adequately with experim ental data. If a large negative value is adopted, for exam ple g cl = g u , this effect
is not considered in the analysis.
EM O
The elastic m odulus E m o represents the initial slope of the stress-strain curve and its value can exhibit
a large variation. Various expressions have been proposed for the evaluation of the elastic m odulus of
m asonry. It is worth noting, however, that these expressions usually define the secant m odulus at a
stress level between 1/3 and 2/3 of the m axim um com pressive stress. In order to obtain an adequate
ascending branch of the strength envelope it is assum ed that E m o $ 2 f' m 2 / g'm .
GUN
The unloading stiffness factor ( u n controls the slope of the unloading branch. It is assum ed to be greater
than or equal to 1.0 and usually ranges from 1.5 to 2.5.
ARE
The reloading strain factor " re defines the point where the reloading curves reach the strength envelope.
The calibration of the hysteretic m odel for the axial behaviour of m asonry showed that good results are
obtained using values ranging between 0.2 and 0.4. However, higher values, for exam ple 1.5, are
required to m odel adequately the cyclic response of the infilled fram es. This is because other sources
of nonlinear behaviour, such as sliding shear, need to be indirectly considered in the response of the
m asonry struts.
Four param eters are required to represent the cross-sectional area of the m asonry strut. These are the initial area
A m s1 = AREA1 and final area A m s2 = AREA2 and the axial displacem ents at which the cross-sectional area
changes, ) R 1 = R1 and ) R 2 = R2. In a sim plified m odel, it can be assum ed that AREA1 and AREA2 are the
sam e using a low value of the strut area to avoid an excessive increase in the axial strength. In a m ore refined
analysis, a higher value of the initial area can be adopted, whereas the final area can be reduced by about 10%
to 30%. The displacem ent R1 and R2 can be estim ated as g'm d m /5 and g'm d m (where d m is the length of the
m asonry strut) respectively, at least until m ore precise inform ation becom es available. Several em pirical
expressions, which are described in section 6.2.1.3 of the reference, have been proposed for the evaluation of
the equivalent width of the m asonry strut, whose value norm ally ranges from 0.1 to 0.25 of the diagonal length
of the infill panel.
IENV
The descending branch of the stress-strain curve is usually m odelled with a parabola instead of the curve
associated with Sargin's equation in order to obtain a better control of the response of the strut after the
m axim um stress has been reached.
62
18e.
This option allows different sections to have their own values of ALPHA and BETA for Rayleigh Dam ping. This
is useful if one is m odelling a pounding study between two adjoining buildings where the buildings have different
dam ping characteristics or where different parts of the system have different dam ping characteristics, ie.e. in soilstructure interaction studies. Dam ping m atrix C is given by
where M = Mass,
BETA0 BETAT
BETA0
BETAT
ALPHA
ALPHA
63
F
F
F
19
These m em bers can be regarded as a form of beam m em ber and m ay be used to represent the flexibility of the
soil continuum beneath foundation beam s and footings. The elem ents have a cubic variation of norm al thrust
and a linear variation of axial shear along their lengths so their edge displacem ents are fully com patible with
beam m em bers. Three possible representations of the soil are included:
Vlazov Foundation
General Two-Param eter Foundation (Pasternak m odel)
Vogt Foundation
The norm al force-deflection relationship of both the Vlazov and the General Two-Param eter Foundation m em bers
are governed by the following equation (Selvadurai,1979):
q(x) = k.w (x) G(d 2 w /dx 2 )
In the Vlazov soil m odel, the param eters k and G are derived from the elastic properties of the soil and specified
constraints to the variation of norm al displacem ent of the soil with depth.
In the General Two-Param eter soil m odel, k and G are input directly by the user.
The Vogt foundation m odel was derived using Boussinesqs form ulas and has been used in the past for m odelling
arch dam s (Holand, 1968; Clough,1973). In two-dim ensional analyses, the norm al force-deflection relationship
for the Vogt m odel is sim ilar to that of the Vlazov and General Two-Param eter soil m odels, but does not contain
a shear term . This m odel is analogous to a distributed W inkler spring.
The m odels can be regarded as Pseudo-Dynam ic foundation com pliance m odels. They do not autom atically
account for the frequency dependence of the dynam ic stiffness of the soil. Such effects can be included by
appropriately scaling the input param eters to account for the fundam ental period of the com bined soil-structure
system .
The effects of radiation dam ping are incorporated into the Vlazov m odel by way of dashpots, placed in parallel
with the soil springs. Radiation dam ping is highly dependent on frequency and should only be included if the
fundam ental period of the com bined soil-structure system is below the fundam ental period of the site.
Appropriate scale factors for radiation dam ping and the elastic stiffness of the soil, as a function of the
fundam ental frequency of the soil-structure system , can be obtained from W olf (W olf, 1994)
64
Foundation m em bers should be placed beneath foundation beam s and footings and additional m em bers should
be provided to m odel the soil surface adjacent to the structure being m odelled. These m em bers should extend
either side of the structure at least two to three tim es the width of the structure.
References:
Clough, Ray W et al,. ADAP a computer program for static and dynamic analysis of arch dams. University of
California, Berkeley, California, 1973
Holand, Ivar and Aldstedt, Erik, Arch Dam Analysis by Finite Element Analysis, Institute for Structural Mechanics,
University of Trondheim , Norway, January 1968
Selvadurai, A. P. S., Elastic Analysis of Soil-Foundation Interaction. Developm ents in Geotechnical Engineering
Vol. 17, Elsevier Scientific Publishing Com pany, The Netherlands, 1979.
W olf, John P., Foundation Vibration Analysis Using Simple Physical Models. Prentice Hall , Englewood Cliffs,
NJ, 1994.
65
19a.
ITYPE
ISHEAR
IHYSTA
IHYSTK
IHYSTG
ILOSA
ILOSK
ILOSG
ISTFS
IRAD
ISTF IRAD
I
I
I
I
I
I
I
I
I
Note:
IHYSTA, IHYSTK and IHYSTG can take on values of 0,1,2,3,4,8,10,11,12,13,14,20,21,23,26 and 28 see
Appendix B.
19b.
EM
MU
DEPTH
W EFF
DENS
F
F
F
F
F
Notes:
A linear variation of displacem ent with depth is only appropriate for shallow soil layers
The m odel is form ulated assum ing that Plane Strain conditions apply.
66
19c.
EM
MU
DEPTH
GAM M A
LENGTH
W EFF
DENS
19d.
(0.001 # GAM M A # 1)
F
F
F
F
F
F
F
EM M U M UB W EFF DENS
EM
MU
M UB
W EFF
DENS
19e.
F
F
F
F
F
AS KS GS W EFF
AS
KS
GS
W EFF
Note:
19f.
EM F PR
EM F
PR
KFACT
W EFF
KFACT
F
F
F
F
W EFF
F
F
F
F
67
19g.
Data for Non-linear Foundation Behaviour (only if IHYSTA, IHYSTK or IHYSTG > 0)
PYTA
PYCA
PYT
PYC
TY
BFA
BFP
BFT
Note:
PYTA, PYCA, PYT, PYC and TY are in units of force per unit area
19h.
F
F
F
F
F
F
F
F
AM ASS
KM ASS
GM ASS
Note:
AM ASS, KM ASS and GM ASS can take values between 0.0 and 1.0
19i.
F
F
F
ADAM P
KDAM P
GDAM P
F
F
F
Notes:
ADAM P, KDAM P and GDAM P can take values between 0.0 and 1.0
Radiation dam ping is highly frequency dependent and scale factors should be evaluated according to
fundam ental frequency of the soil structure system .
68
19j.
Longitudinal Strength Degradation Parameters (only if ILOSA > 0), see Appendix A.
19k.
Longitudinal Stiffness Degradation Parameters (only if IHYSTA > 0), see Appendix B.
19l.
19m.
Normal Stiffness Degradation Parameters (only if IHYSTK > 0), see Appendix B.
19n.
Shear Strength Degradation Parameters (only if ILOSG > 0), see Appendix A.
19o.
Shear Stiffness Degradation Parameters (only if IHYSTG > 0), see Appendix B.
19p.
This option allows different sections to have their own values of ALPHA and BETA for Rayleigh Dam ping. This
is useful if one is m odelling a pounding study between two adjoining buildings where the buildings have different
dam ping characteristics or where different parts of the system have different dam ping characteristics, i.e. in soilstructure interaction studies. Dam ping m atrix C is given by
where M = Mass,
BETA0 BETAT
BETA0
BETAT
ALPHA
ALPHA
69
F
F
F
20
M ulti-Spring Element
If the Bi-Linear with Slackness hysteresis rule is used, then this elem ent will becom e unstable if the whole
elem ent goes into tension. This is because the elem ent has no stiffness if all the m ulti-springs have positive
(tensile) displacem ents. To prevent this instability a com pressive force should be im posed across the m em ber
either by loads applied to the structure or by other prestressed m em bers acting across the m em ber.
The individual springs m aking up the m ulti-spring m em ber have a sign convention where tensile deform ations
and forces are positive.
In all available hysteresis m odels for this elem ent there is no further hysteresis data that is required. If the Bilinear with Gap hysteresis is used then the initial tension gap is set to 10 tim es the height (width) HS of the
elem ent and the com pression gap is zero.
If the Bi-linear with Gap hysteresis is used with the Lift-off option then if all axial springs lift off then all the shear
and rotational springs also disconnect so that their actions and stiffness go to zero.
70
20a.
Control Parameters.
IHYST
ILOS
IHYST
KLOS
IDAM G
HS
W GT
THETA SL
=0
Linear Elem ent
=1
Bi-linear with Gap Hysteresis
(see IHYST = 5)
=2
Bi-linear Hysteresis
(see IHYST = 2)
=3
Ram berg-Osgood Hysteresis (Original)
(see IHYST = 3)
=4
Ram berg-Osgood Hysteresis (Bounded)
(see IHYST = 40)
=5
Ram berg-Osgood Hysteresis (Pyke)
(see IHYST = 41)
=6
Origin Centered Hysteresis
(see IHYST = 38)
=7
Bi-linear Elastic Hysteresis
(see IHYST = 15)
=8
Bi-linear with gap lift-off disconnects shear
(see IHYST = 5)
=9
Bi-linear Elastic with Gap
(see IHYST = 63)
=0
No Longitudinal Strength Degradation
= 1 to 7 Longitudinal Strength Degradation
=0
No Shear Strength Degradation
= 1 to 7 Shear Strength Degradation
=0
No Dam age Indices calculated
=m
Dam age Indices com puted with weight m (note: m =1 gives average)
Height of Multi-Spring m em ber
W eight of Multi-Spring m em ber
Angle between Global X and Local x axes (Degrees)
Shift of position of Transverse Spring(-0.5 # SL # 0.5))
(0.0 im plies that the Transverse Spring is located m idway between Nodes 3 and 4
where SL = -0.5 m oves spring to Node 4 and +0.5 m oves spring to Node 4)
ILOS
KLOS
IDAM G
HS
W GT
THETA
SL
I
I
I
F
F
F
F
Note:
The THETA term is only used for zero length mem bers. In all other cases the local axial or longitudinal
axis is defined as being along the m em ber length.
The IHYST in the notes above refers to the Appendices A and B covering the hysteresis m odels
The transverse spring will generate m om ents at Nodes 3 and 4 by rigid lever arm s whose length will
depend on the length of the m em ber and the param eter SL
If the m odel has gap, tension gap=HS, com pression gap=0.0
20b.
Section Properties.
NS
NS
ITYPE
SA
SV
YT
YC
YP
YN
RA
RV
Note:
ITYPE
SA
SV
YT
YC YP
YN
RA
RV
71
I
I
F
F
F
F
F
F
F
F
20c.
Longitudinal Strength Degradation Parameters (only if ILOS > 0), see Appendix A.
20d.
20e.
This option allows different sections to have their own values of ALPHA and BETA for Rayleigh Dam ping. This
is useful if one is m odelling a pounding study between two adjoining buildings where the buildings have different
dam ping characteristics or where different parts of the system have different dam ping characteristics, i.e. in soilstructure interaction studies. Dam ping m atrix C is given by
where M = Mass,
BETA0 BETAT
BETA0
BETAT
ALPHA
20f.
ALPHA
F
F
F
M UX+
M UXM UY+
M UYM UR+
M URBETA1
BETA2
F
F
F
F
F
F
F
F
72
21
The individual springs, dashpots or tendons m aking up the com pound-spring m em ber have a sign convention
where tensile deform ations and forces are positive.
If the Interaction option is used for a com ponent then if the longitudinal (local x stiffness goes to zero) the
com ponent will disconnect until the axial stiffness again takes a non-zero value. This is sim ilar to the lift-off
option with the Multi-spring elem ent.
73
21a.
NS
Control Parameters.
JPLAS
W GT
THETA
NS
JPLAS
SL
W GT
THETA
Note:
SL
I
I
F
F
F
The THETA term is only used for zero length mem bers. In all other cases the local axial or longitudinal
axis is defined as being along the m em ber length.
The transverse dashpot will generate m om ents at Nodes 3 and 4 by rigid lever arm s whose length will
depend on the length of the m em ber and the param eter SL
JPLAS is usually going to be 1 but this gives the ability for the m em ber data for a non-linear m em ber
to be input but then the action is reset to linear.
Note sections 21b, 21c and 21d are required for each of the NS com ponents. Sections 21c and 21d, if required
m ust follow 21b for each com ponent in turn.
21b.
Section Properties.
ITYPE
ITYPE
IM ODE
IHYST
ILOS
INTER
Y
ST
RA
YP
YN
IM ODE
IHYST
ILOS
INTER
Y ST
RA
YP
YN
=1
Longitudinal action
(local x direction)
=2
Transverse action
(local y direction)
=3
Rotational action
(local theta z axis)
=1
Spring com ponent
=2
Dashpot com ponent
=3
Tendon com ponent with force depending on sign of displacem ent
=4
Tendon com ponent with force depending on sign of velocity
Hysteresis rule. (For spring com ponents see appendix B)
(for other com ponents = 0 )
Strength Degradation rule. (For spring com ponents see appendix A )
(for other com ponents = 0 )
=0
No interaction between longitudinal and transvere/rotational action
=1
If axial contribution is zero all com ponents disconnect
Distance of com ponent from centre-line of m em ber (line of Nodes 3 and 4)
(For transverse and rotational com ponents ITYPE = 2 or 3, reset to 0.0)
Stiffness or dam ping coefficient of Com ponent (For IM ODE = 3 or 4 use 0.0)
Bi-linear factor for Spring com ponent
(for other com ponent types use 0.0)
For Spring m em bers
(IM ODE = 1)
= Yield Force (Positive)
For Dashpots
(IM ODE = 2)
= Lim it Force in positive direction
For Tendons
(IM ODE = 3)
= Force if displacem ent is positive
For Tendons
(IM ODE = 4)
= Force if velocity is positive
For Spring m em bers
(IM ODE = 1)
= Yield Force (Negative)
For Dashpots
(IM ODE = 2)
= Lim it Force in negative direction
For Tendons
(IM ODE = 3)
= Force if displacem ent is negative
For Tendons
(IM ODE = 4)
= Force if velocity is negative
74
I
I
I
F
F
F
F
Note:
For IM ODE = 3 or IM ODE = 4 if the displacem ent and the velocity are 0.0 the force in the tendon
com ponent is zero. These com ponents have no stiffness.
The dashpot com ponents IM ODE = 2 have no stiffness.
If IHYST > 0 and YP # 0.0 and YN $ 0.0 then the com ponent is elastic.
The choice of hysteresis rule for the spring com ponents are the sam e as that for SPRING m em bers.
21c.
Strength Degradation Parameters (only if IM ODE = 1 and ILOS > 0), see Appendix A.
21d.
Hysteresis Rule Data (only if IM ODE = 1 and IHYST > 0 and the rule required m ore data)
see Appendix B.
21e.
This option allows different sections to have their own values of ALPHA and BETA for Rayleigh Dam ping. This
is useful if one is m odelling a pounding study between two adjoining buildings where the buildings have different
dam ping characteristics or where different parts of the system have different dam ping characteristics, i.e. in soilstructure interaction studies. Dam ping m atrix C is given by
where M = Mass,
BETA0 BETAT
BETA0
BETAT
ALPHA
ALPHA
75
F
F
F
22
22a.
IH1 IH2
IH3 IDIAG
IH1
IH2
IH3
IDIAG
=
=
=
=
=
IL1
IL2
IL3
W GT
EM OD
=
=
=
=
=
(as
(as
(as
(as
required)
required)
required)
required)
see
see
see
see
see
see
section
section
section
section
section
section
21a.
21b.
21c.
21d.
21e.
21f.
W GT
I
I
I
I
I
I
I
F
F
Notes:
1.
IHi = 0 im plies elastic action
2.
Any of the hysteresis rules for SPRING elem ents are able to be used for this elem ent
3.
Any of the Strength Degradation rules allow for the hysteresis m odel m ay be used for the Truss
com ponents, except in Note 3 above.
4.
The weight is used to com pute the m em ber m ass and does not contribute to the static loads on the
m em ber or the structure.
5.
These truss com ponents do not contribute to the rotational stiffness of the nodes and therefore care m ust
be given to the boundary conditions to avoid a singular stiffness of the structure. All four nodes m ust be
distinct (i.e. no triangles).
6.
If Elastic m odulus EM OD is non-zero then K1-K6 on next line are taken as the truss cross-sectional
areas and the length of the struts used to com pute truss stiffness are com puted from elem ent geom etry.
76
22b.
K1 K2 K3 K4 K5 K6 R1 R2 R3 R4 R5 R6
K1
K2
K3
K4
K5
K6
R1
R2
R3
R4
R5
R6
=
=
=
=
=
=
=
=
=
=
=
=
area
area
area
area
area
area
of
of
of
of
of
of
Truss)
Truss)
Truss)
Truss)
Truss)
Truss)
F
F
F
F
F
F
F
F
F
F
F
F
Notes:
1.
Ki = 0 im plies truss not present. At least one truss m em ber m ust exist.
2.
Bi-linear factors only used for inelastic m em bers.
22c.
Truss Yield Properties (only required if IH1, IH2 or IH3 greater than 0)
YP1 YN1 YP2 YN2 YP3 YN3 YP4 YN4 YP5 YN5 YP6 YN6
YP1
YN1
YP2
YN2
YP3
YN3
YP4
YN4
YP5
YN5
YP6
YN6
=
=
=
=
=
=
=
=
=
=
=
=
Truss
Truss
Truss
Truss
Truss
Truss
Truss
Truss
Truss
Truss
Truss
Truss
1
1
2
2
3
3
4
4
5
5
6
6
(1-3)
(1-3)
(2-4)
(2-4)
(1-2)
(1-2)
(4-3)
(4-3)
(1-4)
(1-4)
(2-3)
(2-3)
Notes:
1.
If Ypi = 0.0 and Yni = 0.0 im plies truss i rem ains elastic.
2.
If the truss m em ber does not exist supply 0.0 for both yield forces.
77
F
F
F
F
F
F
F
F
F
F
F
F
22d.
P11 P21 P31 P41 P51 P12 P22 P32 P42 P52
P11
P21
P31
P41
P51
P12
P22
P32
P42
P52
=
=
=
=
=
=
=
=
=
=
Strength Change of
Residual Strength of
Strain at start reduction
Strain at Change of
Strain at Residual for
Strength Change of
Residual Strength of
Strain at start reduction
Strain at Change of
Strain at Residual for
Truss
Truss
Truss
Truss
Truss
Truss
Truss
Truss
Truss
Truss
1
1
1
1
1
2
2
2
2
2
(1-3)
(1-3)
(1-3)
(1-3)
(1-3)
(2-4)
(2-4)
(2-4)
(2-4)
(2-4)
[0.40]
[0.05]
[0.10]
[0.50]
[1.00]
[0.40]
[0.05]
[0.10]
[0.50]
[1.00]
F
F
F
F
F
F
F
F
F
F
Notes:
1.
The values in the square brackets are the default values, obtained by supplying 0.0.
2.
The sm allest value for the residual strength ratio is 0.01.
3.
A blank line cannot be supplied for this data to get the default values, at least a line with one 0.0 is
required. Note, in Ruaum oko a blank line is ignored by the com m and processor.
22e.
78
22f.
This option allows different sections to have their own values of ALPHA and BETA for Rayleigh Dam ping. This
is useful if one is m odelling a pounding study between two adjoining buildings where the buildings have different
dam ping characteristics or where different parts of the system have different dam ping characteristics, i.e. in soilstructure interaction studies. Dam ping m atrix C is given by
where M = Mass,
BETA0 BETAT
BETA0
BETAT
ALPHA
Note:
ALPHA
F
F
F
These elem ents m ay be considered as a form of Lattice Analogy as described by Hrennikoff in his 1941
paper. The elem ents m ay be arranged to provide an analogy to a problem in plane stress or plane strain.
Assum ing that the elem ent is square of side a in plan and that the m aterial has a thickness of t then
Hrennikoff would suggest that that
If the forces in the m em bers are F i then the equivalent stresses, assum ing that the local x axis is
parallel to m em bers 3 and 4, m ay be obtained from
Referece:
79
23
The individual springs, m aking up the Plastic Hinge m em ber have a sign convention where tensile
deform ations and forces are positive.
80
23a.
Control Parameters.
JPLAS
JPLAS
HL
W GT
THETA
ISTEEL
ICONC
=0
Mem ber linear
=1
Mem ber non-linear
W idth of Cross-section
Depth (Height) of Cross-section
Cover to reinforcing steel centre-line from top or bottom of section
Plastic Hinge Length
W eight of Reinforced Concrete Hinge m em ber
Angle between Global X and Local x axes (Degrees)
=0
Dhakal Steel hysteresis
=1
Dodd-Restrepo Steel hysteresis
=2
Elasto-Plastic Steel hysteresis
=0
Brian Peng Concrete hysteresis
=1
Crisafulli Concrete hysteresis
B
D
C
HL
W GT
THETA
ISTEEL
ICONC
I
F
F
F
F
F
F
I
Note:
The THETA term is only used for zero length mem bers. In all other cases the local axial or
longitudinal axis is defined as being along the mem ber length.
The transverse dashpot will generate m om ents at Nodes 3 and 4 by rigid lever arm s whose length is
half of the hinge length HL
JPLAS is usually going to be 1 but this gives the ability for the m em ber data for a non-linear m em ber
to be input but then the action is reset to linear.
23b.
EC
EC
FPC
FT
ECC
FPCC
FTC
ECV
FPCV
FTV
DB
FLEXV
Note:
FPC
FT
ECC
FPCC
FTC
ECV
FPCV
FTV
DB
FLEXV
F
F
F
F
F
F
F
F
F
F
F
There are 10 m ulti-spring-like elem ents representing the concrete cross-section representing the
longitudinal stress-strain behaviour in the hinge..
Spring 1 represents the top cover concrete and spring 10 represents the bottom cover concrete.
Springs 13 and 14 represent the diagonal concrete struts carrying the shear in the section.
Flexibility factor m ultiplies the flexibility in that direction by the factor to allow extra shear deform ation.
The stiffness of the diagonal struts are un-affected and the deform ation in the diagonal struts is the
total shear deform ation divided by the flexibility factor. The extra flexibility is obtained by added an
additional spring in series with the diagonal m em ber stiffness.
81
23c.
ES
ES
FSC
FST
Atop
Abtm
Slong
FSC
FST
Atop Abtm
Slong
F
F
F
F
F
F
Note:
Spring 11 represents the top reinforcing steel and spring 12 represents the bottom reinforcing steel.
23d.
This option allows different sections to have their own values of ALPHA and BETA for Rayleigh Dam ping.
This is useful if one is m odelling a pounding study between two adjoining buildings where the buildings have
different dam ping characteristics or where different parts of the system have different dam ping
characteristics, i.e. in soil-structure interaction studies. Dam ping m atrix C is given by
where M = Mass,
BETA0 BETAT
BETA0
BETAT
ALPHA
ALPHA
23e.
Hysteresis Rule Data for confined concrete (only if the hysteresis rule requires more data)
see Appendix B.
23f
Hysteresis Rule Data for cover concrete (only if the hysteresis rule requires more data)
see Appendix B.
23g
Hysteresis Rule Data for reinforcing steel (only if the hysteresis rule requires more data)
see Appendix B.
23h
Hysteresis Rule Data for shear concrete (only if the hysteresis rule requires more data)
see Appendix B.
82
F
F
F
24
Inertia Member
XM ASS YM ASS TM ASS
XM ASS
YM ASS
TM ASS
SL
THETA
SL THETA
F
F
F
F
Notes:
1.
Sign Conventions are the sam e as those for the SPRING m em ber types, see section 12.
2.
If the length of a INERTIA type m em ber is zero then the local X and Y axes coincide with the global
axes unless a non-zero value has been specified for THETA above.
3.
The m em ber only acts during a tim e-history analysis and the inertia force or m om ent is proportional
to the relative acceleration or relative rotational accelerations between the two ends, 3 and 4, of the
m em ber.
83
30
Except for a static analysis, this section M UST be supplied. If all structural m ass (weight) is supplied as
m em ber weights then follow the W EIGHTS flag with two lines of data in which only the node num bers
supplied, that for Node 1 and that for the last node.
W EIGHTS
W EIGHTS
INTERP
INTERP
W ord W EIGHTS
=
0;
Om itted Nodes have no point weight
=
1;
Om itted Nodes have weight of First Node in sequence repeated.
A
I
One input line is required for each nodal point. However, if any nodal points are om itted and INTERP above
is non-zero, the om itted nodes will be assum ed to have the sam e weights as those of the nodal point on the
previous input line. The inform ation for the last nodal point should be supplied. The nodal point num bers
m ust be provided in an ascending order. It m ust be noted that the nodal weights and that the self-weight
com puted from the m em ber weights are not added to the static load analysis.
N WX WY WM
N
WX
WY
WM
Note:
84
I
F
F
F
31
LOADS
N
FX
FY
FM
FX FY
FM
85
I
F
F
F
32
One set of data if IPVERT = -1, two sets if IPVERT = -2, etc.
One input line with the word SHAPE starting in colum n 1
SHAPE ALPHA
One input line is required for each loaded nodal point. The last nodal point should be provided even if no
loads are applied to it or a line with node num ber 0 will term inate the input.
The load com ponents will be m ultiplied by the loading, or excitation, history (see section 25). The first
com ponent is m ultiplied by the first excitation history and the second com ponent by the second excitation
history.
The units of these load shapes are force units.
This enables a m axim um of three com ponent loading, a constant static com ponent and two tim e-varying
com ponents
N
FX
FY
FM
FX FY
FM
I
F
F
F
If there is m ore than a single loading pattern repeat all of the above SHAPE data for the second loading
pattern
86
33.
The following set of input lines is required for each earthquake or dynam ic loading com ponent.
There is 1 com ponent if
IPVERT = -1, 0 or 1
There are n com ponents if
IPVERT = -n or n
For Earthquake Accelerogram s the com ponents act in the directions specified in the Earthquake
Transform ation m atrix supplied in section 2b of this m anual.
For Dynam ic loading patterns each com ponent m ultiplies each of the load vectors described under the
SHAPE data sets.
For Input Displacem ent Histories (IPANAL = 8 or 9) the excitations act at the degrees of freedom specified in
the Nodal Point Boundary Condition data. The displacem ent m ust be scaled, via the divisor ASCALE to have
the displacem ent units chosen for the structure.
EQUAKE
FILE
FILE
87
33b. Control parameters for Accelerogram, Displacem ent Time-History or Loading Time-History
IBERG
IBERG
ISTART
DELTAT
ASCALE
END
VEL
DIS
TSCALE
ISTART
DELTAT
= 0;
Excitation in BERG Form at
= 1;
Excitation in CALTECH Form at
= 2;
Excitation in NCEER Form at
= 3;
Excitation in FREE Form at (One point per line)
= 4;
Excitation in CSMIP Form at
= 5;
Excitation in EXCEL Form at
= 6,
Excitation in PEER Form at
= 7;
Excitation in SAC Form at
The num ber of the first line of the excitation that is to be used.
This is usually = 1 but by using greater values enables the start of the
record to be ignored. This line num ber is counted from the START line.
Excitation data interval
BERG Form at records = Tim e step at which the record will be digitized.
The default value is the tim e-step for the integration DT. This m ay
m ean large m em ory requirem ents for very sm all tim e-steps.
It is suggested that som ething of the order of 0.01 seconds be used
for m ost records is a larger interval is desired.
CALTECH Form at records the record tim e-interval
(usually 0.025, 0.02, 0.01 or 0.005 seconds)
NCEER Form at records the record tim e-interval
(usually 0.02 seconds)
FREE Form at records (see BERG Form at records)
CSMIP Form at records the record tim e-interval
(usually 0.02 seconds)
EXCEL Form at records (see BERG Form at records)
PEER Form at records the record tim e-interval
(usually 0.004 seconds)
SAC Form at records the record tim e-interval
(usually 0.020 seconds)
1/(Scale factor) for the record.
BERG, FREE or EXCEL Form at records om it or set equal to 1.0
CALTECH records are usually in units of acceleration m ultiplied by a constant
as the F6.0 form at is usually an Integer I6 form at and the decim al point is
m issing with about 5 integer digits for the largest num bers. The values m ust
be converted units of the acceleration of gravity . If the record is in the units
of m m /sec/sec and if g = 9.81 m /sec/sec. then ASCALE = 9810.0.
NCEER and CSMIP records are usually in cm /sec/sec and ASCALE = 981.0
to bring the record to units of the acceleration of gravity.
Determ ines action if End-of-File is found before spanning duration of
excitation, DUR in line 3 of the data (Fram e Control Param eters).
=0 ;
End of File im plies data error
= -1 ; Any m issing part of record is padded with zero values
= T ; After T seconds record is set to zero. Allows for a free vibration of
TIM E-T seconds at the end of the earthquake excitation.
Initial Ground Velocity (Default = 0.0)
Added to all degrees of freedom at beginning of Tim e-history analysis for
earthquake analysis only. Only im portant in travelling wave analyses or where
total instead of relative displacem ents are being used
Initial Ground Displacem ent (Default = 0.0)
Added to all degrees of freedom at beginning of Tim e-history analysis for
earthquake analysis only. (Not norm ally of any im portance to the analysis)
Tim e scale for the record (Default = 1.0)
The tim es im plied in the record are effectively divided by TSCALE. If
TSCALE = 2.0 then if the duration of the analysis is 10 seconds at least
20 seconds of excitation m ust be provided unless END = -1
88
The rest of the input for the accelerogram (sections 33c and 33d) is in the Accelerogram File, the
Displacem ent History File or the Force History File specified by the user in the initial file nam e prom pts at the
beginning of the program execution or on the line with the word EQUAKE. The default response is that the
accelerogram s, or excitation is appended to the above data file.
33c. Accelerogram , Displacem ent History or Load-History flag. This line is the start of the accelerogram etc.
for all but the PEER or SAC form at records.
The PEER form at records are preceded by 4 lines of header inform ation and this START line is not required.
The SAC form at records are preceded by 2 lines of header inform ation and this START line is not required
One input line with the word STAR, START or DATA: (the colon is m andatory) starting in colum n 1 and the
word must be in upper case. This line m ay be preceded by as m any header lines as desired.
START
89
(1)
BERG FORMAT
ISEQ
ISEQ
Ti
Gi
(I3,4(F8.4,F9.6))
T1 G1 T2 G2 T3 G3 T4 G4
I3
F 8.4
F 9.6
If the line sequence num ber is greater than 999 it is not read or checked by the program .
(2)
.eqc)
ISEQ
ISEQ
Gi
CALTECH FORMAT
G1 G2 G3 G4 G5 G6 G7 G8 G9 G10
I4
I6
If the line sequence num ber is greater than 9999 it is not read or checked by the program .
(3)
NCEER FORMAT
(10F8.2)
G1 G2 G3 G4 G5 G6 G7 G8 G9 G10
Gi
(4)
FREE FORMAT
ISEQ
ISEQ
T1
G1
(*)
F 8.2
T1 G1
I
F
F
The three item s m ay be placed anywhere on the line and separated by at least one blank colum n or a
com m a. The lines m ust be in consecutive order with ISEQ starting at 1 and increasing line by line. This
form at is particularly useful where the excitation record has been generated on a spreadsheet. It is, however,
not as com pact a form at as the NCEER form at.
90
91
(5)
CSM IP FORMAT
(8F10.3)
G1 G2 G3 G4 G5 G6 G7 G8
Gi
(6)
EXCEL FORMAT
(*)
F 10.3
T1 G1
T1
G1
F
F
The two item s m ay be placed anywhere on the line and separated by at least one blank colum n or a com m a.
The tim es MUST be in ascending order but do not have to be at equal intervals. This form at is particularly
useful where the excitation record has been generated on a spreadsheet. It is, however, not as com pact a
form at as the NCEER form at.
(7)
PEER FORMAT
(5E15.7)
G1 G2 G3 G4 G5
Gi
E 15.7
Note DELTAT is usually 0.004 seconds. The records are usually in the units of acceleration of gravity.
(8)
SAC FORMAT
(6E13.5)
G1 G2 G3 G4 G5 G6
Gi
E 13.5
Note DELTAT is usually 0.020 seconds. The records are usually in the units of acceleration of gravity.
92
34.
(Only if IPANAL = 7)
The following set of input lines is required for the required displacem ent history. This displacem ent history
acts as a control on the displacem ent at the node and direction specified on line 34b.
EQUAKE
FILE
FILE
NSTEP NODE
NSTEP
NODE
NDOF
SCALE
IPRINT
NDOF
SCALE IPRINT
93
I
I
A
F
I
The rest of the input for the accelerogram (sections 34c and 34d) is in the Displacem ent-History File the
nam e of which is specified by the user in the initial file nam e prom pts at the beginning of the program
execution. The default response is that the accelerogram s, or excitation is appended to the above data file.
START
Di
94
35.
The following set of input lines is required for the acceleration response spectra. These spectral accelerations
are assum ed to apply to the base of the structure and will apply to all earthquake excitation directions as
specified by the param eter IPVERT in line 2 of the data set.
SPECTRA
FILE
FILE
NSTEP IPRINT
NSTEP
IPRINT
ISAM E
ICOM B
SDAM P
I
I
I
I
Notes: The Acceleration Response Spectra are supplied in the units of Acceleration of Gravity (g). The
response spectra are then m ultiplied by the gravitational constant GRAV supplied in line 3 of the data
set.
The spectra are supplied in the following section with one line required for each natural period of freevibration. The first line m ust be for the zero natural period of free-vibration. The total num ber of lines
is NSTEP.
In the response spectra calculations if the natural period of a m ode is greater than the value of the
NSTEPth natural period the spectral acceleration is assum ed to rem ain constant for all greater
natural periods.
95
The rest of the input for the response spectra (sections 35c and 35d) is in the Response Spectra File the
nam e of which is specified by the user in the first excitation file nam e prom pt at the beginning of the program
execution. The default response is that the spectra is appended to the data file following lines 26a and 26b
above.
START
T(I)
T(i)
SA(i,1)
SA(i,2)
SA(i,1)
SA(i,2)
End
96
*
*
*
97