BeamEndContact3D

• 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 BeamEndContact3D element object.

element BeamEndContact3D $eleTag $iNode $jNode $sNode $lNode $radius $gTol $fTol <$cFlag$>

$eleTag	unique integer tag identifying element object
$iNode	master node from the beam
$jNode	the remaining node on the beam element with $iNode
$sNode	slave node
$lNode	Lagrange multiplier node
$radius	radius of circular beam associated with beam element
$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 BeamEndContact3D element is a node-to-surface contact element which defines a normal contact interface between the end of a beam element and a separate body. The first master node ($iNode) is the beam node which is at the end of the beam (i.e. only connected to a single beam element), the second node ($jNode) is the remaining node on the beam element in question. 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.

The BeamEndContact3D element enforces a contact condition between a fictitious circular plane associated with a beam element and a node from a second body. The normal direction of the contact plane coincides with the endpoint tangent of the beam element at the master beam node ($iNode). The extents of this circular plane are defined by the radius input parameter. The master beam node can only come into contact with a slave node which is within the extents of the contact plane. There is a lag step associated with changing between the 'in contact' and 'not in contact' conditions.

This element was developed for use in establishing a contact condition for the tip of a pile modeled as using beam elements and the underlying soil elements in three-dimensional analysis.

NOTE:

1. The BeamContact3D element does not use a material 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. masterforce - returns the reactions (forces and moments) acting on the master node.
3. The BeamEndContact3D element works well in static analysis situations. Extension to transient analysis is underway.

EXAMPLE: BeamEndContact3D element with tag 1, and connectivity with nodes 1, 2, 3, and 4

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

---

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

---