Model.beams_to_surfaces

Model.beams_to_surfaces(collection=Collection(), convert1DToSolid=0, domesh=True, meshextension=False, meshsize=0.0, meshtype=2, referencepoint='shearcenter', shellsectiondestination='sortbycurrent', smoothcurves=False, stitchtol=0.0, surfacecreationtype='surfacebyguidelines', tobeamcomponent=0.0, x_breakangle=0.0, y_breakangle=0.0)

Creates surfaces/meshes from 1D beams. The beams must have valid section data assigned.

Parameters:

• collection (Collection) – The collection containing the input entities.

• convert1DToSolid (int) –

  Specifies whether to create 2D surfaces or 3D solids from the beam.

  0 - creates 2D surfaces (default)

  1 - creates 3D solids (valid only for standard sections)

• domesh (bool) –

  Specifies whether the generated surfaces should be meshed. Valid only when convert1DToSolid=0.

  0 - Do not mesh

  1 - Mesh (default)

• meshextension (bool) –

  Specifies whether the generated mesh should be extended to the connected surfaces:

  0 - Do not extend (default)

  1 - Extend

• meshsize (double) – The size of the mesh when domesh=True. The default is the global element size.

• meshtype (int) –

  Specifies the mesh element type when domesh=True:

  0 - Tria

  1 - Quad only

  2 - Mixed (default)

• referencepoint (hwString) –

  Describes the reference point of the beam to be used for surface creation:

  beamnode - Surfaces are congruent with the beam nodes. Not valid when convert1DToSolid=1.

  centroid - Reference point is used as the centroid of the beam section.

  shearcenter - Reference point is used as the shear center of the beam section.

• shellsectiondestination (hwString) –

  The surface/mesh component organization in shell section only.

  sortbycurrent - Current component (default)

  sortbysource - Source beam 1D component

  sortbypart - Component with part-name as name

  sortbythickness - Component with part-name and thickness value as name

• smoothcurves (bool) –

  Specifies to have smooth surfaces or straight surfaces at the beam for shell sections only.

  0 - Straight segments

  1 - Smooth segments (default)

• stitchtol (double) – The stitch tolerance when dosnap=1. The default is the global geometry cleanup tolerance.

• surfacecreationtype (hwString) –

  The surface generation mode for shell sections only.

  surfacebyguidelines - Create surface using the guidelines formed by connecting points of each section (default)

  surfacebysections - Create surfaces at each section

• tobeamcomponent (double) –

  Specifies the surface/mesh component organization:

  0 - Current component (default)

  1 - Source 1D component

• x_breakangle (double) – The angle value in degrees to break the source 1D chain.

• y_breakangle (double) – The angle value in degrees to break the beam offset.

Example

Create surfaces and mixed mesh of size 100.0, snapping the surfaces, extending the mesh, and making the surfaces and mesh congrument with the base mesh

import hm
import hm.entities as ent


model = hm.Model()

model.beams_to_surfaces(
    collection=hm.Collection(model, ent.Element),
    convert1DToSolid=0,
    domesh=True,
    meshextension=True,
    meshsize=100.0,
    meshtype=2,
    stitchtol=0.0,
    tobeamcomponent=0.0,
)