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
64
65
66
67
68
69
70
71
|
Add Heatmap
===========
Heatmap is an optional [ArFrame](../../argaze.md/#argaze.ArFeatures.ArFrame) pipeline step. It is executed at each new gaze position to update heatmap image.
## Enable ArFrame heatmap
[ArFrame](../../argaze.md/#argaze.ArFeatures.ArFrame) heatmap visualization can be enabled thanks to a dedicated JSON entry.
Here is the JSON ArFrame configuration file example where heatmap visualization is enabled:
```json
{
"name": "My FullHD screen",
"size": [1920, 1080],
...
"heatmap": {
"size": [320, 180],
"sigma": 0.025,
"buffer": 0
}
}
```
Then, here is how to access to heatmap object:
```python
# Assuming an ArFrame is loaded
...
print("heatmap:", ar_frame.heatmap)
```
Finally, here is what the program writes in console:
```txt
heatmap: Heatmap(size=[320, 180], buffer=0, sigma=0.025)
```
Now, let's understand the meaning of each JSON entry.
### Size
The heatmap image size in pixel. Higher size implies higher CPU load.
### Sigma
The gaussian point spreading to draw at each gaze position.
### Buffer
The size of point spread images buffer (0 means no buffering) to visualize only last N gaze positions.
## Export heatmap to PNG file
Once timestamped gaze positions have been processed by [ArFrame.look](../../argaze.md/#argaze.ArFeatures.ArFrame.look) method, it is possible to write heatmap image thanks to OpenCV package.
```python
import cv2
# Assuming that timestamped gaze positions have been processed by ArFrame.look method
...
# Export heatmap image
cv2.imwrite('./heatmap.png', ar_frame.heatmap.image)
```
|
