Medical Imaging Interaction Toolkit  2024.06.00
Medical Imaging Interaction Toolkit
Advanced MITK user topics

MITK MiniApps

What are MiniApps?

MiniApps are small command line tools. Generally the purpose of each of these tools is designed to fulfill one simple task, e.g. resample an image or extract image statistics of a given region of interest (ROI).

They are intended to provide command line access to a variety of features of MITK, thus facilitating batched processing of data.

Usage

Each MiniApp should provide information about its usage. If it is called without parameters it will output help information about expected inputs, outputs and parameters. Below you can see the help output of the MitkGibbsTracking MiniApp:

$./MitkGibbsTracking
-i, --input, input image (tensor, ODF or FSL/MRTrix SH-coefficient image)
-p, --parameters, parameter file (.gtp)
-m, --mask, binary mask image (optional)
-s, --shConvention, sh coefficient convention (FSL, MRtrix) (optional), (default: FSL)
-o, --outFile, output fiber bundle (.fib)
-f, --noFlip, do not flip input image to match MITK coordinate convention (optional)

Integrating a command line tool into MITK Workbench

The executable file has be to be announced in MITK Workbench. This can be done in Preferences window: Click 'Window' -> 'Preferences', and select 'Command Line Modules'. You can add directories containing executable files or you can select single executable files. Click 'OK' button. The configured command line tools are now available via the drop-down box of the Command Line Modules tab.

Warning
The build configuration of your MiniApp should match the build configuration of your MITK application. This is especially relevant for developers. Combining a Release application and Debug MiniApp or vice versa might not work.

Available MiniApps in MITK

Technical Information

MiniApps follow the Slicer Execution Model in describing themselves via xml:

$./GibbsTracking --xml
<executable>
<category>Fiber Tracking and Processing Methods</category>
<title>Gibbs Tracking</title>
<description></description>
<contributor>German Cancer Research Center (DKFZ)</contributor>
<parameters>
...
</parameters>
</executable>
Note
Full conformity is still a work in progress.