H.264 NETWORK CAMERA SERIES I VCA Interface Manual (v3.05.31.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Table of contents Introduction ..................................................................................................................................... 8 Getting Started ................................................................................................................................ 9 VCA Feature Packages ..................................................................................................................
Ganz GXi Series VCA Interface Manual V3.05.31.18 Object Presence ........................................................................................................................... 23 Object Direction ............................................................................................................................ 24 Object Enter and Exit .................................................................................................................... 25 Object Appear and Disappear ...
Ganz GXi Series VCA Interface Manual V3.05.31.18 Logical Rules................................................................................................................................. 47 Adding and Removing Logical Rules ........................................................................................... 47 Editing Logical Rule Clauses ........................................................................................................ 48 Editing Logical Rule Actions ....................
Ganz GXi Series VCA Interface Manual V3.05.31.18 Decremental Counters .............................................................................................................. 66 Occupancy Counters ................................................................................................................. 66 Counter Storage and Reporting.................................................................................................... 67 Counter Database Service.................................
Ganz GXi Series VCA Interface Manual V3.05.31.18 Current Device Time ................................................................................................................. 75 Enable Hourly Report ................................................................................................................ 75 Trigger Time .............................................................................................................................. 75 Weekday.....................................
Ganz GXi Series VCA Interface Manual V3.05.31.18 Configuring and Enabling the Service ...................................................................................... 89 Selecting a Time Interval........................................................................................................... 89 Example CSV File ..................................................................................................................... 89 Description of CSV fields: .................................
Ganz GXi Series VCA Interface Manual V3.05.31.18 Auto-tracking Initiation ............................................................................................................. 101 Importing & Exporting VCA Configuration .................................................................................. 102 Exporting VCA Configuration .................................................................................................. 102 Importing VCA Configuration ....................................
Ganz GXi Series VCA Interface Manual V3.05.31.18 Introduction VCAsys is a real-time video analytics engine that utilizes advanced image processing algorithms to turn video into actionable intelligence. At the core of the product is an advanced object tracking engine that continually tracks moving and stationary targets. The tracking engine features built-in robustness to environmental nuisance conditions such as changing illumination, moving foliage, rippling water, etc.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Getting Started To get up and running as fast as possible, the following steps should be executed: • • • • • Locate a unit that supports VCAsys and ensure it is upgraded to a firmware version that contains the VCAsys engine. Obtain an activation code for the feature set required. The different feature levels available for different platforms are described in the VCA Feature Packages topic. Connect power, network and input video. Activate the VCAsys engine.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Accessing VCA Configuration All configuration of the VCAsys engine is performed by accessing the VCA section of the unit setup page: Activation Some features of VCAsys must be activated before they can be used. Activating VCAsys consists of the following two steps: • • Obtaining an activation code from your hardware supplier. Applying an Activation code to the unit.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Obtaining an Activation Code Before VCAsys can be enabled, it must be activated. Typically, an activation code is supplied by the hardware provider, upon receipt of a valid product token, and a unique hardware ID generated by the unit on which VCAsys is to be activated.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Applying an Activation Code to a Unit Once an activation code has been received from your hardware supplier, it's simply a case of entering the code on the appropriate web page. Select the Activation menu: Enter the activation code and click "Apply". If the activation code is valid, the activated features will be displayed in the "Installed Licenses" box.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Switching VCA On and Off By default, VCA is disabled. To enable VCA it must be activated. Select the VCA menu and then the Enable/Disable sub menu. Tick the Enable check box under Analytics and select the required mode. Enable VCA Check/Uncheck to enable/disable the VCA functionality at a global level. If unchecked, ALL VCA functionality will be disabled. Object Tracking Check/Uncheck to enable/disable the object tracking engine.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Enabling Metadata Streaming To visualize the VCA output, metadata streaming must be enabled for RTP.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Configuration of Zones and Rules To create some useful output, it is necessary to configure detection zones and detection rules. The detection zones and rules are configured by selecting VCA and then the Zones and Rules sub menu: Tracking Display The tracking display window shows all moving and stationary targets that are currently being tracked by the engine. Objects that have triggered a rule are displayed in red.
Ganz GXi Series 05-2018-A VCA Interface Manual V3.05.31.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Customizing the Tracking Display The tracking display window can be customized to show various levels of tracking data. Simply right click on the tracking display window and select the Display option: Display Blobs By default, the blobs are not displayed. It's possible to switch the blob display on to observe how the algorithm performs in different scenarios. Moving blobs are displayed in blue, as illustrated in the figure.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Display Object Classification Check this option to display the object classification. This option is only available when the camera has been calibrated. Display Object Wait Time (VCApro only) Check this option to display the amount of time that the object has spent inside a zone. Useful for measuring customer dwell times in specific areas of the scene. Note that the statistics metadata option must be enabled in the Advanced Settings page.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Creating a Zone or Line To create a zone, either double click the left mouse button or right click and select Zone/Line... Create zone: To create a line, right click and select Zone/Line... Create line: Editing Zones and Lines Zones and lines can be edited to be any shape or size. Zones and lines are controlled by manipulating "nodes" that represent the zone/line vertices.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Adding and Removing Nodes Zones and lines can be tailored to any scenario by simply adding more nodes to define the shape required. To add a node, simply double click on the zone or line at the point where the new node should be added. Nodes can be deleted by right clicking on the node and selecting Node...
Ganz GXi Series VCA Interface Manual V3.05.31.18 Non-Detection Zones In some situations, especially where the scene is busy, objects tracked in some areas can interfere with detection zones in other areas. For example, on a windy day, moving foliage can generate false alarms that in some situations could be tracked through a detection zone. To minimize such issues, it is possible to configure "non-detection" zones, where nothing is detected or tracked.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Detection Rules Once some detection zones and/or lines have been configured, it's possible to define some detection rules that apply to the zones/lines. By default, zones and lines are automatically configured to detect object presence. The rules are defined in the Properties Inspector: The properties inspector is context-sensitive to the zone selected.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Object Presence Enable the object presence rule on the selected zone by checking the Presence box in the properties inspector and click apply. Objects that are present inside a zone or pass through a line will trigger the rule and raise an alarm.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Object Direction Enable the object direction rule on the selected zone by checking the Direction Filter box in the properties inspector. Adjust the direction and acceptance angle to suit the detection scenario. Objects that travel in the configured direction (within the limits of the acceptance angle) through a zone or over a line trigger the rule and raise an alarm.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Object Enter and Exit Enable the ‘Object Enter’ and ‘Exit Detection’ by checking the corresponding check boxes in the properties inspector and click apply. An object entered alarm is raised when an object crosses from the outside to the inside of a detection zone.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Object Appear and Disappear Enable the ‘Object Appear’ and ‘Disappear Detection’ by checking the corresponding check boxes in the properties inspector and click apply. An object appear alarm is raised when an object appears inside a detection zone. Note that this is different from object entered detection since the object must be initially detected inside the zone without entering, e.g.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Object Dwell Enable the object dwell rule on the selected zone by checking the Dwell box in the properties inspector and click apply. Objects that dwell inside a zone for longer than the defined amount of time will trigger the rule and raise an alarm.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Object Stopped Enable the object stopped rule on the selected zone by checking the Stopped box in the properties inspector and click apply. Objects that are stopped inside a zone for longer than the defined amount of time will trigger the rule and raise an alarm. The stopped time can be configured by simply clicking in the Time box on the rule control and editing the value in-place.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Object Class Once the camera has been calibrated, it's possible to include or exclude specific object types in the detection rules. Select and enable an Object Filter by checking the box. Select whether the rule should include or exclude the object type. Select the object type to include or exclude. Apply the changes. In this example, the rule has been configured to include detection of people only.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Object Tailgating Enable the object tailgating rule on the selected zone by checking the Object Tailgating box in the properties inspector. Adjust the time threshold to set the minimum allowable time between successive object detections. Object tailgating is defined as an object crossing a line or zone within a certain time after an object has already crossed the line or zone.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Object Tailgating Trigger The tailgating filter can use either the tracking engine or the counting line as trigger sources for tailgating detection. Since the counting line exhibits higher performance when detecting multiple objects crossing a line, best performance will be obtained when the trigger is set to "Counting Line". If a counting line filter is already configured on the line, then the trigger is automatically set to "Counting Line".
Ganz GXi Series VCA Interface Manual V3.05.31.18 Object Speed Enable the object speed rule on the selected zone by checking the Speed Filter box in the properties inspector. Adjust the lower and upper speed limits to suit the detection scenario. Objects that travel within the bounds of the configured speeds, through a zone or over a line trigger the rule and raise an alarm. Note that the camera must be calibrated for this function to be available.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Object Color Filter NOTE: The object color filter requires a VCApro license, and the Tracking mode must be set to People Tracking on the VCA Enable/Disable page. Enable the object color filter by checking the corresponding box in the properties inspector and click apply. Specify the color and threshold (amount of color within an object) detection properties.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Counting Line A counting line is a detection filter optimized for bi-directional object counting (e.g. people or vehicles) in busier detection scenarios. Examples of such applications may include: • • People counting with overhead cameras in a retail environment. Vehicle counting with overhead cameras on public highways. The counting line filter can be enabled when the unit has been configured with VCAcount/VCAaccess/VCAadvanced/VCApro license.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Assigning Counters to Counting Lines A counting line by itself simply generates events when an object to be counted is detected. To count the events, counters (one for each direction) can be created and configured to count the events generated by the line. To create counters, see the Counters topic.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Calibrating the Counting Line To generate accurate counts, the counting line requires calibration. Unlike VCAsurveillance, this cannot be performed at a general level for the whole scene using the 3D calibration tool. This is because the counting line is not always placed on the ground plane: it may be placed at any orientation at any location in the scene. For example, a counting line could be configured vertically with a side-on camera view.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Calibration Diagnostics Mode To enable the user to more accurately configure the calibration for the counting line, there is a diagnostic feature which can be enabled to provide feedback of the counting results. To enable this mode, select the "Metadata Format" ->"Counting Line Diagnostics" on the VCA Advanced Settings page.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Camera Calibration Camera calibration is required for the VCA engine to classify objects into different object classes. Once the camera has been calibrated, the engine can infer real-world object properties such as speed, height and area and classify objects accordingly.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Other Graphical Tools There are several other graphical tools that can be used to make the calibration process simpler and more accurate. Horizon Display The horizon can be displayed by right clicking and checking the menu option. If the horizon is visible in the video, it is possible to use this to set the tilt angle. Drag the grid until the horizon in the video matches the graphical horizon.
Ganz GXi Series 05-2018-A VCA Interface Manual V3.05.31.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Virtual Ruler The calibration configuration control supports a virtual ruler. This can be useful for measuring distances along the ground plane to objects of known size such as road lane widths, car park space widths etc. The virtual ruler is effectively a "measurement stick" that measures the distance between two points along the ground plane (not heights).
Ganz GXi Series VCA Interface Manual V3.05.31.18 Calibrating a Camera Calibrating a camera is necessary to estimate object parameters such as height, area, speed and classification. If you know the height, tilt angle and vertical field of view corresponding to your installation, you can simply type the parameters in the appropriate boxes and apply the changes. If, however, you do not know, or are unable to find out the camera parameters, this topic provides a stepby-step guide to calibrating a camera.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Step 2: Adjust tilt angle and camera height Now, adjust the camera tilt angle and vertical field of view until both mimics are approximately the same size as a real person at that position in the scene. If an estimated height is entered, then adjust this along with the other two parameters. Click and drag the ground plane to change the tilt angle, use the mouse wheel to adjust the camera height and drag the slider to change the vertical field of view.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Step 3: Verify the setup Once you are happy that the scene is correctly calibrated, verify the settings by dragging the mimics around and comparing them to other people or people-sized objects in the scene. The more locations in the scene where the calibration is verified, the more accurate the calibration will be. The 3 calibration parameters can be fine-tuned in the same way as detailed in Step 2.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Advanced Calibration Parameters The advanced calibration parameters allow the ground plane to be panned and rolled without affecting the camera calibration parameters. This can be useful to visualize the calibration setup if the scene has pan or roll with respect to the camera.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Measurement Units The height, area and speed annotation can be displayed in metric or imperial units. By default, the system displays metric units. To change the measurement units, select the Advanced settings page and change the Measurement Units option. Apply the changes. Object Classification VCAsys can perform object classification once the camera has been calibrated.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Logical Rules Logical rules extend the standard rules system to allow various inputs to be combined using logical expressions. A logical rule is defined by one or more clauses that determine whether the rule is triggered or not. The clauses can be thought of as logical components like 'and' or 'not' but can also manipulate events from other clauses in different ways.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Editing Logical Rule Clauses Each logical rule is defined by a hierarchy of clauses which represent a variety of inputs and logical operations. The first step is to select the top-level clause from the drop-down box. Here an 'and' clause has been selected as the top-level clause. When a clause is added, a sentence describing the clause appears with placeholders for any parameters that the clause has.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Editing Logical Rule Actions The next step is to define that actions that should occur when the logical rule is triggered. The actions are added using the (+) button in the lower section of the page. In this example, the logical rule has been configured to generate events and to reset a counter when it is triggered.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Clause Types There are many different types of clause which can be combined in different ways to create logical rules. Most clauses also have configurable parameters which give logical rules the flexibility to fulfill a wide variety of purposes. Rule Clause The 'rule' clause allows another rule (standard or logical) to be used as an input to a logical rule.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Or Clause The 'or' clause takes input from one or more other clauses and will generate output when any of the input clauses are generating output. The events that are generated will combine the target and zone ids from all the inputs that are triggered at that time. The following example shows a logical rule which generates events when either of two presence rules are triggered.
Ganz GXi Series VCA Interface Manual V3.05.31.18 And Clause The 'and' clause generates output only when all its inputs are currently triggered. The target and zone ids from all the input clauses will be combined into a single output event. If one of the inputs generates instantaneous events (e.g. count events) then there will be one output event for each of the instantaneous input events. The example below shows the behavior resulting from combining two presence rules with an 'and' clause.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Before Clause The 'before' clause adds the requirement that one of inputs to an 'and' clause must start before another. The input clauses to be constrained are chosen using their clause id which is the number in square brackets at the start of the clause sentence on the web page. The 'before' clause can only be created as an input to an 'and' clause and can only refer to other inputs of the same 'and' clause.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Within Clause The 'within' clause constrains the inputs to an 'and' clause so that it is only triggered if the specified inputs were triggered within a particular time interval. The input clauses to be constrained are chosen using their clause id which is the number in square brackets at the start of the clause sentence on the web page.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Identity Clause The 'identity' clause adds the requirement for two inputs to an 'and' clause to have been triggered by either the same or a different target. The input clauses to be constrained are chosen using their clause id which is the number in square brackets at the start of the clause sentence on the web page. The 'identity' clause can only be created as an input to an 'and' clause and can only refer to other inputs of the same 'and' clause.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Earliest Clause The 'earliest' clause is a special clause. It affects the start time reported by an 'and' clause. Ordinarily, the start time reported by an 'and' clause is the time at which the 'and' clause itself became true. With the 'earliest' clause, the start time reported is instead the earliest start time amongst the other input clauses. The 'earliest' clause can only be created as an input to an 'and' clause.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Classification Clause The 'classification' clause constrains one of the inputs to an 'and' clause so that it will only trigger if the triggering target has a specific classification. The input clause to be constrained is chosen using its clause id which is the number in square brackets at the start of the clause sentence on the web page.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Proximity Clause The 'proximity' clause adds the requirement for two inputs to an 'and' clause to have been triggered by targets that are detected at more than or less than some defined distance apart. The input clauses to be constrained are chosen using their clause id which is the number in square brackets at the start of the clause sentence on the web page.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Was Clause The 'was' clause is triggered if the input clause was triggered at the specified time in the past. This has the effect of applying a time delay to its input clause. The example below shows the effect of applying a 'was' clause to the output of a presence rule. The logical rule is triggered if the presence rule was triggered five seconds earlier.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Between Clause The 'between' clause is triggered if the input clause was triggered during the specified time interval in the past. This has the effect of applying a time delay and duration scaling to its input clause. The example below shows the effect of applying a 'between' clause to the output of a presence rule. The logical rule is triggered if the presence rule was triggered two seconds earlier up to 4 seconds earlier.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Day Clause The 'day' clause will be triggered only on the chosen day of the week. When combined with other clauses in an 'and' clause, the 'day' clause allows logical rules to be configured so that they are only triggered on a specific day of the week. The example below shows a logical rule that is only triggered on a Wednesday.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Date Clause The 'date' clause will be triggered when the device's date is within the specified date range. The bounds are included, so a single day of the year can be specified by making the start and end times the same. Below is an example where a date clause has been created to trigger between 15th October and 1st April.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Input Clause The 'input' clause allows the level of a digital input (DI) to be used as an input to a logical rule. The DI can be checked to be either open or closed. The following example shows a simple logical rule which copies the DI open signal. Tamper Clause The 'tamper' clause uses the current state of tamper detection as an input to a logical rule.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Learning Clause When scene change detection is enabled, if tracking system detects a drastic change in the scene it temporarily disables the tracking while it learns a new scene model. The 'learning' clause is triggered for the duration of this learning period, so allows the scene learning to be used as an input to a logical rule. Action Types Actions can be assigned to logical rules to perform tasks when they are triggered.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Counters VCAsys also supports object counting. Any combination of detection zones or lines can be assigned to a counter. Counters can be configured to perform any combination of incremental, decremental or occupancy counting. Counter configuration is managed through the properties inspector in an equivalent way to the zone configuration.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Assigning Rules to Counters Counters count triggers generated by rule violations. For example, if it is required to count the number of objects entering a zone, a zone must initially be configured to raise an alarm every time an object enters it. The zone can then be assigned to a counter and the counter will count the objects according to the type of counting required (increment, decrement, occupancy).
Ganz GXi Series VCA Interface Manual V3.05.31.18 Counter Storage and Reporting Counter Database Service The database service is responsible for logging all the counter values at regular intervals to up to 4 database tables. To access the Database Service configuration page, click the Database Service tab under the Counter Reporting menu option. Enable Database Service The control for enabling/disabling the database service.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Total DB Size The maximum size of the database when internal flash is selected as the storage medium is 512KB. The display shows how much storage is in use out of the total available. If the configuration of the database tables would cause the storage requirement to exceed the maximum the user is warned before the settings can be applied. Database Table Configuration The database allows up to 4 tables to be configured (0-3).
Ganz GXi Series VCA Interface Manual V3.05.31.18 Counter Reporting Service The reporting service is the user-interface into the counter storage and reporting functionality. It allows the user to query the database service to generate reports, tables and even export data to Microsoft Excel for further analysis. The essence of the counter reporting page is to select the query parameters and then select whether it should be displayed as a table, bar or exported to CSV.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Bar Graph Reporting Clicking the Bar button pops up a new window with a bar graph of the results. The color of each bar matches the color of the counter on the Zones & Rules configuration page. CSV Export Clicking the CSV button offers a file that contains the results of the query in comma-separated-variable format.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Predefined Requests The counter reporting service has several pre-defined requests that reflect the most common usage scenarios. It's possible to just select one of these pre-defined requests and click one of the reporting modes directly to generate a report in a very short amount of time.
Ganz GXi Series VCA Interface Manual V3.05.31.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Value Type Specifies the results returned should be absolute counts or the difference between the current and previous sample. Can be one of: Value Type Absolute Difference Details The actual counter values are returned The difference between this and the previous sample is returned Request Click one of these buttons to generate either a table, bar chart or CSV output based on the specified query parameters.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Adding a New Email Notification Recipient Multiple reports and recipients can be defined. To add a new recipient/report clicking the "Add" button opens a new window where the settings are configured. Email Configuration Configures the recipient settings Name The name of the report. The email subject will contain this name. Description The description of the counter email report.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Schedule Configuration Configures the schedule for the time and frequency of email notifications Current Device Time The current date and time of the device. Enable Hourly Report Enable hourly email report notification. Note that the hourly report is always sent on the hour and always contains the data from the previous full hour. Trigger Time Select the time during which notification emails should be sent.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Trigger Time Select the time that the email notification should be sent. Weekday Select the days of the week on which the report should be sent. The reports will only be sent at the specified time on the days selected. e.g. If the checkbox "Monday" and "Friday" are ticked and the trigger time is set to 9:00, then a report will be sent at 9:00 on every Monday and every Friday. Enable Weekly Report Enable a weekly notification email.
Ganz GXi Series 05-2018-A VCA Interface Manual V3.05.31.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Trigger Day Select the day of the week when the weekly notification is sent. Trigger Time Select the time of day that the notification should be sent. e.g. If the trigger day is set to Friday and the trigger time is set to 9:00, then the email notification will be sent every Friday at 09:00. Enable Monthly Report Enable a monthly notification email.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Trigger Day Select the day of the month on which the notification should be sent. If the day of the month is set to "31" and the current month doesn't have 31 days, the notification will be sent on the last day of the month. e.g. If the trigger day is set to 31, but the current month is April, the email notification will be sent on April 30th. Trigger Time Select the time when the notification should be sent. e.g.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Counter ID Specifies which counters are included in the report. Can be any one of: Counter ID Active All One of 0-19 Details All currently displayed counters All counters An individual counter id Example 1,4,5,6 0-19 1 Table (Sampling) Select which tables are used as source count data to be included in the report. Multiple selections are possible. Sorting Order Selects the sorting order of the count data.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Send Test Report Click to send a test report to the specified email address to validate the report configuration. Note: Requires that the camera SMTP and DNS settings are correctly configured.
Ganz GXi Series VCA Interface Manual V3.05.31.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Importing Data into Microsoft Excel The counter reporting service is compatible with Microsoft Excel's “Import Data from Web” function which allows users to extract a real-time data feed from one or many cameras and then use Excel's powerful data analysis functions to perform further data processing. On the counter reporting page, set up the query to generate the data view required. Then copy the URI from the Request URI box to the clipboard.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Open Excel and import the data feed as illustrated below: The data is then displayed in Excel and can be processed further. In this example, the three counters have been added to a bar chart.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Other Reports Additionally, to counter reports, the user can obtain reports from other sources of data available such as heatmaps, events, and tracks. All the reporting utilities are grouped in the configuration page, under 'VCA > Reporting' the user will find: • • • • Counter reports (as seen) Heatmap reports Events reports Tracks reports These other reporting facilities are described in the following sections.
Ganz GXi Series VCA Interface Manual V3.05.31.18 When the 'PNG' button is clicked, a heatmap image will be generated and downloaded by the browser.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Events Reporting The events reporting page allows the user to retrieve a CSV file with events that occurred during a certain time. Furthermore, the user can retrieve only events from certain types of rules. Configuring and Enabling the Service To start collecting events, the user should enable the service under the 'Database Service' tab. Additionally, in that same tab, the user can select the amount of storage that is to be dedicated to event storage.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Please note: if no rules are selected, it is assumed that all events should be retrieved, regardless of the rule that triggered them. Example CSV File Once the interval and, optionally, the rules have been selected, the user can click the 'CSV' button to obtain a CSV file that can be imported into Microsoft Excel, or any other spreadsheet program of their choice.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Tracks Reporting As with events, the tracks reporting page allows the user to retrieve a CSV file with tracks that were generated during a certain time. Configuring and Enabling the Service To start collecting tracks, the user should enable the service under the 'Database Service' tab. Additionally, in that same tab, the user can select the amount of storage that is to be dedicated to track storage.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Description of CSV fields: • • • • • • • ID: The unique id of the track given by the database (not necessarily that of the tracker). Channel: Channel where the track was observed (where multiple channels are available). Track ID: The id assigned to the track by the tracker (might be repeated after reboot). Point: The point described by this row. NR Points: The total number of points in the track.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Tamper Detection The Tamper Detection module is intended to detect camera tampering events such as bagging, defocusing, moving the camera, etc. This is achieved by detecting large persistent changes in the image. The output of the tamper detection algorithm is displayed as red blocks on the image. The red area is where the algorithm has detected that the image has changed from its reference image.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Scene Change Detection The Scene Change Detection page allows the user to adjust the settings of the scene change detection algorithm. The scene change detection module resets the tracking algorithm when it detects a large persistent change in the image. This prevents the tracking algorithm from detecting image changes as tracked objects which can be potential sources of false alarms.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Day/Night Mode Change Detection Settings The day/night mode change detection algorithm, when enabled, can detect the change between day mode and night mode of the camera and inhibit VCA while the transition is happening. This prevents false positive detections caused by the change from color to black & white or vice versa. Burnt-in Annotation The Burnt-in Annotation setting allows the VCA annotation to be burnt in to the raw video stream.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Zone Configuration Check to enable burnt-in annotation of the detection zones. Non-detect zones are drawn with a dashed border. Object Configuration Select the object properties to display. The object text size can be changed according to the user's preferences. Objects can be displayed in either two-color or multi-color mode. In two-color mode, select the display colors for objects in alarm and objects not in alarm.
Ganz GXi Series VCA Interface Manual V3.05.31.18 PTZ Profiles PTZ Presets represent discrete Pan-Tilt-Zoom camera configuration settings. Typically, several presets are enabled to observe various areas of interest surrounding the camera's installation location. The camera can move to and between PTZ Presets either manually or automatically. A VCA profile can be associated with each PTZ Preset.
Ganz GXi Series VCA Interface Manual V3.05.31.18 PTZ Control Element The PTZ Control is present when the camera supports PTZ movement in the VCA configuration pages 'Zones and Rules' and Calibration. An equivalent control is also present in the Repositioning page where PTZ Preset related settings are configured. In the Repositioning page, the VCA related profile buttons are not available. This shows the PTZ Control and its various elements: The control is composed of 3 sections.
Ganz GXi Series • • • • VCA Interface Manual V3.05.31.18 Preset name: An edit box containing the name of the currently selected Preset. This box is empty in the case when a Preset is disabled. the user must enter a name here before enabling the Preset. Go: This button instructs the camera to move to the position stored for the currently selected Preset. Set: This button stores the current position as the configuration for the currently selected Preset.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Create VCA Profile Delete VCA Profile Note: Once confirmed, the delete command will be sent immediately to the camera and all zones, rules and calibration settings associated with the profile will be lost. Disable PTZ Preset Note: if there is a VCA Profile associated with this Preset, the Profile is not deleted. It remains and will again become available once the Preset is re-enabled.
Ganz GXi Series VCA Interface Manual V3.05.31.18 PTZ Configuration and Auto-Tracking PTZ General Configuration PTZ General Configuration allows configuration of general VCA PTZ support. This extends the VCA functions to work with PTZ cameras. The general PTZ configuration for VCA is controlled by the settings highlighted in the red box in the figure below. Camera Preset Number for VCA Home Position This text box specifies the PTZ camera preset number for VCA home position.
Ganz GXi Series VCA Interface Manual V3.05.31.18 NOTE: If this function is disabled and the VCA is enabled only at the preset home position, VCA will not be automatically re-enabled. The only way to re-enable VCA in this mode is to manually return the camera to the VCA home preset position. PTZ Auto-tracking Configuration PTZ auto tracking allows a compatible PTZ camera to track a moving subject in real-time.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Allow Manual Override (User Control) When manual override is enabled, the auto-tracking algorithm will release control of the PTZ and stop controlling the PTZ camera if a user sends a manual PTZ command. The auto-tracking algorithm will reset when no user PTZ commands have been sent for the specified period. When manual override is disabled, all user PTZ commands will be ignored if auto-tracking is in progress.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Importing & Exporting VCA Configuration It is possible to export the VCA configuration from a device to an XML configuration file, and to re-load it back into the device at a later date. This might be useful for demonstration purposes, where multiple detection scenarios can be stored in separate configuration files, or in a situation where multiple devices need to share some basic VCA configuration parameters.
Ganz GXi Series • • VCA Interface Manual V3.05.31.18 PTZ: PTZ VCA configuration data. Includes general VCA/PTZ settings and PTZ autotracking settings. Scene Change: The scene changes detection configuration. Click the browse button to select the file to load. Click the 'Import' button to load the configuration and apply it to the device.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Generating External Event Notifications It is possible to assign the VCA alarms to trigger external events, e.g. a relay contact closure, a TCP/IP message, etc.
Ganz GXi Series Note: • • • VCA Interface Manual V3.05.31.18 Rising edge trigger sends the event when the VCA event starts Falling edge trigger sends the event when the VCA event ends 'Both' sends an event at the start and at the end of the VCA event. Select the event notification(s): The external event notification will be generated every time a VCA alarm is generated.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Advanced VCA Settings In most installations, the default VCA configuration will suffice. However, in some cases, better performance can be achieved with modified parameters. The Advanced VCA Settings page allows configuration of the advanced VCA parameters. Alarm Holdoff Time The Alarm Holdoff Time defines the time between the successive re-triggering of an alarm generated by the same object triggering the same rule.
Ganz GXi Series VCA Interface Manual V3.05.31.18 In this detection scenario, the person enters the zone 3 times. At each point an alarm is raised, resulting in a total of 3 alarms. With the Alarm Holdoff Time configured, it's possible to prevent re-triggering of the same rule for the same object within the configured time.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Measurement Units Allows the measurements units to be switched between Metric and Imperial formats. For more information, please refer to the Measurement Units topic. Metadata Format The metadata stream contains a complete description of every moving and stationary target, as well as additional diagnostic data to enable troubleshooting and optimum configuration.
Ganz GXi Series VCA Interface Manual V3.05.31.18 More Information For more information about the format of the metadata, please consult the VCAsys Metadata Format Manual. Stationary Object Hold-on Time The Stationary Object Hold-on Time defines the amount of time that an object will be tracked by the engine once it becomes stationary.
Ganz GXi Series VCA Interface Manual V3.05.31.18 The left picture shows the centroid mode, and the right one shows the Midbottom mode.
Ganz GXi Series VCA Interface Manual V3.05.31.18 People Tracker The IPT uses advanced 3D camera technology to provide far superior tracking accuracy in busy scenes than is achievable on ordinary cameras. It is a special purpose device designed to track adults in walking or standing positions. IPT devices require a special IPT license to activate tracking. Once activated, the Enable/Disable page will then allow VCA to be enabled, as with other IPN devices.
Ganz GXi Series VCA Interface Manual V3.05.31.18 Calibration The IPT tracking will only function if the device is calibrated and a warning message will be displayed if the device is in an uncalibrated state. • • • • • • • It is essential that the calibration be accurate to achieve good tracking performance. The 3D tracking boxes should be used to guide the calibration (ensure that burnt in annotation is disabled during the calibration process).
Ganz GXi Series VCA Interface Manual V3.05.31.18 An example of a correctly calibrated scene Scene Maintenance The IPT does not use a continuous scene learning algorithm. Instead, a new background model is constructed whenever there has been no movement detected for a period of time. This period of time is tied to the Stationary Object Hold-on Time parameter in the Advanced VCA Settings page.
Ganz GXi Series 05-2018-A VCA Interface Manual V3.05.31.
