Split by Count TOP node

Splits upstream items into two using a fixed count

Since

20.0

This node splits the list of input work items into two smaller lists of a fixed size. The lists can be split by taking work items from the start, middle or end of the input list, or by selecting the work items randomly.

The left output of the node will have Count work items split off from the input work item list, and the remaining work items will appear on the right output. If the input list is smaller than Count, then all of the work items will be passed through the left output. This order can be inverted using the Invert Selection toggle.

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.

Parameters ¶

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.

Automatic

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.

Choose Count From

Determines where the split work items should be selected from. The items can be taken from the start, middle or end of the input work item list, or they can be randomly chosen. When choosing the work items randomly the node will still ensure that exactly Count work items are split from the original list.

Count

The number of work items to split from the input list.

Random Seed

When Choose Count From is set to Random, this parameter can be used to change the seed to the random number generator that selects which work items to split from the input list.

Invert Selection

By default, the split work items appear on the left output of the node and the remaining work items appear on the right output. Enabling this parameter inverts the outputs so the split work items are produced on the right/second input instead.

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.

Parameters ¶

TOP nodes