Work with Events

This section is about the Events tab.

Important

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

In this chapter:

View Events

Once an object is detected, you will see a notification on one of the event lists: Faces, Bodies, or Vehicles, subject to the object type.

events_en

A notification can feature different pieces of information, depending on whether a detected object has a match in the record index:

  • Match not found: the normalized object image, detection date and time, camera group name, watch lists.

  • Match found: the normalized object image, reference object photo from the related record, name, the similarity between matched objects, comment from the record, watch lists, detection date and time, camera group, attributes.

    events_list_en

Important

In order to pause the notification thread, click pause above the list of events.

When working with events, the following filters may come in handy:

Note

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

Filters for faces, bodies and vehicles

  • Matches: display events only with/without matches, or all events.

  • Watch lists: display events only for a selected watch list.

  • Acknowledged: display only acknowledged/unacknowledged events, or all events.

  • Camera groups: display only events from a selected group of cameras.

  • Cameras: display only events from a selected camera.

  • Date and time: display only events that occurred within a certain period.

  • Video Archive ID: display events from the video archive with a given ID.

  • Record name: display events with a given record name.

  • Episode ID: display events from the episode with a given ID.

  • Event ID: display an event with a given ID.

  • Event’s best shot: display all events of a track, only events with real-time snapshots, only one event with the best snapshot at the end of a track.

  • Line: display only events from a selected line.

  • Line crossing direction: filter events by line crossing direction, none, A → B, B → A.

  • Has reverse crossing: filter events by having/not having a reverse crossing.

Specific filters for faces

  • Age: display events with people of a given age.

  • Gender: display events with people of a given gender.

  • Beard: filter events by the fact of having a beard.

  • Eyes: filter events based on whether the eyes are open or closed or if they are blocked by an object.

  • Glasses: filter events by the fact of wearing glasses.

  • Emotions: display events with given emotions.

  • Liveness: filter events by face liveness.

  • Face mask: filter events by the fact of wearing a face mask.

  • Head turn: filter events by degree of head turn.

  • Head tilt: filter events by degree of head tilt.

Specific filters for bodies

  • Gender by body: display only events with people of a given gender or all events.

  • Age by body: display only events with people of a given age.

  • Headwear: display only events with a person wearing headgear of a given type: hat/cap, hood/headscarf, none.

  • Vest: display only events with a person wearing a vest of a given color.

  • Helmet: display only events with a person wearing a helmet of a given color.

  • Upper clothes color: display only events with a person wearing a top of a given color.

  • Lower clothes color: display only events with a person wearing a bottom of a given color.

  • Upper clothes type: display only events with a person wearing upper body wear of a given specific type: jacket, coat, sleeveless vest, sweatshirt, T-shirt, shirt, dress.

  • Lower body clothes: display only events with a person wearing lower body wear of a given type: pants, skirt, shorts, obscured.

  • Upper body clothes: display only events with a person wearing upper body wear of a given generalized category: long sleeves, short sleeves, no sleeve.

  • Bag on the back: display only events with a person wearing/not wearing a bag on the back.

  • Bag in hand: display only events with a person wearing/not wearing a bag in hand.

  • Fall: display events by the fact a person falls.

  • Smoking: display events with smoking people.

  • Use the phone: display events with people using their phone.

  • Call on the phone: display events with people calling on the phone.

Specific filters for vehicles

  • Make: filter vehicle events by vehicle make.

  • Model: filter vehicle events by vehicle model.

  • Vehicle body type: display only events with vehicles of a given body type: minivan, limousine.

  • Vehicle body color: display only events with vehicles of a given color.

  • Country: display only events with vehicles registered in a given country.

  • License plate number: display an event with a given plate number.

  • Region: display only events with vehicles registered in a given region.

  • License plate color: display only events with a given license plate color.

  • Special vehicle: display only events with vehicles belonging to a given type: police, fire service and EMERCOM vehicles, gas rescue and emergency services, military, municipal vehicles, and others.

  • Vehicle category: display only events with vehicles belonging to a given category: motorcycle, scooter, car, car with a trailer, truck, truck with a trailer, bus, articulated bus, and others.

  • Vehicle weight and body size: display only events with vehicles of a given weight and body size.

  • Vehicle orientation: display only events with vehicles of a given orientation.

Note

License plate region is predicted for the United Arab Emirates (UAE) and Thailand. License plate color is predicted for Saudi Arabia only. The values of these attributes will be marked as unknown for other countries.

Event Ticket. Acknowledging Event

In order to navigate to an event ticket from the list of events, click on the recognition result in a notification.

An event ticket contains the same data as a relevant notification. It also allows for acknowledging the event. To do so, click Acknowledge to change the event acknowledgment status to Acknowledged.

event_accept_en

Tip

If a detected object has a match in the record index, you can navigate to the relevant record by clicking on the name in the event ticket.

Tip

In order to acknowledge all events, click Acknowledge all above the list of events.

Note

Event acknowledgment can be automated for selected watch lists.

Create or Enrich a Record from the Event

You can either enrich a record with a photo of the detected object or create a new record from the event.

In the detailed event view click on Use for record. If a detected object has a match in the record index, you will be able to either create a new record from the event or add a photo of a detected object to an existing record.

enrich_record_en

For an unmatched object there’s only an option to create a new record from the event.

Work Time Reports on Events

See Reports.

Geo

When the map functionality is enabled, events and episodes from cameras with a filled GEO field are displayed on the map.

Click the button map_button to switch to the map view. Events/episodes are displayed on the map as red circles with the number of events/episodes inside. At a distance, events/episodes are grouped into clusters, and upon approaching, the cluster is divided into separate objects.

map_events_episodes_en

Note

If the number of events/episodes exceeds the maximum value of the objects displayed on the map, then all events/episodes on the map will be combined into one cluster. To change the maximum value of the displayed objects on the map, change the maximum_objects_on_map value in the /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py configuration file in the MAP CONFIG EXAMPLE section.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

# MAP CONFIG EXAMPLE
 "map": {
     ...
     "maximum_objects_on_map": 250,
     ...
  },

map_cluster_events_episodes_en

When you click a circle mark of events/episodes, a pop-up window is displayed with thumbnails of events/episodes grouped in a cluster. Click the thumbnail of the event/episodes to view the event/episodes ticket. This event/episode will be highlighted in the left sidebar. The button map_arrow will hide the sidebar and make the map bigger.

map_events_en

Map type

Select the desired map type by clicking map_type:

  • OSM

  • Stamen Toner

Object tracking

The object tracking functionality is enabled, when you filter events/episodes by the record name. Click the map_track button to display moving an object along track points connected by a line from the earliest to the latest event. In this mode, the track points do not display the number of events/episodes inside and have a specific color for each search object. The most recent events/episodes have a lighter indication of the track point and line, and the most recent events/episodes are displayed in a darker color.

map_events_track_en

Real-time indication

If the desired object is detected by the camera in real-time, then the track point will pulse within 20 seconds.

map_events_track_live

After that, the last track point stops pulsating and becomes a more saturated color, and the lines will have a pronounced gradient.

map_events_track_live_stop

Zones

You can manually set an area on the map and save it using the Zones button. To do this, select the area you are interested in on the map at the desired scale. Click map_zones_en, enter a zone name and save it (for example: Moscow, MKAD, Office). Further, you can quickly navigate to the area you are interested in by selecting it from the drop-down list of zones.

To set the default map area and scale for the entire system, open the configuration file /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py and modify default_zoom and default_center values in the MAP CONFIG EXAMPLE section.

# MAP CONFIG EXAMPLE
"map": {
    "enabled": True,
    "default_zoom": 15,
    "default_center": {"lat": 55, "lng": 36},
   ...
  },

Area selection mode

You can select an area of interest from the map by clicking the button map_line. You can add selected events/episodes to the filter and navigate directly to the events/episodes of interest.

map_line_select_events_en