Model.hm_mapelementstoplane

Model.hm_mapelementstoplane(collection)

Performs fast unfolding of a given set of connected shell elements onto a plane, while minimizing deformation for each element.

The result is returned as a list with a number of entries equal to the number of nodes in the set of selected elements.

Each entry in the list consists of the node ID and mapped node u-v coordinates onto the plane.

Parameters:

collection (Collection) – The collection containing the entities of the shell elements to map.

Returns:

• hwReturnStatus - Status object

• HmQueryResult - Result object containing the output values:

  • Result (HmQueryResultList)-Result list object containing HmQueryResult objects with the following output data:

    • node (Entity) - Node corresponding to a selected element onto the plane - Entity Type: Node

    • uCoordinate (double) - Mapped node u-coordinate onto the plane

    • vCoordinate (double) - Mapped node v-coordinate onto the plane

Example

Get the mapping for all elements to a plane

import hm
import hm.entities as ent

model = hm.Model()

elems = hm.Collection(model, ent.Element, populate=True)

_, resultObj = model.hm_mapelementstoplane(collection=elems)

resultlist=resultObj.Result

for result in resultlist:
    print("node", result.node)
    print("uCoordinate", result.uCoordinate)
    print("vCoordinate", result.vCoordinate)