BeamContact3D

• Command_Manual
  • Tcl Commands
  • Modeling_Commands
    • model
    • uniaxialMaterial
    • ndMaterial
    • frictionModel
    • section
    • geometricTransf
    • element
    • node
    • sp commands
      • fix
      • fixX
      • fixY
      • fixZ
    • mp commands
      • equalDOF
      • rigidDiaphragm
      • rigidLink
    • timeSeries
    • pattern
    • mass
    • block commands
      • block2D
      • block3D
    • region
    • rayleigh
  • Analysis Commands
    • constraints Command
    • numberer Command
    • system Command
    • test Command
    • algorithm Command
    • integrator Command
    • analysis Command
    • eigen Command
    • analyze Command
  • Output Commands
    • recorder
    • record
    • print
    • printA
    • logFile
    • RealTime_Output_Commands
  • Misc Commands
    • eleResponse Command
    • getTime Command
    • getEleTags Command
    • getNodeTags
    • loadConst Command
    • nodeCoord Command
    • nodeDisp Command
    • nodeVel Command
    • nodeAccel Command
    • nodeEigenvector Command
    • nodeBounds
    • print Command
    • remove Command
    • reset Command
    • testIter
    • testNorms
    • wipe Command
    • exit Command
  • DataBase Commands
    • Template:DataBaseCommandsMenu

---

This command is used to construct a BeamContact3D element object.

element BeamContact3D $eleTag $iNode $jNode $sNode $lNode $radius $crdTransf $matTag $gTol $fTol <$cFlag$>

$eleTag	unique integer tag identifying element object
$iNode $jNode	master nodes (-ndm 3 -ndof 6)
$sNode	slave node (-ndm 3 -ndof 3)
$lNode	Lagrange multiplier node (-ndm 3 -ndof 3)
$radius	constant radius of circular beam associated with beam element
$crdTransf	unique integer tag associated with previously-defined geometricTransf object
$matTag	unique integer tag associated with previously-defined nDMaterial object
$gTol	gap tolerance
$fTol	force tolerance
$cFlag	optional initial contact flag
	$cFlag = 0 >> contact between bodies is initially assumed (DEFAULT)
	$cFlag = 1 >> no contact between bodies is initially assumed

---

The BeamContact3D element is a three-dimensional beam-to-node contact element which defines a frictional contact interface between a beam element and a separate body. The master nodes (6 DOF) are the endpoints of the beam element, and the slave node (3 DOF) is a node from a second body. The Lagrange multiplier node (3 DOF) is required to enforce the contact condition. Each contact element should have a unique Lagrange multiplier node. The Lagrange multiplier node should not be fixed, otherwise the contact condition will not work.

NOTE:

1. The BeamContact3D element has been written to work exclusively with the ContactMaterial3D nDMaterial object.
2. The valid recorder queries for this element are:
   1. force - returns the contact force acting on the slave node in vector form.
   2. frictionforce - returns the frictional force acting on the slave node in vector form.
   3. forcescalar - returns the scalar magnitudes of the single normal and two tangential contact forces.
   4. masterforce - returns the reactions (forces only) acting on the master nodes.
   5. mastermoment - returns the reactions (moments only) acting on the master nodes.
   6. masterreaction - returns the full reactions (forces and moments) acting on the master nodes.
   7. The BeamContact3D elements are set to consider frictional behavior as a default, but the frictional state of the BeamContact3D element can be changed from the input file using the setParameter command. When updating, value of 0 corresponds to the frictionless condition, and a value of 1 signifies the inclusion of friction. An example command for this update procedure is provided below
3. The BeamContact3D element works well in static analysis situations. Extension to transient analysis is underway.

EXAMPLE:

BeamContact3D element with tag 1, connectivity with nodes 1, 2, 3, and 4, geomTransf object with tag 1, and material with tag 1

element BeamContact3D 1  1 2 3 4  0.25  1 1  1.0e-10 1.0e-10 0

Update all of the BeamContact3D elements with tags between 10 and 20 to consider a frictionless interface

setParameter -value 0 -eleRange 10 20 friction

---

Code Developed by: Kathryn Petek, Pedro Arduino, & Peter Mackenzie-Helnwein, at the University of Washington

---