itk::EquivalencyTable Class Reference
[Watershed-based Segmentation Filters]

#include <itkEquivalencyTable.h>

Inheritance diagram for itk::EquivalencyTable:

[legend]Collaboration diagram for itk::EquivalencyTable:

[legend]List of all members.

---

Detailed Description

Hash table to manage integral label equivalencies.

EquivalencyTable is a hash table for recording equivalencies among unsigned long integer values. EquivalencyTable can store recursive relationships (8=7, 7=6, 6=5, ...) or be ``flattened'' to eliminate recursion. The table uses an efficient algorithm for eliminating redundancy and preventing circular dependencies.

In the context of the watershed segmentation algorithm (itk::WatershedImageFilter), this table is used to store connections identified among image segments and as the input to itk::watershed::Relabeler.

Definition at line 47 of file itkEquivalencyTable.h.

Public Types
typedef HashTableType::const_iterator	ConstIterator
typedef SmartPointer< const Self >	ConstPointer
typedef itk::hash_map< unsigned long, unsigned long, itk::hash< unsigned long > >	HashTableType
typedef HashTableType::iterator	Iterator
typedef SmartPointer< Self >	Pointer
typedef DataObject	Superclass
typedef HashTableType::value_type	ValueType
Public Member Functions
bool	Add (unsigned long a, unsigned long b)
bool	AddAndFlatten (unsigned long a, unsigned long b)
Iterator	Begin ()
void	Clear ()
bool	Empty () const
Iterator	End ()
void	Erase (const unsigned long a)
void	Flatten ()
virtual const char *	GetNameOfClass () const
Returns TRUE if the label is found in the table and FALSE is the label is *not found in the table *bool	IsEntry (const unsigned long a) const
Lookup an equivalency in the table If no entry is found in the the method returns its the value of the argument Does *not recursively descent through equivalencies *unsigned long	Lookup (const unsigned long a) const
unsigned long	RecursiveLookup (const unsigned a) const
HashTableType::size_type	Size () const
Static Public Member Functions
static Pointer	New ()
Public Attributes
Standard smart pointer declarations *typedef EquivalencyTable	Self
Lookup an equivalency in the table If no entry is found in the *	table
Protected Member Functions
	EquivalencyTable (const Self &)
	EquivalencyTable ()
void	operator= (const Self &)
void	PrintSelf (std::ostream &os, Indent indent) const
virtual	~EquivalencyTable ()
Protected Attributes
HashTableType	m_HashMap

---

Member Typedef Documentation

typedef HashTableType::const_iterator itk::EquivalencyTable::ConstIterator

Definition at line 63 of file itkEquivalencyTable.h.

typedef SmartPointer<const Self> itk::EquivalencyTable::ConstPointer

Definition at line 54 of file itkEquivalencyTable.h.

typedef itk::hash_map<unsigned long, unsigned long, itk::hash<unsigned long> > itk::EquivalencyTable::HashTableType

Define the container type for the table. Definition at line 56 of file itkEquivalencyTable.h.

typedef HashTableType::iterator itk::EquivalencyTable::Iterator

Definition at line 62 of file itkEquivalencyTable.h.

typedef SmartPointer<Self> itk::EquivalencyTable::Pointer

Definition at line 53 of file itkEquivalencyTable.h.

typedef DataObject itk::EquivalencyTable::Superclass

Definition at line 52 of file itkEquivalencyTable.h.

typedef HashTableType::value_type itk::EquivalencyTable::ValueType

Definition at line 64 of file itkEquivalencyTable.h.

---

Constructor & Destructor Documentation

itk::EquivalencyTable::EquivalencyTable (   )  [inline, protected]

Definition at line 141 of file itkEquivalencyTable.h.

virtual itk::EquivalencyTable::~EquivalencyTable (   )  [inline, protected, virtual]

Definition at line 142 of file itkEquivalencyTable.h.

itk::EquivalencyTable::EquivalencyTable (  const Self &   )  [protected]

---

Member Function Documentation

bool itk::EquivalencyTable::Add (  unsigned long  a, unsigned long  b )

Insert an equivalency into the table. A return value of TRUE indicates that the equivalency did not previously exist in the table and was successfully added. A FALSE return value indicates that the equivalency was not added to the table because a conflict with an existing entry occurred (most likely, the equivalency was already recorded directly or indirectly).

bool itk::EquivalencyTable::AddAndFlatten (  unsigned long  a, unsigned long  b )

Insert an equivalency into the table and flatten that equivalency. A return value of TRUE indicates that the equivalency did not previously exist in the table and was successfully added. A FALSE return value indicates that the equivalency was not added to the table because a conflict with an existing entry occurred (most likely, the equivalency was already recorded directly or indirectly).

Iterator itk::EquivalencyTable::Begin (   )  [inline]

Returns an iterator pointing to the first element of the (unordered) table. Definition at line 132 of file itkEquivalencyTable.h.

void itk::EquivalencyTable::Clear (   )  [inline]

Erases all the entries in the table. Definition at line 119 of file itkEquivalencyTable.h.

bool itk::EquivalencyTable::Empty (   )  const [inline]

Returns TRUE if the table is empty, FALSE if it is not empty. Definition at line 123 of file itkEquivalencyTable.h.

Iterator itk::EquivalencyTable::End (   )  [inline]

Returns and iterator pointing to one position past the last element of the (unordered) table. Definition at line 136 of file itkEquivalencyTable.h.

void itk::EquivalencyTable::Erase (  const unsigned long  a  )  [inline]

Erases the entry with key a. Definition at line 115 of file itkEquivalencyTable.h.

void itk::EquivalencyTable::Flatten (   )

``Flattens'' the equivalency table by eliminating all redundant and recursive equivalencies. I.e. the set { 2=1; 3=2; 4=3 } is converted to {4=1; 3=1; 2=1}.

virtual const char* itk::EquivalencyTable::GetNameOfClass (   )  const [virtual]

Returns TRUE if the label is found in the table and FALSE is the label is* not found in the table* bool itk::EquivalencyTable::IsEntry (  const unsigned long  a  )  const [inline]

Definition at line 107 of file itkEquivalencyTable.h.

Lookup an equivalency in the table If no entry is found in the the method returns its the value of the argument Does* not recursively descent through equivalencies* unsigned long itk::EquivalencyTable::Lookup (  const unsigned long  a  )  const [inline]

Definition at line 91 of file itkEquivalencyTable.h.

static Pointer itk::EquivalencyTable::New (   )  [static]

void itk::EquivalencyTable::operator= (  const Self &   )  [protected]

void itk::EquivalencyTable::PrintSelf (  std::ostream &  os, Indent  indent )  const [protected]

unsigned long itk::EquivalencyTable::RecursiveLookup (  const unsigned  a  )  const

Lookup an equivalency in the table by recursing through all successive equivalencies. For example, if the follow entries exist in the table {8=7, 7=6, 6=5}, then RecursiveLookup(8) returns 5.

HashTableType::size_type itk::EquivalencyTable::Size (  void   )  const [inline]

Returns the number of entries in the table. Definition at line 127 of file itkEquivalencyTable.h.

---

Member Data Documentation

HashTableType itk::EquivalencyTable::m_HashMap [protected]

Definition at line 148 of file itkEquivalencyTable.h.

Standard smart pointer declarations* typedef EquivalencyTable itk::EquivalencyTable::Self

Definition at line 51 of file itkEquivalencyTable.h.

Lookup an equivalency in the table If no entry is found in the* itk::EquivalencyTable::table

Definition at line 89 of file itkEquivalencyTable.h.

---

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

• itkEquivalencyTable.h

---