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.

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.

verbosebool, str, int, or None

If not None, override default verbose level (see mne.verbose() and Logging documentation for more). If used, it should be passed as a keyword-argument only.

Returns
stcSourceEstimate

Source power with frequency instead of time.

frequencieslist of float

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.

References

1

Joachim Groß, Jan Kujala, Matti S. Hämäläinen, Lars Timmermann, Alfons Schnitzler, and Riitta Salmelin. Dynamic imaging of coherent sources: studying neural interactions in the human brain. Proceedings of the National Academy of Sciences, 98(2):694–699, 2001. doi:10.1073/pnas.98.2.694.