The BeamSection object defines the properties of a beam section.
The BeamSection object is derived from the Section object.
sectionApi.sections()[name]
This method creates a BeamSection object.
sectionApi.BeamSection
odb_BeamSection&
BeamSection(const odb_String& name,
const odb_String& integration,
const odb_String& profile,
double poissonRatio,
bool thermalExpansion,
bool temperatureDependency,
int dependencies,
odb_Union density,
odb_Union referenceTemperature,
const odb_String& temperatureVar,
double alphaDamping,
double betaDamping,
double compositeDamping,
bool useFluidInertia,
const odb_String& submerged,
odb_Union fluidMassDensity,
odb_Union crossSectionRadius,
double lateralMassCoef,
double axialMassCoef,
double massOffsetX,
double massOffsetY,
const odb_String& beamShape,
const odb_String& material,
const odb_SequenceSequenceDouble& table,
const odb_SequenceSequenceDouble& outputPts,
const odb_SequenceDouble& centroid,
const odb_SequenceDouble& shearCenter,
const odb_String& profileEnd);Required arguments
An odb_String specifying the repository key.
An odb_String specifying the integration method for the section. Possible values are "BEFORE_ANALYSIS" and "DURING_ANALYSIS".
An odb_String specifying the name of the profile. This argument represents the start profile in case of beamShape="TAPERED".
Optional arguments
A Double specifying the Poisson's ratio of the section. The default value is 0.0.
A Boolean specifying whether to use thermal expansion data. The default value is false.
A Boolean specifying whether the data depend on temperature. The default value is false.
An Int specifying the number of field variable dependencies. The default value is 0.
The string "NONE" or a Double specifying the density of the section. The default value is "NONE".
The string "NONE" or a Double specifying the reference temperature of the section. The default value is "NONE".
An odb_String specifying the temperature variation for the section. Possible values are "LINEAR" and "INTERPOLATED". The default value is "LINEAR".
A Double specifying the
factor to create mass proportional damping in direct-integration dynamics. The default value is 0.0.
A Double specifying the
factor to create stiffness proportional damping in direct-integration dynamics. The default value is 0.0.
A Double specifying the fraction of critical damping to be used in calculating composite damping factors for the modes (for use in modal dynamics). The default value is 0.0.
A Boolean specifying whether added mass effects will be simulated. The default value is false.
An odb_String specifying whether the section is either full submerged or half submerged. This argument applies only when useFluidInertia = True. Possible values are "FULLY" and "HALF". The default value is "FULLY".
The string "NONE" or a Double specifying the mass density of the fluid. This argument applies only when useFluidInertia = True and must be specified in that case. The default value is "NONE".
The string "NONE" or a Double specifying the radius of the cylindrical cross-section. This argument applies only when useFluidInertia = True and must be specified in that case. The default value is "NONE".
A Double specifying the added mass coefficient,
, for lateral motions of the beam. This argument applies only whenuseFluidInertia = True. The default value is 1.0.
A Double specifying the added mass coefficient,
, for motions along the axis of the beam. This argument affects only the term added to the free end(s) of the beam, and applies only when useFluidInertia = True. The default value is 0.0.
A Double specifying the local 1-coordinate of the center of the cylindrical cross-section with respect to the beam cross-section. This argument applies only when useFluidInertia = True. The default value is 0.0.
A Double specifying the local 2-coordinate of the center of the cylindrical cross-section with respect to the beam cross-section. This argument applies only when useFluidInertia = True. The default value is 0.0.
An odb_String specifying the change in cross-section of the beam along length. Possible values are "CONSTANT" and "TAPERED". The default value is "CONSTANT".
An odb_String specifying the name of the material. The default value is an empty string.
An odb_SequenceSequenceDouble specifying the items described below. The default value is an empty sequence.
An odb_SequenceSequenceDouble specifying the positions at which output is requested. The default value is an empty sequence.
An odb_SequenceDouble specifying the X–Y coordinates of the centroid. The default value is (0.0, 0.0).
An odb_SequenceDouble specifying the X–Y coordinates of the shear center. The default value is (0.0, 0.0).
An odb_String specifying the name of the end profile. The type of the end profile must be same as that of the start profile. This argument is valid only when beamShape="TAPERED". The default value is an empty string.
Table data
The table data specify the following:
E, the Young's modulus of the section.
G, the torsional shear modulus of the section.
Thermal expansion coefficient, if using thermal expansion.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
Return value
A BeamSection object.
Exceptions
The BeamSection object has members with the same names and descriptions as the arguments to the BeamSection method.
In addition, the BeamSection object can have the following member:
odb_TransverseShearBeam beamTransverseShear() const;
A TransverseShearBeam object specifying the transverse shear stiffness properties.
| *BEAM GENERAL SECTION |
| *BEAM SECTION |
| *BEAM FLUID INERTIA |
| *CENTROID |
| *DAMPING |
| *SHEAR CENTER |
| *SECTION POINTS |