Installing BrainSuite

System Requirements

Operating System: Windows 7, 8, or 10 (64-bit); Mac OS X 10.8+; Linux 64-bit
Memory: 2 GB (4+ GB recommended)
Processor: x86

Surface/Volume Registration (SVReg) and the BrainSuite Diffusion Pipeline (bdp) require MATLAB Compiler Runtime (MCR) R2015b. This file can be downloaded for free from Mathworks here.
The BrainSuite software is distributed as a GUI for Windows, Macintosh OS X, and Linux platforms. Command line programs for cortical surface extraction and diffusion processing are also provided. The related software for Surface/Volume Registration (SVReg) is provided as a collection of command-line programs callable from BrainSuite’s GUI, while the BrainSuite Diffusion Pipeline (BDP) is a command-line only program. Due to memory limitations, the BrainSuite Diffusion Pipeline and SVReg programs are not available for 32-bit Windows. The software may be downloaded here.

Installing on Windows

Windows Platforms

On Windows, the software is distributed as an installer package (BrainSuite16a1_win64.exe). To install:

  1. Run BrainSuite16a1_win64.exe. This will initiate the BrainSuite Wizard Setup.brainsuite16a1_win_installer
  2. Follow the instructions for the Setup, indicating the folder in which you would like to save BrainSuite and its shortcuts.
  3. The Setup program will check to see if you have the correct version of the Matlab runtime libraries installed. If you do not, it will offer to download the MATLAB Compiler Runtime for you. Install this, and then continue the setup procedure.
  4. When Setup has finished, launch BrainSuite.
  5. 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.

Installing on Mac OS X

Mac OS X Platforms

Note: if you are using MacOS Sierra (10.12), please see this page.

BrainSuite for Mac OS X is distributed as a disk image (BrainSuite16a1.dmg) file. To install:

  1. Open BrainSuite16a1.dmg and drag the BrainSuite16a1 folder into your Applications folder, as indicated in the pop-up window.MacOSX Install Window 16a1
  2. Download and install the 2015b MATLAB Compiler Runtime, available from Mathworks. See the Mathworks MCR page for more details.
  3. Open your Applications folder (or Launch Pad on the dock) and start BrainSuite16a1 from within the BrainSuite16a1 folder.
  4. 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.

Installing on Linux

Linux Platforms

On Linux, the software is distributed as gzipped tar file (BrainSuite16a1.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/BrainSuite16a1/. For individual use, you may want to locate the program in your home directory.

  1. Unzip and untar BrainSuite16a1.linux.tgz file. This will create a BrainSuite16a1 folder which includes the files for CSE, BDP, and SVReg.
  2. This can be done on the command line using

    tar xvfz BrainSuite16a1.linux.tgz

    Note that you can unpack BrainSuite into the /opt directory by using

    sudo tar xvfz BrainSuite16a1.linux.tgz -C /opt/
  3. If necessary, move the folder to its desired location. You may need to use sudo to do this.
  4. Download and install the , 2015b MATLAB Compiler Runtime for Linux, available from Mathworks. See the Mathworks MCR page for more details.
  5. To run the GUI on Linux (requires glibc 2.14, glibc++ 3.4.19 or greater), launch BrainSuite16a1 in the bin folder from the terminal, e.g., /opt/BrainSuite16a1/bin/BrainSuite16a1. Doing so will launch the user interface:
  6. brainsuite16a1_linux

  7. We have run the BrainSuite GUI on Ubuntu 14.04LTS, 15.04, and 16.04LTS.
  8. For Ubuntu 12.04LTS, a newer version of glibc++ must be installed. One way to do this is to install g++ 4.8. See this page for details.

    sudo add-apt-repository ppa:ubuntu-toolchain-r/test

    sudo apt-get update

    sudo apt-get install g++-4.8

    Another is to copy a recent version (3.4.19 or greater) of libg++.so to the lib directory inside BrainSuite16a1/bin.

  9. There are a variety of Linux flavors, so if you encounter difficulties with the installation, please visit the BrainSuite forums for assistance.

Building from Source

We highly recommend using the pre-compiled versions of BrainSuite, which have been tested for cross-platform compatibility. If you do wish do build the software from the source code, instructions for how to do this are provided on this page.