MRG, ENH: Allow channel-specific annotations

[larsoner]

Closes #5507

Removes some heavy, seemingly overkill parametrization of the test_annotations.py where the parameters were only used in a single function for example. Also makes an overwrite entry in docdict.

Todo:

• Make rename_channels change the names in annotations
• Make drop_channels drop channel names, and channel-specific annotations that no longer apply

[larsoner]

Okay I think this is good to go now

[cbrnr]

LGTM +1 for merge when green!

[hoechenberger]

Good stuff!

[hoechenberger]

@larsoner The CI error seems unrelated to me!

[hoechenberger]

Thank you, @larsoner!

[jgcaffari1]

Is this only for the most recent version of python? I do not seem to have this functionality in python 3.6 even though I am up to date with mne.

[hoechenberger]

The latest development version and the upcoming release of MNE-Python 0.24 only support Python 3.7 and newer.

[jgcaffari1]

I have updated everything and the annotations recognize ch_names as input, but they do not actually annotate specific channels. Do the channels need to have specific names as strings?

[drammock]

I have updated everything and the annotations recognize ch_names as input, but they do not actually annotate specific channels. Do the channels need to have specific names as strings?

so far this feature has no effect when plotting (we plan to do that, but it's not done yet). Is that what you're noticing?

[jgcaffari1]

That is what I am noticing. Would I be able to see the channel specific annotations if I save and open in another program?

[drammock]

Would I be able to see the channel specific annotations if I save and open in another program?

I think SigViewer has the ability to display channel-specific annotations. I don't know if SigViewer can read our Annotations data structure (but you can export our annotations to CSV). @cbrnr would know more...

[jgcaffari1]

Thank you.

[cbrnr]

Yes, SigViewer should be able to import events from a CSV file with columns position, duration, channel, type, and name. A channel value of -1 means all channels. However, I just tried this with a dummy file and the import didn't work (but there was no error either), so I guess this functionality is currently broken 😢 .

[jackz314]

Just wondering if there has been any progress on displaying per-channel annotations?

[larsoner]

Not that I've seen

[drammock]

Just wondering if there has been any progress on displaying per-channel annotations?

@britta-wstnr good one for the fall sprint?

[aplzr]

Chiming in to say that I would very much appreciate this feature as well.

[aplzr]

I just realized that visualization of channel-specific annotations has actually been implemented in mne-qt-browser, so I'm posting here again for the benefit of everyone that didn't find the respective issues and pull requests, but did find this pull request (as I had initially).

• Install mne-qt-browser (python -m pip install mne-qt-browser)
• Activate its qt backend

  from mne.viz import set_browser_backend
  set_browser_backend("qt")

• Plot a RawArray that has channel-specific annotations