The source code of the Medical Image Registration ToolKit (MIRTK) is hosted on GitHub by the BioMedIA group. The BioMedIA/MIRTK repository contains the build configuration and source code files of the core libraries and basic MIRTK commands. Additional packages can be downloaded from the MIRTK group.
All releases and latest development versions can be downloaded by executing the
commands outlined below in a Terminal window. See the Release Notes for a summary
of changes in each release. When you download the source release packages (e.g.,
.zip archives) from the respective GitHub project pages instead,
you have to download and extract each individual MIRTK package separately and extract
the files into the respective subdirectory of the top-level MIRTK source tree.
We therefore recommend to use Git_ as follows to download the MIRTK source code
To download the latest MIRTK source files using Git_, use the following git clone command:
git clone --depth 1 -- https://github.com/BioMedIA/MIRTK.git MIRTK_SOURCE_DIR="$PWD/MIRTK"
--depth 1 options request a shallow clone of the current development
version of the source files excluding previous revisions in order to save bandwidth,
download time, and disk space. The
--depth option may be omitted if you want to
see the development history and contribute to the MIRTK. To update an existing
copy of the BioMedIA/MIRTK repository, use the git pull
command. Note that submodules also have to be updated in this case using the commands below.
Before running any of the following Git commands, you have to change to the root directory of the downloaded MIRTK repository:
To download the entire MIRTK distribution including third-party library modules, and external packages, run the command:
git submodule update --init
after the initial clone command without any directory path argument. To download only selected additional files, run one or more of the following commands.
Optional third-party libraries for which no binary installation packages for the supported operating systems exists are included as Git submodules under the ThirdParty/ subdirectory of the MIRTK project. To download these third-party source files, run the following command(s):
# Either download all third-party modules at once git submodule update --init -- ThirdParty # Or download one or more of the following modules only git submodule update --init -- ThirdParty/LBFGS
The source files of core MIRTK modules are included in the top-level MIRTK repository under the Modules/ subdirectory. Further optional packages which are developed and distributed in their own respective Git repository are included as Git submodules in the Packages/ directory. To also build these optional packages, initialize and update the desired Git submodules before (re-)configuring the build files, e.g.:
# Either download all additional packages at once git submodule update --init -- Packages # Or download one or more of the following packages only git submodule update --init -- Packages/Deformable git submodule update --init -- Packages/Mapping git submodule update --init -- Packages/Scripting git submodule update --init -- Packages/DrawEM
Operating System: Linux, Mac OS X, Microsoft Windows
The MIRTK is distributed under the terms of the Apache License Version 2. The license enables usage of MIRTK in both commercial and non-commercial applications, without restrictions on the licensing applied to the combined work.
The MIRTK Git repository includes source files and references to Git submodule repositories whose source files are covered by their own respective license terms, which are compatible with the MIRTK license. See the following links for details: