ICApp is a Python-based application that offers a graphical user interface to view and analyze MNE Tools ICA components. It categorizes the components into 'Good' and 'Bad' lists, allows for dynamic interaction through arrow navigation and direct page jumping. The application includes useful plots corresponding to each component. Lazy plotting is used since displaying some of the plots is computationally expensive.
- Dynamic Navigation: Navigate through pages using Ctrl+left or Ctrl+right arrow, or directly jump to a specific page by entering the page number or selecting the desired component and pressing 'Show'.
- Interactive Lists: Manage 'Good' and 'Bad' lists, allowing users to double-click to move items between lists and sort them. Highlighted items can be selected to navigate to the corresponding page.
- Visualizations: Componentes properties are displayed on each page.
- Saving ICA: The ICA object can be saved by clicking on the save button (Shortcut: Ctrl+S). When closing the application, the ICA object will also be returned to the current console.
Make sure you have Python (>3.11) and the following libraries installed:
- mne
- PyQt5 (usually shipped with mne)
- Matplotlib (usually shipped with mne)
To open the application window, you can call the app function with the required parameters:
from ica_app import ICApp
epochs = mne.Epochs(...) # Your MNE's Epochs object
ica = mne.preprocessing.ICA(...) # Your MNE's ICA object
new_ica = ICApp(ica, epochs) # When closing the app, you can keep the modified ICA object on new_icaIf everything went smooth, the application window should look like this:
If you would like to contribute, please fork the repository and use a feature branch. Pull requests and issues descriptions are warmly welcome.
MIT License
This work was made in collaboration with the Neuroengineering Laboratory from the Institute of Science and Technology of the Federal University of São Paulo.