BeamContact3D

From OpenSeesWiki
Revision as of 03:25, 8 March 2011 by Mcganncr (talk | contribs)
Jump to navigation Jump to search




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