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.

verbosebool | str | int | None

Control verbosity of the logging output. If None, use the default verbosity level. See the logging documentation and mne.verbose() for details. Should only be passed as a keyword argument.

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

Examples using mne.beamformer.apply_dics_csd#

DICS for power mapping

DICS for power mapping

Compute source power using DICS beamformer

Compute source power using DICS beamformer

Compute evoked ERS source power using DICS, LCMV beamformer, and dSPM

Compute evoked ERS source power using DICS, LCMV beamformer, and dSPM