*beamsectioncreatefromentities

Creates a beamsection entity from in-plane entities.

Syntax

*beamsectioncreatefromentities entitytype=<value> mark=<mark_id> ?option1=<value1>? ?option2=<value2>? … ?optionN=<valueN>?

Type

HyperMesh Tcl Modify Command

Description

Create a beamsection entity from in-plane entities.

Inputs

entitytype=<value>
The type of input entity. Valid values are elements, lines and surfaces. If config=3 (shell section), surfaces are not allowed.
mark=<mark_id>
The ID of the mark of input entities. Valid values are 1 and 2.
allowshellparts=<value>
If config=4 (elastic section), create shell parts from open segments.
0 - Do not allow
1 - Allow (default)
allowsolidparts=<value>
If config=4 (elastic section), create solid parts from closed segment loops.
0 - Do not allow
1 - Allow (default)
center=<value>
The reduction point to compute beamsection properties.
0 - User
1 - Centroid
2 - Shear center (default)
3 - Frame center
centerposition={x y z}
If center=0, the global plane center to consider as reduction point to compute beamsection properties.
config=<value>
The beamsection config.
0 - Solid
3 - Shell
4 - Elastic (default)
contactdistance=<value>
If config=4 (elastic section), the maximum contact distance between two separated domains.
value < 0.0 - The maximum contact value will be considered as 0.8-times the average element size. (default)
value = 0.0 - No contact
value > 0.0 - Defines the maximum contact distance between elements from two different domain loops. The contact is then ensured by a classical MPC method, using a mortar finite elements method.
createsketch=<value>
Creates a sketch from beamsection topology after properties computation. It will map the domain description to the sketch topology.
0 - Do not create (default)
1 - Create
defaultmaterial=<value>
If config=4 (elastic section), the default material rule to compute beamsection properties. If the value is not set to geometric, the average moment of inertia will be evaluated considering Young’s modulus and Poisson’s ratio from entity intersected by a plane. It results in the evaluation of stiffness terms as EA, EIyy, EIzz, GJ of the full section. The material impacts the centroid and shear center location as well as warping properties. If a region is fully defined (no mix of entities with and without material assigned), the max, mean, nearest and user values are ignored. If a region is missing material property, then this parameter defines how to consider material for undefined regions.
1 – Geometric: section properties are derived from the area moments of inertia without considering any material. User can select a target material that will be assigned to the created property. (default)
2 - Max: applies the highest Young Modulus (and related Nu) from the list of materials seen in intersection.
3 - Mean: applies the averaged Young Modulus (and Nu) from the list of materials seen in intersection.
4 - Nearest: applies the highest Young Modulus (and related Nu) from the closest region with material assigned.
5 - User: applies target material for this region. Requires material selection.
mergetol=<value>
The merge tolerance to close gaps. If config=3 (shell section), all segments extremities in tolerance will be merged. If config=0 (solid section) or config=4 (elastic section), and entitytype=LINES or entitytype=ELEMS for 1D elements, segments in tolerance will be merged to create closed loops.
normal={x y z}
The plane normal to use while creating beamsection. If not provided, the normal will be inferred from source entities.
order=<value>
If config=0 (solid section) or config=4 (elastic section), the order to use for closed section meshing. The element order will change the interpolation functions, so properties may vary.
1 - First order (default)
2 - Second order
usermaterial=<value>
If defaultmaterial=5, the ID of the material to be used to compute beamsection properties.
yaxis={x y z}
Beamsection y axis in global system. If not provided, the y axis will be inferred from source entities using the principal axis.
welddistance=<value>
If config=3 (shell section), the maximum distance for autoweld on two separated domain loops.
value < 0.0 - Autoweld applied in all cases
value = 0.0 - No autoweld applied (default)
Autoweld applied between two domains only if the minimum perpendicular distance between both domains is less than welddistance value.

Examples

To create a solid section from surfaces using the centroid as center:
*createmark surfs 1 10
*beamsectioncreatefromentities entitytype=SURFS mark=1 config=0 center=1
To create a shell section from lines, weld the parts and create a sketch:
*createmark lines 1 all
*beamsectioncreatefromentities entitytype=LINES mark=1 config=3 welddistance=-1.0 createsketch=1
To create an elastic section from lines with only solid parts and create a sketch:
*createmark lines 1 all
*beamsectioncreatefromentities entitytype=LINES mark=1 config=4 mergetol=1e-3 allowshellparts=0 createsketch=1 normal={1.0 2.0 3.0} yaxis={4.0 5.0 6.0}

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

2022.2