5.23.4. Transformation Options

TRANSFORMATION = YES

NO

Turns the transformation option on or off.

WriteTransformedMesh = YES

NO

Flag to enable output of the transformed mesh for mapping. This enables verifying the transformation success. If set to YES, a TransformedMeshFile must be specified (see Input and Output Meshes).

There are three available methods for performing mesh transformation:

  • TRAFO_OPTION is required:

    • Iterative Closest Point (ICP)

    • Four-Points-Congruent Sets (4PCS)

  • TRAFO_OPTION is not required:

    • User-defined translation and rotation

The 4PCS method must be used with caution, as it is fully automatic and may not accurately transform stress tensors and fiber orientations between different coordinate systems. The ICP algorithm is the recommended approach.

The user-defined translation and rotation options are listed underneath TRAFO_OPTION.


Note:  Transformation options are used to transform the source mesh.


TRAFO_OPTION = 4PCS

ICP

Flag that enables specifying the desired transformation option.
NodalPair#i = INT INTDefine nodal pairs to initialize mesh alignment for the ICP algorithm. You must specify a minimum of three nodal pairs, and this option supports up to ten nodal pairs. In each pair, the first integer represents a node ID in the source mesh, and the second corresponds to a node ID in the target mesh. Input values must be space-separated, with each nodal pair on a separate line.
MAX_NUM_ITER = INTMaximum number of iterations to be performed by the 4PCS algorithm.
GLOBAL_ERR = DOUBLEGlobal error measure to accept transformation as best fit 4PCS algorithm.
MATCHING_POINT_DIST = DOUBLE

Maximum distance between points so that they are accepted as matching (4PCS).

PERCENTAGE_OF_MATCHING_POINTS = DOUBLEPercentage of matching points to accept the transformation (4PCS).

Additionally, there are options to apply a custom sequence of user-defined transformations. These transformations are executed in the order in which they are specified:

RotateSRC = DOUBLE;X

DOUBLE;Y

DOUBLE;Z

DOUBLE; DOUBLE DOUBLE DOUBLE

The source mesh rotates by a specified angle (first value, in degrees) around a defined axis. Predefined axes include X, Y, and Z. Alternatively, a custom axis can be specified by providing three space-separated floating-point values following a semicolon (; x y z).
MoveSRC = DOUBLE DOUBLE DOUBLEThe source mesh moves along the user-defined vector (x y z).
ScaleSRC = DOUBLEThe source mesh scales around the origin using the defined scale factor.