| On this page |
A partition is created for each bounds item, and includes all of the source items that overlap with that bounds item. This is done by comparing each source item with each bounds item, using the Compiled Block to do the test.
The default internal Compiled Block creates a Bounding Box for the bounds item to do the overlap test. This test can be overridden by specifying another external Compiled Block. The Compiled Block must return non-empty geometry if there is overlap. Therefore an empty geometry result means that there is no overlap.
Parameters
Bounding Geometry Parms
The geometry specifying the bounds for the intersection test.
Geometry Source
Determines where to load the geometry from.
SOP Node
Lets you specify the path to a SOP node in the current HIP file. This TOP node then cooks the SOP node and stores its output geometry.
Note
You can use the Evaluation Time parameter to cook the SOP node at a different point in the timeline.
Upstream Output File(s)
Gets the file path from the incoming work item’s output attribute and reads the file in as geometry. Files are filtered using the File Tag parameter. If multiple files are found with same tag, the Multiple Inputs parm is used to determine which files to import.
For example, this is useful when you want to use a 
File Pattern node to generate work items representing geometry files and then load them in this node.
Upstream Geometry Data
Gets the geometry data from an attribute on the incoming work item. For example, this is useful when you have geometry data loaded by a previous Geometry Import node.
Custom File Path
Loads the geometry data from the file located in the File Path file directory.
SOP Path
The network path of the SOP node to cook. For example, /obj/geo1/output1.
This parameter is only available when Geometry Source is set to SOP Node.
Evaluate with Work Item Attributes
Turn on when your SOP network uses @attribute expressions to pull values from work items (for example, like with for wedging). If you use @attribute expressions, the node needs to cook the SOP separately for each work item. If you do not use @attribute expressions, the node only needs to cook the SOP once.
This parameter is only available when Geometry Source is set to SOP Node.
File Tag
Loads from only file paths tagged with this file tag. For example, file/geo.
This parameter is only available when Geometry Source is set to Upstream Output File.
Load Geometry During Cook
Loads the geometry when each work item cooks instead of when work item are generated. This is useful if you want to load geometry that is produced when an upstream work item cooks, or if the geometry files being loaded are large.
This parameter is not available when Geometry Source is set to SOP Node.
Multiple Inputs
Determines what to do if an upstream work item has more than one path in the output attribute.
This parameter is only available when Geometry Source is set to Upstream Output File.
Import First File
The first file that matches the specified File Tag is imported, and the remaining files are ignored.
Import and Merge All Files
All matching files are merged and imported as a single piece of geometry
File Path
The file path for the geometry file to import.
This parameter is only available when Geometry Source is set to Custom File Path.
Source Geometry Parms
The source geometry that will be tested for intersection.
Geometry Source
Determines where to load the geometry from.
SOP Node
Lets you specify the path to a SOP node in the current HIP file. This TOP node then cooks the SOP node and stores its output geometry.
Note
You can use the Evaluation Time parameter to cook the SOP node at a different point in the timeline.
Upstream Output File(s)
Gets the file path from the incoming work item’s output attribute and reads the file in as geometry. Files are filtered using the File Tag parameter. If multiple files are found with same tag, the Multiple Inputs parm is used to determine which files to import.
For example, this is useful when you want to use a File Pattern node to generate work items representing geometry files and then load them in this node.
Upstream Geometry Data
Gets the geometry data from an attribute on the incoming work item. For example, this is useful when you have geometry data loaded by a previous Geometry Import node.
Custom File Path
Loads the geometry data from the file located in the File Path file directory.
SOP Path
The network path of the SOP node to cook. For example, /obj/geo1/output1.
This parameter is only available when Geometry Source is set to SOP Node.
Evaluate with Work Item Attributes
Turn on when your SOP network uses @attribute expressions to pull values from work items (for example, like with for wedging). If you use @attribute expressions, the node needs to cook the SOP separately for each work item. If you do not use @attribute expressions, the node only needs to cook the SOP once.
This parameter is only available when Geometry Source is set to SOP Node.
File Tag
Loads from only file paths tagged with this file tag. For example, file/geo.
This parameter is only available when Geometry Source is set to Upstream Output File.
Load Geometry During Cook
Loads the geometry when each work item cooks instead of when work item are generated. This is useful if you want to load geometry that is produced when an upstream work item cooks, or if the geometry files being loaded are large.
This parameter is not available when Geometry Source is set to SOP Node.
Multiple Inputs
Determines what to do if an upstream work item has more than one path in the output attribute.
This parameter is only available when Geometry Source is set to Upstream Output File.
Import First File
The first file that matches the specified File Tag is imported, and the remaining files are ignored.
Import and Merge All Files
All matching files are merged and imported as a single piece of geometry
File Path
The file path for the geometry file to import.
This parameter is only available when Geometry Source is set to Custom File Path.
Compiled Block Parms
This allows to override the default intersection test by specifying another Compiled Block.
Compiled Block
The Compiled Block used for the overlap test. The default Compiled Block uses a Bounding Box for the bounds item. The Compiled Block returns non-empty geometry if there is overlap. Therefore an empty geometry result means that there is no overlap.
Compiled Block Bounds
When using another Compiled Block, as an override, this should specify the Block Begin Compile’s Input Name, so it can be used to forward the bounds input items.
Compiled Block Source
When using another Compiled Block, as an override, this should specify the Block Begin Compile’s Input Name, so it can be used to forward the source input items.
Examples
example_top_partitionbybounds Example for Partition by Bounds TOP node
This example demonstrates how to use the partition by bounds node in PDG/TOPs.
| See also |
Partition by Tile
