Page History: Saccade Detector Element

Compare Page Revisions

Page Revision: 2016/05/16 19:42

	Saccade Detector Element
Info
Category:	Eye-tracking analysis		AddIn:	Eye-tracking analysis
Creator:	OkazoLab Team		Scope:	Parent Event
Owns Snippets:	no		Usage:	Presentation Screen,Status Screen, Code snippets

The element allows/is capable of doing something in experiments

Actions aligned with epochs of the parent event ¶

Epoch	Actions
After experiment onset	The element ...
Event rendered
Before event onset
After event onset
Control loop step	The element ...
Before event offset
Before experiment offset	The element ...

Properties ¶

Generic Properties ¶

Name	Property description	Constraints	Type	Upon change
Triggering
Triggering Mode	Defines the triggering mode for saccade detection	Design Time..	enum
Triggering Time	Returns a local event time (in ms) of the last button triggering. The value can be used an accurate measure of the response time	Status..	clTime
Is Triggered	Indicates whether a button has been triggered at least once, since the onset of the parent event. This property can be naturally used to gate switching between events.	Normal..	Boolean
General Plot Settings
Show Axis		Normal..	Boolean
Rendering Size	Defines the size of the generated XAML staircase plot in pixels. The plot is automatically stretched on rendering, but a larger rendering size improves the chart quality with some cost in performance. The rendering size is also used as the resulting image resolution, when the chart is saved into a file.	Design Time..	clSize
Show Gridlines		Normal..	Boolean
Add Screen Clone		Design Time..	enum
High-Quality Rendering		Normal..	Boolean
Plot Theme		Normal..	Int32
Fixaccade Plot Settings
Fixaccade Plot Title		Normal..	String
Saccade Points Color		Normal..	stColor
Fixation Points Color		Normal..	stColor
Line Thickness		Normal..	Double
Velocity Plot Settings
Velocity Plot Title		Normal..	String
Threshold Color		Normal..	stColor
Velocity Line Color		Normal..	stColor
Line Thickness		Normal..	Double
Saccade Label Color		Normal..	stColor
Results
Reset Plot Now	Provides a runtime command that resets the plotted data. Assign 'true' in the snippets to invoke the command.	WriteOnly..	Boolean
XAML Fixaccade Plot	Returns a live XAML control that can be used for direct binding to the Content property of the XAML ContentControl element, e.g. ContentControl with a generated staircase plot can be added to the status screen or to the XAML Layout element.	Status..	UIElement
Save Fixaccade Plot Now	Assign a filename to save the generated plot at runtime	Normal..	clDesignAction
Preview Fixaccade Plot	Open a window with the plot preview	Design Time..	clDesignAction
XAML Velocity Plot	Returns a live XAML control that can be used for direct binding to the Content property of the XAML ContentControl element, e.g. ContentControl with a generated staircase plot can be added to the status screen or to the XAML Layout element.	Status..	UIElement
Save Velocity Plot Now	Assign a filename to save the generated plot at runtime	Normal..	clDesignAction
Preview Velocity Plot	Open a window with the plot preview	Design Time..	clDesignAction
Detection Results
All Saccades		Status..	clSaccadeInfo
Saccade Number		Status..	Int32
Last Saccade		Status..	clSaccadeInfo
Current X Velocity		Status..	Double
Current Y Velocity		Status..	Double
Gaze Processing
Radar Provider	Defines which of the radar providers is used for positional input in this event. In each experiment, the radar providers includes the system mouse and all tracker elements. The selected radar provider controls the Radar Point property and input to the AOI elements in this event. When 'Auto' is chosen, the first tracker element is picked up. If there are no tracker elements, the system mouse is used by default.	Design Time..	String
AOI		Normal..	Int32
Sampling Rate	Defines the sampling rate of the tracker hardware in Hz. You can keep the zero value for auto-detection.	Normal..	Double
Analysis Window Size	Defines the size of a moving analysis window in samples. The value also defines the data range in all generated plots.	Design Time..	Int32
Exclusive Thresholds	Defines whether the exclusive velocity and saccade thresholds are used by this element. The default value is false, which means that the same threshold values are shared with all eye-tracking analysis elements.	Design Time..	Boolean
X Velocity Threshold	Defines the saccade velocity threshold for the X-axes.	Normal..	Double
Y Velocity Threshold	Defines the saccade velocity threshold for the Y-axes.	Normal..	Double
Minimal Saccade Duration	Defines the minimal duration threshold (in ms.) for the velocity-based saccade detection. If a candidate saccade shorter than the threshold, it's discarded after completion. Note that, the element can still be triggered at the start and peak velocity of the discarded saccades, when the triggering mode is not 'On the saccade end'. If you do not want to apply the minimal duration threshold, set the zero value.	Normal..	Double
Maximal Saccade Duration	Defines the maximal duration threshold (in ms.) for the velocity-based saccade detection. If a candidate saccade shorter than the threshold, it's discarded after completion. Note that, the element can still be triggered at the start and peak velocity of the discarded saccades, when the triggering mode is not 'On the saccade end'. If you do not want to apply the maximal duration threshold, set the zero value.	Normal..	Double
Control
Is Enabled	If set to false the element is completely omitted when the experiment is run.	Design Time..	Boolean
Title	Title of the element	Design Time..	String

+=== Properties inherited from clElement === Inherited properties of clElement

Name	Description	Constraints	Value Type	Upon Change
Control
Is Enabled	If set to false the element is completely omitted when the experiment is run.	Design Time..	Boolean
Title	Title of the element.	Design Time..	String

¶

Description ¶

Snapshots ¶

Snapshot 1

Snapshot 2

Saccade Record ¶

Practical Use ¶

Technique 1 ¶

1. Step 1
2. Step 2
   

Technique 2 ¶

1. Step 1
2. Step 2
   

 // Check the trial outcome. Result and RT just other user variables
// insert code snippet here..

Notes ¶

• Insert Notes here..
• Insert Notes here..