search

mne-tools / mne-connectivity

Connectivity algorithms that leverage the MNE-Python API.
https://mne.tools/mne-connectivity/dev/index.html
BSD 3-Clause "New" or "Revised" License
66 stars 34 forks source link

Adding the dPLI connectivity measure #77

Closed kenjimarshall closed 2 years ago

kenjimarshall commented 2 years ago

Describe the problem

I'm with the Biosignal Interaction and Personhood Technology Lab (BIAPT) at McGill University. We often use the directed phase lag index (Stam et al, 2012) as a directed functional connectivity measure in our consciousness research. This isn't included in the spectral_connectivity module.

Describe your solution

Add a _dPLIEst class to spectral_connectivity.

Additional context

dPLI Paper Stam CJ, van Straaten EC. Go with the flow: use of a directed phase lag index (dPLI) to characterize patterns of phase relations in a large-scale model of brain dynamics. Neuroimage. 2012 Sep;62(3):1415-28. doi: 10.1016/j.neuroimage.2012.05.050. Epub 2012 May 24. PMID: 22634858. Pubmed.

adam2392 commented 2 years ago

This sounds like it would be desirable to have. Do you wanna take a shot at a PR for this?

Perhaps if you have a test dataset in mind, where you can demonstrate the utility of this method?

kenjimarshall commented 2 years ago

Yes I'd be happy to put a PR together!

As per the utility of the method, it captures the phase lead/lag relation between two signals, revealing information about the directionality of FC measured by wPLI. If desired, we can prepare an example analysis for the documentation which illustrates the difference between wPLI and dPLI, and the potential in their combined usage.

The dPLI paper (Stam et al, 2012) shows an example where this information is valuable. I'll also link one of our group's recent papers that used dPLI to prognosticate recovery of consciousness after a disorder of consciousness. propofol_dpli.pdf.