ITK
6.0.0
Insight Toolkit
|
#include <itkDiffusionTensor3DReconstructionImageFilter.h>
This class takes as input one or more reference image (acquired in the absence of diffusion sensitizing gradients) and 'n' diffusion weighted images and their gradient directions and computes an image of tensors. (with DiffusionTensor3D as the pixel type). Once that is done, you can apply filters on this tensor image to compute FA, ADC, RGB weighted maps etc.
n
gradient images, you would use the class as * \li ftp://public.kitware.com/pub/namic/DTI/Data/dwi.nhdr * \li ftp://public.kitware.com/pub/namic/DTI/Data/dwi.img.gz ( gunzip this ) *
Definition at line 149 of file itkDiffusionTensor3DReconstructionImageFilter.h.
Static Public Member Functions | |
static Pointer | New () |
Static Public Member Functions inherited from itk::ImageToImageFilter< Image< TReferenceImagePixelType, 3 >, Image< DiffusionTensor3D< TTensorPixelType >, 3 > > | |
static double | GetGlobalDefaultCoordinateTolerance () |
static double | GetGlobalDefaultDirectionTolerance () |
static void | SetGlobalDefaultCoordinateTolerance (double) |
static void | SetGlobalDefaultDirectionTolerance (double) |
Static Public Member Functions inherited from itk::Object | |
static bool | GetGlobalWarningDisplay () |
static void | GlobalWarningDisplayOff () |
static void | GlobalWarningDisplayOn () |
static Pointer | New () |
static void | SetGlobalWarningDisplay (bool val) |
Static Public Member Functions inherited from itk::LightObject | |
static void | BreakOnError () |
static Pointer | New () |
Protected Types | |
using | GradientImageTypeEnumeration = DiffusionTensor3DReconstructionImageFilterEnums::GradientImageFormat |
Protected Types inherited from itk::ImageToImageFilter< Image< TReferenceImagePixelType, 3 >, Image< DiffusionTensor3D< TTensorPixelType >, 3 > > | |
using | InputToOutputRegionCopierType = ImageToImageFilterDetail::ImageRegionCopier< Self::OutputImageDimension, Self::InputImageDimension > |
using | OutputToInputRegionCopierType = ImageToImageFilterDetail::ImageRegionCopier< Self::InputImageDimension, Self::OutputImageDimension > |
Private Attributes | |
CoefficientMatrixType | m_BMatrix {} |
TTensorPixelType | m_BValue {} |
GradientDirectionContainerType::Pointer | m_GradientDirectionContainer {} |
GradientImageTypeEnumeration | m_GradientImageTypeEnumeration {} |
bool | m_MaskImagePresent {} |
unsigned int | m_NumberOfBaselineImages {} |
unsigned int | m_NumberOfGradientDirections {} |
TensorBasisMatrixType | m_TensorBasis {} |
ReferencePixelType | m_Threshold {} |
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::CoefficientMatrixType = vnl_matrix<double> |
Definition at line 199 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::ConstPointer = SmartPointer<const Self> |
Definition at line 155 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::GradientDirectionContainerType = VectorContainer<unsigned int, GradientDirectionType> |
Container to hold gradient directions of the 'n' DW measurements
Definition at line 205 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::GradientDirectionType = vnl_vector_fixed<double, 3> |
Holds each magnetic field gradient used to acquire one DWImage
Definition at line 202 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::GradientImagesType = VectorImage<GradientPixelType, 3> |
An alternative type alias defining one (of the many) gradient images. It will be assumed that the vectorImage has the same dimension as the Reference image and a vector length parameter of n
(number of gradient directions)
Definition at line 188 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::GradientImageType = Image<GradientPixelType, 3> |
Typedef defining one (of the many) gradient images.
Definition at line 182 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
protected |
Enables backwards compatibility for enum values
Definition at line 323 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::GradientPixelType = TGradientImagePixelType |
Definition at line 167 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::MaskImageType = TMaskImageType |
The type for the optional mask image
Definition at line 194 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::MaskSpatialObjectType = SpatialObject<3> |
The type for the optional SpatialObject for masking
Definition at line 191 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::OutputImageType = TensorImageType |
Definition at line 177 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::Pointer = SmartPointer<Self> |
Definition at line 154 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::ReferenceImageType = typename Superclass::InputImageType |
Reference image data, This image is acquired in the absence of a diffusion sensitizing field gradient
Definition at line 173 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::ReferencePixelType = TReferenceImagePixelType |
Definition at line 165 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::Self = DiffusionTensor3DReconstructionImageFilter |
Definition at line 153 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::Superclass = ImageToImageFilter<Image<TReferenceImagePixelType, 3>, Image<DiffusionTensor3D<TTensorPixelType>, 3> > |
Definition at line 157 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::TensorBasisMatrixType = vnl_matrix_fixed<double, 6, 6> |
Holds the tensor basis coefficients G_k
Definition at line 197 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::TensorImageType = Image<TensorPixelType, 3> |
Definition at line 175 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::TensorPixelType = DiffusionTensor3D<TTensorPixelType> |
Definition at line 169 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
protected |
|
overrideprotecteddefault |
void itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::AddGradientImage | ( | const GradientDirectionType & | , |
const GradientImageType * | gradientImage | ||
) |
Set method to add a gradient direction and its corresponding image.
|
overrideprotectedvirtual |
If an imaging filter needs to perform processing after the buffer has been allocated but before threads are spawned, the filter can can provide an implementation for BeforeThreadedGenerateData(). The execution flow in the default GenerateData() method will be: 1) Allocate the output buffer 2) Call BeforeThreadedGenerateData() 3) Spawn threads, calling ThreadedGenerateData() in each thread. 4) Call AfterThreadedGenerateData() Note that this flow of control is only available if a filter provides a ThreadedGenerateData() method and NOT a GenerateData() method.
Reimplemented from itk::ImageSource< Image< DiffusionTensor3D< TTensorPixelType >, 3 > >.
|
protected |
|
overrideprotectedvirtual |
If an imaging filter can be implemented as a multithreaded algorithm, the filter will provide an implementation of ThreadedGenerateData() or DynamicThreadedGenerateData(). This superclass will automatically split the output image into a number of pieces, spawn multiple threads, and call (Dynamic)ThreadedGenerateData() in each thread. Prior to spawning threads, the BeforeThreadedGenerateData() method is called. After all the threads have completed, the AfterThreadedGenerateData() method is called. If an image processing filter cannot support threading, that filter should provide an implementation of the GenerateData() method instead of providing an implementation of (Dynamic)ThreadedGenerateData(). If a filter provides a GenerateData() method as its implementation, then the filter is responsible for allocating the output data. If a filter provides a (Dynamic)ThreadedGenerateData() method as its implementation, then the output memory will allocated automatically by this superclass. The (Dynamic)ThreadedGenerateData() method should only produce the output specified by "outputThreadRegion" parameter. (Dynamic)ThreadedGenerateData() cannot write to any other portion of the output image (as this is responsibility of a different thread).
DynamicThreadedGenerateData() is the newer variant without threadId, and is the preferred signature, which is called by default. This variant can split the requested region into different number of pieces depending on current multi-processing load, which allows better load balancing. The non-dynamic (also known as classic) ThreadedGenerateData() signature has threadId, and number of pieces to be split into is known in advance. It is activated by calling this->DynamicMultiThreadingOff(); in derived class constructor. It should be used when the multi-threaded algorithm needs to pre-allocate some data structure with size dependent on the number of pieces (also known as chunks, work units, and sometimes also incorrectly as threads). Only PlatformMultiThreader guarantees that each piece will be processed in its own specific thread. Pool and TBB multi-threaders maintain a pool of threads (normally equal to number of processing cores) which they use to process the pieces. This normally results in a single thread being reused to process multiple work units.
Reimplemented from itk::ImageSource< Image< DiffusionTensor3D< TTensorPixelType >, 3 > >.
|
virtual |
The BValue \( (s/mm^2) \) value used in normalizing the tensors to physically meaningful units. See equation (24) of the first reference for a description of how this is applied to the tensor estimation. Equation (1) of the same reference describes the physical significance.
|
inlinevirtual |
Return the gradient direction. idx is 0 based
Definition at line 249 of file itkDiffusionTensor3DReconstructionImageFilter.h.
const GradientImageType* itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::GetGradientImage | ( | unsigned int | index | ) | const |
Set method to add a gradient direction and its corresponding image.
|
overridevirtual |
Reimplemented from itk::ProcessObject.
|
inlinevirtual |
Get reference image
Definition at line 242 of file itkDiffusionTensor3DReconstructionImageFilter.h.
References itk::ProcessObject::GetInput().
|
virtual |
Threshold on the reference image data. The output tensor will be a null tensor for pixels in the reference image that have a value less than this threshold.
|
static |
Method for creation through the object factory.
|
overrideprotectedvirtual |
Methods invoked by Print() to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.
Reimplemented from itk::ProcessObject.
|
virtual |
The BValue \( (s/mm^2) \) value used in normalizing the tensors to physically meaningful units. See equation (24) of the first reference for a description of how this is applied to the tensor estimation. Equation (1) of the same reference describes the physical significance.
void itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::SetGradientImage | ( | GradientDirectionContainerType * | , |
const GradientImagesType * | gradientImage | ||
) |
Another set method to add a gradient directions and its corresponding image. The image here is a VectorImage. The user is expected to pass the gradient directions in a container. The ith element of the container corresponds to the gradient direction of the ith component image the VectorImage. For the baseline image, a vector of all zeros should be set.
void itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::SetMaskImage | ( | MaskImageType * | maskImage | ) |
set an image mask
void itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::SetMaskSpatialObject | ( | MaskSpatialObjectType * | maskSpatialObject | ) |
set a spatial object mask
|
inline |
Set method to set the reference image.
Definition at line 225 of file itkDiffusionTensor3DReconstructionImageFilter.h.
References itk::DiffusionTensor3DReconstructionImageFilterEnums::GradientIsInASingleImage, itk::DiffusionTensor3DReconstructionImageFilterEnums::GradientIsInManyImages, and itk::ProcessObject::SetNthInput().
|
virtual |
Threshold on the reference image data. The output tensor will be a null tensor for pixels in the reference image that have a value less than this threshold.
|
overrideprotectedvirtual |
Verifies that the process object has been configured correctly, that all required inputs are set, and needed parameters are set appropriately. If not valid an exceptions will be thrown.
This method is called before UpdateOutputInformation() is propagated to the inputs.
The ProcessObject's implementation verifies that the m_NumberOfRequiredInputs are set and not null.
Reimplemented from itk::ProcessObject.
|
private |
Definition at line 338 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
LeBihan's b-value for normalizing tensors
Definition at line 353 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
container to hold gradient directions
Definition at line 341 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
Gradient image was specified in a single image or in multiple images
Definition at line 356 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
Mask Image Present
Definition at line 359 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
Number of baseline images
Definition at line 347 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
Number of gradient measurements
Definition at line 344 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
Definition at line 336 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
Threshold on the reference image data
Definition at line 350 of file itkDiffusionTensor3DReconstructionImageFilter.h.