ZeroLengthImpact3D

• 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 constructs a node-to-node zero-length contact element in 3D space.

element zeroLengthImpact3D $tag $slaveNode $masterNode $direction $initGap $frictionRatio $Kt $Kn $Kn2 $Delta_y $cohesion

---

$tag	Unique element object tag
$slaveNode	Slave node tag
$masterNode	Master node tag
$direction	1 if normal vector of master plane points to +X direction 2 if normal vector of master plane points to +Y direction 3 if normal vector of master plane points to +Z direction
$initGap	Initial gap between master plane and slave plane
$frictionRatio	Friction ratio
$Kt	Penalty in tangential directions (parallel to master and slave planes)
$Kn	Penalty in normal direction (normal to master and slave planes)
$Kn2	Penalty in normal direction after yielding based on Hertz impact model
$Delta_y	Yield deformation based on Hertz impact model
$cohesion	Cohesion, if no cohesion, it is zero

---

NOTES:

1. This element has been developed on top of the “zeroLengthContact3D”. All the notes available in “zeroLengthContact3D” wiki page would apply to this element as well. It includes the definition of master and slave nodes, the number of degrees of freedom in the domain, etc.
2. This element adds the capabilities of “ImpactMaterial” to “zeroLengthContact3D”, without the need for extra nodes and elements in the modeling process. That is the capability of having an initial gap in the normal direction and also the capability of considering energy dissipation due to pounding/impact in the normal direction.
3. For simulating a surface-to-surface contact, this element can be defined for connecting the nodes on master surface to the nodes on slave surface.

---

REFERENCES: zeroLengthContact3D , ImpactMaterial

---

Code Developed by: Dr. A.E. Zaghi, M. Cashany @ University of Connecticut (UConn)

---

---

APPLICATION:

1. This element has been employed to simulate the bridge hinge movements like superstructure-abutment interaction in bridges at University of Connecticut (UConn) and University of Nevada, Reno (UNR). This element was found to be fast-converging and eliminating the need for extra elements and nodes in the modeling process.

---

EXAMPLE SCRIPT: The following zip file contains an example script and the corresponding input cyclic displacement:

File:ExampleScript.zip