| On this page |
This node partitions work items based on their index value, or using a custom indexing scheme.
Use Dynamic Partitioning
When on, the partitioner waits for all input work items to be generated before partitioning them. If the input work items are dynamic, then the partitioner has to wait for and depends on the parent(s) of those items.
Merge Input Attributes
When on, the partitioner merges the attributes of the work items in each partition and exports 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 on, the partitioner removes old dependencies when recooking the node if the partitioning scheme changes as a result of the cook.
Force Re-Evaluation on Cook
When on, forces the partitioner to re-evaluate the partitioning scheme even if all of the work items are already cooked and no new work items have been added.
Dirtying Mode
Determines when a partition is dirtied and the effects on child items when that occurs. This is particularity useful for working around some of the limitations of using dynamic partitioning.
Standard
A given partition is 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 are 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 are dirtied instead of deleted.
Mapping Standard
A given partition is only dirtied if an item in the partition is dirtied or if the partition’s contents change as a result of a recook. When the partition is dirtied, any child work items are deleted.
Mapping Non-destructive
The same dirtying behavior as Mapping Standard, except when a partition is dirtied, its children are dirtied instead of deleted.
Split by Attribute
When on, the node splits input work items by the specified attribute before partitioning them. The partitioning logic is evaluated on the list of work items for each distinct attribute value. Work items with different attribute values are always put into different partitions.
Missing Attribute
Determines how the node handles work items that are missing the split attribute.
This parameter is only available when Split by Attribute is on.
Ignore Work Item
Work items that are missing the split attribute are not put into any of the partitions.
Partitioner Defines Behavior
The partitioner node determines what happens to work items that are missing the split attribute. Typically a partitioner node that exposes this option will rename this menu entry to describe the actual operation it performs.
Add Work Item to All Partitions
Work items that are missing the split attribute are put into all of the partitions.
Sort Contents By
Determines the order that work items are sorted in 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 input nodes wired into this node. 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 field parameter.
Sort Direction
Determines whether the work items in this node’s partitions are sorted in ascending or descending order.
Sort Attribute
Specifies the name of the attribute to sort by.
This parameter is only available when Sort Contents By is set to Attribute.
Partition When
Determines when the partitioning step is performed on the input work items.
This parameter is only available when Use Dynamic Partitioning is on.
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 node except that it may create multiple partitions.
Partition Target
Specifies the target TOP node for the partition. The partition scheme is applied to the work items in the target TOP node instead of this node’s 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 partitioners between this node and the target.
This parameter is only available when Use Dynamic Partitioning is on.
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 |
Creates and modifies array attributes on work items.
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.
Renames attributes on 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.
The 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.
Create warnings or errors when a condition is met
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.
Creates a range of 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.
Loads points or primitives from a SOP or geometry file 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.
Controls the scheduling of in-process work items
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
Starts a persistent Nuke command server
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
Generates work items on the specified range
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 prims found in a USD stage.
Creates work items from file references 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 XML into Work Item attributes