Areas of Interest (AOIs)
The AOI Editor allows you to draw areas of interest (AOIs) on top of the reference image or surface. You can draw anything from simple polygons to multiple disconnected shapes. This tool is available for use after a Reference Image Mapper or a Marker Mapper enrichment is completed.
Setup
AOI Editing and Drawing
Upon completion of the Reference Image Mapper or Marker Mapper enrichment, access the main view of the enrichment by navigating to the Enrichments tab and selecting Edit AOIs under the section Tools.
From there, you will enter the AOI editing view and you are ready to start drawing AOIs on your reference image or surface.
AOI Heatmap and Metrics
To visualize your AOI heatmap:
- Navigate to the
Visualizationstab. - Click on
Create Visualization. - Select
AOI heatmapand the enrichment to which it should be applied.
Within the AOI Heatmap view, users can specify the recordings to be included, the metric to be displayed, and which AOIs should be incorporated into the visualization.
Export Format
Through the Visualizations tab, in the AOI Heatmap view, you can download the final visualization displaying the metric of your interest in .png format.
Through the Downloads tab, you can download the AOI-related files as part of the enrichment folder. Note, that the following CSV files will be empty if no AOIs are defined for a specific enrichment.
aoi_fixations.csv
This file contains fixation events mapped on each area of interest.
| Field | Description |
|---|---|
| aoi id | Unique identifier of the corresponding area of interest. |
| section id | Unique identifier of the corresponding section. |
| recording id | Unique identifier of the recording this sample belongs to. |
| fixation id | Identifier of fixation within the section. The counter starts at the beginning of the recording. |
| fixation duration [ms] | Duration of the fixation in milliseconds. |
aoi_metrics.csv
This file contains standard fixation and gaze metrics on AOIs.
| Field | Description |
|---|---|
| aoi id | Unique identifier of the corresponding area of interest. |
| recording id | Unique identifier of the recording this sample belongs to. |
| recording name | Name of the recording this sample belongs to. |
| aoi name | Name of the corresponding area of interest. |
| average fixation duration [ms] | Average fixation duration for the corresponding area of interest in milliseconds. |
| total fixations | Total number of fixations for the corresponding area of interest in milliseconds. |
| time to first fixation [ms] | Average time in milliseconds until the corresponding area of interest gets fixated on for the first time in a recording. |
| time to first gaze [ms] | Average time in milliseconds until the corresponding area of interest gets gazed at for the first time in a recording. |
| total fixation duration [ms] | Total fixation duration for the corresponding area of interest in milliseconds. |
| total gaze duration [ms] | Total fixation duration for the corresponding area of interest in milliseconds. |