SMI Tracker Element

Modified on 2018/08/03 05:43 by Administrator — Categorized as: Elements, Eye Trackers

Summary

Element Icon SMI Tracker
Info
Category: Eye trackers AddIn: SMI
Creator: OkazoLab Scope: Experiment
Owns Snippets: None Usage: Snippets

Synchronized actions

EpochActions
On Experiment Start                        Starts processing tracker samples
On Experiment Start                        Stops processing tracker samples

Properties

NameDescription                              ConstraintsTypeOn
runtime
change
SMI Settings
License Key        The network address of the remote SMI computer in IP format: xxx.xxx.xxx.xxx                String         
SMI address        The network address of the remote SMI computer in IP format: xxx.xxx.xxx.xxx                String         
SMI port        The UPD port number on the remote SMI computer                Int32         
Local address        The network address of the given computer in IP format: xxx.xxx.xxx.xxx                String         
Local port        The UPD port number on the given computer that is used for communication with the SMI eye-tracker                Int32         
Gaze Mode        Defines which eye is used for gaze tracking within EventIDE via the radar properties of events                enTrac..         
System Info        The system info of SMI tracker                System..         
Tracker Samples
Newest Samples        Returns an array of the most recent tracker samples. The array is updated every Control Loop cycle.                Sample..         
Newest Sample        Returns the newest tracker sample. The sample is updated every Control Loop cycle.                Sample..         
SMI Events
Event Triggering        Turn on/off triggering by an incoming SMI event                Boolean         
Is Triggered        Indicates whether any SMI event has triggered the element atleast once  while the parent event is active                Boolean         
SMI Event        Exposes a content of the most recently received SMI event                EventS..         
SMI Logging
SMI Log Folder        Select a folder for storing the generic SMI logs                String         
Is SMI Logging        Turn on/off generic SMI logging                Boolean         
Log Level        Level of info in the SMI generic log files                Int32         
Send Message Now        Runtime command (SMI logging has to be enabled) that writes a custom text message into the SMI log file                String         
Remote Commands
SMI Command        The text of the command (max 256 chars) that will be send to the tracker on Send Command action                String         
Send Command        Set to true in a code snippet at runtime to send the current value of SMI Command to the tracket                Boolean         
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.                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         
Affine Mode        Defines the affine transformation (scale, translation and rotation) is used for calibration instead on the simpler GLM transformation (scale and translation)                Boolean         
Affine Rotation        Defines the rotation angle (deg) for the affine calibration                Double         
Save Calibration Now        Provides a runtime command that saves the current GLM calibration into a XML file. To run the command at runtime, assign a file name to this property.                String         
Load Calibration Now        Provides a runtime command that loads the GLM calibration values from a XML file. To run the command at runtime, assign a file name to this property.                String         
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.                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.                clPoint         
Filters
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).                Double         
Logging
Log Folder        Opens the dialog for selecting a local folder that will hold all tracking logs                String         
Open Log Designer        Opens a designer window where the log format can be defined.                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.                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.                String         
Runtime
Radar Point        Returns the newest calibrated tracking position provided by the tracker at runtime                clPoint         
Perspective Correction
Perspective Correction        Defines...                Boolean         
Configure Perspective                        Boolean         
Viewer Position        Defines...                Point3D         
Tracker Position        Defines...                Point3D         
Focal Length        Defines...                Double         
Control
Is Enabled        If set to false the element is completely omitted when the experiment is run                Boolean         
Title        Title of the element                String         

SMI Tracker Element enables support for all models of SMI eye-trackers in EventIDE. Important note: the SMI SDK has to be installed on a computer before using this element. Another option is to get the iViewXAPI.dll from SDK and place manually in the AddIns subfolder.

Description

...

Snapshots

Snapshot 1

Snapshot 1

Snapshot 2

Snapshot 2

Practical Use

...

Technique 1

  1. Step 1
  2. Step 2
    ...
    === Technique 2 ===
  3. Step 1
  4. Step 2
    ...

     // Check the trial outcome. Result and RT just other user variables
    
    // insert code snippet here..
               
    ...
    == Notes ==
    ...
  5. Insert Notes here..
  6. Insert Notes here..