MasterScan  Lab_Matlab_control Master Branch
List of all members | Properties and Events | Protected Properties | Private Properties | Methods | Protected Methods
dotsReadableEyeEOG Class Reference
Inheritance diagram for dotsReadableEyeEOG:
Inheritance graph
[legend]

Properties and Events

 deviceParameters
 dotsReadableEyeEOG More...
 
Property rawGainH = 100
 in seconds More...
 
Property blinkThreshold = 0.25
 The world's simplest blink filter (multiplied by rawGainV)
 
Property bufferHW = 50
 Smoothing window size (half-width, in samples)
 
- Properties and Events inherited from dotsReadableEye
Property x
 the current "x" position of the eye in user-defined coordinates.
 
Property y
 the current "y" position of the eye in user-defined coordinates.
 
Property pupil
 the current pupil size, offset and scaled
 
Property time
 The time of the most-recent sample (in ui time)
 
Property sampleFrequency
 frequency in Hz of eye tracker data samples More...
 
Property readEventsOnly = true
 Flag determining whether only to read event data see readNewData for details. More...
 
Property helpers
 helper objects including screen ensemble
 
 gazeMonitor
 Gaze monitor properties.
 
- Properties and Events inherited from dotsReadable
Property isAvailable = false
 

whether or not the object is ready to read() from


 
Property components
 

struct array with details about each component


 
Property state
 

matrix of ID, latest value, and latest time indexed by ID


 
Property history
 

matrix of component ID, value, and time from previous read()


 
Property isAutoRead = true
 

whether or not to to invoke read() during getValue(), etc.


 
Property eventDefinitions
 

struct array defining events of interest, indexed by ID


 
Property initialEventQueueSize = 100
 

initial size of queue for events of interest


 
Property clockFunction
 

any function that returns the current time as a number


 
Property filename
 

name of the data file for devices that store their own data


 
Property filepath
 

where the file is


 
Property recordDuringCalibration = true
 

controls whether or not to stop recording during calibration


 
Property useGUI = false
 Flag to use GUI for feedback, etc.
 
Property useExistingCalibration = false
 Flag to skip calibration routine.
 
Property calibrationUI
 Possibly use a keyboard or other UI to help with calibration.
 
Property deactivateEventsAtStartTrial =false
 Flag to deactivate all events at the beginning of each trial.
 

Protected Properties

Property componentNames = {'x', 'y'}'
 Define data component names.
 
Property bufferedVals = []
 Keep buffered data, for smoothing.
 
- Protected Properties inherited from dotsReadable
Property eventQueue
 

array of queued events (row indices into history)


 
Property queueNext
 

queue index of the next event to be dequeued


 
Property queueLast =0
 

queue index of the last event enqueued


 
Property isRecording =false
 

keep track of whether device is currenly writing to a data file


 
Property didCalibrate = true
 Keep track of whether calibration occurs.
 
Property defaultEventPrefix = 'event'
 Default prefix for event names: <prefix>_<componentName>
 
Property eventSets
 Strutures with different named event definitions, in case we want to quickly swap between them.
 

Private Properties

Property aInDevice
 Analog input device.
 
Property inputIndex
 Index into current data stream.
 
Property blankData
 blank data matrix, to compute once and copy when we get data
 
Property blankID = -1
 dummy index
 

Methods

self dotsReadableEyeEOG ()
 % Public methods More...
 
 startTrialDevice (self)
 beginTrial More...
 
 finishTrialDevice (self)
 endTrial More...
 
 preview (self, duration)
 for debugging
 
- Methods inherited from dotsReadable
self dotsReadable ()
 

Constructor takes no arguments.


 
 initialize (self)
 

Locate, acquire, configure, etc. device and component resources.


 
 calibrate (self, varargin)
 

Calibrate the device

More...
 
 record (self, onFlag, filename)
 

Open/close data file associated with the device Arguments: onFlag ...

More...
 
 reset (self, varargin)
 reset device More...
 
 close (self)
 

Release any resources acquired by initialize().


 
 delete (self)
 

Automatically close when Matlab is done with this object.


 
 read (self)
 

Add incoming data to history and detect events of interest.

More...
 
 flushData (self, waitForNoEvents)
 

Delete historical data and reset the current state.

More...
 
 logData (self)
 

Record current and historical data in topsDataLog.

More...
 
stateAtTime getState (self, time)
 

Get the state of device components as of the given time.

More...
 
value data getValue (self, ID)
 

Get the latest value for the given component.

More...
 
event defineEvent (self, name, varargin)
 

Define the event of interest for one of the input components.

More...
 
 defineEventsFromComponents (self, names, varargin)
 defineEventsFromComponents More...
 
 defineEventsFromStruct (self, eventStruct, setName, keepExisting, inactivate)
 defineEventsFromStruct More...
 
 showActiveEvents (self)
 Mostly for debugging.
 
 activateEventSet (self, name)
 Swap in a set of events.
 
 activateEvents (self)
 Activate all events. More...
 
 deactivateEvents (self)
 Deactivate all events. More...
 
activeFlags getActiveFlags (self)
 Get all active flags.
 
 setActiveFlags (self, activeFlags)
 Set all active flags from array.
 
 setEventsActiveFlag (self, activateList, deactivateList)
 Set/unset activeFlag. More...
 
name data getNextEvent (self, isPeek, acceptedEvents)
 

Get the next event that was detected in read().

More...
 
lastName lastID names IDs getHappeningEvent (self, time)
 

Get events that are happening at the current time.

More...
 
name waitTime data waitForEvents (self, eventNames, maxWait)
 Wait for event(s)
 
nEvents getNumberOfEvents (self)
 

Get the number of events in eventQueue.

More...
 
IDs getComponentIDs (self)
 

Get an array of unique integer component IDs.

More...
 
ID getComponentID (self, nameOrID)
 

Get ID of component by name or ID


 
name getComponentName (self, nameOrID)
 

Get name of component by name or ID


 
indices getComponentIndicesByID (self, IDs)
 

Get array of indices for the given component IDs


 
indices getComponentIndicesByName (self, names)
 

Get array of indices for the given component names


 
time getDeviceTime (self)
 

Get the current time from clockFunction.


 
 setDeviceTime (self, val)
 

Set the device time


 
 startTrial (self, varargin)
 

startTrial()

More...
 
 finishTrial (self, varargin)
 

finishTrial()

More...
 
 plotData (self)
 

Open a figure with continuously read device data.

More...
 
 startTrialDevice (self, varargin)
 Overloaded methods.
 

Protected Methods

isOpen openDevice (self)
 % Protected methods More...
 
components openComponents (self)
 Overloaded openComponents method: just x and y.
 
newData readRawEyeData (self)
 % readRawEyeData More...
 
fixXY getFixation (self, timeout, waitForSaccade, doTransform)
 % Get current fixation
 
newData transformRawData (self, newData)
 % Transform the normalized x/y eye data into screen coordinates with units of degrees visual angle
 
 setupCoordinateRectTransform (self)
 % Override default setupCoordinateRectTransform function from dotsReadableEye because we do our own calibration here and don't want to use those transformations
 
 closeDevice (self)
 % Close the communication channels with pupilLab
 
- Protected Methods inherited from dotsReadable
isOpen openDevice (self)
 

Locate and acquire input device resources (for subclasses).

More...
 
 closeDevice (self)
 

Release input device resources (for subclasses).

More...
 
 resetDevice (self, varargin)
 Reset the device.
 
status calibrateDevice (self, varargin)
 

Calibrate the device (for subclasses).

More...
 
isRecording startRecording (self)
 

Turn on data recording from the device (for subclasses).


 
isRecording stopRecording (self)
 

Turn off data recording from the device (for subclasses).


 
components openComponents (self)
 

Locate and acquire device components (for subclasses).

More...
 
 closeComponents (self)
 

Release device components (for subclasses).

More...
 
newData readNewData (self)
 

Read and format incoming data (for subclasses).

More...
 
isEvent detectEvents (self, data)
 

Use new data to look up events of interest (used internally).

More...
 
newSize resizeEventQueue (self, minSize, doClear)
 

Resize and optionally clear the event queue (used internally).

More...
 
nEvents enqueueEvents (self, eventValues)
 

Add events of interest to the event queue (used internally).

More...
 
eventValue nEvents dequeueEvent (self, isPeek)
 

Remove the next queued event of interest (used internally).

More...
 

Additional Inherited Members

- Static Methods inherited from dotsReadable
static isHappening data readable isEventHappening (readables, eventName)
 

Is the named event happening now?

More...
 
static didHappen waitTime data readable name waitForEvent (readables, eventName, maxWait)
 

Wait for the named event to happen.

More...
 
static data loadDataFile (filename, varargin)
 Load data from file. More...
 

Constructor

◆ dotsReadableEyeEOG()

% Public methods

Constructor method

Methods

◆ startTrialDevice()

startTrialDevice ( self  )

beginTrial

Start scan at the beginning of each trial

◆ finishTrialDevice()

finishTrialDevice ( self  )

endTrial

Stop scan at the end of each trial

◆ openDevice()

isOpen openDevice ( self  )
protected

% Protected methods

% openDevice This function connects this instance to the 1208FS device.

◆ readRawEyeData()

newData readRawEyeData ( self  )
protected

% readRawEyeData

Get EOG data.

Properties and Events

◆ deviceParameters

deviceParameters
Initial value:
= struct( ...
'channels', [0 1], ...
'gains', [4 4], ...
'frequency', 1000, ...
'duration', 20)

dotsReadableEyeEOG

This class implements code for Matlab to read eye-movement signals via the electrooculogram (EOG). [ADD NOTES ABOUT ELECTRODE PLACEMENT] 10/04/18 created by jig Parameters for communicating with the input device On the 1208FS: channel 0, differential mode is pins 1 and 2 channel 1, differential mode, is pins 4 and 5

◆ rawGainH

Property rawGainH = 100

in seconds

Gains to apply to the raw inputs, which is useful for visualizing the data on the eye monitor before calibration


The documentation for this class was generated from the following file: