Model.ME_TransformationMatrixSet#

Model.ME_TransformationMatrixSet(part_entity, r1c1, r1c2, r1c3, r1c4, r2c1, r2c2, r2c3, r2c4, r3c1, r3c2, r3c3, r3c4, r4c1, r4c2, r4c3, r4c4, is_relative)#

Sets the transformation matrix for a module.

Parameters:
  • part_entity (Entity) – The object describing the part entity to set the transformation for.

  • r1c1 (double) – Matrix element (row_1,column_1).

  • r1c2 (double) – Matrix element (row_1,column_2).

  • r1c3 (double) – Matrix element (row_1,column_3).

  • r1c4 (double) – Matrix element (row_1,column_4).

  • r2c1 (double) – Matrix element (row_2,column_1).

  • r2c2 (double) – Matrix element (row_2,column_2).

  • r2c3 (double) – Matrix element (row_2,column_3).

  • r2c4 (double) – Matrix element (row_2,column_4).

  • r3c1 (double) – Matrix element (row_3,column_1).

  • r3c2 (double) – Matrix element (row_3,column_2).

  • r3c3 (double) – Matrix element (row_3,column_3).

  • r3c4 (double) – Matrix element (row_3,column_4).

  • r4c1 (double) – Matrix element (row_4,column_1).

  • r4c2 (double) – Matrix element (row_4,column_2).

  • r4c3 (double) – Matrix element (row_4,column_3).

  • r4c4 (double) – Matrix element (row_4,column_4).

  • is_relative (int) –

    0 - An absolute matrix is passed, so internally derive the local relative matrix.

    1 - A relative (to the parent module) matrix is passed in, so use it directly.

Example#

Translate the passed 4 x 4 absolute matrix to a relative matrix, and store this in the hierarchy for part with name “myPart”#
import hm
import hm.entities as ent

model = hm.Model()

model.ME_TransformationMatrixSet(
    part_entity=ent.Part(model, "name=myPart"),
    r1c1=0.994123,
    r1c2=-0.058675,
    r1c3=0.090977,
    r1c4=0,
    r2c1=0.058296,
    r2c2=0.998276,
    r2c3=0.006823,
    r2c4=0,
    r3c1=-0.09122,
    r3c2=-0.001479,
    r3c3=0.99583,
    r3c4=0,
    r4c1=3171.78,
    r4c2=508.679,
    r4c3=1582.44,
    r4c4=1.0,
    is_relative=0,
)