Face and Body Counters

Important

To be able to count human bodies (silhouettes), you first have to enable body detection.

FindFace Multi allows you to count faces and bodies on connected cameras. This functionality can apply to a wide range of situations, such as people counting in queues and waiting areas, monitoring public gatherings, crowding prevention, and more.

You can count objects on each camera independently or collectively on all cameras of one or several camera groups.

The counting method is based on time slices, which means that the system counts faces and bodies in static screenshots taken with a given count interval. The counter shows how the number of faces and bodies changes over time.

In this section:

Configure Counters

To configure counters, open the /etc/findface-security/config.py configuration file and modify the following parameters:

  • COUNTERS_SAVE_FULLFRAME determines saving options of full frames in counters: always, detect - only save if faces or bodies have been detected, never.

  • COUNTERS_FULLFRAME_JPEG_QUALITY: JPEG quality of full frames,

  • COUNTERS_THUMBNAIL_JPEG_QUALITY: JPEG quality of thumbnails.

sudo vi /etc/findface-security/config.py

# counters full frame saving options:
# `always` - save always
# `detect` - save only if faces or bodies 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 one or several camera groups for counting. By default, counting will apply to all cameras within the groups. If necessary, you can disable counting on specific cameras.

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

  6. Check Detect Faces to count faces.

  7. Check Detect Silhouettes to count bodies. Body detection 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/body tracking region within the camera(s) field.

    counter_roi_en

Counter Chart

To see the counter 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 bodies in them, are saved as counter records.

To see the counter records, navigate to the Counters tab. Click on any column for the counter, except ID (leads to the counter settings).

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 bodies 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 bodies.

See also