Model.morphhandlecreatexyz#

Model.morphhandlecreatexyz(dcollectionhandle, domain, name, xx, yy, zz, sys)#

Creates handle at x,y,z, location for the given system.

Parameters:

  • dcollectionhandle (Collection) – The collection containing the handle entities.

  • domain (Entity) – The entity domain. This argument can also be set to None.

  • name (hwString) – Name of handle(s) to be created.

  • xx (double) – X coordinate of handle to be created.

  • yy (double) – Y coordinate of handle to be created.

  • zz (double) – Z coordinate of handle to be created.

  • sys (int) – The ID of the entity system to create handle in (default = global).

Example#

Create a handle on the specified domain at the x, y, and z coordinates for the given system with dependencies on the handles on the collection#
import hm
import hm.entities as ent

model = hm.Model()

model.morphhandlecreatexyz(
    dcollectionhandle=None,
    domain=ent.Domain(model, 1),
    name="bob",
    xx=1.0,
    yy=2.0,
    zz=3.0,
    sys=3,
)

Note

The name does not need to be unique since this function will create a unique name for each new handle by adding numbers after the name.