gazeMapper 1.4.2__tar.gz → 1.4.4__tar.gz

{gazemapper-1.4.2/src/gazeMapper.egg-info → gazemapper-1.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: gazeMapper
-Version: 1.4.2
+Version: 1.4.4
 Summary: Automated world-based analysis of wearable eye tracker data.
 Home-page: https://github.com/dcnieho/gazeMapper
 Author: Diederick Niehorster
@@ -34,11 +34,10 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: glassesTools[GUI]>=1.16.0
+Requires-Dist: glassesTools[GUI]>=1.17.1
 Requires-Dist: typeguard
 Requires-Dist: uvloop; sys_platform != "win32"
 Requires-Dist: watchfiles
-Requires-Dist: pebble
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -46,6 +45,7 @@ Dynamic: description
 Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: license
+Dynamic: license-file
 Dynamic: project-url
 Dynamic: requires-dist
 Dynamic: requires-python
@@ -55,7 +55,7 @@ Dynamic: summary
 [![PyPI Latest Release](https://img.shields.io/pypi/v/gazeMapper.svg)](https://pypi.org/project/gazeMapper/)
 [![image](https://img.shields.io/pypi/pyversions/gazeMapper.svg)](https://pypi.org/project/gazeMapper/)
 
-# gazeMapper v1.4.2
+# gazeMapper v1.4.4
 Tool for automated world-based analysis of wearable eye tracker data.
 gazeMapper is an open-source tool for automated mapping and processing of eye-tracking data to enable automated world-based analysis.
 gazeMapper can:
@@ -64,15 +64,67 @@ gazeMapper can:
 3) Determine data quality measures, e.g., accuracy and precision using [glassesValidator](https://github.com/dcnieho/glassesValidator) ([Niehorster et al., 2023](https://doi.org/10.3758/s13428-023-02105-5)).
 
 If you use this tool or any of the code in this repository, please cite:<br>
-Niehorster, D.C., Hessels, R.S., Nyström, M., Benjamins, J.S. and Hooge, I.T.C. (submitted). gazeMapper: A tool for automated world-based analysis of gaze data from one or multiple wearable eye trackers. Manuscript submitted for publication, 2024 ([BibTeX](#bibtex))<br>
+Niehorster, D.C., Hessels, R.S., Nyström, M., Benjamins, J.S. and Hooge, I.T.C. (submitted). gazeMapper: A tool for automated world-based analysis of gaze data from one or multiple wearable eye trackers. Manuscript submitted for publication, 2025 ([BibTeX](#bibtex))<br>
 If you use the functionality for automatic determining the data quality (accuracy and precision) of wearable eye tracker recordings, please additionally cite:<br>
 [Niehorster, D.C., Hessels, R.S., Benjamins, J.S., Nyström, M. and Hooge, I.T.C. (2023). GlassesValidator:
 A data quality tool for eye tracking glasses. Behavior Research Methods. doi: 10.3758/s13428-023-02105-5](https://doi.org/10.3758/s13428-023-02105-5) ([BibTeX](#bibtex))
 
 ## Example
 ![application example](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/world_data.png?raw=true)
-Example where gazeMapper has been used to map head-centered gaze from two head-worn eye tracker recordings to synchronized world-centered
-gaze data of the pair, drawn on an overview video recording with an additional external camera. From Hessels, R.S., Iwabuchi, T., Niehorster, D.C., Funawatari, R., Benjamins, J.S., Kawakami, S.; Nyström, M., Suda, M., Hooge, I.T.C., Sumiya, M., Heijnen, J., Teunisse, M. & Senju, A. (submitted). Gaze behavior in face-to-face interaction: A cross-cultural investigation between Japan and the Netherlands. Manuscript submitted for publication, 2024
+Example where gazeMapper has been used to map head-centered eye tracking data from two head-worn eye tracker recordings (top panels, camera positions are indicated using stars, and gaze positions using colored circles. Blue indicates eye tracker 1 [ET1] and orange eye tracker 2) to synchronized world-centered gaze data of the pair, drawn on an overview video frame (bottom panel) recorded with an additional external camera. The shown frames are produced by gazeMapper's advanced gaze video functionality (though larger stars and circles to indicate the camera and gaze points were manually overlaid for clarity). From [Hessels, R.S.,Teunisse, M., Niehorster, D.C., Nyström, M., Benjamins, J.S., Senju, A. & Hooge, I.T.S. (2023). Task related gaze behaviour in face to face dyadic collaboration: Toward an interactive theory. _Visual Cognition 31_(4), pp. 291-313. doi: 10.1080/13506285.2023.2250507](https://doi.org/10.1080/13506285.2023.2250507).
+
+# Table of contents
+- [How to acquire](#how-to-acquire)
+  - [Complete instructions for MacOS](#complete-instructions-for-macos)
+  - [Complete instructions for Linux](#complete-instructions-for-linux)
+- [Usage](#usage)
+  - [Workflow and example data](#workflow-and-example-data)
+    - [Example 1: Single participant and single plane](#example-1-single-participant-and-single-plane)
+    - [Example 2: Two participants and two planes](#example-2-two-participants-and-two-planes)
+    - [Example 3: One participant, multiple planes and an overview camera](#example-3-one-participant-multiple-planes-and-an-overview-camera)
+  - [gazeMapper projects](#gazemapper-projects)
+  - [Output](#output)
+    - [Coordinate system of data](#coordinate-system-of-data)
+  - [Eye trackers](#eye-trackers)
+    - [Required preprocessing outside gazeMapper](#required-preprocessing-outside-gazemapper)
+  - [gazeMapper sessions](#gazemapper-sessions)
+  - [gazeMapper planes](#gazemapper-planes)
+    - [Validation (glassesValidator planes)](#validation-glassesvalidator-planes)
+  - [Individual Markers](#individual-markers)
+  - [Actions](#actions)
+  - [Coding analysis, synchronization and validation episodes](#coding-analysis-synchronization-and-validation-episodes)
+    - [Automatic coding of analysis and synchronization episodes](#automatic-coding-of-analysis-and-synchronization-episodes)
+      - [Automatic coding of synchronization timepoints](#automatic-coding-of-synchronization-timepoints)
+      - [Automatic coding of analysis episodes](#automatic-coding-of-analysis-episodes)
+  - [Synchronization](#synchronization)
+    - [Synchronizing eye tracker data and scene camera](#synchronizing-eye-tracker-data-and-scene-camera)
+    - [Synchronizing multiple eye tracker or external camera recordings](#synchronizing-multiple-eye-tracker-or-external-camera-recordings)
+- [Configuration](#configuration)
+  - [`gazeMapper.config.AutoCodeSyncPoints`](#gazemapperconfigautocodesyncpoints)
+  - [`gazeMapper.config.AutoCodeTrialEpisodes`](#gazemapperconfigautocodetrialepisodes)
+  - [`gazeMapper.config.CamMovementForEtSyncFunction`](#gazemapperconfigcammovementforetsyncfunction)
+  - [`gazeMapper.config.I2MCSettings`](#gazemapperconfigi2mcsettings)
+  - [`gazeMapper.config.RgbColor`](#gazemapperconfigrgbcolor)
+  - [Overriding a project's settings for a specific session or recording](#overriding-a-projects-settings-for-a-specific-session-or-recording)
+- [API](#api)
+  - [`gazeMapper.config`](#gazemapperconfig)
+    - [`gazeMapper.config.Study`](#gazemapperconfigstudy)
+    - [`gazeMapper.config.OverrideLevel`](#gazemapperconfigoverridelevel)
+    - [`gazeMapper.config.StudyOverride`](#gazemapperconfigstudyoverride)
+  - [`gazeMapper.episode`](#gazemapperepisode)
+  - [`gazeMapper.marker`](#gazemappermarker)
+  - [`gazeMapper.plane`](#gazemapperplane)
+    - [`gazeMapper.plane.Type`](#gazemapperplanetype)
+    - [`gazeMapper.plane.Definition` and subclasses](#gazemapperplanedefinition-and-subclasses)
+  - [`gazeMapper.process`](#gazemapperprocess)
+  - [`gazeMapper.session`](#gazemappersession)
+    - [`gazeMapper.session.RecordingType`](#gazemappersessionrecordingtype)
+    - [`gazeMapper.session.RecordingDefinition`](#gazemappersessionrecordingdefinition)
+    - [`gazeMapper.session.Recording`](#gazemappersessionrecording)
+    - [`gazeMapper.session.SessionDefinition`](#gazemappersessionsessiondefinition)
+    - [`gazeMapper.session.Session`](#gazemappersessionsession)
+    - [Free functions](#free-functions)
+- [Citation](#citation)
 
 # How to acquire
 GazeMapper is available from `https://github.com/dcnieho/gazeMapper`, and supports Python 3.11 on Windows, MacOS and Linux (newer versions of Python should work fine but are not tested).
@@ -222,7 +274,7 @@ Example 1 is a minimum example, showing a short recording where a participant lo
 
         ![Project config](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/project_config_1.png?raw=true)
 4. Now that the project is set up, we are ready to import and process recordings.
-    1. On the `Session` pane, click `import eye tracker recordings`. There, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/1_simple/data) and indicate its an `SMI ETG` recording. Note that you could also trigger import by drag-dropping a data folder onto gazeMapper. Note also that an SMI ETG recording has to be [prepared](#required-preprocessing-outside-gazemapper) before it can be imported by gazeMapper. This preparation has already been performed for the included example data.
+    1. On the `Session` pane, click `import eye tracker recordings`. There, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/1_simple/data) (`1_simple/data`) and indicate its an `SMI ETG` recording. Note that you could also trigger import by drag-dropping a data folder onto gazeMapper. Note also that an SMI ETG recording has to be [prepared](#required-preprocessing-outside-gazemapper) before it can be imported by gazeMapper. This preparation has already been performed for the included example data.
     1. On the window that pops up, click `+ new session`, and name the session `1` (or any name you like). Expand session `1`. You should now see the following:
 
         ![Add recording 1](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/add_recording_1_1.png?raw=true)
@@ -317,12 +369,12 @@ Nonetheless, below we provide a full description of how recording preparation, d
 
         ![Project config](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/project_config_2.png?raw=true)
 4. Now that the project is set up, we are ready to import and process recordings.
-    1. On the `Session` pane, click `import eye tracker recordings`. There, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/2_two_participants_two_planes/data) and indicate you're looking for `Tobii Glasses 2` recordings. Note that you could also trigger import by drag-dropping a data folder onto gazeMapper.
+    1. On the `Session` pane, click `import eye tracker recordings`. There, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/2_two_participants_two_planes/data) (`2_two_participants_two_planes/data`) and indicate you're looking for `Tobii Glasses 2` recordings. Note that you could also trigger import by drag-dropping a data folder onto gazeMapper.
     1. On the window that pops up, click `+ new session`, and name the session `1` (or any name you like). Expand session `1`. You should now see the following:
 
         ![Add recording 1](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/add_recording_2_1.png?raw=true)
     1. Assign the recording to the session by dragging it from the right, and dropping it on the left for the `lead` recording where it says `drop recording here`. Click `Continue`. The recording will now be imported.
-    1. Again click `import eye tracker recordings`, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/2_two_participants_two_planes/data) and this time indicate you're looking for `Pupil Invisible` recordings. Assign the found Pupil Invisible recording to the `follow` recording.
+    1. Again click `import eye tracker recordings`, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/2_two_participants_two_planes/data) (`2_two_participants_two_planes/data`) and this time indicate you're looking for `Pupil Invisible` recordings. Assign the found Pupil Invisible recording to the `follow` recording.
 
         ![Add recording 2](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/add_recording_2_2.png?raw=true)
 
@@ -416,12 +468,12 @@ Example 3 is a more advanced example, showing a recording of a participant looki
 
         ![Project config](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/project_config_3.png?raw=true)
 4. Now that the project is set up, we are ready to import and process recordings.
-    1. On the `Session` pane, click `import eye tracker recordings`. There, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/3_external_camera_moving_plane/data) and indicate you're looking for `Pupil Invisible` recordings. Note that you could also trigger import by drag-dropping a data folder onto gazeMapper.
+    1. On the `Session` pane, click `import eye tracker recordings`. There, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/3_external_camera_moving_plane/data) (`3_external_camera_moving_plane/data`) and indicate you're looking for `Pupil Invisible` recordings. Note that you could also trigger import by drag-dropping a data folder onto gazeMapper.
     1. On the window that pops up, click `+ new session`, and name the session `1` (or any name you like). Expand session `1`. You should now see the following:
 
         ![Add recording 1](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/add_recording_3_1.png?raw=true)
     1. Assign the recording to the session by dragging it from the right, and dropping it on the left for the `eye tracker` recording where it says `drop recording here`. Click `Continue`. The recording will now be imported.
-    1. Click `import camera recordings`, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/3_external_camera_moving_plane/data) and click continue. Assign the found camera recording (`cam1_R003_reencode.mp4`) to the `overview` recording.
+    1. Click `import camera recordings`, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/3_external_camera_moving_plane/data) (`3_external_camera_moving_plane/data`) and click continue. Assign the found camera recording (`cam1_R003_reencode.mp4`) to the `overview` recording.
 
         ![Add recording 2](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/add_recording_3_2.png?raw=true)
 
@@ -603,7 +655,7 @@ A generic 2D fiducial marker plane is defined by a file with four columns that d
 | `y` |The vertical location of the marker's center on the plane (mm).|
 | `rotation_angle` |The rotation of the marker, if any (degree).|
 
-A file with this information should be stored under any name (e.g., `markerPositions.csv`) in the plane's configuration folder inside the project's configuration folder. See the example data for an example of such a file (TODO).
+A file with this information should be stored under any name (e.g., `markerPositions.csv`) in the plane's configuration folder inside the project's configuration folder. See the [example data](https://github.com/dcnieho/gazeMapper/blob/master/example_data/1_simple/configuration/screen/markerPositions_screen.csv) for an example of such a file.
 
 To be able turn the information of the above file into a plane, further settings are needed:
 | Setting | Description |
@@ -622,7 +674,7 @@ These settings are typically stored in a file `plane_def.json` in the plane's co
 ### Validation (glassesValidator planes)
 gazeMapper has built-in support for computing data quality from the gaze data of a participant looking at a validation poster using glassesValidator. To use this functionality, a plane of type GlassesValidator (`gazeMapper.plane.Type.GlassesValidator`) needs to be defined in the project's setup. By default, the default glassesValidator plane is used for a GlassesValidator plane. When the default checkbox is unchecked in the GUI (the `is_default` setting in `plane_def.json` is False), a custom configuration can be used. When unchecking this checkbox in the GUI, files containing the plane setup are deployed to the plane configuration folder, so that the user can edit or replace them. API users are requested to call `glassesValidator.config.deploy_validation_config()` to deploy the glassesValidator configuration files to the plane's configuration folder. The customization options for a glassesValidator plane are [documented here](https://github.com/dcnieho/glassesValidator/blob/master/README.md#customizing-the-poster).
 
-### Individual Markers
+## Individual Markers
 Besides planes, gazeMapper can also be configured to detect and report on the appearance of individual markers. This is configured in the `Individual markers editor` pane in the GUI or by means of `gazeMapper.marker.Marker` objects.
 
 ## Actions

{gazemapper-1.4.2 → gazemapper-1.4.4}/README.md

@@ -2,7 +2,7 @@
 [![PyPI Latest Release](https://img.shields.io/pypi/v/gazeMapper.svg)](https://pypi.org/project/gazeMapper/)
 [![image](https://img.shields.io/pypi/pyversions/gazeMapper.svg)](https://pypi.org/project/gazeMapper/)
 
-# gazeMapper v1.4.2
+# gazeMapper v1.4.4
 Tool for automated world-based analysis of wearable eye tracker data.
 gazeMapper is an open-source tool for automated mapping and processing of eye-tracking data to enable automated world-based analysis.
 gazeMapper can:
@@ -11,15 +11,67 @@ gazeMapper can:
 3) Determine data quality measures, e.g., accuracy and precision using [glassesValidator](https://github.com/dcnieho/glassesValidator) ([Niehorster et al., 2023](https://doi.org/10.3758/s13428-023-02105-5)).
 
 If you use this tool or any of the code in this repository, please cite:<br>
-Niehorster, D.C., Hessels, R.S., Nyström, M., Benjamins, J.S. and Hooge, I.T.C. (submitted). gazeMapper: A tool for automated world-based analysis of gaze data from one or multiple wearable eye trackers. Manuscript submitted for publication, 2024 ([BibTeX](#bibtex))<br>
+Niehorster, D.C., Hessels, R.S., Nyström, M., Benjamins, J.S. and Hooge, I.T.C. (submitted). gazeMapper: A tool for automated world-based analysis of gaze data from one or multiple wearable eye trackers. Manuscript submitted for publication, 2025 ([BibTeX](#bibtex))<br>
 If you use the functionality for automatic determining the data quality (accuracy and precision) of wearable eye tracker recordings, please additionally cite:<br>
 [Niehorster, D.C., Hessels, R.S., Benjamins, J.S., Nyström, M. and Hooge, I.T.C. (2023). GlassesValidator:
 A data quality tool for eye tracking glasses. Behavior Research Methods. doi: 10.3758/s13428-023-02105-5](https://doi.org/10.3758/s13428-023-02105-5) ([BibTeX](#bibtex))
 
 ## Example
 ![application example](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/world_data.png?raw=true)
-Example where gazeMapper has been used to map head-centered gaze from two head-worn eye tracker recordings to synchronized world-centered
-gaze data of the pair, drawn on an overview video recording with an additional external camera. From Hessels, R.S., Iwabuchi, T., Niehorster, D.C., Funawatari, R., Benjamins, J.S., Kawakami, S.; Nyström, M., Suda, M., Hooge, I.T.C., Sumiya, M., Heijnen, J., Teunisse, M. & Senju, A. (submitted). Gaze behavior in face-to-face interaction: A cross-cultural investigation between Japan and the Netherlands. Manuscript submitted for publication, 2024
+Example where gazeMapper has been used to map head-centered eye tracking data from two head-worn eye tracker recordings (top panels, camera positions are indicated using stars, and gaze positions using colored circles. Blue indicates eye tracker 1 [ET1] and orange eye tracker 2) to synchronized world-centered gaze data of the pair, drawn on an overview video frame (bottom panel) recorded with an additional external camera. The shown frames are produced by gazeMapper's advanced gaze video functionality (though larger stars and circles to indicate the camera and gaze points were manually overlaid for clarity). From [Hessels, R.S.,Teunisse, M., Niehorster, D.C., Nyström, M., Benjamins, J.S., Senju, A. & Hooge, I.T.S. (2023). Task related gaze behaviour in face to face dyadic collaboration: Toward an interactive theory. _Visual Cognition 31_(4), pp. 291-313. doi: 10.1080/13506285.2023.2250507](https://doi.org/10.1080/13506285.2023.2250507).
+
+# Table of contents
+- [How to acquire](#how-to-acquire)
+  - [Complete instructions for MacOS](#complete-instructions-for-macos)
+  - [Complete instructions for Linux](#complete-instructions-for-linux)
+- [Usage](#usage)
+  - [Workflow and example data](#workflow-and-example-data)
+    - [Example 1: Single participant and single plane](#example-1-single-participant-and-single-plane)
+    - [Example 2: Two participants and two planes](#example-2-two-participants-and-two-planes)
+    - [Example 3: One participant, multiple planes and an overview camera](#example-3-one-participant-multiple-planes-and-an-overview-camera)
+  - [gazeMapper projects](#gazemapper-projects)
+  - [Output](#output)
+    - [Coordinate system of data](#coordinate-system-of-data)
+  - [Eye trackers](#eye-trackers)
+    - [Required preprocessing outside gazeMapper](#required-preprocessing-outside-gazemapper)
+  - [gazeMapper sessions](#gazemapper-sessions)
+  - [gazeMapper planes](#gazemapper-planes)
+    - [Validation (glassesValidator planes)](#validation-glassesvalidator-planes)
+  - [Individual Markers](#individual-markers)
+  - [Actions](#actions)
+  - [Coding analysis, synchronization and validation episodes](#coding-analysis-synchronization-and-validation-episodes)
+    - [Automatic coding of analysis and synchronization episodes](#automatic-coding-of-analysis-and-synchronization-episodes)
+      - [Automatic coding of synchronization timepoints](#automatic-coding-of-synchronization-timepoints)
+      - [Automatic coding of analysis episodes](#automatic-coding-of-analysis-episodes)
+  - [Synchronization](#synchronization)
+    - [Synchronizing eye tracker data and scene camera](#synchronizing-eye-tracker-data-and-scene-camera)
+    - [Synchronizing multiple eye tracker or external camera recordings](#synchronizing-multiple-eye-tracker-or-external-camera-recordings)
+- [Configuration](#configuration)
+  - [`gazeMapper.config.AutoCodeSyncPoints`](#gazemapperconfigautocodesyncpoints)
+  - [`gazeMapper.config.AutoCodeTrialEpisodes`](#gazemapperconfigautocodetrialepisodes)
+  - [`gazeMapper.config.CamMovementForEtSyncFunction`](#gazemapperconfigcammovementforetsyncfunction)
+  - [`gazeMapper.config.I2MCSettings`](#gazemapperconfigi2mcsettings)
+  - [`gazeMapper.config.RgbColor`](#gazemapperconfigrgbcolor)
+  - [Overriding a project's settings for a specific session or recording](#overriding-a-projects-settings-for-a-specific-session-or-recording)
+- [API](#api)
+  - [`gazeMapper.config`](#gazemapperconfig)
+    - [`gazeMapper.config.Study`](#gazemapperconfigstudy)
+    - [`gazeMapper.config.OverrideLevel`](#gazemapperconfigoverridelevel)
+    - [`gazeMapper.config.StudyOverride`](#gazemapperconfigstudyoverride)
+  - [`gazeMapper.episode`](#gazemapperepisode)
+  - [`gazeMapper.marker`](#gazemappermarker)
+  - [`gazeMapper.plane`](#gazemapperplane)
+    - [`gazeMapper.plane.Type`](#gazemapperplanetype)
+    - [`gazeMapper.plane.Definition` and subclasses](#gazemapperplanedefinition-and-subclasses)
+  - [`gazeMapper.process`](#gazemapperprocess)
+  - [`gazeMapper.session`](#gazemappersession)
+    - [`gazeMapper.session.RecordingType`](#gazemappersessionrecordingtype)
+    - [`gazeMapper.session.RecordingDefinition`](#gazemappersessionrecordingdefinition)
+    - [`gazeMapper.session.Recording`](#gazemappersessionrecording)
+    - [`gazeMapper.session.SessionDefinition`](#gazemappersessionsessiondefinition)
+    - [`gazeMapper.session.Session`](#gazemappersessionsession)
+    - [Free functions](#free-functions)
+- [Citation](#citation)
 
 # How to acquire
 GazeMapper is available from `https://github.com/dcnieho/gazeMapper`, and supports Python 3.11 on Windows, MacOS and Linux (newer versions of Python should work fine but are not tested).
@@ -169,7 +221,7 @@ Example 1 is a minimum example, showing a short recording where a participant lo
 
         ![Project config](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/project_config_1.png?raw=true)
 4. Now that the project is set up, we are ready to import and process recordings.
-    1. On the `Session` pane, click `import eye tracker recordings`. There, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/1_simple/data) and indicate its an `SMI ETG` recording. Note that you could also trigger import by drag-dropping a data folder onto gazeMapper. Note also that an SMI ETG recording has to be [prepared](#required-preprocessing-outside-gazemapper) before it can be imported by gazeMapper. This preparation has already been performed for the included example data.
+    1. On the `Session` pane, click `import eye tracker recordings`. There, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/1_simple/data) (`1_simple/data`) and indicate its an `SMI ETG` recording. Note that you could also trigger import by drag-dropping a data folder onto gazeMapper. Note also that an SMI ETG recording has to be [prepared](#required-preprocessing-outside-gazemapper) before it can be imported by gazeMapper. This preparation has already been performed for the included example data.
     1. On the window that pops up, click `+ new session`, and name the session `1` (or any name you like). Expand session `1`. You should now see the following:
 
         ![Add recording 1](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/add_recording_1_1.png?raw=true)
@@ -264,12 +316,12 @@ Nonetheless, below we provide a full description of how recording preparation, d
 
         ![Project config](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/project_config_2.png?raw=true)
 4. Now that the project is set up, we are ready to import and process recordings.
-    1. On the `Session` pane, click `import eye tracker recordings`. There, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/2_two_participants_two_planes/data) and indicate you're looking for `Tobii Glasses 2` recordings. Note that you could also trigger import by drag-dropping a data folder onto gazeMapper.
+    1. On the `Session` pane, click `import eye tracker recordings`. There, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/2_two_participants_two_planes/data) (`2_two_participants_two_planes/data`) and indicate you're looking for `Tobii Glasses 2` recordings. Note that you could also trigger import by drag-dropping a data folder onto gazeMapper.
     1. On the window that pops up, click `+ new session`, and name the session `1` (or any name you like). Expand session `1`. You should now see the following:
 
         ![Add recording 1](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/add_recording_2_1.png?raw=true)
     1. Assign the recording to the session by dragging it from the right, and dropping it on the left for the `lead` recording where it says `drop recording here`. Click `Continue`. The recording will now be imported.
-    1. Again click `import eye tracker recordings`, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/2_two_participants_two_planes/data) and this time indicate you're looking for `Pupil Invisible` recordings. Assign the found Pupil Invisible recording to the `follow` recording.
+    1. Again click `import eye tracker recordings`, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/2_two_participants_two_planes/data) (`2_two_participants_two_planes/data`) and this time indicate you're looking for `Pupil Invisible` recordings. Assign the found Pupil Invisible recording to the `follow` recording.
 
         ![Add recording 2](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/add_recording_2_2.png?raw=true)
 
@@ -363,12 +415,12 @@ Example 3 is a more advanced example, showing a recording of a participant looki
 
         ![Project config](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/project_config_3.png?raw=true)
 4. Now that the project is set up, we are ready to import and process recordings.
-    1. On the `Session` pane, click `import eye tracker recordings`. There, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/3_external_camera_moving_plane/data) and indicate you're looking for `Pupil Invisible` recordings. Note that you could also trigger import by drag-dropping a data folder onto gazeMapper.
+    1. On the `Session` pane, click `import eye tracker recordings`. There, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/3_external_camera_moving_plane/data) (`3_external_camera_moving_plane/data`) and indicate you're looking for `Pupil Invisible` recordings. Note that you could also trigger import by drag-dropping a data folder onto gazeMapper.
     1. On the window that pops up, click `+ new session`, and name the session `1` (or any name you like). Expand session `1`. You should now see the following:
 
         ![Add recording 1](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/add_recording_3_1.png?raw=true)
     1. Assign the recording to the session by dragging it from the right, and dropping it on the left for the `eye tracker` recording where it says `drop recording here`. Click `Continue`. The recording will now be imported.
-    1. Click `import camera recordings`, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/3_external_camera_moving_plane/data) and click continue. Assign the found camera recording (`cam1_R003_reencode.mp4`) to the `overview` recording.
+    1. Click `import camera recordings`, select the [folder containing the example data](https://github.com/dcnieho/gazeMapper/tree/master/example_data/3_external_camera_moving_plane/data) (`3_external_camera_moving_plane/data`) and click continue. Assign the found camera recording (`cam1_R003_reencode.mp4`) to the `overview` recording.
 
         ![Add recording 2](https://raw.githubusercontent.com/dcnieho/gazeMapper/master/.github/images/add_recording_3_2.png?raw=true)
 
@@ -550,7 +602,7 @@ A generic 2D fiducial marker plane is defined by a file with four columns that d
 | `y` |The vertical location of the marker's center on the plane (mm).|
 | `rotation_angle` |The rotation of the marker, if any (degree).|
 
-A file with this information should be stored under any name (e.g., `markerPositions.csv`) in the plane's configuration folder inside the project's configuration folder. See the example data for an example of such a file (TODO).
+A file with this information should be stored under any name (e.g., `markerPositions.csv`) in the plane's configuration folder inside the project's configuration folder. See the [example data](https://github.com/dcnieho/gazeMapper/blob/master/example_data/1_simple/configuration/screen/markerPositions_screen.csv) for an example of such a file.
 
 To be able turn the information of the above file into a plane, further settings are needed:
 | Setting | Description |
@@ -569,7 +621,7 @@ These settings are typically stored in a file `plane_def.json` in the plane's co
 ### Validation (glassesValidator planes)
 gazeMapper has built-in support for computing data quality from the gaze data of a participant looking at a validation poster using glassesValidator. To use this functionality, a plane of type GlassesValidator (`gazeMapper.plane.Type.GlassesValidator`) needs to be defined in the project's setup. By default, the default glassesValidator plane is used for a GlassesValidator plane. When the default checkbox is unchecked in the GUI (the `is_default` setting in `plane_def.json` is False), a custom configuration can be used. When unchecking this checkbox in the GUI, files containing the plane setup are deployed to the plane configuration folder, so that the user can edit or replace them. API users are requested to call `glassesValidator.config.deploy_validation_config()` to deploy the glassesValidator configuration files to the plane's configuration folder. The customization options for a glassesValidator plane are [documented here](https://github.com/dcnieho/glassesValidator/blob/master/README.md#customizing-the-poster).
 
-### Individual Markers
+## Individual Markers
 Besides planes, gazeMapper can also be configured to detect and report on the appearance of individual markers. This is configured in the `Individual markers editor` pane in the GUI or by means of `gazeMapper.marker.Marker` objects.
 
 ## Actions

{gazemapper-1.4.2 → gazemapper-1.4.4}/requirements.txt

@@ -1,5 +1,4 @@
-glassesTools[GUI]>=1.16.0   # pulls in various other dependencies such as imgui_bundle, matplotlib, numpy, opencv, pandas, polars
+glassesTools[GUI]>=1.17.1   # pulls in various other dependencies such as imgui_bundle, matplotlib, numpy, opencv, pandas, polars
 typeguard
 uvloop ; sys_platform != "win32"
-watchfiles
-pebble
+watchfiles

{gazemapper-1.4.2 → gazemapper-1.4.4}/src/gazeMapper/GUI/_impl/callbacks.py

@@ -8,16 +8,23 @@ import pathvalidate
 import threading
 from imgui_bundle import imgui, imspinner, hello_imgui, icons_fontawesome_6 as ifa6
 
-from glassesTools import annotation, aruco, async_thread, camera_recording, eyetracker, gui as gt_gui, naming as gt_naming, platform, recording, video_utils
+from glassesTools import annotation, aruco, async_thread, camera_recording, eyetracker, gui as gt_gui, naming as gt_naming, platform, process_pool, recording, video_utils
 from glassesTools.validation import config as val_config, DataQualityType, export, get_DataQualityType_explanation
+from glassesTools.gui import colors
 
-from . import colors, utils
+from . import utils
 from ... import config, marker, naming, plane, process, session
 
+_picker_last_folder = None
 def get_folder_picker(g, reason: str, *args, **kwargs):
     from . import gui
     g = typing.cast(gui.GUI,g)  # indicate type to typechecker
     def select_callback(selected: list[pathlib.Path]):
+        global _picker_last_folder
+        if len(selected)==1 and selected[0].is_dir():
+            _picker_last_folder = selected[0]
+        else:
+            _picker_last_folder = selected[0].parent
         match reason:
             case 'loading' | 'creating':
                 try_load_project(g, selected, action=reason)
@@ -69,7 +76,7 @@ def get_folder_picker(g, reason: str, *args, **kwargs):
             picker_type = gt_gui.file_picker.DirPicker
         case _:
             raise ValueError(f'reason "{reason}" not understood')
-    picker = picker_type(title=header, allow_multiple=allow_multiple, callback=select_callback)
+    picker = picker_type(title=header, allow_multiple=allow_multiple, callback=select_callback, start_dir=_picker_last_folder)
     picker.set_show_only_dirs(False)
     return picker
 
@@ -335,27 +342,31 @@ def show_export_config(g, path: str|pathlib.Path, sessions: list[str]):
 
     # for the sessions, see what we have to export
     to_export: dict[str,bool] = {}
-    rec_dirs: list[pathlib.Path] = []
+    rec_dirs_val: list[pathlib.Path] = []
+    rec_dirs_et_sync: list[pathlib.Path] = []
     for s_name in sessions:
         s = g.sessions.get(s_name,None)
         if s is None:
             continue
         if 'plane gaze' not in to_export:
-            if annotation.Event.Trial in g.study_config.planes_per_episode and any((s.recordings[r].state[process.Action.GAZE_TO_PLANE]==process.State.Completed for r in s.recordings)):
+            if annotation.Event.Trial in g.study_config.planes_per_episode and any((s.recordings[r].state[process.Action.GAZE_TO_PLANE]==process_pool.State.Completed for r in s.recordings)):
                 to_export['plane gaze'] = True
-        if recs:=[s.recordings[r].info.working_directory for r in s.recordings if s.recordings[r].state[process.Action.VALIDATE]==process.State.Completed]:
+        if recs:=[s.recordings[r].info.working_directory for r in s.recordings if s.recordings[r].state[process.Action.VALIDATE]==process_pool.State.Completed]:
             to_export['validation'] = True
-            rec_dirs.extend(recs)
+            rec_dirs_val.extend(recs)
+        if recs:=[s.recordings[r].info.working_directory for r in s.recordings if s.recordings[r].state[process.Action.SYNC_ET_TO_CAM]==process_pool.State.Completed]:
+            to_export['eye tracker synchronization'] = True
+            rec_dirs_et_sync.extend(recs)
         if 'gaze overlay video' not in to_export:
-            if any((s.recordings[r].state[process.Action.MAKE_GAZE_OVERLAY_VIDEO]==process.State.Completed for r in s.recordings)):
+            if any((s.recordings[r].state[process.Action.MAKE_GAZE_OVERLAY_VIDEO]==process_pool.State.Completed for r in s.recordings)):
                 to_export['gaze overlay video'] = True
         if 'mapped gaze video' not in to_export:
-            if s.state[process.Action.MAKE_MAPPED_GAZE_VIDEO]==process.State.Completed:
+            if s.state[process.Action.MAKE_MAPPED_GAZE_VIDEO]==process_pool.State.Completed:
                 to_export['mapped gaze video'] = True
 
     dq_df, dq_set = None, None
-    if rec_dirs:
-        dq_df, default_dq_type, dq_targets = export.collect_data_quality(rec_dirs, {p:f'{naming.validation_prefix}{p}_data_quality.tsv' for p in g.study_config.planes_per_episode[annotation.Event.Validate]}, col_for_parent='session')
+    if rec_dirs_val:
+        dq_df, default_dq_type, dq_targets = export.collect_data_quality(rec_dirs_val, {p:f'{naming.validation_prefix}{p}_data_quality.tsv' for p in g.study_config.planes_per_episode[annotation.Event.Validate]}, col_for_parent='session')
         if dq_df is None:
             to_export.pop('validation', None)
         else:
@@ -465,7 +476,7 @@ def show_export_config(g, path: str|pathlib.Path, sessions: list[str]):
     def launch_export():
         exp = []
         if 'plane gaze' in to_export and to_export['plane gaze']:
-            exp.append('planeGaze')
+            exp.append('plane_gaze')
         if 'gaze overlay video' in to_export and to_export['gaze overlay video']:
             exp.append('gaze_overlay_video')
         if 'mapped gaze video' in to_export and to_export['mapped gaze video']:
@@ -479,6 +490,10 @@ def show_export_config(g, path: str|pathlib.Path, sessions: list[str]):
             targets  = [t for t in dq_set['targets'] if dq_set['targets'][t]]
             export.summarize_and_store_data_quality(dq_df, path/'data_quality.tsv', dq_types, targets, dq_set['targets_avg'], dq_set['include_data_loss'])
 
+        # export et sync for all recordings in all sessions
+        if 'eye tracker synchronization' in to_export and to_export['eye tracker synchronization']:
+            export.export_et_sync(rec_dirs_et_sync, naming.VOR_sync_file, path/'et_sync.tsv')
+
     buttons = {
         ifa6.ICON_FA_CHECK+f" Continue": (launch_export, lambda: not any((to_export[e] for e in to_export))),
         ifa6.ICON_FA_CIRCLE_XMARK+f" Cancel": None

{gazemapper-1.4.2 → gazemapper-1.4.4}/src/gazeMapper/GUI/_impl/gui.py

@@ -19,11 +19,12 @@ import OpenGL
 import OpenGL.GL as gl
 
 import glassesTools
-from glassesTools import annotation, gui as gt_gui, naming as gt_naming, plane as gt_plane, platform as gt_platform
+from glassesTools import annotation, gui as gt_gui, naming as gt_naming, plane as gt_plane, platform as gt_platform, process_pool
+from glassesTools.gui import colors
 
 from ... import config, marker, plane, process, project_watcher, session, type_utils, version
 from .. import async_thread
-from . import callbacks, colors, image_helper, process_pool, session_lister, settings_editor, utils
+from . import callbacks, image_helper, session_lister, settings_editor, utils
 
 
 class GUI:
@@ -418,7 +419,7 @@ class GUI:
             # set pending and running states since these are not stored in the states file
             for job_id in self.job_scheduler.jobs:
                 job_state = self.job_scheduler.jobs[job_id].get_state()
-                if job_state in [process.State.Pending, process.State.Running]:
+                if job_state in [process_pool.State.Pending, process_pool.State.Running]:
                     self._update_job_states_impl(self.job_scheduler.jobs[job_id].user_data, job_state)
 
         # if there are no jobs left, clean up process pool
@@ -432,7 +433,7 @@ class GUI:
             return False
         return True
 
-    def _update_job_states_impl(self, job: utils.JobInfo, job_state: process.State):
+    def _update_job_states_impl(self, job: utils.JobInfo, job_state: process_pool.State):
         sess = self.sessions.get(job.session,None)
         if sess is None:
             return
@@ -446,10 +447,10 @@ class GUI:
         else:
             sess.state[job.action] = job_state
 
-    def _action_done_callback(self, future: process_pool.ProcessFuture, job_id: int, job: utils.JobInfo, state: process.State):
+    def _action_done_callback(self, future: process_pool.ProcessFuture, job_id: int, job: utils.JobInfo, state: process_pool.State):
         # if process failed, notify error
         session_level = job.recording is None
-        if state==process.State.Failed:
+        if state==process_pool.State.Failed:
             exc = future.exception()    # should not throw exception since CancelledError is already encoded in state and future is done
             tb = gt_gui.utils.get_traceback(type(exc), exc, exc.__traceback__)
             lbl = f'session "{job.session}"'
@@ -460,7 +461,7 @@ class GUI:
             self.job_scheduler.jobs[job_id].error = tb
 
         # clean up, if needed, when a task failed or was canceled
-        if job.action==process.Action.IMPORT and state in [process.State.Canceled, process.State.Failed]:
+        if job.action==process.Action.IMPORT and state in [process_pool.State.Canceled, process_pool.State.Failed]:
             # remove working directory if this was an import task
             async_thread.run(callbacks.remove_recording_working_dir(self.project_dir, job.session, job.recording))
             # also update GUI state, might be needed if there was no working directory yet for instance
@@ -580,7 +581,7 @@ class GUI:
         actions = process.get_actions_for_config(cfg, exclude_session_level=True)
         def _draw_status(action: process.Action, item: session.Recording):
             if process.is_action_possible_for_recording(item.definition.name, item.definition.type, action, cfg):
-                session_lister.draw_process_state(item.state[action])
+                gt_gui.utils.draw_process_state(item.state[action])
             else:
                 imgui.text('-')
                 if action==process.Action.AUTO_CODE_TRIALS and cfg.sync_ref_recording and item.definition.name!=cfg.sync_ref_recording:
@@ -815,7 +816,7 @@ class GUI:
         jobs = self.job_scheduler.jobs.copy()
         job_ids = sorted(jobs.keys())
         job_states = {job_id:jobs[job_id].get_state() for job_id in job_ids}
-        if any((job_states[i] in [process.State.Pending, process.State.Running] for i in job_states)):
+        if any((job_states[i] in [process_pool.State.Pending, process_pool.State.Running] for i in job_states)):
             if imgui.button(ifa6.ICON_FA_HAND+' Cancel all'):
                 self.job_scheduler.cancel_all_jobs()
 
@@ -873,14 +874,14 @@ class GUI:
                             imgui.text(f'{job_id}')
                         case 1:
                             # Status
-                            session_lister.draw_process_state((job_state:=jobs[job_id].get_state()))
+                            gt_gui.utils.draw_process_state((job_state:=jobs[job_id].get_state()))
                             if jobs[job_id].error:
                                 gt_gui.utils.draw_hover_text(jobs[job_id].error, text='')
                                 imgui.same_line()
                                 if imgui.small_button(ifa6.ICON_FA_COPY+f'##{job_id}_copy_error'):
                                     imgui.set_clipboard_text(jobs[job_id].error)
                                 gt_gui.utils.draw_hover_text('Copy error to clipboard', text='')
-                            if job_state in [process.State.Pending, process.State.Running]:
+                            if job_state in [process_pool.State.Pending, process_pool.State.Running]:
                                 imgui.same_line()
                                 if imgui.small_button(ifa6.ICON_FA_HAND+f' Cancel##{job_id}'):
                                     self.job_scheduler.cancel_job(job_id)
@@ -1207,7 +1208,7 @@ class GUI:
     def _get_pending_running_job_list(self) -> dict[utils.JobInfo, int]:
         active_jobs: dict[utils.JobInfo, int] = {}
         for job_id in self.job_scheduler.jobs:
-            if self.job_scheduler.jobs[job_id].get_state() in [process.State.Pending, process.State.Running]:
+            if self.job_scheduler.jobs[job_id].get_state() in [process_pool.State.Pending, process_pool.State.Running]:
                 active_jobs[self.job_scheduler.jobs[job_id].user_data] = job_id
         return active_jobs
 
@@ -1216,14 +1217,14 @@ class GUI:
             imgui.text_colored(colors.error, '-')
         else:
             if process.is_session_level_action(action):
-                session_lister.draw_process_state(item.state[action])
+                gt_gui.utils.draw_process_state(item.state[action])
             else:
                 cfg = self.session_config_overrides[item.name].apply(self.study_config, strict_check=False) if item.name in self.session_config_overrides else self.study_config
                 states = {r:item.recordings[r].state[action] for r in item.recordings if process.is_action_possible_for_recording(r, item.definition.get_recording_def(r).type, action, cfg)}
-                not_completed = [r for r in states if states[r]!=process.State.Completed]
-                if any(st:=[s for r in states if (s:=states[r]) in [process.State.Pending, process.State.Running]]):
+                not_completed = [r for r in states if states[r]!=process_pool.State.Completed]
+                if any(st:=[s for r in states if (s:=states[r]) in [process_pool.State.Pending, process_pool.State.Running]]):
                     # progress marker
-                    session_lister.draw_process_state(process.State.Running if process.State.Running in st else process.State.Pending, have_hover_popup=False)
+                    gt_gui.utils.draw_process_state(process_pool.State.Running if process_pool.State.Running in st else process_pool.State.Pending, have_hover_popup=False)
                 else:
                     n_rec = len(states)
                     clr = colors.error if not_completed else colors.ok
@@ -1276,10 +1277,10 @@ class GUI:
                     else:
                         hover_text = process.get_impossible_reason_text(a, actions)
                     status = [self.sessions[s].recordings[r].state[a] for s in actions if a in actions[s] for r in actions[s][a][0]]
-                    status = max(status) if status else process.State.Not_Run
+                    status = max(status) if status else process_pool.State.Not_Run
                 if a.has_options and possible:
                     hover_text += '\nShift-click to bring up a popup with configuration options for this run.'
-                icon = ifa6.ICON_FA_PLAY if status<process.State.Completed else ifa6.ICON_FA_ARROW_ROTATE_RIGHT
+                icon = ifa6.ICON_FA_PLAY if status<process_pool.State.Completed else ifa6.ICON_FA_ARROW_ROTATE_RIGHT
             if not possible:
                 imgui.begin_disabled()
             if imgui.selectable(icon+f" {a.displayable_name}", False)[0]:
@@ -1343,10 +1344,10 @@ class GUI:
                 else:
                     hover_text = process.get_impossible_reason_text(a, actions, for_recording=True)
                 status = [sess.recordings[r].state[a] for r in to_run]
-                status = max(status) if status else process.State.Not_Run
+                status = max(status) if status else process_pool.State.Not_Run
                 if a.has_options and possible:
                     hover_text += '\nShift-click to bring up a popup with configuration options for this run.'
-                icon = ifa6.ICON_FA_PLAY if status<process.State.Completed else ifa6.ICON_FA_ARROW_ROTATE_RIGHT
+                icon = ifa6.ICON_FA_PLAY if status<process_pool.State.Completed else ifa6.ICON_FA_ARROW_ROTATE_RIGHT
             if not possible:
                 imgui.begin_disabled()
             if imgui.selectable(icon+f" {a.displayable_name}##{session_name}", False)[0]:
@@ -1490,7 +1491,7 @@ class GUI:
         if session_level_actions and imgui.begin_table(f'##{sess.name}_session_level', 2, imgui.TableFlags_.sizing_fixed_fit):
             for a in session_level_actions:
                 imgui.table_next_column()
-                session_lister.draw_process_state(sess.state[a])
+                gt_gui.utils.draw_process_state(sess.state[a])
                 imgui.table_next_column()
                 imgui.selectable(a.displayable_name, False, imgui.SelectableFlags_.span_all_columns|imgui.SelectableFlags_.allow_overlap)
                 if (a in menu_actions or a in menu_actions_running) and imgui.begin_popup_context_item(f"##{sess.name}_{a}_context"):
@@ -1506,7 +1507,7 @@ class GUI:
                         if a.has_options and possible:
                             hover_text += '\nShift-click to bring up a popup with configuration options for this run.'
                         status = self.sessions[sess.name].state[a]
-                        icon = ifa6.ICON_FA_PLAY if status<process.State.Completed else ifa6.ICON_FA_ARROW_ROTATE_RIGHT
+                        icon = ifa6.ICON_FA_PLAY if status<process_pool.State.Completed else ifa6.ICON_FA_ARROW_ROTATE_RIGHT
                     if not possible:
                         imgui.begin_disabled()
                     if imgui.selectable(icon+f" {a.displayable_name}##{sess.name}", False)[0]: