Skip to content

Find Faces (preview)

This guide will help you set up and use the Find Faces feature in IRIS+ Professional. It allows you to filter for faces in videos, enabling you to identify individuals based on their facial features.

Find Faces is currently in preview mode. It is not recommended for production use yet, as it may contain bugs and incomplete features.

Note

Currently, the whole content of an image set is used by Find Faces - running a query for an image set with more than one entities will produce results for all entities it contains. This can be circumvented by creating a separate image set for each person you want to recognize.

Prerequisites

Cameras

  • Motion blur must be disabled on the camera, even at the cost of a more noisy image, as blurred faces can interfere with detections.
  • Indexing for face recognition must be turned on.

Images

  • Only JPEG images are currently supported.
  • The minimum detectable face size in the image is 60x60 pixels.
  • Each image should contain exactly one person, facing the camera.
  • The person's face must be visible and unobstructed in the image.

Setup

  1. Select a video from your workspace Click +Set up New Query.

  2. Select Object Detection from the list of query types.

1. Query Name

Give your query a name to better identify it. A description can also be added (optional).

2. Object Detection Filter

Videos

The thumbnail image of the previously chosen video is displayed here.

Time interval

Time interval

Select a time frame for the analytics to run, depending on the type of video selected above:

  • Earliest: Run the query from the time shown (set during video registration as the beginning timestamp of the video).
  • Latest: Run the query until the time shown (set during video registration as the end timestamp of the video).
  • Given Date: You can select a custom start and end date and time to run the query on. Type the desired date and time or select them by clicking the calendar icon.
  • Live: Analysis is run live, continously.
  • Interval: You can select a custom start and end date and time to run the query on. Type the desired date and time or select them by clicking the calendar icon.
  • Set interval to: Choose from the presets below to run the query on a given time inmterval.

3. Find matching faces

Select an image set from the list. This will be used to filter faces in the video.

A similarity threshold of 0.3 - 0.4 is recommended for regular face recognition queries. This means that faces with a similarity score above the threshold set here will be considered matches. If set to a lower value, the chance of false positives increases.

4. Alarm Integrations (optional)

The query can optionally be integrated with third-party systems, such as Milestone XProtect or a webhook to trigger alarms.

  • Cooldown (in seconds, 10 by default): The minimum time between two alerts sent to the chosen integration.

Milestone XProtect Analytics Event Integration

The query can be configured to send detections to Milestone XProtect, appearing as Analytics Events.

  • Milestone XProtect host address: The IP address of the Milestone XProtect server.
  • Analytics event name: The name of the Milestone XProtect Analytics Event that triggers the query.
  • Event display name (optional): The display name of the event that will be shown in the event list.
  • Description (optional): The description of the event that will be shown in the event list.
  • Timestamp offset (in seconds): The time offset between the Milestone XProtect Analytics Event and the query trigger.

Webhook

The query can be configured to send detections to a Webhook URL.

  • URL: The URL of the Webhook.
  • Custom header key: The key of the custom header.
  • Custom header value: The value of the custom header.

Results

All done - Clicking Save & Run will immediately start the analysis and opens the Result screen of this query. Alternatively, clicking Save & Exit saves the query without running it.