.. _events: ********************************************** Work with Events ********************************************** To monitor the real-time face identification in live videos, use the :guilabel:`Events` and :guilabel:`Episodes` tabs. Besides monitoring, both tabs allow you to access the history of identification events. This section is about the :guilabel:`Events`. .. tip:: Take your security up a notch with :ref:`episodes `. .. tip:: Search for faces through the event database and dossier database on the :guilabel:`Search` tab. .. tip:: To perform the face identification in archived videos, see :ref:`offline-video`. .. important:: You can :ref:`enable sound notifications ` for events related to specific watch lists. In some browsers, the tab with events has to remain in focus to get a sound played. To put a tab in focus, open it, and click anywhere on the page. .. rubric:: In this chapter: .. contents:: :local: .. _event-list: View Identification Events ============================================================== Once a face detected, you will see a notification on the event list. |events_en| .. |events_en| image:: /_static/events_en.png .. |events_ru| image:: /_static/events_ru.png A notification can feature different pieces of information, depending on whether a detected face has a match in the database: * Match not found: a normalized face image, detection date and time, the name of a camera group. * Match found: a normalized face image, the photo from a dossier, the name of a person, similarity between faces, the comment from a dossier, the name of a dossier list, detection date and time, the name of a camera group. .. note:: You can configure the system in such a way that you will get notifications only for the faces with a match. .. important:: In order to pause the notifications thread, click |pause| above the list of events. .. |pause| image:: /_static/pause.png When working with events, the following default filters may come in handy: * :guilabel:`Dossier`: display events only for a selected dossier. * :guilabel:`Watch lists`: display events only for a selected dossier category (watch list). .. note:: To view only unmatched faces on the event list, select :guilabel:`Unmatched` in this filter. * :guilabel:`Matches`: display events only with/without matches, or all events. * :guilabel:`Acknowledged`: display only acknowledged/unacknowledged events, or all events. * :guilabel:`Cameras`: display only events from a selected camera. * :guilabel:`Camera groups`: display only events from a selected group of cameras. * :guilabel:`Start`, :guilabel:`End`: display only events that occurred within a certain time period. * :guilabel:`id`: display an event with a given ID. * :guilabel:`Episode`: display events from the episode with a given ID. Face Liveness and Face Features Recognition ============================================= Depending on the system settings, you can see an estimation of face liveness and/or a result of such face features recognition as gender, age, emotions, glasses, and/or beard. The face liveness detector automatically spots fake faces and prevents photo attacks by distinguishing a live face from a face image. .. note:: The liveness score can be ``null``. It is so when the liveness detector is disabled or unable to estimate the face liveness in the provided image. The face feature recognition result is in the following format: +------------------+-----------------------------------------------------------------------------------------------------------+------------------------+ | Face feature | Result format | Example | +==================+===========================================================================================================+========================+ | Age | Feature: ``age``: number of years | age: 33 | +------------------+-----------------------------------------------------------------------------------------------------------+------------------------+ | Gender | Result: ``male/female`` (feature: ``gender``): algorithm confidence in result | female (gender): 0.95 | +------------------+-----------------------------------------------------------------------------------------------------------+------------------------+ | Emotions | Result: ``angry/disgust/fear/happy/sad/surprise/neutral`` (feature: ``emotions``): algorithm confidence | happy (emotions): 0.99 | | | in result | | +------------------+-----------------------------------------------------------------------------------------------------------+------------------------+ | Glasses | Result: ``eye/sun/none`` (feature: ``glasses``): algorithm confidence in result | none (glasses): 0.87 | +------------------+-----------------------------------------------------------------------------------------------------------+------------------------+ | Beard | Result: ``beard/none`` (feature: ``beard``): algorithm confidence in result | none (beard): 0.91 | +------------------+-----------------------------------------------------------------------------------------------------------+------------------------+ |features_en| .. |features_en| image:: /_static/features_en.png :scale: 60% .. |features_ru| image:: /_static/features_ru.png :scale: 60% Filter events by face features and liveness when needed. |filters_en| .. |filters_en| image:: /_static/filters_en.png :scale: 70% .. |filters_ru| image:: /_static/filters_ru.png :scale: 70% Event Ticket. Acknowledging Event ======================================= In order to navigate to an event ticket from the list of events, click on the face recognition result in a notification (:guilabel:`No matches` or the name of a matching person). An event ticket contains the same data as a relevant :ref:`notification `. It also allows for acknowledging the event. To do so, click :guilabel:`Not accepted` to change the event acknowledgment status. Click :guilabel:`Save`. |accept_en| .. |accept_en| image:: /_static/accept_en.png :scale: 70% .. |accept_ru| image:: /_static/accept_ru.png :scale: 70% .. tip:: If a detected face has a match in the dossiers, you can navigate into a relevant one by clicking on the person’s name in the event ticket. .. tip:: In order to acknowledge all the events, click |check| above the list of events. .. |check| image:: /_static/check.png .. note:: Event acknowledgment can be automated for selected watch lists. Event Ticket. Face Search ====================================== FindFace Security allows you to search detected faces through the list of events and dossier database. To navigate from an event ticket to the search tab, click :guilabel:`Events` or :guilabel:`Dossiers` respectively. |search_ticket_en| .. |search_ticket_en| image:: /_static/event_ticket_search_en.png :scale: 70% .. |search_ticket_ru| image:: /_static/event_ticket_search_ru.png :scale: 70% .. seealso:: * :ref:`face-search`.