mne.time_frequency.csd_morlet#
- mne.time_frequency.csd_morlet(epochs, frequencies, tmin=None, tmax=None, picks=None, n_cycles=7, use_fft=True, decim=1, projs=None, n_jobs=None, *, verbose=None)[source]#
Estimate cross-spectral density from epochs using Morlet wavelets.
- Parameters:
- epochsinstance of
Epochs
The epochs to compute the CSD for.
- frequencies
list
offloat
The frequencies of interest, in Hertz.
- tmin
float
|None
Minimum time instant to consider, in seconds. If
None
start at first sample.- tmax
float
|None
Maximum time instant to consider, in seconds. If
None
end at last sample.- picks
str
| array_like |slice
|None
Channels to include. Slices and lists of integers will be interpreted as channel indices. In lists, channel type strings (e.g.,
['meg', 'eeg']
) will pick channels of those types, channel name strings (e.g.,['MEG0111', 'MEG2623']
will pick the given channels. Can also be the string values “all” to pick all channels, or “data” to pick data channels. None (default) will pick good data channels (excluding reference MEG channels). Note that channels ininfo['bads']
will be included if their names or indices are explicitly provided.- n_cycles
float
|list
offloat
|None
Number of cycles to use when constructing Morlet wavelets. Fixed number or one per frequency. Defaults to 7.
- use_fft
bool
Whether to use FFT-based convolution to compute the wavelet transform. Defaults to True.
- decim
int
|slice
To reduce memory usage, decimation factor during time-frequency decomposition. Defaults to 1 (no decimation).
- projs
list
ofProjection
|None
List of projectors to store in the CSD object. Defaults to
None
, which means the projectors defined in the Epochs object will be copied.- n_jobs
int
|None
The number of jobs to run in parallel. If
-1
, it is set to the number of CPU cores. Requires thejoblib
package.None
(default) is a marker for ‘unset’ that will be interpreted asn_jobs=1
(sequential execution) unless the call is performed under ajoblib.parallel_backend()
context manager that sets another value forn_jobs
.- verbose
bool
|str
|int
|None
Control verbosity of the logging output. If
None
, use the default verbosity level. See the logging documentation andmne.verbose()
for details. Should only be passed as a keyword argument.
- epochsinstance of
- Returns:
- csdinstance of
CrossSpectralDensity
The computed cross-spectral density.
- csdinstance of
Examples using mne.time_frequency.csd_morlet
#
Compute a cross-spectral density (CSD) matrix
Compute source power using DICS beamformer
Compute evoked ERS source power using DICS, LCMV beamformer, and dSPM