3-D 2-Node Beam
BEAM188 is suitable for analyzing slender to moderately stubby/thick beam structures. The element is based on Timoshenko beam theory which includes shear-deformation effects. The element provides options for unrestrained warping and restrained warping of cross-sections.
The element is a linear, quadratic, or cubic two-node beam element in 3-D. BEAM188 has six or seven degrees of freedom at each node. These include translations in the x, y, and z directions and rotations about the x, y, and z directions. A seventh degree of freedom (warping magnitude) is optional. This element is well-suited for linear, large rotation, and/or large strain nonlinear applications.
The element includes stress stiffness terms, by default, in any analysis with large deflection. The provided stress-stiffness terms enable the elements to analyze flexural, lateral, and torsional stability problems (using eigenvalue buckling, or collapse studies with arc length methods or nonlinear stabilization).
Elasticity, plasticity, creep and other nonlinear material models are supported. A cross-section associated with this element type can be a built-up section referencing more than one material. Added mass, hydrodynamic added mass and loading, and buoyant loading are available.
For more detailed information about this element, see BEAM188 - 3-D 2-Node Beam in the Mechanical APDL Theory Reference.
BEAM188 is based on Timoshenko beam theory, which is a first-order shear-deformation theory: transverse-shear strain is constant through the cross-section (that is, cross-sections remain plane and undistorted after deformation).
The element can be used for slender or stout beams. Due to the limitations of first-order shear-deformation theory, slender to moderately thick beams can be analyzed. Use the slenderness ratio of a beam structure (GAL2 / (EI) ) to judge the applicability of the element, where:
Shear modulus
Area of the cross-section
Length of the member (not the element length)
Flexural rigidity
Calculate the ratio using some global distance measures, rather than basing it upon individual element dimensions. The following illustration shows an estimate of transverse-shear deformation in a cantilever beam subjected to a tip load. Although the results cannot be extrapolated to any other application, the example serves well as a general guideline. A slenderness ratio greater than 30 is recommended.
Slenderness Ratio (GAL2/(EI)) | δ Timoshenko / δ Euler-Bernoulli |
---|---|
25 | 1.120 |
50 | 1.060 |
100 | 1.030 |
1000 | 1.003 |
The element supports an elastic relationship between transverse-shear forces and transverse-shear strains. You can override default values of transverse-shear stiffnesses via the SECCONTROL command.
BEAM188 does not use higher-order theories to account for variation in distribution of shear stresses. Use solid elements if such effects must be considered.
BEAM188 supports “restrained warping” analysis by making available a seventh degree of freedom at each beam node. By default, BEAM188 elements assume that the warping of a cross-section is small enough that it can be neglected (KEYOPT(1) = 0). You can activate the warping degree of freedom by using KEYOPT(1) = 1. With the warping degree of freedom activated, each node has seven degrees of freedom: UX, UY, UZ, ROTX, ROTY, ROTZ, and WARP. With KEYOPT(1) = 1, bimoment and bicurvature are output.
When KEYOPT(3) = 0 (linear, default), BEAM188 is based on linear shape functions. It uses one point of integration along the length; therefore, all element solution quantities are constant along the length. For example, when SMISC quantities are requested at nodes I and J, the centroidal values are reported for both end nodes. This option is recommended if the element is used as stiffener and it is necessary to maintain compatibility with a first-order shell element (such as SHELL181). Only constant bending moments can be represented exactly with this option. Mesh refinement is generally required in typical applications.
When KEYOPT(3) = 2 (quadratic), BEAM188 has an internal node in the interpolation scheme, effectively making this a beam element based on quadratic shape functions. Two points of integration are used, resulting in linear variation of element solution quantities along the length. Linearly varying bending moments are represented exactly.
When KEYOPT(3) = 3 (cubic), BEAM188 has two internal nodes and adopts cubic shape functions. Quadratically varying bending moments are represented exactly. Three points of integration along the length are used, resulting in quadratic variation of element solution quantities along the length. Unlike typical cubic (Hermitian) formulations, cubic interpolation is used for all displacements and rotations.
Quadratic and cubic options are recommended when higher-order element interpolations are desired in situations where:
The element is associated with tapered cross-sections.
Nonuniform loads (including tapered distributed loads) exist within the element; in this case, the cubic option gives superior results over the quadratic option.
(For partially distributed loads and non-nodal point loads, only the cubic option is valid.)
The element may undergo highly nonuniform deformation (for example, when individual frame members in civil engineering structures are modeled with single elements).
In practice, when two elements with “restrained warping” come together at a sharp angle, you need to couple the displacements and rotations, but leave the out-of-plane warping decoupled. This is normally accomplished by having two nodes at a physical location and using appropriate constraints. This process is made easier (or automated) by the ENDRELEASE command, which decouples the out-of plane warping for any adjacent elements with cross-sections intersecting at an angle greater than 20 degrees.
BEAM188 allows change in cross-sectional inertia properties as a function of axial elongation. By default, the cross-sectional area changes such that the volume of the element is preserved after deformation. The default is suitable for elastoplastic applications. By using KEYOPT(2), you can choose to keep the cross-section constant or rigid. Scaling is not an option for nonlinear general beam sections (SECTYPE,,GENB).
Two limitations are associated with the quadratic and cubic options in BEAM188:
Although the elements employ higher-order interpolations, the initial geometry of BEAM188 is treated as straight.
Because the internal nodes are inaccessible, no boundary/loading/initial conditions are allowed on these internal nodes.
As a result of the limitations associated with the quadratic and cubic options, you will notice discrepancies in the results between BEAM189 and the quadratic option of BEAM188 if the midside nodes of the BEAM189 model have specified boundary/loading/initial conditions and/or the midside nodes are not located exactly at the element midpoint. Similarly, the cubic option of BEAM188 may not be identical to a traditional cubic (Hermitian) beam element.
For the mass matrix and evaluation of consistent load vectors, a higher order
integration rule than that used for stiffness matrix is employed. The elements support
both consistent and lumped mass matrices. Use LUMPM,ON to activate
lumped mass matrix. Consistent mass matrix is used by default. You can add mass per unit
length via the SECCONTROL command's ADDMAS
values. See "BEAM188 Input Summary".
When ocean loading is applied, the loading is nonlinear (that is, based on the square of the relative velocity between the structure and the water). Accordingly, the full Newton-Raphson option (NROPT,FULL) may be necessary to achieve optimal results. (Full Newton-Raphson is applied automatically in an analysis involving large-deflection effects [NLGEOM,ON].)
The St. Venant warping functions for torsional behavior are determined in the undeformed state, and are used to define shear strain even after yielding. No options are available for recalculating in deformed configuration the torsional shear distribution on cross-sections during the analysis and possible partial plastic yielding of cross-sections. As such, large inelastic deformation due to torsional loading should be treated and verified with caution. Under such circumstances, alternative modeling using solid or shell elements is recommended.
The geometry, node locations, coordinate system, and pressure directions for this element are shown in Figure 188.1: BEAM188 Geometry. BEAM188 is defined by nodes I and J in the global coordinate system.
Node K is a preferred way to define the orientation of the element. For information about orientation nodes and beam meshing, see Generating a Beam Mesh With Orientation Nodes in the Mechanical APDL Modeling and Meshing Guide. See the LMESH and LATT command descriptions for details on generating the K node automatically.
BEAM188 can also be defined without the orientation node K. In this case, the element x-axis is oriented from node I (end 1) toward node J (end 2). If no orientation node is used, the default orientation of the element y-axis is automatically calculated to be parallel to the global X-Y plane. For the case where the element is parallel to the global Z-axis (or within a 0.01 percent slope of it), the element y-axis is oriented parallel to the global Y-axis (as shown). To control the element orientation about the element x-axis, use the orientation-node option. If both are defined, the orientation-node option takes precedence. The orientation node K, if used, defines a plane (with I and J) containing the element x and z-axes (as shown). If using this element in a large-deflection analysis, be aware that the location of the orientation node K is used only to initially orient the element.
The number of degrees of freedom depends on the value of KEYOPT(1). When KEYOPT(1) = 0 (the default), six degrees of freedom occur at each node. These include translations in the x, y, and z directions and rotations about the x, y, and z directions. When KEYOPT(1) = 1, a seventh degree of freedom (warping magnitude) is also considered.
The beam element is a one-dimensional line element in space. The cross-section details are provided separately via the SECTYPE and SECDATA commands. (See Beam and Pipe Cross Sections in the Mechanical APDL Structural Analysis Guide for details.) A section is associated with the beam elements by specifying the section ID number (SECNUM). A section number is an independent element attribute. In addition to a constant cross-section, you can also define a tapered cross-section by using the TAPER option on the SECTYPE command. (See Defining a Tapered Beam or Pipe in the Mechanical APDL Structural Analysis Guide.)
BEAM188 ignores any real constant data. See the SECCONTROL command for defining the transverse-shear stiffness and added mass.
A summary of the element input is given in "BEAM188 Input Summary".
BEAM188 can be associated with these cross-section types
(SECTYPE,,Type
):
Standard library section types or user meshes which define the geometry of the beam cross-section (SECTYPE,,BEAM). The material of the beam is defined either as an element attribute (MAT), or as part of section buildup (for multi-material cross-sections).
Generalized beam cross-section (SECTYPE,,GENB), where the relationships of generalized stresses to generalized strains are input directly. Not available for ocean loading.
Tapered beam cross-section (SECTYPE,,TAPER), where a standard library section or user mesh defines each end of the beam. Not available for ocean loading.
Preintegrated composite beam cross section (SECTYPE,,COMB,MATRIX), abstract cross section type for defining a fully populated but symmetrical cross-section stiffness and mass matrix directly. Not available for ocean loading.
Standard Library Sections
BEAM188 elements are provided with section-relevant quantities (area of integration, position, etc.) automatically at a number of section points using SECTYPE and SECDATA. Each section is assumed to be an assembly of a predetermined number of nine-node cells. Each cross-section cell has four integration points and each can be associated with an independent material type.
The number of cells in the cross-sections influences the accuracy of section properties and ability to model nonlinear stress-strain relationship through the cross-section. The element has a nested structure of integration (along the length and in the cross-section).
When the material associated with the elements has inelastic behavior or when the temperature varies across the section, constitutive calculations are performed at the section integration points. For more common elastic applications, the element uses precalculated properties of the section at the element integration points; however, the stresses and strains are calculated in the output pass at the section integration points. Element output is available at the integration points, as well as values extrapolated to the element and section nodes.
If the section is assigned the subtype ASEC, only the generalized stresses and strains (axial force, bending moments, transverse shears, curvatures, and shear strains) are available for output. 3-D contour plots and deformed shapes are not available. The ASEC subtype is displayed only as a thin rectangle to verify beam orientation.
BEAM188 is helpful for analyzing built-up beams (that is, those fabricated of two or more pieces of material joined together to form a single, solid beam). The pieces are assumed to be perfectly bonded together; therefore, the beam behaves as a single member.
The multi-material cross-section capability is applicable only where the assumption of beam behavior (Timoshenko or Bernoulli-Euler beam theory) holds.
Therefore, the element models a simple extension of a conventional Timoshenko beam and can be used in applications such as:
Bimetallic strips
Beams with metallic reinforcement
Sensors where layers of a different material has been deposited
BEAM188 does not account for coupling of bending and twisting at the section stiffness level. The transverse shears are also treated in an uncoupled manner. This can have a significant effect on layered composite and sandwich beams if the lay-up is unbalanced.
Always validate the application of BEAM188, either with experiments or other numerical analysis. Use the restrained warping option with built-up sections after due verification.
KEYOPT(15) specifies the format of the .rst results file. For KEYOPT(15) = 0, the format gives only one averaged result at each section corner node; therefore, this option typically applies to homogeneous sections. For KEYOPT(15) = 1, the format gives one result for each section integration point; therefore, this option typically applies to built-up sections with multiple materials (and generates a larger results file).
Generalized Beam Cross-Sections
When using nonlinear general beam sections, neither the geometric properties nor the material is explicitly specified. Generalized stress implies the axial force, bending moments, torque, and transverse-shear forces. Similarly, generalized strain implies the axial strain, bending curvatures, twisting curvature, and transverse-shear strains. (For more information, see Using Nonlinear General Beam Sections in the Mechanical APDL Structural Analysis Guide.) This is an abstract method for representing cross-section behavior; therefore, input often consists of experimental data or the results of other analyses.
Generally, BEAM188 supports an elastic relationship between transverse-shear forces and transverse-shear strains. You can override default values of transverse-shear stiffnesses via the SECCONTROL command.
When the beam element is associated with a generalized beam (SECTYPE,,GENB) cross-section type, the relationship of transverse-shear force to the transverse-shear strain can be nonlinear elastic or plastic, an especially useful capability when flexible spot welds are modeled. In such a case, the SECCONTROL command does not apply.
Tapered Beam Cross-Sections
A linearly tapered beam is defined by specifying a standard library section or user mesh at each end of the beam. The section geometries are specified at global coordinates, then linear interpolated and evaluated at the element. The sections at the end points must be topologically identical. (For more information, see Defining a Tapered Beam or Pipe in the Mechanical APDL Structural Analysis Guide.)
Forces are applied at the nodes (which also define the element x-axis). If the
centroidal axis is not colinear with the element x-axis, applied axial forces will cause
bending. Applied shear forces cause torsional strains and moment if the centroid and
shear center of the cross-section are different. The nodes should therefore be located
at the desired points where you want to apply the forces. Use the
OFFSETY
and OFFSETZ
arguments
of the SECOFFSET command appropriately. By default, the program uses
the centroid as the reference axis for the beam elements.
Element loads are described in Nodal Loading. Pressures can be input as surface loads on the element faces as shown by the circled numbers in Figure 188.1: BEAM188 Geometry. Positive normal pressures act into the element. Lateral pressures are input as force per unit length. End "pressures" are input as forces.
At both ends of the element, temperatures can be input at these locations:
At the element x-axis (T(0,0))
At one unit from the x-axis in the element y-direction (T(1,0))
At one unit from the x-axis in the element z-direction (T(0,1))
Element locations (T(y,z)) are given according to the convention used in Figure 188.1: BEAM188 Geometry.
For beam elements, element body load commands (BFE) accept an element number and a list of values, 1 through 6 for temperatures TI(0,0), TI(1,0), TI(0,1), TJ(0,0), TJ(1,0), and TJ(0,1). This input can be used to specify temperature gradients that vary linearly both over the cross section and along the length of the element.
The following defaults apply to element temperature input:
If all temperatures after the first are unspecified, they default to the first. This pattern applies a uniform temperature over the entire element. (The first coordinate temperature, if unspecified, defaults to TUNIF.)
If all three temperatures at node I are input, and all temperatures at node J are unspecified, the node J temperatures default to the corresponding node I temperatures. This pattern applies a temperature gradient that varies linearly over the cross section but remains constant along the length of the element.
For any other input pattern, unspecified temperatures default to TUNIF.
Alternatively, temperatures at nodes I and J can be defined using nodal body loads
(BF,NODE
,TEMP,VAL1
).
When using a nodal body load to define a temperature, a uniform temperature is applied
over the cross section at the specified node.
Temperature gradients across the cross-section are not allowed when the beam section has an arbitrary (ASEC) subtype, where the integrated cross-section inertia properties are user-defined (SECTYPE,,BEAM,ASEC).
You can apply an initial stress state to this element via the INISTATE command. For more information, see Initial State in the Mechanical APDL Advanced Analysis Guide.
The effects of pressure load stiffness are automatically included for this element. If an unsymmetric matrix is needed for pressure load stiffness effects, use NROPT,UNSYM.
Hydrodynamic added mass and loading, and buoyant loading, are available via the OCDATA and OCTABLE commands.
The global origin is normally at the mean sea level, with the global Z-axis
pointing away from the center of the earth; however, the vertical location can be
adjusted via Zmsl
(Val6
) on
the OCDATA command (following the OCTYPE,BASIC
command).
For more information, see Applying Ocean Loads in the Mechanical APDL Basic Analysis Guide.
I, J, K (K, the orientation node, is optional but recommended)
UX, UY, UZ, ROTX, ROTY, ROTZ if KEYOPT(1) = 0 |
UX, UY, UZ, ROTX, ROTY, ROTZ, WARP if KEYOPT(1) = 1 |
TXZ, TXY, ADDMAS (See SECCONTROL) |
(TXZ and TXY default to A*GXZ and A*GXY, respectively, where A = cross-sectional area) |
TB command: See Element Support for Material Models for this element.
MP command: EX, (PRXY,or NUXY), GXY, GXZ, ALPX, (or CTEX, or THSX), DENS, ALPD, BETD, DMPR
face 1 (I-J) (-z normal direction) |
face 2 (I-J) (-y normal direction) |
face 3 (I-J) (+x tangential direction) |
face 4 (I) (+x axial direction) |
face 5 (J) (-x axial direction) |
--- |
I and J denote the end nodes. |
Use a negative value for loading in the opposite direction. |
Issue the SFBEAM command to specify surface loads. |
For faces 1, 2, and 3, offsets apply only if you are using the cubic option (KEYOPT(3) = 3). |
T(0,0), T(1,0), T(0,1) at each end node
Warping degree of freedom:
Six degrees of freedom per node, unrestrained warping (default)
Seven degrees of freedom per node (including warping). Bimoment and bicurvature are output.
Cross-section scaling, applies only if NLGEOM,ON has been invoked:
Cross-section is scaled as a function of axial stretch (default)
Section is assumed to be rigid (classical beam theory)
Shape functions along the length:
Linear (default)
Quadratic
Cubic
Shear stress output:
Output only torsion-related shear stresses (default)
Output only flexure-related transverse-shear stresses
Output a combined state of the previous two types
active only when OUTPR,ESOL is active:
Output control for section forces/moments and strains/curvatures:
Output section forces/moments and strains/curvatures at integration points along the length (default)
Same as KEYOPT(6) = 0 plus current section area
Same as KEYOPT(6) = 1 plus element basis directions (X,Y,Z)
Output section forces/moments and strains/curvatures extrapolated to the element nodes
Output control at integration points (not available when section subtype = ASEC):
None (default)
Maximum and minimum stresses/strains
Same as KEYOPT(7) = 1 plus stresses and strains at each section point
Output control for values extrapolated to the element and section nodes (not available when section subtype = ASEC):
None (default)
Maximum and minimum stresses/strains
Same as KEYOPT(9) = 1 plus stresses and strains along the exterior boundary of the cross-section
Same as KEYOPT(9) = 1 plus stresses and strains at all section nodes
Set section properties:
Automatically determine if preintegrated section properties can be used (default)
Use numerical integration of section
Tapered section treatment:
Linear tapered section analysis; cross-section properties are evaluated at each Gauss point (default). This is more accurate, but computationally intensive.
Average cross-section analysis; for elements with tapered sections, cross-section properties are evaluated at the centroid only. This is an approximation of the order of the mesh size; however, it is faster.
Hydrodynamic output (not available in harmonic analyses that include ocean wave effects (HROCEAN)):
None (default)
Additional hydrodynamic printout
Results file format:
Store averaged results at each section corner node (default).
Store non-averaged results at each section integration point. (The volume of data may be excessive. This option is typically useful for built-up sections with multiple materials only.)
The solution output associated with these elements is in two forms:
Nodal displacements and reactions included in the overall nodal solution
Additional element output as described in Table 188.1: BEAM188 Element Output Definitions
To view 3-D deformed shapes for BEAM188, issue an
OUTRES,MISC or OUTRES,ALL command for static
or transient analyses. To view 3-D mode shapes for a modal or eigenvalue buckling
analysis, you must expand the modes with element results calculation active (via the
MXPAND command's Elcalc
= YES option).
Linearized Stress
It is customary in beam design to employ components of axial stress that contribute to axial loads and bending in each direction separately; therefore, BEAM188 provides a linearized stress output as part of its SMISC output record, as indicated in the following definitions:
SDIR is the stress component due to axial load.
SDIR = Fx/A, where Fx is the axial load (SMISC quantities 1 and 14) and A is the area of the cross-section.
SByT and SByB are bending-stress components.
SByT = -Mz * ymax / Izz |
SByB = -Mz * ymin / Izz |
SBzT = My * zmax / Iyy |
SBzB = My * zmin / Iyy |
where My, Mz are bending moments in the beam coordinate system (SMISC quantities 2,15,3,16), as shown in Figure 188.1: BEAM188 Geometry. Coordinates ymax, ymin, zmax, and zmin are the maximum and minimum y, z coordinates in the cross-section measured from the centroid. Values Iyy and Izz are moments of inertia of the cross-section. Except for the ASEC type of beam cross-section, the program uses the maximum and minimum cross-section dimensions. For the ASEC type of cross-section, the maximum and minimum in each of y and y direction is assumed to be +0.5 to -0.5, respectively.
Corresponding definitions for the component strains are:
EPELDIR = Ex |
EPELByT = -Kz * ymax |
EPELByB = -Kz * ymin |
EPELBzT = Ky * zmax |
EPELBzB = Ky * zmin |
where Ex, Ky, and Kz are generalized strains and curvatures (SMISC quantities 7,8,9, 20,21 and 22).
The reported linearized stresses are strictly valid only for elastic behavior of members. BEAM188 always employs combined stresses in order to support nonlinear material behavior. When the elements are associated with nonlinear materials, the component stresses can at best be regarded as linearized approximations and should be interpreted with caution.
When using KEYOPT(7) with the cubic option (KEYOPT(3) = 3), the integration point at the middle of the element is reported last in the integration-point printout.
The Element Output Definitions table uses the following notation:
In the table below, the O column indicates the availability of the items in the file Jobname.OUT. The R column indicates the availability of the items in the results file.
In either the O or R columns, “Y” indicates that the item is always available, a number refers to a table footnote that describes when the item is conditionally available, and “-” indicates that the item is not available.
Table 188.1: BEAM188 Element Output Definitions
Name | Definition | O | R |
---|---|---|---|
EL | Element number | Y | Y |
NODES | Element connectivity | Y | Y |
MAT | Material number | Y | Y |
C.G.:X, Y, Z | Element center of gravity | Y | 1 |
Area | Area of cross-section | 2 | Y |
SF:y, z | Section shear forces | 2 | Y |
SE:y, z | Section shear strains | 2 | Y |
S:xx, xy, xz | Section point stresses | 3 | Y |
EPEL:xx, xy, xz | Elastic strains | 3 | Y |
EPTO:xx, xy, xz | Section point total mechanical strains (EPEL + EPPL + EPCR) | 3 | Y |
EPTT:xx, xy, xz | Section point total strains (EPEL + EPPL + EPCR+EPTH) | 3 | Y |
EPPL:xx, xy, xz | Section point plastic strains | 3 | Y |
EPCR:xx, xy, xz | Section point creep strains | 3 | Y |
EPTH:xx | Section point thermal strains | 3 | Y |
NL:SEPL | Plastic yield stress | - | 4 |
NL:SRAT | Plastic yielding (1 = actively yielding, 0 = not yielding) | - | 4 |
NL:HPRES | Hydrostatic pressure | - | 4 |
NL:EPEQ | Accumulated equivalent plastic strain | - | 4 |
NL:CREQ | Accumulated equivalent creep strain | - | 4 |
NL:PLWK | Plastic work/volume | - | 4 |
SEND:ELASTIC, PLASTIC, CREEP | Strain energy densities | - | 4 |
TQ | Torsional moment | Y | Y |
TE | Torsional strain | Y | Y |
Ky, Kz | Curvature | Y | Y |
Ex | Axial strain | Y | Y |
Fx | Axial force | Y | Y |
My, Mz | Bending moments | Y | Y |
BM | Warping bimoment | 6 | 6 |
BK | Warping bicurvature | 6 | 6 |
EXT PRESS | External pressure at integration point | 5 | 5 |
EFFECTIVE TENS | Effective tension on beam | 5 | 5 |
SDIR | Axial direct stress | - | 2 |
SByT | Bending stress on the element +Y side of the beam | - | Y |
SByB | Bending stress on the element -Y side of the beam | - | Y |
SBzT | Bending stress on the element +Z side of the beam | - | Y |
SBzB | Bending stress on the element -Z side of the beam | - | Y |
EPELDIR | Axial strain at the end | - | Y |
EPELByT | Bending strain on the element +Y side of the beam. | - | Y |
EPELByB | Bending strain on the element -Y side of the beam. | - | Y |
EPELBzT | Bending strain on the element +Z side of the beam. | - | Y |
EPELBzB | Bending strain on the element -Z side of the beam. | - | Y |
TEMP | Temperatures at all section corner nodes. | - | Y |
LOCI:X, Y, Z | Integration point locations | - | 7 |
SVAR:1, 2, ... , N | State variables | - | 8 |
The following values apply to ocean loading only: [9] | |||
GLOBAL COORD | Element centroid location | 10 | Y |
VR, VZ | Radial and vertical fluid particle velocities (VR is always > 0) | 10 | Y |
AR, AZ | Radial and vertical fluid particle accelerations | 10 | Y |
PHDYN | Dynamic fluid pressure head | 10 | Y |
ETA | Wave amplitude over center of element | 10 | Y |
TFLUID | Fluid temperature (printed if VISC is nonzero) | 10 | Y |
VISC | Viscosity (output if VISC is nonzero) | 10 | Y |
REN, RET | Normal and tangential Reynolds numbers (if VISC is nonzero) | 10 | Y |
CT | Input tangential drag coefficients evaluated at Reynolds numbers | 10 | Y |
CDY, CDZ | Input normal drag coefficients evaluated at Reynolds numbers | 10 | Y |
CMY, CMZ | Input inertia coefficients evaluated at Reynolds numbers | 10 | Y |
URT, URN | Tangential (parallel to element axis) and normal relative velocities | 10 | Y |
ABURN | Vector sum of normal (URN) velocities | 10 | Y |
AN | Accelerations normal to element | 10 | Y |
FX, FY, FZ | Hydrodynamic tangential and normal forces per unit length in element coordinates | 10 | Y |
ARGU | Effective position of wave (radians) | 10 | Y |
Available only at the centroid as a *GET item.
Available only if ocean loading is present.
Available only if OUTRES,LOCI command is used.
Available only if the
UserMat
subroutine and TB,STATE command are used.Values are given as the average of the hydrodynamic integration points, which are distributed along the wetted portion of the element.
Applies to ocean loading only.
More output is described via the PRESOL and *GET,,SECR commands in POST1.
Table 188.2: BEAM188 Item and Sequence Numbers lists output available via the ETABLE and ESOL commands using the Sequence Number method. See Creating an Element Table in the Mechanical APDL Basic Analysis Guide and The Item and Sequence Number Table in this reference for more information. The table uses the following notation:
output quantity as defined in the Table 188.1: BEAM188 Element Output Definitions
predetermined Item label for ETABLE
sequence number for data at nodes I and J
Table 188.2: BEAM188 Item and Sequence Numbers
Output Quantity Name | ETABLE and ESOL Command Input | |||
---|---|---|---|---|
Item | E | I | J | |
Fx | SMISC | -- | 1 | 14 |
My | SMISC | -- | 2 | 15 |
Mz | SMISC | -- | 3 | 16 |
TQ | SMISC | -- | 4 | 17 |
SFz | SMISC | -- | 5 | 18 |
SFy | SMISC | -- | 6 | 19 |
Ex | SMISC | -- | 7 | 20 |
Ky | SMISC | -- | 8 | 21 |
Kz | SMISC | -- | 9 | 22 |
TE | SMISC | -- | 10 | 23 |
SEz | SMISC | -- | 11 | 24 |
SEy | SMISC | -- | 12 | 25 |
Area | SMISC | -- | 13 | 26 |
BM | SMISC | -- | 27 | 29 |
BK | SMISC | -- | 28 | 30 |
SDIR | SMISC | -- | 31 | 36 |
SByT | SMISC | -- | 32 | 37 |
SByB | SMISC | -- | 33 | 38 |
SBzT | SMISC | -- | 34 | 39 |
SBzB | SMISC | -- | 35 | 40 |
EPELDIR | SMISC | -- | 41 | 46 |
EPELByT | SMISC | -- | 42 | 47 |
EPELByB | SMISC | -- | 43 | 48 |
EPELBzT | SMISC | -- | 44 | 49 |
EPELBzB | SMISC | -- | 45 | 50 |
TEMP | SMISC | -- | 51-53 | 54-56 |
EXT PRESS [9] | SMISC | -- | 62 | 66 |
EFFECTIVE TENS [9] | SMISC | -- | 63 | 67 |
S:xx, xy, xz | LS | -- | CI[1], DI[2] | CJ[1], DJ[2] |
EPEL:xx, xy, xz | LEPEL | -- | CI[1], DI[2] | CJ[1], DJ[2] |
EPTH:xx | LEPTH | -- | AI[3], BI[4] | AJ[3], BJ[4] |
EPPL:xx, xy, xz | LEPPL | -- | CI[1], DI[2] | CJ[1], DJ[2] |
EPCR:xx, xy, xz | LEPCR | -- | CI[1], DI[2] | CJ[1], DJ[2] |
EPTO:xx, xy, xz | LEPTO | -- | CI[1], DI[2] | CJ[1], DJ[2] |
EPTT:xx, xy, xz | LEPTT | -- | CI[1], DI[2] | CJ[1], DJ[2] |
NL: SEPL, SRAT, HPRES, EPEQ, CREQ, PLWK | NLIN | -- | EI[5], FI[6] | EJ[5], FJ[6] |
The following output quantities are valid for ocean loading only and are averaged values for the element: [10] | ||||
GLOBAL COORD | NMISC | 1, 2, 3 | -- | -- |
VR, VZ | NMISC | 4, 5 | -- | -- |
AR, AZ | NMISC | 6, 7 [7] | -- | -- |
PHDYN | NMISC | 8 [7] | -- | -- |
ETA | NMISC | 9 [7] | -- | -- |
TFLUID | NMISC | 10 | -- | -- |
VISC | NMISC | 11 | -- | -- |
REN, RET | NMISC | 12, 13 [8] | -- | -- |
CT | NMISC | 14 | -- | -- |
CDY, CDZ | NMISC | 15, 16 | -- | -- |
CMY, CMZ | NMISC | 17, 18 [7] | -- | -- |
URT, URN | NMISC | 19, 20, 21 | -- | -- |
ABURN | NMISC | 22 [7] | -- | -- |
AN | NMISC | 23, 24 [7] | -- | -- |
FX, FY, FZ | NMISC | 25, 26, 27 | -- | -- |
ARGU | NMISC | 28 [7] | -- | -- |
CI and CJ are the sequence numbers for accessing the averaged line element solution quantities (LS, LEPEL, LEPPL, LEPCR, LEPTO, and LEPTT) at RST section nodes (section corner nodes where results are available), at element Node I and J respectively. CI and CJ are applicable only when KEYOPT(15) = 0. For a given section corner node
nn
, CI and CJ are given as follows:CI = (
nn
- 1) * 3+COMP
CJ = (
nnMax
+nn
- 1) * 3+COMP
Where
nnMax
is the total number of RST section nodes, and COMP is the stress or strain component (1 - xx, 2 - xy, 3 - xz). Locations of RST section nodes can be visualized with SECPLOT,,6.DI and DJ are the sequence numbers for accessing the non-averaged line element solution quantities (LS, LEPEL, LEPPL, LEPCR, LEPTO, and LEPTT) at RST section integration points (section integration points where results are available), at element Node I and J respectively. DI and DJ are applicable only when KEYOPT(15) = 1. For the ith integration point (i = 1, 2, 3, or 4) in section cell
nc
, DI and DJ are given as follows:DI = (
nc
- 1) * 12 + (i - 1) * 3 + COMPDJ = (
ncMax
+nc
- 1) * 12 + (i - 1) * 3 + COMPWhere
ncMax
is the total number of RST section cells, and COMP is the stress or strain component (1 - xx, 2 - xy, 3 - xz). Locations of RST section cells can be visualized with SECPLOT,,7.AI and AJ are the sequence numbers for accessing the averaged line element thermal strain quantities LEPTH at RST section nodes (section corner nodes where results are available), at element Node I and J respectively. AI and AJ are applicable only when KEYOPT(15) = 0. For a given section corner node
nn
, AI and AJ are given as follows:AI =
nn
AJ =
nnMax
+nn
Where
nnMax
is the total number of RST section nodes. Locations of RST section nodes can be visualized with SECPLOT,,6.BI and BJ are the sequence numbers for accessing the non-averaged line element thermal strain quantities LEPTH at RST section integration points (section integration points where results are available), at element Node I and J respectively. BI and BJ are applicable only when KEYOPT(15) = 1. For the ith integration point (i = 1, 2, 3, or 4) in section cell
nc
, BI and BJ are given as follows:BI = (
nc
- 1) * 4 + iBJ = (
ncMax
+nc
- 1) * 4 + iWhere
ncMax
is the total number of RST section cells. Locations of RST section cells can be visualized with SECPLOT,,7.EI and EJ are the sequence numbers for accessing the averaged line element nonlinear solution quantities (NLIN) at RST section nodes (section corner nodes where results are available), at element Node I and J, respectively. EI and EJ are applicable only when KEYOPT(15) = 0. For a given section corner node
nn
, EI and EJ are given as follows:EI = (
nn
- 1) * 10 + COMPEJ = (
nn
Max +nn
- 1) * 10 + COMPwhere
nn
Max is the total number of RST section nodes, and COMP is the nonlinear element solution component (1 - SEPL, 2 - SRAT, 3 - HPRES, 4 -EPEQ, 5 - CREQ, 6 - PLWK). Locations of RST section nodes can be visualized via SECPLOT,,6.FI and FJ are the sequence numbers for accessing the nonaveraged line element non-linear solution quantities (NLIN) at RST section integration points (section integration points where results are available), at element Node I and J, respectively. FI and FJ are applicable only when KEYOPT(15) = 1. For a given section integration point
nc
, FI and FJ are given as follows:FI = (
nc
- 1) * 10 + COMPFJ = (
nc
Max +nc
- 1) * 10 + COMPwhere
nc
Max is the total number of RST section cells and COMP is the non-linear element solution component (1 - SEPL, 2 - SRAT, 3 - HPRES, 4 - EPEQ, 5 - CREQ, 6 - PLWK). Locations of RST section cells can be visualized via SECPLOT,,7.Applies to ocean loading only.
These quantities are output only if a Reynold's number dependency is used.
External pressure (EXT PRESS) and effective tension (EFFECTIVE TENS) occur at integration points, and not at end nodes.
Values are given as the average of the hydrodynamic integration points, which are distributed along the wetted portion of the element.
The BEAM188 formulation is based on three stress components:
one axial
two shear stress
The shear stresses are caused by torsional and transverse loads. BEAM188 is based on first-order shear-deformation theory, also popularly known as Timoshenko beam theory. The transverse-shear strain is constant for the cross-section; therefore, the shear energy is based on a transverse-shear force. The shear force is redistributed by predetermined shear-stress distribution coefficients across the beam cross-section, and made available for output purposes. By default, the program outputs only the shear stresses caused by torsional loading. Use KEYOPT(4) to activate output of shear stresses caused by flexure or transverse loading.
The accuracy of transverse-shear distribution is directly proportional to the mesh density of cross-section modeling (for determination of warping, shear center and other section geometric properties). The traction-free state at the edges of a cross-section is met only in a well-refined model of the cross-section.
By default, the program uses a mesh density (for cross-section modeling) that provides accurate results for torsional rigidity, warping rigidity, inertia properties, and shear-center determination. The default mesh employed is also appropriate for nonlinear material calculations; however, more refined cross-section models may be necessary if the shear stress distribution due to transverse loads must be captured very accurately. Increasing cross-section mesh size does not imply larger computational cost if the cross-section is homogeneous and the associated material is linear. Use the SECTYPE and SECDATA commands to adjust cross-section mesh density.
The transverse-shear distribution calculation ignores the effects of Poisson's ratio. The Poisson's ratio affects the shear-correction factor and shear-stress distribution slightly, and this effect is ignored.
The beam must not have zero length.
By default (KEYOPT(1) = 0), the effect of warping restraint is assumed to be negligible.
Cross-section failure or folding is not accounted for.
Rotational degrees of freedom are not included in the lumped mass matrix if offsets are present.
The element works best with the full Newton-Raphson solution scheme (that is, the default choice in solution control).
Only moderately "thick" beams can be analyzed. See "BEAM188 Element Technology and Usage Recommendations" for more information.
Stress stiffening is always included in geometrically nonlinear analyses (NLGEOM,ON). Prestress effects can be activated by the PSTRES command.
When the element is associated with nonlinear general beam sections (SECTYPE,,GENB), additional restrictions apply. For more information, see Considerations for Using Nonlinear General Beam Sections in the Mechanical APDL Structural Analysis Guide.
For a random vibration (PSD) analysis, equivalent stress is not calculated.
When the element is used in an ocean environment:
For subtype ASEC, the calculated perimeter is two times the sum of the input maximum height and width.
Hydrodynamic output via KEYOPT(13) is not available in harmonic analyses that include ocean wave effects (HROCEAN).
The three-dimensional effect of water pressure on the element is adjusted, as the element has only one direct stress. For more information, see Hydrostatic Loads in the Mechanical APDL Theory Reference.
Enclosed spaces used by subtypes CTUBE or HREC are assumed to have the same pressure and internal fluid density as the surrounding ocean (that is, as if the flooding option used with PIPE288 or PIPE289 is always enabled).
Generally, it is better to use a pipe element (PIPE288 or PIPE289) rather than beam subtype CTUBE, as the pipe element has a degree of freedom to account for cross-sectional compression and can also have an independent internal pressure applied.
The output axial force may not be exact when using ocean loading with nonlinear materials.
When used in the product(s) listed below, the stated product-specific restrictions apply to this element in addition to the general assumptions and restrictions given in the previous section.
ANSYS Mechanical Pro
Birth and death is not available.
Initial state is not available.
Linear perturbation is not available.
Ocean loading is not available.
ANSYS Mechanical Premium
Birth and death is not available.