The class for representing SubstanceGroups. More...

#include <SubstanceGroup.h>

Inheritance diagram for RDKit::SubstanceGroup:

Classes
struct	AttachPoint

struct	CState

Public Types
enum class	BondType { XBOND , CBOND }
	Bond type (see V3000 spec) More...

typedef std::array< RDGeom::Point3D, 3 >	Bracket

Public Member Functions
	SubstanceGroup ()=delete
	No default constructor. More...

	SubstanceGroup (ROMol *owning_mol, const std::string &type)

	SubstanceGroup (const SubstanceGroup &other)=default

	SubstanceGroup (SubstanceGroup &&other)=default

SubstanceGroup &	operator= (const SubstanceGroup &other)=default

SubstanceGroup &	operator= (SubstanceGroup &&other)=default

	~SubstanceGroup ()
	Destructor. More...

bool	hasOwningMol () const
	returns whether or not this belongs to a molecule More...

ROMol &	getOwningMol () const
	Get the molecule that owns this instance. More...

unsigned int	getIndexInMol () const

void	addAtomWithIdx (unsigned int idx)

void	addParentAtomWithIdx (unsigned int idx)

void	addBondWithIdx (unsigned int idx)

void	addAtomWithBookmark (int mark)

void	addParentAtomWithBookmark (int mark)

void	addBondWithBookmark (int mark)

void	addBracket (const Bracket &bracket)

void	addCState (unsigned int bondIdx, const RDGeom::Point3D &vector)

void	addAttachPoint (unsigned int aIdx, int lvIdx, const std::string &idStr)

BondType	getBondType (unsigned int bondIdx) const

const std::vector< unsigned int > &	getAtoms () const

const std::vector< unsigned int > &	getParentAtoms () const

const std::vector< unsigned int > &	getBonds () const

const std::vector< Bracket > &	getBrackets () const

const std::vector< CState > &	getCStates () const

const std::vector< AttachPoint > &	getAttachPoints () const

void	clearBrackets ()

void	clearCStates ()

void	clearAttachPoints ()

bool	adjustToRemovedAtom (unsigned int atomIdx)

bool	includesAtom (unsigned int atomIdx) const

bool	adjustToRemovedBond (unsigned int bondIdx)

bool	includesBond (unsigned int bondIdx) const

void	setOwningMol (ROMol *mol)

bool	operator== (const SubstanceGroup &other) const

Public Member Functions inherited from RDKit::RDProps
	RDProps ()

	RDProps (const RDProps &rhs)

RDProps &	operator= (const RDProps &rhs)

void	clear ()

const Dict &	getDict () const
	gets the underlying Dictionary More...

Dict &	getDict ()

STR_VECT	getPropList (bool includePrivate=true, bool includeComputed=true) const
	returns a list with the names of our `properties` More...

template<typename T >
void	setProp (const std::string &key, T val, bool computed=false) const
	sets a `property` value More...

template<typename T >
void	getProp (const std::string &key, T &res) const
	allows retrieval of a particular property value More...

template<typename T >
T	getProp (const std::string &key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. More...

template<typename T >
bool	getPropIfPresent (const std::string &key, T &res) const

bool	hasProp (const std::string &key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. More...

void	clearProp (const std::string &key) const
	clears the value of a `property` More...

void	clearComputedProps () const
	clears all of our `computed` `properties` More...

void	updateProps (const RDProps &source, bool preserveExisting=false)
	update the properties from another More...

Additional Inherited Members
Protected Attributes inherited from RDKit::RDProps
Dict	d_props

Detailed Description

The class for representing SubstanceGroups.

Notes:

These are inspired by the SGroups in the MDL formats
Implementation is based on 2010 MDL SD specification: http://infochim.u-strasbg.fr/recherche/Download/Fragmentor/MDL_SDF.pdf
See SGroups.md for further, more comprehensive notes.

Definition at line 53 of file SubstanceGroup.h.

Member Typedef Documentation

◆ Bracket

typedef std::array<RDGeom::Point3D, 3> RDKit::SubstanceGroup::Bracket

Definition at line 61 of file SubstanceGroup.h.

Member Enumeration Documentation

◆ BondType

enum RDKit::SubstanceGroup::BondType

strong

Bond type (see V3000 spec)

Enumerator
XBOND
CBOND

Definition at line 56 of file SubstanceGroup.h.

Constructor & Destructor Documentation

◆ SubstanceGroup() [1/4]

RDKit::SubstanceGroup::SubstanceGroup ( )

delete

No default constructor.

◆ SubstanceGroup() [2/4]

RDKit::SubstanceGroup::SubstanceGroup	(	ROMol *	owning_mol,
		const std::string &	type
	)

Main Constructor. Ownership is only set on this side of the relationship: mol->addSubstanceGroup(sgroup) still needs to be called to get ownership on the other side.

◆ SubstanceGroup() [3/4]

RDKit::SubstanceGroup::SubstanceGroup ( const SubstanceGroup & other )

default

◆ SubstanceGroup() [4/4]

RDKit::SubstanceGroup::SubstanceGroup ( SubstanceGroup && other )

default

◆ ~SubstanceGroup()

RDKit::SubstanceGroup::~SubstanceGroup ( )

inline

Destructor.

Definition at line 104 of file SubstanceGroup.h.

Member Function Documentation

◆ addAtomWithBookmark()

void RDKit::SubstanceGroup::addAtomWithBookmark ( int mark )

◆ addAtomWithIdx()

void RDKit::SubstanceGroup::addAtomWithIdx ( unsigned int idx )

◆ addAttachPoint()

void RDKit::SubstanceGroup::addAttachPoint	(	unsigned int	aIdx,
		int	lvIdx,
		const std::string &	idStr
	)

◆ addBondWithBookmark()

void RDKit::SubstanceGroup::addBondWithBookmark ( int mark )

◆ addBondWithIdx()

void RDKit::SubstanceGroup::addBondWithIdx ( unsigned int idx )

◆ addBracket()

void RDKit::SubstanceGroup::addBracket ( const Bracket & bracket )

◆ addCState()

void RDKit::SubstanceGroup::addCState	(	unsigned int	bondIdx,
		const RDGeom::Point3D &	vector
	)

◆ addParentAtomWithBookmark()

void RDKit::SubstanceGroup::addParentAtomWithBookmark ( int mark )

◆ addParentAtomWithIdx()

void RDKit::SubstanceGroup::addParentAtomWithIdx ( unsigned int idx )

◆ adjustToRemovedAtom()

bool RDKit::SubstanceGroup::adjustToRemovedAtom ( unsigned int atomIdx )

adjusts our atom IDs to reflect that an atom has been removed from the parent molecule decrements all atom IDs that are higher than atomIdx raises a SubstanceGroupException if atomIdx is actually part of this substance group

Returns: whether or not anything was changed

◆ adjustToRemovedBond()

bool RDKit::SubstanceGroup::adjustToRemovedBond ( unsigned int bondIdx )

adjusts our bond IDs to reflect that a bond has been removed from the parent molecule decrements all bond IDs that are higher than bondIdx raises a SubstanceGroupException if bondIdx is actually part of this substance group

Returns: whether or not anything was changed

◆ clearAttachPoints()

void RDKit::SubstanceGroup::clearAttachPoints ( )

inline

Definition at line 143 of file SubstanceGroup.h.

◆ clearBrackets()

void RDKit::SubstanceGroup::clearBrackets ( )

inline

Definition at line 141 of file SubstanceGroup.h.

◆ clearCStates()

void RDKit::SubstanceGroup::clearCStates ( )

inline

Definition at line 142 of file SubstanceGroup.h.

◆ getAtoms()

const std::vector<unsigned int>& RDKit::SubstanceGroup::getAtoms ( ) const

inline

Definition at line 133 of file SubstanceGroup.h.

◆ getAttachPoints()

const std::vector<AttachPoint>& RDKit::SubstanceGroup::getAttachPoints ( ) const

inline

Definition at line 139 of file SubstanceGroup.h.

◆ getBonds()

const std::vector<unsigned int>& RDKit::SubstanceGroup::getBonds ( ) const

inline

Definition at line 135 of file SubstanceGroup.h.

◆ getBondType()

BondType RDKit::SubstanceGroup::getBondType ( unsigned int bondIdx ) const

◆ getBrackets()

const std::vector<Bracket>& RDKit::SubstanceGroup::getBrackets ( ) const

inline

Definition at line 137 of file SubstanceGroup.h.

◆ getCStates()

const std::vector<CState>& RDKit::SubstanceGroup::getCStates ( ) const

inline

Definition at line 138 of file SubstanceGroup.h.

◆ getIndexInMol()

unsigned int RDKit::SubstanceGroup::getIndexInMol ( ) const

get the index of this sgroup in dp_mol's sgroups vector (do not mistake this by the ID!)00

◆ getOwningMol()

ROMol& RDKit::SubstanceGroup::getOwningMol ( ) const

inline

Get the molecule that owns this instance.

Definition at line 110 of file SubstanceGroup.h.

References PRECONDITION.

◆ getParentAtoms()

const std::vector<unsigned int>& RDKit::SubstanceGroup::getParentAtoms ( ) const

inline

Definition at line 134 of file SubstanceGroup.h.

◆ hasOwningMol()

bool RDKit::SubstanceGroup::hasOwningMol ( ) const

inline

returns whether or not this belongs to a molecule

Definition at line 107 of file SubstanceGroup.h.

◆ includesAtom()

bool RDKit::SubstanceGroup::includesAtom ( unsigned int atomIdx ) const

Returns: whether or not anything the specified atom is part of the definition of this substance group

◆ includesBond()

bool RDKit::SubstanceGroup::includesBond ( unsigned int bondIdx ) const

Returns: whether or not anything the specified bond is part of the definition of this substance group

◆ operator=() [1/2]

SubstanceGroup& RDKit::SubstanceGroup::operator= ( const SubstanceGroup & other )

default

◆ operator=() [2/2]

SubstanceGroup& RDKit::SubstanceGroup::operator= ( SubstanceGroup && other )

default

◆ operator==()

bool RDKit::SubstanceGroup::operator== ( const SubstanceGroup & other ) const

inline

Definition at line 175 of file SubstanceGroup.h.

◆ setOwningMol()

void RDKit::SubstanceGroup::setOwningMol ( ROMol * mol )

Set owning molecule This only updates atoms and bonds; parent sgroup has to be updated independently, since parent might not exist at the time this is called.

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

SubstanceGroup.h

Classes

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ Bracket

Member Enumeration Documentation

◆ BondType

Constructor & Destructor Documentation

◆ SubstanceGroup() [1/4]

◆ SubstanceGroup() [2/4]

◆ SubstanceGroup() [3/4]

◆ SubstanceGroup() [4/4]

◆ ~SubstanceGroup()

Member Function Documentation

◆ addAtomWithBookmark()

◆ addAtomWithIdx()

◆ addAttachPoint()

◆ addBondWithBookmark()

◆ addBondWithIdx()

◆ addBracket()

◆ addCState()

◆ addParentAtomWithBookmark()

◆ addParentAtomWithIdx()

◆ adjustToRemovedAtom()

◆ adjustToRemovedBond()

◆ clearAttachPoints()

◆ clearBrackets()

◆ clearCStates()

◆ getAtoms()

◆ getAttachPoints()

◆ getBonds()

◆ getBondType()

◆ getBrackets()

◆ getCStates()

◆ getIndexInMol()

◆ getOwningMol()

◆ getParentAtoms()

◆ hasOwningMol()

◆ includesAtom()

◆ includesBond()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator==()

◆ setOwningMol()