InsightSoftwareConsortium/ITK: ITK 5.1 Release Candidate 1
Lists
Only you see this
Abstract
ITK 5.1 Release Candidate 1 Release Notes We are happy to announce the Insight Toolkit (ITK) 5.1 Release Candidate 1 is available for testing! :tada: ITK is an open-source, cross-platform toolkit for N-dimensional scientific image processing, segmentation, and registration. ITK 5.1 is a feature release that improves and extends the major ITK 5.0 release. ITK 5.1 includes a NumPy filter interface, clang-format enforced coding style, enhanced modern C++ range support, and much more. Downloads <strong>Python Packages</strong> Install ITK pre-release binary Python packages with: <pre><code>pip install --pre itk </code></pre> <strong>Library Sources</strong> InsightToolkit-5.1rc01.tar.gz InsightToolkit-5.1rc01.zip <strong>Testing Data</strong> Unpack optional testing data in the same directory where the Library Source is unpacked. InsightData-5.1rc01.tar.gz InsightData-5.1rc01.zip <strong>Checksums</strong> MD5SUMS SHA512SUMS Features <em>Tomographic sphere reconstruction with the RTK remote module. Reproduce this result by installing the RTK Python packages, <code>pip install itk-rtk</code>, and run the FirstReconstruction.py example.</em> Pass NumPy Array's to ITK Image Filters The Pythonic, functional-like interface to all ITK image-to-image-filters now directly supports operation on NumPy array's, i.e. <code>numpy.ndarray</code>. If a <code>ndarray</code> is passed as an input, a <code>ndarray</code> is returned as an output. For example, <pre><code>smoothed = itk.median_image_filter(array, radius=2) </code></pre> Previously, explicit conversion to / from an <code>itk.Image</code> was required with <code>itk.array_from_image</code> and <code>itk.image_from_array</code>. We can now also convert an <code>itk.Image</code> to a <code>numpy.ndarray</code> with the standard <code>np.asarray</code> call. <pre><code>import numpy as np import itk image = itk.imread('/path/to/image.tif') array = np.asarray(image) </code></pre> Python 3 Only ITK 5.1 will be the first Python 3-only release. Consistent with most scientific Python packages and CPython's 2020 drop in support, Python 2 support and binaries are no longer be available. Python Package 64-bit Float Support In addition to the many other pixel types supported, the <code>itk</code> binary Python packages now include support for the <code>double</code> pixel type, i.e. 64-bit IEEE floating-point pixels. This improves compatibility with scikit-image, which uses this pixel type as a default. clang-format Enforced C++ Coding Style ITK has adopted a <em>.clang-format</em> coding style configuration file so a consistent coding style can automatically be applied to C++ code with the <code>clang-format</code> binary. A consistent coding style is critical for readability and collaborative development. <code>clang-format</code> has been applied to the entire codebase. The Whitesmiths style of brace indentation, previously part of the ITK Coding Style Guidelines, is not supported by clang-format, so it has been replaced by a brace style consistent with VTK's current style. A Git commit hook will automatically apply <code>clang-format</code> to changed C++ code. Enhanced Modern C++ Range Support In addition to the <code>ImageBufferRange</code>, <code>ShapedImageNeighborhoodRange</code>, and <code>IndexRange</code> classes introduced in ITK 5.0, ITK 5.1 adds an <code>ImageRegionRange</code>. These range classes conform to the Standard C++ Iterator requirements so they can be used in range-based for loop's and passed to Standard C++ algorithms. Range-based for loops provide an elegant syntax for iteration. Moreover, they are often more performant than other iteration classes available. For example, to add 42 to every pixel: <pre><code>ImageBufferRange<ImageType> range{ *image }; for (auto&& pixel : range) { pixel = pixel + 42; } </code></pre> In ITK 5.1, adoption of the range classes was extended across the toolkit, which demonstrates their use and improves toolkit performance. Point Set Registration Parallelism ITK provides a powerful registration framework for point-set registration, offering information-theoretic similarity metrics, labeled point-set metrics, and spatial transformation models that range from affine to b-spline to dense displacement fields. ITK 5.1 features enhanced parallelism in point-set metric computation, leveraging the native thread-pool and Threading Building Blocks (TBB) enhancements in ITK 5. SpatialObject's and Strongly-Typed enum's Improvements and refinements were made to the ITK 5 <code>itk::SpatialObject</code> refactoring, and modern C++ interface. In particular, ITK 5.1 transitions enumerations to strongly-typed enumerations, which is flagged by modern compilers due to improved scoping and implicit conversions to <code>int</code>. Enum names are now follow a consistent <code><Description>Enum</code> naming conversion, which results in a Python interface: <pre><code><Description>Enum_<EnumValue1> <Description>Enum_<EnumValue2> [...] </code></pre> DICOM Support ITK's broadly adopted medical image support is hardened thanks to 20 years of testing and support from major open source DICOM libarary maintainers. In this release, many members of the community collaborated to further enhance ITK's DICOM support for corner cases related to modality, pixel types, and vendor variations. Remote Module Updates Many remote modules were updated: <em>AnalyzeObjectMapIO, AnisotropicDiffusionLBR, BSplineGradient, BioCell, BoneEnhancement, BoneMorphometry, Cuberille, FixedPointInverseDisplacementField, GenericLabelInterpolator, HigherOrderAccurateGradient, IOMeshSTL, IOOpenSlide, IOScanco, IOTransformDCMTK, IsotropicWavelets, LabelErodeDilate, LesionSizingToolkit, MinimalPathExtraction, Montage, MorphologicalContourInterpolation, ParabolicMorphology, PhaseSymmetry, RLEImage, RTK, SCIFIO, SimpleITKFilters, SkullStrip, SplitComponents, Strain, SubdivisionQuadEdgeMeshFilter, TextureFeatures, Thickness3D, TotalVariation,</em> and <em>TwoProjectionRegistration</em>. Their updates are included in the detailed changelog below. Congratulations Congratulations and <strong>thank you</strong> to everyone who contributed to this release. Of the 50 authors, we would like to specially recognize the 20 new contributors: Mathew J. Seng, Zahil Shanis, yjcchen0913, PA Rodesch, Aurélien Coussat, yinkaola, Bryce Besler, Pierre Chatelier, Rinat Mukhometzianov, Ramraj Chandradevan, Hina Shah, Gordian Kabelitz, Genevieve Buckley, Aaron Bray, nslay, Antoine Robert, James Butler, Matthew Rocklin, Gina Helfrich, and Neslisah Torosdagli. What's Next As we work towards the next release candidate, we will improve strongly typed enum adoption in the toolkit, consistent with the soft commitment to backwards compatibility to address any potential API or architectual issues until the 5.1.0 release. Please try out the current release candidate, and discuss your experiences at discourse.itk.org. Contribute with pull requests, code reviews, and issue discussions in our GitHub Organization. <strong>Enjoy ITK!</strong> ITK Changes Since v5.0.0 <pre><code>Aurélien Coussat (1): ENH: wrap IterationReporter Bradley Lowekamp (63): BUG: Use ProcessObject GetInput to obtain base pointer BUG: Fix ProcessObject::RemoveOutput for null objects. COMP: Address missing fftw include in CurvatureRegistrationFilter BUG: Fix ProcessObject::RemoveOutput for null objects. BUG: Add casting for vector pixel types STYLE: Use CTEST_TEST_TIMEOUT ENH: Add testing for CastImageFilter for more type conversions BUG: Restore support for Cast between explicitly cast-ed pixel type BUG: Use ProcessObject GetInput to obtain base pointer ENH: Add testing for CastImageFilter for more type conversions BUG: Restore support for Cast between explicitly cast-ed pixel type BUG: Add DataObject::New method BUG: Install FFTW headers in same location as ITK Revert "BUG: InterpolateImageFunction::GetRadius hidden in ITKV4_COMPATIBILITY" BUG: Preserve Interpolate GetRadius behavior with ITKv4Compatibility Revert "COMP: forgotten class for ITKV4_COMPATIBILITY in 2aae174" BUG: HDF5 is clobbering ctest TIMEOUT variables COMP: Fix not marked 'override' for ImageSink destructor BUG: Use enable_if with SFINAE to dispatch ENH: Add Vector constructor from C arrays with cast COMP: Work around uninitialized value warnings ENH: Update ITKv4 registration example to use resample over warp BUG: Specify specific CircleCI docker image with platform COMP: Address compilation warning with aggregate initializer BUG: Specify specific CircleCI docker image with platform ENH: Adding VS2019 v142, VS2017 v140 Azure Pipelines on merge DOC: Tweak internal documentation in SliceImageFilter BUG: Address bug with small size in output of SliceImageFilter ENH: Add more test cases for the SliceImageFilter COMP: Address internal compiler error on MSVC 19.0.24234.1 (v140) ENH: Add check expected input in HistogramMatchingImageFilter COMP: Add missing enum type_name from prior enum declaration style ENH: Check physical location consistency after PermuteImageFilter BUG: Address bug with small size in output of SliceImageFilter COMP: Address internal compiler error on MSVC 19.0.24234.1 (v140) COMP: Add missing include for VectorLinearInterpolateImageFunction ENH: Move ImageToHistogram test to Statistics module BUG: Fix outside buffered region exception in ImageToHistogramFilter BUG: Fix ImageHistogram printing null inputs ENH: Add basic object testing methods for ImageToHistogramFilter ENH: Add testing for ImageToHistogram with AutoMinimumMaximum ENH: Add missing boolean setter methods for AutoMinimumMaximum BUG: Add valgrind suppression for zlib slide_hash ENH: Add testing for OBB vertices and image with direction BUG: Correct ShapeLabelObjectes OBB vertices DOC: Update documentation for OBB vertices method BUG: Add missing suppression name for zlib BUG: Explicitly initialize CovariantVector in VectorImageTest DOC: Adding migration guide for
BibTeX
@inproceedings{ibanez2019insightsoftwareconsortium,
author = {Luis Ibanez and Bill Lorensen and Matt McCormick and Brad King and Daniel J. Blezek and Hans J. Johnson and Bradley Lowekamp and jjomier and Gaetan G. Lehmann and Arnaud Gelas and Mathieu Malaterre and karthikkrishnan and Dženan Zukić and Bill Hoffman and Will and Stephen Aylward and Xiaoxiao Liu and stnava and Niels Dekker and Michka Popoff and Nicholas J. Tustison and gabehart and Sean and alex gouaillard and Daniel A. Enquobahrie and Brian Helba and Tom Vercauteren and P.R. Hernández and David Doria and Doria, David},
title = {{InsightSoftwareConsortium/ITK: ITK 5.1 Release Candidate 1}},
booktitle = {Zenodo},
year = {2019},
doi = {10.5281/zenodo.3592082},
}Loading related content...