Queue Line
- Anand Rajaraman
Queue Line
Queue Line analytics in 3VR VMS sends alerts and events about objects or people in standing in a queue and their average waiting time for checkout. The system sends alerts when the number of people exceeds the threshold limit for a single queue.
Viewing Queue Events
Monitoring Recent Queue Events in the Monitor Panel
The OpCenter Monitor panel allows you to view events as they happen. You can specify which cameras to view, and what types of events are displayed.
Use the following steps to view recent events generated by the Queue Line plug-in:
In 3VR OpCenter, click the Monitor tab to go to the Monitor panel.
Click camera numbers to select the cameras associated with the Queue Line plug-in.
Click the arrow below the camera selector to open the event type drop-down menu.
Select [√]Queue to display events of that type.
Click OK. The Monitor panel will update to display only Queue events from the selected cameras.
To view an event, click the event card. The event card will turn blue, indicating it is currently selected.
Viewing Queue Events
When a Queue event card is selected, the video clip associated with the event will play back in the video player. Details about the event may be viewed in the event editor, located below the video player.
In addition to the tabs available for all event types, such as Notes and Images, Queue events include the following information in the Details tab:
Shortest: The shortest queue observed over the duration of the Queue event
Peak: The longest queue observed over the duration of the Queue event
Average: The average queue length over the duration of the Queue event
About Queue Event Cards
A Queue event will be generated in OpCenter at the interval specified during plug-in configuration. By default, a queue event is generated every 2 minutes. Queue event cards contain pictures, video, and information about the queue. They appear in the Monitor panel for recent events and in the Search panel for search results.
Each Queue event card contains the following information in storyboard view:
a. Thumbnail image
b. Camera number and name
c. Time of event
d. Event type
e. Event length
f. Queue statistics with additional information displayed on mouse over:
g. Date of event
Searching for Queue Events
Setting up a Search
Use the Search panel to find Queue events generated days, weeks, or months ago.
To go to the Search panel, click the Search tab.
Define the dates, days of the week, and time ranges to search for events.
Under Cameras, select one or more cameras bound to the Queue Line plug-in.
Under Events, select [√]Queue to search for events generated by the Queue Line plug-in.
The following options are available when searching for Queue events:
Click (•)All Queue to search for all Queue events generated during the specified time range.
To restrict the search further, click (•)Specify. The following search parameters will be available:
Peak Queue: Check the box next to [√]Peak Queue and adjust the Minimum and Maximum slider bars return Queue events with Peak Queue values falling into the specified range.
Average Queue: Check the box next to [√]Average Queue and adjust the Minimum and Maximum slider bars return Queue events with Average Queue values falling into the specified range.
Shortest Queue: Check the box next to [√]Shortest Queue and adjust the Minimum and Maximum slider bars return Queue events with Shortest Queue values falling into the specified range.
Shortest Queue: Check the box next to [√]Shortest Queue and adjust the Minimum and Maximum slider bars return Queue events with Shortest Queue values falling into the specified range.
When you are finished specifying the criteria for the search, click the Search button.
Queue events matching your criteria will be displayed in the Search panel results screen.
Select an event card to view the video clip and details associated with the event.
Sorting Search Events
There are two ways to sort the results of a search: by Time and by Similarity. Although the default sort order for standard Motion events is by time, when searching for Queue events with the options under (•)Specify it is recommended to sort by similarity. Sort order is specified when setting up the criteria for a search. To change the sorting of Queue events:
Under Events, select [√]Queue to search for events generated by the Queue Line plug-in.
Click (•)Specify.
Change the Sort Results By radio button to (•)Similarity.
When sorting search results by similarity, the following criteria is used to define what “most similar” means for sorting purposes:
[√]Peak Queue: Sorts events by queue length. Returns longest queue first.
[√]Average Queue: Sorts events by average queue length. Returns longest average first.
[√]Shortest Queue: Sorts events by queue length. Returns shortest queue first.
Running Queue Event Reports
The 3VR Report Viewer client application allows you to generate tabular reports based on data captured by the 3VR system.
Use the following steps to set up a report for events generated by the Queue Line plug-in.
From the Report Viewer home screen, click the New button.
Select Event Report from the menu.
Report Viewer will switch to the report editing screen.In the appliance tree in the left-hand panel, select an appliance with the Queue Line plug-in installed on it.
Under Cameras, select a camera bound to the Queue Line plug-in.
Under Events, select [√]Queue. The following options are available when reporting on Queue events:
Click (•)All Queue to create a report for all Queue events.
To further restrict the report, click (•)Specify. The options under (•)Specify are identical to the event selector in the Search panel. Please refer to section 2 for more information.
When connected to a standalone appliance, the Appliances panel will display a read-only field with the appliance name pre-selected.
The fields under Report Parameters allow you to define the metadata of the report definition, such as its name and scope:
Type a name and description for the report.
Define the Date Range, Time Scope, and Interval.
Click Edit Report Data.
In the Edit Report Data dialog, select the functions that should be run on the event data and included in the report output.
The properties in the General category apply to all events:
Property | Description | Functions |
|---|---|---|
Event | Whether an event occured | Count |
Event Duration | The length, in seconds, of the event video clip | Minimum, Maximum, Sum, Average, Standard Deviation |
12.Click the drop-down arrow next to a property and select one of the functions listed to add it to the report.
The properties in the Queue category only apply to events generated by the Queue Line plug-in:
Property | Description | Functions |
|---|---|---|
Peak | The longest queue size observed over the duration of a Queue event | Minimum, Maximum, Sum, Average, Standard Deviation |
Average | The average queue size observed over the duration of a Queue event | Minimum, Maximum, Sum, Average, Standard Deviation |
Shortest | The shortest queue size observed over the duration of a Queue event | Minimum, Maximum, Sum, Average, Standard Deviation |
Click OK to return to the report editing screen.
When you are finished defining the criteria for the report definition, click the Save Report button.
To run the Queue event report, select the report definition from the list and click Run Report.
Maximum Peak Queue
To report the longest queue length observed over each interval, open the Peak drop-down under Intervals and select [ ]Max.
The resulting report will show the Maximum Peak (e.g., longest queue) value for each interval, as well as a total Maximum Peak which is the longest queue observed over the entire scope of the
report.
Minimum Shortest Queue
To report the shortest queue length observed over each interval, open the Shortest drop-down under Intervals and select [ ]Min.
The resulting report will show the Minimum Shortest (e.g., shortest queue) value for each interval, as well as a total Minimum Shortest which is the shortest queue observed over the entire scope of the report.
Average Queue
To report the average queue length observed over each interval, open the Shortest drop-down under Intervals and select [ ]Min.
The resulting report will show the Average queue value for each interval, as well as a total Average which is the average queue observed over the entire scope of the report.
Average Queue Standard Deviation
Standard deviation is a measure of variability. To report the standard deviation from the average queue size observed over each interval, open the Average drop-down under Intervals and select [ ]Std Dev.
The resulting report will show the Standard Deviation for each interval, as well as the total Standard Deviation observed over the entire scope of the report.