|
Navigation: Search (Filter) |
Scroll
|
On the Start tab, under Search & Select, activate the Search function.
Settings Overview
Setting |
Default Value |
Description |
|---|---|---|
Case-sensitive |
Off |
Perform a case-sensitive search for the entered text. |
Include hidden geometry |
Off |
Include hidden geometries in the search. |
Standard Search Functions
Five standard search functions are available. For each function, enter the text you want to search for, then press ENTER or select SELECT or UPDATE to start the search.
Wildcards are supported:
▪Use an asterisk (*) to represent any number of characters.
▪Use a question mark (?) to represent exactly one character.
Without wildcards, the search term must match the expected result exactly.
Each search function selects all matching objects for further processing. The number of selected objects is displayed next to the SELECT button.
To display only the selected objects, use one of the following methods:
▪Right-click in the model area and select ISOLATE from the context menu.
▪Select ISOLATE on the START > ON SELECTION tab.
Close the SEARCH pane when it is no longer needed.
Search by Name
Searches the names of all objects in the model structure for matches.
Example: *.1 matches MechanicalTool.1 and Open_body.1, but not Tool.12. To match Tool.12, use *.1* or *.1?.
Search by PMI, Markup, and Text
Searches PMI, markup, and text content, such as dimensions, callouts, and annotations.
This search is not available in 2D documents. For 2D documents, use **Text Search** instead.
Example: To find all length markups, enter l=*.
Search by attribute
Filter all attributes of all objects. You can use only one of the fields or fill out both fields to limit the search results further.
Example: Entering Attribute name=CAD* would select nodes with attributes CAD_DENSITY or CAD_MASS_UNITS. Also entering Value=kilo* would only select CAD_MASS_UNITS=kilograms, but not CAD_DENSITY.
Search by Type
Selects all objects of a specified type.
The drop-down list contains all searchable node types found in the current scene.
The following are the most common object types:
Node Type |
Description |
|---|---|
Root |
Root node that contains all objects associated with a single file import. |
ProductOccurrence |
Contains geometry, nested ProductOccurrence nodes, and typically attributes. |
Ri_BrepModel |
Geometry node based on B-rep or NURBS data. |
Ri_PolyBrepModel |
Geometry node composed of triangles. |
Ri_Set |
Similar to a ProductOccurrence, but can contain only other sets and geometry nodes. |
Ri_PolyWire |
Wire-based geometry node with optional metadata. |
Curve |
Geometry node composed of wires. |
Line |
Geometry node composed of a single line. |
Plane |
Helper geometry from construction. |
AnnotationItem |
PMI node containing annotations or markups. |
CoordinateSystem |
Contains a transformation that can affect measurement results. |
Point |
Geometry node containing a single point. |
PointSet |
Geometry node containing one or more points. |
PointCloud |
Geometry node containing a large number of points. |
Other |
For additional node types, see the XML API documentation. |
Search by Color
Selects objects based on their node color.
▪Select UPDATE to identify all colored nodes available in the current scene. Each row in the table displays a color and the number of nodes assigned to it.
▪Select the Quantity column header to sort the table by the number of matching nodes.
▪Select a row to select all nodes associated with that color. To select multiple colors, hold [CTRL] or [SHIFT] while selecting rows.
Note: Vertex colors are not currently supported.
Search by Rule
Search rules allow you to filter nodes based on virtually any of their properties.
Rules can be written in an intuitive, human-readable format and combined using operators to create more specific search criteria.
Previous Examples
Each of the search functions described above can also be expressed as a search rule:
Function |
Example |
|---|---|
Name |
node.name = "*.1" |
PMI, markup, text |
markup.content = "l=*" |
Attribute key |
node.attribute("CAD*") to find see if an attribute exists |
Attribute value |
node.attribute("CAD*") = kilo* to also query the value |
Type |
node.type = "ProductOccurrence" |
Color |
node.color = #9999CC" |
Operators
As shown in the examples above, different use cases require different operators to define how a feature's result is evaluated.
Operator |
Symbol |
Prose |
Details |
|---|---|---|---|
Equals |
= or == |
is |
Gets two arguments A and B and returns if both of them are equal. |
Not |
! |
not |
Gets one boolean argument A and returns its opposite. |
Or |
| or || |
or |
Gets two boolean arguments A and B and returns if either of them is true. |
And |
& or && |
and |
Gets two boolean arguments A and B and returns if both of them are true. |
Less than |
< (< in XML) |
Gets two numerical arguments A and B and returns if A is strictly less than B. |
|
Less than or equal |
<= (<= in XML) |
Gets two numerical arguments A and B and returns if A is less than or equal to B. |
|
Greater than |
> (> in XML) |
Gets two numerical arguments A and B and returns if A is strictly greater than B. |
|
Greater than or equal |
>= (>= in XML) |
Gets two numerical arguments A and B and returns if A is greater than or equal to B. |
Keywords
Each keyword queries a specific property of a node. Keywords are grouped into categories and may differ slightly in how they are used. Some keywords require an operator.
Unless otherwise noted, each keyword must be prefixed with node., for example, node.name.
Boolean Keywords
Boolean keywords evaluate a condition on a node and return either true or false.
They can be used on their own or preceded by ! or not to invert the result.
