Detailed Description

template<typename TInputImage>
class itk::MRASlabIdentifier< TInputImage >

identifies slab in MR images comparing minimum intensity averages

This class is templated over the type of image. In many cases, a 3D MR image is constructed by merging smaller 3D blocks (slabs) which were acquired with different settings such as magnetic settings and patient positions. Therefore, stripe like patterns with slabs can be present in the resulting image. Such artifacts are called "slab boundary" artifacts or "venetian blind" artifacts.

With the slab boundary artifacts in an image, even a same tissue class's intensity values might vary significantly along the borders of slabs. Such rough value changes are not appropriate for some image processing methods. For example, MRIBiasFieldCorrectionFilter assumes a smooth bias field. However, with the slab boundary artifacts, the bias field estimation scheme that MRIBiasFieldCorrectionFilter uses might not adopt well. So, the MRIBiasFieldCorrectionFilter creates regions for slabs using the MRASlabIdentifier and then apply its bias correction scheme to each slab.

For this identifier, a slice means 2D image data which is extracted from the input image along one of three axes (x, y, z). Users can specify the slicing axis using the SetSlicingDirection(int dimension) member. (0 - x, 1 - y, 2 - z).

The identification scheme used here is very simple. 1) Users should specify how many pixels per slice the identifier will sample. 2) For each slice, the identifier searches the specified number of pixels of which intensity values are greater than 0 and less than those of the other pixels in the slice 3) The identifier calculates the average for each slice and the overall average using the search results. 4) For each slice, it subtracts the overall average from the slice average. If the sign of the subtraction result changes, then it assumes that a slab ends and another slab begins.

Definition at line 65 of file itkMRASlabIdentifier.h.

Public Types
typedef SmartPointer< const Self >	ConstPointer

typedef TInputImage::ConstPointer	ImageConstPointer

typedef TInputImage::IndexType	ImageIndexType

typedef TInputImage::PixelType	ImagePixelType

typedef TInputImage::Pointer	ImagePointer

typedef TInputImage::RegionType	ImageRegionType

typedef TInputImage::SizeType	ImageSizeType

typedef TInputImage	ImageType

typedef SmartPointer< Self >	Pointer

typedef MRASlabIdentifier	Self

typedef std::vector < ImageRegionType >	SlabRegionVectorType

typedef Object	Superclass

Public Types inherited from itk::Object
typedef SmartPointer< const Self >	ConstPointer

typedef SmartPointer< Self >	Pointer

typedef Object	Self

typedef LightObject	Superclass

Public Types inherited from itk::LightObject
typedef SmartPointer< const Self >	ConstPointer

typedef SmartPointer< Self >	Pointer

typedef LightObject	Self

Public Member Functions
virtual ::itk::LightObject::Pointer	CreateAnother (void) const

void	GenerateSlabRegions (void)

virtual const char *	GetNameOfClass () const

SlabRegionVectorType	GetSlabRegionVector (void)


virtual void	SetImage (const ImageType *_arg)

virtual const ImageType *	GetImage () const


virtual void	SetNumberOfSamples (unsigned int _arg)

virtual const unsigned int &	GetNumberOfSamples () const


virtual void	SetBackgroundMinimumThreshold (ImagePixelType _arg)

virtual const ImagePixelType &	GetBackgroundMinimumThreshold () const


virtual void	SetTolerance (double _arg)

virtual const double &	GetTolerance () const


virtual void	SetSlicingDirection (int _arg)

virtual const int &	GetSlicingDirection () const

Public Member Functions inherited from itk::Object
unsigned long	AddObserver (const EventObject &event, Command *)

unsigned long	AddObserver (const EventObject &event, Command *) const

virtual void	DebugOff () const

virtual void	DebugOn () const

Command *	GetCommand (unsigned long tag)

bool	GetDebug () const

MetaDataDictionary &	GetMetaDataDictionary (void)

const MetaDataDictionary &	GetMetaDataDictionary (void) const

virtual ModifiedTimeType	GetMTime () const

virtual const TimeStamp &	GetTimeStamp () const

bool	HasObserver (const EventObject &event) const

void	InvokeEvent (const EventObject &)

void	InvokeEvent (const EventObject &) const

virtual void	Modified () const

virtual void	Register () const ITK_OVERRIDE

void	RemoveAllObservers ()

void	RemoveObserver (unsigned long tag)

void	SetDebug (bool debugFlag) const

void	SetMetaDataDictionary (const MetaDataDictionary &rhs)

virtual void	SetReferenceCount (int) ITK_OVERRIDE

virtual void	UnRegister () const ITK_OVERRIDE

virtual void	SetObjectName (std::string _arg)

virtual const std::string &	GetObjectName () const

Public Member Functions inherited from itk::LightObject
virtual void	Delete ()

virtual int	GetReferenceCount () const

	itkCloneMacro (Self)

void	Print (std::ostream &os, Indent indent=0) const

Static Public Member Functions
static Pointer	New ()

Static Public Member Functions inherited from itk::Object
static bool	GetGlobalWarningDisplay ()

static void	GlobalWarningDisplayOff ()

static void	GlobalWarningDisplayOn ()

static Pointer	New ()

static void	SetGlobalWarningDisplay (bool flag)

Static Public Member Functions inherited from itk::LightObject
static void	BreakOnError ()

static Pointer	New ()

Protected Member Functions
	MRASlabIdentifier ()

virtual void	PrintSelf (std::ostream &os, Indent indent) const ITK_OVERRIDE

virtual	~MRASlabIdentifier ()

Protected Member Functions inherited from itk::Object
	Object ()

bool	PrintObservers (std::ostream &os, Indent indent) const

virtual void	SetTimeStamp (const TimeStamp &time)

virtual	~Object ()

Protected Member Functions inherited from itk::LightObject
virtual LightObject::Pointer	InternalClone () const

	LightObject ()

virtual void	PrintHeader (std::ostream &os, Indent indent) const

virtual void	PrintTrailer (std::ostream &os, Indent indent) const

virtual	~LightObject ()

Private Member Functions
	MRASlabIdentifier (const Self &)

void	operator= (const Self &)

Private Attributes
ImagePixelType	m_BackgroundMinimumThreshold

ImageConstPointer	m_Image

unsigned int	m_NumberOfSamples

SlabRegionVectorType	m_Slabs

int	m_SlicingDirection

double	m_Tolerance

Additional Inherited Members
Protected Types inherited from itk::LightObject
typedef int	InternalReferenceCountType

Protected Attributes inherited from itk::LightObject
InternalReferenceCountType	m_ReferenceCount

SimpleFastMutexLock	m_ReferenceCountLock