beamsects

The beam section may or may not have any results data available. If the requested data item has not been defined, then the value returned is "-99999.9"
attributesmax
The number of attributes owned by this entity.
Type: unsigned integer
center
The reduction point to recompute beamsection properties when sketch or section manager has been updated. Only valid if a sketch has been assigned to the beamsection.
0 - Base point: Computation based on sketch base point
1 - Centroid
2 - Shear Center
3 - Frame center
Type: unsigned integer
collector
Pointer to the collector that owns the element.
Type: pointer (levels 2, 3 and 4)
computeproperties
The flag to compute properties when sketch or section manager has been updated. Only valid if a sketch has been assigned to the beamsection.
0 - Do not recompute properties
1 - Recompute properties (default)
Type: unsigned integer
dt_field
The table containing the tessellation information.
Type: pointer
dt_dataset
The table containing the solver information (material, functions, and so on).
Type: pointer
engine
The engine for the beamsection entity. Valid values are:
blank
2 - Closed Form
3 - FEM
4 - Thinwall
Type: unsigned integer
Fillcolor
The color the beam section uses for display of solid regions.
Type: integer
Flags
The optimization flag.
Type: integer
id
The ID of the entity.
Type: unsigned integer
include
The ID of the include file the entity is organized in.
Type: entity
includeid
The ID of the include file the entity is organized in.
Type: unsigned integer
internalid
The ID of the entity.
Type: unsigned integer
internalname
The internal name of the entity.
Type: string
Linecolor
The color the beam section uses for display of lines.
Type: integer
moduleid
The module ID of the entity.
Type: integer
name
The name of the entity.
Type: string
partdefinition
The list of sketch curve IDs defining each region. This option is provided as a formatted string. Each curve ID is separated by a comma “,”. If the sketch region describes a solid part and this one contains holes, a hole definition may be added by a semicolon “;”.
Type: string array
partmanagertable
The section manager containing the sketch regions to realize the beamsection. Only valid if a sketch has been assigned to the beamsection.
Type: tabular
partmaterial
The material information for each sketch region. If material=”-1.0” and the region describes a solid part, this one is considered as being a hole. If material=”0.0”, the region will be defined as only geometric region. The format for non-geometric materials is “Type,ElasticModulus,PoissonRatio,ShearModulus,YieldLimit”. The only accepted type is 1 (elastic material).
Type: string
partname
The list of sketch regions names.
Type: string
partscount
The number of sketch regions to realize the beamsection.
Type: unsigned integer
partsize
The characteristic size for each sketch region. If a region is describing a solid part, the partsize corresponds to the meshsize for meshing. If a region is describing a solid part and size=0.0, the meshsize will be autocalculated. If a region is describing a shell part, the partsize corresponds to the part thickness.
Type: double
poolid
The pool number of the entity.
Type: integer
poolname
The pool name of the entity.
Type: string
results_area
The area of the beamsect.
Type: double
results_centroid0
The local y-coordinate of the centroid of the beamsect.
Type: double
results_centroid1
The local z-coordinate of the centroid of the beamsect.
Type: double
results_coordExt0
The coordinate extent in the y direction.
Type: double
results_coordExt1
The coordinate extent in the z direction.
Type: double
results_coordExtP0
The coordinate extent in y principal coordinates.
Type: double
results_coordExtP1
The coordinate extent in z principal coordinates.
Type: double
results_elasticCenter0
The y-coordinate of the elastic center.
Type: double
results_elasticCenter1
The z-coordinate of the elastic center.
Type: double
results_Emt
The elastic torsion modulus.
Type: double
results_gamma
The warping constant.
Type: double
results_lcentroid0
lyy in centroidal coordinates.
Note: This data name contains an uppercase I (i).
Type: double
results_lcentroid1
lzz in centroidal coordinates.
Note: This data name contains an uppercase I (i).
Type: double
results_lcentroid2
lyz in centroidal coordinates.
Note: This data name contains an uppercase I (i).
Type: double
results_lprincipal0
lv principal moment of inertia.
Note: This data name contains an uppercase I (i).
Type: double
results_lprincipal1
lw principal moment of inertia.
Note: This data name contains an uppercase I (i).
Type: double
results_luser0
lyy in user coordinates.
Note: This data name contains an uppercase I (i).
Type: double
results_luser1
lzz in user coordinates.
Note: This data name contains an uppercase I (i).
Type: double
results_luser2
lyz in user coordinates.
Note: This data name contains an uppercase I (i).
Type: double
results_J
The torsional constant.
Type: double
results_NumberOfCells
The number of cells in the section.
Type: integer
results_Pmt
The plastic torsion modulus.
Type: double
results_PrincipalShear0
The principal shear in the y direction.
Type: double
results_PrincipalShear1
The principal shear in the z direction.
Type: double
results_radiusG
The radius of gyration.
Type: double
results_S0
The Ey elastic section modulus.
Type: double
results_S1
The Ez elastic section modulus.
Type: double
results_shearAngle
The shear angle.
Type: double
results_shearCenter0
The y coordinate of shear center.
Type: double
results_shearCenter1
The z coordinate of shear center.
Type: double
results_shearCenterP0
The y coordinate of shear center in principal coordinates.
Type: double
results_shearCenterP1
The z coordinate of shear center in principal coordinates.
Type: double
results_ShearDeform0
The shear deformation coefficient alpha-yy.
Type: double
results_ShearDeform1
The shear deformation coefficient alpha-zz.
Type: double
results_ShearDeform2
The shear deformation coefficient alpha-yz.
Type: double
results_shearStiff0
The shear stiffness factor kyy.
Type: double
results_shearStiff1
The shear stiffness factor kzz.
Type: double
results_shearStiff2
The shear stiffness factor kyz.
Type: double
results_SP0
Ey in principal coordinates.
Type: double
results_SP1
Ez in principal coordinates.
Type: double
results_theta
The principal angle.
Type: double
results_torsionCoeff0
The torsional coefficient in the y direction.
Type: double
results_torsionCoeff1
The torsional coefficient in the z direction.
Type: double
results_Z0
The plastic section modulus Py.
Type: double
results_Z1
The plastic section modulus Pz.
Type: double
results_ZP0
The plastic section modulus Py in principal coordinates.
Type: double
results_ZP1
The plastic section modulus Pz in principal coordinates.
Type: double
results_areaEnclosed
If results_NumberOfCells is non-zero, this is a pointer to the areas enclosed by each cell of the section.
Type: pointer
sketch
The pointer to the sketcher that defines the beam section.
Type: pointer (levels 2, 3, and 4)
solver_id
The solver ID of the entity.
Type: integer
solverkeyword
The name of the solver keyword.
Type: string
solvername
The solver name of the entity for entities enabled for name pool, otherwise the internal name of the entity.
Type: string
source
The source for the beamsection entity. Valid values are:
0 - Generic
1 - Database
2 - Shape
Type: unsigned integer

The following data names are available for sources Generic:

Unless otherwise specified, data names are accessible in level 3 only.

OrientationOrigin0
The y component of the beam section origin.
Type: double
OrientationOrigin1
The z component of the beam section origin.
Type: double
OrientationVector0
The y component of the beam section orientation vector.
Type: double
OrientationVector1
The z component of the beam section orientation vector.
Type: double
setid
The ID of the beam section collector owning the entity.
Type: integer
TorsionFactor
The torsion factor of the beam section.
Type: double
WarpingFactor
The warping factor of the beam section.
Type: double

The following data names are available for sources Database and Shape, and engine FEM:

beamsect_nonstandard
The string name of the beamsection type, or blank if not defined.
Type: string
dt_field
Table containing the tessellation information.
Type: pointer
dt_dataset
Table containing the solver information (material, functions, and so on).
Type: pointer
OrientationOrigin0
The y component of the beam section origin.
Type: double
OrientationOrigin1
The z component of the beam section origin.
Type: double
OrientationVector0
The y component of the beam section orientation vector.
Type: double
OrientationVector1
The z component of the beam section orientation vector.
Type: double
setid
The ID of the beam section collector owning the entity.
Type: integer
sketch
Pointer to the sketcher that defines the beam section.
Type: pointer (levels 2, 3, and 4)
TorsionFactor
The torsion factor of the beam section.
Type: double
WarpingFactor
The warping factor of the beam section.
Type: double

The following data names are available for sources Database and Shape, and engine Thinwall:

Unless otherwise specified, data names are accessible in level 3 only.

beamsect_nonstandard
The string name of the beamsection type, or blank if not defined.
Type: string
OrientationOrigin0
The y component of the beam section origin.
Type: double
OrientationOrigin1
The z component of the beam section origin.
Type: double
OrientationVector0
The y component of the beam section orientation vector.
Type: double
OrientationVector1
The z component of the beam section orientation vector.
Type: double
setid
The ID of the beam section collector owning the entity.
Type: integer
shell_EquationCount
The number of optimization constraint equations linking the variables and vertices in the beam section.
Type: integer
shell_Equations
Pointer to the array of equations.
Type: string
shell_IsOptimization
1 if optimization is enabled, 0 otherwise.
Type: integer
shell_PartCount
The number of separate (welded) parts.
Type: integer
shell_Parts
Pointer to the array of parts in the beam section.
Type: pointer
shell_VariableCount
The number of optimization design variables in the beamsect.
Type: integer
shell_VertexCount
The number of vertices (nodes) in the beamsect.
Type: integer
shell_VertexYInitials
The initial y coordinates of the vertices.
Type: double
shell_VertexZInitials
The initial z coordinates of the vertices.
Type: double
TorsionFactor
The torsion factor of the beam section.
Type: double
WarpingFactor
The warping factor of the beam section.
Type: double
A part consists of an initial flange, and interior section, and an final flange. For each part, the following data names are available:
part_FinalFlangeLength
The number of vertices in the final flange.
Type: integer
part_InitialFlangeLength
The number of vertices in the initial flange.
Type: integer
part_Name
The name of the part.
Type: string
part_NonFlangeLength
The number of vertices in the interior section.
Type: integer
part_Thickness
The initial thickness of the part.
Type: double
part_ThicknessMaximum
The maximum allowed thickness of the part.
Type: double
part_ThicknessMinimum
The minimum allowed thickness of the part.
Type: double
part_VertCount
The total number of vertices in the part.
Type: integer
part_Vertices
Pointer to the array of vertex indices forming the part. They are indices into the shell_Vertex arrays.
Type: pointer

The shell section vertices take two forms, depending on whether or not the section is tagged as an "optimization section." If optimization is enabled, the following data names are available.

Pointers to arrays of length shell_VertexCount:
shell_VertexYMaxima
Pointer to the maximum y coordinates allowed for the vertices.
Type: pointer
shell_VertexYMinima
Pointer to the minimum y coordinates allowed for the vertices.
Type: pointer
shell_VertexZMaxima
Pointer to the maximum z coordinates allowed for the vertices.
Type: pointer
shell_VertexZMinima
Pointer to the minimum z coordinates allowed for the vertices.
Type: pointer
If shell_VariableCount is non-zero then the following data names are pointers to arrays of length shell_VariableCount:
shell_VariableInitials
Pointer to the current values of the variables.
Type: pointer
shell_VariableMaxima
Pointer to the maximum values of the variables.
Type: pointer
shell_VariableMinima
Pointer to the minimum values of the variables.
Type: pointer
shell_VariableNames
Pointer to the names of the variables.
Type: pointer
An equation consists of a dependent vertex and a list of independent vertices and variables. They are linked together in an "unparsed" form. If shell_EquationCount is non-zero then the following data are stored in the shell_Equations variable whose size is equivalent to shell_EquationCount:
equation_DependentVertex
The index of the dependent vertex.
Type: integer
equation_IndependentCount
The number of independent vertices in the equation.
Type: integer
equation_IndependentVertices
Pointer to the array of vertex indices used in the equation.
Type: integer
equation_UnparsedEquation
The actual raw text form of the equation.
Type: string
If equation_IndependentCount and equation_VariableCount are non-zero, then the following data names are available:
equation_VariableCount
The number of design variables in the equation.
Type: integer
equation_Variables
Pointer to the array of design variables used in the equation.
Type: pointer

The following data names are available for source Shape and engine FEM:

beamsect_nonstandard
The string name of the beamsection type, or blank if not defined.
Type: string
OrientationOrigin0
The y component of the beam section origin.
Type: double
OrientationOrigin1
The z component of the beam section origin.
Type: double
OrientationVector0
The y component of the beam section orientation vector.
Type: double
OrientationVector1
The z component of the beam section orientation vector.
Type: double
setid
The ID of the beam section collector owning the entity.
Type: integer
solid_NodeCords
Pointer to the uv coordinates of the nodes.
Type: pointer
solid_NodeCount
The number of nodes in the mesh.
Type: integer
solid_Quad4ElementCount
The number of quad4 elements in the mesh.
Type: integer
solid_Quad8ElementCount
The number of quad8 elements in the mesh.
Type: integer
solid_Tria3ElementCount
The number of tria3 elements in the mesh.
Type: integer
solid_Tria6ElementCount
The number of tria6 elements in the mesh.
Type: integer
solid_Quad4Nodes
Pointer to the node indices for the quad4 elements.
Type: pointer
The node coordinates are in the form of an array {y0,z0,y1,z1,y2,z2,y3,z3,...}. The node indices for the elements index into this array, so the Tria3Nodes array would look like {a0,b0,c0,a1,b1,c1,a2,b2,c2,...}, and a tria whose nodes have coordinates {y3,z3}, {y7,z7}, {y1,z1} would appear in the Tria3Nodes array as {...,3,7,1,...}.
solid_Quad8Nodes
Pointer to the node indices for the quad8 elements.
Type: pointer
The node coordinates are in the form of an array {y0,z0,y1,z1,y2,z2,y3,z3,...}. The node indices for the elements index into this array, so the Tria3Nodes array would look like {a0,b0,c0,a1,b1,c1,a2,b2,c2,...}, and a tria whose nodes have coordinates {y3,z3}, {y7,z7}, {y1,z1} would appear in the Tria3Nodes array as {...,3,7,1,...}.
solid_Tria3Nodes
Pointer to the node indices for the tria3 elements.
Type: pointer
The node coordinates are in the form of an array {y0,z0,y1,z1,y2,z2,y3,z3,...}. The node indices for the elements index into this array, so the Tria3Nodes array would look like {a0,b0,c0,a1,b1,c1,a2,b2,c2,...}, and a tria whose nodes have coordinates {y3,z3}, {y7,z7}, {y1,z1} would appear in the Tria3Nodes array as {...,3,7,1,...}.
solid_Tria6Nodes
Pointer to the node indices for the tria6 elements.
Type: pointer
The node coordinates are in the form of an array {y0,z0,y1,z1,y2,z2,y3,z3,...}. The node indices for the elements index into this array, so the Tria3Nodes array would look like {a0,b0,c0,a1,b1,c1,a2,b2,c2,...}, and a tria whose nodes have coordinates {y3,z3}, {y7,z7}, {y1,z1} would appear in the Tria3Nodes array as {...,3,7,1,...}.
TorsionFactor
The torsion factor of the beam section.
Type: double
WarpingFactor
The warping factor of the beam section.
Type: double

The following data names are available for source Database, and engine Closed Form:

Unless otherwise specified, data names are accessible in level 3 only.

beamsect_dim1
The first parameter definition value for standard sections, 0 otherwise. Type: double
beamsect_dim2
The second parameter definition value for standard sections, 0 otherwise. Type: double
beamsect_dim3
The third parameter definition value for standard sections, 0 otherwise. Type: double
beamsect_dim4
The fourth parameter definition value for standard sections, 0 otherwise. Type: double
beamsect_dim5
The fifth parameter definition value for standard sections, 0 otherwise. Type: double
beamsect_dim6
The sixth parameter definition value for standard sections, 0 otherwise. Type: double
beamsect_dim7
The seventh parameter definition value for standard sections, 0 otherwise. Type: double
beamsect_dim8
The eighth parameter definition value for standard sections, 0 otherwise. Type: double
beamsect_dim9
The ninth parameter definition value for standard sections, 0 otherwise. Type: double
beamsect_dim10
The tenth parameter definition value for standard sections, 0 otherwise. Type: double
beamsect_dim11
The eleventh parameter definition value for standard sections, 0 otherwise. Type: double
beamsect_dim12
The twelvth parameter definition value for standard sections, 0 otherwise. Type: double
beamsect_dim13
The thirteenth parameter definition value for standard sections, 0 otherwise. Type: double
OrientationOrigin0
The y component of the beam section origin.
Type: double
sectiontype
The non-zero beamsection type for standard sections, or 0 for non-standard sections. Type: integer
setid
The ID of the beam section collector owning the entity.
Type: integer
solverid
The solver ID for standard sections. Type: integer
standard_angle
Orientation of the section in 90 degree increments. Type: integer
standard_ParameterInitials
Pointer to the initial values of the parameters. Type: pointer
standard_ParameterMaxima
Pointer to the maximum allowed values of the parameters. Type: pointer
standard_ParameterMinima
Pointer to the minimum allowed values of the parameters. Type: pointer
standard_subtype
The subtype of the standard section, defined by the solver. Type: string
standard_type
The type of the standard section. Type: integer
standard_type_counter
The number of parameters defining the section. This quantity is implied by the type. Type: integer
TorsionFactor
The torsion factor of the beam section.
Type: double
WarpingFactor
The warping factor of the beam section.
Type: double

Version History

2021.1 - Added new data names moduleid, poolid, poolname, and solver_id.

2021.2 - Added new data names internalname and solvername.

2022.1 - Added new data names dt_field, dt_dataset, and sketch.

2022.2 - Added new data names center, computeproperties, partscount, partmanagertable, partmaterial, partname, and partsize.

2024.1 - Deprecated data name config. Added new data names source and engine.