Houdini 20.0 Nodes TOP nodes

Split TOP node

Splits upstream items in two

On this page
Since 17.5

This node uses an expression to split upstream work items into two groups. The work items that match the condition are pass to the left input and the items that don’t are passed on the right.

You can use the Display Outputs parameter to change which group of work items are shown in the node’s work item dot display in the network editor.


Generate When

Determines when this node will generate work items. You should generally leave this set to “Automatic” unless you know the node requires a specific generation mode, or that the work items need to be generated dynamically.

All Upstream Items are Generated

This node will generate work items once all of the input nodes have generated their work items.

All Upstream Items are Cooked

This node will generate work items once all of the input nodes have cooked their work items.

Each Upstream Item is Cooked

This node will generate work items each time a work item in an input node is cooked.


The generation mode is selected based on the generation mode of the input nodes. If any of the input nodes are generating work items when their inputs cook, this node will be set to Each Upstream Item is Cooked. Otherwise, it will be set to All Upstream Items are Generated.

Split Expression

This parameter is evaluated for each upstream work item to determine which output the item should appear on. If the expression returns a non-zero value the work item will appear on the left output, otherwise it will appear on the right output.

Invert Selection

Inverts the behavior of the node. Work items that match the Split Expression will appear on the right output, and work items that fail to match will appear on the left.

Display Outputs

Determines which output to display in the network editor. This parameter is purely for visualization, and has no impact on the behavior of the node when it cooks.


Split Example for Split TOP node

This example demonstrates how to use the Split TOP node to split a list of work items into two separate outputs.

See also

TOP nodes