Page 1
Ganz GXi Series VCA Interface Manual v1.0.66 SERIES NETWORK CAMERAS VCA Interface Manual v1.0.66 Before connecting, operating or adjusting this product, read this instruction booklet carefully and completely 07.12.22 Page 1...
Page 2
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 1 Introduction This is the user manual for the VCAedge video analytics plug-in. This manual will describe how to license, enable and configure the features of our video analytics to detect events of interest and trigger actions to react to those events.
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 2 Getting Started The VCAedge plug-in is a set of analytical tools that can be loaded onto supported cameras. It provides the means to perform advanced analytics, reduce false alerts and customize when events occur. To get started, you will need to add a license, after which you can enable the VCAedge engine and start using the features.
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 3 Enable/Disable By default, the VCAedge plug-in is disabled. Activate it to enable the plug-in. Enable Disable 3.1 General Setting • Enable: Defines the current state of the plug-in features. Select On and Apply to turn the fea- tures on.
Page 5
Ganz GXi Series VCA Interface Manual v1.0.66 • Deep Learning Object Tracker (DLOT) is designed for accurate detection and tracking of people, vehicles and other key objects in challenging environments where motion based tracking meth- ods would struggle. It is based on a classification and detection model, providing the location of an object in the field of view...
Page 6
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 4 Rules Rules are used to react to events within a scene and trigger actions. To manage the rules, navigate to the rules feature from the VCAedge menu. Rules The rules page displays a live view from the camera and allows you to add, modify or delete rules.
Page 7
Ganz GXi Series VCA Interface Manual v1.0.66 Note: The burnt-in annotation feature needs to be enabled for this option to function, this does not effect the processing of analytics but the annotation requires more resource from the camera and is not on by default.
Page 8
Ganz GXi Series VCA Interface Manual v1.0.66 *Note: Abandoned and Removed are available with Object Tracker Engine . 4.4 How to Add a Rule • Select Add to display the available rules. • Select the rule to be added. • Configure the rule accordingly.
Page 9
Ganz GXi Series VCA Interface Manual v1.0.66 The rule will create a zone and overlay it on the live view, the zone can be reshaped accordingly. Select- ing a grey node will split the segment and create a more complex shape, to remove a segment select the minus sign next to a red node.
Page 10
Ganz GXi Series VCA Interface Manual v1.0.66 • Action Rule: Allows actions, defined in the camera, to be triggered when an event occurs. • Convert VCA to MD: Allows the event to be passed to the cameras event engine which is com- patible with ONVIF.
Page 11
Ganz GXi Series VCA Interface Manual v1.0.66 Calibration Available classifiers of Object Filter disabled Not available (Object Filter Off) enabled the classifier defined in the classification • Hardware Platform or License that Tracker Engine is selectable Tracker Engine Calibration Available classifiers of Object Filter...
Page 12
Ganz GXi Series VCA Interface Manual v1.0.66 4.9 Enter The enter rule triggers an event when an object crosses from outside a zone to inside a zone. Note: The enter rule detects already-tracked objects crossing the zone border from outside to inside.
Page 13
Ganz GXi Series VCA Interface Manual v1.0.66 4.9.2 Event Actions • Event Notifications: Define the action that will occur on an event being triggered. – TCP Event: Enables/disables the triggering of the TCP notification when an event occurs. – HTTP Event: Enables/disables the triggering of the HTTP notification when an event oc- curs.
Page 14
Ganz GXi Series VCA Interface Manual v1.0.66 Exit The rule will create a zone and overlay it on the live view, the line can be reshaped accordingly. Selecting a grey node will split the segment and create a more complex shape, to remove a segment select the minus sign next to a red node.
Page 15
Ganz GXi Series VCA Interface Manual v1.0.66 The following applies for the notification methods selected. • Triggered By: Define when the notification will be sent. – Object: Send notification for each object triggering the rule. Choose between the begin of the object triggering the rule, as it enters the zones.
Page 16
Ganz GXi Series VCA Interface Manual v1.0.66 4.11.1 Rule Properties • Name: Defines the name of the rule. • Object Filter: Allows the rule to be configured to only trigger based on an objects classification (e.g. person, vehicle), any combination of the available options is possible.
Page 17
Ganz GXi Series VCA Interface Manual v1.0.66 4.11.3 Save Click Save to save the current settings. 4.11.4 Cancel Click Cancel to return to the rules screen without saving any changes. 4.12 Disappear The appear rule triggers an event when an object starts to be tracked from within a zone.
Page 18
Ganz GXi Series VCA Interface Manual v1.0.66 Tracker Engine Calibration Available classifiers of Object Filter Object Tracker disabled Not available (Object Filter Off) Object Tracker enabled the classifiers defined in the classification DL Object Tracker person, cyclist, bicycle, motorcycle, car, van, truck bus,...
Page 19
Ganz GXi Series VCA Interface Manual v1.0.66 Note: The stopped rule does not detect abandoned objects. It only detects objects which have moved at some point and then become stationary. Stopped The rule will create a zone and overlay it on the live view, the zone can be reshaped accordingly. Select- ing a grey node will split the segment and create a more complex shape, to remove a segment select the minus sign next to a red node.
Page 20
Ganz GXi Series VCA Interface Manual v1.0.66 4.13.2 Event Actions • Event Notifications: Define the action that will occur on an event being triggered. – TCP Event: Enables/disables the triggering of the TCP notification when an event occurs. – HTTP Event: Enables/disables the triggering of the HTTP notification when an event oc- curs.
Page 21
Ganz GXi Series VCA Interface Manual v1.0.66 Dwell The rule will create a zone and overlay it on the live view, the zone can be reshaped accordingly. Select- ing a grey node will split the segment and create a more complex shape, to remove a segment select the minus sign next to a red node.
Page 22
Ganz GXi Series VCA Interface Manual v1.0.66 – HTTP Event: Enables/disables the triggering of the HTTP notification when an event oc- curs. The following applies for the notification methods selected. • Triggered By: Define when the notification will be sent.
Page 23
Ganz GXi Series VCA Interface Manual v1.0.66 The rule will create a line and overlay it on the live view, the line can be reshaped accordingly. Selecting a grey node will split the segment and create a more complex shape, to remove a segment select the minus sign next to a red node.
Page 24
Ganz GXi Series VCA Interface Manual v1.0.66 will be sent for each triggering of the rule, regardless of the number of objects triggering at any one time. Note: Remember to configure the TCP/HTTP notification actions for the action rules feature to function. Any combination of the available options is possible.
Page 25
Ganz GXi Series VCA Interface Manual v1.0.66 – HTTP Event: Enables/disables the triggering of the HTTP notification when an event oc- curs. The following applies for the notification methods selected. • Triggered By: Define when the notification will be sent.
Page 26
Ganz GXi Series VCA Interface Manual v1.0.66 4.17.1 Rule Properties • Name: Defines the name of the rule. 4.17.2 Event Actions • Event Notifications: Define the action that will occur on an event being triggered. – TCP Event: Enables/disables the triggering of the TCP notification when an event occurs.
Page 27
Ganz GXi Series VCA Interface Manual v1.0.66 Tailgating The rule will create a line and overlay it on the live view, the line can be reshaped accordingly. Selecting a grey node will split the segment and create a more complex shape, to remove a segment select the minus sign next to a red node.
Ganz GXi Series VCA Interface Manual v1.0.66 – HTTP Event: Enables/disables the triggering of the HTTP notification when an event oc- curs. The following applies for the notification methods selected. • Triggered By: Define when the notification will be sent.
Page 29
Ganz GXi Series VCA Interface Manual v1.0.66 The rule will create a line and overlay it on the live view, the line can be reshaped accordingly. Selecting a grey node will split the segment and create a more complex shape, to remove a segment select the minus sign next to a red node.
Page 30
Ganz GXi Series VCA Interface Manual v1.0.66 4.19.3 Save Click Save to save the current settings. 4.19.4 Cancel Click Cancel to return to the rules screen without saving any changes. 4.20 Logical Rule Logical rules extend the standard rules to allow various inputs to be combined using logical expressions, this helps to reduce false events.
Page 31
Ganz GXi Series VCA Interface Manual v1.0.66 AND operator 4.20.3 WITHIN x seconds This is the same as a PREVIOUS operator and holds the event as true for the defined period of time. It allows an object to trigger one of the rules and then trigger the next rule within x seconds to cause an event to occur.
Page 32
Ganz GXi Series VCA Interface Manual v1.0.66 4.20.5 Colour Filter It provides the ability to pick up objects based on an object’s colour components that are grouped into 10 colours. Note: The colour filter of the rules that are included in the logical rule are disabled.
Page 33
Ganz GXi Series VCA Interface Manual v1.0.66 Non-detect zone The rule will create a line and overlay it on the live view, the line can be reshaped accordingly. Selecting a grey node will split the segment and create a more complex shape, to remove a segment select the minus sign next to a red node.
Page 34
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 5 Counters Counters can be configured to count the number of times a rule is triggered, for example the number of people crossing a line. Counters The counters page displays a live view from the camera and allows you to add, modify or delete coun- ters.
Page 35
Ganz GXi Series VCA Interface Manual v1.0.66 Note: The burnt-in annotation feature needs to be enabled for this option to function, this does not effect the processing of analytics but the annotation requires more resource from the camera and is not on by default.
Page 36
Ganz GXi Series VCA Interface Manual v1.0.66 More than one counting line rule can be assigned to a counter input. This allows, for example, the occupancy of two counting lines to be reflected in a single counter or more than one entrance / exit gate to be assigned to a counter.
Page 37
Ganz GXi Series VCA Interface Manual v1.0.66 5.3.4 Cancel Click Cancel to return to the counters screen without saving any changes. 5.4 How to Create a Counter • Click Add . • Position the counter on the screen, this is just for reference and does not effect the counter feature.
Page 38
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 6 Calibration Camera calibration is required in order for object identification and classification to occur. If the height, tilt and vertical field-of-view are known then these can be entered as parameters in the appropriate fields.
Ganz GXi Series VCA Interface Manual v1.0.66 Tilt: Defines the tilt of the camera. VFOV: Defines the vertical field of view of the camera. Note: A correct value for the camera vertical field of view is important for accurate calibration and classifi- cation.
Page 41
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 7 Classification When the calibration features have been defined, objects that are detected are assessed and assigned to one of the classifiers listed in the classification section. it has been preprogrammed with the most commonly used classifiers but these can added to or deleted as the scenario requires.
Page 42
Ganz GXi Series VCA Interface Manual v1.0.66 Classification- New Classifier • Define the parameters for the new classifier. Name: Defines the name of the new classifier. Min. Area: Defines the minimum area for the new classifier. Max. Area: Defines the maximum area for the new classifier.
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 8 Burnt-in Annotation The Burnt-in Annotation feature allows analytical data to be burnt in to the raw video stream of the camera. Annotations can include tracked objects, counters and system messages. Burnt-in Annotation Note: - To display object parameters such as speed, height, area and classifications, the device must be cali-...
Page 44
Ganz GXi Series VCA Interface Manual v1.0.66 8.1 Burnt-in Annotation • Activation: Defines the status of the feature, select between On and Off . • Display on: Defines the camera channel that will display the burnt-in annotation. Select be- tween Main Stream , Sub Stream and 3rd Stream .
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 9 TCP Notification The TCP notification sends data to a remote TCP server when triggered. The format is configurable with a mixture of plain text and tokens. Tokens are used to represent the event metadata that will be included when a rule is triggered.
Ganz GXi Series VCA Interface Manual v1.0.66 9.2 TCP Settings • Host URL: The IP address or hostname of the remote TCP server where the event data should be transmitted. • Port: The port to send the TCP notification to.
Page 47
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 10 HTTP Notification The HTTP notification sends a HTTP request to a remote endpoint when triggered. The URL, HTTP header and message body are all configurable with a mixture of plain text and tokens. Tokens are used to represent the event metadata that will be included when a rule is triggered.
Page 48
Ganz GXi Series VCA Interface Manual v1.0.66 10.2 HTTP Settings • URL: The IP address or hostname of the remote HTTP server where the event data should be transmitted. • Method: The HTTP request method. – POST: Used to send event data to the URL address.
Page 49
Ganz GXi Series VCA Interface Manual v1.0.66 • Post-Alarm Duration: Set duration for post-event snapshots. 10.5 How to Enable HTTP Notification • Select On to enable. • Define the URL (HTTP server that will be receiving this notification). • Define the Method to be used.
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 11 Tamper The Tamper feature is intended to detect camera tampering events such as bagging, defocusing and moving the camera. This is achieved by detecting large persistent changes in the image. Tamper 11.1 Tamper Detection...
Ganz GXi Series VCA Interface Manual v1.0.66 • Area Threshold: Defines the percentage area of the image which must be changed for tamper- ing to be triggered. • Suppress Alarm on light: In scenarios where sudden changes in lighting such as switching on/off...
Page 52
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 12 Advanced The advanced section contains settings relating to how the analytics engine tracks objects. Note: In most installations the default configuration will apply. Note: Supported settings are different depending on the tracker engine.
Ganz GXi Series VCA Interface Manual v1.0.66 • Stationary Hold-on Time: Defines the amount of time an object will continue to be tracked and classified once it becomes stationary. • Minimum Object Size: Defines the size of the smallest object that will be considered for tracking.
Page 54
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 13 License To take advantage of the VCAedge video analytic features a licence is required. In many cases, the VCA analytic features on a camera are pre-activated in the factory and further acti- vation is only necessary to enable additional functionality.
Ganz GXi Series VCA Interface Manual v1.0.66 13.1 Activate License • Activation Type: Defines the method that will be used for your activation request. – Token: Allows the activation token to be entered to apply further licenses. – Pre-activation: Defines that software has been pre-licensed and no further action is re- quired.
Page 56
Ganz GXi Series VCA Interface Manual v1.0.66 13.6 How to apply Activation Codes • Use the HWCODE to obtain an activation code for the license you would like to apply and send it to the hardware reseller. • The reseller sends an activation token by return.
Page 57
Ganz GXi Series VCA Interface Manual v1.0.66 Chapter 14 Tokens Tokens are used within actions events such as TCP and HTTP and are automatically filled in with the metadata for the event. This allows the details of the event to be specified in the message that the action sends, e.g.
Page 58
Ganz GXi Series VCA Interface Manual v1.0.66 14.1.6 {{time}} The event time in Unix time stamp format. An example of this would be: time: {{time}} time: 1582308244.376 14.1.7 {{ip}} The IP address of the device 14.1.8 {{host}} The hostname of the device that generated the event 14.1.9 {{datetime}}...
Page 59
Ganz GXi Series VCA Interface Manual v1.0.66 14.1.14 {{mac}} The MAC address of the device An example for using tokens is given below: Event #{{id}}: {{name}} Event type: {{type}} Start time (ISO 8601 format): {{iso8601}} time: {{time}} Device: {{host}}: {{ip}}: {{mac}} Object bounding box: {{bb}} Classification: {{objclass}}...
Need help?
Do you have a question about the GXi Series and is the answer not in the manual?
Questions and answers