Version

Version11
11

User
User Guide
Guide
SecurOS Cargo User Guide (UG - EN, build 117 on 7/13/2023).

© Copyright Intelligent Security Systems, 2023.

SecurOS® ("SecurOS") and all respective logos are trademarks of ISS Corp, in the U.S. and/or other countries.

Intelligent Security Systems reserves the right to make changes to both this Manual and to the products it describes. System
specifications are subject to change without notice. Nothing contained within this Manual is intended as any offer, warranty, promise
or contractual condition, and must not be taken as such.

No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system or translated into any human or
computer language in any form by any means without the express written permission of the copyright holder. Unauthorized copying
of this publication may not only infringe copyright but also reduce the ability of Intelligent Security Systems to provide accurate and
up-to-date information to both users and operators.
 SecurOS Cargo 3 User Guide
Contents

Contents
1 Preface 5
1.1 Scope
........................................................................... 5
1.2 Target
. . . Audience
........................................................................ 5
1.3 Using
. . .This
. . . .Manual
.................................................................... 5
1.4 Getting
. . . .Technical
. . . . . . . . .Support
.............................................................. 5
1.5 Design
. . . .Convention
....................................................................... 6
1.6 Design
. . . .Elements
....................................................................... 7

2 General Description 8
2.1 Implementation
. . . . . . . . . . .and
. . . .Operation
. . . . . . . . .Principles
................................................... 8
2.1.1 Hardware-Software
. . . . . . . . . . .Platform
. . . . . . . Requirements
................................................................... 8
2.1.1.1 Server Requirements . . . . .To
. . .Install
. . . . .Recognition
. . . . . . . . . .Module
................................................... 8
2.1.1.2 Operator Workstation . . . . . and
. . . .SecurOS
. . . . . . . Cargo
. . . . . .Dedicated
. . . . . . . .DB
. . .Server
. . . . . .Requirements
................................... 9
2.1.2 System .Architecture
.................................................................................... 9
2.1.2.1 System Components
.......................................................................... 10
2.1.3 System. .Operation
................................................................................... 10
2.2 Types
. . . .of
. .Configurations
..................................................................... 11
2.2.1 Standalone
. . . . .Configuration
................................................................................ 11
2.2.2 Server-Workstation
. . . . . . . . . . . .Configuration
......................................................................... 11
2.2.3 Distributed
. . . . .Configuration
................................................................................ 11

3 Deploying Module 13
3.1 Installing
. . . . . . .Hardware
.................................................................... 13
3.1.1 Installing
. . . Video
. . . . . .Cameras
............................................................................ 13
3.1.2 Illumination
..................................................................................... 14
3.2 Installing
. . . . . . .Software
.................................................................... 15
3.3 Updating
. . . . . . .Module
. . . . . . Database
. . . . . . . . .Structure
..................................................... 22

4 Module Administration 23
4.1 Objects
. . . . . Reference
...................................................................... 23
4.1.1 Database
..................................................................................... 23
4.1.2 Cargo:. Group
. . . . . .of
. .modules
............................................................................ 25
4.1.3 Cargo:. Side
. . . . number
. . . . . . . recognizer
......................................................................... 25
4.1.3.1 Video source Tab .......................................................................... 27
4.1.3.2 Recognition Tab .......................................................................... 30
4.1.3.3 IMDG classes Tab .......................................................................... 32
4.1.4 Cargo:. Top
. . . .number
. . . . . . .recognizer
......................................................................... 34
4.1.5 Cargo:. Consolidator
.................................................................................... 34
4.1.5.1 SecurOS Cargo. .Quick . . . . .Setup
. . . . .Guide
. . . . .to
. .Work
. . . . .with
. . . Consolidator
............................................... 36
4.1.6 Cargo:. Logic
. . . . . module
............................................................................... 37
4.1.6.1 Recognizers Tab .......................................................................... 38
4.1.6.2 Watchlists Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
4.1.6.2.1 External Database
. . . . . . . .Connection
. . . . . . . . . Example
......................................................... 46
4.1.7 Cargo:. GUI
.................................................................................... 55
4.1.7.1 Display Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.1.7.2 Additional Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
4.2 Configuration
. . . . . . . . . . .Examples
................................................................ 60
4.2.1 Standalone
. . . . .Configuration
................................................................................ 61

www.issivs.com
 SecurOS Cargo 4 User Guide
Contents

4.2.2 Server-Workstation
. . . . . . . . . . . .Configuration
......................................................................... 64
4.2.3 Distributed
. . . . .Server-Workstation
. . . . . . . . . . . . . . . . .Configuration
............................................................... 66

5 Working with Module 69

5.1 Working
. . . . . .in
. .Protocol
. . . . . . . .Window
........................................................... 70
5.1.1 Working. . .with
. . . .Results
. . . . . . .Tab
....................................................................... 71
5.1.1.1 Automatic and .Manual . . . . . .Protocol
. . . . . . .Modes
............................................................ 72
5.1.1.2 Switching Protocol . . . .Modes
...................................................................... 73
5.1.1.3 Working with Results . . . . . .Tab
. . . Records
................................................................. 74
5.1.2 Working . . .with
. . . .Search
. . . . . .Tab
........................................................................ 75
5.1.2.1 Searching .......................................................................... 76
5.1.2.1.1 Typical Search . . . . . Operations
..................................................................... 79
5.1.2.2 Pattern Search. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
5.1.2.3 Working with Search . . . . . .Results
.................................................................... 81
5.1.3 Working. . .with
. . . .Watchlists
. . . . . . . . .Tab
..................................................................... 81
5.1.3.1 Typical Operations . . . .with
. . . .Watchlists
. . . . . . . . Records
.......................................................... 82
5.1.3.2 Watchlists Changes . . . . .History
..................................................................... 85
5.2 Working
. . . . . .in
. .Details
. . . . . . Window
............................................................. 87
5.2.1 Operations
. . . . .in
. .Details
. . . . . .Window
........................................................................ 90
5.3 Working
. . . . . .with
. . . .Media
. . . . . .Client
........................................................... 93
5.4 Self-diagnostic
. . . . . . . . . . . .with
. . . .the
. . .Help
. . . . of
. . .Health
. . . . . .Monitor
. . . . . . .Module
.................................... 93
5.4.1 Cargo:. Side
. . . . (top)
. . . . .number
. . . . . . .recognizer
. . . . . . . . . Object
. . . . . . Problems
..................................................... 95
5.4.2 Cargo:. Logic
. . . . . module
. . . . . . . Object
. . . . . .Problems
.................................................................. 96

6 Appendixes 98
6.1 Appendix
. . . . . . .A.
. .Camera
. . . . . . . Calibration
. . . . . . . . . .Utility
................................................. 98
6.1.1 Distortion
. . . . .Tab
................................................................................ 102
6.1.2 Perspective
. . . . . . Tab
............................................................................... 103
6.1.3 Zoom/Rotation
. . . . . . . . .Tab
............................................................................ 104
6.1.4 Points
. .Calibration
. . . . . . . . . .Tab
......................................................................... 105
6.2 Appendix
. . . . . . . .B.
. . Module
. . . . . . .Events
. . . . . . .and
. . . Commands
. . . . . . . . . . .Reference
..................................... 105
6.2.1 Cargo:
. . Side
. . . . number
. . . . . . . recognizer
........................................................................ 105
6.2.2 Cargo:
. . Top
. . . .number
. . . . . . .recognizer
........................................................................ 106
6.2.3 Cargo:
. . Logic
. . . . . module
.............................................................................. 107
6.3 Appendix
. . . . . . . .C.
. . Technical
. . . . . . . . .Support
. . . . . . . Information
................................................. 110

Index 112

www.issivs.com
 SecurOS Cargo 5 User Guide
Preface

1 Preface
This section contains general information about the document, the means of its design and use, as well
as how to get additional technical support for the product.

1.1 Scope
This guide provides an overview of the possible configurations of the system, as well as the process of
installing and configuring the SecurOS Cargo Module on the server and the administrator's
workstation. Additionally, this guide describes the operator interface, and provides a list of events and
actions to control the Module's objects in the system.

1.2 Target Audience

· Installing and configuring software: this manual is intended for system administrators who are
experienced users of the Microsoft Windows operating system, with expertise in CCTV technology,
computer hardware, configuring a local area network, TCP/IP networking, and with a basic
knowledge of using/configuring macros and scripts.
· Monitoring and operational activities: this manual is intended for SecurOS operators, having basic
computer skills and familiarity with the SecurOS user interface.

1.3 Using This Manual

This document is organized in such a way that the user can use both its printed and electronic versions.
In the latter case one can use Adobe Reader's Bookmarks feature as well as cross-reference hyperlinks to
navigate through content. In several topics this manual refers to other SecurOS manuals, which can be
found as separate files on the SecurOS installation CD or downloaded from our website
(www.issivs.com).

To get online help (Microsoft HTML Help) just press the F1 key when running SecurOS. In
administration mode You can get context help for a given object/utility by pressing the F1 key when its
settings window/utility window is open. In operator mode, use the F1 key to open a description of the
active window of the current operator interface or utility.

1.4 Getting Technical Support

If you have any questions after reading this manual, please address them to your system administrator
or supervisor.

For any further information you can contact the Intelligent Security Systems Technical Support Team:

Note. For all technical support requests, please open a ticket from the ISS Partner Portal:
https://support.issivs.com. You will need to create an account if you don’t already have one.

www.issivs.com
 SecurOS Cargo 6 User Guide
Preface

· in USA:
Phone: +1 732 855 1111
· in Canada:
Phone: +1 778 929 8565
· in Mexico:
Phone: +52 55 9001 5252
· in Colombia:
Phone: +57 320 303 2849
· in Brazil:
Phone: +55 85 9668 2530
· in Central America and Caribbean:
Phone: +502 5517 8395
· in Argentina/ Paraguay/ Uruguay:
Phone: +54 911 5039 6440
· in Peru/ Bolivia/ Chile:
Phone: +56 9 3261 9893
· in Ecuador:
Phone: +57 312 255 2932
· in Venezuela:
Phone: +57 321 722 0425
· in Europe:
Phone: +380 44 299 0810
· in Dubai:
Phone: +971 4 874 7100
· in Qatar:
Phone: +974 6 677 8309
· in Saudi Arabia:
Phone: +966 54 109 9699

To solve problems faster, we recommend preparing the service information described in the Technical
Support Information Section before addressing the Technical Support Team.

1.5 Design Convention

For representation of various terms and titles the following fonts and formatting tools are used in this
document.

www.issivs.com
 SecurOS Cargo 7 User Guide
Preface

Font Description

Used in writing workstation names, utilities or screens, windows

bold type and dialog boxes as well as the names of their elements (GUI
elements).

italic type Used to mark out the SecurOS objects.

bold italic type Used to mark out the elements of homogeneous lists.

Used to mark out macro text and programming code, file names and
monospace their paths. Also it is used to specify the necessary options, to mark
out values specified by the user from the keyboard (manually).

Used to mark out the cross-references within the document and

green
links to the external available ones.

1.6 Design Elements

Warning! Serves to alert the user to information which is necessary for the correct perception of the text set
out below. Typically, this information has a warning character.

Note. Note text in topic body.

Additional Information
Used to display additional information. These type of elements contain, for example, the description of options for
executing a task or reference to additional literature.

www.issivs.com
 SecurOS Cargo 8 User Guide
General Description

2 General Description
The SecurOS Cargo Module of the SecurOS integrated security system is intended for automatic
recognition of the container numbers detected in a camera view. Integration of the Module with the
SecurOS system allows its use with other monitoring systems (e. g. video and audio control, access
control) and equipment (e. g. scales, barriers). A server-workstation architecture allows for a distributed
system.

The Module has the following capabilities:

· Recognition of container numbers on video streams from one or several cameras.
· Registering recognized container numbers in internal database with additional data: transit date
and time, video information referencing (freeze or video frame), etc.
· Extended searching for recognized numbers through databases (in external customer database and
internal Module’s database) in real time.
· Recognition of the IMDG codes.
· Searching containers by dangerous goods classes.
· Using databases as white (“have access”), black (“no access”) and/or information list.
· Editing internal database.
· Printing a report of the captured container: print frame and information about the recognized
number.

2.1 Implementation and Operation Principles

This section contains the software and hardware platform requirements for installing SecurOS Cargo;
the description of the system architecture; the description of the different types of configurations; and it
also provides recommendations regarding the placement of the SecurOS Cargo objects in the SecurOS
system Object Tree.

2.1.1 Hardware-Software Platform Requirements

This section summarizes the hardware/software requirements which are recommended to install the
SecurOS Cargo Module.

Warning! Calculations of individual configurations for best system performance, are recommended to be
performed with a Intelligent Security Systems specialist.

2.1.1.1 Server Requirements To Install Recognition Module

Basic requirements for the SecurOS servers are listed in the SecurOS Administration Guide.

Depending on the number of recognition channels, the requirements may vary according to the
performance of the processor and RAM.

www.issivs.com
 SecurOS Cargo 9 User Guide
General Description

Note. One installed Cargo: Top (side) number recognizer corresponds to one channel of recognition.

2.1.1.2 Operator Workstation and SecurOS Cargo Dedicated DB Server Requirements

Requirements for the Operator Workstation and the Dedicated DB Server are listed in the SecurOS
Administration Guide.

2.1.2 System Architecture

The architecture of the SecurOS Cargo Module is illustrated in Figure 1.

Figure 1. SecurOS Cargo Module Architecture

www.issivs.com
 SecurOS Cargo 10 User Guide
General Description

2.1.2.1 System Components

SecurOS Cargo consists of the following components:
· Cargo: Group of modules — system object. Is used to group SecurOS Cargo system objects. This object
has no settings to configure.
· Cargo: Logic module — system object. Is used to describe SecurOS Cargo system object's logical
connections, determining data flow directions between them. For example, it allows to specify
which Database will be used by the given Recognizer and which Cargo: GUI will be used to display
information.
· Cargo: Top number recognizer — system object. Represents the SecurOS Cargo core and is designed to
analyze the video stream using the recognition algorithms. This type of Recognizer is used to work
with video streams where topsides marking of container is displayed.
· Cargo: Side number recognizer — system object. Similarly to Cargo: Top number recognizer represents
the SecurOS Cargo core and is designed to analyze video streams displaying sidewall and front side
container marking.
· Cargo: Consolidator — system object. Is used for receiving and consolidating recognition results from
several (usually, three) Recognizers, working with video streams from side view and top view
cameras, installed in control point. So, the separate Cargo: Consolidator module is required for each
control point.
· Cargo: GUI — system interface object. Module is designed to monitor information provided by
Recognizers and to work with the Database both in real-time and archive mode.
· Database — SecurOS Cargo's PostgreSQL database. Intended to store recognized container numbers
and associated additional information. To work with information stored in the Database, the Cargo:
GUI object is used.

All SecurOS Cargo's objects (except Database) can be separated into Server-side and Client-side
components.

The following objects are the server-side components: Cargo: Logic module, Cargo: Top number recognizer,
Cargo: Side number recognizer; Cargo: GUI is the client-side component.

2.1.3 System Operation

The video stream from the dedicated Camera (for container number recognition) is sent to the Cargo: Top
number recognizer (or Cargo: Side number recognizer).

Note. Module have two type of the object to recognize container numbers (Recognizers) — the top view
container number video stream (topsides marking, see Cargo: Top number recognizer) and normal view
video stream (sidewall marking, see Cargo: Side number recognizer).

The Recognizer analyzes the video stream using the ISS recognition algorithms, and automatically
localizes the container number(s) in the Camera field of view. Additional algorithms read the characters
from the container numbers(s) and store them in the Database (or, depending on settings, is sent to the
Cargo: Consolidator). The container numbers data is then displayed in the module's Cargo: GUI. If Cargo:
Consolidator is used then recognition results from several Recognizers are sent to the Cargo: Consolidator,
where they are processed to get a final result. Final recognition result is stored in the Database and is
displayed in the module's Cargo: GUI.

Depending if the recognized container numbers exist in a list ("black list", "white list" or "information
list") in a local Database or in a connected external Database, each result will be color-coded and
displayed in the Module's GUI.

www.issivs.com
 SecurOS Cargo 11 User Guide
General Description

2.2 Types of Configurations

This section briefly describes common configurations of SecurOS Cargo.

2.2.1 Standalone Configuration

In this configuration all components (both server-side and client-side) of SecurOS Cargo will be
installed on one Video Server in the SecurOS security network. This configuration is typical for relatively
small systems, allowing for all types of SecurOS specific tasks to be done from one Computer: connection
of equipment, system administration, monitoring, and management of data coming from the installed
module(s).

2.2.2 Server-Workstation Configuration

In this type of configuration, components of SecurOS Cargo are installed on different computers
according to their types: server-side components on a Video Server, and client-side components — on a
Operator Workstation. Database can be installed on any network Computer.

In this case, the Video Server will be responsible for performing the recognition of the container
numbers, saving the results into a database, and storing the video archive associated with the results.
The Operator Workstation will be used for video monitoring purposes and for working with the system
GUI.

Installing system components on computers with different types of pre-installed SecurOS software is
described in section Installing Software.

2.2.3 Distributed Configuration

In this case the Module software can be installed on different Computers: several servers and
workstations. Therefore each Computer will be responsible for performing certain tasks.

This configuration is intended to use for security systems with intense data streams. With the use of a
distributed configuration, computational tasks will be assigned to separate Computers to make the
functionality of the Module more efficient and balanced. This configurations allows for the use of
several Operator Workstations.

Module server-side components have to be installed on a Video Servers only. Module client-side
components — on Operator Workstations (see Installing Software). Data exchange between operator
workstations and video servers is done through the TCP/IP network.

The following tasks can be performed on separate servers/workstations (in a distributed configuration):
· Video capturing, processing of images, and saving them to video archive — on Video Server;
· container numbers recognition — on Video Server;
· Data recording (information about recognized container IDs, container speed, etc.) in database —
on Database Server (any computer in the system except the Operator Workstation);
· Processing and analyzing data — on Video Server.

www.issivs.com
 SecurOS Cargo 12 User Guide
General Description

The Operator Workstation will be used for video monitoring purposes and for working with the system
GUI.

Note. A distributed server-workstation configuration allows for a further increase of the computational
resources by adding servers targeted to each specific task.

www.issivs.com
 SecurOS Cargo 13 User Guide
Deploying Module

3 Deploying Module
The Module installation procedure consists of the following stages:
1. Checking system requirements of the servers and workstations (see Sections Server Requirements
To Install Recognition Module and Operator Workstation and SecurOS Cargo Dedicated DB
Server Requirements).
2. Installing Hardware (e. g. video capture cards) on each server and connecting external hardware (e.
g. cameras).
3. Installing Software.

3.1 Installing Hardware

This section provides guidelines for the installation of cameras and lighting, which if followed will
provide the best recognition results.

3.1.1 Installing Video Cameras

The best camera position (for recognition) is the frontal view of the marking plate on the top or on the
side of the container. The cameras can be installed either at the top or side of the container. Allowable
distance from camera to container depends on camera's lens characteristics (average from 3 to 30
meters). Camera control zone is determined by camera configuration (maximum size — 5 meters), see
Cargo: Side number recognizer for more information.

For side cameras, it is recommended to choose half-height of containers moving within a frame as a
camera vertical position (from 2 to 4 meters). In any case, cameras looking at container sidewalls must
be mounted somewhat lower than the top edge of normal-height containers in order to see no part of
their topsides. That is, the camera must not be mounted too high above the ground.

The camera should be framed to see both horizontal numbers near the top of 3-meters-high containers
and (the lowermost) check digits of vertical numbers on normal containers, which can reach as low as
0,5 meters over the container floor. Therefore, at least 2.5 meters and preferably 3,1 meters of the
container sidewall should well fit into frame.

A few important considerations related to the choice and setup of the video cameras are given below.

Warning! Failing to follow these guidelines could result in poor recognition rates.

· Camera type. Use a high resolution camera (above 500 television lines) with a 1/2" or 1/3" image
sensor and optional manual setting of exposure from 1/2000 to 1/5000 s.
· Camera lens type. Use a zoom lens to provide the best recognition results. The upper limit of the
focal length must not be less than 80 mm for such cameras. These lenses allow you to get high
quality image of the container from different distances.
· Camera features. Additional camera features such as auto focus and auto shaking compensation
should be disabled.

www.issivs.com
 SecurOS Cargo 14 User Guide
Deploying Module

· Enabling/ disabling the auto-iris function. It is recommended to provide sufficient light and turn
the auto-iris function off for best recognition results. If it is impossible to provide such conditions
then turn the auto-iris function on.

To setup the iris diaphragm:

1. Turn the objective to auto-aperture mode.
2. Almost shade the camera aperture.
3. Make some snap-shots of containers passing.
4. Watch the created images from the video archive. If these images are blurry, slightly open the
aperture and repeat the procedure.
· Electronic shutter. Use cameras with high resolution and manual exposure time of 1/2000 or
1/5000 seconds.
· Sensitivity. It is recommended to use cameras with high sensitivity (for darkened conditions), e. g.
0.1 –0.001 lux.

Warning! For reliable recognition, the frame rate of the video from the Recognizer's camera should be
sufficiently high, for example, not less than 25 fps. Technically, each container number, passing in front of the
camera, should be fully visible in at least four to five video frames. Therefore, when containers are known to
move slowly, the frame rate can be reduced to 12 fps.

The module can work with megapixel video taken from IP-cameras. However the identification of
container numbers does not require very high resolutions, and processing of large images takes more
time and resources. Normally a frame with the vertical size of 500 - 600 pixels would be enough.
More than 800 pixels will hardly ever be needed. With a container height of 300 cm falling onto 600
pixels, we have 2 pixels per cm or 20 pixels per 10 cm, which is the typical size of characters in
numbers appearing on container sidewalls. A camera resolution of 800×600 can be used for side view
cameras.

3.1.2 Illumination

Acceptable recognition conditions are achieved in such lighting that provides a contrast between the
container number symbols and the background in the frame of not less than units 15-20
brightness/intensity of the digitized image.

The most suitable conditions for recognition arise when contrast exceeds 40 units of
brightness/intensity of the digitized image.

Note. If artificial lightening is used, there has to be no glare on the receiving video and no exposure on the
obtained image.

In the night, additional directional lights sources should be used to illuminate container numbers, for
example, LED projectors with white light or infrared.

The parameters of the projectors are selected depending on the angle of luminosity, the distance of the
illumination and the level of background illumination. Also a backlight IR illuminator can be used in
case there is no place to install additional illumination. Model of the IR illuminator is selected
depending on the necessary illumination angle and distance.

With an IR illuminator it is recommended to use cameras together with an IR corrective filter for glare
and camera extra exposure compensation.

www.issivs.com
 SecurOS Cargo 15 User Guide
Deploying Module

Note. It is not recommended to use IR illuminators if there is sufficient artificial lighting.

Additional information
The brightness of the point of the digitized image is traditionally measured by a number lying in the 0 — 255
range of values. One can find out these numerical values using the Camera Calibration Utility, in the status bar of
which one can see the coordinates and brightness of the point of the image, pointed to by the cursor, or with the
help of popular graphics editors.

3.2 Installing Software

To install the SecurOS Cargo Module software do the following:

1. Stop the Video Management System Server service with the Server Control Agent utility (see
SecurOS Administration Guide). Its icon can be found in the system tray.

Note. The Video Management System Server can also be stopped with the Windows tools: Computer →
Manage → Services and Applications → Services.

2. To start Module software installation launch the product setup file. In the displayed dialog window
(see figure 2) select the language which will be used during the installation process, then click the
OK button.

Figure 2. Select Setup Language Window

Warning! Language of the Module software is selected automatically and depends on the language of the the
installed SecurOS software. If Module supports the language that you has specified when installing the
SecurOS software, then Module software is installed on the same language. If Module does not support the
language that you has specified when installing the SecurOS software, then Module software is installed in
English.

3. If previous software version is detected on the computer, then the appropriate informational
message will be displayed (see Figure 3).

www.issivs.com
 SecurOS Cargo 16 User Guide
Deploying Module

Figure 3. Informational message

Click the OK button to continue.

4. System will display Select Components window (see figure 4).

Figure 4. Select Components Window

Select one of the Module installation modes:

· Full Installation — all components will be installed;
· Recognition server installation — only container number recognition and database
server Module components installation (without user interface);
· Operator’s workplace installation — only graphical user interface Module component
will be installed. Select this option when installing Module on Operator Workstation;
· Custom installation — user selectable Module components installation. Option is used in case
of separate installation of Module components in other combinations, such as, for example,
SecurOS Cargo Database.

www.issivs.com
 SecurOS Cargo 17 User Guide
Deploying Module

Warning! When installing SecurOS Cargo on Video Server it is necessary to install all Module components
(SecurOS Cargo Database component is installed optionally). Otherwise, updating the system from the
Conf iguration Server will lead to the system not working correctly. On Operator Workstation it is enough to
install LPR: Operator GUI.

Click the Next button to continue. If the SecurOS Cargo Database option was selected, go to step 5,
otherwise go to step 8.
5. System will display Database object settings window (see figure 5).

Figure 5. Database Settings Window

Define database parameters. Set new database name and account for a new PostgreSQL database. If the
Module has been previously installed on this computer in Recognition server installation
mode and you wish to keep the existing data from this database, then specify the existing database
name and account. Click the Next button to continue.
6. If the same database defined in step 5 has been found, the system will display the Database exists
window (see figure 6), otherwise installation will automatically proceed to step 7.

www.issivs.com
 SecurOS Cargo 18 User Guide
Deploying Module

Figure 6. Database exists Window

Select one of the following options:

· Use database 'cargo' — use old PostgreSQL database from the previous Module installation
on this computer. The previous Module version must correspond to the current one to guarantee
correct database functionality;
· Reinitialize (clean) database 'cargo' — database will be reinitialized: all information
in it would be deleted.
Click the Next button to continue.
7. If PostgreSQL DBMS has already been installed on this computer, but the database with the specified
parameters was not found, the setup wizard will display the Database creation window
(see figure 7).

www.issivs.com
 SecurOS Cargo 19 User Guide
Deploying Module

Figure 7. Database creation Window

In the Database creation window specify the PostgreSQL superuser credentials (user name and
password) necessary for creating Module database. Click the Next button to continue.
8. If the Templates of watchlists (black, info, white) option was selected, the system
will display Database for watchlists windows (see figure 8), otherwise go to step 11.

Figure 8. Database for watchlists Window

www.issivs.com
 SecurOS Cargo 20 User Guide
Deploying Module

Define database parameters. Set new database name and account for a new PostgreSQL database. If the
Module has been previously installed on this computer in Recognition server installation
mode and you wish to keep the existing data from this database, then specify the existing database
name and account. Click the Next button to continue.
9. If the same database defined in step 8 has been found, the system will display the Database exists
window (see figure 9), otherwise installation will automatically proceed to step 10.

Figure 9. Database exists Window

Select one of the following options:

· Use database 'ext_cargo' — use old PostgreSQL database from the previous Module
installation on this computer. The previous Module version must correspond to the current one to
guarantee correct database functionality;
· Reinitialize (clean) database 'ext_cargo' — database will be reinitialized: all
information in it would be deleted.
Click the Next button to continue.
10.If PostgreSQL DBMS has already been installed on this computer, but the database with the specified
parameters was not found, the setup wizard will display the Database creation window
(see figure 10).

www.issivs.com
 SecurOS Cargo 21 User Guide
Deploying Module

Figure 10. Database creation Window

In the Database creation window specify the PostgreSQL superuser credentials (user name and
password) necessary for creating Module database. Click the Next button to continue.
11.System will display Ready to Install window (see figure 11).

Figure 11. Ready to Install Window

Review your installation preferences. Click the Back button to make any necessary changes, or the
Install button to start the installation. System will extract required archives and start installation;
installation progress bar will be displayed during this process.

www.issivs.com
 SecurOS Cargo 22 User Guide
Deploying Module

12.If the installation has finished successfully, the system will display the Completing the SecurOS
Cargo Setup Wizard window (see figure 12).

Figure 12. Completing the SecurOS Cargo Setup Wizard

Click the Finish button to exit the installation program.

13.Start the Video Management System Server service with the Server Control Agent utility (see
SecurOS Administration Guide). Its icon can be found in the system tray.

Notes:
1. The Video Management System Server can also be started with the Windows tools:
Computer → Manage → Services and Applications → Services.
2. The Setup Wizard can ask you to restart the computer. If a restart is not done immediately, you
must restart the computer before the first launch of SecurOS.

3.3 Updating Module Database Structure

The local database of the Module created by one of its previous versions is updated automatically when
a new version is installed. Because some data fields of older records will remain empty, all user
operations (especially search queries) described in this manual will not be fully applicable to old
recognition results.

www.issivs.com
 SecurOS Cargo 23 User Guide
Module Administration

4 Module Administration
This section describes the SecurOS Cargo Module objects and their settings.

4.1 Objects Reference

Warning! Open the TCP port of the Database object in the firewall settings for proper module operation.

For convenience, it is recommended to configure objects in the following order:

· Database.
· Cargo: Group of modules.
· Cargo: Side number recognizer.
· Cargo: Top number recognizer.
· Cargo: Consolidator.
· Cargo: Logic module.
· Cargo: GUI.

4.1.1 Database

This object defines the database used to store the recognized container numbers. It also allows to set the
retention period for the database records.

To create and configure the Database object do the following:

1. Enter administration mode.
2. Select the Security Zone object in the SecurOS Object Tree, then create a Database child object. Set
required values in the Parameters of created object window.

Note. Several Database objects within the same parent object are combined into the Databases logic group in the
Object Tree.

3. Set the following parameters in the Database object’s settings window (see Figure 13):

www.issivs.com
 SecurOS Cargo 24 User Guide
Module Administration

Figure 13. Database Object Settings Window

Table 1. Database Object Settings

Parameter Description

Database

Type Select the database type from the list. Default value is PostgreSQL.

DNS-name or IP-address of SecurOS Cargo PostgreSQL database

server.

Note. Use of DNS name is preferred to avoid possible issues in a local

Host network with DHCP server and dynamic IP addresses.

If the database is installed on the local computer which is used to

configure the system, use default value.

Port Port number for database connection. Default value is 5432.

Database name, user name and password are as defined during the
Database name, User,
SecurOS Cargo Module software installation (see Installing
Password
Software).

To check the database connection with the defined parameters click

the Test connection button. If the parameters are set correctly and
Test connection
there is a connection to the LAN, then OK will be displayed to the
left of the button.

Options

Retention period for records (in days). If set to 0, the records are not
Erase records older than deleted.

www.issivs.com
 SecurOS Cargo 25 User Guide
Module Administration

Parameter Description

Note. Cleanup is performed every 12 hours since new settings of the

Cargo: Logic module are applied (when SecurOS Cargo is working
permanently without restarting), or in 12 hours after it was started,
otherwise.

Warning! One should not manually edit tables of the Module database, otherwise the Module might not work
properly.

4.1.2 Cargo: Group of modules

To create the Cargo: Group of modules object do the following:

1. Enter administration mode.
2. Select the Computer object in the SecurOS Object Tree, then create a Cargo: Group of modules child
object. Set the required values in the Parameters of created object window.

Note. This object has no settings to configure and is used to group other Module's objects.

4.1.3 Cargo: Side number recognizer

According to the ISO standard, container code markings (“numbers”) appearing on container sidewalls
can vary widely in their layout (orientation and the number of lines). The variants recognized by the
Module are shown in figure 14, while those less frequent varieties that the Module currently fails to
read are displayed in figure 15.

Figure 14. Examples of container side numbers recognized by the Module: (a) single-line vertical number,(b) single-line horizontal
number, (c) double-line horizontal number and (d) double-line vertical number

www.issivs.com
 SecurOS Cargo 26 User Guide
Module Administration

Figure 15. Examples of container side numbers currently not recognized by the Module: (a) triple-line number and (b) double-line
vertical number with the owner code to the right of the serial number line

The object settings window contains the following tabs:

· Video source tab.
· Recognition tab.
· IMDG classes tab.

To create and configure the Cargo: Side number recognizer object do the following:
1. Enter administration mode.
2. Select the Cargo: Group of modules object in the SecurOS Object Tree, then create a Cargo: Side number
recognizer child object. Set the required values in the Parameters of created object window.
3. Use the appropriate tabs of the object settings window (see below) to set the parameter values.

www.issivs.com
 SecurOS Cargo 27 User Guide
Module Administration

4.1.3.1 Video source Tab

Set the following parameters in the Video source tab (see figure 16):

Figure 16. Video source tab of Cargo: Side number recognizer Object Settings
Window

www.issivs.com
 SecurOS Cargo 28 User Guide
Module Administration

Table 2. Cargo: Side number recognizer object settings. Video source Tab

Parameter Description

Select a camera that will be monitoring the container numbers.

Note. Specify the following parameters of the appropriate Camera object

to get a good image quality:
· Duration of pre-recording — recommended value is 3 seconds;
· Resolution — select resolution of the camera. For reliable
recognition at least 1.5 and preferably, 2–3 pixels per character
Analyze video from camera stroke are required in the captured image (see Installing Video
Cameras for more information on this topic). With correctly set
resolution, characters in container numbers will be at least 15 to 20
pixels high. If the signal comes with the interlaced scanning
(typically for analog cameras) it is necessary to select the High
(CIF2) value or, at least the Normal (CIF1) value. For the camera
with the progressive scanning (usually it is IP-cameras) select the
Complete (CIF4) value.

To preview video provided by selected Camera, click the

Preview (button) (Preview) button that is placed to the right of the available Camera
list. An image will be displayed in styled camera cell. To hide styled
camera cell click the Preview button again.

Enhancing recognition by Select this checkbox to enable image warping procedure. If not
image warping selected, recognition procedure will use initial captured image.

Run warping utility Click this button to run camera calibration utility to correct
(button) distortion (see Appendox A. Camera Calibration Utility).

Load settings from file Click this button to load camera calibration settings from an XML
(button) file.

Enable the Camera objects that corresponds to additional system

cameras, which video will be recorded with source camera video
stream that set in the Analyze video from camera parameter (see
above).

If jumping to archive video on Media Client from operator interface

Record video from cameras is configured by administrator (see Display Tab, the Media Client
parameter), then all Cameras specified in this block and the Camera
selected in the Analyze video from camera block (see above) will be
displayed on Media Client in archive mode when clicking on the
protocol record. Archives will be synchronized, archive position
pointer will be set at record time position.

Select recording mode for camera (for all cameras selected in the
Analyze video from camera and Record video from cameras
blocks). Possible values:

Recording mode · Don't record — video will not be recorded;

www.issivs.com
 SecurOS Cargo 29 User Guide
Module Administration

Parameter Description

· Make snapshots — a single frame will be recorded (one

container — one frame). Snapshot is made automatically by the
camera selected in the Analyze video from camera block when
moving is detected in the frame. Snapshot at the same time
stamp will be made by each camera selected in the Record video
from cameras;
Warning! Snapshots recorded by some IP cameras will not necessarily
correspond to the same astronomical time to within a hundredth of a
second. This is due to specifics of the video networking and possibilities to
synchronize cameras with standard methods. The degree and rates of time
synchronization failures depend on the camera's manufacturer, the network
data transmission protocol that is used, and the network load.

· Record video — video fragment of container pass will be

recorded. Recording is performed by cameras selected in the
Analyze video from camera and Record video from cameras in
a mode similar to make snapshot.

Note. The Duration of pre-recording setting of the corresponding

Camera objects (chosen from the cameras list, see below) should be set to
about 10 s when Make snapshots is selected and to at least 3 s when
Record container pass is selected.

Specify recognition results destination. Possible values:

· Database — select this option to save results into the database.

Select the Database object to record recognized container
Send results to
numbers (see Database).

· Consolidator — select this option if given Recognizer is a data

source for the Cargo: Consolidator (see Cargo: Consolidator).

www.issivs.com
 SecurOS Cargo 30 User Guide
Module Administration

4.1.3.2 Recognition Tab

Set the following parameters in the Recognition tab (see figure 17):

Figure 17. Video source tab of Cargo: Side number recognizer Object Settings
Window

Table 3. Cargo: Side number recognizer object settings. Recognition Tab

Parameter Description

Recognizer settings

Recognize numbers moving Specify the directions in which containers are expected to move in
up/ left to right, down/ right the streamed video (relative to Recognizer's camera).
to left

www.issivs.com
 SecurOS Cargo 31 User Guide
Module Administration

Parameter Description

Set the typical relative height of container number characters as seen

in the captured video (if elimination of optical distortion is enabled
(see Video source Tab), then the specified height should refer to the
Typical height of number corrected frames (see Appendix A. Camera Calibration Utility)).
digits This height value is expressed as percent of the frame height. For
appropriately mounted and tuned (see Installing Video Cameras)
conventional (not megapixel) TV cameras looking at container
sidewalls, this value will normally be close to 7%.

Horizontal container numbers are most often printed in the right top
corner of the container sidewall. One exception is cisterns in crates,
transported as regular containers. To make cistern numbers easilly
readable, they are normally printed at cistern half-height. The
Bottom edge of the zone processor load and the rate of stray recognitions can be reduced by
where horizontal numbers narrowing the zone where horizontal container numbers are looked
appear for. If cisterns have just a slim chance to appear at the given SecurOS
Cargo terminal, the zone bottom edge can be moved up by
decreasing the corresponding parameter value. The full frame
corresponds to 100%. This setting is accessible only for the Cargo:
Side number recognizer.

Select this checkbox to read unconventional topside numbers (i.e.,

Examine all orientations
aligned like if they were printed on container sidewalls).

Use the slider to set the sensitivity of the recognition algorithm.

Only two options, Normal and High, are currently available. The
latter is likely to produce better results in more difficult
circumstances (e.g., low-contrast images, large view angles, etc.) at
Recognition algorithm the cost of employing more computing and, thereby, increasing the
sensitivity processor load by roughly 30%.

The High level is recommended when the priority is to reduce the

percent of completely missed containers (with unrecognized
container numbers). If the priority is to reduce the number of false
or erroneous recognition results, the Normal level is recommended.

Do not output recognition result if

Select this checkbox to filter out recognition results with a low

quality rating. This settings is used to filter out false-positive
recognitions. The working value should be determined by
Recognition quality is lower experiment.
than
Note. The actual recognition quality is displayed in the details window
(see Working in Details Window section).

Container image

www.issivs.com
 SecurOS Cargo 32 User Guide
Module Administration

Parameter Description

Saving images to the database according to the following settings.

Note. Checkbox is enabled in the following cases:
1. If the same Camera is selected both to analyze image and
Store to database record video (see Video source Tab).
2. Save to database option is selected in the Send results to
block, and appropriate Database is selected in the list
(see Video source Tab).
Select an Image Processor object to be responsible for image saving.

Image exporter Note. If there are no Image Processor objects in the SecurOS Object Tree
the list will be empty.

Select the type of the stored frame. Possible values:

Image type · Only container ID — frame contains container ID alone;

· Whole frame — full size of the captured image.

Select file format. Possible values:

Image format · JPEG;

· PNG.

Use slider to specify image quality. The higher the quality, the larger
Image quality
the file size.

Select this checkbox to enable container number recognition tracing

and logging at the lowest possible level. This file is saved into the
ISS/Logs/Modules/Cargo/ folder, path to which is defined by
the %ProgramData% environment variable. Unique file names have
the ring_ prefix and are changed each time when module starts.
Write debug information
The logging records are arranged in a loop, overwriting the old ones
when the file capacity is exhausted. The effective settings for each
Recognizer are also saved in the same folder. These files can help the
ISS Technical Support Team analyze the correctness of the Module
setup and operation if recognition fails to run as expected.

4.1.3.3 IMDG classes Tab

The tab is intended for configuring the functionality of determining IMDG codes (International
Maritime Code for the Transport of Dangerous Goods) on the walls of containers. Set the following
parameters in the IMDG classes tab (see Figure 18):

www.issivs.com
 SecurOS Cargo 33 User Guide
Module Administration

Figure 18. IMDG classes tab of Cargo: Side number recognizer Object Settings
Window

Table 4. Cargo: Side number recognizer object settings. IMDG classes Tab

Parameter Description

Select the flag to identify the dangerous contents of containers

Classify dangerous goods
bearing the IMDG code plate. By default is not selected.

Select a device from the list that will be used to process images of
containers when determining the presence of a plate with the IMDG
Use device code on them using neural network algorithms.
Warning! Only Intel CPUs are supported.

www.issivs.com
 SecurOS Cargo 34 User Guide
Module Administration

4.1.4 Cargo: Top number recognizer

This object is designed specifically to read code markings on container topsides. Therefore, the selection
of cameras for this object should be limited to those positioned to look down at containers travelling
straight under the camera. The Module recognizes conventional top numbers in the two inverse
orientations (see Figure 19) and whenever possible tries to produce a single merged result.

Figure 19. Examples of container top numbers that can be recognized by the Module

However, contrary to the ISO standard, some containers may have their topside marked in a style
designated specifically for sidewalls (see Cargo: Side number recognizer). By default such
unconventional top numbers are not recognized. To enable recognition of such numbers select the
Examine all orientations checkbox in the Recognizer object settings window (see Cargo: Side number
recognizer), but it doubles CPU load. Topside unconventional markings, if any, normally appear in
twosomes having inverse orientations and located near opposite topside edges. When enabled, an
attempt is made to read both numbers and, if possible, a single merged result is produced, provided the
two numbers share the same contrast (black-on-white or white-on-black).

Object settings window is almost identical to Cargo: Side number recognizer (see description in Cargo:
Side number recognizer section). There is additional Recognize in masked area only parameter on
Video source tab. Enable this field to make the system search and recognize container numbers only in
masked area of the video stream. Select the checkbox and then select required masked area from the list.
Zone mask can be changed on the fly in the SecurOS mask editor.

To create and configure the Cargo: Top number recognizer object do the following:
1. Enter administration mode.
2. Select the Cargo: Group of modules object in the SecurOS Object Tree, then create a Cargo: Top number
recognizer child object. Set the required values in the Parameters of created object window.
3. In the object settings window set the parameters in the respective tabs (see Cargo: Side number
recognizer).

4.1.5 Cargo: Consolidator

The object is used for receiving and consolidating recognition results from several SecurOS Cargo
modules, working with video streams from side view and top view cameras, installed at control point.
Each control point requires its own Cargo: Consolidator object.

Cargo: Consolidator has access to all source data originating from the Recognizers, that allows it to take
into account the relative quality of recognition for each character and its position in the container ID on
all container sides. For this reason, using the Cargo: Consolidator object has an advantage over other
merging methods, for which only final recognition results are available.

Note. Cargo: Consolidator works correctly in situations where up to three containers are shipped by one trailer.

To create and configure the Cargo: Consolidator object do the following:

www.issivs.com
 SecurOS Cargo 35 User Guide
Module Administration

1. Enter administration mode.

2. Select the Cargo: Group of modules object in the SecurOS Object Tree, then create a Cargo: Consolidator
child object. Set the required values in the Parameters of created object window.
3. In the Cargo: Consolidator object settings window (see Figure 20) specify parameters according to
recommendations (see SecurOS Cargo Quick Setup Guide to Work with Cargo: Consolidator).

Figure 20. Cargo: Consolidator object settings window

Table 5. Cargo: Consolidator settings

Parameter Description

Select Cargo: Side number recognizer and Cargo: Top number recognizer
object, used as data sources for consolidation. Only Recognizers, with
Consolidator specified as the recognition results destination can be
selected.
Recognition sources
Activate the Opposite checkbox for Recognizers associated with
Cameras, recording video with containers moving in direction,
opposite to the main camera (see section SecurOS Cargo Quick
Setup Guide to Work with Consolidator for details).

Specify time interval (in seconds) to output consolidation result after

first container recognition. This interval should slightly exceed the
Timeout, sec
time, in which a slowly moving container passes all Cameras,
associated with Recognizers — sources of data for Consolidator.

www.issivs.com
 SecurOS Cargo 36 User Guide
Module Administration

Parameter Description

Activate the field and specify the number recognition quality

Discard output if quality is
threshold. The numbers with recognition quality lower than the
under
specified threshold will be ignored.

Database settings Select the Database object to record recognized container numbers.

Set the corresponding direction names.

From right to left, From left Note. The From right to left field value is used to name top to bottom
to right movement direction. The From left to right field value is used to name
bottom to top movement direction.

4.1.5.1 SecurOS Cargo Quick Setup Guide to Work with Consolidator

Step 1. Configuring Recognizers

For all Recognizers, installed on the control point, select Consolidator in the Send results to field
(see Video source Tab).

Step 2. Cargo: Consolidator Object Creation and Configuration

Create and configure the Cargo: Consolidator object in the SecurOS object tree. Recognition sources list
displays all available Recognizers. Select Recognizers from which the Consolidator will be receiving
recognition results.

To ignore low quality consolidation results select Discard output if quality is under checkbox and
specify quality threshold (in relative units).

Note. When merging two or three recognition results, final recognition quality will be approximately equal to
the total quality of all involved results. In most cases consolidation quality threshold should be set up to 1,5 —
2 times greater than recognition quality threshold.

Select Database to save consolidation results.

Specify container movement direction. Each Recognizer has its own reference system. If container is
moving from left to right on the video from camera installed on one side of the container, then the same
container will be moving from right to left on video from camera installed on the other side of the
container. Choose one "main" camera and deselect the Opposite checkboxes for all Recognizers, for
which containers moving direction is the same as for the "main" camera. For other Recognizers the
Opposite parameter must be selected. Assign meaningful names the "from left to right" and "from right
to left" directions on the video from main camera. If the main camera is associated with a Cargo: Top
number recognizer object, the "left to right" direction name is applied to the movement from bottom to
top, the "right to left" direction name is applied to movement from top to bottom.

Example. If "from left to right" direction corresponds to containers arriving to the port it can be called
"Incoming" and the opposite direction as "Outgoing".

These names will be saved into the database even in case when nothing was recognized on the video
from main camera.

www.issivs.com
 SecurOS Cargo 37 User Guide
Module Administration

Specify waiting time — time interval to output consolidation result after first container recognition. This
interval should slightly exceed the time, in which a slowly moving container passes all Cameras,
associated with Recognizers, that are a sources of data for Consolidator. Exact value of this parameter is
defined experimentally.

It is possible to obtain the Consolidator results based on currently saved data. To do this, send a message
to SecurOS with the following command:

DoReact("CARGO_CONS","1","CONSOLIDATE");

Where CARGO_CONS is the SecurOS Cargo: Consolidator object type, "1" is the Cargo: Consolidator object
ID, and CONSOLIDATE is the command to execute. For the details on controlling SecurOS objects see
SecurOS Programming Guide.

Step 3. Cargo: Logic module Object Creation and Configuration

Create and configure the Cargo: Logic module object in the SecurOS object tree. All Consolidators and
Recognizers, created in the SecurOS object tree, will be displayed in the Recognizers tab.

A Cargo: Logic module object can work with all Consolidators and Recognizers that use the same database.
Select required Consolidator objects in the list.

Step 4. Cargo: GUI Object Creation and Configuration

Create and configure the Cargo: GUI object in the SecurOS object tree. In the Additional tab select the
Cargo: Logic module object, which results will be displayed in the Protocol window (see section Cargo:
GUI).

4.1.6 Cargo: Logic module

This object defines the set of Recognizers to process container numbers from. Also there will be an option
to connect to databases from this object.

The object settings window contains the following tabs:

· Recognizers tab;
· Watchlists tab;

To create and configure the Cargo: Logic module object do the following:
1. Enter administration mode.
2. Select the Cargo: Group of modules object in the SecurOS Object Tree, then create a Cargo: Logic module
child object. Set the required values in the Parameters of created object window.
3. Use the appropriate tabs of the object settings window (see below) to set the parameter values.

www.issivs.com
 SecurOS Cargo 38 User Guide
Module Administration

4.1.6.1 Recognizers Tab

Set the following parameters in the Recognizers tab (see figure 21):

Figure 21. Recognizers Tab of Cargo: Logic module Object Settings Window

Table 6. Cargo: Logic module settings. Recognizers Tab

Parameter Description

Select checkboxes next to the Recognizer or Cargo: Consolidator object

Recognizers to process
that provides container IDs to analyze if they belong to the SecurOS
container IDs from
Cargo's database or watchlist.

4.1.6.2 Watchlists Tab

The watchlists tab (see figure 22) is intended to connect third-party databases to the system. In contrast
to the SecurOS Cargo database, that stores information, contained in the Recognizers messages
(see Appendix B. Module Events and Commands Reference), third-party database contains additional
information on the container ID, for example, is a container in the black/white list, etc.

External database can be represented by a set of objects, for example, MS Access file, PostgreSQL DBMS
or Oracle RDBMS table, etc. Both the appropriate native application or SecurOS Cargo can be used to
work with these databases. To edit databases in real-time mode with the help of the SecurOS Cargo the
Watchlists tab (see Working with Watchlists Tab section) is used.

Besides that third-party databases can be used, SecurOS Cargo provides accessing to the internal
template-created lists (databases). Each of these databases represents itself the PostgreSQL DBMS table,
that contains container numbers, that belong to the black, white or informational list.

If the Templates of the special lists (black, info, white) option was selected at the
Module software installation, see Installing Software then databases list will contain 3 databases:
Blacklist, Information and Whitelist. Otherwise the databases list will be empty.

www.issivs.com
 SecurOS Cargo 39 User Guide
Module Administration

Note. Each of the default installed database represents separate table of the single physical database:
ext_cargo: black, info and white, accordingly.

The default created databases can be connected either through Database SecurOS's object, or directly,
with no object creation. At the first case, login and password connection parameters are specified when
creating the Database object and are detected automatically when creating the connection string in the
Database connection window with the help of the Import button. Otherwise these connection
parameters must be specified in the connection string manually.

Figure 22. Watchlists Tab of Cargo: Logic module Object Settings Window

Table 7. Cargo: Logic module settings. Watchlists Tab

Parameter Description

Watchlists to clear To add watchlist connections to the list, use the buttons below.
recognized container IDs

Click this button to create a new database connection parameter set on

the base of the last one, that is specified for the database, selected in the
Clone
current list (see parameter description above). System will display
Watchlists window (see figure 23 and table 8).

Click this button to add a watchlist to the list. System will display
Add
Watchlist properties window (see figure 24 and table 9).

www.issivs.com
 SecurOS Cargo 40 User Guide
Module Administration

Parameter Description

Click this button to remove a selected watchlist from the list. This
Remove
button is active for a selected watchlist.

Click this button to open the watchlist properties window for changing
Properties the watchlist parameters (see figure 24). This button is active for a
selected watchlist.

Watchlists Changes History

Click this button to open the Watchlists changes history window (see
figure 23). This window displays all Watchlist databases that can be
modified to provide changes history. When modifying current
database tables structure is updated and a new history table for
Log and view the
Watchlists changes storing changes is created for each database.
history. Configure To modify Watchlists databases to provide changes history select
required tables in the Tree and click on the Log changes history for the
selected Watchlists button. If operation is successful, system will
display corresponding message.

Figure 23. Watchlists changes history window. Watchlists DB update results

Figure 24. Watchlists Window

www.issivs.com
 SecurOS Cargo 41 User Guide
Module Administration

Table 8. Watchlist name (when cloning)

Parameter Description

Name Specify the new watchlist's name.

Figure 25. Watchlist properties window. Connection Tab

Table 9. Watchlist properties. Connection Tab

Parameter Description

Specify watchlist name.

Name
Warning! When editing the watchlist parameters this box is disabled.

Select the watchlist type from the list. Possible values:

Blacklist — for blacklist container numbers;

Type
Information — for information list container numbers;

Whitelist — for white list container numbers.

www.issivs.com
 SecurOS Cargo 42 User Guide
Module Administration

Parameter Description

Click this button to check connection to an external database and

Test
query. The query is carried out.

Save/discard changes.

OK (Cancel) Note. When creating a new database, the OK button is disabled until
connection string is created and query parameters bindings are
established.

Connection Tab

Specify a string to use for the connection to the external database

Connection string
manually or click the Build connection string button (see below).

Click this button to generate the instruction to connect to database

Build connection string automatically. System will display database connection settings
window (see figure 28 and table 12).

Figure 26. Watchlist properties window. Query Tab

www.issivs.com
 SecurOS Cargo 43 User Guide
Module Administration

Table 10. Watchlist properties. Query Tab

Parameter Description

Edit watchlist

Tick this checkbox to view and edit Watchlists databases with the help of Cargo: GUI object.

Check the box and select a database, that will be used to edit a
container number list.
Table name Note. When using external databases, there is a probability of the
required table will not be detected by SecurOS Cargo and displayed in
the drop-down list. At this case type table name manually.

Click the button to create a new database on the base of the last one,
selected in the Source table field. Thus only the structure of the
table, but not its content, is cloned.
Clone Warning! Cloning is only applicable to the ext_cargo PostgreSQL
database of the SecurOS Cargo, its black, info and white tables and
any objects, created on the base on the last ones. When using third-party
databases operation can be failed.

If external database is used specify name of the column, where

Reassign the number container number is stored. Use this specified name in SQL-query
column (see below). By default the number name of the own Module
Watchlist is used.

Specify an PL/SQL-query to get any information associated with the

container number from the external database.
Warning! When forming the database query, one should remember that
container numbers are normally stored in the database in upper case. If any
database entries do not comply with such condition, use the UPPER
Query function to select all container numbers, that match the query. However,
such search will lead to full database scanning, that significantly increase
database server loading and query execution time.

Note. On editing the query line, the Test button becomes inactive (see
above).

Fill in the table, correlating the query parameters (designated as '?'

symbol) with those obtained from the Recognizer data. A position
number in the table defines the query parameter. The Name row
Parameter bindings
points to a category of accepted data corresponding to the given
parameter, and the Value row — an example of a parameter value
which will be used at the query correctness test.

Click this button to set interrelation between parameters of query

and accepted data. By clicking this button a check of the connection
to the external database and correctness of the query is performed.
Bind parameters
Note. After the given procedure is performed, the Test button becomes
active (see below).

www.issivs.com
 SecurOS Cargo 44 User Guide
Module Administration

Parameter Description

Click on the button to check whether Module will work with

selected Watchlist. During the test, a series of tests are performed,
Test
after which an information message is displayed. Watchlist is
considered to be workable if each test is finished successfully.

Figure 27. External database settings, Miscellaneous Tab

Table 11. Watchlist properties. Miscellaneous Tab

Parameter Description

Select this checkbox to generate event if container number was

found in watchlist.

Note. If recognized container number is found in watchlist, string in

Report on registration protocol window will contain comment from this watchlist, which will
number found in watchlist be marked with corresponding color. If there is no comment to
recognized number, the Container number was found
comment marked with corresponding color will be displayed in protocol
window (see Additional Tab).

www.issivs.com
 SecurOS Cargo 45 User Guide
Module Administration

Parameter Description

Select this checkbox to generate event if container number was not

found in watchlist.
Report on registration
number not found in Note. If recognized container number is not found in the watchlist, the
watchlist Container number was not found comment marked with
corresponding color will be displayed in protocol window
(see Additional Tab).

This parameter has no sense for SecurOS Cargo and is always

Disable localized queries
unavailable.

Figure 28. Database connection settings

www.issivs.com
 SecurOS Cargo 46 User Guide
Module Administration

Table 12. External database connection settings

Parameter Description

Select this option to use an ODBC data source created in Windows.

Warning! When the Module (32-bit application) is running under a 64-bit
Operating System then the ODBC driver being selected should be 32-bit,
too. To create such type of the ODBC source use the Odbcad32.exe
Use ODBC data source application located in the %systemdrive%\Windows\SysWoW64
folder.

Additional configuration is needed when using Oracle ODBC data

source (see Note after the table).

User, Password Specify user name and password for the data source.

Use direct ODBC driver Select this option to use direct ODBC driver connection (ODBC data
connection source creation is not required).

Driver-specific parameters table (optional)

Click in the corresponding row to type in the variable name (or

value) for the connection to the external database. Table is enabled
Name, Value
when Use direct ODBC driver connection is selected. Fill in the
table with driver-specific parameters.

Remove parameter Click this button to remove selected variable.

Add parameter Click this button to add a new special variable.

Click this button to use connection parameter set, that is used to

connect one of the database, associated with the SecurOS's Database
Import
object. This is used, for example, when cloning databases, created on
the base of the SecurOS Cargo's built-in local lists.

Note. When using Oracle database connection, data might be transmitted with incorrect codepage. For the
drivers to work correctly the driver language should be configured (see the Oracle database server installation
documentation or go to www.oracle.com/technetwork/products/globalization/nls-lang-099431.html
reference), or activate Force SQL_WCHAR Support option in the Workarounds tab of Oracle ODBC data
source configuration window.

Warning! It is recommended to use ODBC driver that supports the Unicode code, otherwise data corruption
during query execution may occur!

4.1.6.2.1 External Database Connection Example

This example is for Microsoft SQL Server 2008 R2 DBMS database connection.

External database will be connected to the SecurOS Cargo using ODBC data source.

To create an ODBC data source do the following:

1. Launch the ODBC Data Source Administrator Windows' application: Control panel ® System and
® ®
Security Administrative Tools Data Sources (ODBC).

www.issivs.com
 SecurOS Cargo 47 User Guide
Module Administration

Note. To provide correct operation in the 64-bit Operation Systems launch C:

\Windows\SysWOW64\odbcad32.exe application manually.

2. In the ODBC Data Source Administrator window click the System DSN tab (see figure 29).

Figure 29. ODBC Data Source Administrator Window

Click the Add button.

3. System will display Create New Data Source window (see figure 30).

Figure 30. Create New Data Source Window

In driver list, select the SQL Server driver. Click the Finish button.

www.issivs.com
 SecurOS Cargo 48 User Guide
Module Administration

4. System will display Create a New Data Source for SQL Server window (see figure 31).

Figure 31. Create a New Data Source for SQL Server Window

Specify source Name (is used to identify source in the SecurOS Cargo sources list), optional Description
of the source, and Server, where Microsoft SQL Server 2008 R2 DBMS is deployed.

Note. If DBMS is deployed on the local server, enter localhost or 127.0.0.1 value in the Server text
box.

Click the Next button to continue.

5. System will display the next page of the Create a New Data Source for SQL Server window
(see figure 32).

www.issivs.com
 SecurOS Cargo 49 User Guide
Module Administration

Figure 32. Create a New Data Source for SQL Server Window

Select the With SQL Server authentication using a login ID and password entered
by the user option, check the Connect to SQL Server to obtain default settings for
the additional configuration options box. In the Login ID and Password text boxes enter
the values, that complies with SQL-server instanse's user account to access the database. Click the Next
button to continue.

Note. If the incorrect Login ID and Password values are entered, then system will display appropriate
information message.

6. System will display the next page of the Create a New Data Source for SQL Server window. Accept
default parameters and click the Next button.
7. System will display the last page of the Create a New Data Source for SQL Server window. Accept
default parameters and click the Finish button.
8. System will display ODBC Microsoft SQL Server Setup window (see figure 33).

www.issivs.com
 SecurOS Cargo 50 User Guide
Module Administration

Figure 33. ODBC Microsoft SQL Server Setup Window

To check the server connection click the Test Data Source button.
9. System will display checking result window (see figure 34).

Figure 34. SQL Server ODBC Data Source Test

If checking is completed successfully, click the OK button to finish the ODBC data source creation.
Otherwise, check if the entered parameters are correct and retry connection test.

10.System will display ODBC Data Source Administrator window with created ODBC data source
(see figure 35).

www.issivs.com
 SecurOS Cargo 51 User Guide
Module Administration

Figure 35. ODBC Data Source Administrator Window

To finish ODBC data source creation click the OK button.

To connect created data source to the SecurOS Cargo do the following:

1. In the Cargo: Logic module object settings window click the Watchlists tab (see figure 36).

Figure 36. Watchlists Tab

Click the Add button.
2. System will display Watchlist properties window (see figure 37).

www.issivs.com
 SecurOS Cargo 52 User Guide
Module Administration

Figure 37. Watchlist properties window

In the Name specify a name of the new database, which will be displayed in the Watchlists to clear
recognized container IDs parameter list (see figure 36). Select the watchlist type in the Type list. Click
the Build connection string to continue with configuring.
3. System will display Database connection window (see figure 38).

www.issivs.com
 SecurOS Cargo 53 User Guide
Module Administration

Figure 38. Database connection Window

Select the Use ODBC data source option. Select created source in the source list (in this example —
MS SQL Server). In the User and Password text boxes enter values, specified at source creation
(Microsoft SQL Server access user account values). Click the OK button to continue.
4. In the Watchlist properties click the Query tab (see figure 39).

www.issivs.com
 SecurOS Cargo 54 User Guide
Module Administration

Figure 39. Query Tab

The query, specified in this tab, will be used by SecurOS Cargo as a template query to return data,
relevant to recognized container number. These returned data will be displayed in the Watchlists tab
(see Working with Watchlists Tab section).

Set the following parameters:

· Edit watchlist — tick checkbox, then select from list (or type manually) the name of the table, that
will be displayed in the operator interface and that can be edited (for the created example data
source this is the BlackList table).
· Query — type SQL-query, which will be used to retrieve data. For the created data source it will
be as follows:

SELECT Comment FROM ContNumbers.dbo.BlackList WHERE Number = ?, where:

· Comment — table field, that contains data to retrieve.

· ContNumbers.dbo.BlackList — table of the database instance, specified in Microsoft
SQL Server format.

Warning! Format of the queried table name specified in the query string depends on used DBMS.

· Number — query condition, in example this is the field of the Number column in the
ContNumbers.dbo.BlackList table, that contains container number.

www.issivs.com
 SecurOS Cargo 55 User Guide
Module Administration

· Parameter bindings — this is the table, where correspondence between entities of the database
table and query parameters is established. To establish a correspondence click the Bind
parameters button. In example, the query condition is specified as Number=?, where ? — a value
of the "container number" entity, stored in the table. SecurOS Cargo, as a rule, uses data sample
relevant to the queried container number, so this entity is used in the Parameter bindings table by
default. Thus, it is established that Plate query parameter corresponds to "container number"
entity.

In the Value field specify container number value in that form, in which it is stored in the database.
Click the Bind parameters button. The Test button will be enabled.
5. Click the Test button. If connection and query parameters are specified correctly, system will display
the following window (see figure 40):

Figure 40. Data source connection test result Window

If it is known in advance that the Comment field, relevant to the correctly specified container number,
contains data, these data will be displayed in the <The result is> string. The <empty string>
query result means, that there is no any additional data in the table (Comment field) relevant to the
specified container number (PONU4970600) or this container number does not exist, but the query itself
executed correctly.
6. To finish configuring the connection click the OK button in the External database properties
window.

As a result of performed steps external database is configured as ODBC data source and connection with
this database is configured and tested. Thus, the external database is completely prepared to be used by
the SecurOS Cargo.

4.1.7 Cargo: GUI

This object defines the operator interface for the Module.

The object settings window contains the following tabs:

· Display tab. Allows to select an operator's monitor to display recognition data and positions of the
Protocol and Details windows (see Working in Protocol WIndow and Working in Details Window
sections).
· Additional tab. Allows to select recognition data source and color marking scheme for the checking
results, if recognized containers IDs belongs to watchlists (see Watchlists Tab section). Color
marking draws operator's attention to "alarmed" checking result in Protocol and Detailed windows.

To create and configure the Cargo: GUI object do the following:

1. Enter administration mode.

www.issivs.com
 SecurOS Cargo 56 User Guide
Module Administration

2. Select the Desktop object in the SecurOS Object Tree, then create a Cargo: GUI child object. Set the
required values in the Parameters of created object window.
3. Use the appropriate tabs of the object settings window (see below) to set the parameter values.

4.1.7.1 Display Tab

Set the following parameters in the Display tab (see Figure 41):

Figure 41. Cargo: GUI object settings window. Display Tab

Table 13. Cargo: GUI object settings. Display Tab

Parameter Description

Settings to display archive

Select a Media Client object from the drop-down list to

Media Client
display video from cameras (Recognizer's cameras).

www.issivs.com
 SecurOS Cargo 57 User Guide
Module Administration

Parameter Description

Recognized container IDs protocol Select this checkbox to enable displaying protocol window
window in operator interface.

Specify top-left position, width, and height (in percentage

X, Y, W, H of desktop size) of the window on the screen.
Recommended values: X — 70, Y — 0, W — 30, H — 100.

Select this field and choose operator's display where

Display protocol window should be displayed (only if several
displays are used).

Specify maximum amount of records that will be displayed

in the Protocol window. General list sets maximum
amount of records in the last recognized container number
Number of protocol records
list, Special container IDs list sets maximum amount of
records in the last "alarmed" container numbers list (see
Working with Results Tab).

Display query status while Select this checkbox if it is necessary to display DB query
searching DB status (see Searching).

Select this checkbox to display recognition date in protocol

Display date
window (see Working with Results Tab).

Contains types of container numbers, that can be output in

the Special container IDs list (see above). Select
Special list includes
appropriate checkbox to output container numbers of
specified types.

Recognized container IDs details Select this checkbox to enable displaying detailed window
window in the operator interface.

Select this field and choose operator's display where

Display protocol window should be displayed (only if several
displays are used).

Specify top-left position, width, and height (in percentage

X, Y, W, H of desktop size) of the window on the screen.
Recommended values: X — 0, Y — 70, W — 70, H — 30.

Specify path to the folder, where images, that are displayed

Frame Export in the details window (see Working in Details Window),
will be saved.

Select this checkbox to allow an operator to edit the

Enable container ID editing
recognized numbers (see Working in Details Window).

www.issivs.com
 SecurOS Cargo 58 User Guide
Module Administration

Parameter Description

Activate this checkbox to display image (container number,

container or whole frame) stored in the database (see
Working in Details Window).
Show container image (if possible)
Note. Type of image stored in the database is specified by the
Type parameter in the Cargo: Side number recognizer object
settings window (see Recognition Tab).

Activate this checkbox to display the recognition quality

Show recognition quality
(see Working in Details Window).

Select this checkbox to group Recognizers by belonging to

Local/Remote system. Recognizers will be grouped in
Enable License plate recognizers
Results tab (see Working with Results Tab) and Search tab
grouping
(see Searching). If not selected (default value), Recognizers
will be displayed in the list in alphabetical order.

Note. Operator interf aces on different Video Servers or Operator Workstations can be configured independently of
each other.

www.issivs.com
 SecurOS Cargo 59 User Guide
Module Administration

4.1.7.2 Additional Tab

Set the following parameters in the Additional tab (see figure 42):

Figure 42. Cargo: GUI object settings window. Additional Tab

Table 14. Cargo: GUI object settings. Additional Tab

Parameter Description

Receive events from the logic Select one or more corresponding Cargo: Logic module object
objects from the dropdown list.

www.issivs.com
 SecurOS Cargo 60 User Guide
Module Administration

Parameter Description

Event color marking table of the container numbers, that

belong to appropriate lists. Each string of the table defines a
watchlist, that contain container number list, and a color,
that is used to mark a strings in the Protocol window, if
Event color marking recognized container number belongs to the specified list.

Note. If watchlist is not added to the event color marking table,

then strings of the relevant container numbers will not be
marked with a color in the Protocol window.

Add/Delete watchlist of the container number and

appropriate color for recognized container number color
marking. To add a list select appropriate string in the list
box below the table, then click color box on the right of the
list box to select a color, then click the Add button. To
Add, Delete (buttons) delete a list select click appropriate string in the table, then
click the Delete button.

Note. Color for the color marking can be specified both when
adding a table entry and when editing it by clicking the Color
value of the appropriate table entry.

Select this checkbox to allow an operator to edit the

Enable watchlist editing
watchlist (see Working with Watchlists Tab).

Tick this checkbox to view Watchlists records changes

Show Watchlists changes history
history (see Typical Operations with Watchlists Records).

4.2 Configuration Examples

This section contains SecurOS Cargo Module object configuration examples for the following system
configurations:
· Standalone Configuration;
· Server-Workstation Configuration;
· Distributed Server-Workstation Configuration.

www.issivs.com
 SecurOS Cargo 61 User Guide
Module Administration

4.2.1 Standalone Configuration

The SecurOS Cargo Object Tree for a standalone configuration is represented in Figure 43.

Figure 43. Object Tree for standalone configuration

To configure SecurOS Cargo in a standalone configuration do the following:

1. Open settings window of the Computer which role is Video Server (see SecurOS Administration
Guide) and specify the following parameter in the Archive tab:
· Directory ® set Read/Write access for video for at least one logical drive (e. g. for C:).
2. Depending on the number and type of video cameras used, create one or several Video Capture Device
objects children to the created Computer (see SecurOS Administration Guide).
3. Create one or several Camera objects children to created Video Capture Device with the following
parameters:
· Channel ® for analog cameras, set the actual number of the labeled BNC connector the first camera
is attached to; for IP cameras this value can be left default (unless IP camera has more than 1 lens or
the camera represents an analog camera connected to an IP encoder);
· Duration of pre-recording ® recommended value is 3 seconds.

www.issivs.com
 SecurOS Cargo 62 User Guide
Module Administration

4. Create a Database object child to Security Zone object (see Database). Define the database for storing
the recognized container numbers and set the retention period if necessary.
Set the following parameter:
· Host ® set the server external IP address (by default the 127.0.0.1 computer internal address is
specified).
· Port ® specify port (by default 5432 port is used).
· Database name ® set SecurOS Cargo database name, specified during Module software
installation.
· User/Password ® set user name and password, specified during Module software installation.

It is necessary to configure the connection to external IP addresses on the specified PostgreSQL

server.

To configure connection to external IP addresses, edit the postgresql.conf and pg_hba.conf

PostgreSQL files: the listen_addresses = ’*’ string must be added in the postgresql.conf
file, and permissions for SecurOS Cargo Operator Workstations or Video Server must be added in the
pg_hba.conf file. For example:

host all all 0.0.0.0/0 md5

Note. To check connection with remote database on Operator Workstation use Test connection button or
pgAdmin utility.

5. Create a Cargo: Group of modules object child to created Computer (see Cargo: Group of modules).
6. Create one or several Cargo: Top number recognizer object(s) (see Cargo: Top number recognizer) or
Cargo: Side number recognizer object(s) (see Cargo: Side number recognizer) children to created Cargo:
Group of modules object, depending on camera view (see below).
Set the following parameters in the Video source tab:
· Analyze video from camera ® define the corresponding Camera object;
· Record video from cameras ® select those Cameras, which will be the sources of video containing
recognized container number images;
· Recording mode ® select Make snapshots or Record container pass if it is necessary to
record a video sequence or a single snapshot of the passing container the number was recognized
from;
· Send results to ® define Database object to save the recognized container numbers, or Cargo:
Consolidator object.
Set the remaining parameters for recording and recognition in accordance with the requirements.
7. Create a Cargo: Logic module object child to created Cargo: Group of modules (see Cargo: Logic
module). Set the following parameters:
· Recognizers to process container IDs from ® add the corresponding Cargo: Top number recognizer
or Cargo: Side number recognizer objects;
· configure Watchlists, if necessary.
8. Create Desktop object child to the created Computer object.
9. Create Media Client object child to the created Desktop. In the Cameras tab choose Cameras, with
which given Media Client will be able to work. For example, it may be ones specified in the Record
video from cameras list in the Recognizer settings. To work with all Cameras use default value.

www.issivs.com
 SecurOS Cargo 63 User Guide
Module Administration

10.Create Cargo: GUI object child to the created Desktop. Set the following parameters in the Display
tab:
· Media Client ® choose Media Client object from the drop-down list to display video used by
Recognizers;
· select corresponding checkboxes to display Recognized license plates protocol window and
Recognized license plates details window and specify window size and position parameters.
· specify other parameters to display recognition data.
In the Additional tab specify the following parameters:
· Process events from the logic objects ® select checkboxes for those Cargo: Logic modules, events of
which must be processed;
· Specify color markers in the Event color marking block;
· If it necessary to edit Watchlists and view changes history, tick corresponding checkboxes.

www.issivs.com
 SecurOS Cargo 64 User Guide
Module Administration

4.2.2 Server-Workstation Configuration

The SecurOS Cargo Object Tree for a server-workstation configuration is illustrated in Figure 44.

Figure 44. Object Tree for a server-workstation configuration

To configure SecurOS Cargo in a server-workstation environment do the following:

1. Open settings window of the Computer which role is Video Server (see SecurOS Administration
Guide) and specify the following parameter in the Archive tab:
· Directory ® set Read/Write access for video for at least one logical drive (e. g. for C:).
2. Depending on the number and type of video cameras used, create one or several Video Capture Device
objects, children to created Computer (see SecurOS Administration Guide).

www.issivs.com
 SecurOS Cargo 65 User Guide
Module Administration

3. Create one or several Camera objects children to created Video Capture Device with the following
parameters:
· Channel ® for analog cameras, set the actual number of the labeled BNC connector the first camera
is attached to; for IP cameras this value can be left default (unless IP camera has more than 1 lens or
the camera represents an analog camera connected to an IP encoder);
· Duration of pre-recording ® recommended value is 3 seconds.
3. Create a Database object child to Security Zone object (see Database). Define the database for storing
the recognized container numbers and set the retention period if necessary.
Set the following parameter:
· Host ® set the server external IP address (by default the 127.0.0.1 computer internal address is
specified).
· Port ® specify port (by default 5432 port is used).
· Database name ® set SecurOS Cargo database name, specified during Module software
installation.
· User/Password ® set user name and password, specified during Module software installation.

It is necessary to configure the connection to external IP addresses on the specified PostgreSQL

server.

To configure connection to external IP addresses, edit the postgresql.conf and pg_hba.conf

PostgreSQL files: the listen_addresses = ’*’ string must be added in the postgresql.conf
file, and permissions for SecurOS Cargo Operator Workstations or Video Server must be added in the
pg_hba.conf file. For example:

host all all 0.0.0.0/0 md5

Note. To check connection with remote database on Operator Workstation use Test connection button or
pgAdmin utility.

4. Create a Cargo: Group of modules object child to created Computer (see Cargo: Group of modules).
5. Create one or several Cargo: Top number recognizer object(s) (see Cargo: Top number recognizer) or
Cargo: Side number recognizer object(s) (see Cargo: Side number recognizer) children to created Cargo:
Group of modules object, depending on camera view (see below).
Set the following parameters in the Video source tab:
· Analyze video from camera ® define the corresponding Camera object;
· Record video from cameras ® select those Cameras, which will be the sources of video containing
recognized container number images;
· Recording mode ® select Make snapshots or Record container pass if it is necessary to
record a video sequence or a single snapshot of the passing container the number was recognized
from;
· Send results to ® define Database object to save the recognized container numbers, or Cargo:
Consolidator object.
Set the remaining parameters for recording and recognition in accordance with the requirements.
6. Create a Cargo: Logic module object child to created Cargo: Group of modules (see Cargo: Logic
module). Set the following parameters:
· One or more recognizers ® add Cargo: Top number recognizer or Cargo: Side number recognizer;

www.issivs.com
 SecurOS Cargo 66 User Guide
Module Administration

· configure Watchlists, if necessary.

7. Create a Computer object with ID equal to the NetBIOS name of the computer to be used as an
Operator Workstation, and set the following parameters:
· Network address ® IP address or DNS/WINS name of the computer within the local TCP/IP
network.
· Servers to connect ® add server where Recognizer objects are created and configured (for detailed
description see SecurOS Administration Guide).
8. Create Desktop object child to the created Computer object.
9. Create Media Client object child to the created Desktop. In the Cameras tab choose Cameras, with
which given Media Client will be able to work. For example, it may be ones specified in the Record
video from cameras list in the Recognizer settings. To work with all Cameras use default value. Set the
following Media Client Window position parameters.
10.Create Cargo: GUI object child to the created Desktop. Set the following parameters:
· Media Client ® choose Media Client object from the drop-down list to display video used by
Recognizers;
· select corresponding checkboxes to display Recognized license plates protocol window and
Recognized license plates details window and specify window size and position parameters.
· specify other parameters to display recognition data.
In the Additional tab specify the following parameters:
· Process events from the logic objects ® select checkboxes for those Cargo: Logic modules, events of
which must be processed;
· Specify color markers in the Event color marking block;
· If it necessary to edit Watchlists and view changes history, tick corresponding checkboxes.
11.Launch the SecurOS client on the Operator Workstation and specify the video server IP address (or
DNS/WINS name) when prompted.

4.2.3 Distributed Server-Workstation Configuration

In a distributed client-server configuration, within SecurOS network, there may be several Video Servers
on which recognition is performed, and several Operator Workstations intended for working with
recognition results. For example, Recognizers are located on one or several Video Servers, Cargo: Logic
module is located on the other Video Server, and monitoring and work with recognized container
numbers is performed on Operator Workstations.

To configure SecurOS Cargo in a distributed server-workstation configuration do the following:

1. Make sure the SecurOS network is configured for WINS name resolution or there is a non-empty
hosts file in the folder \System32\drivers\etc on the operator workstations connected to the
security network.

Note. To check name resolution, run the ping command on the operator workstations and put the computer
network name of the Video Server (doing the license plate recognition) as a command parameter. The
command should indicate a connection (network traffic) between these computers.

2. Open settings window of the Computer which role is Video Server (see SecurOS Administration
Guide) and specify the following parameter in the Archive tab:
· Directory ® set Read/Write access for video for at least one logical drive (e. g. for C:).

www.issivs.com
 SecurOS Cargo 67 User Guide
Module Administration

3. Create a Video Capture Device object child to the created Computer (see SecurOS Administration
Guide).
4. Create Camera objects children to created Video Capture Device with the following parameters:
· Channel ® for analog cameras, set the actual number of the labeled BNC connector the first camera
is attached to; for IP cameras this value can be left default (unless IP camera has more than 1 lens or
the camera represents an analog camera connected to an IP encoder);
· Duration of pre-recording ® recommended value is 3 seconds.
5. Create a Database object child to Security Zone object (see Database). Define the database for storing
the recognized container numbers and set the retention period if necessary. Set the following
parameter:
· Host ® set the server external IP address (by default the 127.0.0.1 computer internal address is
specified).

It is necessary to configure the connection to external IP addresses on the specified PostgreSQL

server.

To configure connection to external IP addresses, edit the postgresql.conf and pg_hba.conf

PostgreSQL files: the listen_addresses = ’*’ string must be added in the postgresql.conf
file, and permissions for SecurOS Cargo Operator Workstations or Video Server must be added in the
pg_hba.conf file. For example:

host all all 0.0.0.0/0 md5

Note. To check connection with remote database on Operator Workstation use Test connection button or
pgAdmin utility.

6. Select the Computer object of the recognition server computer. Create a Cargo: Group of modules
object (see Cargo: Group of modules).

Note. Recognition server configuration procedure is the same for all recognition servers.

7. Create one or several Cargo: Top number recognizer object(s) (see Cargo: Top number recognizer) or
Cargo: Side number recognizer object(s) (see Cargo: Side number recognizer) children to created Cargo:
Group of modules object, depending on camera view (see below).
Set the following parameters in the Video source tab:
· Analyze video from camera ® define the corresponding Camera object;
· Record video from cameras ® select those Cameras, which will be the sources of video containing
recognized container number images;
· Recording mode ® select Make snapshots or Record container pass if it is necessary to
record a video sequence or a single snapshot of the passing container the number was recognized
from;
· Send results to ® define Database object to save the recognized container numbers, or Cargo:
Consolidator object.
Set the remaining parameters for recording and recognition in accordance with the requirements.
8. Select the Computer object of the data processing and analyzing server and create a Cargo: Group of
modules object (see Cargo: Group of modules).

www.issivs.com
 SecurOS Cargo 68 User Guide
Module Administration

9. Create a Cargo: Logic module object child to created Cargo: Group of modules (see Cargo: Logic
module). Set the following parameters:
· One or more recognizers ® add Cargo: Top number recognizer or Cargo: Side number recognizer;
· configure Watchlists, if necessary.
10.Create a Computer object with ID equal to the NetBIOS name of the computer to be used as the
operator workstation, and set the following parameter:
· Network address ® IP address or DNS/WINS name of the computer within the local TCP/IP
network.
11.Create Desktop object child to the created Computer object.
12.Create Media Client object child to the created Desktop. In the Cameras tab choose Cameras, with
which given Media Client will be able to work. For example, it may be ones specified in the Record
video from cameras list in the Recognizer settings. To work with all Cameras use default value. Set the
following Media Client Window position parameters.
13.Create Cargo: GUI object child to the created Desktop. Set the following parameters:
· Media Client ® choose Media Client object from the drop-down list to display video used by
Recognizers;
· select corresponding checkboxes to display Recognized license plates protocol window and
Recognized license plates details window and specify window size and position parameters.
· specify other parameters to display recognition data.
In the Additional tab specify the following parameters:
· Process events from the logic objects ® select checkboxes for those Cargo: Logic modules, events of
which must be processed;
· Specify color markers in the Event color marking block;
· If it necessary to edit Watchlists and view changes history, tick corresponding checkboxes.
14.Launch the SecurOS client on the Operator Workstation and specify the video server IP address (or
DNS/WINS name) when prompted.

www.issivs.com
 SecurOS Cargo 69 User Guide
Working with Module

5 Working with Module

A typical operator interface is represented in figure 45.

Figure 45. Operator interface

Operator interface consists of the following elements:

· Protocol window, see Working in Protocol Window;
· Details window, see Working in Details Window;
· Media Client, see Working with Media Client.

Operator can do the following:

· monitor the recognition of container numbers, see Working with Results Tab;
· examine and edit the recognized container number and supply a comment to accompany this
number in the protocol panel, see Working in Details Window;
· examine shots and/or video from the Recognizer's camera as well as from additional cameras, see
Working with Media Client;
· search through container numbers log and archive, see Working with Search Tab;

www.issivs.com
 SecurOS Cargo 70 User Guide
Working with Module

· work with Watchlists (white, black, information), see Working with Watchlists Tab;
· print report associated with current recognized container number, see Working in Details
Window;
· save image of the container with recognized number into the file, see Working in Details Window.

5.1 Working in Protocol Window

Protocol window is shown in Figure 46.

Figure 46. Active and Inactive Tabs of the Protocol Window

Protocol window (see the figure above) is used for the following:
· monitoring recognized container numbers (Results tab, see Working with Results Tab);
· searching container by its number (comment) and/or by date (Search tab, see Working with Search
Tab);
· searching container with dangerous goods by its IMDG class (Search tab, see Working with Search
Tab);
· working with list records: add, edit, delete (Watchlists tab, see Working with Watchlists Tab).

To switch between tabs, left-click it.

To look through the list one can use either the mouse scroll button or the following keyboard buttons: ,
, , , Home/End, Page Up/Page Down.

www.issivs.com
 SecurOS Cargo 71 User Guide
Working with Module

5.1.1 Working with Results Tab

Appearance of the Results tab is represented in Figure 47.

Figure 47. Protocol Window: Protocol Tab in Automatic Mode

Two types of recognized container number records are displayed in the Results tab:
· list of the last recognized container numbers (general list);
· list of the last recognized "alarmed" container numbers ("alarmed" records list).

Note. Number of displayed records is defined during system configuration (see Cargo: GUI).

Each Protocol tab record contains the follow information:

· Recognized container number. The "?" mark is used for any unrecognized character of the container
number.

www.issivs.com
 SecurOS Cargo 72 User Guide
Working with Module

· Date and time of the container passing (time of the first recognition) in format of the installed OS.
Date is displayed only when the Display date checkbox is selected in the Cargo: GUI object settings
(see Display Tab).
· Recognizer name.
· The icon of the dangerous contents of the container according to IMDG. Displayed if the container
is marked with the corresponding image and the Classify dangerous goods checkbox is selected in
the settings of the Cargo: Number recognizer object (see IMDG classes tab).
· Optional: "alarm" information, i.e. comment to given container number.

"Alarmed" records are the ones associated with recognized container numbers found in
white/information/black lists of the Watchlists database or appropriate external database.

Notes:
1. If recognized container number belongs to any watchlist, comment to this number will be displayed
in the list in color, specified in the Cargo: GUI object settings (see Additional Tab)
2. If container number is fully recognized and has invalid checksum it will be marked with icon.

See also:
· Automatic and Manual Protocol Modes.
· Switching Protocol Modes.
· Working with Results Tab Records.

5.1.1.1 Automatic and Manual Protocol Modes

Protocol may work in two modes: Automatic and Manual. An indicator of the current mode is the
corresponding (Auto-refresh) button in the Protocol window (see Figure 48).

Figure 48. Module working mode indication

Automatic mode
Automatic mode is used for passive monitoring — in this mode operator can't edit recognized container
numbers, perform a search, add container numbers to the watchlists, etc. When working in Automatic
mode operator interface appearance is the following:
· Button (Auto-refresh) is pressed and highlighted.
· List of the recognized container numbers is updated automatically at each new recognition. New
recognition record is always added to the top of the list.

www.issivs.com
 SecurOS Cargo 73 User Guide
Working with Module

· Cameras of the Media Client are in live mode; one can observe passing of the vehicle with container
in real time mode.
· Information associated with new recognition (current record) is displayed in the details window
(see Working in Details Window). Information in the window is automatically updated at each
new recognition.

Notes:
1. The current record is always located at the top of the list. This record is highlighted in light-blue
(see Figure 48).
2. Number of the records to display is specified by the system administrator. At each new recognition
the latest record is replaced by the new one.

Manual mode
Manual mode is used for working with recognition results — editing container numbers, searching
container numbers in the database, editing container numbers in the watchlists databases, adding
comments, etc. When working in the Manual mode, operator interface appearance is the following:

· Button (Auto-refresh) is not pressed and not highlighted.

· List of the recognized container numbers is updated automatically at each new recognition. A new
record is always added to the top of the list.
· Camera on the Media Client is switched to the archive mode and "the best frame" is displayed. See
also Media Client features when switching protocol modes.
· Information associated with record selected in the list is displayed in the details window
(see Working in Details Window). Information in the window is not updated at new recognition.

5.1.1.2 Switching Protocol Modes

The Automatic mode is set each time when module starts.

To switch to the Manual mode one can use one of the following methods:
· click the (Auto-refresh) button in the Protocol window (see Figure 48).

Note. If Details window (see Working in Details Window) is displayed in the operator GUI, this button is
hidden.

· select a record in the Protocol's list of the recognized container numbers.

Note. Module switches to the Manual mode automatically when operator performs operations in the details
window and also when operator activates the Search or Watchlists tabs.

To switch back to the Automatic mode click the (Auto-refresh) button (see Figure 48).

Note. When switching modes, the selected mode is also set for the details window (see Working in Details
Window).

www.issivs.com
 SecurOS Cargo 74 User Guide
Working with Module

Media Client features when switching protocol modes

If operator selected a record in the protocol list to switch to the Manual mode, then all Cameras
associated with selected record (or, if to be more precise, with appropriate Recognizer, see Cargo: Side
number recognizer) will be displayed in the Media Client in archive mode. In this case the following
restrictions are applied:
· Not more than 4 Cameras can be displayed in the Media Client. If more than 4 Cameras were
specified in the Recognizer settings, then only first 4 Cameras (in order) are displayed.
· 1x1 or 2x2 layout is used depending of the Cameras number.
· Archives of all displayed Cameras are synchronized by the time of the recognition event, generated
by Recognizer camera, see description of the Analyze video from camera in the Video source Tab.

When switching back to the Automatic mode the following rules are applied:
· All Cameras are switched to the live mode.
· The Media Client's layout, that was used before switching to the Manual mode, is restored.
· Cameras are placed in the layout 's cells in that order, which was used before switching to the
Manual mode.

See also:
· Working with Search Tab.
· Working with Watchlists Tab.
· Working in Details Window.

5.1.1.3 Working with Results Tab Records

To browse the container number information (to select it), click it.

To filter recognized container numbers, click Filter button. The Results tab will become one-listed and
display only "alarmed" records.

To additionally filter records by the number of the Recognizer, click the down arrow on the Filter
button (see Figure 49).

Figure 49. Filter by Container number recognizer

Note. If Enable License plate recognizers grouping is not selected (see Display Tab), Recognizers will be
listed in alphabetical order. If selected, they will be grouped by belonging to Local/Remote system.

www.issivs.com
 SecurOS Cargo 75 User Guide
Working with Module

To switch from one-listed tab back to all recognized and "alarmed" records view, click the Filter
button again.

5.1.2 Working with Search Tab

Use the Search tab to find specific data items, including previously recognized container numbers,
stored in the SecurOS Cargo database and other databases (see Database). With small to medium sized
databases, containing up to several hundred thousand records, queries will be processed pretty fast.
Yet, the larger the stock of records having to be referenced, the longer the search will inevitably take.
Therefore, if no effort is taken to limit the search scope in databases containing millions of records, the
query response time might become unacceptably large. One solution to this problem would be to shrink
the scope of referenced items as much as possible using the available info on the container numbers one
wishes to find.

Figure 50. Protocol Window: Search Tab

The Search tab window is divided into the Search form (upper area) and Search result (bottom area)
parts (see figure 50).

www.issivs.com
 SecurOS Cargo 76 User Guide
Working with Module

All query fields specifying the items to be found are optional. For example, you can select a specific
source of container number or skip this field so that results from any Recognizer will be assumed
suitable. There are two parameters, however, that directly affect the pool of records to be analyzed.
These are the "Time interval" and the flag to "Search first symbols of number" (the latter in no way
precludes entering the number in full in the Text field). Specifying any of these parameters (or both)
drastically reduces the response time for large databases.
5.1.2.1 Searching

The Search form (see Figure 51) is used to specify the kind of data items you wish to find.

Figure 51. Search Form

The actual database query is constructed using the search parameters (all of them are optional) entered
by the operator. These include the time interval; the Type of the container number (i.e., whether it
should belong to one of the predefined types); Recognizer (you can select the Recognizer that identified
the number); and the text to be found (the Text field). The use of these search parameters is detailed
below.

Time interval. Select appropriate checkboxes and specify start and end of the time interval in the From
and To fields with the help of buttons or keyboard. If the From checkbox is not selected, the search
interval is assumed to have no limit in the past. If the To checkbox is not selected, then the current time
will be used as the end of the search period. As mentioned above defining time limits significantly
reduces searching time.

Note. When the Search tab is used for the first time, then search interval is specified automatically by the
system and is equal to one hour (from the current time).

IMDG class. Select the contents dangerous class of the container to be found (see Figure 52). Default
value is Ignore. This means that the search results will return container numbers both with and
without dangerous content that satisfy all other specified search criteria.

Warning! The field is available if the Classify dangerous goods flag is checked in the settings of at least one of
the active Recognizers (see IMDG classes tab).

www.issivs.com
 SecurOS Cargo 77 User Guide
Working with Module

Figure 52. Search Form. IMDG classes available for searching

To specify search conditions by dangerous class, select the checkboxes to the left of the classes of
interest. To search by all dangerous classes, select the All IMDG classes checkbox. To search for
containers that do not contain dangerous goods (or if it has not been searched), select the None
checkbox.

Type of number of the container. Using the drop-down list, you can limit the search to recognized
container numbers falling within a certain class. This could be numbers appearing in the white, black,
or info lists (see Working with Checklists Tab and Watchlists Tab); or present on any of the lists; or
not fully recognized. No type constraints are imposed if Any is selected for this field.

Recognizer. This parameter affects only the search result that is displayed. If a concrete Recognizer is
specified, then in the Search result list will be displayed only those license plates that were recognized by
this Recognizer (see Working with Results Tab Records). If Any value is selected, search results will be
displayed on all Recognizers.

Note. If Enable License plate recognizers grouping is not selected (see Display Tab), Recognizers will be
listed in alphabetical order. If selected, they will be grouped by belonging to Local/Remote system.

Text. If this field remains blank, any container number satisfying the search parameters described above
will fit. If the text string is not empty, its interpretation as a search template will depend on the selection
made for the two checkboxes described below. The text string will be looked for either across the
recognized container numbers alone, if the Search only number checkbox is activated, or otherwise
across the recognized numbers and the corresponding comment field. In the latter case, the search takes
longer to complete. When searching for container numbers it is allowed to enter both uppercase and
lowercase characters. The search can be significantly sped up if the Search first symbols of number
checkbox is activated and the text entered is the full container number or its initial part. For example, a
container number XYZ123 can be quickly found using the search string XYZ1, however the query might
also return the number XYZ100.

www.issivs.com
 SecurOS Cargo 78 User Guide
Working with Module

Regular expressions (see Pattern Search) can also be entered as search text strings, thus allowing the
experienced user to target a whole set of number variants in one query.

Note. All search parameters are optional and can be combined as needed.

Sort by date. Choose how to sort found records. Found records can be sorted by date: either from oldest
to newest or from newest to oldest records.

In all search recommendations, it is assumed that any of the time interval, Type orRecognoizer fields
can be additionally specified.

If the Display query status while searching DB checkbox is selected (see Display Tab), then when
searching database system will display a table, where name/ID of the queried database, current query
status and its progress bar (see figure 53) will be represented:

Figure 53. DB query statuses

Warning! Search is carried out only on those databases that are used by Recognizers specified in search
conditions.

When searching on all available databases is finished the search result list is displayed (see figure 54):

www.issivs.com
 SecurOS Cargo 79 User Guide
Working with Module

Figure 54. Search result

5.1.2.1.1 Typical Search Operations

The following operations are available in the searching tab:
· Searching Container Within Time Interval.
· Searching Container by dangerous goods.
· Searching Container by Full Number (part of number) or Comment.
· Viewing Database Information.
· Searching Partially Recognized Container Number.
· Searching Container by Recognizer.

Searching Container Within Time Interval

To find container numbers recognized within a certain time interval:
1. Set the time interval by means of the From and To fields.
2. Leave the Text field blank.
3. Click the Search button or press the Enter key to start the search.

Searching Container by dangerous goods

To find container by dangerous goods:
1. In the IMDG classes field open drop-down list and select flags to the left of that dangerous classes
of goods, containers with which must be found.
2. Click the Search button or press the Enter key to start the search.

Searching Container by Full Number (part of number) or Comment

To find a container by its full number, or a part of the number, or by text present in the comment field:

www.issivs.com
 SecurOS Cargo 80 User Guide
Working with Module

1. In the Text field, enter a container number in full, or its part, or a text string to be looked for in the
comment database field.
2. Activate the Search only number checkbox, if search is to be done among recognized container
numbers alone (excluding comments). If the whole container number or its initial part are known,
activate the Search first symbols of number checkbox for a much faster search.
3. Click the Search button or press the Enter key to start the search.

Viewing Database Information

To examine all records stored in the Module’s database:
1. Leave all search parameters undefined.
2. Click the Search button or press the Enter key to start the search.

Searching Partially Recognized Container Number

To find container numbers that failed to be fully recognized:
1. Select the Error item from the Type drop-down list.
2. Click the Search button or press the Enter key to start the search.

Searching Container by Recognizer

To examine all container numbers output by a given Recognizer:
1. Select the respective Recognizer from the Recognizer drop-down list.
2. Click the Search button or press the Enter key to start the search.

5.1.2.2 Pattern Search

Searches can be done on the whole container number or on part of the number in the Text field. When
doing partial text searches, unknown symbols may be replaced by regular expression.

Note. For additional information on regular expressions see http://msdn.microsoft.com/en-

us/library/28hw3sce.aspx.

Table 15. Example of using regular expressions for search

Regular expression Description

~^A All container numbers begin with the A letter.

!~^A All container numbers do not begin with the A letter.

~A$ All container numbers end with the A letter.

!~A All container numbers do not have the A letter.

~[0-9]A All container numbers have the letter A after any digit.

All container numbers have the AU or HU or TU

~(AU|HU|TU)
substring.

~(77|97)$ All container numbers end with the 77 or 97 substring.

All container numbers have the 00, 01, 10 and 11

~[0-1][0-1]
substring.

www.issivs.com
 SecurOS Cargo 81 User Guide
Working with Module

5.1.2.3 Working with Search Results

There is a list of found records in the Search results section. If number of such records exceeds the value
specified in the Cargo: GUI module settings (see Cargo: GUI), then data will be displayed page by page.

To display the next page, click the Next records link below the search result list. To return to the
previous page, click the Previous records link (see figure 54).

Warning! When scrolling pages all the databases are queried again.

To view more information about a particular container number, click on the required entry. On the
Media Client, specified in the Cargo: GUI object settings, the “best frame” of the recognized container
number will be displayed. Details window will display all available information for this container
number (see Working in Details Window).

To export search result:

Click the Export button and select appropriate menu command:
· Search and Export — to export all search result pages;
· Export page — to export currently displayed page of the search result.

System will display search results in view mode. Then one can save data in one of suggested formats.

5.1.3 Working with Watchlists Tab

Watchlists tab (see figure 55) is intended for editing black, white, informational or other list of the
internal or external databases. Module checks if a recognized container number belongs to such a
watchlist and, if it exists in the appropriate database, displays information on the protocol tab
(see Working with Results Tab) in real-time.

Figure 55. Protocol Window: Watchlists Tab

Using the Watchlists tab an operator can insert container number and attendant information into the
black, white or informational list, as well as edit or delete existent record.

This tab consists of the following components:

· Watchlist text box — a drop down list, that contains all internal or external databases connected to
the Module;

www.issivs.com
 SecurOS Cargo 82 User Guide
Working with Module

· Container numbers — a table, which represents data in a form, that complies with database
structure. I.e. number of columns in each table is specified by the structure of the appropriate
database. Table header (column names) are also displayed in the form, that complies with database
structure;
· Export, Import, Add, Remove, Save buttons — list export/import, adding/removing record,
saving changes.

5.1.3.1 Typical Operations with Watchlists Records

The following operations are available in the watchlists tab:
· Adding Number to Wathclist.
· Selecting Record.
· Editing Record (in table).
· Editing Record (in separate window).
· Deleting Record.
· Sorting List.
· Exporting List.
· Importing List.
· Customizing Table Appearance.

Adding Number to Wathclist

To add a container number to a watchlist do the following:
1. In the Watchlist drop down list select a list, you want add a new container number to.
2. Click the Add button.
3. System will display an empty entry at the bottom of the list. Double click appropriate cell and type

container number, comment, other information. Each added record is marked with symbol on
the left of the record.

Note. If comment to the record is not specified, the Container number was found message will be
displayed in protocol window and details window. Message will be marked in color, specified in the Cargo:
GUI object settings for corresponding watchlist (see Additional Tab).

4. Click the Save button to store container number into the list.

Container number and attendant information will be registered in the appropriate list. When the
container number is recognized the record will be displayed, specifying which list the plate belongs to.
Additional comments/information about the recognized container number, that matches the database
query (see External Database Connection Example), will be displayed in the Comment field.

Selecting Record
To select record, click it.

Editing Record (in table)

To edit watchlist record do the following:
1. Select the record.
2. Double click the cell that must be changed.

www.issivs.com
 SecurOS Cargo 83 User Guide
Working with Module

3. Change the cell data. Edited record will be marked with symbol on the left of the row.
4. Click the Save button.

Container number and attendant information will be changed. When the container number is
recognized the record will be displayed, specifying which list the plate belongs to. Additional
comments/information about the recognized container number, that matches the database query (see
External Database Connection Example), will be displayed in the Comment field.

Editing Record (in separate window)

Note. Editing record in separate window is convenient when working with checklist fields that contain
significant text fragments. For example, when editing multi-string comments.

To change value of any field do the following:

1. Right-click field that must be changed.
2. Select Open field_name in the context menu (see Figure 56).

Figure 56. Calling field editing window

3. Specify new field value in the opened field (see Figure 57).

Figure 57. Field editing window

4. Click on Add button.

www.issivs.com
 SecurOS Cargo 84 User Guide
Working with Module

Deleting Record
To delete record do the following:
1. Select the record.
2. Click the Delete button.
3. Click the Save button.

Warning! Each deleted record is marked with symbol on the left of the record. To confirm deletion click
the Save button, otherwise record will not be removed.

Sorting List
To sort table records by any field click on required column in the table head, then click on the "arrow
up/arrow down" symbol (see Figure 58). Table records will be sorted by ascending/descending in the
selected column.

Figure 58. Sorting list

Exporting List
To export watchlist select it in the Watchlist field and click on Export button. List will be converted to
text csv file (with ";" separator). By default file will be saved in %ProgramData%
\ISS\Watchlists\Cargo folder. If operation is successful, system will display corresponding
message.

Importing List
To import container number list select required list in the Watchlists field, where information from
external file should be added to, then click on Import button. In standard file manager window choose
CSV-file (see CSV File Requirements below), that contains required data, then click on Open button.
Data of this file will be added to the end of selected Watchlist. If operation is successful, system will
display corresponding message.

Close Watchlist import window, click on Save button.

CSV File Requirements

External file, data of which will be imported into the Watchlist, should comply with the following
requirements:
· File type — simple text file with csv extension.
· The ";" symbol (semicolon) must be used as a fields/values separator.
· Number of columns in this file should correspond to number of columns of the table displayed in
the Watchlists tab (exclude Time and Operator columns, if such columns exist).
· Names of the columns in the file should correspond with names of the columns of the table
displayed in the Watchlists tab. Columns order in the file and in the table may differ.

www.issivs.com
 SecurOS Cargo 85 User Guide
Working with Module

If external file does not comply with conditions above, then system will display error message when
importing file.

Customizing Table Appearance

The appearance of the checklist table can be customized in accordance with the preferences of each
operator. One can customize the following elements:
· List of displayed columns;
· Columns width.

To display/ hide table columns:

1. Right click table head.
2. In context menu select/deselect checkboxes for columns, that should be displayed/hidden
(see Figure 59).

Warning! Column that contain container number is always displayed and cannot be hidden.

Figure 59. Customizing table appearance

To change column width:

1. Place mouse pointer over column separator. It will take the form shown in Figure 59.
2. Press and hold mouse button and move pointer in the desired direction.

5.1.3.2 Watchlists Changes History

When working with watchlists one can save and view saved history of operations with watchlist
records. To activate this feature one should do the following:
1. Modify used database in the Cargo: Logic module object settings (see Watchlists Tab, Watchlists
changes history block);
2. Enable feature in the Cargo: GUI object settings (see Additional Tab, Show Watchlists changes
history checkbox).

Note. Typical and cloned Watchlists databases are ready for modifying automatically. To modify external
database it must be connected to the Module first (see External Database Connection Example).

After feature is configured watchlists tables will contain additional columns (see Figure 60):

www.issivs.com
 SecurOS Cargo 86 User Guide
Working with Module

Figure 60. Call table with container number changes history

· Time — date and time of the last operation with this watchlist record (in format of used OS);
· Operator — name of operator who performed the last operation with watchlist record (name of
SecurOS User Account or Windows user, registered in Active Directory domain (see SecurOS
Administration Guide)).

Viewing Number Changes History

To view number changes history, right click on license plate number value in the table (in our example
this is the number field), in the context menu select the Container number changes history
(see Figure 60).

Note. Changes history will be displayed not only for the record selected in the list, but for all records, relating
to the selected number.

System will display Changes history for container number window (see Figure 61).

Figure 61. Change history for container number window

In this window history of all operations related to given container number will be displayed, beginning
with the adding this number to the watchlist. Information will be displayed in the following fields:
· Time — date and time of the operation (in format of used OS);
· Operator — name of operator who performed this operation with watchlist record (name of
SecurOS User Account or Windows user, registered in Active Directory domain (see SecurOS
Administration Guide));
· Operation — name of the performed operation. Possible values:
- Add — adding new value to the table;
- Edit — editing current value in the table;

www.issivs.com
 SecurOS Cargo 87 User Guide
Working with Module

- Delete — deleting current value from the table.

· Field — name of the field of the Watchlists table (see Figure 60), value of which has been changed;

Note. List of table fields depends on used watchlist database structure.

· New value — new value of the Field;

· Old value — old value of the Field.

When viewing one can sort data by table columns (see Sorting List).

5.2 Working in Details Window

Information, associated with the recognized container number, is displayed in the details window.

The window contains the following parts, see Figure 62:

Figure 62. Details Window

· Container number block, that include the following elements:

- A large-size view of the container number recognition result formatted according to its plate type.
Detected containers with missing or illegible container numbers are displayed as ?????? and
assigned a zero recognition quality;
- Additional Info field — displays additional information from the watchlists (see Working with
Watchlists Tab) or external databases related to this container.

www.issivs.com
 SecurOS Cargo 88 User Guide
Working with Module

· Auto-refresh button — indicator of current Protocol mode (see Automatic and Manual Details
Window Modes).

- — Protocol works in Automatic mode, switches to Manual when pressed;

- — Protocol works in Manual mode, switches to Automatic when pressed.

· Number field — is a place where the recognized container number can be manually corrected
(edited);

Note. One can edit container number if Enable watchlist editing checkbox is selected in the Cargo: GUI object
settings (see Cargo: GUI).

· Edit/ Save/Cancel buttons to process Number changes:

- — edit current number (switches to the Save button after any changes);

- — save current number changes;

- — discard current number changes.

· IMDG class block that contains icon of the recognized image of IMDG code. Hovering the mouse
pointer over the icon displays a tooltip with a textual description of the dangerous class of the
contents of the container (for example, Class 5. Oxidizing substances and organic
peroxides);

Warning! The field is available if the Classify dangerous goods flag is checked in the settings of at least one of
the active Recognizers (see IMDG classes tab).

· Other information block, that include the following data:

- Quality — gives the relative quality of the recognition. To filter out the "recognition noise", set the
quality filter to a higher value (see Recognition Tab).

Note. The recognition quality value is displayed in the Details Window only if the Show recognition quality
parameter is activated in the Cargo: GUI object settings window (see Cargo: GUI).

- Date — displays the date and time when this container number was first recognized in the video.
To display time the current time format of the installed OS is used.
- Source — gives the name (as in the SecurOS Object Tree) of the Recognizer this container number
was detected by.
· Print report — allows to print a report about given container (see Printing Report).
· Comment field — you can enter any comment here. It will be displayed in the Protocol window;
· Edit/ Save/Cancel buttons to process Comment changes:

- — edit current comment (switches to the Save button after any changes);

- — save current comment changes;

- — discard current comment changes.

www.issivs.com
 SecurOS Cargo 89 User Guide
Working with Module

Note. If comment to the record is not specified, the Container number was found message will be
displayed in the Additional info field. Message color will correspond to the color of the corresponding
watchlist.

In Manual mode an image of the container with recognized number is displayed (see Figure 63):

Figure 63. Details Window in Manual mode. Image type - Only container ID

Container image field is displayed in the following cases:

· Store to database flag (see Recognition tab) is activated in the Cargo: Side (top) number recognizer
object settings;
· Show container image (if possible) flag is activated in the Cargo: GUI object settings (see Cargo:
GUI).

This field contains the following parts:

· Container image — image of the container stored in the database. Type of displayed image (Only
container ID, Whole frame) depends on Recognizer object settings (see Recognition Tab,
Image type parameter). To change image size, the following buttons are used:

- — zoom in/zoom out;

- — zoom to original size;

- — stretch image to fit;

- — save image into a file (see Saving image into the File).

Note. Selected image display mode is kept when moving to the next recognized container number.

www.issivs.com
 SecurOS Cargo 90 User Guide
Working with Module

5.2.1 Operations in Details Window

The following operations are available in the details window:

· Editing Recognized Number.
· Printing Report.
· Adding/ editing comment.
· Saving image into the File.

Editing Recognized Number

To edit the recognized plate number:
1. Left-click Plate field.
2. Edit the recognized number.

3. Press Enter key (or button to the right of the field).

Note. Unsaved changes can be discarded by clicking on button.

Operation of editing the recognized number is logged, information about event is displayed in the Event
Viewer window (see SecurOS Quick User Guide). Window appearance is shown in Figure 64.

Figure 64. Container number editing event in Event Viewer window

The following information is displayed in the string corresponding to number change event:
· Object type — type of object, that generated event — Cargo: Logic module;
· Name — name of the object of the specified type;
· Time — event date and time;
· Event — name of the number changing event — Recognized Container number changed;
· Comment — event details (is displayed in the Comment window if event is selected):
- Operator — ID and name of the SecurOS User Account or Windows user (if Active Directory is
used, see SecurOS Administration Guide), who changed container number;
- Computer — ID of Computer within SecurOS network, from which container number has been
changed;
- Old License plate number — recognized license plate number;
- New License plate number — changed license plate number.

When number is changed the corresponding PLATE_CORRECTED event of the CARGO_LOGIC object is
saved to the SecurOS log (see Appendix 2. Module Events and Commands Reference, Cargo: Logic
module subsection).

www.issivs.com
 SecurOS Cargo 91 User Guide
Working with Module

Printing Report
To print a report:
1. Click the Print report button. A standard print dialog box will appear.
2. Set the printing parameters and click the OK button.

All the video frames captured by all cameras selected in the Record video from cameras settings (see
Video Tab) at a moment when the container number was best visible and the following data, displayed
in this Details Window, will be printed:
· Name of the Recognizer, that detected container.
· Date and time of the first container number recognition in a frame in the DD-MM-YYYY
HH:MM:SS.FFF format.
· Recognized container number.
· Container platform's moving direction. Mentioned above information is displayed if the Cargo:
Consolidator object is used and the container platform's moving directions are specified in it's
settings (see Cargo: Consolidator).
· Comment to the recognized container number (optionally).

Notes:
1. In Automatic mode the data, displayed in the Details window at the moment of the command
execution, will be printed.
2. Container image (snapshot) is included into the report only if there is a frame in archive, that
corresponds to the moment of the operation execution.

Example of the report is presented in Figure 65.

www.issivs.com
 SecurOS Cargo 92 User Guide
Working with Module

Figure 65. Report printed from the Details window

Adding/ editing comment

To add/edit a comment:
1. Click Comment field.
2. Type required text.

3. Click on the button, located below the Comment field.

Note. Unsaved changes can be discarded by clicking on button.

Saving image into the File

To save image into the file click the button. System will display message with information about
saved file (see Figure 66).

www.issivs.com
 SecurOS Cargo 93 User Guide
Working with Module

Figure 66. Message with information about file

To browse saved frame directory click the Open directory button.

5.3 Working with Media Client

The SecurOS' Media Client is used to manage video from the cameras in the system. Using the video
monitor a user can view live video streams, control PTZ cameras, view/playback archived video,
perform smart searches for video, export video sequences, and much more.

For more information about working with Media Client (e.g. switching layouts and cameras, working
with archive, image zoom) see SecurOS Quick User Guide.

5.4 Self-diagnostic with the Help of Health Monitor Module

Errors that may occur during SecurOS Cargo operation are being diagnosed automatically and pop up
in Health Monitor diagnostics module window (see SecurOS Administration Guide). Health Monitor
can display problems in Table or Tree view. Use corresponding buttons in top right window corner to
switch between these modes:
· – for Table view;

· – for Tree view.

Table view
Appearance of Health Monitor in Table view is shown on figure 67.

www.issivs.com
 SecurOS Cargo 94 User Guide
Working with Module

Figure 67. SecurOS Cargo Problem Objects. Table view

In Table view problems displayed as a list that can be sorted by columns.

Table data is presented by following columns:

· Object type — type of problem object;
· Object name — identifier and name of problem object;
· Server — ID and IP address of Video Server where the problem occurred. If there is no IP address
specified in Computer object settings then the "IP address is not set" line will be displayed;
· Problem type — name of the problem occurred on given object;
· Date and Time — date and time when problem occurred in OS format. Today's problem will be
marked with "Today" word.

Tree view
Appearance of Health Monitor in Tree view is shown on figure 68.

www.issivs.com
 SecurOS Cargo 95 User Guide
Working with Module

Figure 68. SecurOS Cargo Problem Objects. Tree view

In Tree view SecurOS Cargo problem objects are combined in SecurOS Cargo node of Problem objects
tree. Within the node objects are grouped by SecurOS Cargo object type:
· Container number recognizers (see Cargo: Side (top) number recognizer Object Problems);
· Logic modules (see Cargo: Logic module Object Problems).

The total number of SecurOS Cargo problem objects of given type is displayed to the right of the
SecurOS Cargo node. Within the node, the total number of problem objects of this type is displayed to
the right of each group.

Select the problem to see its detailed description in the bottom of the window.

More information about Health Monitor self-diagnostic module is provided in the SecurOS
Administration Guide.

5.4.1 Cargo: Side (top) number recognizer Object Problems

The following problems are diagnosed for the Cargo: Side number recognizer and the Cargo: Top number
recognizer:
· Recognition results Database is not available;
· Insufficient CPU resources to analyze all frames;
· Error while saving container image to Database;
· Error while saving recognition results to Database;
· Error while retrieving recognition area mask;
· Video resolution is excessively high.

www.issivs.com
 SecurOS Cargo 96 User Guide
Working with Module

Warning! Problems of the Cargo: Top number recognizer and Cargo: Side number recognizer objects are displayed
®
within the same group SecurOS Cargo Container number recognizers.

Recognition results Database is not available

· The message appears if the connection with the recognition results database is lost.
· The message disappears in 3 minutes after restoring database connection.

Insufficient CPU resources to analyze all frames

· The message appears if the frames queue for recognition in the Cargo: Side number recognizer is
regularly overflooded. More than 30% of frames for recognition are dropped for at least 30% of all
passing containers. This can decrease recognition quality.
· The message disappears if the issue does not repeat within 3 minutes.

Note. This problem can also be detected for Cargo: Top number recognizer object.

Error while saving container image to Database

· The message appears if the container image was not saved into the database. Possible reasons are
the following:
o connection to the DB was lost;
o DB rejected image saving request.
· The message disappears if the error does not repeat within 3 minutes after recording is resumed.

Error while saving recognition results to Database

· The message appears if recognition results cannot be saved into the database. The recognition
results will be lost.
· The message disappears if the error does not repeat within 3 minutes.

Error while retrieving recognition area mask

· The message appears if the recognition area mask were not retrieved successfully.
· The message disappears after the module is restarted.

Note. This problem can also be detected for Cargo: Top number recognizer object.

Video resolution is excessively high

· The message appears if the Examine all orientations option is enabled, and the frame resolution for
at least one dimension (vertical or horizontal) is higher than 1200 pixels.
· The message disappears immediately after the problem is solved.

Note. This problem can also be detected for Cargo: Top number recognizer object.

5.4.2 Cargo: Logic module Object Problems

The following problems are diagnosed for the Cargo: Logic module object:
· Error while saving results to Database;
· Error while querying Watchlist.

www.issivs.com
 SecurOS Cargo 97 User Guide
Working with Module

Error while saving results to Database

· The message appears if an error occurred when saving recognition results (number and
corresponding Watchlists) into the database. The recognition results will be lost.
· The message disappears if the error does not repeat within 3 minutes.

Error while querying Watchlist

· The message appears if it is impossible to match recognized container number against the
Watchlists because the Watchlist database is disconnected or not configured.
· The message disappears if the error does not repeat within 3 minutes.

www.issivs.com
 SecurOS Cargo 98 User Guide
Appendixes

6 Appendixes
This section contains the following Appendixes:
· Appendix A. Camera Calibration Utility;
· Appendix B. Module Events and Commands Reference;
· Appendix C. Technical Support Information.

6.1 Appendix A. Camera Calibration Utility

Camera Calibration Utility is used to avoid images distortion received from the Recognizer's camera.
Thus using several archive images the utility increases the recognition quality on geometrical similarity
disturbance between an object and its image. Elimination of distortion in the megapixel video can
recognize numbers, visible under considerably large angles (horizontal and vertical) than allowed by
regulations.

Note. Distortion may be caused by applying low-quality optical camera devices or camera with big
observation angle or short distance between the object and Recognizer's camera.

Location: <SecurOS_root_folder>\Modules\Cargo\ccu.exe

www.issivs.com
 SecurOS Cargo 99 User Guide
Appendixes

Figure 69. Camera Calibration Utility Window

There are buttons to work with files and help buttons on the utility toolbar (see figure 70).

Figure 70. Camera Calibration Utility Toolbar

Table 16. Camera Calibration Utility Toolbar Buttons

Button Name Description

Working with files

Open image Open image file

Reset Reset calibration settings

Load Load calibration settings

Save Save calibration settings to the current XML

file. If file is not set, new window will appear
to define its path and name.

www.issivs.com
 SecurOS Cargo 100 User Guide
Appendixes

Button Name Description

Save as Save calibration settings to new XML file

Working with images

Grid Show distortion grid

Guides Show guide lines

Setup cut region Activate cropping area setting mode. Cropped

area is the analyzed part of the frame where
number is best seen. Setting up the clipping
area allows to save CPU resources and
eliminate cases of incomplete number
recognition. Cases of incomplete recognition
are eliminated due to the fact that the
recognition result is issued immediately after
the controlled shifting of the number beyond
the clipping region. When analyzing the entire
frame area, situations are possible when the
number is almost not visible, but continues to
be recognized, that results in errors.

Stretch cut region Stretching cut region. Allows to stretch selected

analyzed area of the frame on the full frame.

Setting panel consists of the following four tabs (see figure 69):
· Distortion — nonlinear image transformation (see Distortion Tab);
· Zoom/ Rotation — linear image transformation (see Zoom/ Rotation Tab);
· Perspective — linear image transformations (shift, skew, stretch) and perspective elimination (see
Perspective Tab);
· Points calibration — automatic camera calibration by points (see Points Calibration Tab).

To switch between tabs, click its name.

Note. There are only two tab names displayed on setting panel. To switch to the next, click Tabs List Button
(see figure 69) and choose the required one.

To avoid distortion do the following:

1. Export several frames with container in JPEG format (see SecurOS Quick User Guide).
2. Launch Camera Calibration Utility.
3. Click Open image button and select an archive image of carriage (see item 1).
4. Using parameters settings panel (tabs) set calibration parameters. It is recommended to use image on
Transformed tab for visual check of image changes.
5. Click Open image button and select an another archive image of carriage to check specified
parameters. If necessary, repeat item 4.
6. Click the Save or Save as button in the utility toolbar to save specified parameters to a file for further
loading or close the utility window.

www.issivs.com
 SecurOS Cargo 101 User Guide
Appendixes

7. System will display the following informational message (see figure 71):

Figure 71. Informational message

8. Click the Yes button to send and apply current settings into SecurOS Cargo, otherwise click the No
button. In latter case unsaved correction settings will be lost.

www.issivs.com
 SecurOS Cargo 102 User Guide
Appendixes

6.1.1 Distortion Tab

The Distortion tab is used to make nonlinear image transformation and defines the following
parameters:

Figure 72. Distortion Tab

· Pincushion — pincushion and barrel distortion;

· Corners — deskewing corner position;
· Keystone (V) — deskewing image position on vertical line;
· Keystone (H) — deskewing image position on horizontal line;
· Distortion center X, Y — distortion center coordinates;

www.issivs.com
 SecurOS Cargo 103 User Guide
Appendixes

· Balance — applying defined values to the image width or height.

To change a parameter, use its scroll bar and/or editable field to set the value.

6.1.2 Perspective Tab

The Perspective tab is used for shifting (parallel transfer), skewing, stretching upon horizontal and
vertical lines and elimination of both vertical and horizontal perspective (parallel lines convergence on
image). The following transformation parameters can be defined on the tab:

Figure 73. Perspective Tab

· Perspective (H) — horizontal perspective elimination;

www.issivs.com
 SecurOS Cargo 104 User Guide
Appendixes

· Perspective (V) — vertical perspective elimination.

· Skew (H) — image skewing upon horizontal line;
· Skew (H) — image skewing upon vertical line;
· Stretch (V) — image stretching upon vertical line;
· Stretch (H) — image stretching upon horizontal line;
· Shift (H) — image shifting upon horizontal line;
· Shift (V) — image shifting upon vertical line;
· P Center (X, Y) — perspective center coordinates.

To change a parameter, use its scroll bar and/or editable field to set the value.

6.1.3 Zoom/Rotation Tab

The Zoom/ Rotation tab is used to make linear image transformation and defines the following
parameters:

Figure 74. Zoom/ Rotation Tab

· Zoom — image scale;

· Rotation — image rotation relative to the image point (see below);
· Z/ R Center X, Y — coordinates of image point (by default its coordinates are equal with the image
center).

To change a parameter, use its scroll bar and/or editable field to set the value.

www.issivs.com
 SecurOS Cargo 105 User Guide
Appendixes

6.1.4 Points Calibration Tab

Functionality of this tab is not used by SecurOS Cargo Module.

6.2 Appendix B. Module Events and Commands Reference

SecurOS system event programming is described in the SecurOS Programming Guide. Listed below
are the parameters of the events generated by the SecurOS Cargo and all the corresponding commands.

6.2.1 Cargo: Side number recognizer

Object type identifier: CNR_CAM_SIDE.

Table 17. CNR_CAM_SIDE events

Event identifier: CONTAINER_NUMBER_RECOGNIZED

Event name in macro: Container number recognized

Description: Final hypothesis of recognition

Parameters:

recognizer_id Recognizer ID.

recognizer_name Name of the Recognizer that sends the event.

Recognizer type. Possible values:

recognizer_type · CNR_CAM_SIDE — Cargo: Side number recognizer;

· CNR_CAM_TOP — Cargo: Top number recognizer.

number Recognition result

weight Final hypothesis trustworthiness (relative units)

direction_id Container’s carrier direction ID

Date and time when container number was best seen (in DD-MM-YY
best_view_date_time
HH:MM:SS.FFF format)

best_view_mask_id ID of the zone where the container number is seen best

camera_id Recognizer's camera ID.

Time of the first recognition of a plate with an IMDG code in the

imdg_first_time
Camera's field of view (in YYYY-MM-DD HH:MM:SS.FFF format)

Time of the last recognition of a plate with an IMDG code in the

imdg_last_time
Camera's field of view (in YYYY-MM-DD HH:MM:SS.FFF format)

Structure in JSON format which contains information about the

Camera that has detected the container number. The structure also
comment contains parameters that allow to jump to the event in the operator
interface (see SecurOS Programming Guide, Use the comment
Parameter to Visualize Events section).

www.issivs.com
 SecurOS Cargo 106 User Guide
Appendixes

Event identifier: CONTAINER_IMDG

Event name in macro: no

Description: The results of code recognition when an IMDG code image is found on the container

Parameters::

The list of dangerous classes of the container contents according to the

imdg_codes IMDG code, separated by commas. Only the class is specified (no
subclass).

Commands: none.

6.2.2 Cargo: Top number recognizer

Object type identifier: CNR_CAM_TOP.

Table 18. CNR_CAM_TOP events

Event identifier: CONTAINER_NUMBER_RECOGNIZED

Event name in macro: Container number recognized

Description: Final hypothesis of recognition

Parameters:

recognizer_id ID of the Recognizer that sends the event.

recognizer_name Name of the Recognizer that sends the event.

Recognizer type. Possible values:

recognizer_type · CNR_CAM_SIDE — Cargo: Side number recognizer;

· CNR_CAM_TOP — Cargo: Top number recognizer.

number Recognition result

weight Final hypothesis trustworthiness (relative units)

direction_id Container’s carrier direction ID

Date and time when container number was best seen (in DD-MM-YY
best_view_date_time
HH:MM:SS.FFF format)

best_view_mask_id ID of the zone where the container number is seen best

camera_id Recognizer's camera ID.

Time of the first recognition of a plate with an IMDG code in the

imdg_first_time
Camera's field of view (in YYYY-MM-DD HH:MM:SS.FFF format)

Time of the last recognition of a plate with an IMDG code in the

imdg_last_time
Camera's field of view (in YYYY-MM-DD HH:MM:SS.FFF format)

www.issivs.com
 SecurOS Cargo 107 User Guide
Appendixes

Structure in JSON format which contains information about the

Camera that has detected the container number. The structure also
comment contains parameters that allow to jump to the event in the operator
interface (see SecurOS Programming Guide, Use the comment
Parameter to Visualize Events section).

Event identifier: CONTAINER_IMDG

Event name in macro: no

Description: The results of code recognition when an IMDG code image is found on the container

Parameters::

The list of dangerous classes of the container contents according to the

imdg_codes IMDG code, separated by commas. Only the class is specified (no
subclass).

Commands: none.

6.2.3 Cargo: Logic module

Object type identifier: CARGO_LOGIC.

Table 19. CARGO_LOGIC events

Event identifier: LOG_ADDED

Event name in macro: New protocol record was added

Description: New protocol record was added

Parameters:

tid New or edited database record ID.

Event identifier: CAR_LP_FOUND

Event name in macro Recognized container number was found in database

Description: Container number was not found in database

Parameters::

Type of the Recognizer that sends the event. Possible values:

recognizer_type · CNR_CAM_SIDE — Cargo: Side number recognizer;

· CNR_CAM_TOP — Cargo: Top number recognizer.

recognizer_id ID of the Recognizer that sends the event

recognizer_name Name of the Recognizer that sends the event

www.issivs.com
 SecurOS Cargo 108 User Guide
Appendixes

Identifier of the container platform's moving direction. Possible

values:

direction_id · 0 — undefined;

· 1 — from right to left;

· 2 — from left to right.

track_id Container's number track identifier

Date and time when container number was best seen (in DD-MM-YYYY
best_view_date_time
HH:MM:SS.FFF format)

template_name Name of the template used for recognizing container number

number Recognition result

database_name Database name

Database type. Possible values:

· blacklist;
database_type
· whitelist;

· informationlist.

information Comment to the recognized container number from database

Structure in JSON format which contains information about the

Camera that has detected the container number. The structure also
comment contains parameters that allow to jump to the event in the operator
interface (see SecurOS Programming Guide, Use the comment
Parameter to Visualize Events section).

Event Identifier: CAR_LP_NOT_FOUND

Event name in macro: Recognized container number was not found in database

Description: Container number was not found in database

Parameters:

Recognizer type. Possible values:

recognizer_type · CNR_CAM_SIDE — Cargo: Side number recognizer;

· CNR_CAM_TOP — Cargo: Top number recognizer.

recognizer_id ID of the Recognizer that sends the event

recognizer_name Name of the Recognizer that sends the event

www.issivs.com
 SecurOS Cargo 109 User Guide
Appendixes

Identifier of the container platform's moving direction. Possible

values:

direction_id · 0 — undefined;

· 1 — from right to left;

· 2 — from left to right.

track_id Container's number track identifier

Date and time when container number was best seen (in DD-MM-YYYY
best_view_date_time
HH:MM:SS.FFF format)

number Recognition result

database_name Database name

Database type. Possible values:

· blacklist;
database_type
· whitelist;

· informationlist.

Structure in JSON format which contains information about the

Camera that has detected the container number. The structure also
comment contains parameters that allow to jump to the event in the operator
interface (see SecurOS Programming Guide, Use the comment
Parameter to Visualize Events section).

Event identifier: DB_SEARCH_ERROR

Event name in macro: Error occured while communicating with external database

Description: Query result is not received from the database

Parameters:

recognizer_id ID of the Recognizer that sends the event

recognizer_name Name of the Recognizer that sends the event

logic_id Cargo: Logic module object ID

logic_name Cargo: Logic module object name in Object Tree

number Recognition result

database_name Database name

Event identifier: PLATE_CORRECTED

Event name in Macro: Recognized Container number changed

Description: Recognized container number has been changed with the help of Cargo: GUI object

Parameters:

www.issivs.com
 SecurOS Cargo 110 User Guide
Appendixes

Date and time when container number was best seen (in DD-MM-YYYY
best_view_date_time
HH:MM:SS.FFF format)

Identifier of the container platform's moving direction. Possible

values:

direction_id · 0 — undefined;

· 1 — from right to left;

· 2 — from left to right.

Structure that contains the following data:

· Name and ID of the operator who changed container number;

· Name of Computer, from which container number has been

comment
changed;

· Recognized container number;

· Corrected container number.

corrected_plate Corrected container number

owner ID of Computer, from which container number has been changed

operator_id ID of User Account, who changed container number

direction_name Container platform direction name

number Recognized container number

operator_name Name of User Account, who changed container number

recognizer_id ID of the Recognizer that sends the event

recognizer_name Name of the Recognizer that sends the event

Type of the Recognizer that sends the event. Possible values:

recognizer_type · CNR_CAM_SIDE — Cargo: Side number recognizer;

· CNR_CAM_TOP — Cargo: Top number recognizer.

template_name Name of the container number template

track_id Container's number track identifier

Commands: none.

6.3 Appendix C. Technical Support Information

Current section contains service information that is necessary on addressing to Intelligent Security
Systems Technical Support.

www.issivs.com
 SecurOS Cargo 111 User Guide
Appendixes

Note. Collected data have to be send to the Intelligent Security Systems Technical Support Team (see Getting
Technical Support).

To ensure quick technical support, prepare the following technical information:

Warning! Data in items marked by "*'' are necessary to report.

1. (*) User (customer) name to address to.

2. (*) Organization name.
3. (*) User (or organization) contacts: phone, e-mail.
4. Name of a personal Intelligent Security Systems manager (on Intelligent Security Systems authorized
partner case). Otherwise, give the following data:
· Company where the hardware and software components were purchased.
· Actions proposed to solve the problems announced by a partner from whom the product was
purchased.
5. (*) Problem description.
6. (*) Actions results in the problem.
7. List of changes which result to the problem in case of applying after some changes in system
settings/configuration.
8. System and diagnostic information on computer and SecurOS system configuration obtained from
the SystemInfo utility (see SecurOS Administration Guide for detailed information about utility).
If it is impossible to run the utility provide the following information:
· (*) Guardant keys identifiers and Dallas code;

Note. Equipment Dallas code can be found by the Hardware Report Utility (see SecurOS Administration
Guide for detailed information about utility).

· (*) name and version of the installed Intelligent Security Systems company software.
· total number of video servers and monitoring (operator) workstations in the system;
· operating system (name and service pack version).
9. Another useful information, if possible. For example:
· computer equipment configuration.
· central processors load.
· main and virtual memory used volumes.
· network load.
· network and network neighborhood configuration.

www.issivs.com
 SecurOS Cargo 112 User Guide
Index

D
Database connection settings, 46
Database name property,
Index Database, 24
Database object description, 23
Database settings, parameter,
Cargo: Consolidator, 36
A Databases/Watchlists tables Tree, parameter,
Cargo: Logic module, 40
Add, button,
Details window, 87
Cargo: Logic module, 39
Saving image into the file, 92
Add/Delete, buttons,
Disable localized queries property,
Cargo: GUI, 60
External database, 45
Analyze video from camera, parameter,
Discard output if quality is under, parameter,
Cargo: Side number recognizer, 28
Cargo: Consolidator, 36

B Display date, parameter,

Cargo: GUI, 57
Bind parameters, button, Display query status while searching DB, parameter,
Watchlists, 43 Cargo: GUI, 57
Bottom edge of the zone where horizontal numbers Display, parameter,
appear, parameter, Cargo: GUI, 57
Cargo: Side number recognizer, 31
Build connection string, button,
Watchlists, 42
E
Edit watchlist parameter,

C Watchlists, 43
Enable container ID editing, parameter,
Cargo: Consolidator object description, 34 Cargo: GUI, 57
Cargo: Group of modules object description, 25 Enable License plate recognizers grouping, property,
Cargo: GUI object description, 55 Cargo: GUI, 58
Cargo: Logic module object description, 37 Enable watchlist editing, parameter,
Cargo: Side number recognizer object description, 25 Cargo: GUI, 60
Cargo: Top number recognizer object description, 34 Enhancing recognition by image warping, parameter,
Classify dangerous goods, parameter, Cargo: Side number recognizer, 28
Cargo: Side number recognizer, 33 Entries,
Client components, 10 Filtering, 74
Clone button, Pattern search, 80
Watchlists, 43 Erase records older than property,
Clone, button, Database, 24
Cargo: Logic module, 39 Event color marking, parameter,
Configuration examples, Cargo: GUI, 60
Client-server configuration, 64 Examine all orientations, parameter,
Distributed server-workstation configuration, 66 Cargo: Side number recognizer, 31
Standalone configuration, 61
Configurations,
Distributed configuration, 11
F
Frame Export, parameter,
Server-workstation configuration, 11
Cargo: GUI, 57
Standalone configuration, 11
From right to left, From left to right parameters,
Connection string property,
Cargo: Consolidator, 36
External database, 42

www.issivs.com
 SecurOS Cargo 113 User Guide
Index

Preview, button,
H Cargo: Side number recognizer, 28
Properties, button,
Host property,
Cargo: Logic module, 40
Database, 24
Protocol,

I Automatic mode, 72
Manual mode, 73
Illumination, 14
Image exporter, parameter,
Cargo: Side number recognizer, 32
Q
Query property,
Image format, parameter,
Watchlists, 43
Cargo: Side number recognizer, 32
Image quality, parameter,
Cargo: Side number recognizer, 32 R
Image type, parameter, Reassign the number column parameter,
Cargo: Side number recognizer, 32 Watchlists, 43
installation, Receive events from the logic objects property,
Hardware installation, 13 Cargo: GUI, 59
Software installation procedure, 15 Recognition algorithm sensitivity, parameter,
Installation, Cargo: Side number recognizer, 31
Installation procedure, 13 Recognition quality is lower than, parameter,
Cargo: Side number recognizer, 31
L Recognition sources, parameter,
Load settings from file (button), Cargo: Consolidator, 35
Recognize numbers moving up/left to right, down/right
Cargo: Side number recognizer, 28
to left, parameter,

M Cargo: Side number recognizer, 30

Recognized container IDs details window, group of
Media Client, parameter, parameters,
Cargo: GUI, 56 Cargo: GUI, 57
Recognized container IDs protocol window, group of
N parameters,
Cargo: GUI, 57
Name property,
Recognizers to process container IDs from property,
Cargo: Logic module, 41
Cargo: Logic module, 38
External database, 41
Record video from cameras, parameter,
Number of protocol records, parameter,
Cargo: Side number recognizer, 28
Cargo: GUI, 57
Recording mode, parameter,

O Cargo: Side number recognizer, 28

Records,
Operator capacity, 69 "Alarmed", 72
Operator GUI elements, 69 Searching, 76
Details window, 69 Watchlists, 81
Media Client, 69 Remove, button,
Protocol window, 69 Cargo: Logic module, 40
Report on registration number found in watchlist
P property,
Watchlists, 44
Parameter bindings property,
Report on registration number not found in watchlist
Watchlists, 43
property,
Password property,
Watchlists, 45
Database, 24
Run warping utility, button,
Port property,
Cargo: Side number recognizer, 28
Database, 24

www.issivs.com
 SecurOS Cargo 114 User Guide
Index

Exporting list, 84
S Importing list, 84
Search, Sorting list, 84
Viewing number changes history, 86
Export search results, 81
Watchlists to clear recognized container IDs property,
Self-diagnostic,
Cargo: Logic module, 39
with the Help of Health Monitor Module, 93
Write debug information, parameter,
Send results to, parameter,
Cargo: Side number recognizer, 32
Cargo: Side number recognizer, 29
Server components, 10
Settings to display archive, group of parameters, X
Cargo: GUI, 56 X, Y, W, H, parameters,
Show container image (if possible), parameter, Cargo: GUI, 57
Cargo: GUI, 58
Show recognition quality, parameter,
Cargo: GUI, 58
Show Watchlists changes history, parameter,
Cargo: GUI, 60
Special list includes, group of parameters,
Cargo: GUI, 57
Store to database, parameter,
Cargo: Side number recognizer, 32

T
Table name parameter,
Watchlists, 43
technical support,
how to get, 5
how to prepare service information, 110
Test connection,
Database, 24
Test, button,
Watchlists, 42, 44
Timeout, parameter,
Cargo: Consolidator, 35
Typcal height of number character, parameter,
Cargo: Side number recognizer, 31
Type property,
Database, 24
External database, 41

U
Use device, parameter,
Cargo: Side number recognizer, 33
User property,
Database, 24

W
Watchlists records,
Adding number to watchlist, 82
Deleting record, 84
Editing record, 82

www.issivs.com