#include <CircularFingerprintGenerator.hpp>

Classes
class	DefAtomIdentifierFunctor
	The functor for the generation of ECFP atom identifiers. More...

class	DefBondIdentifierFunctor
	The default functor for the generation of bond identifiers. More...

Public Types
typedef std::function< std::uint64_t(const Chem::Atom &, const Chem::MolecularGraph &)>	AtomIdentifierFunction
	Type of the generic functor class used to store user-defined functions or function objects for the generation of atom identifiers. More...

typedef std::function< std::uint64_t(const Chem::Bond &)>	BondIdentifierFunction
	Type of the generic functor class used to store user-defined functions or function objects for the generation of bond identifiers. More...

Public Member Functions
	CircularFingerprintGenerator ()
	Constructs the `CircularFingerprintGenerator` instance. More...

	CircularFingerprintGenerator (const Chem::MolecularGraph &molgraph)
	Constructs the `CircularFingerprintGenerator` instance and generates the atom-centered circular substructure fingerprint of the molecular graph molgraph. More...

void	setAtomIdentifierFunction (const AtomIdentifierFunction &func)
	Allows to specify a customized function for the generation of initial atom identifiers. More...

void	setBondIdentifierFunction (const BondIdentifierFunction &func)
	Allows to specify a customized function for the generation of initial bond identifiers. More...

void	setNumIterations (std::size_t num_iter)
	Allows to specify the desired number of feature substructure growing iterations. More...

std::size_t	getNumIterations () const
	Returns the number of feature substructure growing iterations. More...

void	includeHydrogens (bool include)

bool	hydrogensIncluded () const

void	includeChirality (bool include)

bool	chiralityIncluded () const

void	generate (const Chem::MolecularGraph &molgraph)
	Generates the atom-centered circular substructure fingerprint of the molecular graph molgraph. More...

void	setFeatureBits (Util::BitSet &bs, bool reset=true) const
	Maps previously generated feature identifiers to bit indices and sets the correponding bits of bs. More...

void	setFeatureBits (std::size_t atom_idx, Util::BitSet &bs, bool reset=true) const
	Maps previously generated identifiers of structural features involving the atom specified by atom_idx to bit indices and sets the correponding bits of bs. More...

std::size_t	getNumFeatures () const

std::uint64_t	getFeatureIdentifier (std::size_t ftr_idx) const

const Util::BitSet &	getFeatureSubstructure (std::size_t ftr_idx) const

void	getFeatureSubstructure (std::size_t ftr_idx, Chem::Fragment &frag, bool clear=true) const

void	getFeatureSubstructures (std::size_t bit_idx, std::size_t bs_size, Chem::FragmentList &frags, bool clear=true) const

Static Public Attributes
static constexpr unsigned int	DEF_ATOM_PROPERTY_FLAGS
	Specifies the default set of atomic properties considered in the generation of atom identifiers by CircularFingerprintGenerator::DefAtomIdentifierFunction. More...

static constexpr unsigned int	DEF_BOND_PROPERTY_FLAGS
	Specifies the default set of bond properties considered in the generation of bond identifiers by CircularFingerprintGenerator::DefBondIdentifierFunction. More...

Detailed Description

CircularFingerprintGenerator.

See also: [STECFP]

Member Typedef Documentation

◆ AtomIdentifierFunction

typedef std::function<std::uint64_t(const Chem::Atom&, const Chem::MolecularGraph&)> CDPL::Descr::CircularFingerprintGenerator::AtomIdentifierFunction

Type of the generic functor class used to store user-defined functions or function objects for the generation of atom identifiers.

Functions or function objects for the generation of atom identifiers are required to take the atom (as a const reference to Chem::Atom) and containing molecular graph (as a const reference to Chem::MolecularGraph) as argument and return the identifier as an integer of type std::uint64_t (see [FUNWRP]).

◆ BondIdentifierFunction

typedef std::function<std::uint64_t(const Chem::Bond&)> CDPL::Descr::CircularFingerprintGenerator::BondIdentifierFunction

Type of the generic functor class used to store user-defined functions or function objects for the generation of bond identifiers.

Functions or function objects for the generation of bond identifiers are required to take the bond (as a const reference to Chem::Bond) as argument and return the identifier as an integer of type std::uint64_t (see [FUNWRP]).

Constructor & Destructor Documentation

◆ CircularFingerprintGenerator() [1/2]

CDPL::Descr::CircularFingerprintGenerator::CircularFingerprintGenerator ( )

Constructs the CircularFingerprintGenerator instance.

◆ CircularFingerprintGenerator() [2/2]

CDPL::Descr::CircularFingerprintGenerator::CircularFingerprintGenerator ( const Chem::MolecularGraph & molgraph )

Constructs the CircularFingerprintGenerator instance and generates the atom-centered circular substructure fingerprint of the molecular graph molgraph.

Parameters

molgraph The molecular graph to process.

Member Function Documentation

◆ setAtomIdentifierFunction()

void CDPL::Descr::CircularFingerprintGenerator::setAtomIdentifierFunction ( const AtomIdentifierFunction & func )

Allows to specify a customized function for the generation of initial atom identifiers.

Parameters

func	A CircularFingerprintGenerator::AtomIdentifierFunction instance that wraps the target function.

Note: By default, atom identifiers are generated by a CircularFingerprintGenerator::DefAtomIdentifierFunctor instance. If the generated initial identifier for an atom is 0, the atom is regarded as not being present in the processed molecular graph.

◆ setBondIdentifierFunction()

void CDPL::Descr::CircularFingerprintGenerator::setBondIdentifierFunction ( const BondIdentifierFunction & func )

Allows to specify a customized function for the generation of initial bond identifiers.

Parameters

func	A CircularFingerprintGenerator::BondIdentifierFunction instance that wraps the target function.

Note: By default, bond identifiers are generated by a CircularFingerprintGenerator::DefBondIdentifierFunctor instance. If the generated initial identifier for a bond is 0, the bond is regarded as not being present in the processed molecular graph.

◆ setNumIterations()

void CDPL::Descr::CircularFingerprintGenerator::setNumIterations ( std::size_t num_iter )

Allows to specify the desired number of feature substructure growing iterations.

Parameters

num_iter The number of iterations.

Note: The default number of iterations is 2.

◆ getNumIterations()

std::size_t CDPL::Descr::CircularFingerprintGenerator::getNumIterations ( ) const

Returns the number of feature substructure growing iterations.

Returns: The number of iterations.

◆ includeHydrogens()

void CDPL::Descr::CircularFingerprintGenerator::includeHydrogens ( bool include )

◆ hydrogensIncluded()

bool CDPL::Descr::CircularFingerprintGenerator::hydrogensIncluded ( ) const

◆ includeChirality()

void CDPL::Descr::CircularFingerprintGenerator::includeChirality ( bool include )

◆ chiralityIncluded()

bool CDPL::Descr::CircularFingerprintGenerator::chiralityIncluded ( ) const

◆ generate()

void CDPL::Descr::CircularFingerprintGenerator::generate ( const Chem::MolecularGraph & molgraph )

Generates the atom-centered circular substructure fingerprint of the molecular graph molgraph.

Parameters

molgraph The molecular graph to process.

◆ setFeatureBits() [1/2]

void CDPL::Descr::CircularFingerprintGenerator::setFeatureBits	(	Util::BitSet &	bs,
		bool	reset = `true`
	)		const

Maps previously generated feature identifiers to bit indices and sets the correponding bits of bs.

Parameters

bs	The target bitset.
reset	If true, bs will be cleared before any feature bits are set.

Note: The binary fingerprint size is specified implicitly via the size of bs.

See also: generate()

◆ setFeatureBits() [2/2]

void CDPL::Descr::CircularFingerprintGenerator::setFeatureBits	(	std::size_t	atom_idx,
		Util::BitSet &	bs,
		bool	reset = `true`
	)		const

Maps previously generated identifiers of structural features involving the atom specified by atom_idx to bit indices and sets the correponding bits of bs.

Parameters

atom_idx	The index of the atom that has to be involved in the structural features.
bs	The target bitset.
reset	If true, bs will be cleared before any feature bits are set.

Note: The binary fingerprint size is specified implicitly via the size of bs.

See also: generate()

◆ getNumFeatures()

std::size_t CDPL::Descr::CircularFingerprintGenerator::getNumFeatures ( ) const

◆ getFeatureIdentifier()

std::uint64_t CDPL::Descr::CircularFingerprintGenerator::getFeatureIdentifier ( std::size_t ftr_idx ) const

◆ getFeatureSubstructure() [1/2]

const Util::BitSet& CDPL::Descr::CircularFingerprintGenerator::getFeatureSubstructure ( std::size_t ftr_idx ) const

◆ getFeatureSubstructure() [2/2]

void CDPL::Descr::CircularFingerprintGenerator::getFeatureSubstructure	(	std::size_t	ftr_idx,
		Chem::Fragment &	frag,
		bool	clear = `true`
	)		const

◆ getFeatureSubstructures()

void CDPL::Descr::CircularFingerprintGenerator::getFeatureSubstructures	(	std::size_t	bit_idx,
		std::size_t	bs_size,
		Chem::FragmentList &	frags,
		bool	clear = `true`
	)		const

Member Data Documentation

◆ DEF_ATOM_PROPERTY_FLAGS

constexpr unsigned int CDPL::Descr::CircularFingerprintGenerator::DEF_ATOM_PROPERTY_FLAGS

staticconstexpr

Initial value:

=
                Chem::AtomPropertyFlag::HEAVY_BOND_COUNT | Chem::AtomPropertyFlag::VALENCE | Chem::AtomPropertyFlag::TYPE |
                Chem::AtomPropertyFlag::FORMAL_CHARGE | Chem::AtomPropertyFlag::H_COUNT | Chem::AtomPropertyFlag::TOPOLOGY |
                Chem::AtomPropertyFlag::ISOTOPE

Specifies the default set of atomic properties considered in the generation of atom identifiers by CircularFingerprintGenerator::DefAtomIdentifierFunction.

◆ DEF_BOND_PROPERTY_FLAGS

constexpr unsigned int CDPL::Descr::CircularFingerprintGenerator::DEF_BOND_PROPERTY_FLAGS

staticconstexpr

Initial value:

=

Chem::BondPropertyFlag::ORDER | Chem::BondPropertyFlag::AROMATICITY

Specifies the default set of bond properties considered in the generation of bond identifiers by CircularFingerprintGenerator::DefBondIdentifierFunction.

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

CircularFingerprintGenerator.hpp

Classes

Public Types

Public Member Functions

Static Public Attributes

Detailed Description

Member Typedef Documentation

◆ AtomIdentifierFunction

◆ BondIdentifierFunction

Constructor & Destructor Documentation

◆ CircularFingerprintGenerator() [1/2]

◆ CircularFingerprintGenerator() [2/2]

Member Function Documentation

◆ setAtomIdentifierFunction()

◆ setBondIdentifierFunction()

◆ setNumIterations()

◆ getNumIterations()

◆ includeHydrogens()

◆ hydrogensIncluded()

◆ includeChirality()

◆ chiralityIncluded()

◆ generate()

◆ setFeatureBits() [1/2]

◆ setFeatureBits() [2/2]

◆ getNumFeatures()

◆ getFeatureIdentifier()

◆ getFeatureSubstructure() [1/2]

◆ getFeatureSubstructure() [2/2]

◆ getFeatureSubstructures()

Member Data Documentation

◆ DEF_ATOM_PROPERTY_FLAGS

◆ DEF_BOND_PROPERTY_FLAGS