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
$sNode	slave node
$lNode	Lagrange multiplier node
$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 are the endpoints of the beam element, and the slave node is a node from a second body. The Lagrange multiplier node is required to enforce the contact condition. This node should not be shared with any other element in the domain.

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

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

---