1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231
|
//
// Copyright (c) 2017-2021, Novartis Institutes for BioMedical Research Inc.
// and other RDKit contributors
//
// @@ All Rights Reserved @@
// This file is part of the RDKit.
// The contents are covered by the terms of the BSD license
// which is included in the file license.txt, found at the root
// of the RDKit source tree.
//
#include <RDGeneral/export.h>
#ifndef RDKIT_RGROUPDECOMP_H
#define RDKIT_RGROUPDECOMP_H
#include "../RDKitBase.h"
#include <GraphMol/Substruct/SubstructMatch.h>
#include <chrono>
namespace RDKit {
//! Compute the isomorphic degenerative points in the
//! molecule. These are points that are symmetrically
//! equivalent.
/*!
\param mol Molecule to compute the degenerative points
\return the set of degenerative points (set<unsigned int>)
*/
typedef enum {
IsotopeLabels = 0x01,
AtomMapLabels = 0x02,
AtomIndexLabels = 0x04,
RelabelDuplicateLabels = 0x08,
MDLRGroupLabels = 0x10,
DummyAtomLabels = 0x20, // These are rgroups but will get relabelled
AutoDetect = 0xFF,
} RGroupLabels;
typedef enum {
Greedy = 0x01,
GreedyChunks = 0x02,
Exhaustive = 0x04, // not really useful for large sets
NoSymmetrization = 0x08,
GA = 0x10,
} RGroupMatching;
typedef enum {
AtomMap = 0x01,
Isotope = 0x02,
MDLRGroup = 0x04,
} RGroupLabelling;
typedef enum {
// DEPRECATED, remove the following line in release 2021.03
None = 0x0,
NoAlignment = 0x0,
MCS = 0x01,
} RGroupCoreAlignment;
typedef enum {
Match = 0x1,
FingerprintVariance = 0x4,
} RGroupScore;
struct RDKIT_RGROUPDECOMPOSITION_EXPORT RGroupDecompositionProcessResult {
const bool success;
const double score;
RGroupDecompositionProcessResult(const bool success, const double score)
: success(success), score(score) {}
};
struct RGroupMatch;
struct RDKIT_RGROUPDECOMPOSITION_EXPORT RGroupDecompositionParameters {
unsigned int labels = AutoDetect;
unsigned int matchingStrategy = GreedyChunks;
unsigned int scoreMethod = Match;
unsigned int rgroupLabelling = AtomMap | MDLRGroup;
unsigned int alignment = MCS;
unsigned int chunkSize = 5;
//! only allow rgroup decomposition at the specified rgroups
bool onlyMatchAtRGroups = false;
//! remove all user-defined rgroups that only have hydrogens
bool removeAllHydrogenRGroups = true;
//! remove all user-defined rgroups that only have hydrogens,
//! and also remove the corresponding labels from the core
bool removeAllHydrogenRGroupsAndLabels = true;
//! remove all hydrogens from the output molecules
bool removeHydrogensPostMatch = true;
//! allow labelled Rgroups of degree 2 or more
bool allowNonTerminalRGroups = false;
// unlabelled core atoms can have multiple rgroups
bool allowMultipleRGroupsOnUnlabelled = false;
double timeout = -1.0; ///< timeout in seconds. <=0 indicates no timeout
// Determine how to assign the rgroup labels from the given core
unsigned int autoGetLabels(const RWMol &);
// Prepare the core for substructure searching and rgroup assignment
bool prepareCore(RWMol &, const RWMol *alignCore);
// Add r groups to unlabelled atoms if allowMultipleRGroupsOnUnlabelled is set
void addDummyAtomsToUnlabelledCoreAtoms(RWMol &core);
// Parameters specific to GA
// GA population size or -1 to use best guess
int gaPopulationSize = -1;
// GA maximum number of operations or -1 to use best guess
int gaMaximumOperations = -1;
// GA number of operations permitted without improvement before exiting (-1
// for best guess)
int gaNumberOperationsWithoutImprovement = -1;
// GA random number seed (-1 for default, -2 for random seed)
int gaRandomSeed = -1;
// Number of runs
int gaNumberRuns = 1;
// Sequential or parallel runs?
#ifdef RDK_BUILD_THREADSAFE_SSS
bool gaParallelRuns = true;
#else
bool gaParallelRuns = false;
#endif
// Controls the way substructure matching with the core is done
SubstructMatchParameters substructmatchParams;
RGroupDecompositionParameters() { substructmatchParams.useChirality = true; }
private:
int indexOffset{-1};
void checkNonTerminal(const Atom &atom) const;
};
typedef std::map<std::string, ROMOL_SPTR> RGroupRow;
typedef std::vector<ROMOL_SPTR> RGroupColumn;
typedef std::vector<RGroupRow> RGroupRows;
typedef std::map<std::string, RGroupColumn> RGroupColumns;
class UsedLabelMap {
public:
UsedLabelMap(const std::map<int, int> &mapping) {
for (const auto &rl : mapping) {
d_map[rl.second] = std::make_pair(false, (rl.first > 0));
}
}
bool has(int label) const { return d_map.find(label) != d_map.end(); }
bool getIsUsed(int label) const { return d_map.at(label).first; }
void setIsUsed(int label) { d_map[label].first = true; }
bool isUserDefined(int label) const { return d_map.at(label).second; }
private:
std::map<int, std::pair<bool, bool>> d_map;
};
struct RGroupDecompData;
class RDKIT_RGROUPDECOMPOSITION_EXPORT RGroupDecomposition {
private:
RGroupDecompData *data; // implementation details
RGroupDecomposition(const RGroupDecomposition &); // no copy construct
RGroupDecomposition &operator=(
const RGroupDecomposition &); // Prevent assignment
RWMOL_SPTR outputCoreMolecule(const RGroupMatch &match,
const UsedLabelMap &usedRGroupMap) const;
std::map<int, bool> getBlankRGroupMap() const;
public:
RGroupDecomposition(const ROMol &core,
const RGroupDecompositionParameters ¶ms =
RGroupDecompositionParameters());
RGroupDecomposition(const std::vector<ROMOL_SPTR> &cores,
const RGroupDecompositionParameters ¶ms =
RGroupDecompositionParameters());
~RGroupDecomposition();
//! Returns the index of the added molecule in the RGroupDecomposition
/// or a negative error code
/// :param mol: Molecule to add to the decomposition
/// :result: index of the molecle or
/// -1 if none of the core matches
/// -2 if the matched molecule has no sidechains, i.e. is the
/// same as the scaffold
int add(const ROMol &mol);
RGroupDecompositionProcessResult processAndScore();
bool process();
const RGroupDecompositionParameters ¶ms() const;
//! return the current group labels
std::vector<std::string> getRGroupLabels() const;
//! return rgroups in row order group[row][attachment_point] = ROMol
RGroupRows getRGroupsAsRows() const;
//! return rgroups in column order group[attachment_point][row] = ROMol
RGroupColumns getRGroupsAsColumns() const;
};
RDKIT_RGROUPDECOMPOSITION_EXPORT unsigned int RGroupDecompose(
const std::vector<ROMOL_SPTR> &cores, const std::vector<ROMOL_SPTR> &mols,
RGroupRows &rows, std::vector<unsigned int> *unmatched = nullptr,
const RGroupDecompositionParameters &options =
RGroupDecompositionParameters());
RDKIT_RGROUPDECOMPOSITION_EXPORT unsigned int RGroupDecompose(
const std::vector<ROMOL_SPTR> &cores, const std::vector<ROMOL_SPTR> &mols,
RGroupColumns &columns, std::vector<unsigned int> *unmatched = nullptr,
const RGroupDecompositionParameters &options =
RGroupDecompositionParameters());
inline bool checkForTimeout(const std::chrono::steady_clock::time_point &t0,
double timeout, bool throwOnTimeout = true) {
if (timeout <= 0) {
return false;
}
auto t1 = std::chrono::steady_clock::now();
std::chrono::duration<double> elapsed = t1 - t0;
if (elapsed.count() >= timeout) {
if (throwOnTimeout) {
throw std::runtime_error("operation timed out");
}
return true;
}
return false;
}
} // namespace RDKit
#endif
|