Model.splitelementbyelemselect

Model.splitelementbyelemselect(elem_collection, consider1ds=1, dividequadsoptions='none', midpointoptions='none', reverseorientation=False, splitallsidesoptions='none', splitnumberedges=0, splitoptions='none', useinferredgeometry=1, useadjacentlayer=0, splitfreeedges=True)

Splits shell element patches using patterns based on the patch shared edges.

Parameters:

• elem_collection (Collection) – The collection containing the element entities to split.

• consider1ds (unsigned int) –

  Check for 1D elements during the split operation. Valid values are:

  0 - Splitting 1D elements disabled.

  1 - Splitting 1D elements enabled. (default)

• dividequadsoptions (hwString) –

  The orientation of the diagonals of the selected elements after split. Valid values are:

  ShortestDiagonals - Chooses the shortest diagonal in each element. (default)

  AlignedDiagonals - Aligns all the diagonals in the same direction.

  UnionjackDiagonals - Creates a union-jack pattern out of the diagonals.

  LargestAngleDiagonals - Chooses the diagonal that splits the largest angle in the element.

• midpointoptions (hwString) –

  The element split pattern at the midpoint. Valid values are:

  ToQuads - Splits quads and trias into quads only.

  ToTrias - Splits quads and trias into trias only.

• reverseorientation (bool) –

  Check for switching to the other diagonal within each selected element.

  False - The diagonals are not reversed. (default)

  True - The diagonals are reversed.

• splitallsidesoptions (hwString) –

  The mode in which trias are split if SplitAllSides is the split mode. This option is effective only if splitoptions="SplitAllSides" and splitnumberedges=1.

  Valid values are:

  Quads - Splits a tria into three quads. (default)

  Mixed - Splits a tria into two trias and one quad.

• splitnumberedges (unsigned int) – The number of splits in each edge of the selected elements. Default value is 1.

• splitoptions (hwString) –

  The split mode. Valid values are:

  SplitAllSides - Splits each edge of the selected elements. (default)

  DivideQuads - Divides selected quads along the diagonals.

  Midpoint - Splits selected elements at their midpoint.

• useinferredgeometry (unsigned int) –

  Checks for using inferred geometry from the nodes when the underlying geometry is not specified.

  0 - Do not use inferred geometry.

  1 - Use inferred geometry.

• useadjacentlayer (unsigned int) –

  Checks for using a layer of adjacent elements as transition elements for split operations.

  0 - Do not use adjacent layer. (default)

  1 - Use an adjacent layer.

• splitfreeedges (bool) – Reserved for future development.

Example

Split the elements with IDs 10 and 11

import hm
import hm.entities as ent

model = hm.Model()

model.splitelementbyelemselect(
    collection=hm.Collection(model, ent.Element, [10, 11]),
    consider1ds=1,
    splitallsidesoptions="Quads",
    splitnumberedges=5,
    splitoptions="SplitAllSides",
    useinferredgeometry=1,
    useadjacentlayer=0,
)