Face and Silhouette Statistics

Important

To collect statistics on human silhouettes, you first have to enable silhouette recognition.

FindFace Security allows you to collect real-time statistics on in-video faces and silhouettes. This functionality can apply to a wide range of situations, such as monitoring public gatherings, ensuring social distancing regulations, crowding prevention, and more.

The stat counter is based on time slices, which means that it counts faces and silhouettes in static screenshots taken with a given count interval. The counter shows how the number of faces and silhouettes changes over time. It does not depict the total accumulated figures.

In this section:

Enable and Configure Counters

By default, counters are disabled. To enable counters, open the findface-security configuration file and modify the SERVICES section as such:

sudo vi /etc/ffsecurity/config.py

...
SERVICES = {
    "ffsecurity": {
        ...
        "counters": True,
    }
...

You will see the Counters tab appear in the FindFace Security web interface.

In the same configuration file, you can modify the following parameters:

  • COUNTERS_SAVE_FULLFRAME determines saving options of full frames in counters: always, detect - only save if faces or silhouettes have been detected, never.
  • COUNTERS_FULLFRAME_JPEG_QUALITY: JPEG quality of full frames,
  • COUNTERS_THUMBNAIL_JPEG_QUALITY: JPEG quality of thumbnails,
# counters full frame saving options:
# `always` - save always
# `detect` - save only if faces or silhouettes have been detected
# `never` - never save full frames
'COUNTERS_SAVE_FULLFRAME': 'always',
'COUNTERS_FULLFRAME_JPEG_QUALITY': 75,
'COUNTERS_THUMBNAIL_JPEG_QUALITY': 75,

Create Counter

To set up a counter, do the following:

  1. Navigate to the Counters tab.

  2. Click +.

    create_counter_en

  3. Specify the counter name.

    counter_en

  4. Select the camera to receive statistics from.

  5. Specify the interval between two consecutive screenshots used for counting.

  6. Check Detect Faces to receive statistics on faces.

  7. Check Detect Silhouettes to receive statistics on silhouettes. Silhouettes recognition has to be enabled.

  8. Make sure that the counter is Active.

  9. Click Save. You will see two new tabs appear.

  10. (Optional) Navigate to the Region of Interest tab to specify the face/silhouette tracking region within the camera field of view.

    counter_roi_en

Stat Chart

To see the stat chart for the last hour, 24 hours, or week, navigate to the Chart tab in the counter settings.

counter_chart_en

Work with Counter Records

Static screenshots taken by a counter, with the number of faces and silhouettes in them, are saved as counter records.

To see the counter records, navigate to the Counters tab and click on the required counter.

counter_records_en

To work with counter records, use the following filters:

  • Counter
  • Cameras
  • Camera groups
  • Time period
  • Number of faces in record
  • Number of silhouettes in record
  • Record id

Set Webhook for Counter

To take it up a notch, configure a webhook for counter records with a specific number of faces and silhouettes.

See also