Spatial Filters

You can use the spatial filter options to perform advanced search and selection of objects based upon user defined areas and/or locations. You can select one or many, from the following options. Descriptions of each option are detailed in the table below:

Filter

Condition

Description

Not in the Region

 

Used to match objects that are not matching the spatial condition specified. This option effectively adds 'Not' to a filter.

Type

 

Used to specify the type of spatial query.

Selected Objects

 

Used to specify objects that can match each by their bounding box, or combine to form a single bounding box. Selecting this option makes available the further filtering options 'Regions' 'Grow Region' and 'Crossing'.

Regions

 

Specifies the number of regions, and is used to set the way in which the regions are matched. This is used in conjunction with the following conditions:

 

Combined

Used to test all of the bounding boxes of matched objects by merging them together into the minimum box that totally encloses all the boxes. That merged box is tested against the objects during statement evaluation.

 

Separate

Used to individually test one or more bounding boxes of matched objects. If any test succeeds, the whole test is positive.

Grow Region

 

Used to specify a size for a bounding box in the scene. You can select an exact size, or choose to grow the box to a specified size. This is used in conjunction with the following conditions:

 

No

Uses the box as defined.

 

Scene Units

Used to grow the box by a specified number of units.

 

Percentage

Used to grow the box to a specified percentage of the diagonal size.

Crossing

 

Used to set the match to occur for objects that touch or cross through the specified box, or parts that are wholly contained in the box. The available options are either Yes (check for crossing), or No (ignore crossing).

Bounding Box

 

Used to specify the x, y, and z, min and max values for a box in the scene, or you can "Get from selected object(s)" if any objects are selected in the scene. You can modify the six values to change the dimensions of the box for your query. Selecting this option also makes available the further filtering options 'Grow Region' and 'Crossing' (described above).

Get box from selected objects

 

Gets the selected objects if any objects are selected in the scene. The six values are automatically updated for your query. This is used in conjunction with following conditions:

 

X Min Max

Used to specify the x min and max values for a box in the scene.

 

Y Min Max

Used to specify the y min and max values for a box in the scene.

 

Z Min Max

Used to specify the z min and max values for a box in the scene.

Contour

 

Used to match the triangles of selected objects against other objects in the scene, effectively asking whether two objects touch. A tolerance can be added to specify that two objects must be within a specified number of scene units of one another. Selecting this option also makes the further filtering option 'Grow Region' (described above) available.