Houdini 20.5 Nodes TOP nodes

Filter by Attribute TOP node

Filters upstream work items by their attribute names or values

Since 20.0

This node filters upstream work items based on their attribute data. The filter can be defined based on the names of the the attributes on input work items, or based on specific values for attributes. The attribute name filter uses the Attribute Pattern Syntax and the value filter uses the Filter Pattern Syntax.

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.

Operation

Determines whether the work items that match the filter should be kept or discarded.

Include Output Files

When on, output files from the upstream item are included on the copied work items.

Filter By

Determines whether the filter should be applid to the names of the attributes on the input work items or attribute values.

Attribute Names

Filter based on the attribute names that exist on input work items.

Attribute Values

Filter based on the values of specific attributes on the work items.

Attribute Pattern

When Filter By is set to Attribute Names, this parameter specifies the Attribute Pattern for matching work item attribute names.

Filter Pattern

When Filter By is set to Attribute Values, this parameter specifies the Filter Pattern for matching attribute values.

Inclusive

When Filter By is set to Attribute Values this parameter determines whether value range comparisons should include the end range value.

See also

TOP nodes