CDPL::Chem::ConnectedSubstructureSet Class Reference

ConnectedSubstructureSet. More...

#include <ConnectedSubstructureSet.hpp>

Inheritance diagram for CDPL::Chem::ConnectedSubstructureSet:

Public Types
typedef std::shared_ptr< ConnectedSubstructureSet >	SharedPointer
	A reference-counted smart pointer [SHPTR] for dynamically allocated ConnectedSubstructureSet instances. More...
Public Types inherited from CDPL::Chem::FragmentList
typedef std::shared_ptr< FragmentList >	SharedPointer
Public Types inherited from CDPL::Util::IndirectArray< Fragment >
typedef Array< typename ValueType::SharedPointer >	BaseType
	The type of the public Array<PointerType> base class storing the pointer elements. More...
typedef Fragment	ElementType
	The type of the object that is obtained after dereferenciation of a stored pointer element. More...
typedef std::shared_ptr< IndirectArray >	SharedPointer
	A reference-counted smart pointer [SHPTR] for dynamically allocated IndirectArray instances. More...
typedef boost::transform_iterator< DerefFunc, typename BaseType::ConstElementIterator, const Fragment & >	ConstElementIterator
	A constant random access iterator used to iterate over the pointed-to objects. More...
typedef boost::transform_iterator< DerefFunc, typename BaseType::ConstReverseElementIterator, const Fragment & >	ConstReverseElementIterator
	A constant random access iterator used to iterate over the pointed-to objects in reverse order. More...
typedef boost::transform_iterator< DerefFunc, typename BaseType::ElementIterator, Fragment & >	ElementIterator
	A mutable random access iterator used to iterate over the pointed-to objects. More...
typedef boost::transform_iterator< DerefFunc, typename BaseType::ReverseElementIterator, Fragment & >	ReverseElementIterator
	A mutable random access iterator used to iterate over the pointed-to objects in reverse order. More...
Public Types inherited from CDPL::Util::Array< typename ValueType::SharedPointer >
typedef std::vector< typename ValueType::SharedPointer >	StorageType
typedef std::shared_ptr< Array >	SharedPointer
	A reference-counted smart pointer [SHPTR] for dynamically allocated Array instances. More...
typedef typename ValueType::SharedPointer	ElementType
	The type of objects stored by the array. More...
typedef std::size_t	SizeType
	The type of objects stored by the array. More...
typedef Array	BaseType
	Specifies for derived classes the type of the Array base class. More...
typedef StorageType::const_iterator	ConstElementIterator
	A constant random access iterator used to iterate over the elements of the array. More...
typedef StorageType::const_reverse_iterator	ConstReverseElementIterator
	A constant random access iterator used to iterate over the elements of the array in reverse order. More...
typedef StorageType::iterator	ElementIterator
	A mutable random access iterator used to iterate over the elements of the array. More...
typedef StorageType::reverse_iterator	ReverseElementIterator
	A mutable random access iterator used to iterate over the elements of the array in reverse order. More...

Public Member Functions
	ConnectedSubstructureSet ()
	Constructs an empty ConnectedSubstructureSet instance. More...
	ConnectedSubstructureSet (const MolecularGraph &molgraph)
	Constructs and initialzes a ConnectedSubstructureSet instance for the molecular graph molgraph. More...
void	reset (const MolecularGraph &molgraph)
	Specifies the molecular graph that is searched for connected substructures. More...
void	findSubstructures (std::size_t size)
	Searches the specified molecular graph for connected substructures of the given size. More...
std::size_t	getSubstructureSize () const
	Returns the current substructure size in terms of number of bonds. More...
Public Member Functions inherited from CDPL::Util::IndirectArray< Fragment >
	IndirectArray ()
	Creates an empty array. More...
	IndirectArray (std::size_t num_elem, const typename ValueType::SharedPointer &ptr=typename ValueType::SharedPointer())
	Creates and initializes the array with num_elem copies of ptr. More...
	IndirectArray (const InputIter &first, const InputIter &last)
	Creates and initializes the array with copies of the pointers in the range [first, last). More...
virtual	~IndirectArray ()
	Virtual destructor. More...
ElementIterator	insertElement (const ElementIterator &it, const typename ValueType::SharedPointer &ptr)
	Inserts a new element before the location specified by the iterator it. More...
void	insertElement (std::size_t idx, const Fragment &value=Fragment())
	Inserts a new element before the location specified by the index idx. More...
ElementIterator	insertElement (const ElementIterator &it, const Fragment &value=Fragment())
	Inserts a new element before the location specified by the iterator it. More...
void	insertElements (const ElementIterator &it, std::size_t num_elem, const typename ValueType::SharedPointer &ptr)
	Inserts num_elem copies of ptr before the location specified by the iterator it. More...
void	insertElements (const ElementIterator &it, const InputIter &first, const InputIter &last)
	Inserts the range of pointers [first, last) before the location specified by the iterator it. More...
void	insertElements (std::size_t idx, std::size_t num_elem, const Fragment &value=Fragment())
	Inserts num_elem copies of value before the location specified by the index idx. More...
void	insertElements (const ElementIterator &it, std::size_t num_elem, const Fragment &value=Fragment())
	Inserts num_elem copies of value before the location specified by the iterator it. More...
void	insertElements (std::size_t idx, const InputIter &first, const InputIter &last)
	Inserts the range of elements [first, last) before the location specified by the index idx. More...
void	insertElements (const ElementIterator &it, const InputIter &first, const InputIter &last)
	Inserts the range of elements [first, last) before the location specified by the iterator it. More...
ElementIterator	removeElement (const ElementIterator &it)
	Removes the element at the position specified by the iterator it. More...
void	removeElement (std::size_t idx)
	Removes the element at the position specified by the index idx. More...
ElementIterator	removeElement (const ElementIterator &it)
	Removes the element at the position specified by the iterator it. More...
ElementIterator	removeElements (const ElementIterator &first, const ElementIterator &last)
	Removes the elements pointed to by the iterators in the range [first, last). More...
ElementIterator	removeElements (const ElementIterator &first, const ElementIterator &last)
	Removes the elements pointed to by the iterators in the range [first, last). More...
const Fragment &	getFirstElement () const
	Returns a const reference to the object pointed to by the first element of the array. More...
Fragment &	getFirstElement ()
	Returns a non-const reference to the object pointed to by the first element of the array. More...
const Fragment &	getLastElement () const
	Returns a const reference to the object pointed to by the last element of the array. More...
Fragment &	getLastElement ()
	Returns a non-const reference to the object pointed to by the last element of the array. More...
ConstElementIterator	getElementsBegin () const
	Returns a constant iterator over the pointed-to objects that points to the beginning of the array. More...
ElementIterator	getElementsBegin ()
	Returns a mutable iterator over the pointed-to objects that points to the beginning of the array. More...
ConstElementIterator	getElementsEnd () const
	Returns a constant iterator over the pointed-to objects that points to the end of the array. More...
ElementIterator	getElementsEnd ()
	Returns a mutable iterator over the pointed-to objects that points to the end of the array. More...
ConstElementIterator	begin () const
	Returns a constant iterator over the pointed-to objects that points to the beginning of the array. More...
ElementIterator	begin ()
	Returns a mutable iterator over the pointed-to objects that points to the beginning of the array. More...
ConstElementIterator	end () const
	Returns a constant iterator over the pointed-to objects that points to the end of the array. More...
ElementIterator	end ()
	Returns a mutable iterator over the pointed-to objects that points to the end of the array. More...
ConstReverseElementIterator	getElementsReverseBegin () const
	Returns a constant iterator over the pointed-to objects that points to the beginning of the reversed array. More...
ReverseElementIterator	getElementsReverseBegin ()
	Returns a mutable iterator over the pointed-to objects that points to the beginning of the reversed array. More...
ConstReverseElementIterator	getElementsReverseEnd () const
	Returns a constant iterator over the pointed-to objects that points to the end of the reversed array. More...
ReverseElementIterator	getElementsReverseEnd ()
	Returns a mutable iterator over the pointed-to objects that points to the end of the reversed array. More...
const Fragment &	getElement (std::size_t idx) const
	Returns a const reference to the object pointed-to by the pointer element at index idx. More...
Fragment &	getElement (std::size_t idx)
	Returns a non-const reference to the object pointed-to by the pointer element at index idx. More...
const Fragment &	operator[] (std::size_t idx) const
	Returns a const reference to the object pointed-to by the pointer element at index idx. More...
Fragment &	operator[] (std::size_t idx)
	Returns a non-const reference to the object pointed-to by the pointer element at index idx. More...
Public Member Functions inherited from CDPL::Util::Array< typename ValueType::SharedPointer >
	Array ()
	Creates an empty array. More...
	Array (std::size_t num_elem, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
	Creates and initializes the array with num_elem copies of value. More...
	Array (const InputIter &first, const InputIter &last)
	Creates and initializes the array with copies of the elements in the range [first, last). More...
virtual	~Array ()
	Virtual destructor. More...
StorageType &	getData ()
const StorageType &	getData () const
BaseType &	getBase ()
	Returns a non-const reference to itself. More...
const BaseType &	getBase () const
	Returns a const reference to itself. More...
std::size_t	getSize () const
	Returns the number of elements stored in the array. More...
std::size_t	size () const
	Returns the number of elements stored in the array. More...
bool	isEmpty () const
	Tells whether the array is empty (getSize() == 0). More...
void	resize (std::size_t num_elem, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
	Inserts or erases elements at the end so that the size becomes num_elem. More...
void	reserve (std::size_t num_elem)
	Preallocates memory for (at least) num_elem elements. More...
std::size_t	getCapacity () const
	Returns the number of elements for which memory has been allocated. More...
void	clear ()
	Erases all elements. More...
void	swap (Array &array)
	Swaps the contents with array. More...
void	assign (std::size_t num_elem, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
	This function fills the array with num_elem copies of the given value. More...
void	assign (const InputIter &first, const InputIter &last)
	This function fills a vector with copies of the elements in the range [first, last). More...
void	addElement (const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
	Inserts a new element at the end of the array. More...
void	insertElement (std::size_t idx, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
	Inserts a new element before the location specified by the index idx. More...
ElementIterator	insertElement (const ElementIterator &it, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
	Inserts a new element before the location specified by the iterator it. More...
void	insertElements (std::size_t idx, std::size_t num_elem, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
	Inserts num_elem copies of value before the location specified by the index idx. More...
void	insertElements (const ElementIterator &it, std::size_t num_elem, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
	Inserts num_elem copies of value before the location specified by the iterator it. More...
void	insertElements (std::size_t idx, const InputIter &first, const InputIter &last)
	Inserts the range of elements [first, last) before the location specified by the index idx. More...
void	insertElements (const ElementIterator &it, const InputIter &first, const InputIter &last)
	Inserts the range of elements [first, last) before the location specified by the iterator it. More...
void	popLastElement ()
	Removes the last element of the array. More...
void	removeElement (std::size_t idx)
	Removes the element at the position specified by the index idx. More...
ElementIterator	removeElement (const ElementIterator &it)
	Removes the element at the position specified by the iterator it. More...
ElementIterator	removeElements (const ElementIterator &first, const ElementIterator &last)
	Removes the elements pointed to by the iterators in the range [first, last). More...
const typename ValueType::SharedPointer &	getFirstElement () const
	Returns a const reference to the first element of the array. More...
typename ValueType::SharedPointer &	getFirstElement ()
	Returns a non-const reference to the first element of the array. More...
const typename ValueType::SharedPointer &	getLastElement () const
	Returns a const reference to the last element of the array. More...
typename ValueType::SharedPointer &	getLastElement ()
	Returns a non-const reference to the last element of the array. More...
ConstElementIterator	getElementsBegin () const
	Returns a constant iterator pointing to the beginning of the array. More...
ElementIterator	getElementsBegin ()
	Returns a mutable iterator pointing to the beginning of the array. More...
ConstElementIterator	getElementsEnd () const
	Returns a constant iterator pointing to the end of the array. More...
ElementIterator	getElementsEnd ()
	Returns a mutable iterator pointing to the end of the array. More...
ConstElementIterator	begin () const
	Returns a constant iterator pointing to the beginning of the array. More...
ElementIterator	begin ()
	Returns a mutable iterator pointing to the beginning of the array. More...
ConstElementIterator	end () const
	Returns a constant iterator pointing to the end of the array. More...
ElementIterator	end ()
	Returns a mutable iterator pointing to the end of the array. More...
ConstReverseElementIterator	getElementsReverseBegin () const
	Returns a constant iterator pointing to the beginning of the reversed array. More...
ReverseElementIterator	getElementsReverseBegin ()
	Returns a mutable iterator pointing to the beginning of the reversed array. More...
ConstReverseElementIterator	getElementsReverseEnd () const
	Returns a constant iterator pointing to the end of the reversed array. More...
ReverseElementIterator	getElementsReverseEnd ()
	Returns a mutable iterator pointing to the end of the reversed array. More...
const typename ValueType::SharedPointer &	getElement (std::size_t idx) const
	Returns a const reference to the element at index idx. More...
typename ValueType::SharedPointer &	getElement (std::size_t idx)
	Returns a non-const reference to the element at index idx. More...
void	setElement (std::size_t idx, const typename ValueType::SharedPointer &value=typename ValueType::SharedPointer())
	Assigns a new value to the element specified by the index idx. More...
const typename ValueType::SharedPointer &	operator[] (std::size_t idx) const
	Returns a const reference to the element at index idx. More...
typename ValueType::SharedPointer &	operator[] (std::size_t idx)
	Returns a non-const reference to the element at index idx. More...

Additional Inherited Members
Protected Member Functions inherited from CDPL::Util::Array< typename ValueType::SharedPointer >
void	checkIfNonEmpty () const
void	checkIndex (std::size_t idx, bool allow_end) const
void	checkIterator (const ElementIterator &it, bool allow_end)
void	checkIterator (const ConstElementIterator &it, bool allow_end) const

Detailed Description

ConnectedSubstructureSet.

Member Typedef Documentation

SharedPointer

typedef std::shared_ptr<ConnectedSubstructureSet> CDPL::Chem::ConnectedSubstructureSet::SharedPointer

A reference-counted smart pointer [SHPTR] for dynamically allocated ConnectedSubstructureSet instances.

Constructor & Destructor Documentation

ConnectedSubstructureSet() [1/2]

CDPL::Chem::ConnectedSubstructureSet::ConnectedSubstructureSet

(

)

Constructs an empty ConnectedSubstructureSet instance.

ConnectedSubstructureSet() [2/2]

CDPL::Chem::ConnectedSubstructureSet::ConnectedSubstructureSet

(

const MolecularGraph &

molgraph

)

Constructs and initialzes a ConnectedSubstructureSet instance for the molecular graph molgraph.

Parameters

molgraph

The molecular graph to search for connected substructures.

Member Function Documentation

reset()

void CDPL::Chem::ConnectedSubstructureSet::reset

(

const MolecularGraph &

molgraph

)

Specifies the molecular graph that is searched for connected substructures.

The current substructure size is reset to zero.

Parameters

molgraph

The molecular graph to search for connected substructures.

findSubstructures()

void CDPL::Chem::ConnectedSubstructureSet::findSubstructures

(

std::size_t

size

)

Searches the specified molecular graph for connected substructures of the given size.

If a molecular graph has not yet been specified (in the constructor or by a prior call to reset(const Chem::MolecularGraph&)), the method has no effect. Otherwise, all connected substructures of the specified size are added as Chem::Fragment objects to the list of previously found (if any) substructures. If the specified size is zero, substructures of size 1 (i.e. the bonds of the molecular graph) will be extracted.

Parameters

size	The substructure size in terms of number of bonds.

getSubstructureSize()

std::size_t CDPL::Chem::ConnectedSubstructureSet::getSubstructureSize

(

)

const

Returns the current substructure size in terms of number of bonds.

The current substructure size corresponds to the size that was specified in the the last call to findSubstructures(). If findSubstructures() has not yet been called, the current substructure size is zero.

Returns

The current substructure size.

---

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

• ConnectedSubstructureSet.hpp