dotPath

 elements

A dot moving on any 2-D path. Each element is based on time series data that is a 2×n matrix: (x, y) × images. Default frame rate = 120 frames/sec. An example data set is included in a file called dotPathData.mat in <PsychBench folder>/docs/element.

Note the standard Psychtoolbox/PsychBench screen coordinate convention applies: +x = right, +y = down on screen (like reading). If your data has +y = up, just set property flipVert = <cd>true<cd>.

For each trial you define in an experiment script, you can make one or more 

dotPath

 objects using 

dotPath

Object and input them to addTrial.

For each trial you define in an experiment script, you can make one or more 

dotPath

 objects using 

dotPath

Object and input them to addTrial.

Input properties

Adjustable properties

You can allow the subject to adjust the following input properties of an object of this type during the experiment using an adjuster element. If you need to make other properties adjustable, you can copy the element type using newPbType and edit it.

position
nn_eyes
rotation
opacity

(None)

(None)

fileName    
dataExpr    
fps        

No defaults: fileName, dataExpr
Default: fps = 120 frames/sec

These properties point to the the time series data to use, which is a 2×n matrix (see above). You can load the data from a file or get it from a variable in the base MATLAB workspace:

fileName is a string that is name of a .mat file containing the data. Include path if the file is not in the MATLAB current folder or search path (or not the first file with that name on the search path). The file can contain multiple data sets—if so, use dataExpr below to specify. <cd>[]<cd> = don't load from file—get data from the base MATLAB workspace.

dataExpr is a string that is variable name and possibly indexes/field names to get to the data. Set this to load from a file containing multiple data sets or to get from the base MATLAB workspace.

e.g.

fileName = <cds>"data.mat"<cds>
-> data in file data.mat, which contains only one data set

fileName = <cds>"data.mat"<cds>
dataExpr = <cds>"dataVar{2}"<cds>
-> cell 2 of cell array dataVar in file data.mat

dataExpr = <cds>"dataVar"<cds>
-> variable dataVar in base MATLAB workspace

dataExpr = <cds>"dataVar{2}"<cds>
-> cell 2 of cell array dataVar in base MATLAB workspace

fps is frame rate of the data (frames/sec), i.e. 1/fps = time interval between points in the data.

height
sizeMult

Default: show at 10 deg height

Set either height (absolute size) or sizeMult (relative size):

height sets height directly (deg). Here height is the greatest vertical distance spanned by the dot across time.

OR

sizeMult is a conversion factor from whatever distance units the data is in to deg visual angle. i.e. the conversion factor has units deg visual angle / data distance units, and just multiplies the data. sizeMult is useful when you want to preserve relative sizes between different data sets by setting it equal across different dotPath elements.

speed

Default: normal speed

Motion speed, including reverse motion. 1 = normal, 0.5 = half speed, 2 = double speed, -1 = reverse normal, etc.

dotSize

Default: 0.2 deg

dotSize is dot diameter (deg). 0 = don't show dots.

color

Default: white

A 1×3 RGB vector with numbers between 0–1.

repeat          
breakInterval

Default: repeat = show indefinitely by repeating until a cue you set in property end
Default: breakInterval = no interval between repeats

repeat = <cd>true<cd>/<cd>false<cd>: show indefinitely by repeating until a cue you set in property end occurs. If <cd>false<cd>, the element ends on its own at end of data.

breakInterval sets an interval between repetitions where nothing shows (sec). 0 = none.

startTimeInPath

Default: 0

Start time in the time series data (sec).

Input properties all visual elements have

position

Input properties all adjuster elements have

adjust

Input properties all objects have

report
info

Record properties

PsychBench uses record properties to record information during experiments. You can't set record properties but you can see them in experiment results using input property report.