3VR People Counter Installation and Configuration Guide
3VR People Counter
Overview
The 3VR People Counter (3VR-PCS) counts the number of people within a configured visual area. The counting data is then transferred via different interfaces for external processing.
This guide covers the process of installing and configuring the People Counter sensor, as well as setting up the sensor to work with a 3VR Appliance and Dashboard.
Accessories Required for Installation
The following accessories are required for the initial operation of the device, but they are not included in the scope of delivery:
- RJ-45 Ethernet cable
- PoE injector or Ethernet switch with PoE
- Distance measuring device
- Angle measuring device (if the 3VR-PCS is not aligned vertically)
- Configuration PC with web browser and Internet access
Structure and Function
Functional Description
- Housing View - Optics Side
- Status LED
- Ethernet Interface
- Housing View - Connection Side
- Ethernet Interface
- USB Interface
- SW3 button used to reset the sensor to default settings (Factory Default Reset)
Status LED
Starting the 3VR-PCS takes about 50 seconds. During this time, the status LED will behave as follows:
- In the first 2–4 seconds after connection via power-over-Ethernet (PoE), the LED remains off. The PoE operating mode is detected during this time
- When the 3VR-PCS starts, the LED is illuminated in red (for approx. 40 seconds)
- After the system start is finished, the LED goes off for about 3 seconds
- When the LED is illuminated in green, this means that the 3VR-PCS is ready for operation. The 3VR-PCS can now be accessed and configured via its web browser Human Machine Interface (HMI)
When the 3VR-PCS is completely set up, the LED turns yellow as soon as at least one person is under the 3VR-PCS in the defined area of interest (“Fill Level” >0).
Factory Reset Button
Pressing the factory Reset button resets all device settings, including network settings, to the factory defaults. To use this button, the 3VR-PCS must be powered and the Status LED must be green or yellow. Press the button gently with a pencil. The 3VR-PCS will reboot and the Status LED will switch to red).
Installation
This chapter describes the mounting and initial operation of the 3VR-PCS. It provides instructions for establishing the connections, as well as wiring examples for different applications.
Special tools needed for this section are:
- Angle measuring device
- Distance measuring device
Mounting the 3VR People Counter
- Consider the following requirements when selecting the mounting position:
- A minimum clearance of 8-12 inches must be observed between the counting lines and the entrance to the monitored area.
- As much as possible, make sure the counting area is free of interfering objects
- The people flow must pass through the center of the monitored area
- The counting lines must be set in such a way that people cannot bypass the counting lines, as they will otherwise not be counted
- There must not be any point of interest in the monitoring area, i.e. no place where people are encouraged to linger (sales counter, coat stands, info stands, etc.)
- Ensure that the mounting position and the holder or the protective housing provide sufficient stability.
Ensure that there are no sight restrictions and that the area is sufficiently lighted.
Obstructed visual range or inadequate ambient lighting may cause reduced accuracy and incorrect counting results. The required light intensity is 30 Lux.
- For the 3VR-PCS, ensure that there is enough room to connect the connectors required.
Consider the parameters in the tables below when positioning the 3VR-PCS. Use the angle measuring device to align it.
The mounting position and alignment can influence the counting accuracy.
For building applications, mount the device in the building (if possible) or on the side of the building where there aren’t any sliding doors in the detection range.
The reference plane for the installation height is the floor underneath the 3VR-PCS. Measure the installation height from the base to the optics.
- Pay attention to the dimensions of the monitored area, depending on the installation height
- Note the actual heights, distances, and angles for use during device configuration (see “Position and Alignment” for further information)
Insert three screws through the three tabs on the 3VR-PCS to secure it to the roof plates.
Reduced Counting Accuracy
If the mechanical fixation of the 3VR-PCS changes during operation (e.g. due to vibrations), this will affect the positioning of the 3VR-PCS. If the configured angles, A and B, no longer match, the counting accuracy is reduced.
- Ensure that the position of the 3VR-PCS cannot change during operation
- Secure the bolted connections against loosening
Secure all cable connections by appropriate means.
If it is necessary to deviate from the optimal alignment, consult 3VR regarding potentially necessary parameter optimizations.
Measure the distance from the People Counter sensor to the floor. You’ll need the mounting height (in centimeters) for the sensor configuration.
Mounting the Cover
Do not use a screwdriver to remove the hood. Unlock it carefully and slide the cover out.
Surface Mounting
- To mount the cover of the 3VR-PCS, put the hood on and slide it into position.
Recessed Mounting
|
Establishing Connections
- Ensure that the power supply of the 3VR-PCS is switched off.
- Cover or isolate neighboring components that are energized.
- Establish the connections to the Ethernet interface, RS-485, and digital inputs and outputs; refer to the notes in the sections below for information.
- Switch on the power supply.
Notes on the Ethernet Connection
The 3VR-PCS is normally supplied with a fixed, default IP address. You might need to adjust the device’s network settings before connecting it to your network. See “Configuring the Communication Settings” for information.
Configuration
This chapter describes the basic configuration of the 3VR-PCS parameters, as well as additional software functions.
Preparation for HMI Access
Use the web interface (HMI) to configure the 3VR-PCS and perform the counting test. (You need Internet access to use the web interface.) The web interface is provided by a JAVA applet on the 3VR-PCS. No additional software must be installed for the configuration of the 3VR-PCS, you only need to start a web browser and enter the device’s the IP address in the address bar.
When starting the HMI, normal operation will be interrupted. Close the browser window to return to normal operation.
Preparation
Special items needed for this process are as follows:
- Power-over-Ethernet switch or injector
- 2 RJ-45 Ethernet cables
|
Configuring the Communication Settings
You need to assign a static IP address to the 3VR-PCS. To assign the 3VR-PCS a static IP address:
|
Setting the Date and Time
To set the time and date:
|
Position and Alignment
In order to obtain correct counting results, you must set the position and alignment of the 3VR-PCS at the installation site using the configuration HMI. The process for configuring position and alignment is as follows:
|
Counting Area and Enabling Suppression of Static Objects
On the Counting Area menu page, you define the counting area (Counting Area, Area of Interest) within the monitored area Monitored Area at Ground. This demarcates the area at ground level within the monitored area that is used for detecting people and all derived functions, such as counting, fill level, and object list.
By restricting the monitored area to the counting area, you can exclude static objects in the boundary areas that could interfere with counting accuracy without unnecessarily reducing the monitored area in which people are recorded.
As an alternative, or in addition to restricting to the monitored area, you can enable the Background Segmentation (BGS) function to suppress static objects within the counting area. The BGS function recognizes objects in the counting area that do not move for a certain period of time and prevents these static objects from affecting the detection of people.
Any static objects in the monitored area are automatically detected during configuration as white surfaces in the picture Monitored area next to the camera picture.
To define the counting area:
|
Counting Gates
Use the Counting Gates menu page to adjust the positions of the counting lines (Enter plane and Exit plane) in the counting area.
|
Acceptance Test
After completing the basic configuration, perform a quick counting test. The prerequisites for this test are as follows:
- Connect a PC to the Ethernet interface of the 3VR-PCS (see “Preparation for HMI Access” for more details).
- When using in vehicles, ensure that the door trigger works properly.
The steps to perform the acceptance test are as follows:
|
Exposure Control
Especially bright areas in the evaluation range of the exposure control area can result in a too dark overall image, as the exposure is reduced. You can change the size and position of the exposure control area to affect the automatic adjustment of the image exposure. The set area is the reference for the calculation. Setting it to a bright area results in an overall darker image. Setting it to a darker area results in an overall brighter image.
To configure the exposure control:
|
Enabling Video Recording
In addition to the counting function, you can use the 3VR-PCS to transfer a video data stream. In this context, transmission for visualization (see Configuring Video Transmission (Streaming) for details) must be differentiated from transmission for recording (see Configuring Video Transmission (Testing) for details).
You need a specific license file to use the video transfer and recording feature; this license file is either preinstalled on delivery or can be later uploaded to the 3VR-PCS. Refer Updating the licensing file for more details.
When recording, the flow of data contains, in addition to the video images, the logged counting events, which are filed in special files. You can use these special files, along with the SASbin2rec tool, to create subtitling files for the accompanying videos.
For the SASbin2rec tool, contact 3VR support: http://www.3vr.com/services-support/techsupport
Limited Privacy Policy
The privacy policy is limited during the use of the video transmission and recording.
Data Volume
The data volume of saved files depends on the following video settings:
- Store Codec (file format of the video transmission)
- Framerate (picture refresh rate)
- JPEG Quality (picture quality when transmitting in JPEG format)
The following table gives the space requirements for the original camera picture. The values for JPEG images depend on the content of the picture and so may vary slightly.
Space requirements for video recording in gigabytes per hour
Store Codec | JPEG Quality | Framerate (frames per second) | GB/h |
---|---|---|---|
JPEG | 55% | 5 FPS | 0.18 |
JPEG | 90% | 5 FPS | 0.36 |
RAW | 5 FPS | 1.29 | |
RAW | 6.67 FPS | 1.72 | |
RAW | 10 FPS | 2.57 | |
RAW | 20 FPS | 5.15 |
Configuring Video Transmission (Streaming)
To configure the video transmission to display the video images:
|
Testing Video Transmission (Streaming)
To test video transmission, you can use VLC Media Player for Windows. Download VLC Media Player for Windows here: http://www.videolan.org/vlc/download-windows.html
To test the video transmission:
|
People Counter Plug-in Configuration
Perform the steps below to install the 3VR-PCS plug-in.
Configuring the People Counter
- Configure the 3VR-PCS according to the instructions.
- Verify, through the counter’s interface, that the counter is counting people properly.
- Close the browser window for the counter interface.
Installing the People Counter Plug-in
|
Configuring Individual Channels
|
Configuring 3VR System Manager
Perform the following steps to stream video into the 3VR VMS Servers:
- Open System Manager and navigate to the Configure tab.
- Select the channel to use with the 3VR-PCS Sensor. If the channel name has a strike through it, right-click it and select Enable. You need to configure channel as a Network Camera using the Generic IP Camera Driver, as described below.
- Set the camera type.
- Click the Unknown link beside Type. The Edit Camera Type dialog box appears.
- Select Network Camera as the Camera Type.
- Enter generic into the Filter field.
- Select Generic IP Camera Driver from the drop-down list. Click Save.
- In the Network Camera: Network Address field, enter the IP address configured for the sensor.
- In the Network Camera: User Name field, enter counter.
- In the Network Camera: Password field, enter counter.
- In the IP Cameras section:
- Set the Video Mode to MJPEG Stream.
- Set the RTP Protocol to UDP.
- Set Disable RTCP? to Yes.
- Set the RTSP URL Path (MJPEG) to /video1.
Displaying the CSV Data Files
Example:
- File completion interval: 3 hours
- Sample rate: Every 15 minutes
record_id | timestamp | period | status | SUM_IN_0 | SUM_OUT_0 | ACT_FILL_0 |
---|---|---|---|---|---|---|
13089 | 2014-06-12 18:15:00 | 900 | 0 | 42 | 7 | 5 |
13090 | 2014-06-12 18:30:00 | 900 | 0 | 0 | 2 | 0 |
13091 | 2014-06-12 18:45:00 | 900 | 0 | 3 | 5 | 0 |
13092 | 2014-06-12 19:00:00 | 900 | 0 | 8 | 0 | 0 |
13093 | 2014-06-12 19:15:00 | 900 | 0 | 13 | 21 | 0 |
13094 | 2014-06-12 19:30:00 | 900 | 0 | 34 | 0 | 0 |
13095 | 2014-06-12 19:45:00 | 900 | 0 | 0 | 55 | 0 |
13096 | 2014-06-12 20:00:00 | 900 | 2 | 0 | 0 | 0 |
13097 | 2014-06-12 20:15:00 | 900 | 2 | 0 | 89 | 0 |
13098 | 2014-06-12 20:30:00 | 900 | 3 | 0 | 0 | 0 |
13099 | 2014-06-12 20:45:00 | 900 | 0 | 144 | 0 | 8 |
13100 | 2014-06-12 21:00:00 | 900 | 0 | 0 | 233 | 0 |
- record_id: Unique ID for the data line (after ID 4294967295, it restarts with 0)
- timestamp: Timestamp of the APC-adjusted local time of writing the data line
- period: Time (in seconds) for the summation
- status: OSD status values, see the table below
- SUM_IN_0: Summation of the incoming counts for “period”seconds at the time of the “timestamp"
- SUM_OUT_0: Summation of the outgoing counts for “period”seconds at the time of the “timestamp”
- ACT_FILL_0: Fill level of detected people in the area of interest at the time of writing the data line
OSD Status | Description |
---|---|
0 | OK |
1 | Error (e.g. one sensor covered) |
2 | Warning: Illumination is very dark |
3 | Error: Illumination is too dark |
4 | Warning: Illumination is very bright |
5 | Error: Illumination is too bright |
6 | Status not known (e.g. first time after boot) |
- The form of the internal filename is: “000042_COUNTER01ABCD_data.csv”
- The filename uses an ID prefix - restarting at 999999 with 000000 - and contains the hostname, which is, by default “COUNTER,” and the last 6 letters of the MAC address.
- Up to 4000 files can be backed up inside.
Service Tools
This section describes how to update the firmware on the 3VR-PCS, update the license file, reboot the device, and reset the parameter settings.
Updating the Firmware
You can update the firmware with an update provided by 3VR. Follow the instructions below to update the firmware.
Unauthorized firmware may cause damage to the device.
Uploading firmware that was modified manually or has not been approved by the manufacturer may damage the functionality of the 3VR-PCS or may even cause the device to fail.
- 3VR charges for maintenance services to repair defects caused by uploading illegitimate firmware versions.
Firmware updates do not modify parameters, communication settings, and customer settings. New parameters may be set to their default values.
To update the firmware:
|
Updating the License File
In order to enable certain functions, you may need to apply a license file. To update a license file:
|
Rebooting the 3VR-PCS
To Reboot the 3VR-PCS, do the following:
|
Resetting the Parameter Settings
Under certain circumstances, it might be necessary to reset all the parameter settings of the 3VR-PCS to their factory settings. To reset the settings, do the following:
|
3D Dwell in 3VR People Counting Plug-in
Installation of People Counting plug-in requires separate licensing in 3VR VMS.
3D Dwell time in 3VR People Counter identifies objects movement or position in specific zone or area. In 3VR OpCenter, the 3D dwell time is captured to track and calculate the video images of the number of adults/children who spend their average time within a closed area, such as a department store or business area that needs to be monitored. Inside the OpCenter event card, the dwell time with the person type is displayed. The person type maybe adult/children.
3D Dwell time in 3VR People Counter improves:
- To identify customer behavior while customer is lingering to make decision on buying products or number of times making their visits to any place
- Trend statistics that allows to know how much time their customers spend time in specific area to identify their interests
- Efficiency by identifying irregular working pattern of people in areas not related to them. For example, Employees frequent activities in areas not related to them may affect productive hours
Pre-requisite
The People Counting sensor plugin must be installed and configured in 3VR System Manager to view the 3D Dwell and 3D Queue events in 3VR OpCenter.
Installing 3VR People Counting Plug-in in System Manager
| |
3. In the resulting Confirm dialog box, click Install to proceed. | |
4. Navigate to the folder containing the plug-in file and click to highlight it. 5. Click OK. The plug-in will now begin installing. 6. When the plug-in installation is complete, it appears in the System Manager under the Plugins folder. |
Configuring People Counting in System Manager
Binding Channels to Plug-In
The camera channels are bounded to people counting sensor plug-in from where the dwell time starts recording and counting occurs in specific zones. Each channels are bounded to specific zones, particularly zone 1, zone 2, zone 3, and zone 4. To bind the channels to the plug-in:
| |
The Bind Plug-in to Cameras dialog appears. 3. Select the Camera and click OK. 4. "The 3VR software must be restarted for your changes to take effect" dialog window appears. Click OK to restart system manager |
Enabling 3D-Dwell at Specific Interval
The camera settings for 3D-Count must be enabled after binding the channels to the people counter sensor plug-ins. The 3D-Count data for different zones is displayed at 15-minute time interval.
|
The default dwell height threshold in cms is 100 cm.The default and minimum queue fill threshold is 1, which indicates the number of people in the queue and cannot be set to zero.
Viewing 3D-Dwell Data in OpCenter
After binding the channels and enabling the 3D-Dwell, goto to the OpCenter to view the 3D-Dwell data.
- In OpCenter, goto Monitor tab and select the Channel and the time interval. Select 3D-Dwell check-box from the drop-down.
- Click OK to save your selections.
The table describes the 3D-Dwell parameters common to all the four zones.
Parameter | Description | |
---|---|---|
Appliance Name | Describes the appliance type in 3D Dwell. In the illustration, the appliance type is 3000(4). | |
Camera | Displays the channel camera name configured for 3D Dwell . For illustration purpose in our example, channel 21 is used. | |
People Count Type | Is based on 3D-Dwell and 3D- Queue | |
Date | Indicates the dwell date | |
Sensor | The default sensor type is "3VR People Counting Sensor" | |
Person Type | Indicates the type of person by Adult/Child based on dwell height | |
Zone Type | Indicates the dwell count recorded in that zone. The zones in 3VR People Counting are zone 1, zone 2, zone 3, and zone 4. |
Searching Recent Events ranging from 5 Minutes till One Month
To view events data ranging from 5 minutes to one month.
| |
5. The screen refreshes to display the dwell events for single day or 24 hours. By pushing the side arrows in the Date Range and selecting the Recent radio button, it is possible to select 5 minutes to 1 month. |
Searching by specific Event Types
The events that are searched by specific type, display only one event type at a time. Mathematical operations such as "==", "<=", ">=", and Range can be applied on different event types such as motion, 3D-queue, 3D-dwell, people counter, and axis people counter. To search by specific event types:
|
Searching by Related Events
Specifies the event types that is included within the events for specific interval of time in minutes. For example, the user can include 3 minutes of 3D-dwell events within the selected 3D-queue events. To search by related event types:
|
Modify Search, New Search and Export Functions
| |
The event data that is displayed in OpCenter is saved in the destination folder as image and video files. |
3D-Queue in 3VR People Counting Plug-in
The 3D-Queue feature in People Counter is used to count people in a queue on a particular time, for example 60 second. Inside the OpCenter event card, people count with the person type is displayed. The person type maybe adult/children.
Viewing 3D-Queue Data in OpCenter
After binding the channels and enabling the 3D-queue, goto to the OpCenter to view the 3D-Queue data.
- In OpCenter, goto Monitor tab and select the Channel and the time interval. Select 3D-Dwell check-box from the drop-down.
- Click OK to save your selections.
The table describes the 3D-Queue parameters common to all the four zones.
Parameter | Description | |
---|---|---|
Appliance Name | Describes the appliance type in 3D Dwell. Here the appliance type is 3000 (4) | |
Camera | Displays the channel camera name configured for 3D Dwell . For illustration purpose in our example, channel 21 is used. | |
People Count Type | Is based on 3D- Queue | |
Time and Date | Indicates the queue time and date | |
Sensor | The default sensor type is "3VR People Counting Sensor" | |
Person Type | Indicates the type of person by Adult/Child based on dwell height | |
Fill Count | Indicates the count recorded in the queue in that zone. The zones in 3VR People Counting are zone 1, zone 2, zone 3, and zone 4. |