comparison scripts/nomad/README.md @ 1186:7117a31555c1

Etienne Beauchamp s work on optimization with Nomad software
author Nicolas Saunier <nicolas.saunier@polymtl.ca>
date Tue, 21 Jun 2022 17:06:06 -0400
parents
children
comparison
equal deleted inserted replaced
1177:aa88acf06876 1186:7117a31555c1
1 # Optimization tool
2
3 ----
4 ## usage
5 1. Make sure your data is structured like so:
6 ```
7 Data # Folder containing all the data
8 └── <Intersection name> # Intersection (e.g. montcalm-chartwell)
9 ├── <tracking configuration file>.cfg
10 ├── <Date 1>
11 │ ├── <Other subdirectories> # There can be as many subdirectories as you want
12 │ ├── <Video 1>
13 │ ├── <Ground truth database 1>_gt.sqlite
14 │ ├── homography.txt
15 │ ├── image.pg
16 │ ├── mask.png
17 │ └── point-correspondences.txt
18 ├── <Date 2>
19 └── <Date 3>
20 .
21 .
22 .
23 ```
24
25 > Please note : You should have at least one ground truth database (with a name ending with "_gt.sqlite") for each date of the intersection.
26
27 2. Select an intersection or several intersections for which you wish to find optimal tracking parameters, for instance:
28
29 $ python3 optimize-with-nomad.py -t /media/disk2/etienne/Data/montcalm-chartwell/ /media/disk2/etienne/Data/montcalm-victorin/ --optimize-grouping-only
30
31 > Please note : You cannot find the optimal parameters only for the grouping algorithm if there is not a database already created. You should first execute the tracking algorithm with basic parameters.
32
33 3. Once the optimal parameters are found, tracking may be launched:
34
35 $ cd $HOME/Data/montcalm-chartwell
36 $ feature-based-tracking tracking-visible.cfg --tf --video-filename 2019-11-27/Visible/2019-11-27T12\:20-05\:00.MP4 --database-filename 2019-11-27/Visible/2019-11-27T12\:20-05\:00.sqlite --homography-filename 2019-11-27/Visible/homography.txt --mask-filename 2019-11-27/Visible/mask.png --feature-quality 0.1 --min-feature-distanceklt 3.54964337411 --window-size 6 --min-tracking-error 0.01 --min-feature-time 15
37 $ feature-based-tracking tracking-visible.cfg --gf --video-filename 2019-11-27/Visible/2019-11-27T12\:20-05\:00.MP4 --database-filename 2019-11-27/Visible/2019-11-27T12\:20-05\:00.sqlite --homography-filename 2019-11-27/Visible/homography.txt --mask-filename 2019-11-27/Visible/mask.png --mm-connection-distance 2 --mm-segmentation-distance 1.9 --min-nfeatures-group 4
38