GeoSequencer

The GeoSequencer node allows you to quickly process a sequence of PLY, SPLAT, or USD files and output them as a time-sampled USDC file to be manipulated by Nuke's existing splat toolset. You can also load in existing time-sampled USD files to be converted.

In addition to being able to utilize Nuke’s toolset, it's more performant than reading PLY files directly. USDC files are faster to read and are more memory efficient as the attribute data is not loaded all at once.

This is primarily a conversion node, but it is also possible to use this to import the resulting sequence. You can import via GeoImport to use your converted sequences in Nuke. A new GeoImport node is created in your node graph by default once the conversion has completed. This can be turned on or off via the Create GeoImport after creation knob.

Learn more about the workflow at Working with Animated Splats.

Inputs and Controls

Connection Type

Connection Name

Function

No inputs.

Control (UI)

Knob (Scripting)

Default Value

Function

GeoSequencer Tab

Method convert_method From PLY or SPLAT File Sequence

This selects the type of source sequence to read in and populates the node accordingly. Select from: From PLY or SPLAT File Sequence, From Time-sampled USD File Sequence, or From USD File Sequence without Time-samples.

Source Files convert_source_files N/A

Defines the PLY, SPLAT or USD files to be converted to time-sampled USD Value Clip files.

Sequence Files sequence_files N/A The output path for the generated USDC sequence files. These should be numbered by frame in the format "name.###.usdc". Note that the dot on each side of the ### is required.
Conversion Prim Path conversion_primitive_path /root The USD prim path to place prims for the generated sequence. Must be a valid USD prim path.
Missing Parent Type conversion_primitive_parent_type Xform The type of prim to create for any ancestor prims in the path which don’t already exist.
Clip Prim Path clip_primitive_path /root The USD prim path to make animated in the output file. This will only be enabled in the case of USD sequences, and allows a user to pick an existing USD prim path.
Animated Data animated_attributes on (all) Enables attributes to be animated in the Value Clip.
Clip Set clip_set default Displays the clip set.
Output File output_file N/A The USD cache file for the generated clip. The output path for the primary USDC file (a manifest and topology file will also be created here).
Frame Range range_first, range_last 1, 100 The frame range of the source file sequence. It can be edited to provide a different frame range in the generated USDC sequence.
Create GeoImport after generation. create_import_after_generation on Check this to automatically create a populated GeoImport node after the USD Value Clip has been generated, with the output file pre-populated.
Generate Clip clip_generate_button N/A Clicking this will generate the USD Value Clip on disk for use in your composite.