Welcome Guest, you are in: Login

ScrewTurn Wiki

RSSRSS

Navigation




Search the wiki


PoweredBy

Bee Monitor Element

RSS
Modified on 2016/05/08 11:33 by Maria Categorized as Usability Research
Element Icon New Element
Info
Category: AddIn: Base Elements
Creator: OkazoLab Team Scope: Parent Event
Owns Snippets: no Usage: Presentation Screen,Status Screen, Code snippets

Actions aligned with epochs of the parent event

EpochActions
After experiment onsetThe element ...
Event rendered
Before event onset
After event onset
Control loop stepThe element ...
Before event offset
Before experiment offsetThe element ...

Properties

Generic Properties

NameProperty descriptionConstraintsTypeUpon change
General Plot Settings
Show Axis Boolean
Adaptive Resizing Boolean
Rendering SizeDefines 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.clSize
Show Gridlines Boolean
Add Screen Clone enum
High-Quality Rendering Boolean
Plot Theme Int32
Bee Plot Settings
Plot TitleString
Show Gaze MarkerBoolean
Gaze Marker ColorstColor
Gaze Marker FillstColor
Gaze Marker ScaleDouble
Show Mouse MarkerBoolean
Mouse Marker ColorstColor
Mouse Marker FillstColor
Mouse Marker ScaleDouble
Results
XAML Bee PlotReturns 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.UIElement
Save Plot NowAssign a filename to save the generated plot at runtimeString
Review PlotOpen a window with the plot previewBoolean
Video Results
Video CapturingBoolean
Video EncoderDefines an encoder that will handle video compression for the recorded videos. The list contains all video encoders installed in OS.enum
Configure EncoderOpens a configuration dialog of the selected video encoder (of supported)Boolean
Frame RateInt32
Output FolderOpens a dialog for selecting a local folder to store recorded videosString
Detection Results
Fixation NumberInt32
Gaze Processing
Radar ProviderDefines 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.enum
AOI enum
Sampling RateDefines the sampling rate of the tracker hardware in Hz. Set zero value for auto-detection.Double
Exclusive ThresholdsDefines 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.Boolean
X Velocity ThresholdDefines the saccade velocity threshold for the X-axes.Double
Y Velocity ThresholdDefines the saccade velocity threshold for the Y-axes.Double
Minimal Saccade DurationDefines the minimal duration threshold (in ms.) for the velocity-based saccade detection. 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.Double
Maximal Saccade DurationDefines 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.Double

+=== Properties inherited from clElement === Inherited properties of clElement
NameDescriptionConstraintsValue TypeUpon Change
Control
Is EnabledIf set to false the element is completely omitted when the experiment is run.Boolean
TitleTitle of the element.String



Bee Monitor element allows monitoring gaze and mouse positions relative to the stimulus screen. Real-time updates of monitored plot can be captured into a video stream.


Description

The element generates a 'bee' plot showing gaze and mouse positions as markers superimposed over a replica of the stimulus screen. The plot can be monitored on the status screen and captured into a video file.

Snapshots

Snapshot 1

Snapshot 1

Snapshot 2

Snapshot 2


Video capturing

A screencast of the bee plot will be captured into a video file, if the Video capturing property is set to true. When capturing is enabled, the element creates a new video file on the onset of the parent event and ends recording on the offset. A name of the video file is automatically constructed of the current time and element's title. The file is stored in a selected folder or in the same folder with the experiment file.

The element allows selecting an encoder filter for video compression via the Video Encoder property. Since standard Windows encoders, e.g. 'Microsoft Video 1', may have problems with high-quality capturing, you can install and use any third-party video encoder. Many encoders allows adjusting encoding parameters, e.g. quality, via a configuration panel or configuration tool.

For all capturing tasks, we would recommend to use a free H.264/MPEG-4 encoder, called x264vfw. You can get the x264vfw installer on their project website. After the installation you can configure the x264vfm options via the Configure x264vfw tool.



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

ScrewTurn Wiki version 5.2.0.8. Some of the icons created by FamFamFam.