comet-toolbox 1.1.0

Dynamic functional connectivity toolbox for multiverse analysis

Comet - A toolbox for dynamic functional connectivity and multiverse analysis

About the toolbox

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).

Installation and usage

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.

Code structure

/
├─ 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

Contributing

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.