Installing and Configuring Demographics Plug-in
Refer Guidelines for Facial Image Surveillance document for assistance positioning cameras for Demographics. The Demographic analysis requires carefully placed cameras with adequate resolution and lighting.
Demographics Plug-In
Installing the Plug-In
Launch 3VR System Manager.
In the Configure panel, click the plus sign beside the appliance name.
Right-click the Plug-ins folder and select Add Plug-in.
In the resulting Confirm dialog box, click Install to proceed.
Navigate to the folder containing the plug-in file (Plugins.Demographics-Release-7.0.xxxxx.3pg) and click to highlight the file.
Click OK. The plug-in will now begin installing.
When the plug-in is installed, it will appear below Plug-ins in System Manager.
System License Key
Prior to installing and configuring analytics, enter the system-specific license key that was provided to you at the time of purchase.
If you do not have access to the original order confirmation email, you can look up the license key by appliance serial number on the 3VR Partner Portal, go to http://partners.3VR.com and sign in with your Partner Portal account, then click the Obtain System License Key link.
After obtaining the license key, enter it in the License Settings dialog in 3VR System Manager:
In the Configure tab of System Manager, select the appliance name. The system settings will appear to the right.
Click Common Operations, then click License Settings.
In the License Settings dialog, click Add/Update License Key.
Type the license key in the pop-up box.
Click the Add/Update License Key button.
The License Settings window will update to reflect that a license key was applied.
Click Close to return to the Configure tab.
Binding Cameras to Plug-in
Click the plug-in name to view its settings.
On the right side of System Manager, select the Bound Cameras field and click the ... button.
In the Bind Plug-in to Cameras dialog box, click the [√] beside each camera that should have Demographics.
Click OK to return to the Configure panel.
Configuring Per-Camera Plug-in Settings
After binding the plug-in to cameras the links will appear under Bound Cameras for each camera.
Click a link (for example Edit “3. Hallway”) to edit the settings for that camera.
The following settings should be configured for each camera bound to the Demographics plug-in:
Drawing Demographics Inclusion Zone
For each camera that is bound to the Demographics plug-in, you may define one or more zones that will be used for Demographics analysis. The zone name will be appended to the Demographics event that appears in OpCenter. Drawing a zone becomes essential when:
The camera covers an area where Demographics analysis is not desired. For example, if the camera covers a checkout line, you might draw a zone that excludes the cashier.
You wish to isolate areas in the field of view that might generate different demographics data. For example, a store with a camera covering two end-cap displays might want to compare the demographics of people attracted to each display. Note: this use case is typically only relevant when using a megapixel camera with a wide field of view.
Faces appearing in front of the camera are in the field of view for a long time, as in a long hallway. In this case, you might draw an inclusion zone only for the closest half of the camera to avoid
accidentally counting the same person twice. The image to the right exhibits this use of a zone.
If no inclusion zones are specified, the plug-in will default to analyzing the full frame.
Zones are specified in the Zones tab of the Edit Settings window. To create a new zone:
Click the polygon icon.
Click the video player to begin drawing a zone. Each click of the mouse will create a new line segment. To complete the polygon,
click the mouse over your start position.Edit the polygon by clicking and dragging its end points. Sections of the polygon may not overlap.
In this example, we have drawn a Demographics zone in the center of the hallway.When the zone has been created, edit the Name of the zone and make sure that [√]Enabled is checked.
Repeat for any remaining zones you wish to draw in the field of view. The area outside of an inclusion zone will be ignored.
Setting the Eye Distance
The Eye-to-Eye Distance setting should be configured on each camera bound to the plug-in. This setting helps the Demographics
plug-in identify and analyze faces. It can also be used to filter out background faces, if the faces in the foreground are substantially
larger. To set the Eye-to-Eye Distance:
In the Edit Settings window, click the Parameters tab.
Wait until a person appears on camera, then click the pause button.
Click and drag the orange box until it covers both of the person’s eyes. The positioning of the box in the video player is irrelevant.
Save Settings
When you are finished editing the Demographics settings for the current camera, click the OK button at the bottom of the Edit Settings dialog. Repeat the steps in this section for any remaining cameras bound to the Demographics plug-in.
Final Configuration
Restarting System Software
In the Configure panel, right-click the appliance name and select Restart 3VR Software.
In the pop-up box that appears, click Restart to proceed. Wait 1-2 minutes for the software to restart.
Verifying Successful Configuration
To verify that the Demographics plug-in has been correctly configured, check for recent Demographics events in 3VR OpCenter:
In 3VR OpCenter, click the Monitor tab to go to the Monitor panel.
Click camera numbers to select the cameras bound to the Demographics plug-in.
Click the arrow below the camera selector to open the event type drop-down menu.
Select [√]Demographics Event.
Click OK.
If the plug-in has been correctly configured, Demographics events will appear in the Monitor panel as they occur in real-time.
Fine Tuning Plug-in Performance with Optimal Settings
The remaining settings in the Edit Settings dialog should only be modified from their defaults if Demographics results are unsatisfactory.
Parameters Tab
Event Time | Default | Range |
---|---|---|
| 0.2 seconds | 0-10 seconds |
Face Confidence
Threshold | Default | Range |
---|---|---|
| 5 | 0-1 |