Adams Basic Package > Adams View > View Command Language > force > force modify element_like beam

force modify element_like beam

Allows modification of the beam object.

Format:

 
force modify element_like beam
beam_name =
beam1
new_beam_name =
beam2
Adams_id =
integer
ixx=
real number
iyy =
real number
izz=
real number
y_shear_area_ratio=
real number
z_shear_area_ratio=
real number
youngs_modulus =
real number
shear_modulus =
real number
length =
real number
area_of_cross_section =
real number
damping_ratio =
real number
matrix_of_damping_terms =
a 6x6 matrix
i_marker_name =
existing_marker_name
j_marker_name =
existing_marker_name

Example:

 
force modify element_like beam &
beam_name =
beam1 &
new_beam_name =
beam2 &
Adams_id =
1 &
ixx =
4 &
iyy =
2 &
izz =
3 &
y_shear_area_ratio =
0.9 &
z_shear_area_ratio =
0.8 &
youngs_modulus =
0.4&
shear_modulus =
0.2 &
length =
2 &
area_of_cross_section =
1.5 &
damping_ratio =
2 &
matrix_of_damping_terms =
a 6x6 matrix &
i_marker_name =
marker_1 &
j_marker_name =
marker_2

Description:

 
Parameter
Value Type
Description
beam_name
An Existing Beam
Specifies the name of the new beam. You may use this name later to refer to this beam.
new_beam_name
A New Beam
Specifies the name of the new beam. You may use this name later to refer to this beam. Adams View will not allow you to have two beams with the same full name, so you must provide a unique name.
Adams_id
Integer
Specifies an integer used to identify this element in the Adams data file.
comments
String
Specifies comments for the object being created or modified.
ixx
Area_inertia
Specifies the polar area moment of inertia about the X axis of a cross section perpendicular to the length of the beam.By definition, the beam lies along the positive X axis of the J marker. You should compute IXX about the X axis of the J marker.
Iyy
Area_inertia
Specifies the principal area moment of inertia about the Y axis of a cross section perpendicular to the length of the beam. By definition, the beam lies along the positive X axis of the J marker. You should compute IYY about the Y axis of the J marker.
Izz
Area_inertia
Specifies the principal area moment of inertia about the Z axis of a cross section perpendicular to the length of the beam. By definition, the beam lies along the positive X axis of the J marker. You should compute IZZ about the Z axis of the J marker.
y_shear_area_ratio
Real
Specifies the shear area ratio in the y direction.
z_shear_area_ratio
Real
Specifies the shear area ratio in the z direction.
youngs_modulus
Pressure
Specifies Young's modulus of elasticity for the beam material.
shear_modulus
Pressure
Specifies the shear modulus of elasticity for the beam material.
length
Length
Specifies the undeformed length of the beam along the x axis of the J marker.
area_of_cross_section
Area
Specifies the uniform area of the beam cross section. The centroidal axis must be orthogonal to this cross section.
damping_ratio
Time
Specifies a ratio for calculating the structural damping matrix for the beam. Adams multiplies the stiffness matrix by the value of DAMPING_RATIO to obtain the damping matrix.
matrix_of_damping_terms
Real
Specifies a six-by-six structural damping matrix for the beam.
i_marker_name
An Existing Marker
Specifies a marker on the first of two parts connected by this force element. Adams View connects this element to one part at the I marker and to the other at the J marker.
j_marker_name
An Existing Marker
Specifies a marker on the second of two parts connected by this force element. Adams View connects this element to one part at the I marker and to the other at the J marker.
 
Specifies the theory to be used to define the force this element will apply. By default the LINEAR theory is used. If the NONLINEAR option is used, the full non linear Euler-Bernoulli theory is used. If the STRING option is used, a simplified non linear theory is used. The simplified non linear theory may speed up your simulations with little performance penalties.

Extended Definition:

1. The beam, which is massless and has a uniform cross section, is modeled as alinear translational and a linear rotational action-reaction force between twomarkers. The forces the beam produces are linearly dependent on the relativedisplacements and the relative velocities of the markers at its endpoints. The xaxisof the J marker defines the centroidal axis of the beam. The y-axis and the zaxisof the J marker are the principal axes of the cross section. They areperpendicular to the x-axis and to each other. When the beam is in an undeflectedposition, the I marker has the same angular orientation as the J marker, and the Imarker lies on the x-axis of the J marker.
The following constitutive equations define how Adams uses the data you input for a beam to apply a force and a torque to the I marker depending on the displacement and velocity of the I marker relative to the J marker. Adams appliesa force of equal magnitude and opposite direction to the J marker.
[Fx] [K11 0 0 0 0 0 ] [x]
[Fy] [0 K22 0 0 0 K26] [y]
[Fz] = - [0 0 K33 0 K35 0 ] [z]
[Tx] [0 0 0 K44 0 0 ] [a]
[Ty] [0 0 K35 0 K55 0 ] [b]
[Tz] [0 K26 0 0 0 K66] [c]
[C11 C21 C31 C41 C51 C61] [Vx]
[C21 C22 C32 C42 C52 C62] [Vy]
- [C31 C32 C33 C43 C53 C63] [Vz]
[C41 C42 C43 C44 C54 C64] [Wx]
[C51 C52 C53 C54 C55 C65] [Wy]
[C61 C62 C63 C64 C65 C66] [Wz]
Note that both matrices, Cij and Kij, are symmetric, that is, Cij=Cji and Kij=Kji. You define the twenty-one unique damping coefficients when you write the BEAMstatement. Adams defines the Kij's in the following way:
K11 = E A / L
K22 = 12 E Izz /[L**3 (1+Py)]
K26 = -6 E Izz /[L**2 (1+Py)]
K33 = 12 E Iyy /[L**3 (1+Pz)]
K35 = 6 E Iyy /[L**2 (1+Pz)]
K44 = G Ixx / L
K55 = (4+Pz) E Iyy /[L (1+Pz)]
K66 = (4+Py) E Izz /[L (1+Py)]
where Py = 12 E Izz ASY/(G A L**2) and
Pz = 12 E Iyy ASZ/(G A L**2)
2. The BEAM statement implements a force in the same way the FIELD statementdoes, but the BEAM statement requires you to input only the values of the beam'sphysical properties, which Adams uses to calculate the matrix entries. For a forcerequest, the forces returned are the forces the J marker exerts upon the I marker.
3. The constitutive equations shown above define the forces and moments exerted on the I marker. These forces and moments are due to relative displacements andvelocities of the I marker with respect to the J marker. Because of force transfer,the reaction moments at the J marker are usually not the same as the appliedmoments at the I marker.
4. Normally, entity names are composed of alphabetic, numeric, or '_' (underscore) characters, and start with an alphabetic or '_' character. They may be any length. For more information, see Using Extended Names.
By enclosing the name in double quotes, you may use other printable characters, or start the name with a numeral. If a name contains characters, or starts with a numeral, you must always quote the name when entering it. Note that you can specify the parentage of an entity (e.g. what part "owns" a marker or a geometry element) when you CREATE it by changing the name. If you enter just the entity name, then the default parent will be assigned by Adams View. If you type in the full name, then you may over ride the default parent. In most cases, when creatingan entity, Adams View will provide a default name. The default name that Adams View provides will specify the parentage that it has assumed. You may, or course, delete this name and use your own. The form of a full name is:
"...._NAME.GRAND_PARENT_NAME.PARENT_NAME.ENTITY_NAME"
The number of levels used varies from case to case and the parentage must exist before an entity can be assigned to it.
5. Normally, entity names are composed of alphabetic, numeric, or '_' (underscore) characters, and start with an alphabetic or '_' character. They may be any length. For more information, see Using Extended Names.
By enclosing the name in double quotes, you may use other printable characters, or start the name with a numeral. If a name contains characters, or starts with a numeral, you must always quote the name when entering it. Note that you can specify the parentage of an entity (e.g. what part "owns" a marker or a geometry element) when you CREATE it by changing the name. If you enter just the entity name, then the default parent will be assigned by Adams View. If you type in the full name, then you may over ride the default parent. In most cases, when creatingan entity, Adams View will provide a default name. The default name that Adams View provides will specify the parentage that it has assumed. You may, or course, delete this name and use your own. The form of a full name is:
"...._NAME.GRAND_PARENT_NAME.PARENT_NAME.ENTITY_NAME"
The number of levels used varies from case to case and the parentage must exist before an entity can be assigned to it.
6. Specifies an integer used to identify this element in the Adams data file. When you use the FILE Adams_DATA_SET WRITE command, Adams View writes an Adams data file for your model. Adams requires that each modeling element be identified by a unique integer identifier. If you use this parameter to specify a non-zero identifier,Adams View will use it in the corresponding statement in the Adams data file. You may also enter zero as an identifier, either explicitly or by default. The next time you write an Adams file, Adams View will replace the zero with a unique, internallygenerated identifier. Adams View will permanently store this identifier with the element just as if you had entered it yourself. Normally, you would let all identifiers default to zero, and Adams View would generate the identifiers for you. You are never required to enter a non-zero identifier. You only need to specify it if, for some reason, you wish to control the Adams file output.
7. When an Adams Solver data file (.adm) is read into Adams View, all comments associated with a statement (from the end of the previous statement through the end of the current statement) are stored with the object. Comments in the data file can be associated with model. These comments must follow the title statement and be followed by the comment 'END OF MODEL COMMENTS'. This string must be uppercase. When an Adams Solver data file is written, the comments for an object are written before the statement corresponding to the object.
8. The y_shear_area_ratio is a correction factor for shear deflection in the y direction for Timeshenko beams. (Oden, J.T., and E. Ripperger. Mechanics of Elastic Structures, Second Edition, p. 351. New York: McGraw-Hill, 1981). This ratio is the area of the beam cross section divided by the area of the beam cross section that resists y-direction shear forces. If you want to neglect the deflection due toy-direction shear, set the ratio to zero.
9. z_shear_area_ratio is the correction factor for shear deflection in the z direction for Timeshenko beams. (Oden, J.T., and E. Ripperger. Mechanics of Elastic Structures, Second Edition, p. 351. New York: McGraw-Hill, 1981). This ratio is the area of the beam cross section divided by the area of the beam cross section that resists z-direction shear forces. If you want to neglect the deflection due to directionshear, set the ratio to zero.
10.  Specifies Young's modulus of elasticity for the beam material.
11.  Because the matrix_of_damping_terms matrix is symmetric, you need to specify only one-half of it. The following matrix shows the values to input:
[r01 ]
[r02 r07 ]
[r03 r08 r12 ]
[r04 r09 r13 r16 ]
[r05 r10 r14 r17 r19 ]
[r06 r11 r15 r18 r20 r21]
Enter the elements by columns from top to bottom, then from left to right. If you do not use either CMATRIX or CRATIO, CMATRIX defaults to a matrix with thirty-six zeroentries; that is, r1 through r21 each default to zero.

Cautions:

Adams View will not allow you to have two beams with the same full name, so you must provide a unique name.

Tips:

If you type a "?", Adams View will list the gravity fields available by default.