.. _search-objects:

****************************************************
Search Faces in System
****************************************************

FindFace CIBR allows you to search for individuals throughout the entire system.
               
To find an individual, do the following:

#. Navigate to the :guilabel:`Search` tab.
#. Specify an object to search for in one of the following ways:

   * by record's URL or ID
   * by uploading a photo file
  
   |search_en|

   .. |search_en| image:: /_static/search_en.png
      :scale: 70%

   .. |search_ru| image:: /_static/search_ru.png
      :scale: 70%
  
   .. note::

       The search by case cluster is available from the case participant records or by case cluster's URL or ID.


#. If you specified a record URL or ID, select a photo from it. If there are multiple photos, you can select some or all of them. Click the :guilabel:`Apply` button. When you select several objects from the record index, the search range will narrow. The search results will only contain the objects similar to those on the selected photos and within the preset search threshold. 

    |search_record_en|

    .. |search_record_en| image:: /_static/search_record_en.png
      :scale: 60%

    .. |search_record_ru| image:: /_static/search_record_ru.png
      :scale: 60%

#. If you uploaded a photo file, it will be displayed in the new window. If there are multiple objects in the image, select the one of your interest. Click :guilabel:`Search`.

    |search_file_multiple_en|

    .. |search_file_multiple_en| image:: /_static/search_file_multiple_en.png
      :scale: 60%
    
    .. |search_file_multiple_ru| image:: /_static/search_file_multiple_ru.png
      :scale: 60%

    |search_file_en|

    .. |search_file_en| image:: /_static/search_file_en.png
      :scale: 60%
    
    .. |search_file_ru| image:: /_static/search_file_ru.png
      :scale: 60%

#. To search by case cluster associated with a certain case participant, navigate to the participant record, click three dots, then :guilabel:`Search` or specify a case cluster URL or ID on the :guilabel:`Search` tab. The search results will only contain the objects similar to those on the selected case cluster and within the preset search threshold. 

    |search_cluster_participant_en|

    .. |search_cluster_participant_en| image:: /_static/search_cluster_participant_en.png
      :scale: 60%

    .. |search_cluster_participant_ru| image:: /_static/search_cluster_participant_ru.png
      :scale: 60%


    |search_cluster_en|

    .. |search_cluster_en| image:: /_static/search_cluster_en.png
      :scale: 60%

    .. |search_cluster_ru| image:: /_static/search_cluster_ru.png
      :scale: 60%


#. Define the search section – :guilabel:`Record` or :guilabel:`Case cluster`. 

#. You will see the search results appear. If necessary, you can narrow down your search by specifying filters or lowering a similarity threshold. 

   The following filters are available for records:

   * :guilabel:`Watch lists`: display records from selected watch lists.
   * :guilabel:`Filling`: display only empty records, only filled ones, or any records.
   * :guilabel:`Name contains`: filter records by name.
   * :guilabel:`ID`: display a record with a given ID.
   * :guilabel:`Status`: filter records by status (only active, only inactive, or any status).
   * :guilabel:`Match type`: filter records by match type.
   * :guilabel:`Limit`: display records within the specified limit.

   The following filters are available for a case cluster:

   * :guilabel:`Participant`: display only clusters/participants or any.
   * :guilabel:`Acknowledged`: display only acknowledged/unacknowledged case clusters or all clusters.
   * :guilabel:`Matches`: display case clusters only with/without matching the record or all events.
   * :guilabel:`Watch lists`: display only case clusters that contain a record from a selected watch list.
   * :guilabel:`Date and time`: display only case clusters that occurred within a certain period.
   * :guilabel:`ID`: display a case cluster with a given ID.
   * :guilabel:`Photo ID`: display a case cluster with a given photo ID.
   * :guilabel:`Video ID`: display a case cluster with a given video ID.
   
   The following specific filters are available for a case cluster:

   .. note::
      
     Some filters from the list below may be hidden, subject to enabled recognition features.

   * :guilabel:`Age`: display case clusters with people of a given age.
   * :guilabel:`Beard`: filter case clusters by the fact of having a beard.
   * :guilabel:`Emotions`: display case clusters with given emotions.
   * :guilabel:`Gender`: display case clusters with people of a given gender.
   * :guilabel:`Glasses`: filter case clusters by the fact of wearing glasses.
   * :guilabel:`Face mask`: filter case clusters by the fact of wearing a face mask.
   * :guilabel:`Limit`: display case clusters within the specified limit.

   You can sort out results of a search by the following parameters:

   * most similar first
   * the newest first
   * the oldest first