Trazer Suite TF User Guide

User Reference Manual
for
TRAZER®SuiteTF
By
KritiKal Solutions Pvt. Ltd.
A-28, Sector 16, Noida
Uttar Pradesh – 201301
+91-120-4048600
www.kritikalsolutions.com
User Reference Manual TRAZER®SuiteTF
© Copyright KritiKal Solutions Private Limited, 2019
All rights reserved. This publication and its contents are proprietary to KritiKal Solutions Private Limited.
No part of this publication may be reproduced in any form or by any means, without the written permission
of KritiKal Solutions Private Limited. Noida, India.
KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 2 of 49

Contents
1. Introduction .............................................................................................. 5
2. Contents of the DVD ................................................................................ 6
2.1. Prerequisites ..................................................................................................... 6
2.2. TRAZER®Suite – 1.0.XXXX ............................................................................. 6
2.3. Sample Projects ................................................................................................. 6
2.4. Tutorial Videos .................................................................................................. 6
3. Installation................................................................................................. 7
3.1. System Requirements ....................................................................................... 7
3.2. Installation of Windows prerequisites ............................................................. 7
3.3. Installing TRAZER®SuiteTF software ............................................................ 7
4. Creating a new project .......................................................................... 17
4.1. What is a project ..............................................................................................17
4.2. Input options ....................................................................................................18
4.2.1. Video ....................................................................................................................18
4.2.2. Live ......................................................................................................................18
4.3. Database Configuration ...................................................................................19
4.4. Scene Configuration .........................................................................................22
4.4.1. Detection Window ...............................................................................................23
4.4.2. Homography ........................................................................................................25
4.4.3. Occupancy ...........................................................................................................26
4.5. Classifier Configuration...................................................................................27
4.5.1. Enabling / Disabling classes ...............................................................................27
4.5.2. Day Settings ........................................................................................................28
4.5.3. Night Settings .....................................................................................................29
4.6. Additional Video Settings ................................................................................32
4.7. Saving the project ............................................................................................34
4.8. Optimizing Configuration ................................................................................34
5. Processing ................................................................................................ 35
5.1. Load a project ...................................................................................................35
5.2. Start processing................................................................................................35
5.3. Pause/Stop processing ......................................................................................36
6. CFR - Collate-Feedback-Report ........................................................... 37
6.1. Introduction ......................................................................................................37
6.2. Load a project ...................................................................................................38
6.2.1. Choose the table (Video Input) ...........................................................................38
6.2.2. Choose the time range (Live Input) ...................................................................41
6.3. Delete / Reclassify ............................................................................................42
6.3.1. Deleting ...............................................................................................................43
6.3.1.1. Examples of invalid detections ........................................................................................ 43
6.3.2. Reclassification ...................................................................................................44
6.4. Add Vehicle .......................................................................................................44
6.5. Add Trajectory ..................................................................................................47
6.6. Reports ..............................................................................................................48
6.6.1. Flow .....................................................................................................................48
6.6.2. Occupancy ...........................................................................................................49
6.6.3. Trajectory ............................................................................................................49
7. Contact Us ................................................................................................ 49

1. Introduction
TRAZER® (TRaffic AnalyZer and EnumeratoR) is a technology that helps in collecting
useful traffic data catering to heterogeneous and homogeneous traffic conditions of the
developed as well as developing nations. TRAZER® provides accurate and audit-able
traffic data perfect for all traffic conditions. With excellent support and flexible service,
customization and sales model, TRAZER® is set to revolutionize traffic data collection
and analysis.
TRAZER®SuiteTF is a one stop solution to all the traffic survey and data collection
needs. It provides fast and automatic processing of both Video and Live feed (IP Camera).
TRAZER®SuiteTF is a complete package which includes a Software and Scene
Configuration module, an Automatic Traffic Counter and Classifier (ATCC) Processor
and a Collate – Feedback – Report (CFR) module.

2. Contents of the DVD
2.1. Prerequisites
This folder contains all the helping 3rd party freeware utilities and video codecs which
may be required by the user to convert videos, extract information about the video, get
live online support from the TRAZER support team. The folder also contains some
prerequisites which are installed by default on a typical Windows machine but may be
missing on a few systems sometimes.
2.2. TRAZER®Suite – 1.0.XXXX

This is the distribution folder which contains the setup file and individual installation
files. For a first time installation, the user must run setup.exe and follow the on-screen
instructions. The folder also contains a ProductDetails.txt file which should be kept
safe. This file contains the product codes that would be needed to upgrade the existing
installation or any software support. Detailed explanation about the installation
procedure is given in the next section.
2.3. Sample Projects

This folder contains a couple of sample projects and their corresponding videos. To run
these, the user must open the project file (.xml) in notepad and edit the field named
<VIDEO_FILE_NAME> to the absolute path of the video file inside the Sample Projects
folder. For example, if the Sample Projects folder was copied to C:\ drive, then the project
file will have the edited line -
<VIDEO_FILE_NAME>”C:\SampleProjects\00102_small.avi”</VIDEO_FILE_NAME>
2.4. Tutorial Videos

This folder contains tutorial videos on different stages of the TRAZER software
which have also been covered in this document.

3. Installation
3.1. System Requirements

The system requirements are as follows:
• Windows XP or 7, 32 bit operating system
• Minimum 4GB RAM
• i7 or 8-core processor for real-time processing (recommended)
• Minimum core2duo 2.0 GHz processor
• Storage space as per user requirement
3.2. Installation of Windows prerequisites

A typical Windows machine usually gets these prerequisites at the time of Windows
installation or during Windows updates. We recommend that this step should be skipped
during installation and only if TRAZER does not get installed properly or it does not run
successfully, the user should install these prerequisites. Alternatively, the user can
proceed with this step anyway and be on the safer side. We leave that decision upto the
user.
The system should have internet connection. We highly recommend the user to run
Windows Update before installing the prerequisites. After windows update, the
prerequisites have to be installed in the following order:
• Dot Net Framework (dotnetfx.exe)
• DirectX SDK (dxwebsetup.exe) – This is a web installer for which the user must
ensure that the computer is connected to uninterrupted source of internet.
Additionally, for the video codec support, following softwares are required:
• Divx Codec (DivXPlay.exe)
• XVID Codec (Xvid-1.3.2-20110601.exe)
• FFDSHOW DirectShow Filters (ffdshow_rev4489_20121025_clsid.exe)
3.3. Installing TRAZER®SuiteTF software

For a first time installation on the machine, the user must run setup.exe and follow the
on screen instructions. If the user is installing TRAZER on the windows machine for the
first time, the user will be prompted with the following screen:

The 3 listed softwares,

• HASPUserSetup
• OpenSSL
• PostgreSQL
are necessary for TRAZER to work and are hence installed before installing TRAZER.
Each of these 3 installations are explained briefly as follows.
HASPUserSetup
1. If there is an older version of HASP drivers on the system, there will be a warning
message shown as below which the user should accept and click on “Yes”

2. Navigate till there is a screen for End User License Agreement (EULA). The user
must accept the terms and click on Next
3. Finally after the installation, the setup shows a message that port number 1947 is
used for communication. The user must ensure that this port is not being used by
another software / service and is not blocked by the windows firewall.
OpenSSL
1. Navigate by clicking on Next till the setup asks for the destination location. The
user should choose the default location as suggested by the setup as shown below.
2. In the next screen the user must select the option of “The Windows system
directory”. By selecting this option, the setup will install all the necessary
libraries in the windows system folder so that the user does not have to manually
set the PATH environment variable for OpenSSL libraries.
3. On the final screen when the installation of OpenSSL completes, uncheck the
option for donation and click on “Finish”.

PostgreSQL
1. Navigate by clicking on Next till the setup asks for the Installation Directory. The
user should choose the default location as suggested by the setup as shown below.
2. On clicking next the setup will ask the user for Data Directory. The user should
again choose the default location as suggested by the setup and click on Next.

3. If there was already an existing installation of PGSQL found on the system, the
setup will display a warning message as shown below. The user must click Next.
4. On clicking next, the setup will ask the user to set up a password. We recommend
using “postgres” as the password as it becomes a generic password for all TRAZER
users.

5. Click on Next and wait for the installation to complete. On the final screen,
“uncheck” the option for Stack Builder and click on Finish.
TRAZER®Suite
1. Navigate till the setup asks for the installation folder. The user should avoid
selecting the Program Files or Windows folder as it requires administrative
privileges to write anything into this folder. It is strongly recommended to choose a
location which is open to all users of the system and has write permissions, for eg:
C:\ drive.
2. Proceed with the rest of the installation till it completes.

As a final step of TRAZER installation, the user has to manually edit the PATH
environment variable and add the location of PostgreSQL libraries. The steps to do that
are as follows:
1. Click on Start Menu button, Navigate to My Computer, Right Click on that and
select Properties
2. On the properties window, click on Advanced System Settings link on the left
panel. A new window named System Settings will open with Advanced tab
selected. There is button titled “Environment Variables” at the bottom of this
window. Click on this button.

3. In the Environment Variables window, search for the variable – PATH or path,
and double click on that.
4. In the Edit System Variable window, in the Variable Value field, add a semi colon
at the end and then add the location of the PostgreSQL bin folder as shown in the
image. The location may vary depending upon what the user had specified as the
location at the time of installation of PostgreSQL.
5. Click on OK (Edit System Variable), OK (Environment Variables) and then Apply

(System Properties).
On successful installation, TRAZER®Suite group is created in Start Menu->All
Programs. If the above steps were followed correctly and the USB License dongle is
plugged into the system, the user should be ale to run TRAZER modules.
On successful installation, appropriate icons will be created in the Start Menu and the
installation will be done in the user specified folder at installation time. This folder
contains the TRAZER®SuiteTF software libraries and executable. The contents of this
folder are as follows:
• TrazerProcessorConsole.exe – The processing binary for console mode. To run
this binary, the user should open a command prompt and navigate to the
TrazerSoft folder. At the command prompt, type TrazerProcessorConsole.exe
<path to project file> and press enter. If the project file path is not specified,
then the binary assumes that there is a default project file name project.xml in the
same folder.

• TrazerProcessorGUI.exe – The processing module with Graphical User

Interface. Its usage has been discussed in details in later sections.
• TrazerCfrGUI.exe – The CFR module. Its usage has been described in details in
the section on CFR.
The software works on projects that need to be created as a starting step. The next
section describes the concept of projects.

4. Creating a new project

The first step in TRAZER®SuiteTF is creating a new project. To create a new project, run
TrazerProcessorGUI.exe. On the main screen under Project tab (shown in figure
4.1), there are two buttons namely – New (video) and New (live) (if Live feed (IP
Camera) is enabled in the software license of TRAZER®SuiteTF).
Figure 4.1: Main screen (Trazer_UI.exe)
4.1. What is a project

A project in TRAZER®SuiteTF is a configuration file in XML format that encapsulates
various parameters and flags used by the processing module to process the video and
store the data. The project configuration contains database, classifier and scene
configurations. It is analogous to a survey site in the real world. For example,
Akshardham flyover is one location in Delhi where we keep recording videos for testing.
This location would correspond to a single project file in TRAZER®SuiteTF. If the scene
changes, there needs to be a new project for the new scene. A scene will change if the
location changes or if the camera positioning on the same location changes.

There are two modes of input for a project which are explained below.
4.2. Input options
4.2.1. Video
Video mode assumes an AVI video file as input. On clicking the New (video) button, a
file browser window will open. Browse to the location where the AVI file is located, select
it and then click on Open. Once the video is selected, a new window for database
configuration will pop-up.
4.2.2. Live
On clicking New (live), a small window for IP Camera configuration pops up as shown
below.
Figure 4.2: IP Camera Configuration Screen
Enter the IP Address, Username and Password in their respective fields and select
the Camera type from the drop down list. Currently we support only two brands of
IP Cameras – Samsung and AXIS . When done, click on “Ok” and a new window for
database configuration will pop-up.

4.3. Database Configuration

Once the input source has been selected, next step is to provide the PostgreSQL database
authentication details which are required by the processor to store the results. The DB
Authentication window is shown in figure 4.3 below.


Figure 4.3: Database Configuration Window
The database parameters have default values as shown in the figure. If default values
were chosen during the installation of PostgreSQL, then don't change these values.
Location Name corresponds to the real world location. It could be the locality name,
street name or the name of any popular landmark near the survey site.
Location ID is a numeric ID which is unique for this particular project. It could be the
datestamp (YYMMDD) or a combination of date, time, camera number, etc. This ID must
be unique.

Once all the fields have been filled, click on OK. If the database authentication details
are correct, a message – “Database Connected” pops up as shown below. Click on OK.
Figure 4.4: Database Connected
If the video / live feed gets initialized properly, the first frame of the video is displayed or
live video stream starts playing on the video panel of the Main Screen. At this point, a
basic project is ready, with input and database configured.
4.4. Scene Configuration

In order to configure the scene, it is recommended to play and pause the video at a
frame where there is lesser traffic. In case of live feed, wait until the live traffic
becomes sparse and then click on Settings tab. On clicking the Settings tab, the
video frame at that moment is captured and is used to define different scene parameters.
That is why it is important to ensure that the most appropriate frame is being used for
Scene configuration. Under the Settings tab, there are two buttons – Classifier and
Scene.
Figure 4.5: Settings Tab

On clicking the Scene button, a new screen opens up as shown below. (Figure 4.6)
There are three buttons under Scene Configuration tab which are described next.
Figure 4.6: Scene Configuration Screen
The current Mouse Position gets updated just below the image panel as shown in the
figure above.
4.4.1. Detection Window

This is used to define a sub-region of the video frame where the user wants to detect
vehicles. The objective is to define a region such that:
• All the lanes of the road lie inside the detection window
• If the opposite side traffic is also visible in the video, then the region is drawn such
that it excludes that traffic as much as possible.

To define the detection window, click on Detection Window button. Now left-click
the mouse to select the top-left corner of the desired detection window. Now
keeping the mouse pressed, drag the mouse diagonally towards bottom right and
release the mouse press at the desired bottom-right corner of the detection window.
Figure 4.7: Setting Detection Window
To save this detection window, click on Apply and then click on Close. To re-draw the
window, click on Close , then click on Detection Window button.

4.4.2. Homography
Homography defines the mapping between the image and world points. To establish this
mapping, the user needs to click 4 points on the road in a specific order as shown in the
image below.
Figure 4.8: Setting Homography
As shown in the image above, the order in which four points have been clicked is –
Bottom-Left (point 1), Top-Left (point 2), Top-Right (point 3) and Bottom-Right
(point 4). On clicking these four points, the right panel of the screen will capture the
Image Coordinates (as shown in the figure above). The user must know the road
dimensions in actual enclosed within these four points. If the width of the road is W
meters and the length of the road is L meters inside the four points, then the
world coordinates will be Bottom-Left [0, 0], Top-Left [0, L], Top-Right [W, L]
and Bottom-Right [W, 0].

To save the homography, click on Apply and then click on Close. To redo the
homography, click on Close, then click on Homography button.
4.4.3. Occupancy
For Occupancy, the user is required to mark two points on the road in the direction of the
traffic flow. Occupancy is the time spent ( in seconds ) by each vehicle between these two
points. The points are marked as shown in the figure below.
Figure 4.9: Setting Occupancy Points
Please make sure that point 1 is above point 2 as the traffic flow is always assumed to be
towards the camera. Also, make sure that the two occupancy points lie entirely
within the detection window.
To save the occupancy points, click on Apply and then click on Close. To re-draw the
occupancy points, click on Close, then click on Occupancy button.

To exit the Scene Configuration screen, click on the Back button.
4.5. Classifier Configuration

After setting up the Scene settings, click on the Classifier button under Settings tab.
The classifier settings has been further subdivided into Day and Night settings. The
software applies different logic for processing day and night traffic hence the user is
required to set the day and night settings separately.
4.5.1. Enabling / Disabling classes

Just below the Classifier Configuration tab, there are four check buttons for enabling /
disabling LMV, Auto, HMV and TW respectively. By default all four classes are enabled.
To disable a class, uncheck the corresponding box.
Figure 4.10: Classifier Enable/Disable Panel

4.5.2. Day Settings

In Day settings, the user is required to enter 3 values for each class – Min Width, Max
Width and Min Move.
Figure 4.11: Classifier Settings for Day
Min Width – The minimum width in meters of the vehicle of that class.
Max Width – The maximum width in meters of the vehicle of that class.
Min Move – In order to make sure that a detected vehicle is a valid vehicle and not a
false positive, the software monitors the displacement of each detection and accepts it as
a valid vehicle detection only if it has moved by a minimum threshold distance in
meters. The Min Move provides that threshold distance. A lower value of this threshold
may result in too many false positives, while a high value may result in accurate
detections but may miss many vehicles.

4.5.3. Night Settings

Night Settings are different from Day Settings since the software uses a different logic
for detection and classification for night videos.
Headlight Size – Objective is to specify minimum and maximum size of a headlight (in
pixels). Bright spots in the scene which do not pass these thresholds are treated as
outliers and not considered a valid headlight.
Minimum Votes – Since both an Auto and a Two Wheeler have a single headlight, the
software internally runs a voting algorithm to resolve this conflict. In this voting
technique, it first collects votes for both Auto and TW, then it first checks if the Auto
votes are greater than the Min Votes for Auto. If it passes this, the vehicle is
classified as an Auto, else it checks if the TW votes are greater that the Min Votes
for TW. If it passes, the vehicle is classified as TW else it is rejected.
HL (Headlight ) Threshold – Since LMV and HMV both have two headlights, this
threshold in meters helps the software resolve the LMV vs HMV conflict. If the distance
between the two headlights is less than HL Threshold, it is a LMV, else it is a
HMV.
Gamma Value – To internally improve the brightness of the night video frame, the
software uses this gamma value. By default this value is set to 0.001 and we recommend
that the user does not change this value unless very confident about the implications.


Figure 4.12: Classifier Settings for Night
Since the night time processing is in beta release, we recommend the user to use these
default settings and try to change them only in case of a good understanding of these
parameters.
Once done, click on Apply and then press the Back button.

4.6. Additional Video Settings
At this stage, the system is almost done with creation of the project and ready to save it
to an XML file. For video inputs, additionally the user can also specify a section of the
video to be processed.


Figure 4.13: Media Player Panel
The figure above shows a typical media player panel for video inputs.
Start / End Markers: There are two gray triangles just below the video slider. These
are the markers for the start and end position of the video that would be processed. By
default these point to the start and end of the video respectively.
Setting the start / end marker: On the bottom left of the panel, there are two orange
broken staple buttons and a red cross next to it. The left orange button is to set
the start of the video section. The right orange button is to set the end of the video
section. And the red cross is to reset the markers to the start and end of the input
video.
To seek to the desired position of the video, the user can either play the video or drag the
blue rectangle on the video slider.
4.7. Saving the project

To save the current project, click on Save under Project tab. A file browser window will
open, where the user can browse to the desired location to save the project file. As a
suggestion, in case of video input, we recommend using the video name as the
project name too. For example, if the name of the video is DVD4_000000_005959.avi,
then the corresponding project file name is DVD4_000000_005959.xml. For live feed, we
recommend using the following convention for the name of the project :
LocationName_LocationID.xml
4.8. Optimizing Configuration

For new users, it is not easy to get the project configuration perfect in the first attempt
itself. It involves experiments with different values and parameters before coming to an
optimal configuration. To perform multiple iterations of parameter tuning, what we
suggest is that once the user has configured all parameters, save the project. Now go to
the Process tab and start the processing and observe the results (detections). If satisfied,
go ahead and save the project if not already saved and close the project. Else, tweak the
classifier settings and / or scene settings and again start processing. The user must
repeat this loop until satisfied with the results. Finally save the project again and close.
5. Processing
Once the project has been created, processing the video is simple. If the project is not
already loaded, the user first needs to load a project.
5.1. Load a project

Under the Project tab, click on Load button. A file browser will open where the user can
locate the project XML file and click on Open. If the project file loads successfully, the
user will be able to see the starting frame of the video or in case of live feed, the screen
will start showing the live camera feed.
5.2. Start processing

On successful loading of the project, click on the Process tab and under this tab, click
on the Start button to start processing. As soon as the processing starts, the video
frame turns to gray-scale instead of colored, and the detection window would be
shown highlighted compared to the other region of the video frame. Lastly, the
occupancy region would be marked by two horizontal red lines passing through
the occupancy defined by the user. (Refer to the image below)

Figure 5.1: TRAZER Processing
The right panel shows a table titled Vehicle Counts. It has three columns. First column
displays the vehicle class, the second column displays the current instant count of
vehicles of each class while the third column shows the total count of vehicles of each
class.
5.3. Pause/Stop processing

Option to Pause the processing is only available in Video input since a Live feed
processing cannot be paused. To pause the video processing, click on the Pause
button under Process tab.
To stop the processing, click on Stop button under Process tab. Once the processing
stops, the video initializes itself to the starting frame while live feed resumes in color.
The counts on the right panel do not reset until the user starts processing
again. This is to allow the user to note the readings after stopping the processing.

6. CFR - Collate-Feedback-Report
6.1. Introduction
CFR stands for Collate-Feedback-Report. This module allows the user to refine the
processed data and get above 95% accuracy with ease. Along with refining the processed
data, it also allows the user to play back the annotated video and generate flow,
occupancy and trajectory reports for further analysis. CFR is an art which a user masters
with practice.
Figure 6.1: CFR Main Screen

6.2. Load a project

The first step of the CFR is to load a project. The user should load a project which has
already been processed. To load a project, click on the Load button and choose the
desired project XML file from the file browser and click Open.
6.2.1. Choose the table (Video Input)

If the input type for the project is Video, then the user gets a pop up which looks like one
shown in the image below.
Figure 6.2: Choosing transaction in Video CFR

The Location field shows the location name / location ID from the project
configuration file. The next field Table Names is a drop down list showing all the
transactions for this particular project. The transaction Id follows the following
naming convention - locationID_yyyy_mm_dd_hour_min_sec. The same transaction
id is used as a suffix to create tables in the database. The transaction id, as can be
observed, contains all the information about when was the project processed.
Usually a user would want to refine the latest processed data. That is why in the image
above, we select the latest table, appearing last in the list.
Figure 6.3: Time duration for chosen transaction
A common question is why would a single project have multiple transactions. Remember
that we suggested multiple trials of processing to achieve optimal project configuration.
Each processing is an individual transaction for the project, therefore creating new tables
in the database.

There are other reasons too why a project may have multiple transactions which the user
would realize while getting more familiar with the software usage and application.
Once the user has chosen the appropriate table, the other two fields can be ignored. The
last two fields are From and To timestamps which give the start and end time of the
video that has been processed. It is highly unlikely the user would want to manually
change these time ranges. Sometimes it is difficult to remember the exact time of the
transaction which makes it difficult to choose a specific transaction from the drop down.
In such cases, the time range helps the user to select the correct transaction.
After choosing the table, click on Ok.

6.2.2. Choose the time range (Live Input)

If the input type for the project is Live, then the user gets a pop up which looks like one
shown in the image below.
Figure 6.4: Time-range for Live CFR
Compared to Video feed, here there is no drop down to select a particular transaction.
Instead, the user is required to enter a time range between which he/she wants to
analyze the processed data. The live feed is a continuous feed so a transaction is capable
of running for multiple days at a stretch. In case the processing continues for more than
24 hours, the system internally creates a new transaction ID for each day to keep the
data more organized and to avoid over loading of a single database. Therefore, for live
feed the user cannot be asked to select a single transaction like in the case of Video feed.
As shown in the image above, enter the time stamp values in the correct format. The
format is very important so make sure it is followed correctly. When done, click on Ok.

Once the project has been loaded successfully and appropriate transaction / time-range
has been specified, the UI should display the starting frame of the video and in case of
Live feed it would show a blue screen. This means that the database has been found for
the loaded project and the system is ready to assist the user to analyze and refine the
processed data.
Click on Feedback tab and then click on Show Rectangles (the text on the button
changes to Hide Rectangles). This enables drawing of detection boxes around vehicles in
the corresponding color for each class. Red for LMV, Blue for Auto, Green for HMV
and Yellow for Two Wheeler.
6.3. Delete / Reclassify

Though the user may choose to first add the missing vehicles and then delete / reclassify
the wrong ones, but we strongly suggest to follow the order of Delete-then-Reclassify-
then-Add. The reason is that with Delete and Reclassify happening first, most of the
false detections get removed and now when the user plays back the processed data, it is
much easier to catch the undetected vehicles.
Figure 6.5: Delete / Reclassify Screen

To start with this process, click on Delete / Reclassify button under Feedback tab.
After a few seconds, a new screen would open that looks like the image shown above.
6.3.1. Deleting
As shown in the image, there are 4 tabs at the top for 4 classes. For each class, there are
20 thumbnails per page and at the bottom of the screen, there are navigation buttons to
get to the next / previous pages.
The strategy is to go page by page for each class. Start scanning from the first row
from left to right , and click on any image that is not a valid detection and then
click on Delete button. The user can also select multiple images. To de-select any image,
click on it again. Once all the invalid images are selected for the entire page, click
on Delete and then click on Commit. The next page will automatically become
number 1 and the user repeats the same strategy for each page.
After all the pages for one class have been scanned, move to the next class. Once all
classes have been scanned for invalid detections, click on Export button which
saves everything back to the database. After export has been done, the system goes back
to the main screen.
If the user clicks on Export by mistake, all refinements till that stage are saved to the
database and the user can start Delete / Reclassify again for the remaining.
6.3.1.1. Examples of invalid detections
As a thumb-rule, we recommend the users to consider the following kinds of detections as
invalid.
• Frontal face of the vehicle is not captured (167)
• Only partial vehicle visible in the detection image (75)
• More than one vehicle present in the detection image (265)
• Vehicle is too small compared to the detection image
(662) In figure 6.6, all selected vehicles are invalid detections.

Figure 6.6: Invalid Detections
6.3.2. Reclassification
Reclassification is similar to Deletion process. In fact, once the user gets familiar with the
interface, he/she can delete and reclassify simultaneously. For starters, we still
recommend Deleting first, then Reclassifying in the second iteration. To Reclassify, click
on Delete/Reclassify button. The interface is the same as for Delete. This time, scan each
page row by row from left to right, select a detection that belongs to a different
class, then click on the respective classifier button on the top tight panel labeled
Re -Classify. Once a page is scanned completely, click on Commit. Once all pages for
all classes are scanned, click on Export.
6.4. Add Vehicle

Once Deletion / Reclassification is done and the user is back on the main screen, click on
Add Vehicle under Feedback tab and make sure Show Rectangles button is
enabled (if the text on the button is Hide Rectangles, then Show Rectangles is enabled).
On clicking Add Vehicle, a small panel labeled Add comes on bottom right panel of the
main screen.

Figure 6.7: Add Vehicle Interface
Before we explain the panel, lets list down the steps to add a missing vehicle. To add a
vehicle:
• Play the video

• Find an undetected vehicle
• Pause the video
• Choose the appropriate classifier from Add panel
• Draw a box around that vehicle
• Click on Save button.

Following the above steps will ensure that the user has added all the undetected vehicles
but this would consume a lot of time. Playing the entire video will at least take the same
time as the duration of the video. Based on our experience, we have devised a simple
strategy to add missing vehicles which is not only reliable, but also saves time.
Firstly, we never play the video. Instead, we use the forward and rewind buttons
to navigate through the video. And to make the navigation fast, we set the Frame
Incrementer value to 20 or 25 (max). Since usually all videos are recorded at 25 fps,
setting the frame incrementer to 25 means that with every click on the forward / rewind
button, the video jumps 1 second forward or backward.
While navigating using the forward/rewind buttons, the vehicle counts also change
in the table on the top right panel. This means that even with a high frame incrementer,
if a vehicle gets detected but does not show up on the image, the vehicle counts will still
change and this would indicate to the user that the vehicle did not actually get missed.
Having said that, a frame incrementer value of 20 ensures that all detections are shown
in the image majority of times. Also, the frame number is displayed on the title bar
of the main screen.
While navigating if a vehicle is found undetected, then add the vehicle at its exit
point. That is, navigate to that position after which the vehicle exits the scene and add
the vehicle at this position. This is very important as it ensures that we have looked at
the complete vehicle trajectory before concluding that it got missed. This minimizes
chances of double detections.
Hence, a better faster strategy to add vehicles:

• Set the frame incrementer to 20 or 25
• Reset the video slider position to frame 0
• Enable Show Rectangles
• Use forward / rewind button to navigate
• Add the undetected vehicle at its exit point.
• After every short while, keep clicking on Save button.
Even in Add vehicle interface, the user can delete a vehicle. To do so, right click
on the vehicle and then press 's' on the keyboard. A right click on the vehicle
turns the box boundary to dotted lines indicating that it has been selected. To cancel
the right click, press ESC key on the keyboard. Why we choose letter 's' for deletion is
because of the other keyboard shortcuts which are designed to be as a group on the
keyboard so that the fingers can move quickly to these keys.

Lastly, the keyboard shortcuts to make the entire activity even faster are as follows:
• Forward – 'd' on keyboard

• Rewind – 'a' on keyboard
• Delete – 's' on keyboard
• Select LMV – 'q' on keyboard
• Select AUTO – 'w' on keyboard
• Select HMV – 'e' on keyboard
• Select TW – 'r' on keyboard
• Save – 'CTRL + s' on keyboard
6.5. Add Trajectory

Adding trajectory for a particular vehicle helps to improve its speed calculation and also
in trajectory analysis. The strategy is pretty much the same as discussed for Adding
vehicle. To add trajectory, click on Add Trajectory button and the Add panel will change
to look like the image below.
Figure 6.8: Add Trajectory Interface

The steps to add trajectory are as follows:

• Enable Show Rectangles
• Set the Frame Incrementer to 10 or 15 (ideal, could be different)
• Navigate and select a vehicle by clicking inside its box. The text box below Selected
Vehicle ID will show the vehicle ID of the selected vehicle.
• Click on Draw button
• Navigate through forward / rewind button on those frames where vehicle is not
detected.
• Draw boxes around the selected vehicle.
• When finished drawing the trajectory, click on Save button
• To cancel, click on Discard button.
6.6. Reports
1. Finally, when all the refinements and manual corrections have been done, the user can
save reports of the processed data. The software allows three different reports. All the
reports are saved in .csv file format (comma separated value) which can be easily
exported in Microsoft Excel and other spreadsheet softwares for further data analysis.
6.6.1. Flow
The flow report is an interval wise report of traffic volume per class, average speed per
class, average occupancy per class and traffic congestion.
Countsts
.No. Start Time End Time LMV AUTO HMV TW
S. . t rt i i
Averager Speed
LMV AUTO HMV TW
Occupancy
LMV AUTO HMV TW
To save the flow report, click on Flow button under Reports tab and save the file at the
desired location.

6.6.2. Occupancy
Occupancy report gives vehicle wise details which are described in the image below
.No. Vehicle_ID Type Occupancy Avg. Speed
S. . icle ID cc cy .
To save the Occupancy report, click on Occupancy button under Reports tab and save the
file at the desired location.
6.6.3. Trajectory
This report shows the trajectory of each detected vehicle on the road. It gives frame wise
data for each vehicle.
Framer No.. Type Vehicleile IDID
X1 Y1 X2 Y2 WC_X WC_Y
To save the Trajectory report, click on Trajectory button under Reports tab and save the
file at the desired location.
7. Contact Us
For any support related queries, please write to support.trazer@kritikalsolutions.com

Trazer Suite TF User Guide

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Trazer Suite TF User Guide

Uploaded by

Copyright:

Available Formats

User Reference Manual

© Copyright KritiKal Solutions Private Limited, 2019

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 2 of 49

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 4 of 49

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 5 of 49

2. Contents of the DVD

2.2. TRAZER®Suite – 1.0.XXXX

2.3. Sample Projects

2.4. Tutorial Videos

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 6 of 49

3.1. System Requirements

3.2. Installation of Windows prerequisites

3.3. Installing TRAZER®SuiteTF software

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 7 of 49

The 3 listed softwares,

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 8 of 49

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 10 of 49

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 11 of 49

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 12 of 49

2. Proceed with the rest of the installation till it completes.

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 13 of 49

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 14 of 49

5. Click on OK (Edit System Variable), OK (Environment Variables) and then Apply

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 15 of 49

• TrazerProcessorGUI.exe – The processing module with Graphical User

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 16 of 49

4. Creating a new project

Figure 4.1: Main screen (Trazer_UI.exe)

4.1. What is a project

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 17 of 49

4.2. Input options

Figure 4.2: IP Camera Configuration Screen

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 18 of 49

4.3. Database Configuration

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 19 of 49

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 20 of 49

Figure 4.3: Database Configuration Window

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 21 of 49

Figure 4.4: Database Connected

4.4. Scene Configuration

Figure 4.5: Settings Tab

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 22 of 49

Figure 4.6: Scene Configuration Screen

4.4.1. Detection Window

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 23 of 49

Figure 4.7: Setting Detection Window

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 24 of 49

Figure 4.8: Setting Homography

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 25 of 49

Figure 4.9: Setting Occupancy Points

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 26 of 49

To exit the Scene Configuration screen, click on the Back button.

4.5. Classifier Configuration

4.5.1. Enabling / Disabling classes

Figure 4.10: Classifier Enable/Disable Panel

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 27 of 49

4.5.2. Day Settings

Figure 4.11: Classifier Settings for Day

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 28 of 49

4.5.3. Night Settings

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 29 of 49

KritiKal Solutions Pvt. Ltd. - Confidential & Proprietary 30 of 49

Figure 4.12: Classifier Settings for Night