ML Deformer attributes

ML Deformer Attributes

ML Model Location

Path to the folder containing trained models.

Target Morph

Toggle visualization of the Target deformation (the "goal" for the ML Deformer to approximate.)

Typically, when you are finished animating your scene, you will turn on Target Morph and set the Envelope to 1.0 to reactivate the original high quality deformation for final renders.

Target Morph Envelope

Note: This envelope slider is active only if you turn on the Target Morph option.

Lets you adjust the morph (in %) between the trained approximation and the Target.

Control Values

Lets you Select, Create, or Assign a Control Collector.

You can also click Select Control Collector to highlight the collector in the Node Graph. A Control Collector specifies which inputs are passed into the ML Model. See the Control Collector attributes.

ML Deformer Attributes Table

Index

The placement in the array.

ML Model

Right-click on a cell to select the Trained Model to use. The ML Model contextual menu appears:

ML Model contextual menu

Option	Function
Select Model	Lets you choose the ML model to apply to the specified geometry.
Enable Model/Disable Model	Turns the deformation on the Source model on or off. This is the same as activating or disabling the Enabled button in the ML Deformer Attributes list.
Reload Model	Reloads the ML model with the latest changes.
Export Training Data...	Opens the ML Deformer Export Training Data window, where you can export the sample poses that will be used to train the model.
Train Model...	Opens the ML Deformer Training Settings where you can configure the training settings and start the training of the model.
View Training Results...	Opens the Training Results window to let you evaluate the effectiveness of the most recent training, including the error rates and how they differ between the Training and Validation results. A large difference between the Training and Validation results could be an indication of overfitting of the data. See the explanation of Overfitting in the ML Training Results window.
Apply Mesh Compare	Lets you apply a heat map to review the quality of the ML target geometry compared to the original geometry. The options include: Visualize Quality: Displays the spatial accuracy of the output mesh vertices compared to the source. Visualize Impact: Displays the amount of new deformation that is being applied by the ML Deformer (i.e. the amount of "work" the deformer is doing) on source mesh vertices. Enable Mesh Compare: Quickly toggle the visualization on and off. This includes displaying vertex colors. White areas represent a perfect match, while red areas represent areas with a large deviation. You can customize the heat map's colors, falloff, threshold, and other options in the connected meshCompare node. Note: Mesh Compare can negatively impact scene performance. Thus, we recommend using Mesh Compare only as a diagnostic tool, and deleting the meshCompare node when you're finished.
Open Training Job Monitor...	Opens the ML Training Job Monitor where you can view the progress of the training process.

Enabled

Toggles the ML Deformer approximation on or off.

Target Geometry

Right-click a cell to select the deformed geometry the ML model should approximate. The Target Geometry contextual menu appears:

Option	Function
Select Target Geometry	Highlights the object currently assigned as the Target geometry, or the complex deformation being approximated, in the Viewport, Outliner, and Node Editor.
Select Output Geometry	Highlights the object currently assigned as the Output, or the geometry that is being deformed by the ML Deformer, in the Viewport, Outliner, and Node Editor.
Replace Target with Selected	Assigns the currently selected object as the Target, that is, the geometry that the model is going to approximate.
Create Target for Deformers Post ML Deformer	Creates a Target mesh based on the deformers that follow ML deformer in the deformation stack and lets you approximate other deformers in the stack without having to set up the Target manually.
Disconnect Target	Lets you unassign the object currently assigned as the Target.

Geometry

Right-click a cell to select the base geometry. The base geometry defines what vertices should be deformed by the ML Deformer.

Pose Generation

Lets you create a separate Control Collector for sample generation. See Control Collector attributes for more about controls settings.