Demographics Plug-In

Installing the Plug-In

1. Launch 3VR System Manager.

2. In the Configure panel, click the plus sign beside the appliance
   name.

3. Right-click the Plug-ins folder and select Add Plug-in.
   

   

4. In the resulting Confirm dialog box, click Install to proceed.

5. Navigate to the folder containing the plug-in file (Plugins.Demographics-Release-7.0.xxxxx.3pg) and click to
   highlight the file.

6. Click OK. The plug-in will now begin installing.

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

After obtaining the license key, enter it in the License Settings dialog in 3VR System Manager:

1. In the Configure tab of System Manager, select the appliance name. The system settings will appear to the right.

2. Click Common Operations, then click License Settings.

3. In the License Settings dialog, click Add/Update License Key.

4. Type the license key in the pop-up box.

5. Click the Add/Update License Key button.
   

   

6. The License Settings window will update to reflect that a license key was applied.

7. Click Close to return to the Configure tab.

Binding Cameras to Plug-in

This must be added part of Multi-Excerpt Plug-in content.

Configuring Per-Camera Plug-in Settings

1. After binding the plug-in to cameras the links will appear
   under Bound Cameras for each camera.

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

Zones are specified in the Zones tab of the Edit Settings window. To create a new zone:

1. Click the polygon icon.

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

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

4. When the zone has been created, edit the Name of the zone and make sure that [ ]Enabled is checked.

5. 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:

1. In the Edit Settings window, click the Parameters tab.

2. Wait until a person appears on camera, then click the pause button.

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

1. In the Configure panel, right-click the appliance name and select Restart 3VR Software.

   

2. 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:

1. In 3VR OpCenter, click the Monitor tab to go to the Monitor panel.

2. Click camera numbers to select the cameras bound to the Demographics plug-in.

3. Click the arrow below the camera selector to open the event type drop-down menu.

4. Select [ ]Demographics Event.

   

5. Click OK.

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

Face Confidence