Page History: EyeLink Tracker Element

Compare Page Revisions

Page Revision: 2016/05/17 17:50

	EyeLink Tracker Element
Info
Category:	Eye Trackers		AddIn:	EyeLink eye-tracking
Creator:	OkazoLab Team		Scope:	Entire experiment (global)
Owns Snippets:	no		Usage:	Runtime Screen,Snippets

Actions aligned with epochs of the parent event ¶

Epoch	Actions
After Onset	The element starts analyzing the selected signal
Control Loop step	Latest signal samples is analyzed within the selected analysis window and the signal plot gets updated.
Before Offset	The element stops analyzing the selected signal

Properties ¶

Generic Properties ¶

Name	Description	Attributes	Value Type	Proxy Changed Actions
EyeLink settings
Remote IP Address	The network address of a EyeLink computer in IP format: xxx.xxx.xxx.xxx	Design Time..	String
Gaze Mode	Indicates what eye is used for tracking within EventIDE via the Radar properties.	Design Time..	stTrackedTarget
Filters
Blinks via Pupil Size	If true, the detection of blinks based on the zero pupil size is used.	Normal..	Boolean
Min Pupil Size	Threshold for pupil size. If measured value is smaller that given value a blink is detected instead of a change in the eye position.	Normal..	Single
Smoothing Ratio	Defines a ratio for the fast FIR smoothing filter, which is applied to the gaze tracking within EventIDE. The filter convolves every new tracking position with the previous ones. The property value defines a tap weight for the previous data, such that the convolution looks like: X=(Xn*(1-Ratio)+Xn-1*Ratio)/2. The value has to be positive and less than 1 (0 means no filtering).	Normal..	Double
Tracker Samples
Current Samples	Returns an array of Array the raw tracker samples taken in the last iteration of the control loop.	Status..	Sample
Newest Sample	Returns the newest raw tracker sample taken in the last iteration of the control loop.	Status..	Sample
EDF Logging
EDF log Folder		Design Time..	String
Is EDF Logging	Turn on/off logging with EDF file on the EyeLink host computer.	Design Time..	Boolean
Include Events	Turn on/off EyeLink events logging in EDF file.	Design Time..	Boolean
Send Message	Runtime command that sends a custom EDF message (if the EDF Logging is enabled) to an EDF file	WriteOnly..	String

+=== Properties inherited from clTrackerElement ===

Name	Description	Constraints	Type	Upon Runtime Change
GLM Calibration
Run GLM Calibration	Runs the GLM calibration procedure, which calculates two pairs of linear coefficients for mapping of the tracker input into the screen coordinates. The calculated coefficients are automatically applied at runtime.	Designtime Command..	Boolean
Gain X	Defines the gain coefficient for the X axis in the GLM calibration model: X='GainX'*x+OffsetX		Double
Gain Y	Defines the gain coefficient for the Y axis in the GLM calibration model: Y=GainY*y+OffsetY		Double
Offset X	Defines the offset coefficient for the X axis in the GLM calibration model: X=GainX*x+OffsetX		Double
Offset Y	Defines the offset coefficient for the Y axis in the GLM calibration model: Y=GainY*y+OffsetY		Double
Drift Correction
Recalibrate Now	Runtime command that helps to correct drifts in tracking data.Correction is done by recalibration of the latest tracker position into a custom screen point defined by the 'Recalibration Point' property.nAs result, the offsets of the GLM calibration get adjusted (but not gains) to compensate a drift in further data.	Runtime Command..	Boolean
Recalibration Point	Defines the screen point to which the tracker position will be recalibrated on calling 'Recalibrate Now' action. The default auto value always denotes the screen center.	Normal..	clPoint
Logging
Log Folder	Opens the dialog for selecting a local folder that will hold all tracking logs	Designtime Command..	String
Open Log Designer	Opens a designer window where the log format can be defined.	Designtime Command..	Boolean
Is Logging	Defines whether logging is turn on/off. The value can be changed at any moment at runtime allowing selective logging during the relevant periods only.	Normal..	Boolean
User Field	Defines the custom user data that is added to every line in the log file. The property can be used for recording varying status information (e.g. trial number) together with the tracker data. The string value may contains multiple fields separated by delimiter.	Normal..	String	Once a string value is assigned, it is added to every new upcoming line in the log until a new assignment is made.

+=== 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

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..