| On this page | |
| Since | 19.0 |
You can use this node to create work items for nodes that match a pattern. The node uses the same pattern matching logic as the network editor’s Find window. For example, the pattern box* matches nodes that begin with the name box.
The names, paths, category, and node type for each matched node are stored as attributes on the work items produced by this node.
The pattern is applied relative to a root node, is specified using the Root Node parameter, and can be applied recursively to child nodes.
TOP Attributes
|
|
str |
The operator type category name. For example, SOP or TOP. |
|
|
str |
The name of the node. For example, |
|
|
str |
The full path to the node. For example, |
|
|
str |
The name of the node’s operator type. For example, torus or box. |
パラメータ
Generate When
このノードがワークアイテムを生成するタイミングを決めます。 このノードがどの生成モードを必須にしているのか、もしくは、ワークアイテムを動的に生成させる必要があるのかどうか分からないのであれば、通常では、これを“Automatic”のままに設定してください。
All Upstream Items are Generated
このノードは、すべての入力ノードが自身のワークアイテムを生成した時にワークアイテムを生成します。
All Upstream Items are Cooked
このノードは、すべての入力ノードが自身のワークアイテムをクックした時にワークアイテムを生成します。
Each Upstream Item is Cooked
このノードは、入力ノード内のワークアイテムがクックされる度にワークアイテムを生成します。
Automatic
入力ノードの生成モードに基づいて生成モードが選択されます。 入力ノードのどれかがその入力のクック時にワークアイテムが生成されている場合、このノードには Each Upstream Item is Cooked が設定されます。 そうでない場合、 All Upstream Items are Generated が設定されます。
Root Node
Specifies the root node that the Node Pattern is applied to.
Node Pattern
Specifies the pattern to use when matching nodes. This parameter uses the same pattern matching logic as the network editor’s Find window.
Sort Nodes By
Determines how the list of nodes is sorted.
None
The nodes are left unsorted. When a specific order is not needed, this option is marginally faster because it doesn’t need to sort the list of matched nodes.
Node Name
The nodes are sorted alphabetically by name. It is possible for multiple nodes to have the same name. For example, like when the nodes are in different subnets and Recursive is on. In this case, it would probably be more appropriate to use sort by Node Path since the node path is always unique.
Node Path
The nodes are sorted alphabetically based on their full file path.
Recursive
When on, the pattern is applied recursively to subnets inside of the root node.
Split Results into Separate Work Items
When on, one work item is created for each matching node. When off, a single work item with all node paths is created.
Inherit Upstream Work Item Index
When Split Files into Separate Items and this parameter are both on, generated work items will inherit their upstream work items' indices. When this parameter is off and Split Files into Separate Items is on, the work items' indices are based on the node’s position within the list of matched nodes.
| See also |
File Pattern
Python Script
