Model.morphvolumecreate#

Model.morphvolumecreate(ecollection, xd, yd, zd, buff, sysid, han, ord, tan)#

Creates a matrix of morph volumes.

Parameters:

  • ecollection (Collection) – The collection containing the element entities to be enclosed.

  • xd (int) – Density of matrix in x direction.

  • yd (int) – Density of matrix in y direction.

  • zd (int) – Density of matrix in z direction.

  • buff (double) – Percentage buffer zone around matrix.

  • sysid (int) – ID of system used to orient matrix.

  • han (int) –

    0 - Do not create handles for morph volumes.

    1 - Create handles for morph volumes.

  • ord (int) – Order of morph volumes.

  • tan (int) –

    0 - No tangency.

    1 - Make neighboring morph volume edges continuously tangent.

Example#

Create a matrix of morph volumes xd by yd by zd in number aligned with the specified coordinate system ( or the global system if zero ) and enclose the elements selected interactively#
import hm
import hm.entities as ent

model = hm.Model()

model.morphvolumecreate(
    ecollection=hm.CollectionByInteractiveSelection(model, ent.Element),
    xd=3,
    yd=3,
    zd=3,
    buff=10.0,
    sysid=0,
    han=1,
    ord=1,
    tan=1,
)

Note

The order of the morph volumes (ord) refers to the number of mid-nodes along each edge with an order of one meaning there will be no mid-nodes, an order of two meaning that there will be one mid-node, and so forth.

If the specified system is cylindrical, the matrix will be laid out in a cylindrical fashion with xd, yd, and zd, relating to the radial, circumferential, and depth densities.

If a single morph volume is being created and a cylindrical system is specified, the system is internally converted int a rectangular system for aligning the morph volume.