Advertisement

Ganz GXi Series
VCA Interface Manual v1.0.66
SERIES
NETWORK CAMERAS
I
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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the GXi Series and is the answer not in the manual?

Questions and answers

Summary of Contents for Ganz GXi Series

  • 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.
  • Page 3: Getting Started

    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.
  • Page 4: General Setting

    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.
  • Page 28: Counting Line

    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.
  • Page 39: Graphics Overlay

    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 40 Ganz GXi Series VCA Interface Manual v1.0.66 Focal Length(mm) CCD Size (in) CCD Height(mm) 1/6“ 1.73 1/4“ 2.40 1/3.6“ 3.00 1/3.2“ 3.42 1/3“ 3.60 1/2.7“ 3.96 1/2“ 4.80 1/1.8“ 5.32 2/3“ 6.60 1“ 9.60 4/3“ 13.50 Focal Length(mm) CCD Size (in) CCD Height(mm) 1/6“...
  • 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.
  • Page 43: Burnt-In Annotation

    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 .
  • Page 45: Tcp Notification

    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.
  • Page 46: Tcp Settings

    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.
  • Page 50: Tamper Detection

    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...
  • Page 51: Event Action

    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.
  • Page 53: Scene Change

    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.
  • Page 55: Activate License

    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}}...

Table of Contents