Model.reviewmaterialorientation#

Model.reviewmaterialorientation(collection, onlyorient, normal_size, color)#

Reviews material orientation. Reads and plots the first axis of the element (material) coordinate system for selected elements. When review is complete, the function Model.vectorsoff() must be run.

Parameters:
  • collection (Collection) – The collection containing the entities to review. Valid entities are elements and properties.

  • onlyorient (int) –

    0 - The new x-element directions are shown as continuous gradient lines starting and ending on free edges.

    1 - The new x-element directions are displayed as vectors starting from the element centroid.

  • normal_size (double) – If only_orient=1, this defines the size of the displayed vectors.

  • color (int) – The color of the vectors or lines. Valid values are 1-64.

Example#

Review the element ( material ) coordinate system of the displayed elements with blue vectors of size 3.0#
import hm
import hm.entities as ent

model = hm.Model()

model.reviewmaterialorientation(
    collection=hm.CollectionByDisplayed(model,ent.Element),
    only_orient=1,
    normal_size=3.0,
    color=7,
)