mne.beamformer.apply_dics_csd#
- mne.beamformer.apply_dics_csd(csd, filters, verbose=None)[source]#
Apply Dynamic Imaging of Coherent Sources (DICS) beamformer weights.
Apply a previously computed DICS beamformer to a cross-spectral density (CSD) object to estimate source power in time and frequency windows specified in the CSD object [1].
Note
Only power can computed from the cross-spectral density, not complex phase-amplitude, so vector DICS filters will be converted to scalar source estimates since power is strictly positive and so 3D directions cannot be combined meaningfully (the direction would be confined to the positive quadrant).
- Parameters:
- csdinstance of
CrossSpectralDensity
The data cross-spectral density (CSD) matrices. A source estimate is performed for each frequency or frequency-bin defined in the CSD object.
- filtersinstance of
Beamformer
DICS spatial filter (beamformer weights) Filter weights returned from
make_dics
.- 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.
- csdinstance of
- Returns:
- stc
SourceEstimate
Source power with frequency instead of time.
- frequencies
list
offloat
The frequencies for which the source power has been computed. If the data CSD object defines frequency-bins instead of exact frequencies, the mean of each bin is returned.
- stc
References
Examples using mne.beamformer.apply_dics_csd
#
Compute source power using DICS beamformer
Compute evoked ERS source power using DICS, LCMV beamformer, and dSPM