.. _camera-groups:

***************************************
Camera Groups
***************************************

Camera groups are entities that are used for video sources classification. After processing a video, the system will attribute the object recognition events obtained from the video to a designated camera group. It makes the further event handling and search a lot easier.

To create a camera group, do the following:

#. Navigate to the :guilabel:`Settings` tab. Click :guilabel:`Camera Groups`.
#. Click :guilabel:`+ Add new camera group`.

    |create_camera_group_en|

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

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

#. On the :guilabel:`Information` tab, specify the camera group name. Add a comment if needed.

    |camera_group_en|

     .. |camera_group_en| image:: /_static/camera_group_en.png
        :scale: 80%

     .. |camera_group_ru| image:: /_static/camera_group_ru.png
        :scale: 80%

#. If you want to allocate a certain ``findface-video-worker`` instance to process video streams from the group, create or select one or several allocation labels.

   .. note::
      To complete the allocation, list the labels in the ``/opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml`` configuration file. See :ref:`video-allocation` for details.

#. If you want to deduplicate events from cameras that belong to the same group, i.e. exclude coinciding events, select :guilabel:`Deduplicate events with interval` and specify the deduplication interval (interval between 2 consecutive checks for event uniqueness).

   .. warning::
      Use deduplication with extreme caution. If cameras within a group observe different scenes, some objects may be skipped. See :ref:`deduplication` for details.

#. By default, video from all camera groups is processed using the :ref:`generic confidence threshold <settings>`. To set an individual threshold for the camera group, select :guilabel:`Confidence Threshold` and specify the threshold value.

   .. include:: /_inclusions/threshold_important.rst

#. Click :guilabel:`Save`.
#. On the :guilabel:`Permissions` tab, assign privileges on the camera group, specifying which user roles are allowed to change/view the camera group settings.

     |camera_group_permissions_en|

     .. |camera_group_permissions_en| image:: /_static/camera_group_permissions_en.png
        :scale: 80%

     .. |camera_group_permissions_ru| image:: /_static/camera_group_permissions_ru.png
        :scale: 80%

#. Click :guilabel:`Save`.

#. Make sure that the camera group is active.