The following - possibly updated - changelog can be viewed as formatted
article at https://phabricator.mitk.org/w/mitk/changelog/release-v2021.02/.
News for MITK Workbench users
In-application help pages
We revised all of our in-application help pages and user manuals. Whenever you feel lost or overwhelmed, just press the universal help key F1, to open the help page for the currently active plugin.
Following MITK v2018.04.2, which put much focus on the segmentation tools, we did not stop for this release and continued to improve our segmentation.
Segmenting dynamic patient images
Besides many minor bugfixes and new features, we put most of our effort into the robust segmentation of dynamic, time-resolved patient images. A prominent difference to the previous release is the option to create either static segmentations that span over all time steps, or dynamic segmentations that enable individual segmentations for different time steps.
Label set presets
You can now share a certain style or scheme for labels between different segmentation sessions (or provide templates for new segmentation sessions) to greatly reduce the time spent for repetitive segmentation tasks.
Properties of labels like their names, colors, and visibilities are saved as label set presets. They can then be applied to any segmentation session. If a label for a certain value already exists, its properties are overridden by the preset. If a label for a certain value does not yet exist, an empty label with the label properties of the preset is created. The actual segmentations of labels are unaffected as label set presets only store label properties.
Reduction of segmentation tools
We noticed that the 2-d correction tool was rarely used at all. Instead, the add and subtract tools are commonly used to accomplish the same task, so we removed the correction tool to simplify the user interface. Did you already know that you can subtract with the add tool and add with the subtract tool by pressing ⌃ while drawing? 💡
We plan to further reduce the number of rarely used tools in the future to streamline the user interface and to make way for fewer but more handy tools. Stay tuned.
Our image statistics were completely overhauled. They are much more efficient now and reliably cache the results of calculations to increase productivity. Speaking of productivity, it is now possible to display the statistics of multiple images at once, while multiple image masks can automatically be considered. Statistic values can now be copied directly into spreadsheet software like Microsoft Excel.
Data selection is now separate for each plugin, giving you a filtered pre-selection of suitable data for your task. Plugins do no longer interfere with each other through an out-of-context selection in the Data Manager, supporting you in establishing stable workflows. Utilize the favorites or selection history lists to quickly find the data you need in complex projects.
We improved the visualization of translucent objects. Also a correct depth perception is now retained in combination with volume rendering (see video below). The visualization in general has a smoother appearance since we use so-called anti-aliasing techniques to reduce jagged pixel edges of objects.
Improved support of DICOM files
We have to admit that this went unfortunate for previous releases on Linux and macOS. 🙈
We were always proud of our broad support of DICOM files. Our sophisticated, configurable loading mechanism matured over many years to come up with image blocks in the application even in difficult scenarios, when many other tools failed to deliver. However, it turned out that for quite some years now we screwed up the packaging of our installers without noticing. Hence, your experience on Linux and macOS potentially differed from our expectations and advertisements, as we didn't see any issues in our build versions of MITK.
Well, we are happy to announce that this belongs to the past now. 🎉
We also improved the support of reading specific DICOM image volumes from directories that contain multiple volumes. In the past this sometimes lead to the situation that different series located in the same directory ended up in one dynamic image after loading. Now, only the slices that belong to the same series as the selected file will be loaded. You can still load the whole directory at once when you select or drag'n'drop the directory itself.
The official installers now come with our most used command-line apps in addition to the MITK Workbench application. Execute them with the --help parameter for instructions.
An incredibly useful and powerful command-line app that supports all file types known to MITK, including DICOM. For example, to convert a DICOM image into a NRRD image, execute:
$ MitkFileConverter --input my/dicom/series.dcm --output output_image.nrrd
Image type converter
A bit more technical but also very handy is the image type converter to convert/cast pixel types of images. For example, to convert to an unsigned 16-bit integral pixel type, execute:
$ MitkImageTypeConverter --input input_image.nrrd --output output_image.nrrd --type ushort
💔 Known issues
- DICOM file names/paths with non-ASCII characters (e. g. German umlauts) may fail to load on Windows. Two different workarounds are:
- Rename the file
- Switch to the UTF-8 locale of Windows 10 2019-03 or later before starting the MITK Workbench
- 3-d picking and 3-d region growing segmentation tools do not yet support dynamic images
News for developers
- 🧭 We added navigation links to the top and bottom of the Phabricator-versions of our changelogs. Please use them to flip through the past changelogs for a comprehensive overview of changes.
- 💡 After a short list of a few mentions to raise awareness of new features and concepts, we focus on merging the tables of dependency changes over time and on referencing all relevant API-breaking changes.
✨ New features
New selection concept and UI
A new selection concept was introduced, following our mission to decouple plugin views from selections in the Data Manager view. We recommend that you adapt your plugins to the new concept in an effort to unify user experience.
You certainly noticed that we merge the latest developments once or twice a month into our master branch and tag these commits as snapshots. These snapshots are always accompanied by comprehensive changelogs. We also started to automatically deploy unofficial (as in "no guarantees given") snapshot installers to our website for convenient previews.
Project organization in Visual Studio
Projects in the MITK Visual Studio solution are now automatically organized into folders for applications, modules, plugins, and so on. MITK extensions have separate root folders to easily navigate through MITK's and your code.
OpenSSL as run-time dependency was a bit tricky to get right in particular on Windows and in installers in general. It is now an optional default dependency of the MITK superbuild. When it is found during configuration, OpenSSL-specific features like the HTTPS support of POCO are automatically enabled.
On Windows, we recommend to use the Qt online installer to install OpenSSL. MITK will look for it at this specific location by default.
Until we figured out how to reliably query the DLL locations of OpenSSL in CMake, everything you need to do is to set their locations in the MITK build through the CMake cache variables MITK_OPENSSL_CRYPTO_DLL and MITK_OPENSSL_SSL_DLL.
Auto-cleaning of external projects on updates
Updates of external projects like CTK, ITK, or VTK were difficult to get right in existing MITK builds as sometimes old build artifacts, header files, or configuration files had to be removed manually to successfully build MITK again. This is no longer the case since we implemented a mechanism to automatically clean an external project, if its definition file changed. This feature can be disabled through the MITK_AUTOCLEAN_EXTERNAL_PROJECTS CMake cache variable.
Packaging on Windows
Installers do no longer need to include an extra installer for Visual Studio redistributables. All necessary run-time libraries are now packaged, making installers fully installable without administrator rights.
We also generate shortcuts for packaged applications now so no need to crawl through the bin folder anymore to find the MITK Workbench or any other command-line app.
Besides the PACKAGE_DEPENDS mechanism you can now also use TARGET_DEPENDS to specify plain CMake targets without any indirection. These targets are passed down verbatim to target_link_libraries().
Build status on GitHub
Doxygen documentation warnings
We fixed all Doxygen documentation warnings. We encourage you to check your documentation build output after migration to discover potential warnings that previously drowned in noise.
New command-line apps
In addition to the bundled command-line apps mentioned above in the users section, we also introduced new command-line apps, for example:
- Fuse3Dto4DImageMiniApp: Fuse n 3-d images to a single 3d+t image with n time steps
- StitchImagesMiniApp: Stitch multiple images together into a single image
- ResampleImage: Resample images with custom spacing, mapping, and interpolation
🛠 Third-party dependency changes
The following table shows a complete list of changed third-party dependencies. Considerable changes include:
- Minimum required versions of our prerequisites
- CMake 3.18
- Qt 5.12 (5.12.9 on Windows)
- NSIS 3 for building Windows .exe installers
- Major core dependency updates
- VTK 8.1 VTK 9 (migration guide)
Some outdated and experimental components of MITK were removed which resulted in the removal of a few dependencies without replacement.
|Dependency||Old version||New version|
|3d5ae388 (Dec 19, 2014)|
|CTK||fc06bedc (Aug 10, 2018)||7210c5bc (Nov 08, 2020)|
|DCMQI||d067f81c (Jun 26, 2018)||83f498e9 (Feb 8, 2021)|
|DCMTK||29f9de10 (Jun 15, 2018)||3.6.5|
|MatchPoint||24ef6072 (Apr 13, 2018)||f2a64255 (May 02, 2019)|
|OpenIGTLink||54df50de (Aug 21, 2014)||3.0|
|Qt||5.11.1||5.12 (5.12.9 on Windows)|
|9d510bef (Mar 1, 2018)|
🔥 API-breaking changes
- ⚠️ Migration from TinyXML to TinyXML-2 has a few implicit but major pitfalls. Please follow the migration guide thoroughly.
- ⚠️ Render window names were changed from stdmulti.widget[1-4] to stdmulti.widget[0-3]. Since it is only a change of literal strings it has a high potential to fail unnoticed.
- The default mechanisms of assembling DICOM images from a collection of files or a folder changed
- Implementation files like .cpp files are now excluded from the doxygen parser
Build system changes
- ITK dependencies of modules and plugins were completely redone
- The PACKAGE_DEPENDS mechanism (third-party dependencies of modules and plugins) was overhauled for many dependencies like Boost, OpenMesh, OpenMP, OpenSSL, or Python3
- Auto-load modules are not allowed as link-time dependencies anymore
- The SUBPROJECTS parameter of mitk_create_module() is not parsed anymore
Other API-breaking changes
- 📂 Modules
- 📂 Core
- 📂 CommandLine
- 📂 ContourModel
- 📂 DataTypesExt
- 📂 DICOMReader 📂 DICOM
- 📂 DICOMReaderServices 📂 DICOM/autoload/DICOMImageIO
- 📂 DicomRT 📂 RT
- 📂 DicomRTIO 📂 RT/autoload/DICOMRTIO
- 📂 DicomUI 📂 DICOMUI
- 📂 ImageStatistics
- 📂 QtWidgets
- 📂 Remeshing
- 📂 Segmentation
- 📂 Plugins
Removed modules, plugins, and classes
- 📂 Modules
- 📂 DataTypesExt
- 📂 MapperExt
- 📂 US
- 📂 USUI
- 📂 Plugins