aboutsummaryrefslogtreecommitdiff
path: root/src/argaze/utils/export_tobii_segment_fixations.py
blob: d40c4d3185e50f3a634d80a27f5b12a2a4f20874 (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
80
81
82
83
84
85
86
87
88
89
90
91
92
#!/usr/bin/env python

import argparse
import bisect
import os

from argaze import GazeFeatures
from argaze.TobiiGlassesPro2 import TobiiEntities
from argaze.utils import MiscFeatures

def main():
    """
    Analyse Tobii segment fixations
    """

    # manage arguments
    parser = argparse.ArgumentParser(description=main.__doc__.split('-')[0])
    parser.add_argument('-s', '--segment_path', metavar='SEGMENT_PATH', type=str, default=None, help='path to a tobii segment folder')
    parser.add_argument('-d', '--dispersion_threshold', metavar='DISPERSION_THRESHOLD', type=int, default=10, help='dispersion threshold in pixel')
    parser.add_argument('-t', '--duration_threshold', metavar='DURATION_THRESHOLD', type=int, default=100, help='duration threshold in millisecond')
    parser.add_argument('-o', '--output', metavar='OUT', type=str, default=None, help='destination folder path (segment folder by default)')
    args = parser.parse_args()

    if args.segment_path != None:

        # Manage destination path
        if args.output != None:

            if not os.path.exists(os.path.dirname(args.output)):

                os.makedirs(os.path.dirname(args.output))
                print(f'{os.path.dirname(args.output)} folder created')

            fixations_filepath = f'{args.output}/fixations.json'

        else:

            fixations_filepath = f'{args.segment_path}/fixations.json'

        # Load a tobii segment
        tobii_segment = TobiiEntities.TobiiSegment(args.segment_path)

        # Load a tobii segment video
        tobii_segment_video = tobii_segment.load_video()
        print(f'Video duration: {tobii_segment_video.get_duration()}, frame number: {tobii_segment_video.get_frame_number()}, width: {tobii_segment_video.get_width()}, height: {tobii_segment_video.get_height()}')

        # Load a tobii segment data
        tobii_segment_data = tobii_segment.load_data()
        print(f'Data keys: {tobii_segment_data.keys()}')

        # Access to timestamped gaze position data buffer
        tobii_ts_gaze_positions = tobii_segment_data.gidx_l_gp

        print(f'{len(tobii_ts_gaze_positions)} gaze positions loaded')

        # Format tobii gaze data into generic gaze data and store them using millisecond unit timestamp
        generic_ts_gaze_positions = GazeFeatures.TimeStampedGazePositions()

        for ts, tobii_data in tobii_ts_gaze_positions.items():
            generic_data = GazeFeatures.GazePosition(tobii_data.gp[0] * tobii_segment_video.get_width(), tobii_data.gp[1] * tobii_segment_video.get_height())
            generic_ts_gaze_positions[ts/1000] = generic_data

        print(f'Dispersion threshold: {args.dispersion_threshold}')
        print(f'Duration threshold: {args.duration_threshold}')

        fixation_analyser = GazeFeatures.DispersionBasedFixationIdentifier(generic_ts_gaze_positions, args.dispersion_threshold, args.duration_threshold)
        fixations = GazeFeatures.TimeStampedFixations()

        # Start fixation identification
        MiscFeatures.printProgressBar(0, int(tobii_segment_video.get_duration()*1000), prefix = 'Progress:', suffix = 'Complete', length = 100)

        for ts, item in fixation_analyser:

            if item == None:
                continue

            if item.get_type() == 'Fixation':

                fixations[ts] = item

                MiscFeatures.printProgressBar(ts, int(tobii_segment_video.get_duration()*1000), prefix = 'Progress:', suffix = 'Complete', length = 100)

        print(f'\n{len(fixations)} fixations found')

        # Export fixations analysis results
        fixations.export_as_json(fixations_filepath)

        print(f'Fixations saved into {fixations_filepath}')

if __name__ == '__main__':

    main()