.. _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 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:`+ 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%

#. In 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

#. If you need to identify a person either as a ``Local`` or a ``Stranger``, enable and configure :ref:`Extended Event Analysis <extended_event_analysis>`.

    |camera_group_extended_event_analysis_en|

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

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

#. Click :guilabel:`Save`.

#. If :ref:`data replication <replication>` is configured in your system, an additional ``Originating System`` field appears in the :guilabel:`Information` tab. A camera group is replicated to the Processing System, once it is created in the Originating System. By default, the replicated camera group is inactive. In the Processing System, camera groups from the Originating System can be identified by their names. There’s an option to filter camera groups by the Originating System’s name.

    |camera_group_list_replica_en|

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

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

#. In the :guilabel:`Permissions` tab, assign privileges for the camera group by specifying which user roles are allowed to change/view the camera group settings. You can select the desired action for all user roles at once: ``Off``, ``View``, or ``Change``. If there are many user roles in the system, it may take some time.

     |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.

#. When you click the |ellipsis_button| button for a created camera group, the following actions are available:

     .. |ellipsis_button| image:: /_static/ellipsis_button.png
        :scale: 50%

   * Activate/Deactivate
   * Delete
   * Duplicate

   These actions are not applicable to the replicated camera group.