Skip to content

User Manual

RomanN91 edited this page May 12, 2019 · 6 revisions

Quick Start

Every mark up task starts with loading a video. Now we support video set as a bunch of images in lossless format '.png' - that is an usual use case because that's how tracking algorithms are usually trained to avoid training on lossy compressed videos. First of all press 'Load Video' button and choose the video in the dialog window. Our program is shipped with the test video from MOT dataset set as a bunch of image frames, it can be found in your build directory at 'data/test/MOT16-04/img1/'. You can download additional test video files at the link.

Loading Video

Our program has two 'View Panels' for convenient work with time domain medium such as video. You can choose which viewport shows the needed moment of time with the 'Time Sliders' on the right panel. Then you can scroll through time while keeping time lag between the two panels using 'Simultaneous Navigation' on the left panel.

Preview and Time navigation

To get the automatically marked up tracks press 'Run Object Detection' button. After a while the viewports will display the detected detections and tracks. The same color corresponds to the same ID attached to different detections. A bunch of detections with the same ID forms a track.

Run Automatic Mark Up

We've got marked up tracks! Finally save them. You can come back and refine them later.

Save

Manual Refinement of Detections

To help user on refining automatic tracks mark up and speed up the process we came up with the 'Refine Panels' on the right. They contain the most tools you need to refine the tracks in short amount of time.

We can select a bounding box at each view port by simply clicking on it twice in 'Select' mode. It's important to know which bounding box the tools are applied to.

Refinement Panel

Delete Track

We can simple delete the wrong track by selecting the corresponding bounding box and then pressing 'Delete Track' button on the right.

delete_1

delete_2

Add Bounding Boxes and Interpolate between them

To add a new BBox press the 'Add new bounding box' button and then drag your cursor while pressing left mouse's button over the region where you want your BBox. Every new BBox is just a new track consisted of one detection and is assigned a new ID.

Add BBox

Select the BBoxes you want to interpolate between while in 'Select' mode.

Select New Bboxes

Then just press 'Interpolate' on the right tools panel. You can Interpolate between two BBoxes with different ID, then first they are United into one Track and next they interpolated.

Interpolate

Delete BBox

Let's assume you drawn BBox in the wrong place. Let's simply delete it by selecting and then pressing 'Delete bounding box'

Delete BBox

Split Track

Select BBox at the frame you want to split the track at and then press 'Split' button.

Split_1

The track becomes two with different IDs.

Split_2

Unite Tracks

To unite two tracks select them and then press 'Unite'.

Unite_1

The two tracks now are united into one the BBoxes are assigned the same ID.

Unite_2

Using Load to refine tracks later

After you loaded the video you load precomputed tracks to refine the mark-up.

Load 1

Finally you got the mark-up that you can refine now.

Load 2

Install from Sources

Clone this wiki locally