mne-tools / mne-tools/mne-python

Create local topographic representations. Don't connect distant sensors in topomap.

Open
#8,291 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
3.5k
Forks
1.6k
Avg merge
1d 6h
Merged PRs (30d)
100

Description

Describe the problem

When creating topoplots for montages that have clearly separated clusters of sensors the plotting connects these regions, often creating some visual distortion between regions of interest.

For example in the fNIRS example here I would like the left and right regions repeated. Here is what I would like removed.

And here is another example with a dataset with 4 seperate regions that I would prefer plotted independently

image

Describe your solution

I am not sure of the optimal solution, but my initial thoughts are I would like to be able to either specify how many independent regions I want plotted. Or perhaps specify a maximum distance between sensors, and anything above this distance is not connected in the plot.

Additional context

I tried varying the existing parameters in the topo plot function, but nothing quite achieves my aim.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the behavior in the linked fNIRS processing example and locating the topomap plotting entry point used there. Review how separated sensor clusters are connected, then define and test a way to render those regions independently, including the four-region example, with a clear completion criterion for avoiding connections across distant sensors.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
data-visualization
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.