fmk - adding forceBEamCol command

Author: fmckenna

source/user/manual/model/beamIntegration.rst

@@ -3,7 +3,7 @@
 Beam integration Command
 ************************
 
-This command is used to construct an element and add it to the Domain. 
+This command is used to construct an integration object for certain beam elements. A wide range of numerical integration options are available in OpenSees to represent either distributed plasticity or concentrated plasticity.
 
 .. function:: beamIntegration $integtaionType $tag $arg1 ...
 
@@ -19,8 +19,6 @@ Following are beamIntegration types available in the OpenSees:
 
 1. Integration Methods for Distributed Plasticity. Distributed plasticity methods permit yielding at any integration point along the element length.
 
-1. Zero-Length Elements
-
 .. toctree::
    :maxdepth: 4
 

source/user/manual/model/element.rst

@@ -58,8 +58,8 @@ The following subsections contain information about **$eleType** and the number
    elements/ElasticBeamColumnElementWithStiffnessModifiers
    elements/ElasticTimoshenkoBeamColumnElement
    elements/BeamWithHingesElement
-   elements/DisplacementBasedBeamColumnElement
-   elements/ForceBasedBeamColumnElement
+   elements/dispBeamColumn
+   elements/forceBeamColumn
    elements/gradientInelasticBeamColumn   
    elements/FlexureShearInteractionDisplacementBasedBeamColumnElement
    elements/MVLEM

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

@@ -0,0 +1,84 @@
+.. _forceBeamColumn:
+
+
+Force-Based Beam Column
+^^^^^^^^^^^^^^^^^^^^^^^
+
+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\
+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.  
+
+.. tabs::
+
+  .. tab:: Tcl
+
+     .. function:: element forceBeamCoumn $eleTag $iNode $jNode $transfTag $integrationTag <-iter $maxIter $tol>  <-mass $mass> 
+
+     .. csv-table::
+	:header: "Argument", "Type", "Description"
+	:widths: 10, 10, 40
+
+		 "$eleTag",       "|integer|", "Unique element object tag"
+		 "$iNode", "|integer|", "tag of the iNode"
+		 "$jNode", "|integer|", "tag of the jNode"		 
+		 "$transfTag",    "|integer|",   "tag of the geometric transformation object"
+		 "$integrationTag", "|integer|",   "tag of the beam integration object"
+		 "$maxIter",        "|integer|",   "max number of iterations, default = 10"
+		 "$tol",            "|float|",   "tolerance, default = 1.0e-12"
+		 "$mass",           "|float|", "Element mass per unit length, default = 0.0"
+		    
+  .. tab:: OpenSeesPy
+
+     .. function:: element('forceBeamColumn',eleTag,*eleNodes,transfTag,integrationTag,'-iter',maxIter=10,tol=1e-12,'-mass',mass=0.0)
+
+     ========================   =============================================================
+     ``eleTag`` |int|           tag of the element
+     ``eleNodes`` |listi|       a list of two element nodes
+     ``transfTag`` |int|        tag of transformation
+     ``integrationTag`` |int|   tag of :func:`beamIntegration`
+     ``maxIter`` |int|          maximum number of iterations to undertake to satisfy element compatibility (optional)
+     ``tol`` |float|            tolerance for satisfaction of element compatibility (optional)
+     ``mass`` |float|           element mass density (per unit length), from which a lumped-mass matrix is formed (optional)
+     ========================   =============================================================
+
+.. note::
+
+   The valid queries to an elastic beam-column element when creating an ElementRecorder object are:
+   
+   #. force or globalForce
+      
+   #. localForce
+      
+   #. basicForce
+      
+   #. section $sectionNumber $arg1 $arg2 ... (note: $sectionNumer is integer 1 through $numIntegrPts)
+      
+   #. basicDeformation
+      
+   #. plasticDeformation
+      
+   #. inflectionPoint
+      
+   #. tangentDrift
+      
+   #. integrationPoints
+      
+   #. integrationWeights
+
+
+
+References
+----------
+
+.. [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.
+       
+.. [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.
+      
+.. [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.
+
+.. [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.
+
+.. [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.
+
+
+
+      

source/user/manual/modelCommands.rst

@@ -23,7 +23,7 @@ In OpenSees there are commands to add each of these types of objects to a domain
    material/ndMaterial
    section
    model/geomTransf
-   model/beamIntegrations   
+   model/beamIntegration
    model/element
    model/timeSeries
    model/pattern