# Search Tab

## Search in 3D, Drawings, Documents, and IntelliPID

UDiTH's search function is designed to work across 3D models, 2D drawings, documents, and IntelliPID:

Results are organised by the attributes in which the search string was found. The numbers shown after the attributes indicate the number of matching groups in grey and the affected P&IDs in light blue. When you expand an attribute, the matching groups are displayed as a list, with the corresponding P&ID name highlighted in light blue.

The search function returns two types of result:

<table>
<tr><td Rowspan="2"><img src="./media/IntelliPidSearch.png" width="300">

</td><td>

- **Hard results**: These exactly match the entered search criteria and are displayed in white.
  
- **Soft results**: These include variations of the search string, such as characters that are commonly added or omitted when converting data to another format. For example, both `slab 1 0002` and `slab-1-0002` would return results. These are displayed in light grey.

</td></tr>
</table>

> Ensure that there is enough space to display your search results by dragging the bar below the search box downwards.

Otherwise, only **Select from search results** may be visible.

### Wildcards

You can add wildcards to the beginning or end of your search term:

-   `?` stands for any single character or number.

-   `*` stands for any number of characters or numbers (`a*` matches `a`, `abc`, `a-12`, and so on).

-   With `>`, `<`, `=`, `=>`, and `=<`, you can search for attributes that start with a number. Any numbers following text strings are ignored.

### Search Tools

Use the search tools below the search results to make it easier to identify and select objects.

<table>
<tr><td>

<img src="./media/image60.jpg" width="44" height="44">

</td><td>

Enables or disables automatic camera movement when changing the selected objects.

</td></tr>
<tr><td>

<img src="./media/ButtonHighlight.png" width="44" height="44">

</td><td>

**Highlight all objects of the selected category**

Objects that do not belong to the selection are greyed out and opaque, while selected objects remain fully coloured.

</td></tr>
<tr><td>

<img src="./media/ButtonShow.png" width="44" height="44">

</td><td>

**Show only objects of the selected category**

Objects that do not belong to the selection are hidden, while selected objects remain visible.

</td></tr>
</table>

<table>
<tr><td>

<img src="./media/SearchGoToGroup.png" width="100" height="">

</td><td>

**Go to previous/next group** selects the previous or next group of objects in the selected category and focuses the 3D view on those objects.

</td></tr>
<tr><td>

<img src="./media/SearchGoToObject.png" width="100" height="">

</td><td>

**Go to previous/next part** selects the previous or next part in the selected category and focuses the 3D view on those objects.

</td></tr>
</table>

