aboutsummaryrefslogtreecommitdiff
path: root/src/argaze/utils/README.md
blob: d5af45a8b8a84db9c44be1f3f71eedf642b65770 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
Collection of command-line high level features scripts.

!!! note
      *Consider that all inline commands below needs to be executed into ArGaze root folder.*

!!! note
      *Use -h option to get command arguments documentation.*

# ArUco Markers factory

Export all markers from *DICT_APRILTAG_16h5* dictionary as 5 cm pictures with 300 dpi resolution into an *./src/argaze/utils/_export/markers* folder:

```
python ./src/argaze/utils/aruco_markers_dictionary_export.py DICT_APRILTAG_16h5 -s 5 -r 300 -o ./src/argaze/utils/_export/markers
```

Export a 7 columns and 5 rows calibration board made of 5cm squares with 3cm markers from *DICT_APRILTAG_16h5* dictionary at 300 dpi into an *./src/argaze/utils/_export* folder:

```
python ./src/argaze/utils/aruco_calibration_board_export.py 7 5 5 3 DICT_APRILTAG_16h5 -r 300 -o ./src/argaze/utils/_export
```

# Camera calibration

Calibrate a camera device (-d DEVICE) using a 7 columns and 5 rows calibration board made of 5cm squares with 3cm markers from *DICT_APRILTAG_16h5* dictionary. Then, export its optical parameters into an *calibration.json* file into *./src/argaze/utils/demo_environment/* folder:

```
python ./src/argaze/utils/camera_calibrate.py 7 5 5 3 DICT_APRILTAG_16h5 -d DEVICE -o ./src/argaze/utils/demo_environment
```

!!! note
      Use **A3_DICT_APRILTAG_16h5_3cm_35cmx25cm.pdf** file located in *./src/argaze/ArUcoMarkers/utils/* folder ready to be printed on A3 paper sheet.

# AR environment demonstration

Load AR environment from **setup.json** file, detect ArUco markers into camera device (-d DEVICE) frames and estimate envirnoment pose.

```
python ./src/argaze/utils/demo_ar_features_run.py -d DEVICE
```

!!! note
      This demonstration assumes that camera calibration step is done and a **calibration.json** has been exported into *./src/argaze/utils/demo_environment/* folder.

!!! note
      Use **A3_demo.pdf** file located in *./src/argaze/utils/demo_environment/* folder ready to be printed on A3 paper sheet.

# Gaze features demonstration

Simulate gaze position using mouse pointer to illustrate gaze features.

```
python ./src/argaze/utils/demo_gaze_features_run.py
```

# Heatmap demonstration

Simulate gaze position using mouse pointer to produce heatmap picture.
A picture is saved by pressing escape key.

```
python ./src/argaze/utils/demo_heatmap_run.py
```