Proposals:Slice contiguous images

ITK uses a contiguous image memory model. All the pixels in an image/volume are in a single contiguous memory block. Many existing medical image analysis systems use a slice contiguous memory model. Here, all the pixels in a slice are in a contiguous memory block but the slices may not be contiguous in memory. A slice contiguous memory model has benefits over a volume contiguous memory model in memory management and cache coherency.

Design

Image virtual address space manged by the PixelContainer

The implementation could be done at the PixelContainer level. You can think of the PixelContainer as providing a 1D contiguous address space for an ND image. The pixel container could then manage the indexing into real memory.

Which dimensions of an image should be contiguous?

For ND images, we'll need to decide which dimensions are contiguous:

• (N-1)D are contiguous, last dimension sparse across the memory space
• 2D slices are contiguous, (N-2)D dimension sparse across the memory space

Specifying the PixelContainer

At one point in ITK's history, Images were templated over the type of PixelContainer. We could revert back to that design to allow other PixelContainers to be used. Alternatively, we could use inheritance/virtual functions, allowing the existing image to operate on a variety of PixelContainer classes.

Option: Let Iteratior be aware of the internal Image Organization

This option will provide a better shot for supporting high computation times. In this option, the iterators will be aware of the internal slice-by-slice memory organization of the image and will manage the final access to the pixel data in memory.

• WithIndex iterators should be easy to adapt to this framework and not API changes.
• PixelWise (not WithIndex) should also require minor modifications and not API changes.
• Neighborhod iterators will be the more challenging ones, but doesn't seem to bea technical reason why they couldn't be converted.

Impact

• Supporting slice contiguous images will require modification to the image iterators and anywhere Image::GetBufferPointer() is called.
• A simplistic implementation may result in a double derefernce of data which could impact performance.
• Using inheritance in the PixelContainer class will most likely result in a virtual function call to dereference a pixel which could impact performance.

Readers and Writers

For completness, this support will make more sense if it is accompanied of modifications in the Readers and Writers that will facilitate to bring isolated slices from images into memory and that will allow to write slice-by-slice into output files.

Image::GetBufferPointer() Usage in Insight Toolkit 3.6.0

Find all "GetBufferPointer", Subfolders, Find Results 1, "Insight Toolkit 3.6.0 Code", "*.c; *.cpp;; *.cxx; *.txx; *.h; *.cmake"
Code\Algorithms\itkFFTWComplexConjugateToRealImageFilter.txx(118):
Code\Algorithms\itkFFTWComplexConjugateToRealImageFilter.txx(122):
Code\Algorithms\itkFFTWRealToComplexConjugateImageFilter.txx(126):
Code\Algorithms\itkFFTWRealToComplexConjugateImageFilter.txx(129):
Code\Algorithms\itkMattesMutualInformationImageToImageMetric.txx(784):
Code\Algorithms\itkMattesMutualInformationImageToImageMetric.txx(907):
Code\Algorithms\itkMattesMutualInformationImageToImageMetric.txx(1061):
Code\Algorithms\itkMattesMutualInformationImageToImageMetric.txx(1223):
Code\Algorithms\itkMattesMutualInformationImageToImageMetric.txx(1254):
Code\Algorithms\itkMattesMutualInformationImageToImageMetric.txx(1524):
Code\Algorithms\itkRayCastInterpolateImageFunction.txx(1159):
Code\Algorithms\itkRayCastInterpolateImageFunction.txx(1163):
Code\Algorithms\itkRayCastInterpolateImageFunction.txx(1167):
Code\Algorithms\itkRayCastInterpolateImageFunction.txx(1171):
Code\Algorithms\itkRayCastInterpolateImageFunction.txx(1192):
Code\Algorithms\itkRayCastInterpolateImageFunction.txx(1196):
Code\Algorithms\itkRayCastInterpolateImageFunction.txx(1200):
Code\Algorithms\itkRayCastInterpolateImageFunction.txx(1204):
Code\Algorithms\itkRayCastInterpolateImageFunction.txx(1226):
Code\Algorithms\itkRayCastInterpolateImageFunction.txx(1230):
Code\Algorithms\itkRayCastInterpolateImageFunction.txx(1234):
Code\Algorithms\itkRayCastInterpolateImageFunction.txx(1238):
Code\Algorithms\itkSCSLComplexConjugateToRealImageFilter.txx(74):
Code\Algorithms\itkSCSLComplexConjugateToRealImageFilter.txx(83):
Code\Algorithms\itkSCSLComplexConjugateToRealImageFilter.txx(100):
Code\Algorithms\itkSCSLComplexConjugateToRealImageFilter.txx(112):
Code\Algorithms\itkSCSLComplexConjugateToRealImageFilter.txx(135):
Code\Algorithms\itkSCSLComplexConjugateToRealImageFilter.txx(150):
Code\Algorithms\itkSCSLComplexConjugateToRealImageFilter.txx(182):
Code\Algorithms\itkSCSLComplexConjugateToRealImageFilter.txx(199):
Code\Algorithms\itkSCSLComplexConjugateToRealImageFilter.txx(211):
Code\Algorithms\itkSCSLComplexConjugateToRealImageFilter.txx(234):
Code\Algorithms\itkSCSLComplexConjugateToRealImageFilter.txx(249):
Code\Algorithms\itkSCSLRealToComplexConjugateImageFilter.txx(74):
Code\Algorithms\itkSCSLRealToComplexConjugateImageFilter.txx(95):
Code\Algorithms\itkSCSLRealToComplexConjugateImageFilter.txx(109):
Code\Algorithms\itkSCSLRealToComplexConjugateImageFilter.txx(133):
Code\Algorithms\itkSCSLRealToComplexConjugateImageFilter.txx(148):
Code\Algorithms\itkSCSLRealToComplexConjugateImageFilter.txx(179):
Code\Algorithms\itkSCSLRealToComplexConjugateImageFilter.txx(193):
Code\Algorithms\itkSCSLRealToComplexConjugateImageFilter.txx(217):
Code\Algorithms\itkSCSLRealToComplexConjugateImageFilter.txx(232):
Code\Algorithms\itkVnlFFTComplexConjugateToRealImageFilter.txx(57):
Code\Algorithms\itkVnlFFTComplexConjugateToRealImageFilter.txx(69):
Code\Algorithms\itkVnlFFTRealToComplexConjugateImageFilter.txx(89):
Code\Algorithms\itkVnlFFTRealToComplexConjugateImageFilter.txx(92):
Code\Algorithms\itkWatershedSegmenter.txx(533):
Code\Algorithms\itkWatershedSegmenter.txx(582):
Code\BasicFilters\itkReflectiveImageRegionConstIterator.txx(84):
Code\BasicFilters\itkVTKImageExport.txx(374):
Code\BasicFilters\itkVTKImageExportBase.cxx(109):
Code\BasicFilters\itkVTKImageExportBase.h(99):
Code\Common\itkBloxImage.txx(58):
Code\Common\itkBSplineDeformableTransform.txx(741):
Code\Common\itkBSplineDeformableTransform.txx(917):
Code\Common\itkConstNeighborhoodIterator.h(120):
Code\Common\itkConstNeighborhoodIterator.txx(360):
Code\Common\itkConstNeighborhoodIterator.txx(362):
Code\Common\itkConstNeighborhoodIterator.txx(596):
Code\Common\itkImage.h(239):
Code\Common\itkImage.h(240):
Code\Common\itkImage.h(241):
Code\Common\itkImage.h(242):
Code\Common\itkImageAdaptor.h(232):
Code\Common\itkImageAdaptor.h(233):
Code\Common\itkImageAdaptor.txx(332):
Code\Common\itkImageAdaptor.txx(334):
Code\Common\itkImageAdaptor.txx(341):
Code\Common\itkImageAdaptor.txx(343):
Code\Common\itkImageConstIterator.h(173):
Code\Common\itkImageConstIteratorWithIndex.h(230):
Code\Common\itkImageConstIteratorWithIndex.txx(66):
Code\Common\itkImageConstIteratorWithIndex.txx(81):
Code\Common\itkImageConstIteratorWithIndex.txx(144):
Code\Common\itkImageConstIteratorWithIndex.txx(229):
Code\Common\itkImageContainerInterface.h(77):
Code\Common\itkImageDuplicator.txx(79):
Code\Common\itkImageRandomConstIteratorWithIndex.txx(110):
Code\Common\itkImageRandomNonRepeatingConstIteratorWithIndex.txx(133):
Code\Common\itkImageReverseConstIterator.h(177):
Code\Common\itkImageReverseConstIterator.h(210):
Code\Common\itkImageReverseConstIterator.h(256):
Code\Common\itkImportImageContainer.h(86):
Code\Common\itkOctree.txx(263):
Code\Common\itkSpecialCoordinatesImage.h(248):
Code\Common\itkSpecialCoordinatesImage.h(249):
Code\Common\itkSpecialCoordinatesImage.h(250):
Code\Common\itkSpecialCoordinatesImage.h(251):
Code\Common\itkValarrayImageContainer.h(100):
Code\Common\itkValarrayImageContainer.h(145):
Code\Common\itkValarrayImageContainer.h(147):
Code\Common\itkVectorImage.h(250):
Code\Common\itkVectorImage.h(251):
Code\Common\itkVectorImage.h(252):
Code\Common\itkVectorImage.h(253):
Code\Common\itkVectorImageNeighborhoodAccessorFunctor.h(70):
Code\Common\itkZeroFluxNeumannBoundaryCondition.txx(51):
Code\IO\itkImageFileReader.txx(343):
Code\IO\itkImageFileReader.txx(395):
Code\IO\itkImageFileWriter.txx(283):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(497):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(508):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(573):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(580):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(620):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(631):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(696):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(732):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(776):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(787):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(794):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(803):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(887):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(893):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(951):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(960):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(1047):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(1083):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(1118):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(1210):
Code\Review\itkOptMattesMutualInformationImageToImageMetric.txx(1216):
Matching lines: 121    Matching files: 38    Total files searched: 2359

---

ITK: [Welcome | Site Map]