====== Find Objects ======

Use the "Find Objects" tool to search for objects that correspond with an arbitrary value. There will be searched for this value in all attributes and in all datasets/the visible dataset/selected dataset (depending of the settings). The [[195:desktop:map:query_objects|Query Objects]] tool on the other hand will search for a value in a specified dataset and a specified attribute.

Go to [[195:desktop:workspace:select_objects|]]  to read on about the other ways to select objects.
\\ \\
{{orbit_desktop:how_to_find.png?35&nolink|}}Open the Find Object tool by:
  * Opening the [[195:desktop:map:2d_menus#selection_menu|Map 2D Selection menu]] and choose "Find Objects ...". \\ 
  * Entering an attribute value in the search function in the main toolbar: \\ {{orbit_desktop:mapcanvas:selection:search.png?nolink|}}

{{orbit_desktop:mapcanvas:selection:find_window.png?nolink|}}

^Find Object^^
|Search for|Search for an object by entering an approximate attribute value. Type in the value you search for and press 'Find'. Depending on the size of the datasets to be searched, this process will take less or more time. \\ |
^In Dataset(s)^^
|All Datasets|With this option, Orbit GIS will search in all datasets from the [[195:desktop:dataset:index|dataset list]] for the entered value.|
|All Visible Datasets|With this option, Orbit GIS will search only in the visible datasets for the entered value.| 
|Active Dataset|With this option, Orbit GIS will search only in the [[195:desktop:dataset:index|active dataset]] for the entered value.|
|Find|The Find operation will collect all objects that completely or partly contain the searched value in any of their attributes.|
|Clear Results|Press this button to start all over and to clear the obtained results.|
^Result^^
|The results are listed in an embedded [[195:desktop:tabs:inspector|]]. The same tools are available, but remember that these objects are not selected, they are only the result of the "Find"-process. It is possible to browse through the result list and select an object. See [[195:desktop:tabs:inspector#Object list tools|]] and [[195:desktop:tabs:inspector#spatial content|]].||
\\ 
===== Object Selection Tools =====

With the Object Selection Tools, it is possible to transfer the results of a [[195:desktop:map:find_object|find operation]] or [[195:desktop:map:query_objects|query]] to the [[195:desktop:tabs:inspector|Object Inspector]] by selecting and highlighting them on the map. There are several selection methods, it is for example possible to calculate intersections between the result set of the find operation and the list of selected objects in the Object Inspector. All methods are described below.\\ \\ 
{{orbit_desktop:mapcanvas:selection:object_selection_tools.png?nolink|}}

^Function^Description^
|{{orbit_desktop:mapcanvas:selection:select_and_highlight_v2.png?nolink|}}|It is possible to browse through the results and select and highlight objects. The selected and highlighted objects are then transferred to the [[195:desktop:tabs:inspector|Object Inspector]] and highlighted in the MapCanvas.|
|{{orbit_desktop:mapcanvas:selection:all_objects_v2.png?nolink|}}|When the "all objects"-box is checked before pressing "Select and Highlight", the complete search result will be selected and highlighted.\\ \\ |
|  {{orbit_desktop:mapcanvas:selection:replace_object_inspector_objects_v2.png?nolink|}}  |Replace the Object Inspector objects\\ When this function is activated, the objects in the Object Inspector will be replaced by the obtained objects from the "Find"-process.\\ \\ |
|  {{orbit_desktop:mapcanvas:selection:merge_with_object_inspector_objects_v2.png?nolink|}}  |Merge with the Object Inspector objects\\ When this function is activated, the obtained objects from the "Find"-process will be added to the objects in the Object Inspector.\\ \\ |
|  {{orbit_desktop:mapcanvas:selection:remove_from_object_inspector_objects_v2.png?nolink|}}  |Remove from the Object Inspector objects\\ With this function activated, the obtained objects from the "Find"-process will be removed from the objects in the Object Inspector.\\ \\ |
|  {{orbit_desktop:mapcanvas:selection:exclusive_add_to_object_inspector_objects_v2.png?nolink|}}  |Exclusive add to the Object Inspector objects\\ When this function is activated, the obtained objects from the "Find"-process will be added exclusively to the objects in the Object Inspector. Common objects will be removed from the Object Inspector.|
|  {{orbit_desktop:mapcanvas:selection:retain_common_objects_v2.png?nolink|}}  |Retain the common objects\\ With this function activated, only the common objects of the objects in the Object Inspector and the obtained objects from the "Find"-process will appear in the Object Inspector.|