BRAPH 2.0 is an open-source MATLAB-based software that provides advanced capabilities for brain connectivity analysis. It offers a comprehensive range of features, including conventional graph theory, multilayer graphs, and deep learning techniques. With its user-friendly interface and extensive analysis pipelines, researchers can explore the complex organization of the human brain using multimodal neuroimaging data, going beyond the limitations of traditional approaches.
Advances in brain connectivity analysis. Brain connectivity analysis is rapidly evolving thanks to the widespread availability of increasing computational power and large-scale, high-resolution, multimodal neuroimaging datasets. BRAPH 2.0 provides a complete set of tools to analyze these data with conventional graph theory (single-layer graphs), multilayer graphs (multiplex and multi-layer graphs), and deep learning (from artificial neural networks to graph convolutional neural networks), as well as a flexible, easily expandable software architecture. BRAPH 2.0 uses parallel computing to allow users to run scripts on servers or clusters using both central processing units (CPUs) and graphical processing units (GPUs).
BRAPH 2.0 is designed to facilitate the analysis of brain connectivity using various neuroimaging modalities and cutting-edge techniques. It enables researchers to assess the intricate nature of brain organization by leveraging multimodal data and incorporating advanced tools such as deep learning. The software provides an extensive set of analysis pipelines accessible through a graphical user interface (GUI) and sample scripts, allowing users to perform ready-to-use analyses or develop customized pipelines for their specific research needs.
To install BRAPH 2.0, follow these steps:
-
Ensure that you have MATLAB R2022a or a later version installed on your system. BRAPH 2.0 is compatible with the versions of MATLAB for Microsoft Windows, macOS, and Linux operating systems.
-
Make sure you have the following toolboxes installed in MATLAB:
- Statistics and Machine Learning Toolbox (required)
- Parallel Computing Toolbox (optional)
- Deep Learning Toolbox (optional, for deep learning analysis)
-
Download the latest stable version of BRAPH 2.0 from the BRAPH 2.0 Releases.
-
Unzip the downloaded file into the desired directory on your system.
-
Launch MATLAB and change the current folder to the "braph2genesis" folder located in the directory where you unzipped BRAPH 2.0. You may need to add the folder to the MATLAB path.
-
Run the script
braph2genesisin MATLAB. This installation process may take up to one hour to complete. You only need to run this script once or whenever there is an update to BRAPH 2.0. -
After the installation is complete, you can run BRAPH 2.0 by navigating to the "braph2" folder in MATLAB and running the script
braph2. This will launch the graphical user interface (GUI) from which you can choose an analysis pipeline to start your analysis. -
Explore the BRAPH 2.0 Tutorials.
BRAPH 2.0 provides a range of analysis pipelines that can be used for various use cases in brain connectivity analysis. For detailed information about these analysis pipelines, including their functionalities and step-by-step instructions, refer to the BRAPH 2.0 Pipeline Tutorials. Here are some possible use cases of BRAPH 2.0:
-
Conventional Single-Layer Analyses: BRAPH 2.0 offers pipelines to analyze single-layer graphs derived from different kinds of neuroimaging data. These pipelines involve loading the brain atlas, loading the subject data, constructing the graph, calculating graph measures of interest, and comparing groups. Single-layer analyses can be performed on connectivity data, functional data, and structural data.
-
Multilayer Analyses: BRAPH 2.0 supports the analysis of multilayer graphs, which capture the connectivity patterns across multiple layers or modalities. The multilayer analysis pipelines involve similar steps as single-layer analyses but operate on multilayer graphs. This allows researchers to explore the relationships between different layers or modalities of brain connectivity.
-
Deep Learning Analyses: BRAPH 2.0 enables the analysis of brain connectivity data using deep learning techniques. The deep learning pipelines involve loading the brain atlas, loading the subject data, constructing the input for deep learning models, splitting the dataset, training the models, and evaluating the model performance. Deep learning analyses can be applied to connectivity data, functional data, and structural data.
BRAPH 2.0 is designed to be an open community-driven project, and the code is freely available on this GitHub repository at BRAPH 2.0 Releases. Developers can contribute to BRAPH 2.0 at various levels of complexity, ranging from editing existing pipelines and adapting example scripts to implementing entirely new features. For the details on how to do this, refer to the BRAPH 2.0 Developer Tutorials.
BRAPH 2.0 is an open-source project, and contributions from the community are highly encouraged. Whether you want to report a bug, suggest a new feature, or contribute code improvements, your contributions are valuable and help make BRAPH 2.0 even better.
If you encounter any issues or have ideas for new features, please submit detailed information for bug reports using the Bug Report template and clear descriptions for feature requests using the Feature Request template. Your contributions help us improve BRAPH 2.0 and make it even better.
If you're interested in contributing with code, follow these steps:
-
Fork the BRAPH 2.0 repository on GitHub.
-
Create a new branch for your changes.
-
Make your modifications and commit them.
-
Push your branch to your forked repository.
-
Open a pull request against the
developbranch of the main repository.
Improvements to the documentation are welcome. Submit a pull request as indicated above with your proposed changes for errors, outdated information, or suggestions for improvement.
Join discussions on the BRAPH 2.0 forum to provide support, answer questions, and share your expertise.
By contributing to BRAPH 2.0, you play a crucial role in its growth and improvement. Your contributions shape the future development of the software and advance brain connectivity analysis.
We appreciate your support and look forward to your contributions!
If you use BRAPH 2.0 in your research work, please cite the following publication:
Mite Mijalkov, Ehsan Kakaei, Joana B Pereira, Eric Westman & Giovanni Volpe (2017).
BRAPH: A graph theory software for the analysis of brain connectivity.
PLOS ONE 12, e0178798.
https://doi.org/10.1371/journal.pone.0178798
We appreciate your acknowledgment of BRAPH 2.0 in your research!