#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 For additional details see [138] and [139].
* \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 143 of file itkDiffusionTensor3DReconstructionImageFilter.h.
Static Public Member Functions | |
static Pointer | New () |
![]() | |
static double | GetGlobalDefaultCoordinateTolerance () |
static double | GetGlobalDefaultCoordinateTolerance () |
static double | GetGlobalDefaultDirectionTolerance () |
static double | GetGlobalDefaultDirectionTolerance () |
static void | SetGlobalDefaultCoordinateTolerance (double) |
static void | SetGlobalDefaultCoordinateTolerance (double) |
static void | SetGlobalDefaultDirectionTolerance (double) |
static void | SetGlobalDefaultDirectionTolerance (double) |
![]() | |
static bool | GetGlobalWarningDisplay () |
static void | GlobalWarningDisplayOff () |
static void | GlobalWarningDisplayOn () |
static Pointer | New () |
static void | SetGlobalWarningDisplay (bool val) |
![]() | |
static void | BreakOnError () |
static Pointer | New () |
Protected Types | |
using | GradientImageTypeEnumeration = DiffusionTensor3DReconstructionImageFilterEnums::GradientImageFormat |
![]() | |
using | InputToOutputRegionCopierType |
using | OutputToInputRegionCopierType |
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 {} |
Additional Inherited Members | |
![]() | |
static constexpr unsigned int | InputImageDimension |
static constexpr unsigned int | OutputImageDimension |
![]() | |
static constexpr unsigned int | OutputImageDimension |
![]() | |
static const ImageRegionSplitterBase * | GetGlobalDefaultSplitter () |
static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION | ThreaderCallback (void *arg) |
![]() | |
template<typename TSourceObject> | |
static void | MakeRequiredOutputs (TSourceObject &sourceObject, const DataObjectPointerArraySizeType numberOfRequiredOutputs) |
static constexpr float | progressFixedToFloat (uint32_t fixed) |
static uint32_t | progressFloatToFixed (float f) |
![]() | |
bool | m_DynamicMultiThreading |
![]() | |
TimeStamp | m_OutputInformationMTime {} |
bool | m_Updating {} |
![]() | |
std::atomic< int > | m_ReferenceCount {} |
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::CoefficientMatrixType = vnl_matrix<double> |
Definition at line 193 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::ConstPointer = SmartPointer<const Self> |
Definition at line 149 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 199 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 196 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 182 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 176 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
protected |
Enables backwards compatibility for enum values
Definition at line 313 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::GradientPixelType = TGradientImagePixelType |
Definition at line 161 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::MaskImageType = TMaskImageType |
The type for the optional mask image
Definition at line 188 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 185 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::OutputImageType = TensorImageType |
Definition at line 171 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::Pointer = SmartPointer<Self> |
Definition at line 148 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 167 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::ReferencePixelType = TReferenceImagePixelType |
Definition at line 159 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::Self = DiffusionTensor3DReconstructionImageFilter |
Definition at line 147 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::Superclass |
Definition at line 150 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 191 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::TensorImageType = Image<TensorPixelType, 3> |
Definition at line 169 of file itkDiffusionTensor3DReconstructionImageFilter.h.
using itk::DiffusionTensor3DReconstructionImageFilter< TReferenceImagePixelType, TGradientImagePixelType, TTensorPixelType, TMaskImageType >::TensorPixelType = DiffusionTensor3D<TTensorPixelType> |
Definition at line 163 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
protected |
Referenced by GetNameOfClass().
|
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< double >, 3 > >.
|
protected |
|
virtual |
Create an object from an instance, potentially deferring to a factory. This method allows you to create an instance of an object that is exactly the same type as the referring object. This is useful in cases where an object has been cast back to a base class.
Reimplemented from itk::LightObject.
|
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< double >, 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 243 of file itkDiffusionTensor3DReconstructionImageFilter.h.
References m_GradientDirectionContainer, and m_NumberOfGradientDirections.
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::LightObject.
References DiffusionTensor3DReconstructionImageFilter().
|
inlinevirtual |
Get reference image
Definition at line 236 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::LightObject.
|
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 219 of file itkDiffusionTensor3DReconstructionImageFilter.h.
References itk::DiffusionTensor3DReconstructionImageFilterEnums::GradientIsInASingleImage, itk::DiffusionTensor3DReconstructionImageFilterEnums::GradientIsInManyImages, m_GradientImageTypeEnumeration, 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 328 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
LeBihan's b-value for normalizing tensors
Definition at line 343 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
container to hold gradient directions
Definition at line 331 of file itkDiffusionTensor3DReconstructionImageFilter.h.
Referenced by GetGradientDirection().
|
private |
Gradient image was specified in a single image or in multiple images
Definition at line 346 of file itkDiffusionTensor3DReconstructionImageFilter.h.
Referenced by SetReferenceImage().
|
private |
Mask Image Present
Definition at line 349 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
Number of baseline images
Definition at line 337 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
Number of gradient measurements
Definition at line 334 of file itkDiffusionTensor3DReconstructionImageFilter.h.
Referenced by GetGradientDirection().
|
private |
Definition at line 326 of file itkDiffusionTensor3DReconstructionImageFilter.h.
|
private |
Threshold on the reference image data
Definition at line 340 of file itkDiffusionTensor3DReconstructionImageFilter.h.