itk::LabelObject< TLabel, VImageDimension > Class Template Reference

#include <itkLabelObject.h>

Inheritance diagram for itk::LabelObject< TLabel, VImageDimension >:

Collaboration diagram for itk::LabelObject< TLabel, VImageDimension >:

Detailed Description

template<typename TLabel, unsigned int VImageDimension>
class itk::LabelObject< TLabel, VImageDimension >

The base class for the representation of an labeled binary object in an image.

LabelObject is the base class to represent a labeled object in an image. It should be used associated with the LabelMap.

LabelObject store mainly 2 things: the label of the object, and a set of lines which are part of the object. No attribute is available in that class, so this class can be used as a base class to implement a label object with attribute, or when no attribute is needed (see the reconstruction filters for an example. If a simple attribute is needed, AttributeLabelObject can be used directly.

All the subclasses of LabelObject have to reinplement the CopyAttributesFrom() and CopyAllFrom() method. No need to reimplement CopyLinesFrom() since all derived class share the same type line data members.

The pixels locations belonging to the LabelObject can be obtained using:

* for(unsigned int pixelId = 0; pixelId < labelObject->Size(); pixelId++)
*   {
*   std::cout << labelObject->GetIndex(pixelId);
*   }
* 

Author

Gaetan Lehmann. Biologie du Developpement et de la Reproduction, INRA de Jouy-en-Josas, France.

This implementation was taken from the Insight Journal paper: http://www.insight-journal.org/browse/publication/176

See Also

LabelMapFilter, AttributeLabelObject

Examples:

SphinxExamples/src/Filtering/ImageFusion/OverlayLabelMapOnTopOfAnImage/Code.cxx, SphinxExamples/src/Filtering/LabelMap/ApplyMorphologicalClosingOnAllLabelObjects/Code.cxx, SphinxExamples/src/Filtering/LabelMap/ApplyMorphologicalClosingOnSpecificLabelObject/Code.cxx, SphinxExamples/src/Filtering/LabelMap/ExtractGivenLabelObject/Code.cxx, and SphinxExamples/src/Filtering/LabelMap/MaskOneImageGivenLabelMap/Code.cxx.

Definition at line 64 of file itkLabelObject.h.

Classes
class	ConstIndexIterator
class	ConstLineIterator

Public Types
typedef unsigned int	AttributeType
typedef SmartPointer< const Self >	ConstPointer
typedef WeakPointer< const Self >	ConstWeakPointer
typedef Index< VImageDimension >	IndexType
typedef Self	LabelObjectType
typedef TLabel	LabelType
typedef LineType::LengthType	LengthType
typedef LabelObjectLine < VImageDimension >	LineType
typedef Offset< VImageDimension >	OffsetType
typedef SmartPointer< Self >	Pointer
typedef LabelObject	Self
typedef itk::SizeValueType	SizeValueType
typedef LightObject	Superclass
Public Types inherited from itk::LightObject
typedef SmartPointer< const Self >	ConstPointer
typedef SmartPointer< Self >	Pointer
typedef LightObject	Self

Public Member Functions
void	AddIndex (const IndexType &idx)
void	AddLine (const IndexType &idx, const LengthType &length)
void	AddLine (const LineType &line)
void	Clear ()
template<typename TSourceLabelObject >
void	CopyAllFrom (const TSourceLabelObject *src)
template<typename TSourceLabelObject >
void	CopyAttributesFrom (const TSourceLabelObject *src)
template<typename TSourceLabelObject >
void	CopyLinesFrom (const TSourceLabelObject *src)
virtual ::itk::LightObject::Pointer	CreateAnother () const
bool	Empty () const
IndexType	GetIndex (SizeValueType i) const
const LabelType &	GetLabel () const
const LineType &	GetLine (SizeValueType i) const
LineType &	GetLine (SizeValueType i)
virtual const char *	GetNameOfClass () const
SizeValueType	GetNumberOfLines () const
bool	HasIndex (const IndexType &idx) const
void	Optimize ()
bool	RemoveIndex (const IndexType &idx)
void	SetLabel (const LabelType &label)
void	Shift (OffsetType offset)
SizeValueType	Size () 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
virtual void	Register () const
virtual void	SetReferenceCount (int)
virtual void	UnRegister () const noexcept

Static Public Member Functions
static AttributeType	GetAttributeFromName (const std::string &s)
static std::string	GetNameFromAttribute (const AttributeType &a)
static Pointer	New ()
Static Public Member Functions inherited from itk::LightObject
static void	BreakOnError ()
static Pointer	New ()

Static Public Attributes
static const unsigned int	ImageDimension = VImageDimension
static const AttributeType	LABEL = 0

Protected Member Functions
	LabelObject ()
virtual void	PrintSelf (std::ostream &os, Indent indent) const override
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 Types
typedef std::deque< LineType >	LineContainerType

Private Member Functions
	LabelObject (const Self &) ITK_DELETE_FUNCTION
void	operator= (const Self &) ITK_DELETE_FUNCTION

Private Attributes
LabelType	m_Label
LineContainerType	m_LineContainer

Additional Inherited Members
Protected Attributes inherited from itk::LightObject
AtomicInt< int >	m_ReferenceCount

Member Typedef Documentation

template<typename TLabel , unsigned int VImageDimension>

typedef unsigned int itk::LabelObject< TLabel, VImageDimension >::AttributeType

Definition at line 88 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef SmartPointer< const Self > itk::LabelObject< TLabel, VImageDimension >::ConstPointer

Definition at line 72 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef WeakPointer< const Self > itk::LabelObject< TLabel, VImageDimension >::ConstWeakPointer

Definition at line 73 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef Index< VImageDimension > itk::LabelObject< TLabel, VImageDimension >::IndexType

Definition at line 83 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef Self itk::LabelObject< TLabel, VImageDimension >::LabelObjectType

Definition at line 70 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef TLabel itk::LabelObject< TLabel, VImageDimension >::LabelType

Definition at line 85 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef LineType::LengthType itk::LabelObject< TLabel, VImageDimension >::LengthType

Definition at line 87 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef std::deque< LineType > itk::LabelObject< TLabel, VImageDimension >::LineContainerType

private

Definition at line 377 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef LabelObjectLine< VImageDimension > itk::LabelObject< TLabel, VImageDimension >::LineType

Definition at line 86 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef Offset< VImageDimension > itk::LabelObject< TLabel, VImageDimension >::OffsetType

Definition at line 84 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef SmartPointer< Self > itk::LabelObject< TLabel, VImageDimension >::Pointer

Definition at line 71 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef LabelObject itk::LabelObject< TLabel, VImageDimension >::Self

Standard class typedefs

Definition at line 68 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef itk::SizeValueType itk::LabelObject< TLabel, VImageDimension >::SizeValueType

Definition at line 89 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

typedef LightObject itk::LabelObject< TLabel, VImageDimension >::Superclass

Definition at line 69 of file itkLabelObject.h.

Constructor & Destructor Documentation

template<typename TLabel , unsigned int VImageDimension>

itk::LabelObject< TLabel, VImageDimension >::LabelObject ( )

protected

template<typename TLabel , unsigned int VImageDimension>

itk::LabelObject< TLabel, VImageDimension >::LabelObject ( const Self &  )

private

Member Function Documentation

template<typename TLabel , unsigned int VImageDimension>

void itk::LabelObject< TLabel, VImageDimension >::AddIndex

(

const IndexType &

idx

)

Add an index to the object. If the index is already in the object, the index can be found several time in the object.

template<typename TLabel , unsigned int VImageDimension>

void itk::LabelObject< TLabel, VImageDimension >::AddLine	(	const IndexType &	idx,
		const LengthType &	length
	)

Add a new line to the object, without any check.

template<typename TLabel , unsigned int VImageDimension>

void itk::LabelObject< TLabel, VImageDimension >::AddLine

(

const LineType &

line

)

Add a new line to the object, without any check.

template<typename TLabel , unsigned int VImageDimension>

void itk::LabelObject< TLabel, VImageDimension >::Clear

(

)

template<typename TLabel , unsigned int VImageDimension>

template<typename TSourceLabelObject >

void itk::LabelObject< TLabel, VImageDimension >::CopyAllFrom

(

const TSourceLabelObject< TLabel, VImageDimension > *

src

)

Copy the lines, the label and the attributes from another node.

template<typename TLabel , unsigned int VImageDimension>

template<typename TSourceLabelObject >

void itk::LabelObject< TLabel, VImageDimension >::CopyAttributesFrom

(

const TSourceLabelObject< TLabel, VImageDimension > *

src

)

Copy the label and the attributes of another node to this one

template<typename TLabel , unsigned int VImageDimension>

template<typename TSourceLabelObject >

void itk::LabelObject< TLabel, VImageDimension >::CopyLinesFrom

(

const TSourceLabelObject< TLabel, VImageDimension > *

src

)

Copy the lines of another node to this one

template<typename TLabel , unsigned int VImageDimension>

virtual::itk::LightObject::Pointer itk::LabelObject< TLabel, VImageDimension >::CreateAnother ( ) 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::LightObject.

Reimplemented in itk::ShapeLabelObject< TLabel, VImageDimension >, and itk::StatisticsLabelObject< TLabel, VImageDimension >.

template<typename TLabel , unsigned int VImageDimension>

bool itk::LabelObject< TLabel, VImageDimension >::Empty

(

)

const

Returns true if there no line in the container (and thus no pixel in the object.

template<typename TLabel , unsigned int VImageDimension>

static AttributeType itk::LabelObject< TLabel, VImageDimension >::GetAttributeFromName ( const std::string &  s )

static

Referenced by itk::ShapeLabelObject< TLabel, VImageDimension >::GetAttributeFromName().

template<typename TLabel , unsigned int VImageDimension>

IndexType itk::LabelObject< TLabel, VImageDimension >::GetIndex

(

SizeValueType

i

)

const

Get the index of the ith pixel associated with the object. Valid indices are from 0 to LabelObject->GetSize() - 1.

template<typename TLabel , unsigned int VImageDimension>

const LabelType& itk::LabelObject< TLabel, VImageDimension >::GetLabel

(

)

const

Set/Get the label associated with the object.

template<typename TLabel , unsigned int VImageDimension>

const LineType& itk::LabelObject< TLabel, VImageDimension >::GetLine

(

SizeValueType

i

)

const

template<typename TLabel , unsigned int VImageDimension>

LineType& itk::LabelObject< TLabel, VImageDimension >::GetLine

(

SizeValueType

i

)

template<typename TLabel , unsigned int VImageDimension>

static std::string itk::LabelObject< TLabel, VImageDimension >::GetNameFromAttribute ( const AttributeType &  a )

static

Referenced by itk::ShapeLabelObject< TLabel, VImageDimension >::GetNameFromAttribute().

template<typename TLabel , unsigned int VImageDimension>

virtual const char* itk::LabelObject< TLabel, VImageDimension >::GetNameOfClass ( ) const

virtual

Run-time type information (and related methods).

Reimplemented from itk::LightObject.

Reimplemented in itk::AttributeLabelObject< TLabel, VImageDimension, TAttributeValue >, itk::ShapeLabelObject< TLabel, VImageDimension >, and itk::StatisticsLabelObject< TLabel, VImageDimension >.

template<typename TLabel , unsigned int VImageDimension>

SizeValueType itk::LabelObject< TLabel, VImageDimension >::GetNumberOfLines

(

)

const

template<typename TLabel , unsigned int VImageDimension>

bool itk::LabelObject< TLabel, VImageDimension >::HasIndex

(

const IndexType &

idx

)

const

Return true if the object contain the given index and false otherwise. Worst case complexity is O(L) where L is the number of lines in the object.

template<typename TLabel , unsigned int VImageDimension>

static Pointer itk::LabelObject< TLabel, VImageDimension >::New ( )

static

Method for creation through the object factory.

template<typename TLabel , unsigned int VImageDimension>

void itk::LabelObject< TLabel, VImageDimension >::operator= ( const Self &  )

private

template<typename TLabel , unsigned int VImageDimension>

void itk::LabelObject< TLabel, VImageDimension >::Optimize

(

)

Reorder the lines, merge the touching lines and ensure that no pixel is covered by two lines

template<typename TLabel , unsigned int VImageDimension>

virtual void itk::LabelObject< TLabel, VImageDimension >::PrintSelf ( std::ostream &  os, Indent  indent  ) const

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.

Reimplemented in itk::ShapeLabelObject< TLabel, VImageDimension >, itk::StatisticsLabelObject< TLabel, VImageDimension >, and itk::AttributeLabelObject< TLabel, VImageDimension, TAttributeValue >.

Referenced by itk::AttributeLabelObject< TLabel, VImageDimension, TAttributeValue >::PrintSelf(), and itk::ShapeLabelObject< TLabel, VImageDimension >::PrintSelf().

template<typename TLabel , unsigned int VImageDimension>

bool itk::LabelObject< TLabel, VImageDimension >::RemoveIndex

(

const IndexType &

idx

)

Remove an index to the object. Depending on the configuration, it can either reduce the size of the corresponding line, add one more line, remove the line from the line container.

template<typename TLabel , unsigned int VImageDimension>

void itk::LabelObject< TLabel, VImageDimension >::SetLabel

(

const LabelType &

label

)

template<typename TLabel , unsigned int VImageDimension>

void itk::LabelObject< TLabel, VImageDimension >::Shift

(

OffsetType

offset

)

Shift the object position

template<typename TLabel , unsigned int VImageDimension>

SizeValueType itk::LabelObject< TLabel, VImageDimension >::Size

(

)

const

Returns the number of pixels contained in the object.

Warning

To get an accurate result, you need to make sure there is no duplication in the line container. One way to ensure this (at a cost) is to call the Optimize method.

Member Data Documentation

template<typename TLabel , unsigned int VImageDimension>

const unsigned int itk::LabelObject< TLabel, VImageDimension >::ImageDimension = VImageDimension

static

Definition at line 81 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

const AttributeType itk::LabelObject< TLabel, VImageDimension >::LABEL = 0

static

Definition at line 91 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

LabelType itk::LabelObject< TLabel, VImageDimension >::m_Label

private

Definition at line 380 of file itkLabelObject.h.

template<typename TLabel , unsigned int VImageDimension>

LineContainerType itk::LabelObject< TLabel, VImageDimension >::m_LineContainer

private

Definition at line 379 of file itkLabelObject.h.

---

The documentation for this class was generated from the following file:

• itkLabelObject.h