Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 23 Current »

Getting Started

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

Entering Dwell License Key

The next step in plug-in configuration is to license the Dwell plug-in.

  1. In the Configure panel, select the plug-in name to view its settings.

  2. Click Edit Settings.

  3. Copy (select the text and press Ctrl+C) the 23-character code from the Licensing Question field in the Edit Global Settings dialog.

  4. Paste (press Ctrl+V) the licensing question into an email to 3VR Technical Support (support@3VR.com).

  5. 3VR Technical Support will respond with the matching 27-character key within 1 business day.

  6. Copy (CTRL+C) and paste (CTRL-V) the key from the email into the License Key box in System Manager.

  7. Click OK to save and return to the Configure panel.

The Licensing Status field will display “Invalid” until the 3VR system software is restarted.

In your email, you must include the system serial number and the number of cameras of Dwell purchased (reference the P.O. number of the order if available). Please also provide your contact information and the customer/reseller company name.

Registering with System License Key

Prior to installing and configuring analytics, you must 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, sign in with your Partner Portal account, then click the Obtain System License Key link).

After you have obtained the license key, enter it in the License Settings dialog in System Manager:

  1. In the Configure panel 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 panel.

Entering System License Key

Prior to installing and configuring the Queue Line plug-in you should ensure that the location where you plan to perform Queue Line analysis meets the following specifications:

Cameras

Queue Line analysis is possible with both analog and IP cameras at any resolution. The Queue Line plug-in cannot be installed on PTZ cameras. Dynamic gain compensation should be set to the lowest level. Use wide dynamic range cameras for outdoor lighting situations.

Environment

Cameras should be positioned in areas with little background motion. Congested scenes with constant motion outside of the queue will degrade the performance of the plug-in.

Lighting

Uniform lighting is ideal. Back lighting (bright conditions) will negatively affect performance. Changes in lighting conditions throughout the day should be considered — position cameras away from exterior doors and windows to minimize the effect of lighting changes.

Field of View

The camera’s field of view should cover between 10 and 30 feet.

Mounting

Cameras should be mounted as close to straight overhead as possible, perpendicular to the ground. Positioning cameras at an angle less than 60 degrees from the horizontal is not recommended as performance can be severely impaired.

Binding Cameras to Plug-in

  1. Click the plug-in name to view its settings.

  2. On the right side of System Manager, select the Bound Cameras field and click the ... button.

  3. In the Bind Plug-in to Cameras dialog box, click the check box beside each camera that should have Dwell.

  4. Click OK to return to the Configure panel.

Pre-Installation Checklist

  • Ensure that you have purchased the Queue plug-in for the correct number of cameras for the installation (SKUs TBD).

  • Ensure that you have at least 24 hours to complete the installation. Step 4 of the plug-in configuration process entails sending a system-specific license question to 3VR Technical Support in order to obtain the matching license key. It can take up to 1 full business day to receive the license key.

  • Plan to connect to the 3VR appliance with one of the following methods:

    • Laptop connected to the system using a D-Link USB network adapter or a network cable

    • Connection from a remote PC over the LAN

You may also configure the Queue Line plug-in with a monitor, mouse, and keyboard connected to the appliance. However, in order to license the Queue Line plug-in you will need to copy and paste very long text strings (30+ characters), and this functionality is not available from the local console.

Configuring Per-Camera

Plug-In Settings

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

  2. Click a link (for example Edit “7. Lobby”) to edit the settings for that camera.

  3. The following settings must be configured for each camera bound to the Dwell plug-in:

Drawing Dwell Zone

For each camera that is bound to the Dwell plug-in, you must define at least one dwell zone that will be analyzed for Dwell events.
Zones are specified in the Dwell Zone tab of the Edit Settings window.

This is a required step. If you do not draw a Dwell zone, no Dwell events will be generated on the camera.

Use the following steps to draw a Dwell 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.

  4. After creating the zone, edit the Name of the zone and make sure that [√]Enabled is checked.

  5. If desired, repeat steps 1-4 to create additional Dwell zones.

    The above is an example of a Dwell camera with two Dwell zones.

  6. The above is an Example of a Dwell hot spot.

If a Dwell zone is created that is smaller than the size of the dwelling object, the Dwell plug-in will consider any object that envelops the zone as dwelling in the zone. This allows for the creation of Dwell “hot spots”, specific points of interest where you wish to capture Dwell events.

Setting Minimum Size

A Minimum Size must be established for each camera bound to the Dwell plug-in. Once set, the plug-in will only analyze the video feed for dwelling objects larger than the specified size. Smaller objects will be ignored. The minimum object size should be configured with the size range of targeted objects in mind.

To set the minimum object size:

  1. In the Edit Settings window, click the Minimum Size tab.

  2. Click and drag the Orange box until it is the desired minimum size. The positioning of the box in the video player is irrelevant.

Saving Settings

When you are finished editing the Dwell 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 Dwell plug-in.

Finalize 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 Dwell plug-in has been correctly configured, check for recent Dwell 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 Dwell plug-in.

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

  4. Select [√]Dwell and click OK.

  5. If the plug-in has been correctly configured, Dwell events will appear in the Monitor panel in real-time.

Verify that Dwell events are being generated correctly on all cameras bound to the plug-in during configuration.

Fine Tuning Plug-in Performance with Optional Settings

The settings in the Parameters tab of the Edit Settings dialog should only be modified from their defaults if Dwell results are unsatisfactory.

Minimum Dwell Time (seconds)

The minimum amount of time an object must dwell before a Dwell event will be generated.

Default: 10
Range: 1-200

Down sample Factor

Controls how the video resolution is down sampled before analyzing for Dwell events. When left at 0 (default), the plug-in will use the full resolution of the camera, which is highly CPU intensive. Installations running many Dwell cameras (or other analytics) at the same time may see improved performance by increasing the Down sample Factor of each Dwell camera.

Default: 0
Range: 0-8

  • No labels