Release information

Latest release

The latest MRtrix3Tissue releases can be found here, as well as all release notes and history. You can download the code for each release, or install (and update) MRtrix3Tissue directly via git. Refer to the general installation instructions for details on the latter.

If you want to be automatically notified of new releases, you can “watch” the repository by clicking the “watch” button at the top. You can also follow the MRtrix3Tissue Twitter account, where releases will be announced too.

Version numbering

MRtrix3Tissue is a fork of MRtrix3. This means it includes most MRtrix3 functionality out of the box, but also that version information may get confusing if not managed well. MRtrix3Tissue version numbering is separate from MRtrix3. An effort has been made to make this as overtly clear as possible for users, in a couple of ways:

Changes since MRtrix3 “RC3”

MRtrix3Tissue started its life with version v0.0.0 (3Tissue_v0.0.0), which is identical to MRtrix3 Release Candidate 3 (3.0_RC3), but has initially quickly been updated with MRtrix3’s “development” branch during June-July-August 2019. Since these upstream MRtrix3 developments have stretched out over more than a year (starting from May 2018), many things have been updated but also changed.

For users who have used MRtrix3 Release Candidate 3 (3.0_RC3) before, here’s a short list of the most critical name changes of major commands, assuming you’re using at least MRtrix3Tissue v5.1.0 (3Tissue_v5.1.0):

The interface (arguments, options) and/or default behaviour of some of the above have also changed. Please refer to their command line documentation for details. Here are some other commands for which the interface or default behaviour has changed (please note that this list is not exhaustive):

Another important change is that several commands that output text files, will now add comments (lines starting with #, followed by other text) in those text files to describe certain “header” information. For example, dwi2response dhollander will add 2 lines of comments at the start of each output response function text file: these document the full command that was run (by the user) to generate those outputs (and the version of the software), as well as the b-values of the response function. This change is particularly important to be aware of for users that have their own scripts or processing pipelines that rely on reading these text files or extracting information from them (potentially in external data processing software packages).

Finally, MRtrix3Tissue currently brings a few specific improvements:

If you want to get started immediately, take a look at the basic single-subject pipeline, which also serves as an excellent tutorial.

[Go back to the documentation index]