|
| 1 | +# ITK 5.4.2 Release Notes |
| 2 | + |
| 3 | +We are pleased to announce the release of [ITK 5.4.2](https://docs.itk.org), the latest maintenance update for this cross-platform, open-source toolkit supporting N-dimensional scientific image analysis with spatially-aware algorithms. 🎉 🍻 🥳 This patch release addresses several key issues identified since ITK 5.4.0 while maintaining API stability. |
| 4 | + |
| 5 | +🔦 Highlights |
| 6 | +------------- |
| 7 | + |
| 8 | +As a maintenance update following 5.4.0, version 5.4.2 incorporates critical improvements including: |
| 9 | + |
| 10 | +- **Enhanced Label Map Handling**: Improved unique label map filter behavior for segmentation workflows |
| 11 | +- **Modern Library Support**: Updated compatibility with recent libtiff versions |
| 12 | +- **Large Data Optimization**: Expanded `VectorImage` support for high-dimensional datasets |
| 13 | +- **Performance Improvements**: Fixed thread-based parallelism in SLIC filter implementations |
| 14 | +- **Cross-Platform Enhancements**: Build system updates and compiler compatibility fixes |
| 15 | + |
| 16 | +A full list of changes can be found in the changelog below. |
| 17 | + |
| 18 | +🔢 Versioning Note |
| 19 | +------------------ |
| 20 | + |
| 21 | +This release follows 5.4.0 directly, as the intermediate 5.4.1 patch was reserved for an urgent hotfix that required immediate distribution prior to full release documentation. |
| 22 | + |
| 23 | +For comprehensive details on ITK 5.4.0, please review the [ITK 5.4.0 Release Notes](https://docs.itk.org/en/latest/releases/5.4.0.html). |
| 24 | + |
| 25 | +💾 Download |
| 26 | +----------- |
| 27 | + |
| 28 | +**Python Packages** |
| 29 | + |
| 30 | +Install [ITK Python packages](https://docs.itk.org/en/latest/learn/python_quick_start.html) with: |
| 31 | + |
| 32 | +```bash |
| 33 | +pip install itk |
| 34 | +``` |
| 35 | + |
| 36 | +**Guide and Textbook** |
| 37 | + |
| 38 | +- [InsightSoftwareGuide-Book1-5.4.2.pdf](https://github.com/InsightSoftwareConsortium/ITK/releases/download/v5.4.2/InsightSoftwareGuide-Book1-5.4.2.pdf) |
| 39 | +- [InsightSoftwareGuide-Book2-5.4.2.pdf](https://github.com/InsightSoftwareConsortium/ITK/releases/download/v5.4.2/InsightSoftwareGuide-Book2-5.4.2.pdf) |
| 40 | + |
| 41 | +**Library Sources** |
| 42 | + |
| 43 | +- [InsightToolkit-5.4.2.tar.gz](https://github.com/InsightSoftwareConsortium/ITK/releases/download/v5.4.2/InsightToolkit-5.4.2.tar.gz) |
| 44 | +- [InsightToolkit-5.4.2.zip](https://github.com/InsightSoftwareConsortium/ITK/releases/download/v5.4.2/InsightToolkit-5.4.2.zip) |
| 45 | + |
| 46 | +**Testing Data** |
| 47 | + |
| 48 | +Unpack optional testing data in the same directory where the Library Source is unpacked. |
| 49 | + |
| 50 | +- [InsightData-5.4.2.tar.gz](https://github.com/InsightSoftwareConsortium/ITK/releases/download/v5.4.2/InsightData-5.4.2.tar.gz) |
| 51 | +- [InsightData-5.4.2.zip](https://github.com/InsightSoftwareConsortium/ITK/releases/download/v5.4.2/InsightData-5.4.2.zip) |
| 52 | + |
| 53 | +**Checksums and Signatures** |
| 54 | + |
| 55 | +- [InsightToolkit-5.4.2.tar.gz.asc](https://github.com/InsightSoftwareConsortium/ITK/releases/download/v5.4.2/InsightToolkit-5.4.2.tar.gz.asc) |
| 56 | +- [InsightToolkit-5.4.2.zip.asc](https://github.com/InsightSoftwareConsortium/ITK/releases/download/v5.4.2/InsightToolkit-5.4.2.zip.asc) |
| 57 | + |
| 58 | +- [InsightData-5.4.2.tar.gz.asc](https://github.com/InsightSoftwareConsortium/ITK/releases/download/v5.4.2/InsightData-5.4.2.tar.gz.asc) |
| 59 | +- [InsightData-5.4.2.zip.asc](https://github.com/InsightSoftwareConsortium/ITK/releases/download/v5.4.2/InsightData-5.4.2.zip.asc) |
| 60 | + |
| 61 | +- [MD5SUMS](https://github.com/InsightSoftwareConsortium/ITK/releases/download/v5.4.2/MD5SUMS) |
| 62 | +- [SHA512SUMS](https://github.com/InsightSoftwareConsortium/ITK/releases/download/v5.4.2/SHA512SUMS) |
| 63 | + |
| 64 | +🙏 Congratulations |
| 65 | +------------------ |
| 66 | + |
| 67 | +Congratulations and **thank you** to everyone who contributed to this release. |
| 68 | + |
| 69 | +🗣️ What's Next |
| 70 | +--------------- |
| 71 | + |
| 72 | +**ITK 6 Preparation** |
| 73 | + |
| 74 | +The development community is currently focused on delivering **ITK 6**, a major modernization release featuring: |
| 75 | + |
| 76 | +- Architectural upgrades for contemporary C++ development |
| 77 | +- Enhanced template metaprogramming capabilities |
| 78 | +- Streamlined build system configurations |
| 79 | + |
| 80 | +Early access builds (alpha/beta releases) will become available during ongoing 5.4.x maintenance, enabling parallel evaluation of new features while maintaining production stability. |
| 81 | + |
| 82 | +**5.4 Maintenance Commitment** |
| 83 | + |
| 84 | +We remain dedicated to supporting current users through: |
| 85 | + |
| 86 | +- Regular security and regression patches |
| 87 | +- Critical bug resolution |
| 88 | +- Platform compatibility updates |
| 89 | + |
| 90 | +**Enjoy ITK!** |
| 91 | + |
| 92 | +ITK Changes Since v5.4.0 |
| 93 | +------------------------ |
| 94 | + |
| 95 | +### Andras Lasso (1): |
| 96 | + |
| 97 | +#### Enhancements |
| 98 | + |
| 99 | +- Backport libtiff fix of not displaying warning for unknown tags ([15e47178d6](https://github.com/InsightSoftwareConsortium/ITK/commit/15e47178d6)) |
| 100 | + |
| 101 | + |
| 102 | +### Brad King (1): |
| 103 | + |
| 104 | +#### Platform Fixes |
| 105 | + |
| 106 | +- itktiff: Suppress C99 inline only on MSVC from VS 2013 and below ([6025654de3](https://github.com/InsightSoftwareConsortium/ITK/commit/6025654de3)) |
| 107 | + |
| 108 | + |
| 109 | +### Bradley Lowekamp (11): |
| 110 | + |
| 111 | +#### Enhancements |
| 112 | + |
| 113 | +- A GTest for LabelUniqueLabelMapFilter ([47eec5a2a2](https://github.com/InsightSoftwareConsortium/ITK/commit/47eec5a2a2)) |
| 114 | +- Download x86 clangformat on Darwin arm64 ([ee6bc26281](https://github.com/InsightSoftwareConsortium/ITK/commit/ee6bc26281)) |
| 115 | +- remove repetitive monochorme1 warning ([80a172e8c2](https://github.com/InsightSoftwareConsortium/ITK/commit/80a172e8c2)) |
| 116 | + |
| 117 | +#### Documentation Updates |
| 118 | + |
| 119 | +- Correct Documentation for PadImageFilter::SizeGreatestPrimeFactor ([276a52a5c0](https://github.com/InsightSoftwareConsortium/ITK/commit/276a52a5c0)) |
| 120 | + |
| 121 | +#### Bug Fixes |
| 122 | + |
| 123 | +- Check output of StatisticsUniqueLabelMapFilterTest1 ([8f32d71c8a](https://github.com/InsightSoftwareConsortium/ITK/commit/8f32d71c8a)) |
| 124 | +- Address bugs in unique label map filters ([00bfdb80e7](https://github.com/InsightSoftwareConsortium/ITK/commit/00bfdb80e7)) |
| 125 | +- Remove dilation output in test ([790af9eba0](https://github.com/InsightSoftwareConsortium/ITK/commit/790af9eba0)) |
| 126 | +- Address race condition in SLIC filter ([bbf9f17a40](https://github.com/InsightSoftwareConsortium/ITK/commit/bbf9f17a40)) |
| 127 | +- Enable system TIFF with modern TIFF and cmake ([7b83336a7e](https://github.com/InsightSoftwareConsortium/ITK/commit/7b83336a7e)) |
| 128 | +- Remove SpatialObjectProperty's writable string methods from SWIG ([efe773f555](https://github.com/InsightSoftwareConsortium/ITK/commit/efe773f555)) |
| 129 | +- Fix 32-bit truncation on VectorImage Accessors ([ee63f5eba3](https://github.com/InsightSoftwareConsortium/ITK/commit/ee63f5eba3)) |
| 130 | + |
| 131 | + |
| 132 | +### Dženan Zukić (1): |
| 133 | + |
| 134 | +#### Platform Fixes |
| 135 | + |
| 136 | +- Get ITK_USE_FLOAT_SPACE_PRECISION=ON to compile again ([e816336468](https://github.com/InsightSoftwareConsortium/ITK/commit/e816336468)) |
| 137 | + |
| 138 | + |
| 139 | +### Hans Johnson (1): |
| 140 | + |
| 141 | +#### Platform Fixes |
| 142 | + |
| 143 | +- macOS-11 Azure CI environment EOL ([e5de32ad02](https://github.com/InsightSoftwareConsortium/ITK/commit/e5de32ad02)) |
| 144 | + |
| 145 | + |
| 146 | +### Matt McCormick (25): |
| 147 | + |
| 148 | +#### Enhancements |
| 149 | + |
| 150 | +- Initial pixi configuration ([e2eef2d73d](https://github.com/InsightSoftwareConsortium/ITK/commit/e2eef2d73d)) |
| 151 | +- Add Pixi dev environment ([5037e7447c](https://github.com/InsightSoftwareConsortium/ITK/commit/5037e7447c)) |
| 152 | +- Add Pixi GitHub Actions Configuration ([bb705e50eb](https://github.com/InsightSoftwareConsortium/ITK/commit/bb705e50eb)) |
| 153 | +- Add Pixi python-exe and python-exe-debug tasks ([73841d0a89](https://github.com/InsightSoftwareConsortium/ITK/commit/73841d0a89)) |
| 154 | +- Python dispatch on the first RequiredInputName ([8185e10aab](https://github.com/InsightSoftwareConsortium/ITK/commit/8185e10aab)) |
| 155 | +- Add Pixi osx-64 configuration ([84a8386daa](https://github.com/InsightSoftwareConsortium/ITK/commit/84a8386daa)) |
| 156 | +- Add Intel Mac to Pixi GitHub Action tests ([7d759f2e4e](https://github.com/InsightSoftwareConsortium/ITK/commit/7d759f2e4e)) |
| 157 | +- Add Pixi mac ARM configuration ([0306e8e654](https://github.com/InsightSoftwareConsortium/ITK/commit/0306e8e654)) |
| 158 | +- Add ARM Mac to Pixi GitHub Action tests ([78a6cb7ca4](https://github.com/InsightSoftwareConsortium/ITK/commit/78a6cb7ca4)) |
| 159 | +- Bump ITK version to 5.4.2 ([898def6451](https://github.com/InsightSoftwareConsortium/ITK/commit/898def6451)) |
| 160 | + |
| 161 | +#### Documentation Updates |
| 162 | + |
| 163 | +- Update .zenodo ([a890386f7d](https://github.com/InsightSoftwareConsortium/ITK/commit/a890386f7d)) |
| 164 | +- Improve itk_hdf5_mangle.h.in instructions ([c595d0b26b](https://github.com/InsightSoftwareConsortium/ITK/commit/c595d0b26b)) |
| 165 | +- Document development with Pixi ([1b75686e2c](https://github.com/InsightSoftwareConsortium/ITK/commit/1b75686e2c)) |
| 166 | +- Updates for release testing data uploads ([9a3a8d2961](https://github.com/InsightSoftwareConsortium/ITK/commit/9a3a8d2961)) |
| 167 | + |
| 168 | +#### Platform Fixes |
| 169 | + |
| 170 | +- Set CastXML flag based on CMAKE_CXX_STANDARD ([9ebd1d6ff9](https://github.com/InsightSoftwareConsortium/ITK/commit/9ebd1d6ff9)) |
| 171 | +- Remove unused setuptools upgrade in Linux builds ([2734a97318](https://github.com/InsightSoftwareConsortium/ITK/commit/2734a97318)) |
| 172 | +- Bump ITKTotalVariation remote module ([da08898f21](https://github.com/InsightSoftwareConsortium/ITK/commit/da08898f21)) |
| 173 | +- Use .clang-format from release-5.4 branch ([6d3e550ba6](https://github.com/InsightSoftwareConsortium/ITK/commit/6d3e550ba6)) |
| 174 | + |
| 175 | +#### Bug Fixes |
| 176 | + |
| 177 | +- Move InputSpaceName, OutputSpaceName from Transform to TransformBase ([107e3ad040](https://github.com/InsightSoftwareConsortium/ITK/commit/107e3ad040)) |
| 178 | +- Update HDF5 name mangled symbols ([be7d38694c](https://github.com/InsightSoftwareConsortium/ITK/commit/be7d38694c)) |
| 179 | +- Fix pixi caching of Python Debug builds ([0967a50721](https://github.com/InsightSoftwareConsortium/ITK/commit/0967a50721)) |
| 180 | +- GenerateImageSource sets Size from ReferenceImage ([c54f1b1a2b](https://github.com/InsightSoftwareConsortium/ITK/commit/c54f1b1a2b)) |
| 181 | + |
| 182 | +#### Style Changes |
| 183 | + |
| 184 | +- clang-format fixes to itkSLICImageFilter.hxx ([d8614fa2c4](https://github.com/InsightSoftwareConsortium/ITK/commit/d8614fa2c4)) |
| 185 | +- clang-format updates to itkGridImageSourceTest2.cxx ([a54a6455e3](https://github.com/InsightSoftwareConsortium/ITK/commit/a54a6455e3)) |
| 186 | + |
| 187 | +### Mihail Isakov (1): |
| 188 | + |
| 189 | +#### Bug Fixes |
| 190 | + |
| 191 | +- Fix ExposeMetaData<std::vector<double>> im MetaImageIO ([087a1c4fb0](https://github.com/InsightSoftwareConsortium/ITK/commit/087a1c4fb0)) |
| 192 | + |
| 193 | + |
| 194 | +### Niels Dekker (3): |
| 195 | + |
| 196 | +#### Enhancements |
| 197 | + |
| 198 | +- Add nested CoordinateType aliases as alternative to CoordRepType ([bdfd0c2207](https://github.com/InsightSoftwareConsortium/ITK/commit/bdfd0c2207)) |
| 199 | +- Add ...CoordinateType aliases as alternative to ...CoordRepType ([be27beb8cb](https://github.com/InsightSoftwareConsortium/ITK/commit/be27beb8cb)) |
| 200 | + |
| 201 | +#### Bug Fixes |
| 202 | + |
| 203 | +- `QuadEdgeMeshPoint` should be properly initialized by `{}` ([ef7521d2bd](https://github.com/InsightSoftwareConsortium/ITK/commit/ef7521d2bd)) |
| 204 | + |
| 205 | + |
| 206 | +### Ziv Yaniv (1): |
| 207 | + |
| 208 | +#### Bug Fixes |
| 209 | + |
| 210 | +- Missing writing of the nifti descrip field. ([9749611e77](https://github.com/InsightSoftwareConsortium/ITK/commit/9749611e77)) |
| 211 | + |
| 212 | + |
| 213 | +ITK Software Guide Changes Since v5.4.0 |
| 214 | +--------------------------------------------- |
| 215 | + |
| 216 | +### Dženan Zukić (2): |
| 217 | + |
| 218 | +#### Documentation Updates |
| 219 | + |
| 220 | +- Fix a typo in CreateAModule chapter ([1d04a60](https://github.com/InsightSoftwareConsortium/ITKSoftwareGuide/commit/1d04a60)) |
| 221 | +- Update supported compiler version information ([95b46fe](https://github.com/InsightSoftwareConsortium/ITKSoftwareGuide/commit/95b46fe)) |
| 222 | + |
| 223 | + |
| 224 | +### Matt McCormick (3): |
| 225 | + |
| 226 | +#### Enhancements |
| 227 | + |
| 228 | +- Bump ITK version to v5.4.0 ([c722c6a](https://github.com/InsightSoftwareConsortium/ITKSoftwareGuide/commit/c722c6a)) |
| 229 | + |
| 230 | +#### Documentation Updates |
| 231 | + |
| 232 | +- Update ITK logo ([d341bad](https://github.com/InsightSoftwareConsortium/ITKSoftwareGuide/commit/d341bad)) |
| 233 | +- Update single PDF cover page for ITK 5.4.0 ([0e3ae9e](https://github.com/InsightSoftwareConsortium/ITKSoftwareGuide/commit/0e3ae9e)) |
| 234 | + |
| 235 | + |
| 236 | +### Niels Dekker (3): |
| 237 | + |
| 238 | +#### Enhancements |
| 239 | + |
| 240 | +- Add section "Initializing variables of fixed size array types" ([f10846c](https://github.com/InsightSoftwareConsortium/ITKSoftwareGuide/commit/f10846c)) |
| 241 | + |
| 242 | +#### Documentation Updates |
| 243 | + |
| 244 | +- Describe `ITK_DEFAULT_COPY_AND_MOVE` ([8430b42](https://github.com/InsightSoftwareConsortium/ITKSoftwareGuide/commit/8430b42)) |
| 245 | + |
| 246 | +#### Platform Fixes |
| 247 | + |
| 248 | +- Replace backticks with `\code{}` in Initialization and Assignment ([5246e64](https://github.com/InsightSoftwareConsortium/ITKSoftwareGuide/commit/5246e64)) |
| 249 | + |
| 250 | +Remote Module Changes Since v5.4.0 |
| 251 | +--------------------------------------------- |
| 252 | + |
| 253 | +## TotalVariation: |
| 254 | +### Jon Haitz Legarreta Gorroño (1): |
| 255 | + |
| 256 | +#### Enhancements |
| 257 | + |
| 258 | +- Transition project configuration to `pyproject.toml` ([ad32c14](https://github.com/InsightSoftwareConsortium/ITKTotalVariation/commit/ad32c14)) |
| 259 | + |
| 260 | + |
| 261 | +### Matt McCormick (4): |
| 262 | + |
| 263 | +#### Enhancements |
| 264 | + |
| 265 | +- Bump CI configuration for ITK 5.4.0 ([2e7bcbe](https://github.com/InsightSoftwareConsortium/ITKTotalVariation/commit/2e7bcbe)) |
| 266 | + |
| 267 | +#### Platform Fixes |
| 268 | + |
| 269 | +- Change from FetchContent_Populate to FetchContent_MakeAvailable ([a5484bd](https://github.com/InsightSoftwareConsortium/ITKTotalVariation/commit/a5484bd)) |
| 270 | +- Add find_package(OpenMP) to module export code ([a8ba12c](https://github.com/InsightSoftwareConsortium/ITKTotalVariation/commit/a8ba12c)) |
| 271 | + |
| 272 | +#### Bug Fixes |
| 273 | + |
| 274 | +- Bump Python package version for re-deploy ([9f6654d](https://github.com/InsightSoftwareConsortium/ITKTotalVariation/commit/9f6654d)) |
| 275 | + |
0 commit comments