Fixation Detector Element

Modified on 2018/08/03 05:15 by Administrator Categorized as Elements, Eye-tracking analysis
<div style="margin-right: 10px; margin-left: 16px; margin-bottom:10px; float: right; width: 500px; overflow: hidden; height: auto; padding: 0px; background: #fafafa; background: -webkit-gradient(linear, left top, left bottom, from(#fbfbfb), to(#fafafa));background: -moz-linear-gradient(top, #fbfbfb, #fafafa);border: 1px dashed #ddd;box-shadow: 0 0 0 3px #fff, 0 0 0 5px #ddd, 0 0 0 10px #fff, 0 0 2px 10px #eee;">
== Summary ==
{s:Element Info Panel
| title=Fixation Detector
| category=Eye-tracking Analysis
| icon=[image|Element Icon|{UP(Fixation-Detector-Element)}Fixation-Detector-Element-Icon.png]
| author= OkazoLab
| addin= Eye-tracking analysis
| scope= Parent event
| usage= Snippets
| ownsnippets= None
}
== Properties ==
{|
|-
! Name
! Description                              
! Constraints
! Type
! On<br/>runtime<br/>change
|-
| colspan="5" bgcolor="#AADDDDD" | Triggering
|-
| Triggering Mode        
| Defines the triggering mode for fixation detector        
| {s:atDesign}        
| enFixa..        
|  
|-
| Fixation Duration        
| Defines the minimal fixation duration (in ms.) for triggering, when the triggering mode is set to 'Minimal fixation duration'        
| {s:atNormal}        
| Double        
|  
|-
| Triggering Time        
| Returns a local event time (in ms) of the last successful detection        
| {s:atStatus}        
| clTime        
|  
|-
| Is Triggered        
| Indicates a successful detection, in accordance with the current triggering mode. The property is automatically reset to 'false' on the onset of the parent event. You can reset the property manually, e.g. for catching multiple detections in a row.        
| {s:atNormal}        
| Boolean        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | General Plot Settings
|-
| Show Axis        
|         
| {s:atNormal}        
| Boolean        
|  
|-
| Rendering Size        
| The rendering size also defines the image resolution, when the plot is saved into an image file or video.        
| {s:atNormal}        
| clSize        
|  
|-
| Show Gridlines        
| Defines whether the major tick gridlines are shown on the plot.        
| {s:atNormal}        
| Boolean        
|  
|-
| Add Screen Clone        
| Defines whether a clone of the presentation screen is shown at the background of the plot.        
| {s:atDesign}        
| enScre..        
|  
|-
| Rendering Quality        
| Defines the quality and speed the plot rendering        
| {s:atNormal}        
| Int32        
|  
|-
| Plot Theme        
| Defines a visual theme for the plot        
| {s:atNormal}        
| Int32        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | Fixaccade Plot Settings
|-
| Fixaccade Plot Title        
|         
| {s:atNormal}        
| String        
|  
|-
| Saccade Points Color        
|         
| {s:atNormal}        
| stColor        
|  
|-
| Fixation Points Color        
|         
| {s:atNormal}        
| stColor        
|  
|-
| Line Thickness        
|         
| {s:atNormal}        
| Double        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | Velocity Plot Settings
|-
| Velocity Plot Title        
|         
| {s:atNormal}        
| String        
|  
|-
| Threshold Color        
|         
| {s:atNormal}        
| stColor        
|  
|-
| Fixation Line Color        
|         
| {s:atNormal}        
| stColor        
|  
|-
| Line Thickness        
|         
| {s:atNormal}        
| Double        
|  
|-
| Saccade Line Color        
|         
| {s:atNormal}        
| stColor        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | Results
|-
| Reset Plots Now        
| Runtime command that resets the plotted data. Assign 'true' in the snippets to execute the command.        
| {s:atRuntimeAction}        
| 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 Content='{Binding OnlineChart}'/> ContentControl with a generated staircase plot can be added to the status screen or to the XAML Layout element.        
| {s:atNormal}        
| UIElem..        
|  
|-
| Save Fixaccade Plot Now        
| Assign a fully specified filename to save the generated plot        
| {s:atRuntimeAction}        
| String        
|  
|-
| Preview Fixaccade Plot        
| Open a window with the fixaccade plot preview        
| {s:atRuntimeAction}        
| Boolean        
|  
|-
| 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 Content='{Binding OnlineChart}'/> ContentControl with a generated staircase plot can be added to the status screen or to the XAML Layout element.        
| {s:atNormal}        
| UIElem..        
|  
|-
| Save Velocity Plot Now        
| Assign a filename to save the generated plot at runtime        
| {s:atRuntimeAction}        
| String        
|  
|-
| Preview Velocity Plot        
| Open a window with the plot preview        
| {s:atRuntimeAction}        
| Boolean        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | Detection Results
|-
| All Fixations        
|         
| {s:atStatus}        
| clFixa..        
|  
|-
| Fixation Number        
|         
| {s:atStatus}        
| Int32        
|  
|-
| Last Fixation        
|         
| {s:atStatus}        
| clFixa..        
|  
|-
| Total Fixation Duration        
|         
| {s:atStatus}        
| clTime        
|  
|-
| Current X Velocity        
| Returns the current gaze velocity along the X-axes. The value is read-only.        
| {s:atStatus}        
| Double        
|  
|-
| Current Y Velocity        
|         
| {s:atStatus}        
| Double        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | Gaze Processing
|-
| Tracking Device        
| Defines what tracking device provides positional samples for the element. The tracking devices include eye-trackers, the mouse and touch-screens. The 'Auto' option chooses the tracking device selected in the parent event. If there are no tracking elements enabled in the experiment, the system mouse is always used.        
| {s:atDesign}        
| String        
|  
|-
| Sampling Rate        
| Defines the sampling rate of the tracking device  hardware in Hz. Keep the zero value for auto-detection.        
| {s:atNormal}        
| 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        
| {s:atDesign}        
| Int32        
|  
|-
| Exclusive Thresholds        
| Defines whether the exclusive velocity and saccade duration thresholds are used for the fixation detection by this element. The default value is false, which means that the same threshold values are shared with all eye-tracking analysis elements.        
| {s:atDesign}        
| Boolean        
|  
|-
| X Velocity Threshold        
| Defines the saccade velocity threshold for the X-axes        
| {s:atNormal}        
| Double        
|  
|-
| Y Velocity Threshold        
| Defines the saccade velocity threshold for the Y-axes        
| {s:atNormal}        
| Double        
|  
|-
| Minimal Saccade Duration        
| Defines the minimal saccade duration threshold (in ms.) for the velocity-based detection algorithm. If a saccade candidate 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.        
| {s:atNormal}        
| Double        
|  
|-
| Maximal Saccade Duration        
| Defines the maximal duration threshold (in ms.) for the velocity-based detection algorithm. 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.        
| {s:atNormal}        
| Double        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | AOI
|-
| Element AOI        
| Selects a visual element, whose viewport defines an on-screen AOI for the eye-tracking analysis.        
| {s:atNormal}        
| Int32        
|  
|-
| Custom AOIs        
| Selects a visual element, whose viewport defines an on-screen AOI for the eye-tracking analysis.        
| {s:atNormal}        
| IColle..        
|  
|-
| colspan="5" bgcolor="#AADDDDD" | Control
|-
| Is Enabled        
| If set to false the element is completely omitted when the experiment is run        
| {s:atDesign}        
| Boolean        
|  
|-
| Title        
| Title of the element        
| {s:atDesign}        
| String        
|  
|-            
|}
== ==
</div>
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
<!--*****************************************************************************************************************************************************************************-->
'''Fixation Detector Element''' analyzes a position stream from an arbitrary tracking device (e.g. an eye-tracker) and detects fixation states in a real-time.<br><br>
{TOC}

== Demo Video==
<iframe width="560" height="315" src="https://www.youtube.com/embed/GZnPoAOsXto" frameborder="0" allowfullscreen></iframe>

== Snapshots ==
{|
| [imageleft|Snapshot 1 <br/>|{UP(page-name)}*-sm.png|{UP(page-name)}*.png]
|| [imageleft|Snapshot 2 |{UP(page-name)}*-sm.png|{UP(page-name)}*.png]
|}

== Practical Use ==
=== Technique 1 ===

# Step 1
# Step 2

=== Technique 2 ===

# Step 1
# Step 2

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

== Extra Notes ==
== Notes ==

* Insert Notes here..
* Insert Notes here..
Meta Keywords: Fixation
Meta Description:
Change Comment:
EventIDE Wiki

Navigation¶

Fixation Detector Element
