Control panel - shlomitya/eye-tracker-analyzer GitHub Wiki

To the right of the Data Inspector GUI is a control panel. The upper part of the panel toggles between Subjects (ETA files), Trials (trigger segments) and detected saccades. The middle part of the panel controls the data panels visualization, such as zooming in and out, as well as actions relating to manual changes. At the bottom of the control panel are actions buttons to save, finish, or cancel the data inspection.

The upper part of the panel contains several buttons that allow toggling through subjects, trials, and saccades.

• Subject - The currently inspected subject. When two or more ETA files are analyzed, the upper < and > buttons allow the user to toggle between different Subjects (loaded ETA files).
• Trial Displayed - The subject's currently inspected segment, which can be toggled using the < and > buttons, or through the keyboard's left and right arrow keys.
• Center On - toggles between the current segment's detected saccades and centres the data panels on the next detected saccade. This option could be useful to quickly inspect the detection quality in long segments.

Under Tools are several buttons related to the visualization of the data panels and to manual changes.

• Refit Graphs - Adjusts the data panels y-axes to fit the current segment min and max values
• Pan (Hotkey: P) - Changes the cursor from Selection mode to Pan mode, which will be denoted by a change of the cursor's icon to a hand. Under this mode, the data panels could be dragged along their x- or y-axes via a left-mouse button click in order to display information that may be outside the visible scale.
• Select (Hotkey: S) - Changes the cursor from Pan mode to Selection mode, which will be denoted by a change of the cursor's icon to an arrow. This is the default mode used when opening the Data Inspector. In this mode, the user can perform several manual changes:
  • Discard saccade - Clicking on a detected saccade (either horizontal or vertical components, highlighted in green) will flag it as a false alarm and will discard it from the analysis. The discarded saccade (both vertical and horizontal components) will be marked in red. Clicking on a discarded saccade will undo the action.

• Force detect a saccade - Clicking on a gaze trace containing no detected saccades nor missing data will force the algorithm to search for a saccade in the vicinity of the clicked segment. The toolbox will run the saccade detection algorithm on the segment iteratively, adjusting the detection threshold to be less and less stringent, until a saccade is detected. The segment containing the new saccade will be marked in blue, and the new saccade will be included in all analyses. Clicking on a forced-detected saccade will undo the action.

• Drop data segment - Clicking on an empty position within the data panel using the left mouse button will define this position as the edge of a segment that needs to be dropped. This edge will be marked with a blue vertical line, and a second blue vertical line will follow the cursor. A second left mouse press on a different position will define the second edge of the segment that needs to be dropped. Clicking on the right mouse button after the first edge was defined will cancel the action.

Once both edges are defined, all samples within the defined segment will be discarded from further analysis. The segment will be painted pink to mark it as a discarded segment. Saccades detected during this duration will likewise be painted in pink and discarded from further analysis. To reinstate a data segment, click on an empty position within the data panel using the right mouse button to define the edge of a segment that needs to be reinstated. A second line will follow the cursor, and a second right mouse button press will define the second edge of the reinstated segment. All discarded samples within the segment will be reinstated along with all discarded saccades, allowing the cancellation of a previous manual discarding.

• Undo (Hotkey: ctrl + z) - Undos the last performed manual change action.
• Redo (Hotkey: ctrl + y) - Redos the last undone manual change action.
• Zoom In - Changes to Zoom In mode, which will be denoted by a change of the cursor's icon to a magnifying glass with a plus. In this mode, a box can be drawn within the data panel to refit the x- and y-axes scales to the box.
• Zoom Out - Changes to Zoom Out mode, which will be denoted by a change of the cursor's icon to a magnifying glass with a minus. Clicking on the data panel in this mode will decrease the x and y-axes scales.
• Re-extract saccades - Allows to rerun the saccade detection algorithm on the given datasets. Opens a dialogue containing all parameters within the analysis pane that are relevant to saccade detection, which can be edited to redo the detection. Notice: all manual changes performed will be discarded by this action.
• Reject-Restore Trial - Clicking this button will discard the current trial from further analysis, including all saccades detected within it. Trials rejected in this way will be marked by a red 'Rejected' label within the data panel. Clicking on this button on a currently rejected trial will restore the trial and remove the red label.

• Save - Saves any manual changes done to the current subject or subjects to the respective .ETA files. These changes will automatically be loaded when loading the same .ETA file using the same parameters, and will be displayed on the Data Inspector if "Perform Data Inspection" is selected. This process might take several minutes, depending on the size of the resulting .ETA files.
• Finish - Closes the Data Inspector and resumes the analysis. In case any manual changes were performed and the user has not saved the changes, a message will prompt the user to decide whether to save the changes to the respective .ETA files, continue with the analysis using the manual changes without saving them to the .ETA files, or cancel and resume data inspection.
• Cancel Analysis - Exits the Data Inspection without saving any manual changes. To cancel the analysis altogether, the user needs to press cancel again within the progress bar window.