blob: 2814d75d8d0af91ce61a5205d68313ec4f26016a (
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
"""Explore/Explore ratio module.
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program. If not, see <http://www.gnu.org/licenses/>.
"""
__author__ = "Théo de la Hogue"
__credits__ = []
__copyright__ = "Copyright 2023, Ecole Nationale de l'Aviation Civile (ENAC)"
__license__ = "GPLv3"
from dataclasses import dataclass, field
from argaze import GazeFeatures, DataFeatures
import numpy
@dataclass
class ScanPathAnalyzer(GazeFeatures.ScanPathAnalyzer):
"""Implementation of explore vs exploit ratio algorithm as described in:
**Dehais F., Peysakhovich V., Scannella S., Fongue J., Gateau T. (2015).**
*Automation surprise in aviation: Real-time solutions.*
Proceedings of the 33rd annual ACM conference on Human Factors in Computing Systems (2525–2534).
[https://doi.org/10.1145/2702123.2702521](https://doi.org/10.1145/2702123.2702521)
"""
short_fixation_duration_threshold: float = field(default=0.)
"""Time below which a fixation is considered to be short and so as exploratory."""
def __post_init__(self):
super().__init__()
self.__explore_exploit_ratio = 0.
@DataFeatures.PipelineStepMethod
def analyze(self, scan_path: GazeFeatures.ScanPathType):
assert(len(scan_path) > 1)
short_fixations_durations = []
long_fixations_durations = []
saccades_durations = []
for scan_step in scan_path:
if scan_step.first_fixation.duration > self.short_fixation_duration_threshold:
long_fixations_durations.append(scan_step.first_fixation.duration)
else:
short_fixations_durations.append(scan_step.first_fixation.duration)
saccades_durations.append(scan_step.last_saccade.duration)
short_fixations_duration = numpy.array(short_fixations_durations).sum()
long_fixations_duration = numpy.array(long_fixations_durations).sum()
saccades_duration = numpy.array(saccades_durations).sum()
assert(long_fixations_duration > 0)
self.__explore_exploit_ratio = (saccades_duration + short_fixations_duration) / long_fixations_duration
@property
def explore_exploit_ratio(self) -> float:
"""Explore/Exploit ratio."""
return self.__explore_exploit_ratio
|