HomePhabricator
Diffusion MITK 24935707b963
Tags
None
Referenced Files
F2065891: BuildStatus.PNG
Feb 15 2021, 1:51 PM
F1646868: selectiondialog.png
Feb 15 2021, 1:51 PM
F2103749: folders.PNG
Feb 15 2021, 1:51 PM
F2104149: Capture.PNG
Feb 15 2021, 1:51 PM
F2103808: installer.PNG
Feb 15 2021, 1:51 PM
F2104219: Capture2.PNG
Feb 15 2021, 1:51 PM
F2108339: statdyn.mp4
Feb 15 2021, 1:51 PM
F1646878: depthpeeling.mp4
Feb 15 2021, 1:51 PM
Subscribers
None

Description

v2021.02

The following - possibly updated - changelog can be viewed as formatted
article at https://phabricator.mitk.org/w/mitk/changelog/release-v2021.02/.

NOTE: This is a release changelog. It is composed of a selected short list of highlights since the last release v2018.04.2 - split into dedicated user and developer sections. See the past ten changelogs starting from 2020 Week 25 (Late June) for a comprehensive, developer-centric overview of changes.

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.

Press F1 to open a context-specific help page

Segmentation

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.

Capture.PNG (604ร—388 px, 36 KB)

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.

Image Statistics

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.

Measurement View and Image Statistics View

Data Selection

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.

New selection dialog

Visualization

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.

Command-line apps

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.

MitkFileConverter command-line app

File converter

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.

New selection dialog

Snapshot installers

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.

Visual Studio folders

OpenSSL

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.

OpenSSL in the Qt online installer

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.

The auto-clean feature of modified dependencies

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.

Root folder of the WorkbenchRelease package

CMake-style dependencies

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

Beside our CDash site for detailed build status reports, we now provide a quick overview of build statuses on our GitHub page.

CI badges 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

NOTE: Here is the list of supported platforms for MITK v2021.02.

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
  • Replacements

Some outdated and experimental components of MITK were removed which resulted in the removal of a few dependencies without replacement.

DependencyOld versionNew version
ACVD3d5ae388 (Dec 19, 2014)
Boost1.681.74
cpprestsdk2.10.16
CMake3.103.18
CppUnit1.12.11.15.1
CTKfc06bedc (Aug 10, 2018)7210c5bc (Nov 08, 2020)
DCMQId067f81c (Jun 26, 2018)83f498e9 (Feb 8, 2021)
DCMTK29f9de10 (Jun 15, 2018)3.6.5
GDCM2.6.33.0.8
freeglut2.8.1
ITK4.13.14.13.3
MatchPoint24ef6072 (Apr 13, 2018)f2a64255 (May 02, 2019)
NSIS23
OpenCV3.4.13.4.8
OpenIGTLink54df50de (Aug 21, 2014)3.0
OpenMesh8.1
Qt5.11.15.12 (5.12.9 on Windows)
Qwt6.1.06.1.5
Raptor2.0.15
Rasqal0.9.32
Redland1.0.17
SimpleITK9d510bef (Mar 1, 2018)
TinyXML2.6.2
TinyXML-28.0.0
VTK8.19.0.1 (patched)
zlib66a753051.2.11

๐Ÿ”ฅ API-breaking changes

Dangerous 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.

Behavioral changes

Documentation changes

  • 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

Removed modules, plugins, and classes

NOTE: MITK Diffusion moved into a separate MITK extension.
  • ๐Ÿ“‚ Modules
    • Biophotonics
    • BiophotonicsHardware
    • ๐Ÿ“‚ DataTypesExt
      • Mesh
      • MeshUtil
    • GPGPU
    • ๐Ÿ“‚ MapperExt
      • MeshMapper2D
      • MeshVtkMapper3D
    • PhotoacousticsAlgorithms
    • PhotoacousticsHardware
    • PhotoacousticsLib
    • PlanarFigureSegmentation
    • RDF
    • SpectroCam
    • ๐Ÿ“‚ US
      • USDiPhASDeviceCustomControls
    • USHardwareDiPhAS
    • ๐Ÿ“‚ USUI
      • QmitkUSControlsCustomDiPhASDeviceWidget
  • ๐Ÿ“‚ Plugins
    • org.mitk.gui.qt.lasercontrol
    • org.mitk.gui.qt.photoacoustics.imageprocessing
    • org.mitk.gui.qt.photoacoustics.pausmotioncompensation
    • org.mitk.gui.qt.photoacoustics.pausviewer
    • org.mitk.gui.qt.photoacoustics.simulation
    • org.mitk.gui.qt.photoacoustics.spectralunmixing
    • org.mitk.gui.qt.spectrocamrecorder

Details

Provenance
kislinskAuthored on Feb 15 2021, 1:45 PM
kislinskPushed on Feb 15 2021, 1:51 PM
Parents
rMITK33ea274cbd50: Fix erasing labels in 4-d images
rMITK9d72c939e513: 2021 Week 06 (Early February)
Branches
Unknown
Tags
Unknown
References
tag: v2021.02