Houdini 17.5 Nodes TOP nodes

Work Item Expand TOP node

Expands file lists or partitions into multiple work items

On this page

This node can be used to expand ether an upstream item’s output file list or a partition into multiple work items. Example use cases:

A work item has 30 output files associated with it, and you'd like to create a new work item for each of those 30 files.

A partition has some number of work items in it, and you'd like to create a new work item for each group of 5 items in the partition.

TOP Attributes

expandsize

integer

The size of the expanded group of work items. For example if Expansion Type is set to a Fixed Count of 3 and there are 12 items in the partition being expanded, expandsize will be set to 4 on each work item. If there were only 11 items in the partition, then the last set of work items would have an expandsize of 2.

Parameters

Work Item Generation

Whether this node generates static or dynamic work items. You should generally leave this set to "Automatic" unless you know the node’s work items can be computed statically, or that they need to be generated dynamically.

Dynamic

This node always creates dynamic work items: it waits until the upstream work items are known, and generates new work items from the upstream work items.

Static

This node always creates static work items: it creates the number of work items it thinks it needs based on the parameters (and any upstream static items) before the network runs.

Automatic

If the input is static (a static processor, or a partitioner with only static inputs, or a mapper), this node generates static work items, otherwise it generates dynamic work items.

Apply Expansion To

Determines what will be expanded.

Upstream Output Files

For each upstream work item, expands the output files into more work items.

Items in Upstream Partitions

For each upstream partition, expands the items in the partition into more work items.

Expansion Type

Determines the relationship between the elements being expanded and the new work items.

One to One

A new work item will be created for each upstream file or for each work item in the upstream partition.

Fixed Size

The upstream files or partitioned items will be put into fixed size groups based on Value, a new work item will be created for each of those groups.

Fixed Count

The upstream files or partitioned items will be distributed amongst a fixed number of groups based on Value, a new work item will be created for each of those groups.

Value

When using an expansion type other than One to One, this parameter determines the way the upstream elements are grouped.

Examples

example_top_workitemexpand Example for Work Item Expand TOP node

This example demonstrates how to use the workitem expand node in PDG/TOPs.

The following examples include this node.

example_top_workitemexpand Example for Work Item Expand TOP node

This example demonstrates how to use the workitem expand node in PDG/TOPs.

See also

TOP nodes