Please refer to the documentation for detailed information about the toolbox and the current features. The following README will only provide a very brief overview.
Note
This package is under active development. If you have any questions, suggestions, or want to contribute, please do not hesitate to reach out on GitHub or via the email address in the pyproject.toml file. Some features are also not yet tested, so there will be bugs (the question is just how many).
As Comet contains a fair amount of dependencies, it should be installed in a dedicated Python environment (e.g. conda or another environment manager of your choice) to avoid version conflicts. Comet runs on all major operating systems (Linux, Windows, macOS), although development and testing are primarily conducted on Linux. If you encounter any issues, please let us know via the issue tracker.
conda create -n comet python==3.13
conda activate comet
pip install "comet-toolbox[gui]"
Usage of the toolbox is then possible through either the GUI (might take 1-2 minutes to open on the first start):
comet-gui
or through the scripting API:
from comet import connectivity, graph, multiverse
A comprehensive set of usage examples are provided in the documentation.
/
├─ src/comet/ ← Parent directory
│ ├─ connectivity.py ← Functional connectivity module
│ ├─ graph.py ← Graph analysis module
│ ├─ multiverse.py ← Multiverse analysis module
│ ├─ gui.py ← Graphical user interface
│ ├─ utils.py ← Miscellaneous helper functions
│ ├─ cifti.py ← CIFTI related functions
│ └─ bids.py ← BIDS related functions (placeholder)
├─ docs/ ← Documentation
├─ tutorials/ ← Example jupyter notebooks
├─ tests/ ← Unit tests
├─ pyproject.toml ← Packaging & dependencies
└─ README.md ← Project overview
We warmly welcome contributions and suggestions for new features! Comet is an open and collaborative project, and your input helps make it better for the entire community. More detailed contribution guidelines will follow soon. For now, before submitting a pull request, please open an issue on GitHub to start a discussion or share ideas.