|
Size: 724
Comment:
|
Size: 8264
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| = Setting up BrainSuite for Brainstorm = ''Authors: Chinmay Chinara, Anand Joshi, Raymundo Cassani, David Shattuck'' |
= BrainSuite for Brainstorm = ''Authors: Chinmay Chinara, Anand Joshi, Raymundo Cassani, Takfarinas Medani, David Shattuck'' |
| Line 4: | Line 4: |
| <<TableOfContents(2,2)>> | BrainSuite software is a collection of image analysis tools designed to process magnetic resonance images (MRI) of the human brain. BrainSuite provides an automatic sequence to extract cortical surface mesh models from the MRI, tools to register these to a labeled atlas to define anatomical regions of interest, and tools for processing diffusion imaging data including co-registration to anatomical data, ODF and tensor fitting and tractography. BrainSuite also contains visualization tools for exploring these data, and can produce interactive maps of regional connectivity. For more details please visit https://brainsuite.org/. |
| Line 6: | Line 6: |
| == BrainSuite Installation == 1. Download the latest version of BrainSuite ('''BrainSuite23a''') from http://forums.brainsuite.org/download/. You need to register yourself first there in order to go to the download page. 1. Install it on your computer by following the instructions in BrainSuite's quick start installation guide: https://brainsuite.org/quickstart/installation/. '''NOTE: For BrainSuite23a, MATLAB Compiler Runtime (MCR) 2023a is required. Depending on your OS install it from [[https://www.mathworks.com/products/compiler/matlab-runtime.html|here]]'''. |
''For any BrainSuite specific queries please contact its developers:<<BR>>Anand Joshi (ajoshi[at]usc[dot]edu)<<BR>>David Shattuck (david[dot]shattuck[at]gmail[dot]com)'' <<TableOfContents(3,2)>> == Background == Currently BrainSuite is used within Brainstorm to perform the following tasks: * [[https://neuroimage.usc.edu/brainstorm/Tutorials/SegBrainSuite|T1-MRI Segmentation]] to extract segmented brain surfaces from a T1-weighted MRI image. * [[https://brainsuite.org/processing/surfaceextraction/bse/|Skull stripping]] for removing extracranial regions in CT for [[https://neuroimage.usc.edu/brainstorm/Tutorials/IeegContactLocalization#Post-implantation_CT|sEEG contact localization]]. == System Requirements == 1. Operating System (OS): Windows 10/11 (64-bit); MacOS 10.8+; Linux 64-bit (Ubuntu recommended) 1. Memory (RAM): >= 4GB recommended 1. MATLAB Runtime Compiler (MCR) 2023a (9.14) for BrainSuite: * 4GB download size, 9GB installation size (for Windows). * 2.3GB download size, 5GB installation size (for Mac). * 4.4GB download size, 9GB installation size (for Linux). 1. BrainSuite23a: * 1.2GB download size, 1.7GB installation size (for Windows). * 1.3GB download size, 1.9GB installation size (for Mac). * 1.3GB download size, 1.6GB installation size (for Linux). '''Note: Since Brainstorm and BrainSuite currently have different MCR requirements (2022b and 2023a respectively), make sure you have enough disk space to make sure things run smoothly'''. == Downloading BrainSuite == Download the latest version of BrainSuite ('''BrainSuite23a''') from http://forums.brainsuite.org/download/. 1. You need to register yourself first there in order to go to the download page.<<BR>><<BR>> {{attachment:bst_login.png||width="400"}} 1. After account creation, log in and choose the binary depending on your OS.<<BR>><<BR>> {{attachment:bst_download.png||width="500"}} 1. Depending on the OS, the downloaded binary could be: * '''BrainSuite23a_win64.exe''' (for Windows) * '''BrainSuite23a.dmg''' (for Mac) * '''BrainSuite23a.linux.tgz''' (for Linux) == Installing MATLAB Compiler Runtime (MCR) == BrainSuite23a depends on '''MCR 2023a (9.14)''' which can be downloaded and installed following the steps mentioned in https://www.mathworks.com/products/compiler/matlab-runtime.html. == Installing BrainSuite == Depending on the OS, the BrainSuite installation can be a bit different for each. === For Windows === 1. Launch '''BrainSuite23a_win64.exe''' that was downloaded above. You may see the security warning issue as under. Click '''More info > Run Anyway ''' to continue.<<BR>><<BR>> {{attachment:bst_warning1.png||width="300"}} {{attachment:bst_warning2.png||width="299"}} 1. From the '''Setup''' window that pops up, click '''Yes''' if MCR 2023a has already been installed else click '''No''' and exit setup and follow steps as per the section [[https://neuroimage.usc.edu/brainstorm/Tutorials/BstBrainSuite#Installing_MATLAB_Compile_Runtime_.28MCR.29|Installing MATLAB Compile Runtime (MCR)]] above.<<BR>><<BR>> {{attachment:bst_setup1.png||width="300"}} 1. Follow the instructions for the Setup, indicating the folder in which you would like to save BrainSuite and its shortcuts. We recommend that you just leave it as is with the defaults and click '''Install'''.<<BR>><<BR>> {{attachment:bst_setup2.png||width="300"}} 1. When Setup has finished, launch BrainSuite. Verify that the program has been installed correctly by checking that no red text warnings appear in the log at the bottom of the BrainSuite window.<<BR>><<BR>> {{attachment:bst_setup3.png||width="500"}} === For Mac === 1. Make sure MCR 2023a has already been installed as per the section [[https://neuroimage.usc.edu/brainstorm/Tutorials/BstBrainSuite#Installing_MATLAB_Compile_Runtime_.28MCR.29|Installing MATLAB Compile Runtime (MCR)]] above. 1. BrainSuite for MacOS is distributed as a disk image file '''BrainSuite23a.dmg'''. To install, open BrainSuite23a.dmg and drag the '''BrainSuite23a''' folder into your '''Applications''' folder, as indicated in the pop-up window.<<BR>><<BR>> {{attachment:bst_mac1.png||width="400"}} 1. Once the installation is completed, start BrainSuite23a from the launchpad. 1. However, there might be security issues that might pop up as under when opening the app. This occurs due to Apple's check for certain softwares when it cannot determine if it is malicious or not. Click '''OK'''. <<BR>><<BR>> {{attachment:bst_mac2.png||width="200"}} 1. To bypass this, instead of opening it from launchpad, use '''Finder''' to locate BrainSuite23a under '''Applications''' and open the app by '''Control and left-click > Open'''.<<BR>><<BR>> {{attachment:bst_mac3.png||width="500"}} 1. Click '''Open''' from the pop-up that appears. BrainSuite23a is now saved as an exception to your security settings, and you can open it at any time by double-clicking it.<<BR>><<BR>> {{attachment:bst_mac4.png||width="200"}} 1. Verify that the program has been installed correctly by checking that no red text warnings appear in the log at the bottom of the BrainSuite window.<<BR>><<BR>> {{attachment:bst_mac5.png||width="500"}} === For Linux === 1. Make sure MCR 2023a has already been installed as per the section [[https://neuroimage.usc.edu/brainstorm/Tutorials/BstBrainSuite#Installing_MATLAB_Compile_Runtime_.28MCR.29|Installing MATLAB Compile Runtime (MCR)]] above. 1. On Linux, the software is distributed as gzipped tar file '''BrainSuite23a.linux.tgz'''. This file can be installed to whichever location is most appropriate for your system. A typical location, provided you have administrator privileges, would be '''/opt/BrainSuite23a/'''. For individual use, you may want to locate the program in your '''home''' directory. 1. Unzip and untar '''BrainSuite23a.linux.tgz''' file. This will create a BrainSuite23a folder which includes the files for CSE, BDP, and SVReg. This can be done on the command line using:<<BR>><<BR>>'''tar xvfz BrainSuite21a.linux.tgz''' 1. Note that you can unpack BrainSuite into the '''/opt''' directory by using:<<BR>><<BR>>'''sudo tar xvfz BrainSuite21a.linux.tgz -C /opt/''' 1. If necessary, move the folder to its desired location. You may need to use '''sudo''' to do this. 1. To run the GUI on Linux (requires '''glibc 2.14''', '''glibc++ 3.4.19''' or greater), launch BrainSuite23a in the bin folder from the terminal, e.g., /opt/BrainSuite23a/bin/BrainSuite23a. Doing so will launch the user interface as under. Verify that the program has been installed correctly by checking that no red text warnings appear in the log at the bottom of the BrainSuite window.<<BR>><<BR>> {{attachment:bst_linux1.png||width="500"}} == Linking BrainSuite with Brainstorm == 1. Install and set Brainstorm up either through MATLAB or as a standalone following this [[https://neuroimage.usc.edu/brainstorm/Installation|tutorial]]. 1. After launching Brainstorm, go to '''File > Edit preferences''' and set the '''BrainSuite installation folder''' to the path of the BrainSuite folder. === For Windows === {{attachment:bst_win_pref.png||width="500"}} === For Mac === {{attachment:bst_mac_pref.png||width="500"}} === For Linux === <TODO> == Testing == <TODO> == Troubleshooting == <TODO> Link to forums and general troubleshooting <<EmbedContent(http://neuroimage.usc.edu/bst/get_feedback.php?Tutorials/BstBrainSuite)>> |
BrainSuite for Brainstorm
Authors: Chinmay Chinara, Anand Joshi, Raymundo Cassani, Takfarinas Medani, David Shattuck
BrainSuite software is a collection of image analysis tools designed to process magnetic resonance images (MRI) of the human brain. BrainSuite provides an automatic sequence to extract cortical surface mesh models from the MRI, tools to register these to a labeled atlas to define anatomical regions of interest, and tools for processing diffusion imaging data including co-registration to anatomical data, ODF and tensor fitting and tractography. BrainSuite also contains visualization tools for exploring these data, and can produce interactive maps of regional connectivity. For more details please visit https://brainsuite.org/.
For any BrainSuite specific queries please contact its developers:
Anand Joshi (ajoshi[at]usc[dot]edu)
David Shattuck (david[dot]shattuck[at]gmail[dot]com)
Contents
Background
Currently BrainSuite is used within Brainstorm to perform the following tasks:
T1-MRI Segmentation to extract segmented brain surfaces from a T1-weighted MRI image.
Skull stripping for removing extracranial regions in CT for sEEG contact localization.
System Requirements
- Operating System (OS): Windows 10/11 (64-bit); MacOS 10.8+; Linux 64-bit (Ubuntu recommended)
Memory (RAM): >= 4GB recommended
MATLAB Runtime Compiler (MCR) 2023a (9.14) for BrainSuite:
- 4GB download size, 9GB installation size (for Windows).
- 2.3GB download size, 5GB installation size (for Mac).
- 4.4GB download size, 9GB installation size (for Linux).
BrainSuite23a:
- 1.2GB download size, 1.7GB installation size (for Windows).
- 1.3GB download size, 1.9GB installation size (for Mac).
- 1.3GB download size, 1.6GB installation size (for Linux).
Note: Since Brainstorm and BrainSuite currently have different MCR requirements (2022b and 2023a respectively), make sure you have enough disk space to make sure things run smoothly.
Downloading BrainSuite
Download the latest version of BrainSuite (BrainSuite23a) from http://forums.brainsuite.org/download/.
You need to register yourself first there in order to go to the download page.
After account creation, log in and choose the binary depending on your OS.
- Depending on the OS, the downloaded binary could be:
BrainSuite23a_win64.exe (for Windows)
BrainSuite23a.dmg (for Mac)
BrainSuite23a.linux.tgz (for Linux)
Installing MATLAB Compiler Runtime (MCR)
BrainSuite23a depends on MCR 2023a (9.14) which can be downloaded and installed following the steps mentioned in https://www.mathworks.com/products/compiler/matlab-runtime.html.
Installing BrainSuite
Depending on the OS, the BrainSuite installation can be a bit different for each.
For Windows
Launch BrainSuite23a_win64.exe that was downloaded above. You may see the security warning issue as under. Click More info > Run Anyway to continue.
From the Setup window that pops up, click Yes if MCR 2023a has already been installed else click No and exit setup and follow steps as per the section Installing MATLAB Compile Runtime (MCR) above.
Follow the instructions for the Setup, indicating the folder in which you would like to save BrainSuite and its shortcuts. We recommend that you just leave it as is with the defaults and click Install.
When Setup has finished, launch BrainSuite. Verify that the program has been installed correctly by checking that no red text warnings appear in the log at the bottom of the BrainSuite window.
For Mac
Make sure MCR 2023a has already been installed as per the section Installing MATLAB Compile Runtime (MCR) above.
BrainSuite for MacOS is distributed as a disk image file BrainSuite23a.dmg. To install, open BrainSuite23a.dmg and drag the BrainSuite23a folder into your Applications folder, as indicated in the pop-up window.
Once the installation is completed, start BrainSuite23a from the launchpad.
However, there might be security issues that might pop up as under when opening the app. This occurs due to Apple's check for certain softwares when it cannot determine if it is malicious or not. Click OK.
To bypass this, instead of opening it from launchpad, use Finder to locate BrainSuite23a under Applications and open the app by Control and left-click > Open.
Click Open from the pop-up that appears. BrainSuite23a is now saved as an exception to your security settings, and you can open it at any time by double-clicking it.
Verify that the program has been installed correctly by checking that no red text warnings appear in the log at the bottom of the BrainSuite window.
For Linux
Make sure MCR 2023a has already been installed as per the section Installing MATLAB Compile Runtime (MCR) above.
On Linux, the software is distributed as gzipped tar file BrainSuite23a.linux.tgz. This file can be installed to whichever location is most appropriate for your system. A typical location, provided you have administrator privileges, would be /opt/BrainSuite23a/. For individual use, you may want to locate the program in your home directory.
Unzip and untar BrainSuite23a.linux.tgz file. This will create a BrainSuite23a folder which includes the files for CSE, BDP, and SVReg. This can be done on the command line using:
tar xvfz BrainSuite21a.linux.tgzNote that you can unpack BrainSuite into the /opt directory by using:
sudo tar xvfz BrainSuite21a.linux.tgz -C /opt/If necessary, move the folder to its desired location. You may need to use sudo to do this.
To run the GUI on Linux (requires glibc 2.14, glibc++ 3.4.19 or greater), launch BrainSuite23a in the bin folder from the terminal, e.g., /opt/BrainSuite23a/bin/BrainSuite23a. Doing so will launch the user interface as under. Verify that the program has been installed correctly by checking that no red text warnings appear in the log at the bottom of the BrainSuite window.
Linking BrainSuite with Brainstorm
Install and set Brainstorm up either through MATLAB or as a standalone following this tutorial.
After launching Brainstorm, go to File > Edit preferences and set the BrainSuite installation folder to the path of the BrainSuite folder.
For Windows
For Mac
For Linux
<TODO>
Testing
<TODO>
Troubleshooting
<TODO> Link to forums and general troubleshooting