Skip to content

Commit f3cefcf

Browse files
fmckennafmckenna
committed
fmk - adding dispBeamColumn
1 parent 1f31869 commit f3cefcf

File tree

3 files changed

+94
-3
lines changed

3 files changed

+94
-3
lines changed

‎source/user/manual/model/element.rst‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,12 +54,12 @@ The following subsections contain information about **$eleType** and the number
5454
:maxdepth: 1
5555

5656
elements/elasticBeamColumn
57+
elements/dispBeamColumn
58+
elements/forceBeamColumn
5759
elements/ModElasticBeam
5860
elements/ElasticBeamColumnElementWithStiffnessModifiers
5961
elements/ElasticTimoshenkoBeamColumnElement
6062
elements/BeamWithHingesElement
61-
elements/dispBeamColumn
62-
elements/forceBeamColumn
6363
elements/gradientInelasticBeamColumn
6464
elements/FlexureShearInteractionDisplacementBasedBeamColumnElement
6565
elements/MVLEM

‎source/user/manual/model/elements/dispBeamColumn.rst‎

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
.. _dispBeamColumn:
2+
3+
4+
Displacement-Based Beam Column
5+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
6+
7+
This command is used to construct a displacementBeamColumn element object. A variety of numerical integration options are available for the element state determination and encompass both distributed plasticity and pla\
8+
stic hinge integration, see :ref:`beamIntegration` options. The element if formulated in a basic system, given by its end rotations and axial deformation. The geometric transformation between this basic system and the 2d or 3d system comprisomg nodal displacements and rotations, is provided by the geometric transformation, see :ref:`geomTransf` options.
9+
10+
.. note::
11+
12+
The displacement based beam column element uses shape functions to determine the displacement field along the element length. This is typical formulation used for elements in the finite element method. As a consequence, section forces satisfy weak-equilibrium with element end forces. For a discussion on the consequences of weak equilibrium and of the differences between **displacement** based beam column element and the **force** based element see `this post on portwooddigital <https://portwooddigital.com/2020/02/23/a-tale-of-two-element-formulations/>`_
13+
14+
.. tabs::
15+
16+
.. tab:: Tcl
17+
18+
.. function:: element dispBeamCoumn $eleTag $iNode $jNode $transfTag $integrationTag <-mass $mass>
19+
20+
.. csv-table::
21+
:header: "Argument", "Type", "Description"
22+
:widths: 10, 10, 40
23+
24+
"$eleTag", "|integer|", "Unique element object tag"
25+
"$iNode", "|integer|", "tag of the iNode"
26+
"$jNode", "|integer|", "tag of the jNode"
27+
"$transfTag", "|integer|", "tag of the geometric transformation object"
28+
"$integrationTag", "|integer|", "tag of the beam integration object"
29+
"$maxIter", "|integer|", "max number of iterations, default = 10"
30+
"$tol", "|float|", "tolerance, default = 1.0e-12"
31+
"$mass", "|float|", "Element mass per unit length, default = 0.0"
32+
33+
.. tab:: OpenSeesPy
34+
35+
.. function:: element('dispBeamColumn',eleTag,*eleNodes,transfTag,integrationTag,'-cMass','-mass',mass=0.0)
36+
37+
======================== =============================================================
38+
``eleTag`` |int| tag of the element
39+
``eleNodes`` |listi| a list of two element nodes
40+
``transfTag`` |int| tag of transformation
41+
``integrationTag`` |int| tag of :func:`beamIntegration`
42+
``'-cMass'`` to form consistent mass matrix (optional, default = lumped mass matrix)
43+
``mass`` |float| element mass density (per unit length), from which a lumped-mass matrix is formed (optional)
44+
======================== =============================================================
45+
46+
.. note::
47+
48+
The valid queries to an elastic beam-column element when creating an ElementRecorder object are:
49+
50+
#. force or globalForce
51+
52+
#. localForce
53+
54+
#. basicForce
55+
56+
#. section $sectionNumber $arg1 $arg2 ... (note: $sectionNumer is integer 1 through $numIntegrPts)
57+
58+
#. basicDeformation
59+
60+
#. plasticDeformation
61+
62+
#. inflectionPoint
63+
64+
#. tangentDrift
65+
66+
#. integrationPoints
67+
68+
#. integrationWeights
69+
70+
71+
72+
References
73+
----------
74+
75+
.. [1] Neuenhofer, Ansgar, FC Filippou. Geometrically Nonlinear Flexibility-Based Frame Finite Element. ASCE Journal of Structural Engineering, Vol. 124, No. 6, June, 1998. ISSN 0733-9445/98/0006-0704-0711. Paper 16537. pp. 704-711.
76+
77+
.. [2] Neuenhofer, Ansgar, FC Filippou. Evaluation of Nonlinear Frame Finite-Element Models. ASCE Journal of Structural Engineering, Vol. 123, No. 7, July, 1997. ISSN 0733-9445/97/0007-0958-0966. Paper No. 14157. pp. 958-966.
78+
79+
.. [3] Neuenhofer, Ansgar, FC Filippou. ERRATA -- Geometrically Nonlinear Flexibility-Based Frame Finite Element. ASCE Journal of Structural Engineering, Vol. 124, No. 6, June, 1998. ISSN 0733-9445/98/0006-0704-0711. Paper 16537. pp. 704-711.
80+
81+
.. [4] Taucer, Fabio F, E Spacone, FC Filippou. A Fiber Beam-Column Element for Seismic Response Analysis of Reinforced Concrete Structures. Report No. UCB/EERC-91/17. Earthquake Engineering Research Center, College of Engineering, University of California, Berkeley. December 1991.
82+
83+
.. [5] Spacone, Enrico, V Ciampi, FC Filippou. A Beam Element for Seismic Damage Analysis. Report No. UCB/EERC-92/07. Earthquake Engineering Research Center, College of Engineering, University of California, Berkeley. August 1992.
84+
85+
86+
87+

‎source/user/manual/model/elements/forceBeamColumn.rst‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,11 @@ Force-Based Beam Column
55
^^^^^^^^^^^^^^^^^^^^^^^
66

77
This command is used to construct a forceBeamColumn element object, which is based on the iterative force-based formulation. A variety of numerical integration options are available for the element state determination and encompass both distributed plasticity and pla\
8-
stic hinge integration, see :ref:`beamIntegration` options. The element if formulated in a basic system, given by its end rotations and axial deformation. The geometric transformation between this basic system and the 2d or 3d system comprisomg nodal displacements and rotations, is provided by the geometric transformation, see :ref:`geomTransf` ooptions.
8+
stic hinge integration, see :ref:`beamIntegration` options. The element if formulated in a basic system, given by its end rotations and axial deformation. The geometric transformation between this basic system and the 2d or 3d system comprisomg nodal displacements and rotations, is provided by the geometric transformation, see :ref:`geomTransf` options.
9+
10+
.. note::
11+
12+
Force based elements use known equilibrium along the element length to determine section forces. As a consequence, in a finite element setting the element must iterate given nodal displacements at each trial step to determine the section deformations at the integration points to cause such. For a discussion of differences between **force** based beam column element and the **displacement** based element see `this post on portwooddigital <https://portwooddigital.com/2020/02/23/a-tale-of-two-element-formulations/>`_
913

1014
.. tabs::
1115

0 commit comments

Comments
 (0)