.. _guests: ************************************************* Configure Object Monitoring. Dossier Database ************************************************* This chapter is all about configuring object monitoring and creating the dossier database. FindFace Multi provides video monitoring of the following objects: * human face * human body (silhouette) * car Object monitoring is implemented using a set of default and custom watch lists, e.g., wanted, VIP, etc., and a database of dossiers. You can create as many custom watch lists as necessary. Each dossier contains one or several object photos and is allocated to one or several watch lists. To put an object on monitoring, you need to make a relevant watch list active. You can save mixed data and objects of different kinds to the same dossier as long as these objects are connected. For example, a dossier can contain a face and full-length photo, car photo, and license plate number, all linked to a wanted perpetrator. In this case, the system will be looking for any of these objects in the camera field. .. tip:: To create dossiers in bulk, use the :ref:`batch photo upload ` functionality. .. rubric:: In this section: .. contents:: :local: .. _unmatched-list: Monitoring Unmatched Objects ================================== FindFace Multi features a special pre-configured watch list used for monitoring only unmatched objects (objects that do not match any dossier). This watch list cannot be removed from the system. To edit its settings, navigate to the :guilabel:`Preferences` tab. Click :guilabel:`Watch Lists` and then click :guilabel:`Unmatched` in the table. |unmatched_en| .. |unmatched_en| image:: /_static/unmatched_en.png :scale: 60% .. |unmatched_ru| image:: /_static/unmatched_ru.png :scale: 60% .. note:: To view only unmatched objects in the event list, select :guilabel:`Only without matches` in the :guilabel:`Matches` filter on the :guilabel:`Events` tab. .. _create-list: Create Watch List ================================= You can create a custom watch list. Do the following: #. Navigate to the :guilabel:`Preferences` tab. Click :guilabel:`Watch Lists`. #. Click :guilabel:`+`. |create_list_en| .. |create_list_en| image:: /_static/create_list_en.png :scale: 60% .. |create_list_ru| image:: /_static/create_list_ru.png :scale: 60% #. From the :guilabel:`Label` palette, select a color which will be shown in event notifications for this list. Keep in mind that the right color makes for a quicker response of the person on duty. |list_en| .. |list_en| image:: /_static/list_en.png :scale: 60% .. |list_ru| image:: /_static/list_ru.png :scale: 60% #. Specify the watch list name. Add a comment if needed. #. Select a camera group(s) that will be used to monitor the watch list. If no groups specified, the watch list will be monitored by all active cameras in the system. #. Check :guilabel:`Require acknowledgment` if it is mandatory that events associated with the list be manually acknowledged. #. Check :guilabel:`Enable sound alert` to turn on sound notifications for the list if needed. #. By default, all watch lists in the system are applied the :ref:`generic confidence threshold `. To set an individual threshold for the watch list, check :guilabel:`Confidence Threshold` and specify the threshold value. .. include:: /_inclusions/threshold_important.rst #. Check :guilabel:`Active`. #. Click :guilabel:`Save`. #. On the :guilabel:`Permissions` tab, assign privileges on the watch list, specifying which user roles are allowed to change/view the watch list settings. |list_permissions_en| .. |list_permissions_en| image:: /_static/list_permissions_en.png :scale: 60% .. |list_permissions_ru| image:: /_static/list_permissions_ru.png :scale: 60% #. Click :guilabel:`Save`. .. _create-dossier: Create Dossier Manually ==================================== To create a dossier manually, do the following: #. Navigate to the :guilabel:`Dossiers` tab. #. Click :guilabel:`+`. |create_dossier_en| .. |create_dossier_en| image:: /_static/create_dossier_en.png :scale: 60% .. |create_dossier_ru| image:: /_static/create_dossier_ru.png :scale: 60% #. Attach photos of at least one of the following objects: face, body, car. Supported formats: WEBP, JPG, BMP, PNG. .. important:: A face or body in the photos must be close to a frontal position. Distance between pupils: 60 px. Photos that do not meet the requirements will be rejected with a detailed error description. |dossier_en| .. |dossier_en| image:: /_static/dossier_en.png :scale: 100% .. |dossier_ru| image:: /_static/dossier_ru.png :scale: 100% #. Attach related files. #. Specify the person's name. If necessary, add a comment. #. Specify the car's license plate number if applicable. #. From the :guilabel:`Watch lists` drop-down menu, select a watch list (or several lists, one by one) for the dossier. #. Check :guilabel:`Active`. If a dossier is inactive, it is excluded from the real time monitoring. #. Click :guilabel:`Save`. If a similar dossier already exists in the database, you will be able to merge it with the new dossier, create the new dossier anyway, or cancel creation. .. _batch-upload: Batch Photo Upload ======================== To create dossiers in bulk, use the batch photo upload. Do the following: .. tip:: If you need to upload a large number of photos (more than 10,000), use :ref:`bulk-upload`. .. important:: Supported formats: WEBP, JPG, BMP, PNG. .. important:: A face and body in the photos must be close to a frontal position. Distance between pupils: 60 px. Photos that do not meet the requirements will be rejected with a detailed error description. #. Navigate to the :guilabel:`Dossiers` tab. #. Click :guilabel:`+`. |create_dossier_en| #. Click :guilabel:`Batch Dossier Upload`. |batch_upload_en| .. |batch_upload_en| image:: /_static/batch_upload_en.png :scale: 60% .. |batch_upload_ru| image:: /_static/batch_upload_ru.png :scale: 60% #. Specify the type of objects to detect in the photos. #. Select multiple image files, or a directory. |configure_upload_en| .. |configure_upload_en| image:: /_static/configure_upload_en.png :scale: 70% .. |configure_upload_ru| image:: /_static/configure_upload_ru.png :scale: 70% #. You can use image file names as a basis for names and/or comments in dossiers to be created. Select the necessary option(s). Then configure the automatic name/comment generation rule by appending a custom prefix and/or postfix to the file name. .. tip:: To avoid merging the 3 words into one, use underscore or another symbol in the prefix and postfix. #. From the :guilabel:`Watch lists` drop-down menu, select a classification list for the dossiers. #. Use the :guilabel:`Parallel Upload` option to specify the number of photo upload streams. The more streams you use, the faster it takes to complete the upload, however it requires more resources as well. #. From the :guilabel:`Group Photo` drop-down menu, select the system behavior upon detecting several objects in a photo: reject the photo, upload the biggest object, or upload all objects. #. Click :guilabel:`Start` to launch the photo upload. .. important:: To view the batch photo upload log, click :guilabel:`Logs`. You can then download the log in the ``.csv`` format if needed. |batch_upload_log_en| .. |batch_upload_log_en| image:: /_static/batch_upload_log_en.png :scale: 50% .. |batch_upload_log_ru| image:: /_static/batch_upload_log_ru.png :scale: 50% Filter Dossiers ================================= You can find all dossiers created in FindFace Multi on the :guilabel:`Dossiers` tab. Use filters to sort them out. |filter_dossier_en| .. |filter_dossier_en| image:: /_static/filter_dossier_en.png :scale: 60% .. |filter_dossier_ru| image:: /_static/filter_dossier_ru.png :scale: 60% Purge Dossier Database ============================ You can purge the entire dossier database in one click. To do so, navigate to the :guilabel:`Preferences` tab. Click :guilabel:`Watch Lists`. Click :guilabel:`Delete All Dossiers`. |dossier_delete_en| .. |dossier_delete_en| image:: /_static/dossier_delete_en.png :scale: 60% .. |dossier_delete_ru| image:: /_static/dossier_delete_ru.png :scale: 60% Disable Event Creation for Specific Objects ============================================= Sometimes, it is necessary to omit certain objects during monitoring. One of the most common cases is the objects in advertisement media located in the camera field. Being detected continuously by your system, they can easily overflow the event feed and the database. To prevent this from happening, do the following: #. :ref:`Create a watch list ` that will store the objects excluded from detection. In its settings, check :guilabel:`Do not create events`. |excluded_en| .. |excluded_en| image:: /_static/excluded_en.png :scale: 60% .. |excluded_ru| image:: /_static/excluded_ru.png :scale: 60% #. For each excluded object, :ref:`create a dossier ` and add it to the watch list.