Skip to content
MRtrix3 provides a set of tools to perform various advanced diffusion MRI analyses, including constrained spherical deconvolution (CSD), probabilistic tractography, track-density imaging, and apparent fibre density
C++ Python CSS Shell MATLAB C
Branch: master
Clone or download

Latest commit

Latest commit 86fd1b7 May 22, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github GitHub Actions: don't trigger on pull request edited Apr 22, 2020
bin dwifslpreproc: Tweak warning message on slspec questionable usage Apr 22, 2020
cmd Merge pull request #2031 from MRtrix3/fixes_for_publication_crawler Apr 22, 2020
core CohortDataImport::initialise(): Fix for cwd May 17, 2020
docs Merge branch 'tag_update_3.0.0' Apr 22, 2020
icons final svg source cleanup Mar 1, 2017
lib/mrtrix3 5ttgen hsvs: Last-minute fixes prior to release Apr 22, 2020
matlab write_mrtrix.m: Increase floating-point precision Apr 14, 2020
share/mrtrix3 5ttgen hsvs: Add missing LUT files Mar 10, 2020
src Merge pull request #1993 from MRtrix3/mrregister_warpfull_mif Apr 22, 2020
testing testing: mrconvert fix failure in case of enabled NIfTIAutoSaveJSON Apr 22, 2020
.gitattributes Update .gitattributes file May 13, 2020
.gitignore Partially addressing Issue #1654 Jan 26, 2020
.gitmodules Re-arrange test data Oct 21, 2019
CONTRIBUTING.md CONTRIBUTING.md: minor wording and spelling changes Aug 7, 2019
Doxyfile Doxyfile: update input folders to list 'core' rather than 'lib' Aug 25, 2017
LICENCE.txt use correct spelling for LICENCE.txt... Dec 11, 2015
README.md docs: new 'getting help' section and mention new wiki section Apr 21, 2020
build
check_syntax Partially addressing Issue #1654 Jan 26, 2020
configure configure: fix pylint issue Mar 17, 2020
doxygen Major overhaul of version number handling - please update external co… Jan 7, 2014
generate_bash_completion.py Add copyright notice to non-CPP files Oct 8, 2019
install_mime_types.sh Add copyright notice to non-CPP files Oct 8, 2019
mrtrix-mime.xml Revert "signal handling: try SetConsoleCtrlHandler on Windows - doesn… Jan 18, 2017
mrtrix-mrview.desktop Revert "signal handling: try SetConsoleCtrlHandler on Windows - doesn… Jan 18, 2017
package_mrtrix Add copyright notice to non-CPP files Oct 8, 2019
run_pylint run_pylint: BSD head requires options before arguments Jan 27, 2020
run_tests Testing: Change fod2fixel temp data paths Nov 23, 2019
set_path Support setting the path on a default Catalina install Dec 12, 2019
update_dev_doc Add copyright notice to non-CPP files Oct 8, 2019

README.md

MRtrix

Build Status

Please visit the official website for MRtrix to access the documentation for MRtrix3, including detailed installation instructions.

Getting help

Support and general discussion is hosted on the MRtrix3 Community Forum. Please also look through the Frequently Asked Questions on the wiki section of the forum. You can address all MRtrix3-related queries there, using your GitHub or Google login to post questions.

Quick install

  1. Install dependencies by whichever means your system uses. These include: Python (>=2.6), a C++ compiler with full C++11 support (g++ 4.9 or later, clang++), Eigen (>=3.2.8), zlib, OpenGL (>=3.3), and Qt (>=4.8, or at least 5.1 on MacOSX).

  2. Clone Git repository and compile:

     $ git clone https://github.com/MRtrix3/mrtrix3.git
     $ cd mrtrix3/
     $ ./configure
     $ ./build
    
  3. Set the PATH:

    • Bash shell:

      run the set_path script provided:

        $ ./set_path
      

      or edit the startup ~/.bashrc or /etc/bash.bashrc file manually by adding this line:

        $ export PATH=/<edit as appropriate>/mrtrix3/bin:$PATH
      
    • C shell:

      edit the startup ~/.cshrc or /etc/csh.cshrc file manually by adding this line:

        $ setenv PATH /<edit as appropriate>/mrtrix3/bin:$PATH
      
  4. Test installation:

    Command-line:

     $ mrconvert
    

    GUI:

     $ mrview
    

Keeping MRtrix3 up to date

  1. You can update your installation at any time by opening a terminal in the mrtrix3 folder, and typing:

     git pull
     ./build
    
  2. If this doesn't work immediately, it may be that you need to re-run the configure script:

     ./configure
    

    and re-run step 1 again.

Building a specific release of MRtrix3

You can build a particular release of MRtrix3 by checking out the corresponding tag, and using the same procedure as above to build it:

git checkout 3.0_RC3
./configure
./build

Contributing

Thank you for your interest in contributing to MRtrix3! Please read on here to find out how to report issues, request features and make direct contributions.

You can’t perform that action at this time.