| On this page |
This node partitions work items based on their index value, or using a custom indexing scheme.
Use Dynamic Partitioning
When this toggle is enabled the partitioner will wait for all input work items to be generated before partitioning them. If the input work items are dynamic, this means the partitioner will have to wait for and depend on the parent(s) of those items.
Merge Input Attributes
When this toggle is enabled the partitioner will merge the attributes of the work items in each partition and export them to the partition itself.
Primary Input Rule
Determines how the work items from the node on the first/primary input are partitioned.
All
Each upstream item from the primary input is put into all partitions.
By Index
Each upstream item from the primary input is put into a partition based on its index.
None
Upstream items from the primary input aren’t put into any of the partitions.
Secondary Input Rule
Determines how the work items from the unordered secondary input are partitioned.
All
Each upstream item from the secondary input is put into all partitions.
By Index
Each upstream item from the secondary input is put into a partition based on its index.
Primary Intersection
Each upstream item from the secondary input is put into a partition based on its index, provided that there is an item from the primary input with the same index.
None
Upstream items from the secondary input aren’t put into any of the partitions.
These are advanced parameters that provide finer control over the behavior of the partitioner.
Auto Remove Stale Dependencies
When recooking the node, indicates that the partitioner should remove old dependencies if the partitioning scheme changes as a result of the cook.
Force Re-Evaluation on Cook
Forces the partitioner to re-evaluation the partitioning scheme even if all of the work items are already cooked and no new work items have been added.
Dirtying Mode
The dirty mode parameter offers fine grained control over when a partition is dirtied and the effects on child items when that occurs. This parameter is particularity useful for working around some of the limitation of using dynamic partitioning.
Standard
A given partition will be dirtied when any of the work items in the partition are dirtied. In the case of dynamic partitioning, if any ancestor of a dynamic work item in a partition is dirtied, then All partitions will be dirtied.
When a partition is dirtied all of its children are deleted.
Non-destructive
The same dirtying behavior as Standard, except when a partition is dirtied its children will be dirtied instead of deleted.
Mapping Standard
A given partition will only be dirtied if an item in the partition is dirtied or if the partition’s contents changes as a result of a recook. When the partition is dirtied, any child work items will be deleted.
Mapping Non-destructive
The same as Mapping Standard, except when a partition is dirtied its children will be dirtied instead of deleted.
Sort Contents By
Determines the order that work items are sorted when accessing the partitions on this node. This also affects the sort order of output files on the partition.
None
No sorting is applied - the work items in the partition are handled in no particular order.
Work Item Index
Work items in the partition are sorted based on their index
Input Node Order
Work items in the partition are sorted based on the order of inputs nodes wired into the partitioner itself. If two work items are from the same input, they are then sorted by index.
Attribute
Work items in the partition are sorted based on the attribute specified in the Sort Attribute parameter.
Sort Direction
Determines whether the work items in this node’s partitions are sorted in ascending or descending order.
Sort Attribute
When Sort Contents By is set to Attribute, this parameter is used to determine the name of the attribute to sort by.
Partition When
This parameter is only enabled when using dynamic partitioning. It controls when the partitioning step is performed on the input work items.
Input Items Are Generated
Inputs are partitioned once all of them have been generated.
Input Items Are Cooked
Inputs are partitioned once all of them are cooked. This is required when the partitioning scheme is based on the results of the work items' execution.
This makes this partitioner behave like a
Wait for All except that it may create
multiple partitions.
Partition Target
This parameter is only enabled when using dynamic partitioning. When the target is set, the partition scheme will be applied to the work items in the target TOP node instead of the input work items.
The target TOP node must be a processor in the same graph above this node, and there cannot be any other mappers or partitioner between this node and the target.
example_top_partitionbyindex Example for Partition by Index TOP node
This example demonstrates how to use the partition by index node in PDG/TOPs.
| See also |
Copies attributes from work items in one branch onto work items in another branch.
Creates or sets an attribute on all incoming work items.
Removes attributes from work items.
Parses attribute values from a string, such as a file name.
Starts a feedback loop. TOP nodes within the block execute serially, optionally looping for each incoming work item.
Ends a feedback loop. TOP nodes within the block execute serially, optionally looping for each incoming work item.
Copies data from a CSV file into work item attributes.
Writes work item attributes to a CSV file.
Sends code to a shared server to execute
Ends a command server block.
PDG Scheduler for Thinkbox’s Deadline software.
Downloads the contents of one or more URLs into files.
Edits the variables set in the environment work item command lines execute in.
Error handler for failed work items.
Encodes a sequence of still images as a video file.
Extracts a sequence of still images from a video file.
Compress files into an archive.
Copies a file from one location to another, either at runtime or whenever the node generates.
Decompresses archive files specified by incoming work items into individual files.
Creates work items based on files that match a certain pattern.
Deletes a file at a specified path.
Renames or moves a file.
Conditionally filter upstream work items
Filter upstream work items that fall within a specified frame or attribute range
Generates work items with no attributes that run a command line.
Load points or primitives from SOP or file geometry into work item attributes or a temporary file.
Creates work items that cook a digital asset
Schedules work items using HQueue.
Starts a persistent Houdini command server
Provides easy access to ImageMagick functionality such as mass image convert, resize, and image mosaics.
Invokes a compiled block on input geometry
Extracts data from JSON files and creates attributes
Performs various operations that produce JSON output
Schedules work items on the local machine.
Maps all upstream work items to downstream work items.
Maps upstream work items to downstream work items using an expression
Maps upstream work items to downstream work items based on their index.
Map upstream work items to downstream work items using range values
Starts a persistent Maya command server
Merge all upstream work items
Does nothing
Notify an OP node that some TOP work has completed
Subnet output
Partitions work items based on their attributes
Partitions source items spatially using the bounding items.
Partitions work items into pairs, triples, etc
Partitions work items using existing comparisons
Partitions work items based on an expression
Partitions work items based on their frame
Partitions work items based on their index
Partitions work items based on their node
Partition work items based on range values
Partitions work items spatially using axis-aligned bounding boxes.
Execute Perforce commands through PDG
Maps work items using a Python script
Partitions work items using a Python script
Generate work items using a Python script
A Python-based programmable Scheduler for PDG.
Creates work items that run a script
Starts a python command server.
Creates work items that cook an embedded Alembic ROP node
Creates work items that cook an embedded Composite ROP node
Creates work items that cook a ROP node or network
Creates work items that cook an embedded Geometry ROP node
Creates work items that cook an embedded Mantra ROP node
Creates work items that cook an embedded USD ROP node
Creates work items that render an IFD file with Mantra
Sends an email
Creates shotgun entities
Deletes entities from shotgun
Downloads shotgun attachments
Finds shotgun entities
Starts a persistent Shotgun command server
Updates shotgun entities
Uploads files to shotgun
Sorts work items by a list of attributes
Splits upstream items in two
Container for TOP nodes
Switch which between network branches
Cooks another TOP network
Input to a TOP fetch-ed network
Writes text to a new file or appends to an existing file.
Schedules work items using Pixar’s Tractor.
Creates work items from file references found in a USD stage.
Creates work items from prims found in a USD stage.
Creates work items that render a USD file.
Waits for all upstream work items to complete.
Creates work items with varying attribute values.
Expands file lists or partitions into multiple work items
Extracts data from an XML file and creates a string attribute containing the data