easyPlot(datastruct [,'window_size'] [,'bias'] [,'derivative'] [,'regressors'] [,'save'] [,'trials']) [] = optional parameters '' = parameter-value pairs


EASYPLOT provides a quick visual summary of the information contained in a datastruct generated by an easy* structure from the SuperPsychToolbox suite. It can be used for a quick check that everything is working properly, and that a participant is engaged in the study.


easyPlot(datastruct) displays an overview of all responses gathered by an easy* function (e.g., easyKeys, easyType). The datastruct should be a non-empty datastruct generated by one of these functions. easyPlot(datastruct,param1,val1,param2,val2...) sets various optional parameters. Parameters are case-insensitive, and each string parameter must be followed by a value as indicated: 'window_size' 2- or 4-element numeric array. If a specific window size or position for the plot is desired, this can be specified as a two-element array [width height] or four-element array [topL topR bottomL bottomR]. Default: [0 0 1280 768] 'bias' String. The generic behaviour of easyPlot can be altered to display plots relevant for monitoring technical diagnostics (did the experiment run properly?), behaviour output, or a general overview. These modes can be specified as 'diagnostic', 'behav', or 'overview', respectively. Default: 'overview' 'derivative' Non-negative integer scalar. Instead of plotting the raw values in timeseries, it is possible to compute temporal derivatives. Enter a scalar to identify the derivative of interest. For example, 0=raw value, 1=rate of change/sec, 2=acceleration, 3=change in acceleration. Default: 0 'regressors' Two cell array: string, scalar. To plot session-wise regressors, set the first cell to 'condition', 'response', 'accuracy', or 'all'. Event onsets will be distributed by rows using this variable. Time will be plotted at the bin_size given by the scalar. Default: [] 'save' String. If a filepath is supplied here, EASYPLOT will attempt to write the figure to disk using a matlab-supported image format (the one suggested by the file extension in your filepath). Saves in the current directory by default. Default: '' 'trials' String, cell array of strings, scalar, or numeric array. If a specific trial or set of trials is identified using this variable, then EASYPLOT will display data for only those trials that are matched. Unmatched trials will be ignored. Trials can be identified by row number or a specific stimulus / row name. Default: []