This class computes texture feature coefficients from a grey level run-length matrix. More...

#include <itkHistogramToRunLengthFeaturesFilter.h>

Inheritance diagram for itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >:

Collaboration diagram for itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >:

Public Types
typedef SmartPointer< const Self >	ConstPointer
typedef DataObject::Pointer	DataObjectPointer
typedef HistogramType::TotalAbsoluteFrequencyType	FrequencyType
typedef HistogramType::ConstPointer	HistogramConstPointer
typedef HistogramType::Pointer	HistogramPointer
typedef THistogram	HistogramType
typedef HistogramType::IndexType	IndexType
typedef SimpleDataObjectDecorator < MeasurementType >	MeasurementObjectType
typedef HistogramType::MeasurementType	MeasurementType
typedef HistogramType::MeasurementVectorType	MeasurementVectorType
typedef SmartPointer< Self >	Pointer
enum	RunLengthFeatureName { ShortRunEmphasis, LongRunEmphasis, GreyLevelNonuniformity, RunLengthNonuniformity, LowGreyLevelRunEmphasis, HighGreyLevelRunEmphasis, ShortRunLowGreyLevelEmphasis, ShortRunHighGreyLevelEmphasis, LongRunLowGreyLevelEmphasis, LongRunHighGreyLevelEmphasis }
typedef HistogramToRunLengthFeaturesFilter	Self
typedef ProcessObject	Superclass
Public Member Functions
virtual ::itk::LightObject::Pointer	CreateAnother (void) const
MeasurementType	GetFeature (RunLengthFeatureName name)
virtual const char *	GetNameOfClass () const
virtual unsigned long	GetTotalNumberOfRuns ()

void	SetInput (const HistogramType *histogram)
const HistogramType *	GetInput () const

MeasurementType	GetShortRunEmphasis () const
const MeasurementObjectType *	GetShortRunEmphasisOutput () const

MeasurementType	GetLongRunEmphasis () const
const MeasurementObjectType *	GetLongRunEmphasisOutput () const

MeasurementType	GetGreyLevelNonuniformity () const
const MeasurementObjectType *	GetGreyLevelNonuniformityOutput () const

MeasurementType	GetRunLengthNonuniformity () const
const MeasurementObjectType *	GetRunLengthNonuniformityOutput () const

MeasurementType	GetLowGreyLevelRunEmphasis () const
const MeasurementObjectType *	GetLowGreyLevelRunEmphasisOutput () const

MeasurementType	GetHighGreyLevelRunEmphasis () const
const MeasurementObjectType *	GetHighGreyLevelRunEmphasisOutput () const

MeasurementType	GetShortRunLowGreyLevelEmphasis () const
const MeasurementObjectType *	GetShortRunLowGreyLevelEmphasisOutput () const

MeasurementType	GetShortRunHighGreyLevelEmphasis () const
const MeasurementObjectType *	GetShortRunHighGreyLevelEmphasisOutput () const

MeasurementType	GetLongRunLowGreyLevelEmphasis () const
const MeasurementObjectType *	GetLongRunLowGreyLevelEmphasisOutput () const

MeasurementType	GetLongRunHighGreyLevelEmphasis () const
const MeasurementObjectType *	GetLongRunHighGreyLevelEmphasisOutput () const
Static Public Member Functions
static Pointer	New ()
Protected Types
typedef ProcessObject::DataObjectPointerArraySizeType	DataObjectPointerArraySizeType
Protected Member Functions
void	GenerateData ()
	HistogramToRunLengthFeaturesFilter ()
virtual DataObjectPointer	MakeOutput (DataObjectPointerArraySizeType)
void	PrintSelf (std::ostream &os, Indent indent) const
	~HistogramToRunLengthFeaturesFilter ()
Private Member Functions
	HistogramToRunLengthFeaturesFilter (const Self &)
void	operator= (const Self &)
Private Attributes
unsigned long	m_TotalNumberOfRuns

Detailed Description

template<class THistogram>
class itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >

This class computes texture feature coefficients from a grey level run-length matrix.

By default, run length features are computed for each spatial direction and then averaged afterward, so it is possible to access the standard deviations of the texture features. These values give a clue as to texture anisotropy. However, doing this is much more work, because it involved computing one for each offset given. To compute a single matrix using the first offset, call FastCalculationsOn(). If this is called, then the texture standard deviations will not be computed (and will be set to zero), but texture computation will be much faster.

This class is templated over the input histogram type.

Print references: M. M. Galloway. Texture analysis using gray level run lengths. Computer Graphics and Image Processing, 4:172-179, 1975.

A. Chu, C. M. Sehgal, and J. F. Greenleaf. Use of gray value distribution of run lengths for texture analysis. Pattern Recognition Letters, 11:415-420, 1990.

B. R. Dasarathy and E. B. Holder. Image characterizations based on joint gray-level run-length distributions. Pattern Recognition Letters, 12:490-502, 1991.

IJ article: http://hdl.handle.net/1926/1374

See also:: ScalarImageToRunLengthFeaturesFilter; ScalarImageToRunLengthMatrixFilter; HistogramToRunLengthFeaturesFilter

Author:: : Nick Tustison

Definition at line 66 of file itkHistogramToRunLengthFeaturesFilter.h.

Member Typedef Documentation

template<class THistogram >

typedef SmartPointer<const Self> itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::ConstPointer

Reimplemented from itk::ProcessObject.

Definition at line 73 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef DataObject::Pointer itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::DataObjectPointer

Smart Pointer type to a DataObject.

Reimplemented from itk::ProcessObject.

Definition at line 97 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef ProcessObject::DataObjectPointerArraySizeType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::DataObjectPointerArraySizeType [protected]

Make a DataObject to be used for output output.

Reimplemented from itk::ProcessObject.

Definition at line 178 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef HistogramType:: TotalAbsoluteFrequencyType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::FrequencyType

Definition at line 88 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef HistogramType::ConstPointer itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::HistogramConstPointer

Definition at line 83 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef HistogramType::Pointer itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::HistogramPointer

Definition at line 82 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef THistogram itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::HistogramType

Definition at line 79 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef HistogramType::IndexType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::IndexType

Definition at line 86 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef SimpleDataObjectDecorator<MeasurementType> itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::MeasurementObjectType

Type of DataObjects used for scalar outputs

Definition at line 100 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef HistogramType::MeasurementType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::MeasurementType

Definition at line 84 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef HistogramType::MeasurementVectorType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::MeasurementVectorType

Definition at line 85 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef SmartPointer<Self> itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::Pointer

Reimplemented from itk::ProcessObject.

Definition at line 72 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef HistogramToRunLengthFeaturesFilter itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::Self

Standard typedefs

Reimplemented from itk::ProcessObject.

Definition at line 70 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

typedef ProcessObject itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::Superclass

Reimplemented from itk::ProcessObject.

Definition at line 71 of file itkHistogramToRunLengthFeaturesFilter.h.

Member Enumeration Documentation

template<class THistogram >

enum itk::Statistics::HistogramToRunLengthFeaturesFilter::RunLengthFeatureName

Run-length feature types

Enumerator:

ShortRunEmphasis
LongRunEmphasis
GreyLevelNonuniformity
RunLengthNonuniformity
LowGreyLevelRunEmphasis
HighGreyLevelRunEmphasis
ShortRunLowGreyLevelEmphasis
ShortRunHighGreyLevelEmphasis
LongRunLowGreyLevelEmphasis
LongRunHighGreyLevelEmphasis

Definition at line 155 of file itkHistogramToRunLengthFeaturesFilter.h.

Constructor & Destructor Documentation

template<class THistogram >

itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::HistogramToRunLengthFeaturesFilter ( ) [protected]

template<class THistogram >

itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::~HistogramToRunLengthFeaturesFilter ( ) [inline, protected]

Definition at line 174 of file itkHistogramToRunLengthFeaturesFilter.h.

template<class THistogram >

itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::HistogramToRunLengthFeaturesFilter ( const Self & ) [private]

Member Function Documentation

template<class THistogram >

virtual::itk::LightObject::Pointer itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::CreateAnother ( void ) const [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::Object.

template<class THistogram >

void itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GenerateData ( void ) [protected, virtual]

This method causes the filter to generate its output.

Reimplemented from itk::ProcessObject.

template<class THistogram >

MeasurementType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetFeature ( RunLengthFeatureName name )

convenience method to access the run length values

template<class THistogram >

MeasurementType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetGreyLevelNonuniformity ( ) const

Methods to return the grey level nonuniformity.

template<class THistogram >

const MeasurementObjectType* itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetGreyLevelNonuniformityOutput ( ) const

Methods to return the grey level nonuniformity.

template<class THistogram >

MeasurementType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetHighGreyLevelRunEmphasis ( ) const

Methods to return the high grey level run emphasis.

template<class THistogram >

const MeasurementObjectType* itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetHighGreyLevelRunEmphasisOutput ( ) const

Methods to return the high grey level run emphasis.

template<class THistogram >

const HistogramType* itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetInput ( ) const

template<class THistogram >

MeasurementType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetLongRunEmphasis ( ) const

Methods to return the long run emphasis.

template<class THistogram >

const MeasurementObjectType* itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetLongRunEmphasisOutput ( ) const

Methods to return the long run emphasis.

template<class THistogram >

MeasurementType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetLongRunHighGreyLevelEmphasis ( ) const

Methods to return the long run high grey level run emphasis.

template<class THistogram >

const MeasurementObjectType* itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetLongRunHighGreyLevelEmphasisOutput ( ) const

Methods to return the long run high grey level run emphasis.

template<class THistogram >

MeasurementType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetLongRunLowGreyLevelEmphasis ( ) const

Methods to return the long run low grey level run emphasis.

template<class THistogram >

const MeasurementObjectType* itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetLongRunLowGreyLevelEmphasisOutput ( ) const

Methods to return the long run low grey level run emphasis.

template<class THistogram >

MeasurementType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetLowGreyLevelRunEmphasis ( ) const

Methods to return the low grey level run emphasis.

template<class THistogram >

const MeasurementObjectType* itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetLowGreyLevelRunEmphasisOutput ( ) const

Methods to return the low grey level run emphasis.

template<class THistogram >

virtual const char* itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetNameOfClass ( ) const [virtual]

Run-time type information (and related methods).

Reimplemented from itk::ProcessObject.

template<class THistogram >

MeasurementType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetRunLengthNonuniformity ( ) const

Methods to return the run length nonuniformity.

template<class THistogram >

const MeasurementObjectType* itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetRunLengthNonuniformityOutput ( ) const

Methods to return the run length nonuniformity.

template<class THistogram >

MeasurementType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetShortRunEmphasis ( ) const

Methods to return the short run emphasis.

template<class THistogram >

const MeasurementObjectType* itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetShortRunEmphasisOutput ( ) const

Methods to return the short run emphasis.

template<class THistogram >

MeasurementType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetShortRunHighGreyLevelEmphasis ( ) const

Methods to return the short run high grey level run emphasis.

template<class THistogram >

const MeasurementObjectType* itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetShortRunHighGreyLevelEmphasisOutput ( ) const

Methods to return the short run high grey level run emphasis.

template<class THistogram >

MeasurementType itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetShortRunLowGreyLevelEmphasis ( ) const

Methods to return the short run low grey level run emphasis.

template<class THistogram >

const MeasurementObjectType* itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetShortRunLowGreyLevelEmphasisOutput ( ) const

Methods to return the short run low grey level run emphasis.

template<class THistogram >

virtual unsigned long itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::GetTotalNumberOfRuns ( ) [virtual]

template<class THistogram >

virtual DataObjectPointer itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::MakeOutput ( DataObjectPointerArraySizeType idx ) [protected, virtual]

Make a DataObject of the correct type to used as the specified output. Every ProcessObject subclass must be able to create a DataObject that can be used as a specified output. This method is automatically called when DataObject::DisconnectPipeline() is called. DataObject::DisconnectPipeline, disconnects a data object from being an output of its current source. When the data object is disconnected, the ProcessObject needs to construct a replacement output data object so that the ProcessObject is in a valid state. So DataObject::DisconnectPipeline eventually calls ProcessObject::MakeOutput. Note that MakeOutput always returns a itkSmartPointer to a DataObject. ImageSource and MeshSource override this method to create the correct type of image and mesh respectively. If a filter has multiple outputs of different types, then that filter must provide an implementation of MakeOutput().

Reimplemented from itk::ProcessObject.

template<class THistogram >

static Pointer itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::New ( ) [static]

standard New() method support

Reimplemented from itk::Object.

template<class THistogram >

void itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::operator= ( const Self & ) [private]

Time when GenerateOutputInformation was last called.

Reimplemented from itk::ProcessObject.

template<class THistogram >

void itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::PrintSelf	(	std::ostream &	os,
		Indent	indent
	)		const `[protected, virtual]`

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.

template<class THistogram >

void itk::Statistics::HistogramToRunLengthFeaturesFilter< THistogram >::SetInput ( const HistogramType * histogram )