The example-based ML nodes represent example sets using geometries that consist exclusively of packed primitives, see ML Example for more details. ML Extract Example is a utility node that allows you to extract a single example.

If the Keep Packed option is off, then ML Extract Example will output the embedded geometry of the input component of the example (ignoring the target component, if it exists). Unlabeled examples consist of only an input component.

See Machine Learning documentation for more general information.

ML Extract Example obtains a single example from a geometry entirely of packed primitives, each represents an example. These geometry may have been generated by ML Attribute Generate or ML Pose Generate, at the start of a chain of nodes that performs synthetic data set generation. The packed primitives can also be examples that were generated one by one using ML Example. For example, using a SOP for loop.

ML Extract Example makes it easy to feed a single example into a procedural network. For example, when using a TOP setup to generate a data set, this node can be used to extract the example that corresponds to a single work item by using the corresponding TOP attribute as the index.

Instead of extracting a single example, ML Extract Example can access a single part of a partition created by ML Example Partition.

ML Extract Example can also be a convenient tool for inspecting or visualizing a single example.