Debian Codegraph @

CHANGELOG

raw
1 Release CMTK-3.3.1p2 (2021-03-27):
2
3 (r5443) Fixed: compilation errors using C++17.
4
5 Release CMTK-3.3.1p1 (2019-01-24):
6
7 (r5440) Fixed: compilation error when building with DCMTK 3.6.4.
8
9
10 Release CMTK-3.3.1 (2016-01-23):
11
12 (r5419) Fixed: bug in PolynomialXform class, which lead to out-of-range
13 array access in the parameter vector when trying to get the
14 linear matrix of a zero-degree transform (which doesn't exist).
15 (r5418) Fixed: some compiler warnings revealed by SolarisStudio compiler.
16
17
18 Release CMTK-3.3.0 (2016-01-16):
19
20 (r5404) Fixed: removed 32bit (31, really) limit on number of pixels in
21 an image, at least for most algorithms. Volume reconstruction
22 will continue to be limited due to 32bit integers being used as
23 vector indexes in AlgLib numerical code.
24 (r5394) Changed: limit number of images in groupwise registration to 255.
25 This reduces memory consumption significantly.
26 (r5392) Fixed: compile problems with VisualStudio Express 2015.
27 (r5391) Fixed: recent system DCMTK versions on Fedora (perhaps elsewhere too)
28 have lost constants for ACR-NEMA legacy field tags. Re-added those
29 for compatibility.
30
31
32 Release CMTK-3.2.3 (2015-02-01):
33
34 (r5381) Fixed: link error on Win64 due to missing implementation of a
35 conversion method for 64bit integers.
36 (r5380) Fixed: MXML 2.8 is broken; when this version is detected, fall back to
37 bundled library version.
38 (r5378) Fixed: bashisms fixed by merging downstream Debian patch; see
39 https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=772217. Patch
40 provided by Michael Gilbert <[email protected]>.
41 (r5377) Fixed: on Windows, recursive directory creation failed if the given
42 path begin with a drive letter. Thanks to Florian Schulze,
43 [email protected], for finding and fixing the problem.
44 (r5375) Fixed: when DICOM files have fractional rescale slope, read image as
45 floating point, not integer.
46 (r5375) Fixed: "dcm2image" tool did not respect command line options to ignore
47 acquisition number tags and disable orientation checks.
48 (r5374) Fixed: bashisms in two scripts.
49
50
51 Release CMTK-3.2.2 (2014-08-01):
52
53 (r5368) Fixed: XformList::ApplyInPlace terminated concatenation when an
54 inverted B-spline FFD transformation was encountered.
55 (r5365) Fixed: binary VTK files were previously written (illegally) as
56 double-precision data.
57 (r5353) Fixed: wrong binary paths in munger.pl script
58
59
60 Release CMTK-3.2.1 (2014-06-19):
61
62 (r5355) Added: ADNI phantom detection and quantification (exposed via the
63 "detect_adni_phantom" tool) now computes maximum dimming, i.e.,
64 minimum intensity of a 10mm sphere relative to the 90th percentile
65 of intensities over all such spheres.
66 (r5353) Added: global scale factor support in "vol2csv" tool
67 (r5347) Fixed: missing coordinate information in Siemens mosaic files must
68 be treated as zero.
69
70
71 Release CMTK-3.2.0 (2014-05-01):
72
73 (r5344) Added: manually force CNR centroid fallback in
74 "detect_adni_phantom" tool.
75 (r5340) Packaging: RPM distribution now split into "core" (binaries) and
76 "devel" (libraries and headers) packages.
77 (r5340) Packaging: TGZ packages no longer include "CMTK-M.m.p/" release
78 name prefix for stored files.
79 (r5337) Added: CMTK_BINARY_DIR and CMTK_LIRBARY_DIR as used in a number of
80 shell scripts included with CMTK can now be overridden by setting
81 them before executing one such script. This should allow CMTK to
82 work when it was installed/unpacked into a path other than the
83 installation path defined during build.
84 (r5333) Added: "epiunwarp" now has optional sixth positional parameter to
85 export reverse deformation field to a given path.
86 (r5327) Added: time units are now written to XML sidecar files for TR, TE,
87 TI, and dwell time.
88 (r5324) Added: sign of the phase encode direction is now extracted from
89 Siemens EPI files and written to XML sidecar files. This
90 information apparently is NOT available in GE files at all.
91 (r5316) Changed: "registration" and "registrationx" tools no longer
92 support the "603" special degree-of-freedom notation for no-scale
93 affine transformations. This is now denoted, more logically, as
94 "3303". Newly supported special notations have been added: "3003"
95 and "3033" for affine with no rotation or scale, and affine with
96 no rotation, respectively.
97 (r5309) Added: symmetric affine registration now also supports in-plane
98 transformations.
99 (r5307) Improved: "imagemath" tool's "--average" operator no longer
100 returns missing values for a pixel where a single one of the input
101 images has missing (padded) data.
102 (r5303) Added: new "geomatch" tool can compare grid dimensions, pixel
103 sizes, and/or transformation matrices of two or more images to
104 ensure that they match.
105 (r5297) Added: "dof2mat" tool can now print only 3x3 top-left submatrix.
106 (r5293) Added/Changed: "mat2dof" tool no longer has unintuitive
107 single-character options for xform modifiers. Instead, it now
108 supports writing to a single, simple transformation file.
109 (r5281) Added: "sequence" tool can now optionally create histogram files
110 in CSV format.
111 (r5270) Changed: where appropriate, image processing operators now set the
112 data class of their outputs as "LABEL". This includes a variety of
113 binarization/thresholding techniques, label combination
114 algorithms, and segmentations.
115 (r5260) Added: distance map-based erosion of multi-label fields, both in
116 the library and exposed via the new "--erode-distance-multilabel"
117 operation of "convertx"
118 (r5250) Fixed: compilation errors with Visual C++ 2013.
119 (r5243) Added: exact isotropic resampling in UniformVolume class, exposed
120 at command line via new "--resample-exact" operation of the
121 "convertx" tool.
122 (r5240) Added: interpolator classes now issue a warning message to the
123 console when an unsuitable interpolator (i.e., cubic, spline,
124 linear, sinc) is used on data flagged as "labels."
125 (r5238) Changed: "reformatx" tool now propagates floating image data class
126 (label or grey) to output, as represented by the "intent_code"
127 header field when written in NIfTI format.
128 (r5238) Added: new operations in "convertx" tool, "--labels" and "--grey",
129 set and reset the "intent_code" field in NIfTI images to
130 NIFTI_INTENT_LABEL and 0, respectively.
131 (r5230) Added: the "xform2dfield" tool can now write deformation fields
132 for use by FSL's "applywarp" tool.
133 (r5230) Added: XformIO can now write deformation fields in NIfTI format,
134 albeit very inflexibly so.
135 (r5222) Improved: region-based DataGrid filters now use OpenMP
136 acceleration where available (but they no longer report progress
137 or allow user cancellation).
138 (r5220) Added: freq_dim, phase_dim, slice_dim as well as slice times and
139 acquisition order fields are now properly set in NIFTI headers for
140 files created by "dcm2image," so long as these data were available
141 in the input DICOM files.
142 (r5214) Added: slice times (relative to first slice in each volume) are
143 now extracted from Siemens DICOM files and written to XML sidecar
144 files by "dcm2image" tool.
145
146
147 Release CMTK-3.1.0 (2014-02-21):
148
149 (r5203) Changed: "dcm2image" tool now returns exit code 3 if one or more
150 image stacks could not be built due to non-uniform slice spacing
151 that exceeds the given "--tolerance" threshold.
152 (r5196) Added: "vol2csv" tool now accepts user-define column labels for
153 the optional density-weighted volumes.
154 (r5195) Added: DICOM import now supports Philips tags for diffusion
155 information (b Value and gradient direction vectors).
156 (r5187) Changed: "fview" GUI now expects only a transformation sequence on
157 the command line. To override fixed and/or moving image (or to
158 provide them, if they are not stored within the transformation),
159 use the new optional arguments, "--fixed" and "--moving".
160 (r5185) Added: for convenience, histogram- and mean/sdev-based intensity
161 matching are now also available in "convertx", in addition to
162 "imagemath".
163 (r5183) Fixed: use of MacPorts should be optional, even if its directory
164 tree exists.
165 (r5183) Fixed: CUDA should be optional and build config file clearly
166 labelled if it is used.
167 (r5166) Added: polynomial transformation model and class to fit such
168 transformations to landmarks.
169 (r5157) Changed: "reformatx" no longer corrects Jacobian maps for global
170 scale by default. This seems like a more natural way to do this.
171 (r5154) Added/changed: "unwarp_image_phantom" tool now supports (and
172 defaults to) polynomial transformations, rather then B-spline
173 FFD.
174
175
176 Release CMTK-3.0.0 (2014-01-09):
177
178 (r5122) Fixed: wrong offset computation broke fitting of B-spline
179 transformation to transformation series.
180 (r5121) Fixed: over 200 code defects identified by static analysis
181 (Coverity Scan) have been fixed over the past 200 or so commits.
182 (r5110) Fixed: fitting a B-spline transformation to an XformList that
183 contained a nonrigid transformation, specifically a numerically
184 inverted one, did not properly exclude locations where the
185 inversion failed or the input location was outside the B-spline
186 grid's support region.
187 (r5097) Added: "streamxform" tool can now apply only affine components of all
188 provided transformations, via the "--affine-only" option (contribution
189 from Greg Jefferis).
190 (r5087) Changed: "dwi_find_bad_slices" now more appropriately named
191 "dwi_mask_bad_slices". Tool can now mask detected bad slices, convert
192 image pixel type, and write masked images.
193 (r5012) Added: "dcm2image" tool (and cmtkIO library) now determine "dwell
194 time" from DICOMs from both GE and Siemens scanners. This is necessary
195 for applying fieldmap-based distortion corrections.
196 (r5008) Added: new "resample" operator for "convertx" tool to create
197 near-isotropic resampled images with the same FOV as the original.
198 (r4983) Added: new "stream_pixels" tool should make it easier to stream image
199 data through pipeline-based tools such as Camino's.
200 (r4978) Changed: "dcm2image" tool no longer embeds study information into
201 Nifti header; this is for subject privacy when data are going to
202 be shared.
203 (r4977) Improved: "detect_adni_phantom" tool has new options,
204 "--refine-xform", "--refine-outliers", and
205 "--exclude-outliers". Detection has also been made more robust by
206 ordering 10mm spheres by increasing distance from phantom center.
207 (r4892) Changed: by default, "mk_analyze_hdr" and "mk_nifti_hdr" now
208 create a header with "Byte" as the image pixel data type, and
209 "axial" as the orientation (for "mk_analyze_hdr" only).
210 (r4855) Added: "detect_adni_phantom" tool (and library classes) now state
211 in the output XML file whether certain fallback conditions were
212 triggered. These usually hint at problems with the imaging
213 phantom, e.g., missing spheres.
214 (r4852) Added: new tool, "interleaved_bad_slices" identifies volumes (and
215 slices) in a time series such as rs-fMRI where the entire volume
216 is bad due to motion during the interleaved acquisition.
217 (r4819) Added: "describe" tool can now describe transformation files as
218 well as images.
219 (r4797) Changed: "dcm2image" tool now enforces uniform volume spacing up
220 to given tolerance level. Volumes with non-uniformity exceeding
221 the threshold, no volume will be created, thus avoiding creation
222 of invalid data.
223 (r4792) Added: multi-iteration and residual-controlled fitting of B-spline FFD
224 to phantom landmarks.
225 (r4787) Added: new "vol2csv" tool writes regional volumes of a label image
226 to a CSV files, optionally using a text file with label
227 descriptions, a (Jacobian) pixel volume scale map, and one or more
228 "density" maps, such as tissue probabilities etc.
229 (r4774) Removed: the "contributed" N-CANDA pipeline scripts have been
230 moved out of the CMTK code tree and into the N-CANDA Data Core
231 repository, hosted at http://nitrc.org/svn/ncanda-datacore
232 (r4770) Improved: speed-up of FFT-based matched filter sphere detection.
233 Benefits primarily ADNI phantom detection (faster by up to about
234 25-30 percent)
235 (r4760) Changed: "CMTK_BUILD_WRAPPER" is now turned ON by default (i.e.,
236 wrapper script "cmtk" is built, and all binaries are installed
237 into a private directory)
238 (r4758) Added: "dcm2image" tool has new option, "--no-progress" to disable
239 progress reporting (for batch operation).
240
241
242 Release CMTK-2.3.0 (2013-05-16):
243
244 (r4751) Added: ADNI phantom detection tool now also functions when the
245 60mm SNR sphere is displaced.
246 (r4732) Added: ADNI phantom detection tool can now robustly bootstrap gross
247 orientation from CNR spheres if one or both of the 15mm phantom
248 spheres are missing.
249 (r4719) Added: dilation and erosion in anisotropic images by distance, not by
250 pixels.
251 (r4708) Added: ADNI phantom detection is now more robust in the presence
252 of missing, cropped, or low-contrast marker spheres.
253 (r4703) Added/Changed: dcm2image now only exports potentially protected,
254 identifying meta-data (e.g., UIDs, paths, dates) into XML files if
255 specifically instructed to do so.
256 (r4699) Added: ADNI phantom detection tool now recognizes when marker spheres
257 are (partially) outside image field of view. Optional "tolerant" mode
258 can override program termination.
259 (r4690) Added: ADNI phantom description file (XML) now contains estimated
260 scale factors and nonlinearity.
261 (r4684) Added: pixel search tool, "pxsearch." For now, this simply
262 searches for the pixel with the maximum value in a local
263 neighborhood.
264 (r4680) Fixed: use of stat() rather than stat64() broke access to files on
265 large file systems.
266 (r4674) Fixed: FFTW dependency was not really options due to incorrect
267 configuration conditions (Issue #6841).
268 (r4670) Fixed: an error in WarpXform::ReplaceInitialAffine broke
269 convert_warp tool, specifically the computation of a fractional
270 transformation. New test cases have also been added to cover this.
271 (r4662) Fixed: check whether FFTW libraries were found rather than relying on
272 CMTK_USE_FFTW option being set.
273 (r4654) Added: N-CANDA script for creating GRE field maps using FSL/prelude
274 (r4652) Fixed: OpenMP problems using VisualStudio
275 (r4648) Fixed: configuration problem with CMake 2.8.10 due to changed path to
276 CMakeSystem.cmake file.
277 (r4622) Added: N-CANDA structural pipeline in "contrib/ncanda/"
278 (r4595) Added: more channels of the SRI24 atlas added to the CMTK
279 repository. The atlas is also now installed and packaged with the
280 toolkit.
281 (r4586) Added: Otsu thresholding now integrated into "mrbias" tool.
282
283
284 Release CMTK-2.2.6 (2012-10-29):
285
286 (r4573) Fixed: DICOM stacker segfaulted
287 (r4571) Updated: NrrdIO has been updated to current upstream code base from
288 https://teem.svn.sourceforge.net/svnroot/teem/NrrdIO/trunk
289 (r4562) Fixed: center of mass was not computed properly if Inf or NaN data
290 were present in the image.
291
292
293 Release CMTK-2.2.5 (2012-10-22):
294
295 (r4551) Added: "dcm2image" tool can now substitute components of the input
296 image paths into generated output images - "%0" represents the input
297 file name (for the first image in a multi-file stack), "%1" through
298 "%9" the hierarchical directories in order of decreasing depth, i.e.,
299 from deepest to highest.
300 (r4529) Added: image type (magnitude, real, phase) can now be extracted from
301 Siemens DICOM files.
302 (r4527) Fixed: incorrect image origin was previously computed for Siemens
303 mosaic DICOM images (Issue #6754).
304 (r4522) Added: more DICOM information is now put into the dcm2image-generated
305 XML files, such as MR imaging frequency; study, series, and
306 frame-of-reference UIDs; device serial number; and intensity rescale
307 intercept and slope values. Also gave all tags with values straight
308 from the DICOM tags a "dicom:" XML namespace prefix.
309 (r4513) Added: for GE DICOM images, the raw data type (magnitude, phase, real,
310 or imaginary) is now written into the output XML files by the
311 "dcm2image" tool.
312 (r4510) Refactored: more logical API for symmetric matrix eigensystem
313 computation. Symmetric matrices are now actually enforced, whereas
314 previously it was silently assumed all matrices handed to the
315 eigensystem functions were symmetric.
316 (r4504) Added: "dcm2image" tool can now write single-slice images also
317 (these were skipped previously). Use the new
318 "--write-single-slices" command line switch to activate this
319 behaviour.
320
321
322 Release CMTK-2.2.4 (2012-08-24):
323
324 (r4498) Fixed: some PACS-processed Siemens mosaic DICOM files have lost
325 some DCM tags; missing information must be parsed from CSA headers
326 instead.
327 (r4485) Fixed: echo planar image unwarping created NaN deformations if any of
328 the image columns was all zeroes, because no center of mass could be
329 computed. For these cases, deformation is now forced to zero
330 initially.
331
332
333 Release CMTK-2.2.3 (2012-08-10):
334
335 (r4475) Added: new "contrib" directory for third-party contributions;
336 initially Greg Jefferis' "munger" Perl script.
337 (r4470) Added: new "groupwise_reformat" script simplifies reformatting all
338 images in a set aligned with one of the groupwise registration
339 tools.
340 (r4458) Fixed: older versions of FFTW than 3.3.2 now supported again.
341 (r4456) Fixed: when reading NRRD files with missing "spaceOrigin" entry,
342 CMTK now substitutes a zero-vector for the origin, rather than
343 keeping NrrdIO's not-a-number values.
344 (r4454) Fixed: the index-to-physical matrix of a UniformVolume was not
345 properly modified when downsampling with pixel selection (rather than
346 averaging).
347 (r4449) Added: when installed system mxml library is found, its version is
348 determined, and the bundled library is automatically built if the
349 system library is outdated (pre-2.7).
350 (r4447) Added: new tool, "dwi_find_bad_slices," to detect bad slices in
351 sets of diffusion-weighted images.
352 (r4447) Changed: image-to-physical matrix and slice spacing now work
353 properly (as in, without generating Inf/NaN values) when splitting
354 volume into single slices and re-stacking it. This has caused some
355 baselines to change, because the volume field of view sizes have
356 seen subtle changes as a result.
357
358
359 Release CMTK-2.2.2 (2012-06-18):
360
361 (r4438) Added: new tools "fit_spline_xform" and "fit_affine_xform" to fit
362 a single B-spline or affine transformation, respectively, to a list of
363 concentated, optionally inverted, transformations.
364 (r4420) Fixed: "reorient" tool can now force reorientation when original image
365 orientation is overridden by command line argument.
366 (r4400) Obsoleted: the "mip" tool as well as library code exclusively used by
367 it (e.g., support for PGM file format; volume/ray accumulators) have been
368 removed.
369 (r4385) Changed: the "fit_spline_xform" tool has been renamed to
370 "fit_spline_dfield" to make room for a new tool which will fit splines to
371 arbitrary transformation sequences.
372 (r4369) Added: new "streamxform" tool to apply sequences of transformations to
373 point coordinates read from standard input. The old tool, "gregxform", has
374 been deprecated and may be removed in a future release of CMTK.
375 (r4351) Changed: all nonrigid transformation files, "registration," are now
376 written gzip-compressed. (Linear transformation files are generally much
377 smaller and continue to be written as plain uncompressed files.)
378 (r4347) Added: "dcm2image" tool has two new options, "--filter" and
379 "--exclude", to include or exclude DICOM files selectively based on
380 matching a provided text to values of user-specified DICOM tags.
381 (r4326) Added: ADNI phantom detector now also computes SNR and four CNR
382 estimates. These are all also written to the XML phantom description
383 file.
384 (r4317) Fixed: older versions of DCMTK do not provide lossless-JPEG header
385 file <dcmtk/dcmjpls/djdecode.h>, but it isn't needed anyway.
386
387
388 Release CMTK-2.2.1 (2012-05-07):
389
390 (r4313) Fixed: previous release accidentally installed and packaged the entire
391 source tree, rather than just the Licenses/ directory. This has been fixed.
392
393
394 Release CMTK-2.2.0 (2012-05-04):
395
396 (r4280) Updated: bundled MiniXML (mxml) library is now version 2.7
397 (r4256) Changed: the "search" and "replace" parts of the CMTK_MOUNTPOINTS
398 variable have been switched. The new order is far more intuitive.
399 (r4240) Fixed: one of the functions computing Jacobian matrices for B-spline
400 FFD transformations was broken, leading to slightly skewed inverse
401 transformations in various tools. Due to direct optimization of the
402 inversion error, the actual inversion results were still accurate within
403 the given tolerance.
404 (r4195) Added: tool for unwarping images using B-spline free-form deformation
405 computed from a reference scan of the ADNI phantom.
406 (r4180) Added: detection of the landmarks in the Magphan EMR051 structural
407 imaging phantom (a.k.a. "ADNI Phantom"). Both as a library class and as a
408 command line tool ("detect_adni_phantom").
409 (r4158) Added: Otsu single-threshold binarization in library as well as
410 "convertx" tool.
411 (r4131) Added: sphere detection filter based on FFT-based fast bipolar filter
412 kernel convolution. Requires CMTK to be configured with FFTW support.
413 (r4096) Added: new tool, "fit_affine_xform_landmarks" to fit affine
414 transformations to sets of landmark pairs. Also added supporting classes
415 for fitting and landmark I/O.
416 (r4090) Added: two new tools, "fibxform" and "fib2image", for applying
417 transformation sequences to UNC Fber Tracking outputs and for marking
418 fibers in discrete images.
419 (r4074) Fixed: "dcm2image" no longer accepts printf-style substitution code
420 "%d" for image index. This was never safe, as format string is supplied by
421 user (Issue #6203).
422 (r4068) Added: CMTK now comes with a built-in model of the ADNI structural
423 imaging phantom (a.k.a. Magphan EMR051). The new tool "mk_adni_phantom"
424 can be used to create a digital image of the phantom for testing and
425 potentially registration purposes.
426 (r4052) Added: "epiunwarp" tool can now initialize deformation by matching
427 centers of mass for each row. This seems to greatly improve unwarping
428 results.
429 (r4050) Changed: "dcm2image" now defaults to "sort-by-instance" file ordering;
430 this seems more generally useful than sorting by file names. Also changed
431 names of the command line options.
432 (r4048) Fixed: system DCMTK (from MacPorts) can now be properly configured on
433 MacOS.
434 (r4041) Fixed: get correct image origin for Siemens mosaic DICOM files from
435 CSA header.
436 (r4036) Added: the "dcm2image" tool now ooptionally creates an XML sidecar
437 file for each stacked image, which contains imaging parameters including
438 b-values and diffusion-weighting vectors for DW-MRI.
439 (r4024) Obsolete: removed unused 2d/2d registration classes.
440 (r4016) Refactored: finally merged old-style SMP and non-SMP elastic voxel
441 matching functional classes.
442 (r4004) Fixed: full OpenMP support now available on MacOS.
443 (r3984) Changed: "dcm2image" tool no longer accepts "--ge-extensions" command
444 line option. Instead, all supported vendor-specific extensions are now
445 automatically activated based on the vendor tag in the actual input files.
446 (r3981) Fixed: numerous Visual C++ 2010 compiler warnings, including
447 potentially serious use of "this" pointer in member initialization.
448 (r3969) Added: cmtk::RegressionTracker class for checksum-based tracking down
449 of regression problems.
450 (r3964) Fixed: cmtk::ImagePairSimilarityJointHistogram constructor was using
451 "this" pointer before properly constructing object (Visual C++ warning).
452
453
454 Release CMTK-2.1.3 (2012-03-05):
455
456 (r3953) Refactored: the Shape-Based Averaging and Interpolation code was moved
457 from the "sbai.cxx" tool source code to a new library class,
458 "cmtk::LabelCombinationShapeBasedAveragingInterpolation"
459 (r3941) Added: the "sba" tool for Shape-Based Averaging (and the underlying
460 library class) can now optionally detect and exclude local outlier pixels
461 based on distribution of distances over all inputs at each pixel and for
462 each label.
463 (r3928) Refactored: the Shape-Based Averaging code was move from the "sba.cxx"
464 tool source code to a new library class,
465 "cmtk::LabelCombinationShapeBasedAveraging"
466 (r3922) Obsoleted: the "average_edt" tool has been replaced by two new tools,
467 "sba" and "sbai", for Shape-Based Averaging (and Interpolation). The "sba"
468 tool implements the "--interpolate-image" mode of "average_edt", whereas
469 "sbai" implements the "--interpolate-distance" mode. "Windowed" averaging
470 of intensity images was not really useful and is no longer supported.
471 (r3919) Changed: "average_edt" tool now represents labels as short integers,
472 not bytes, so it can now support label values up to 65535.
473
474
475 Release CMTK-2.1.2 (2012-02-22):
476
477 (r3902) Fixed: compilation errors using latest zlib (1.2.6); also fixed
478 configuration problem on Mac with system zlib and MacPorts zlib being
479 incompatible.
480 (r3880) Added: "fit_affine_xform" can fit an affine transformation to a
481 nonrigid transformation, either a deformation field or a B-spline
482 free-form deformation. The "fit_warp_xform" tool can use this
483 functionality now to estimate the global affine component of a deformation
484 before fitting a spline to the residual.
485 (r3873) Added: "dof2mat" tool to convert affine transformation in
486 degree-of-freedom representation to 4x4 transformation matrix.
487 (r3847) Added: "lvote" local voting tool can now normalize local, patch-based
488 similarity scores with global image-to-atlas correlations.
489 (r3837) Added: "fit_spline_xform" tool to fit B-spline free-form deformation
490 to pixel-wise deformation field .
491 (r3821) Added: "groupwise_warp" tool can now protect regions from deformation
492 if an "exclusion" mask is provided.
493 (r3814) Added: label combination by locally-weighted voting and local
494 shape-based averaging (tools "lvote" and "lsba") has been moved out of the
495 "Unstable" library and added to the default CMTK build set.
496 (r3805) Added: script for creating all officially distributed MacOS builds is
497 now included as core/scripts/PackageMacOS
498 (r3799) Fixed: prevent empty region traversal in cmtk::RegionIndexIterator
499 (r3751) Fixed: "groupwise_affine" was not actually using template image
500 specified on the command line.
501 (r3730) Fixed: histogram-based intensity matching should preserve intensity
502 range.
503 (r3728) Added: "groupwise_init" tool can now center aligned image ensemble
504 inside template field of view ("--center-template" command line switch).
505 (r3722) Added: "registrationx" tool can now compute transformations restricted
506 to in-plane components for a selected plane (xy, xz, or yz). This is
507 useful for eddy current distortion correction in EPI unwarping,
508 (r3719) Added: new "correct_dwi_distortion" script applies distortion
509 correction to an entire series of diffusion-weighted images.
510
511
512 Release CMTK-2.1.1 (2012-01-10):
513
514 (r3711) Added: new "epiunwarp" tool implements an algorithm by Holland et
515 al. (NeuroImage 2010) for unwarping echo-planar MR images (e.g., DWI)
516 using two images acquired with reversed phase encoding direction.
517 (r3698) Changed: by default, "dcm2image" now embeds concatenated DICOM tags
518 StudyID and StudyDate into "description" fields of Analyze, NIFTI, and
519 Nrrd output images.
520 (r3628) Added: "similarity" tool now computes absolute and relative image
521 differences; this feature is used by the applications test driver script
522 to perform tolerant comparisons.
523 (r3608) Removed: support for MPI distributed-memory parallelism has been
524 retired. This was rarely used, poorly tested, and due to ever larger SMP
525 systems no longer very critical.
526 (r3604) Refactored: unified DICOM reader utility class.
527 (r3591) Added: simple tissue class segmentation tool based on EM optimization
528 of a Gaussian mixture model.
529
530
531 Release CMTK-2.1.0 (2011-11-21):
532
533 (r3570) Fixed: incorrect output image orientation when providing target image
534 geometry for "reformatx", "volume_injection", or "volume_reconstruction"
535 on the command line.
536 (r3547) Added: as a configuration option ("CMTK_BUILD_WRAPPER"), a wrapper
537 script "cmtk" can now be built for consistent access to CMTK's tools while
538 avoiding name collisions with other tools installed on the same
539 system. When this option is selection, all actual binaries are installed
540 in the bin/ subdirectory of the configured *library* install
541 directory. Only the wrapper script itself is installed in the configured
542 binary install directory.
543 (r3542) Added: "fview" tool can now automatically deduce fixed and moving
544 image paths from the applied sequence of transformations, if these paths
545 were stored within the transformation file.
546 (r3529) Added: CMTK can now read Siemens MR DICOM images in mosaic format.
547 (r3522) Fixed: TypedArray data arrays are now de-allocated with proper
548 deallocator (free() or new[]()), depending on how they were allocated
549 (Issue #6213).
550 (r3505) Added: build configuration can now switch between building bundled
551 DCMTK DICOM library and using installed system libraries (Issue #6182; see
552 also Issue #6184).
553 (r3484) Added: cmtk::CommandLine class can now output program descriptions in
554 'nroff' markup sutibale for creating man pages. In addition, the build
555 system now creates these man pages, if "BUILD_MANPAGES" option is set. The
556 man pages will also be installed and packaged. This was added in response
557 to a request from Yaroslav Halchenko.
558 (r3471) Added: multi-class STAPLE algorithm can now be limited to "disputed"
559 pixels to improve results (via the "--mstaple-disputed" operation of
560 "imagemath" tool).
561 (r3442) Added: build configuration can now switch between building bundled
562 MXML library and using installed system library.
563 (r3438) Fixed: proactively fixed a problem reading and writing very large
564 gzip-compressed files. Thanks to Yaroslav Halchenko
565 <[email protected]> for pointing this out.
566 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=587912
567 (r3420) Added: when registration tools (warp, warpx, registration,
568 registrationx) are interrupted, suffix "-partial" is added to any results
569 files that may be written. This serves to prevent accidental use of
570 incomplete results.
571 (r3415) Added: the "dcm2image" tool can now embed selected meta information
572 (such as Patient Name) as "image description" in Analyze, Nifti, and NRRD
573 output files. This information is preserved by other CMTK tools (e.g.,
574 "convertx") and is now also displayed by the "describe" tool.
575 (r3408) Refactored: global static cmtk::StackBacktrace object is now
576 initialized in each "main.cxx" file, or in "cmtkSafeMain" wrapper, rather
577 than forcing CMake to re-compile initializer code into separate .o file
578 for every binary.
579 (r3405) Added: computation of fixed control points is now parallel in "warp"
580 and "warpx" tools if OpenMP support is enabled.
581 (r3400) Fixed: the thread-related environment variables (mostly
582 CMTK_NUM_THREADS) are now checked by tyhe tool-independent "cmtkSafeMain"
583 wrapper, which guarantees that they will be observed by every CMTK command
584 line tool. This should avoid over-parallelization with OpenMP.
585 (r3385) Added: "mrbias" and "mrbias_cuda" tools now have an option for
586 automatic foreground threshold selection based on estimation of image
587 noise. For that purpose, the tools now also support defining a padding
588 value for the input image (typically zero).
589
590
591 Release CMTK-2.0.0 (2011-08-15):
592
593 (r3360) Added: Hausdorff distance for binary shapes
594 (r3344) Added: fast (linear time) region variance filter based on fast region
595 mean filter.
596 (r3337) Added: fast (linear-time) region mean filter
597 (r3312) Fixed: crash in non-SMP "warp" B-spline registration.
598 (r3305) Fixed: volume_injection tool selected improper padding value due to
599 problem in the type traits implemented by the cmtkBase library.
600 (r3303) Fixed: when moving image had float/double data type, the
601 "registration" tool accidentally used zero as padding value and, as a
602 result, ignored image background.
603 (r3300) Fixed: broken array indexing made "mcwarp" tool crash when intensity
604 correction was activated. Also produced incorrect results.
605 (r3288) Fixed: external projects can now find and use CMTK properly. The
606 "validation" tree has been moved out of "core/" and now uses CMTK's core like
607 any other external project.
608 (r3277) Changed/fixed: padding flag and value are now propagated to the new
609 array when converting the scalar data type of an existing array.
610
611
612 Release CMTK-1.7.1 (2011-07-14):
613
614 (r3270) Added: new "probe" tool implements "volume probe" functionality
615 formerly provided by "describe" tool, with several extensions such as
616 flexible coordinate specification and interpolation modes.
617 (r3265) Fixed: potential infinite loop in "imagemath" tool when images of
618 different size were on the stack for a multi-image operation.
619 (r3263) Fixed: crash in SMP nonrigid registration due to incorrect use of
620 number of tasks submitted to thread pool.
621 (r3256) Added: missing "histogram pruning" operator in "convertx" tool.
622 (r3198) Added: symmetric optimization of forward and inverse affine
623 transformation in "registrationx" tool.
624 (r3190) Fixed: when reformatting a moving image, the reformatted image now
625 inherits the input image's padding flag and value. This addresses an issue
626 with reformatted floating-point images breaking Slicer and other tools do
627 to "Inf" used for padding by default. The registration tools can now be
628 run with the "--pad-flt" flag to set input image padding, which then
629 propagates into the reformatted output image.
630 (r3187) Added: new "destripe" tool removes stripe artifacts from accross-slice
631 intensity variations.
632 (r3176) Added: "convertx" tool now supports downsampling by pixel selection in
633 addition to downsampling by pixel averaging.
634
635
636 Release CMTK-1.7.0 (2011-04-18):
637
638 (r3158) Fixed: allow OpenMP to be disabled by initial CMake cache file, which
639 is necessary on MacOS to allow automated release building.
640 (r3151) Added: two-level command line help; "--help" now prints only basic
641 options, whereas "--help-all" prints all options including those marked as
642 "advanced." this should make it easier for new users to get a quick
643 overview of essential functions.
644 (r3120) Fixed: Nrrd library was not properly splitting file paths containing
645 Windows-style separators ('\' rather than '/').
646 (r3118) Improved: bundled NrrdIO library was updated to 1.11.0 from 1.9.0.
647 (r3114) Fixed: CMTK now compiles with OpenMP support using VisualStudio
648 compilers. All OpenMP parallel loops are now using signed, rather than
649 unsigned, loop variables, thus complying with older (pre-3) versions of
650 the OpenMP standard.
651 (r3079) Fixed: reading of uncompressed BioRad (and potentially other format)
652 files was broken (patch by Greg Jefferis).
653 (r3062) Fixed: problem with directory creation due to difference path
654 separator characters for Windows vs. POSIX.
655 (r3059) Fixed: broken thread semaphores on Windows due to incorrect
656 conditional compilation. (This bug was introduced in r1661.)
657 (r3031) Fixed: problem with instantiation of static smart pointer "NULL"
658 object led to crashes on MacOS-X platform. This has been fixed.
659 (r3031) Fixed: linking errors when building shared libraries on MacOS, caused
660 by missing library dependencies.
661 (r3003) Improved: CMTK now employs a toolkit-wide, centralized, fine-grain
662 framework for diagnostic outputs of user-defined detail level. Every
663 command line tool supports the new "--verbose-level" option; output
664 previously generated using the deprecated "--verbose" option is at level
665 "1" and can thus be enabled by "--verbose-level 1".
666 (r2974) Added: initial support for Grand Central Dispatch, including GCD-based
667 backend for thread pool parallel model.
668 (r2919) Added: regional image filters, such as mean, variance, and third
669 moment added to "convertx" tool.
670 (r2908) Changed: "--verbose" output now written to standard output, not
671 standard error (Issue #5496).
672 (r2905) Added: "reformatx" and "convertx" tools now support "unsigned int"
673 pixel data type for output files (Issue #5497).
674
675
676 Release CMTK-1.6.1 (2011-02-17):
677
678 (r2886) Fixed: crash in "fview" fusion viewer application due to incorrect
679 interface of class derived from QApplication.
680 (see http://lists.trolltech.com/qt-interest/2008-01/thread00570-0.html)
681 (r2884) Added: all CMTK command line tools now support the "--version"
682 argument to print the CMTK version number.
683 (r2878) Fixed: "--write-reformatted" option of "registration" tool was
684 broken. In some cases, the wrong image was used as the fixed image.
685 (r2871) Fixed: pipe-based decompression was broken on MacOSX
686 (r2869) Improved: "runcheck" tool is now more sensitive to stdlibc++ version.
687
688
689 Release CMTK-1.6.0 (2011-02-01):
690
691 (r2858) Added: "mk_phantom_3d" can now read MRS voxel location and size from
692 GE DICOM files and draw voxel in correct location, if image grid with matching
693 physical scanner coordinates is imported.
694 (r2845) Improved: "volume_injection" and "volume_reconstruction" tools now
695 produce reconstructed images with physical space coordinates matching
696 those of the first input image.
697 (r2829) Improved: various fixes related to packaging. Now uses non-default
698 installation prefix, renamed installation components, added missing RPM
699 fields.
700 (r2818) Fixed: building using MacOSX SDK 10.4u now uses gcc version 4.0, which
701 works, unlike the default gcc-4.2 with this SDK version.
702 (r2815) Added: CMTK build can now be configured to use bundled sqlite3
703 library, even when system library is available. This avoids problems with
704 multiple different versions of the library in different SDKs on MacOS.
705 (r2815) Updated: bundled sqlite3 library has been updated to version 3.7.4.
706 (r2805) Added: "convertx" can now apply mapping functions to replace image
707 values with other values or with padding data.
708 (r2794) Improved: better default configurations for MacOS-X builds.
709 (r2794) Fixed: packaging and installation directories.
710 (r2772) Fixed: label combination by voting now supports up to 32768 labels
711 (was 256).
712 (r2768) Removed: unused and redundant "probe_xform" and "average_grey"
713 applications. Use "gregxform" and "reformatx"/"average_images" instead.
714 (r2765) Removed: largely unused and incomplete support for building a single
715 "cmtk" binary wrapper for all command line tools.
716 (r2760) Removed: now-obsolete "convert" tool has been retired. Operations
717 still missing in "convertx" will be added as the need arises.
718 (r2756) Added: "convertx" tool gained two more missing operations from
719 "convert", namely replace padded pixels and pixels with Inf/NaN values.
720 (r2752) Improved: addressing all warnings reported by "doxygen", source code
721 documentation has been completed.
722 (r2733) Removed: the "congeal", "groupwise_rmi", "congeal_warp", and
723 "groupwise_rmi_warp" tools have been removed. These are replaced by the
724 "groupwise_affine" and "groupwise_warp" tools introduced in the previous
725 release.
726
727
728 Release CMTK-1.5.4 (2011-01-13):
729
730 (r2714) Changed: all command line tools now default to writing output in NIFTI
731 format, not Analyze, if no output file name is given.
732 (r2708) Added: new "groupwise_warp" tool for nonrigid groupwise registration
733 unites the "congeal_warp" and "groupwise_rmi-warp" tools, which will be
734 removed in the next release of CMTK.
735 (r2705) Added: new "groupwise_affine" tool for affine groupwise registration
736 unites the "congeal" and "groupwise_rmi" tools, which will be removed in
737 the next release of CMTK.
738 (r2695) Fixed: subtle and rare numerical problem leading to NAN values in
739 image-to-physical matrix read from Nifti files with quaternion-based
740 orientation.
741 (r2684) Fixed: improved installation and packaging by fixing multiple problems
742 related to CMTK use files and scripts.
743 (r2680) Improved: better naming, grouping, and documentation of "film",
744 "volume_injection", and "volume_reconstruction" command line options. Also
745 named equivalent options consistently between these tools.
746 (r2664) Fixed: restricting "warpx" tool deformation to certain coordinate
747 directions was broken.
748
749
750 Release CMTK-1.5.3 (2010-12-13):
751
752 (r2652) Improved: CMTK can now be more flexibly configured to use bundled zlib
753 over existing system zlib. This is partially addressing Issue #5395, with
754 a patch provided by Kent Williams. This also fixes Issue #5382, because
755 we no longer depend on Darwin's broken system zlib.
756 (r2629) Fixed: LZMA decompression was broken on i686 due to bug in
757 lzmadec_seek(). The decompression backend classes now use a common fake
758 "seek" implementation if seek is not supported by the low-level backend or
759 broken.
760 (r2613) Fixed: "dbtool" was warning of unused command line parameters.
761 (r2611) Fixed: properly exit "fview" application with an exception when one of
762 the input images cannot be read.
763
764
765 Release CMTK-1.5.2 (2010-12-06):
766
767 (r2591) Fixed: previous release accidentally removed the ability of CMTK's
768 image writer to recursively create non-existing directories in the output
769 path.
770
771
772 Release CMTK-1.5.1 (2010-12-02):
773
774 (r2580) Fixed: segmentation fault when getting cropped subvolume after
775 providing out-of-range cropping boundaries.
776 (r2575) Fixed: all output images are now written in the same orientation and
777 pixel array order as the respective input images. Previously, images were
778 written in internal order, i.e., RAS or closest orientation supported by
779 output file format. For backward compatibility, the old behaviour can be
780 turned back on by defining the "CMTK_LEGACY_WRITE_IMAGES_RAS" environment
781 variable.
782 (r2563) Fixed: "dcm2image" tool choked on non-DICOM files.
783 (r2560) Added: "dcm2image" tool has new option to ignore AcquisitionNumber tag
784 when grouping images, which is useful for Siemens fMRI series. Tool also
785 now warns if images are left over that cannot be assigned to any stack.
786 (r2558) Fixed: CMake initial cache files for pre-defined configurations now
787 set cache variables.
788
789
790 Release CMTK-1.5.0 (2010-11-17):
791
792 (r2544) Added: "similarity" in label mode now prints Jaccard index, J.
793 (r2540) Fixed: all command line tools now use a C++-safe exit mechanism based
794 on throwing an exit exception that is caught in a safe main() wrapper
795 function.
796 (r2540) Fixed: CommandLine class was leaking memory because some local classes
797 did not have virtual destructors (Issue #5320).
798 (r2512) Fixed: SmartPointer::DynamicCastFrom() was leaking memory due to
799 implicit, rather than explicit, call to inherited constructor.
800 (r2505) Added: "film" tool now has "--padding-value" option to define a
801 padding value for the input image. Also to get this to work,
802 UniformVolume::GetInterleavedSubvolume() now copies padding flag and value
803 from input data to output.
804 (r2502) Fixed: "ReformatVolume::CreateInterpolator" did not actually create a
805 nearest neighbor interpolator when so requested.
806 (r2500) Fixed: "imagemath" tool performed incorrect operations for the "exp"
807 and "sqrt" do to incorrect function wrapper.
808 (r2495) Added: "dcm2image" tool can now optionally sort output images by
809 instance numbers of the input image files, rather than by their
810 names. This is useful when using variable-length numbered files that must
811 be stacked in order (e.g., for functional MRI).
812 (r2483) Added: "fview" fusion viewer tool can now switch between no
813 transformation (identity), affine-only and full nonrigid transformation.
814 (r2479) Fixed: ITK transformations must be in LPS space, regardless of the
815 coordinate spaces of the images being registered.
816 (r2467) Fixed: make consistent use of C memory allocator to avoid conflicts
817 between core CMTK and external libraries (e.g., NrrdIO).
818 (r2467) Added: "warp" and "warpx" tools have new option, "--relax-to-unfold"
819 to unfold deformation regions with negative Jacobians before continuing
820 at the next resolution level. Hopefully, this will allow more aggressive
821 deformations without incurring folding, thus improving registration
822 accuracy.
823 (r2450) Removed: support for pixelwise incompressibility weight maps, which
824 was never really used and hasn't been exposed at the command line for a
825 while.
826 (r2445) Fixed: conversion of affine transformation to/from ITK format and
827 native image space failed when fixed and moving images resided in different
828 spaces (fixed image space was used for both of them).
829 (r2440) Fixed: newly created transformation objects should, by default, set
830 their coordinate space to CMTK's default space, RAS.
831 (r2436) Added: "mk_nifti_hdr" tool to create NIFTI headers from scratch or
832 patch existing headers.
833 (r2434) Fixed: "CMakeFiles" directory gets in the way of in-source builds
834 (Issue #5269). Thanks to Dominique Belhachemi for report and fix.
835 (r2422) Fixed: "registrationx" tool ignored user specification for transform
836 initializer and always used an identity transformation unless an explicit
837 initial alignment was provided.
838 (r2416) Changed: "make_initial_affine" now defaults to writing transformations
839 in CMTK standard RAS space, rather than between native image spaces. This
840 makes much more sense, because in all likelihood it will be other CMTK
841 tools reading these transformations.
842 (r2408) Fixed: average images created by the groupwise registration tools did
843 not have proper coordinate space information. Also made the default output
844 image type NIFTI (instead of Analyze) to produce files with fully
845 specified coordinate systems.
846 (r2395) Fixed/Added: triplanar viewer now displays RAS physical coordinates of
847 current location; also fixed problem with repeated slice position change
848 after a single mouse click.
849 (r2390) Changed: by default, the DICOM image stacker, "dcm2image," now writes
850 NIFTI files with attached header (.nii) rather than Analyze hdr/img
851 pairs. This is because Analyze format does not properly represent the
852 image location and orientation information obtained from the DICOM input
853 images.
854 (r2380) Removed: several hundred lines of unused, obsolete code was removed
855 from the Numerics library.
856
857
858 Release CMTK-1.4.3 (2010-09-28):
859
860 (r2365) Fixed: "xform2dfield" and "xform2scalar" tools did not respect
861 CMTK_NUM_THREADS variable, as they were only using OpenMP directly.
862 (r2359) Added: by default, CMTK is now built with support for on-the-fly
863 decompression of bzip2 and lzma-compressed files if libbzip2 and/or
864 liblzmadec and their respective header files are installed on the build
865 system. Also rewrote the decompression class, cmtk::CompressedStream, from
866 scratch to be more easily extended.
867 (r2345) Fixed: prevent "dcm2image" tool from trying to read compressed (using
868 gzip, etc.) DICOM files, as these cannot be read by DCMTK right now.
869 (r2337) Added: "describe" tool now prints machine-readable image-to-physical
870 space transformation matrix. Also transposed matrix output to make it
871 compatible with "mat2dof" tool.
872 (r2329) Improved: poor description of command line arguments in "split" tool.
873 (r2327) Fixed: broken Makefiles when source path contained space.
874 (r2317) Refactored: eliminated several hundred lines of unused and obsolete
875 code, including several classes.
876 (r2309) Fixed: because gcc/OpenMP breaks POSIX semaphores on Cygwin, use
877 CMTK's mutex/condition implementation instead (Issue #4779)
878 (r2294) Improved: eliminating calls to floor() improved registration times by
879 another ~10%.
880 (r2287) Improved: apparently using histogram entropy is computed faster
881 without OpenMP parallelization, reducing test times for the "warp" tool by
882 about 30%. This should be noticable in production use also. No surprise,
883 actually, because most entropy evaluations are done in parallel on a
884 higher level anyway.
885 (r2281) Fixed: "reformatx" tool did not properly initiatialize thread system,
886 therefore running too many OpenMP threads even when CMTK_NUM_THREADS was
887 set.
888
889
890 Release CMTK-1.4.2 (2010-08-23):
891
892 (r2268) Fixed: various compile errors when compiling Qt support classes using
893 Sun/Oracle compiler.
894 (r2261) Refactored: new "XformListIO" class provides a static member function
895 that assembles lists of transformations with optional inversions from
896 string vectors as supplied by the command line parse. This new class is
897 used to unify three instances where this was previously done by code
898 duplication.
899 (r2254) Added: new, lightweight "fview" fusion viewer replaces old, broken,
900 and incomplete "fusion" application.
901 (r2213) Bugfix: UniformVolume::GridMatches sometimes returned "false" due to
902 differences below the numerical relevance threshold.
903 (r2202) Added: "--force-outside-value" command line argument now also offered
904 and implemented for affine registration.
905 (r2197) Improved: UniformVolumeInterpoaltor classes now convert input data to
906 Types::DataItem and cache the converted array for faster computation. This
907 particularly speeds up higher-order interpolation with cubic or sinc
908 kernels.
909
910
911 Release CMTK-1.4.1 (2010-08-09):
912
913 (r2178) Improved: when run as Slicer plugins, GPU-accelerated command line
914 tools now categorize themselves into "->GPU" submenus.
915 (r2176) Refactored: command line arguments now passed to CommandLine::Parse,
916 rather than constructor.
917 (r2171) Fixed: "new" registration classes (exposed in "registrationx" and
918 "warpx" tools) now respect reference image padding. Also fixed bug that
919 led to loss of padding information during resampling.
920 (r2166) Added: "registrationx" tool now supports special number of degrees of
921 freedom, "603", which produces a rigid transformation plus shears, but without
922 scaling (i.e., it uses 6+0+3 parameters of the affine transformation)
923 (r2160) Added: on-the-fly median filtering for "registrationx" and "warpx"
924 tools.
925 (r2156) Added: root mean squares image similarity measure for "registrationx"
926 and "warpx" tools. This is of course very similar to mean squares (MSD),
927 but exhibits different sensitivity to outliers.
928 (r2138) Added: GPU-accelerated levelset tool for CUDA, "levelset_cuda."
929 (r2111) Refactored: simple two-phase levelset evolution moved from "levelset"
930 tool into a new Segmentation/ library class, cmtk::SimpleLevelset.
931 (r2107) Refactored: UniformVolume::Clone and CloneGrid now return smart
932 rather than dumb pointers.
933 (r2103) Added: GPU/cmtkCUDA.h defines macros to safely call CUDA API functions
934 and check their error codes.
935 (r2097) Added: a new class, cmtk::ImageSymmetryPlaneCommandLine, together with
936 a derived class template unifies the tools for CPU-based and GPU-based
937 symmetry plane computation.
938 (r2094) Added: GPU-supported symmetry plane computation tool, "symplx_cuda",
939 which is used analogously to CPU-based "symplx" tool.
940 (r2060) Added: cmtk::ParametricPlane class can now provide the 4x4 matrix of
941 the reflection transformation w.r.t. the plane.
942 (r2035) Refactored: all cmtk header files are now included via paths relative
943 to the library parent directory.
944 (r2019) Refactored: split new symmetry plane functional into base class and
945 metric-dependent class. Base class will be shared by GPU implementation.
946 (r2016) Added: new "symplx" tool that will extend, and ultimately replace, the
947 current "sympl" tool for symmetry plane computation.
948 (r2012) Fixed: concurrent memory access problems in GPU kernel to populate
949 histograms on device.
950 (r2006) Improved: imagemath tool now prints a warning when more than one image
951 is left on the operation stack. This often indicates a problem with the
952 specified image operations.
953 (r2003) Fixed: require compatible version of SQLite (>= 3.5.0), otherwise
954 build bundled library.
955 (r1999) Added: "--product" operation for imagemath tool.
956 (r1996) Fixed: mrbias_cuda tool and curt validation tool now properly
957 self-identify on the command line and via XML.
958
959
960 Release CMTK-1.4.0 (2010-07-12):
961
962 - Fixed: header files are now installed in library-specific subdirectories,
963 which is consistent with the source tree.
964 - Improved: bundled SQLite is now only built if no system-wide library is
965 found.
966 - Added: "imagemath" tool now supports applying single-image operations to the
967 entire stack.
968 - Improved: "imagemath" tool now uses deque, not stack, to implement image
969 stack. This way we can perform all-image operations more easily.
970 - Improved: log-Intensity histograms are now value scale invariant.
971 - Removed: building against VTK is no longer supported.
972 - Added: class for histogram population and entropy computation on GPU
973 device.
974 - Added: vtkxform tool can now read (and write) binary-coded VTK files.
975 - Added: first utility classes (memory allocation and resource management,
976 volume data transfer) for GPU computation using CUDA.
977 - Testing: added test name to function mapper cmtk::TestFunctionMap to
978 simplify writing of test drivers.
979 - API: some Numerics functions from AlgLib were moved into ::alglib namespace
980 to avoid clashes with functions also defined elsewhere (e.g., gamma, erf,
981 etc).
982 - Refactored: thread function within thread pool is now provided with thread
983 index directly, rather having to perform a lookup (Issue #4939).
984 - Added: cmtk::CommandLine class prints warning message if not all command
985 line arguments are actually used. This usually points to a usage error.
986 - Added: 'vtkxform' tool now accepts list of transformations, each of which
987 can be inverted.
988 - API: change interface of SplineWarpXform::getTransformedGridSequence() to
989 isolate "number of points" parameter and make it harder to use this
990 incorrectly.
991 - Refactored: use more smart pointers in more places. Standardize Clone() and
992 Create() member functions of different classes.
993 - Improved: parallelized computation of FFD smoothness constraint. This
994 greatly improves multicore scaling of nonrigid registration using this
995 constraint.
996 - Removed: "describe" tool no longer prints center of mass and first-order
997 moments. If we ever need this, we'll make a separate tool for this.
998 - Refactored: further consolidated Vector3D into FixedVector
999 - Documentation: marked VTKWrapper library as deprecated.
1000
1001
1002 Release CMTK-1.3.1 (2010-06-07):
1003
1004 - Added: "vtkxform" tool to apply transformation to point coordinates in VTK
1005 files (does not require VTK support to be enabled or VTK to be
1006 installed).
1007 - Fixed: tiny numerical differences between division and multiplication with
1008 the inverse caused failed range check assertion in SplineWarpXform (Issue
1009 #4894). This is now fixed by replacing the assertion with a value range
1010 truncation. It ain't pretty, but it works.
1011 - Configuration: added two CMake initial script files in config/ directory,
1012 which should support and standardize backward-compatible builds on
1013 MacOSX/Intel (Issue #4895; thanks to Greg Jefferis for suggesting these).
1014 - Added: several features previously implemented only in congeal_warp have
1015 been ported into groupwise_rmi_warp. Also added tests for the latter.
1016 - Refactored: completely reorganised the groupwise registration functional
1017 hierarchy - instead of redundant member functions in leaf classes, we are
1018 now using template specialization to inject the necessary transformation
1019 model-dependent code at the base of the hierarchy.
1020 - Fixed: previously undetected bug in AffineGroupwiseRegistrationRMI
1021 functional effectively led to inverse transformations to be computed.
1022 - API: renamed CongealingFunctionalBase to more appropriate
1023 GroupwiseRegistrationFunctionalXformTemplate and removed unused second
1024 template parameter (histogram bin type) from several classes.
1025 - Improved: CMTK can now determine whether to write compressed (gz) or
1026 uncompressed NIFTI images based on the given file name, e.g., image.nii.gz
1027 for compressed vs. image.nii for uncompressed. Note that for this to work
1028 as expected the "CMTK_WRITE_UNCOMPRESSED" environment vairbale must be
1029 set, because otherwise images will be written compressed by
1030 default. Also note that CMTK's behaviour with respect to writing
1031 compressed vs. uncompressed files has not changed for all other file
1032 formats (Issue #4852).
1033 - Fixed: when using an unknown image file format suffix, CMTK would state that
1034 it would write a RAW3D file instead, but then write nothing. This now
1035 defaults to single-file NIFTI, which is actually written (Issue #4852).
1036 - Refactored: consolidated affine initialization of groupwise registration
1037 functionals to reduce code duplication and thus avoid residual unfixed
1038 bugs.
1039 - Improved: when initializing groupwise registrations, translations are now
1040 computed with a zero sum over all images. Previously, we aligned all
1041 centers with the template FOV center, but there is no reason why this
1042 would be a good idea when using, for example, centers of mass of the input
1043 images.
1044 - Added: groupwise registration tools now abort with an error when at least
1045 one of the input images get transformed too far outside the FOV. This is
1046 detected in cmtk::CongealingFunctionalBase and defaults to requiring at
1047 least 1% of reformatted pixels to be inside the FOV of every image. At
1048 present, this is not configurable at run time.
1049 - Removed: support for writing joint histograms.
1050 - Refactored: value ranges are now handled by Types::Range<T> class
1051 template. The specialization typedef'ed as Types::DataItemRange is now
1052 used for more intuitive handling of item ranges.
1053 - Fixed: selection of floating image interpolation method was implemented in
1054 warpx tool, but not exposed at the command line.
1055 - Fixed: auto-cropping by threshold was implemented in image pair registration
1056 preprocessor class, but not exposed through the command line interface.
1057 - Added: padding in convertx tool can now be turned on and off multiple times
1058 during the sequence of operations, including the use of different padding
1059 values at different times.
1060 - Added: connected components operator; also added this as a function to
1061 convertx tool.
1062 - Configuration/build: when system zlib is installed, we use it instead of the
1063 bundled zlib. This is necessary to avoid version issues when Qt support is
1064 activated, because Qt is linked against the system zlib.
1065 - Distribution: updated version of bundled zlib to 1.2.5, which fixes valgrind
1066 warnings among other things. In the process, fixed a configuration file
1067 bug by which the system zconf.h file, if present, was included rather than
1068 the one configured for CMTK.
1069 - Fixed: in some cases, TypedArray memory was allocated via malloc() but freed
1070 via delete[]. Now everything is consistently using cmtk::Memory (wraps
1071 new{} and delete[]) for allocation and deallocation.
1072 - Fixed: Correlation Ratio similarity measure was broken due to imcomplete
1073 copying of class fields in HistogramBase class. This was resolved
1074 "accidentally" when unifying and standardizing all copy constructors and
1075 assignment operators.
1076 - Refactored: non-standard copy member functions in various classes have been
1077 standardized as operator=() members. Assignment operators and copy
1078 constructors that performed only member-wise copies were deleted
1079 altogether.
1080 - API: renamed "InfinitePlane" class to "ParametricPlane" which is more
1081 descriptive and precise.
1082 - Added: CMake configuration of CUDA and OpenCL support for future GPU
1083 computations. Currently unused and experimental.
1084 - Refactored: UniformDistanceMap is now a factory class and no longer directly
1085 inherits from UniformVolume.
1086 - API: renamed "GetDownsampled" member in DataGrid and UniformVolume classes
1087 to "GetDownsampledAndAveraged" to clarify that this is a
1088 downsampling-and-averaging operation, not just a downsampling.
1089 - Refactored: greatly improved handling of grid index and region types.
1090 - Added: SmartConstPointer, based on concepts in Meyer's "More Effective C++"
1091 book.
1092 - Removed: unused classes from the deprecated "Pipeline" library
1093 - Documentation: describe library groups in doxygen documentation
1094 - Libraries: all reconstruction-related classes were consolidated in a new
1095 component library, "cmtkRecon"
1096 - Removed: unused cmtk::DirectionSetOptimizer class.
1097 - Removed: unused member functions of cmtk::Vector that complicate the API and
1098 stand in the way of eventually replacing this class with std::valarray.
1099 - Refactored: where appropriate, catch exceptions by constant references,
1100 rather than by value or by non-constant reference.
1101
1102
1103 Release CMTK-1.3.0 (2010-04-19):
1104
1105 - Added: a new command line tool, "dbtool", to modify, query, and maintain
1106 databases of images and of transformations between them.
1107 - Fixed: consolidated redundant "--switch" and "--exchange" parameters to
1108 "warp" tool (Issue #3616). Also fixed initial transformation missing
1109 inversion bug (unreported) for inverse-consistent nonrigid registration.
1110 - Fixed: if this is supported, default to terminal width for line width in
1111 cmtk::Console::FormatText
1112 - Added: image/transformation database support for the following registration
1113 tools: "registration", "registrationx", "warp", "reformatx"
1114 - API: cmtk::MetaInformationObject is getting a more explicit and
1115 task-appropriate interface.
1116 - API: refactored multi-channel registration class hierarchy to factor common
1117 code out of template class and into new non-template base class
1118 cmtk::MultiChannelRegistrationFunctionalBase
1119 - Added: mat2dof tool can now read from file in addition to reading from
1120 std::cin via redirection.
1121 - API: introduced "cmtk::Units" namespace with classes that handle conversions
1122 between units, e.g., between degrees and radians. Also added unit-safe
1123 trigonometric functions to MathUtil class.
1124 - Refactored: numerous code improvements based on suggestions from the third
1125 edition of Meyers, S., "Effective C++"
1126 - Removed: obsolete real-valued mod operators in MathUtil namespace.
1127 - Removed: long unused support for GIPL image file format import
1128 - Fix: volume_reconstruction and volume_injection tools now convert affine ITK
1129 transformations (i.e., such read from .tfm files) from native into
1130 standard space (Issue #4761).
1131 - API: made all meta key strings C++ objects rather than cpp #defines; also
1132 removed CMTK_ prefix after moving them into cmtk namespace.
1133 - API: renamed "InformationObject" class to more descriptive
1134 "MetaInformationObject"
1135 - Fixed: various issues pointed out by "cppcheck" static code analysis.
1136 - API: moved morphological operators from cmtk::DataGrid into separate class,
1137 cmtk::DataGridMorphologicalOperators.
1138 - API: prevent copying of system classes where this would lead to problems.
1139 - Added: filter, levelset, make_initial_affine, mrbias, and reformatx tools
1140 now support database updating.
1141 - Added: database backend for storing images and transformations between their
1142 coordinate spaces.
1143 - Added: "convertx --binarize-thresh" operation
1144 - Bugfix: shared-library build configuration was broken.
1145 - Bugfix: "convertx --mask-inverse" was broken.
1146 - Added: "mk_phantom_3d" tool can now import either an image including
1147 existing pixel data or just the grid geometry.
1148 - Added: "mk_phantom_3d" tool now supports three different coordinate modes:
1149 absolute, relative, indexed.
1150 - Added: "--revert" image operation for "imagemath" tool to revert binary
1151 masks.
1152 - API: moved "DrawXXX" members from "DataGrid" class into a new, dedicated
1153 painter class, "UniformVolumePainter."
1154 - Added: image operation for medial skeleton based on analysis of the Hessian
1155 eigensystem. Note that this is currently broken and only kept for future
1156 investigation.
1157 - Added: two differential operator members for "UniformVolume" class, one for
1158 gradient and one for Hessian matrix, each implemented using central
1159 differences.
1160 - Added: symmetric eigensystem can now be sorted either by absolute or by
1161 actual eigenvalues.
1162 - Bugfix: UniformDistanceMap constructor failed to copy orientation and
1163 space-related information from input UniformVolume object
1164 - Added: Euclidean distance map computation in "convertx" tool.
1165 - Added: "warpx" and "congeal_warp" can now do repeated histogram-based
1166 intensity matching of floating to reference image, with a transfer
1167 function that changes as warping progresses and thus takes into account
1168 shifting volume proportions.
1169 - Added: "convertx" now does histogram equalization. Also added tests.
1170 - Refactored: created a new class for histogram-based intensity matching,
1171 cmtk::HistogramMatchingLookup.
1172 - Added: first library-level tests for TypedArray class.
1173
1174
1175 Release CMTK-1.2.2 (2010-02-25):
1176
1177 - Added: cmtk::SQLite wrapper class for sqlite3 library, with tests.
1178 - Added: bundled still-unused sqlite3 "library" for future use in
1179 image/relationship database.
1180 - Added: "imagemath" now has "min-value" and "fill" operations.
1181 - Improved: "imagemath" can now set, unset, and change padding value
1182 repeatedly, so different images can be read with different padding values
1183 (Issue #4597)
1184 - Improved: better separation of code for DICOM vs non-DICOM configuration.
1185 - Improved: code for PGM output (8 and 16 bit) now more consistent and less
1186 complex. Also unified API for 8bit and 16bit write functions.
1187 - Added: bitwise "and" operation in "imagemath" tool. Added test for this.
1188 - Testing: added tests for cmtk::TypedArraySimilarity class.
1189 - Fixed: TypedArraySimilarity::GetPeakSignalToNoiseRatio was broken due to
1190 negated GetMeanSquaredDifference return value.
1191 - Testing: added tests for cmtk::ScalarImageSimilarity class (and, by
1192 extension, cmtk::TypedArraySimilarity as well).
1193 - Removed: obsolete "ImageIO" class was removed; the only two remaining former
1194 derived classes, cmtk::PGM and cmtk::DICOM, will now be used directly, as
1195 they only have static member functions left.
1196 - Fixed: initialize memory for Analyze header with zeroes in "mk_analyze_hdr"
1197 tool.
1198 - Testing: added tests for "mk_analyze_hdr" tool.
1199 - Testing: added tests for "mat2dof" tool.
1200 - Fixed: "mip" tool did not compute projection images with proper pixel sizes
1201 based on the input volume.
1202 - Testing: added tests for "mip" tool.
1203 - Improved: "mip" tool now sets black and white points automatically if not
1204 provided by the user.
1205 - Testing: added test for "Rohlfing" single-image intensity-consistent
1206 filtering in "filter" tool.
1207 - Removed: further removal of obsolete PGM and DICOM I/O code.
1208
1209
1210 Release CMTK-1.2.1 (2010-02-01):
1211
1212 - Added: "statistics" tool now optionally outputs mask-based results for all
1213 up to a user-provided maximum label, even if not all labels in the range
1214 actually occur in the mask.
1215 - Added: "convertx" tool now does thresholding above and below threshold, to
1216 threshold and to padding.
1217 - Added: re-added missing "--fast" switch for warp and warpx tools.
1218 - Added: "imagemath" can now threshold above and below given values.
1219 - Added: "convertx" tool can now rescale image intensities to target range
1220 using "--scale-to-range" operation.
1221
1222 - Fixed: reading empty (i.e., zero pixels) images crashed the toolkit
1223 - Fixed: "reformatx" did not respect user-defined padding value when computing
1224 Jacobian maps (Issue #4564).
1225 - Fixed: label mode of "avg_adm" tool was broken.
1226 - Fixed: "avg_adm" now gives consistent results regardless of number of
1227 CPUs. Also fixed minor bug that would have broken this altogether if there
1228 were more CPUs than pixels in an image row.
1229 - Fixed: "avg_adm" tests crashed on MPI; bug also affected non-MPI build
1230 (Issue #4571).
1231 - Fixed: "statistics" now tests whether grid of mask volume matches that of
1232 statistics volume.
1233
1234 - Testing: run all warp and warpx tests in "fast" mode
1235 - Testing: added tests, inputs, and baselines for "avg_adm" tool.
1236
1237 - Removed: deformation strain tensor computation was untested and unused; thus
1238 removed.
1239 - Removed: partial read support for AVW file format removed
1240 - Removed: support for legacy typedstream studies removed; Nrrd should be able
1241 to replace this if needed.
1242 - Removed: obsolete IO code for DCM tags etc.
1243
1244
1245 Release CMTK-1.2.0 (2010-01-06):
1246
1247 - Added: cmtk::Console can now determine terminal line width on POSIX systems,
1248 and this is used by cmtk::CommandLine to format command line help output
1249 with the correct line breaking.
1250 - Added: new, experimental implementation of pairwise image registration,
1251 with more accurate metric computation and support for arbitrary floating
1252 image interpolation. These are accessible through the new "registrationx"
1253 command line tool.
1254 - Added: single-step mass-preserving reformatting in reformatx tool. Also
1255 added a new test to cover this.
1256 - Added: "convertx" tool, which will replace "convert" in the long term but is
1257 designed to apply all operations given on the command line in the exact
1258 order that they are specified and with arbitrary repetitions. This is in
1259 response to Issue #3784.
1260
1261 - Improved: more sophisticated install and packaging configuration; still not
1262 fully clear how that translates into separated packages for different
1263 components.
1264 - Improved: ported everything related to Qt to use the actual Qt4 classes, so
1265 we can finally get rid of legacy Qt3 support classes. This should reduce
1266 the number of actually unused dynamic libraries, which we previously had
1267 to link against.
1268 - Improved: numerous small improvements to triplanar viewer
1269 - Improved: dcm2image tool now numbers images only if there would otherwise be
1270 filename collisions. The printf()-type numbering has been replaced with
1271 two new output path substitutions, "%n" and "%N". Both expand to the empty
1272 string when a path is already unique without numbering. Otherwise, "%n"
1273 substitutes to an increasing number, and "%N" substitutes to the same
1274 number with a leading dash, "-". So using "./%n/image%N.nii" generates a
1275 single file ".//image.nii" if that is a unique path, or a sequence of
1276 images "./1/image-1.nii", "./2/image-2.nii" for up to ten colliding
1277 paths. For larger numbers of collisions, the number of digits is
1278 automatically increased as necessary.
1279 - Improved: command line callback error handling was ugly and tedious; now
1280 using exceptions to achieve the same effect.
1281
1282 - Changed: in API, all volume "origin" fields were renamed to "offset" to
1283 avoid confusion with "origin" of coordinate spaces.
1284
1285 - Fixed: bundled DICOM library finally works on all tested platforms and all
1286 tested compilers.
1287 - Fixed: compile error on latest Mac/Intel gcc due to undefined "ushort"
1288 type.
1289 - Fixed: triplanar can now be called again with no parameters to open empty
1290 viewer UI.
1291 - Fixed: set coordinate space meta information for user-defined target grid in
1292 "reformatx" tool.
1293 - Fixed: using Sun's compiler, there was a problem with the timely
1294 initialization of SmartPointer<...>::Null when such an object was used in
1295 the global scope. This led to crashing volume_injection and
1296 volume_reconstruction tools.
1297
1298 - Removed: support for AMD Core Math Library (ACML), which was rarely used and
1299 complicated code unnecessarily
1300 - Removed: push-forward function of reformatx has long been obsolete because
1301 we can invert any transformation and switch reference and floating image,
1302 to achieve the same effect.
1303 - Removed: "Binary" data class; this should really be treated as "Labels"
1304 anyway.
1305 - Removed: for now, we are dropping support for system-installed DCMTK
1306 libraries. The configuration of these was a complete hack anyway. For the
1307 time being, we will rely exclusively on the bundled, stripped-down version
1308 of the toolkit for DICOM support.
1309
1310 - Testing: support for baselines local to each build. If a baseline exists in
1311 testing/baseline/${TESTNAME}, then it will be used. Otherwise, the global
1312 baseline as configured by the CMTK_DATA_ROOT top-level CMake variable is
1313 used.
1314 - Testing: added tests for manual target grid definition in "reformatx" tool.
1315
1316
1317 Release CMTK-1.1.3 (2009-11-18):
1318
1319 - Added: new tool, xform2scalar, to extract scalar measures from deformation
1320 fields or transformations. This, in combination with "statistics" and
1321 "sequence" tools, obsoletes the old (and inappropriately named)
1322 "deformation_field" tool.
1323 - Added: scripts for multi-NEX motion correction and iterative shape averaging
1324 are now configured in build tree and installed in install tree. These (and
1325 future scripts) will also be included in installable packages.
1326 - Added: B-spline transformation can now be written in ITK file format, thus
1327 allowing direct import of "warp" transformations into 3D Slicer.
1328 - Added: new binary builds for Solaris on i386 and x86_64 using SunPro CC
1329 compiler.
1330
1331 - Removed: obsolete "deformation_field" tool.
1332
1333 - Fixed: average_images tool was broken.
1334 - Fixed: numerous unitialized variables and other things that tripped valgrind
1335 memory checker.
1336 - Fixed: some more missing tests were added to the configuration of the
1337 bundled D(4)CMTK library.
1338 - Fixed: cmake file to set up tests when no hash map implementation is found
1339 cannot set properties for mcwarp and mcaffine tests.
1340 - Fixed: numerous compile errors using Sun CC compiler
1341 - Fixed: incomplete Wiki markup of command line help due to incorrectly
1342 overloaded virtual member function
1343 - Fixed: re-worked CMake build system to eliminate redundant repeated
1344 libraries
1345 - Fixed: re-arranged "warp" command line parameters to avoid crashing Slicer,
1346 as it does not allow optional non-option parameters
1347 - Fixed: signal handler functions are now 'extern "C"' to avoid potential
1348 problems of conflicting linkage
1349 - Fixed: margins for line breaking not correct in Console::FormatText
1350
1351 - Improved: better, more data-drive automatic initialization of optimizer step
1352 sizes and image sampling parameters in pairwise rigid and nonrigid
1353 registration.
1354 - Improved: more explicit handling of effective reference and floating volume
1355 in pairwise registration classes.
1356
1357 - Testing: added tests and baselines for average_images tool.
1358
1359
1360 Release CMTK-1.1.2 (2009-10-28):
1361
1362 - Added: new multi-threading framework based on pools of continuously running
1363 threads. This should reduce thread creation overhead and also improve
1364 scheduling by allowing load balancing using over-partitioned tasks, i.e.,
1365 tasks split into substantially more parts than the number of CPUs.
1366 - Added: logit and logistic functions for imagemath tool, for single and
1367 multiple images.
1368 - Added: imagemath tool "--match-histograms" operation matches the intensity
1369 distribution of one image to that of another.
1370 - Added: imagemath tool now supports image data padding.
1371
1372 - Fixed: basic reformatting in groupwise registration used slightly broken
1373 partitioning for SMP computation. This has been fixed.
1374 - Fixed: NIFTI reader was not able to read files with detached 348-byte
1375 headers, i.e., headers without "extension" field.
1376 - Fixed: BioRad header problem resulting from struct field alignment (patch by
1377 Greg Jefferis).
1378 - Fixed: TemplateArray::GetRangeTemplate() now ignores non-finite values, which
1379 also fixes a crash in triplanar viewer when reading images with non-finite
1380 values.
1381
1382 - Improved: switched long and short options in command line help and wiki
1383 markup outputs.
1384
1385
1386 Release CMTK-1.1.1 (2009-09-02):
1387
1388 - Added: "congeal" and "congeal_warp" now optionally match image histograms to
1389 either template data (if template data is used for registration) or first
1390 image (if no template is defined or its data is not used).
1391 - Added: groupwise, pairwise, and multi-channel registration tools now each
1392 support "--delta-f-threshold" option to define termination threshold for
1393 optimization based on relative target function change.
1394
1395 - Fixed: configuration of type sizes in bundled DICOM library was broken.
1396 - Fixed: file system functions were borken on Windows (MS-VS build) due to use
1397 of Unix-style directory separators ('/' vs. '\').
1398
1399 - Improved: command line options for "congeal" and "congeal_warp" tools
1400 streamlined and grouped.
1401 - Improved: help and wiki outputs of command line tool option descriptions now
1402 include textual descriptions of the argument expected by each option,
1403 e.g., "float", "string", "image-path".
1404
1405 - Removed: "Mutual Information" variant of RMI-based groupwise registration
1406 deleted; this turned out to be almost zero and thus useless. For now,
1407 we're left with optimizing the approximated joint entropy.
1408
1409 - Testing: added tests for all registrations using DeltaF threshold.
1410
1411
1412 Release CMTK-1.1.0 (2009-08-26):
1413
1414 - API: no longer allow short-only options for command lines.
1415 - API: cmtk::SmartPointer now supports smart pointers to constant objects for
1416 improved const-consistency.
1417 - API: begin decoupling the actual transformation classes (e.g.,
1418 SplineWarpXform) from their reference image grids (used for
1419 precomputations). Instead, use classes like the new
1420 SplineWarpXformUniformVolume to tie both together, thus allowing more
1421 transformation objects to remain const in more situations (see, for
1422 example, modified implementation of ReformatVolume::WarpXform).
1423 - API: all "...NonVirtual" member functions replaced their virtual
1424 counterparts and became virtual themselves.
1425 - API: decoupled VTK and non-VTK landmark code so only one tool,
1426 align_landmarks, still needs to be linked against the VTKWrapper and VTK
1427 libraries.
1428 - API: re-worked progress reporting to support multiple-level nested tasks
1429 - API: removed some residual legacy preprocessor definitions
1430
1431 - Changed: command line tools now need to "opt-in" for XML support. This is to
1432 prevent cluttering Slicer's menu with modules that do not actually support
1433 it.
1434 - Changed: finally eliminated all those affine transformation inversions in
1435 the rigid registration framework that have been a pain for over ten
1436 years. CAUTION! This changes the outcomes of both affine and warp
1437 registrations, usually just slightly, but in unstable cases potentially by
1438 a lot.
1439
1440 - Fixed: mk_analyze_hdr command line option "--description" was broken.
1441 - Fixed: contrary to the Wiki, NMI was the default registration criterion used
1442 in "film." This has now been changed to MSD, which is most approriate for
1443 within-modality registration.
1444 - Fixed: ReformatVolume::CheckerboardMode was not initialized
1445 - Fixed: ReformatVolume::CreateInterpoaltor did not support partial volume
1446 interpolation.
1447 - Fixed: ReformatVolume::MakeTargetImage did not create a grid with proper
1448 geometry (i.e., offset, direction matrix, meta data).
1449 - Fixed: conversion of non-axial Analyze images to Nrrd produced output file
1450 that was missing coordinate space definition.
1451 - Fixed: a critical bug that effectively broke all multi-threaded computations
1452 on Windows (using MS compilers).
1453
1454 - Added: all tools now support "--echo" command line switch, which dumps the
1455 command line to stdout before continuing with the program.
1456 - Added: the "levelset" and "film" tools now fully support the Slicer3
1457 execution model. Support in "mrbias" tool has also been improved.
1458 - Added: new "asegment" tool for atlas-based segmentation
1459 - Added: command line class now automatically generates command line syntax
1460 description for "--help" output, unless a syntax description string is
1461 explicitly set.
1462 - Added: cmtk::CommandLine class now permits arbitrary-typed variables to be
1463 set by command line enum parameter groups.
1464 - Added: new optional "asegment_sri24" tool for atlas-based segmentation using
1465 the SRI24 atlas (currently available only separately from
1466 http://nitrc.org/projects/sri24/).
1467 - Added: "warp" and "registration" tools now support writing of the
1468 reformatted floating image without requiring a separate tool, such as
1469 refortmatx. This makes integration into Slicer much more convenient.
1470 - Added: support Slicer3's XML-based progress reporting, and auto-detect
1471 Slicer's presence to switch between standard console progress output and
1472 XML-based output.
1473 - Added: automatic Wiki markup printing of command line options
1474 - Added: export and import of affine transformations in ITK file format for
1475 exchange with Slicer.
1476 - Added: new class, cmtk::TransformationToNativeSpacesAffine, to change an
1477 affine transformation under changes of reference and floating image
1478 coordinate spaces.
1479 - Added: intensity adjustment of floating image in affine and B-spline
1480 registration using histogram matching
1481
1482 - Removed: multiple redundant command line parameters of the "warp" tool have
1483 been retired. We are only retaining options that differ from the default
1484 values.
1485
1486
1487 Release CMTK-1.0.2 (2009-07-24):
1488
1489 - API: all igsGetSetXXX macros are now cmtkGetSetXXX, and they all define the
1490 field name with a "m_" prefix to avoid type/field name collisions.
1491 - API: more elegant design of noise estimator classes that work on TypedArray
1492 objects. Mike's experimental ML noise estimator implementations moved to
1493 "Unstable" library.
1494 - API: new wrapper class "cmtk::HashMapSTL" hides the various STL hash map
1495 implementations and also adds support for upcoming standard unordered_map
1496 class.
1497
1498 - Added: source tree now incorporates minimal subset of DCMTK files so we can
1499 build DICOM support without external dependencies, even on Windows using
1500 VisualStudio.
1501 - Added: "mcaffine" tool now accepts user-provided initial transformation from
1502 file [Tracker #3925].
1503 - Added: cmtk::CommandLine class now automatically prints parameter defaults
1504 in "--help" output.
1505
1506 - Fixed: numerous uninitialized data situations identified by valgrind memory
1507 checker
1508 - Fixed: incomplete computation when using "--sampling-density" option of
1509 "congeal" tool.
1510 - Fixed: Slicer can now detect CMTK tools as plugins via their response to
1511 "--xml"; note that the XML description itself is not fully correct and
1512 functional yet.
1513 - Fixed: testing and configuration were out of order in top-level
1514 CMakeLists.txt, resulting in build problems.
1515 - Fixed: "film" tool now uses anisotropic Gaussian kernel for volume
1516 injection [Tracker #3945].
1517 - Fixed: volume injection should use reconstructed image pixel size to scale
1518 Gaussian kernel, not pass image pixel size. Pass image size depends on
1519 number of passes, whereas point spread function does not.
1520
1521 - Improved: eliminated explicit offset calculations in cmtk::DataGrid and use
1522 existing index-to-offset function instead.
1523 - Improved: instead of trying to figure out what STL version provides, or does
1524 not provide, a 64bit integer hash function specialization, we simply provide a
1525 generic hash function ourselves, which works on all platforms.
1526
1527 - Testing: added an experimental build with valgrind/memcheck memory checking
1528 to discover further issues with uninitialized data etc.
1529 - Testing: support for automated memory testing using valgrind etc.
1530 - Testing: added test for multi-channel affine registration using histograms
1531 - Testing: added actual multi-channel registration test, and test for mcwarp
1532 - Testing: added test for importing deflate-compress DICOM images
1533
1534
1535 Release CMTK-1.0.1 (2009-06-25):
1536
1537 - API: changed XformList::Apply to XformList::ApplyInPlace
1538
1539 - Build: added missing applications "regress" and "probe_xform" to default
1540 build again.
1541
1542 - Changed: probe_xform tool now uses different command line semantics. All
1543 transformations are concatenated rather than applied separately.
1544
1545 - Added: normal vector of InfinitePlane can now be set directly.
1546 - Added: "sympl" tool can now use different approximated symmetry plane
1547 orientations to begin search, supporting non-sagittal symmetry planes
1548 [Tracker #3834].
1549 - Added: established infrastructure for optional algorithm validation,
1550 beginning with rigid registration. All validation tools must be activated
1551 via the "BUILD_VALIDATION" option of the top-level CMakeLists.txt file
1552 - Added: tools for rigid registration validation using data from the
1553 Retrospective Image Registration Evaluation project.
1554 - Added: "registration" tool now supports on-the-fly Sobel edge filtering, and
1555 histogram equalization was unified with "warp" tool's.
1556
1557 - Fixed: cmtkVoxelMatchingAffineFunctional.h compile error when SMP is turned
1558 off.
1559 - Fixed: crash of average_affine tool when run with no parameters
1560 [Tracker #3841]
1561
1562 - Improved: AffineRegistration and ElasticRegistration now use a new, unified
1563 image preprocessing class for things like cropping, histogram
1564 equalization, etc.
1565
1566 - Removed: obsolete cmtk::Array class; replace all uses with std::vector
1567
1568
1569 Release CMTK-1.0.0 (2009-06-16):
1570
1571 - API: "TemplateHistogram", "LogTemplateHistogram", and "TemplateHistogram2D"
1572 renamed to remove "Template" part. Also removed all global histogram
1573 typedefs (e.g., "UnsignedIntHistogram") to be more flexible with
1574 conditional instantiations
1575 - API: "Histogram2D" renamed to "JointHistogram".
1576 - API: all "VM_" class prefixes replaced with more explicit "VoxelMatching"
1577
1578 - Documentation: added extensive documentation with code examples for several
1579 key classes.
1580
1581 - SVN: moved test data out of "core" tree and into "data"; allow configuration
1582 of separate (shared) data tree from top-level CMake file
1583
1584 - Added: MiniXML library included in source tree for all upcoming XML needs.
1585 - Added: initial support for XML command line parameter descriptions. Mostly
1586 infrastructure work to make sure XML can be generated by CommandLine
1587 class with minimal extra programmer involvement
1588 - Added: cmtk::Console can now typeset text with given margin and width.
1589 - Added: Windows implementation of mutex lock.
1590 - Added: cmtk::StdOut stream
1591 - Added: "--auto-multi-levels" option for registration tool. Selects automatic
1592 resolution and optimization parameters for given number of levels.
1593 - Added: new top-level configuration option to switch all numerical algorithms
1594 (i.e., AlgLib) to single-precision floats. This can be used to save memory
1595 in extreme situations (for example, high-resolution volume reconstruction)
1596 - Added: two new operations for imagemath tool: xor-scalar and contract-labels
1597 - Added: Windows implementation of dcm2image file scanning
1598
1599 - Changed: CMake switches for changing coordinate and data real type are now
1600 advanced.
1601
1602 - Fixed: numerical instability of correlation coefficient (leading to values
1603 outside -1..+1, which in turn produced invalid p-values
1604 - Fixed: legacy IGS_MOUNTPOINTS was not considered
1605 - Fixed: principal axes registration was broken [Tracker #3743]
1606 - Fixed: configure problem with bundled zlib, which broke compile of NrrdIO in
1607 Visual Studio.
1608 - Fixed: Analyze/Nifti images were not written compressed
1609 - Fixed: numerous compiler errors and warnings detected by GCC 4.4
1610
1611 - Improved: simplified code by removing HAVE_ZLIB conditionals. These are now
1612 always true since we're bundling zlib.
1613 - Improved: use double instead of float for linear model and regression
1614 - Improved: use CMake's FindOpenMP to detect and configure OpenMP
1615 - Improved: prevent configurations where CMTK_USE_PTHREADS is ON but
1616 CMTK_BUILD_SMP is OFF.
1617 - Improved: better integration of Doxygen into CMake build system
1618 - Improved: better output of stacked image information in dcm2image
1619 - Improved: pre-defined "--xml" and "--help" command line options can now be
1620 overridden by library user [Tracker #3830].
1621
1622 - Removed: cmtk::MathUtil::CoefficientOfCorrelation was removed because it
1623 turned out to be a redundant, numerically unstable variant of
1624 MathUtil::Correlation
1625 - Removed: deprecated options -m/--metric removed from registration and warp
1626 tools.
1627 - Removed: obsolete tool skeleton "detect_interleave"
1628 - Removed: obsolete "--threads" option from all remaining command lines; using
1629 CMTK_NUM_THREADS environment variable is more flexible and versatile.