Plot data
Last updated
Was this helpful?
Last updated
Was this helpful?
This function plots TMS-evoked activity averaged over trials. Timing of the TMS pulse is indicated with a red dashed line. Output from peak analyses can also be plotted, as well as confidence intervals across trials.
Example butterfly plot generated by tesa_plot. Data from one individual plotted using default settings. Red line indicates timing of TMS pulse.
1. Select the data to plot. All will plot a butterfly plot with all electrodes. Individual electrodes can be selected, as well as ROI and GMFA analyses.
2. Define the time limits for the x axis (in ms).
3. Define the amplitude limits for the y axis (in uV). Leave blank for auto-scaling.
4. Turn on/off 95% confidence intervals calculated across trials. This is only available for single electrode and ROI plots.
tesa_plot( EEG );
Default use.
tesa_plot( EEG, 'key1',value1... );
Custom inputs.
pop_tesa_plot( EEG );
Pop up window.
'''pop_tesa_plot( EEG, 'key1',value1... );''' Custom inputs.
Input
Description
Example
Default
EEG
EEGLAB EEG structure
EEG
-
Key
Input value
Description
Example
Default
'xlim'
[min,max]
Integers describing the x axis limits in ms.
[-200,600]
[-100,500]
'ylim'
[min,max]
Integers describing the y axis limits in ms. If left blank, the plot will automatically scale.
[-10,10]
[ ]
'elec'
'string'
String describing a single electrode for plotting. If left blank, a butterfly plot of all electrodes will be plotted.
'Cz'
[ ]
'CI'
'on' or 'off'
Plot confidence interval calculated across trials. This option is not available for GMFA and butterfly plots.
'on'
'off'
Options for plotting output from tesa_tepextract and tesa_peakanalysis
'tepType'
'data' or 'ROI' or 'GMFA'
'data' input extracts data for plotting from EEG.data. 'ROI' input selects a ROI generated by tesa_tepextract. 'GMFA' input selects a GMFA generated by tesa_tepextract. Note that if multiple ROIs or GMFAs are present, 'tepName' must also be included to determine which one to plot.
'ROI'
'data'
'tepName'
'string'
String is either the name of a ROI or GMFA generated by tesa_tepextract. The default names generated by tesa_tepextract are 'R1','R2'... etc. however the user can also define names. This is required if multiple ROIs or GMFAs are present.
'motor'
[ ]
'plotPeak'
'on' or 'off'
If 'on', peaks identified with tesa_peakanalysis will also be plotted. A box defining the lower and upper time limits in which the peak was searched will also be plotted. Green indiciates that a peak was found, red a peak was not detected. Note that tesa_peakanalysis must be run prior to using this function and 'tepType' must also be called.
'on'
'off'
pop_tesa_plot(EEG, 'xlim', [-200,600], 'ylim', [-10,10], 'elec', 'P1', 'CI', 'on');
Plot the average of electrodes P1 and P3, rescale the axes and include confidence intervals.
pop_tesa_plot(EEG, 'tepType', 'ROI', 'tepName', 'parietal', 'plotPeak', 'on', 'CI', 'on');
Plot the output from a ROI analysis called parietal including detected peaks and confidence intervals.
pop_tesa_plot(EEG, 'tepType', 'GMFA', 'plotPeak', 'on');
Plot output from a GMFA analysis including detected peaks
5. Turn on/off the peak analysis results for ROI and GMFA analyses. The + marks the peak and the dotted box indicates the time window. Peaks that were found are green and peaks not present are red. Note that needs to be run before this option is possible.