// // Copyright (c) 2017-2021, Novartis Institutes for BioMedical Research Inc. // and other RDKit contributors // // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above // copyright notice, this list of conditions and the following // disclaimer in the documentation and/or other materials provided // with the distribution. // * Neither the name of Novartis Institutes for BioMedical Research Inc. // nor the names of its contributors may be used to endorse or promote // products derived from this software without specific prior written // permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // #include "RGroupDecomp.h" #include "RGroupDecompData.h" #include #include #include #include #include #include #include #include #include #include // #define VERBOSE 1 namespace RDKit { // Attachment Points // labeled cores => isotopes // atom mappings // atom indices => use -1 - atom index, range is [-1, ...., -num_atoms] const std::string RLABEL = "tempRlabel"; const std::string RLABEL_TYPE = "tempRlabelType"; const std::string RLABEL_CORE_INDEX = "rLabelCoreIndex"; const std::string SIDECHAIN_RLABELS = "sideChainRlabels"; const std::string done = "RLABEL_PROCESSED"; const std::string CORE = "Core"; const std::string RPREFIX = "R"; const std::string _rgroupInputDummy = "_rgroupInputDummy"; namespace { void ADD_MATCH(R_DECOMP &match, int rlabel) { if (match.find(rlabel) == match.end()) { match[rlabel] = boost::make_shared(); } } } // namespace RGroupDecomposition::RGroupDecomposition( const ROMol &inputCore, const RGroupDecompositionParameters ¶ms) : data(new RGroupDecompData(inputCore, params)) {} RGroupDecomposition::RGroupDecomposition( const std::vector &cores, const RGroupDecompositionParameters ¶ms) : data(new RGroupDecompData(cores, params)) {} RGroupDecomposition::~RGroupDecomposition() { delete data; } int RGroupDecomposition::add(const ROMol &inmol) { // get the sidechains if possible // Add hs for better symmetrization RWMol mol(inmol); const bool explicitOnly = false; const bool addCoords = true; MolOps::addHs(mol, explicitOnly, addCoords); // mark any wildcards in input molecule: for (auto &atom : mol.atoms()) { if (atom->getAtomicNum() == 0) { atom->setProp(_rgroupInputDummy, true); // clean any existing R group numbers atom->setIsotope(0); atom->setAtomMapNum(0); if (atom->hasProp(common_properties::_MolFileRLabel)) { atom->clearProp(common_properties::_MolFileRLabel); } atom->setProp(common_properties::dummyLabel, "*"); } } int core_idx = 0; const RCore *rcore = nullptr; std::vector tmatches; std::vector tmatches_filtered; // Find the first matching core (onlyMatchAtRGroups) // or the first core that requires the smallest number // of newly added labels and is a superstructure of // the first matching core int global_min_heavy_nbrs = -1; SubstructMatchParameters sssparams(params().substructmatchParams); sssparams.uniquify = false; sssparams.recursionPossible = true; for (const auto &core : data->cores) { { // matching the core to the molecule is a two step process // First match to a reduced representation (the core minus terminal // R-groups). Next, match the R-groups. We do this as the core may not be // a substructure match for the molecule if a single molecule atom matches // 2 RGroup attachments (see https://github.com/rdkit/rdkit/pull/4002) // match the reduced represenation: std::vector baseMatches = SubstructMatch(mol, *core.second.matchingMol, sssparams); tmatches.clear(); for (const auto &baseMatch : baseMatches) { // Match the R Groups auto matchesWithDummy = core.second.matchTerminalUserRGroups(mol, baseMatch, sssparams); tmatches.insert(tmatches.end(), matchesWithDummy.cbegin(), matchesWithDummy.cend()); } } if (tmatches.empty()) { continue; } std::vector tmatches_heavy_nbrs(tmatches.size(), 0); size_t i = 0; for (const auto &mv : tmatches) { bool passes_filter = data->params.onlyMatchAtRGroups; boost::dynamic_bitset<> target_match_indices(mol.getNumAtoms()); for (const auto &match : mv) { target_match_indices[match.second] = 1; } // target atoms that map to user defined R-groups std::vector targetAttachments; for (const auto &match : mv) { const Atom *atm = mol.getAtomWithIdx(match.second); // is this a labelled rgroup or not? if (!core.second.isCoreAtomUserLabelled(match.first)) { // nope... if any neighbor is not part of the substructure // make sure we are a hydrogen, otherwise, skip the match for (const auto &nbri : boost::make_iterator_range(mol.getAtomNeighbors(atm))) { const auto &nbr = mol[nbri]; if (nbr->getAtomicNum() != 1 && !target_match_indices[nbr->getIdx()]) { if (data->params.onlyMatchAtRGroups) { passes_filter = false; break; } else { ++tmatches_heavy_nbrs[i]; } } } } else { // labelled R-group if (core.second.isTerminalRGroupWithUserLabel(match.first)) { targetAttachments.push_back(match.second); } } if (!passes_filter && data->params.onlyMatchAtRGroups) { break; } if (passes_filter && data->params.onlyMatchAtRGroups) { for (auto attachmentIdx : targetAttachments) { if (!core.second.checkAllBondsToAttachmentPointPresent( mol, attachmentIdx, mv)) { passes_filter = false; break; } } } } if (passes_filter) { tmatches_filtered.push_back(mv); } ++i; } if (!data->params.onlyMatchAtRGroups) { int min_heavy_nbrs = *std::min_element(tmatches_heavy_nbrs.begin(), tmatches_heavy_nbrs.end()); if (!rcore || (min_heavy_nbrs < global_min_heavy_nbrs && !SubstructMatch(*core.second.core, *rcore->core, sssparams) .empty())) { i = 0; tmatches_filtered.clear(); for (const auto heavy_nbrs : tmatches_heavy_nbrs) { if (heavy_nbrs <= min_heavy_nbrs) { tmatches_filtered.push_back(std::move(tmatches[i])); } ++i; } global_min_heavy_nbrs = min_heavy_nbrs; rcore = &core.second; core_idx = core.first; if (global_min_heavy_nbrs == 0) { break; } } } else if (!tmatches_filtered.empty()) { rcore = &core.second; core_idx = core.first; break; } } tmatches = std::move(tmatches_filtered); if (tmatches.size() > 1) { if (data->params.matchingStrategy == NoSymmetrization) { tmatches.resize(1); } else if (data->matches.size() == 0) { // Greedy strategy just grabs the first match and // takes the best matches from the rest if (data->params.matchingStrategy == Greedy) { tmatches.resize(1); } } } if (rcore == nullptr) { BOOST_LOG(rdDebugLog) << "No core matches" << std::endl; return -1; } // strategies // ========== // Exhaustive - saves all matches and optimizes later exhaustive // May never finish due to combinatorial complexity // Greedy - matches to *FIRST* available match // GreedyChunks - default - process every N chunks // Should probably scan all mols first to find match with // smallest number of matches... std::vector potentialMatches; std::unique_ptr tMol; for (const auto &tmatche : tmatches) { const bool replaceDummies = false; const bool labelByIndex = true; const bool requireDummyMatch = false; bool hasCoreDummies = false; auto coreCopy = rcore->replaceCoreAtomsWithMolMatches(hasCoreDummies, mol, tmatche); tMol.reset(replaceCore(mol, *coreCopy, tmatche, replaceDummies, labelByIndex, requireDummyMatch)); #ifdef VERBOSE std::cerr << "Core Match core_idx " << core_idx << " idx " << data->matches.size() << ": " << MolToSmarts(*coreCopy) << std::endl; #endif if (tMol) { #ifdef VERBOSE std::cerr << "All Fragments " << MolToSmiles(*tMol) << std::endl; #endif R_DECOMP match; // rlabel rgroups MOL_SPTR_VECT fragments = MolOps::getMolFrags(*tMol, false); std::set coreAtomAnyMatched; for (size_t i = 0; i < fragments.size(); ++i) { std::vector attachments; boost::shared_ptr &newMol = fragments[i]; newMol->setProp("core", core_idx); newMol->setProp("idx", data->matches.size()); newMol->setProp("frag_idx", i); #ifdef VERBOSE std::cerr << "Fragment " << MolToSmiles(*newMol) << std::endl; #endif for (auto at : newMol->atoms()) { unsigned int elno = at->getAtomicNum(); if (elno == 0) { unsigned int index = at->getIsotope(); // this is the index into the core // it messes up when there are multiple ? if (!at->hasProp(_rgroupInputDummy)) { int rlabel; auto coreAtom = rcore->core->getAtomWithIdx(index); coreAtomAnyMatched.insert(index); if (coreAtom->getPropIfPresent(RLABEL, rlabel)) { std::vector rlabelsOnSideChain; at->getPropIfPresent(SIDECHAIN_RLABELS, rlabelsOnSideChain); rlabelsOnSideChain.push_back(rlabel); at->setProp(SIDECHAIN_RLABELS, rlabelsOnSideChain); data->labels.insert(rlabel); // keep track of all labels used attachments.push_back(rlabel); } } else { // restore input wildcard at->clearProp(_rgroupInputDummy); } } } if (attachments.size() > 0) { // reject multiple attachments? // what to do with labelled cores ? std::string newCoreSmi = MolToSmiles(*newMol, true); for (size_t attach_idx = 0; attach_idx < attachments.size(); ++attach_idx) { int rlabel = attachments[attach_idx]; ADD_MATCH(match, rlabel); match[rlabel]->add(newMol, attachments); #ifdef VERBOSE std::cerr << "Fragment " << i << " R" << rlabel << " " << MolToSmiles(*newMol) << std::endl; #endif } } else { // special case, only one fragment if (fragments.size() == 1) { // need to make a new core // remove the sidechains // GJ I think if we ever get here that it's really an error and I // believe that I've fixed the case where this code was called. // Still, I'm too scared to delete the block. RWMol newCore(mol); for (const auto &mvpair : tmatche) { const Atom *coreAtm = rcore->core->getAtomWithIdx(mvpair.first); Atom *newCoreAtm = newCore.getAtomWithIdx(mvpair.second); int rlabel; if (coreAtm->getPropIfPresent(RLABEL, rlabel)) { newCoreAtm->setProp(RLABEL, rlabel); } newCoreAtm->setProp("keep", true); } newCore.beginBatchEdit(); for (const auto atom : newCore.atoms()) { if (!atom->hasProp("keep")) { newCore.removeAtom(atom); } } newCore.commitBatchEdit(); if (newCore.getNumAtoms()) { std::string newCoreSmi = MolToSmiles(newCore, true); // add a new core if possible auto newcore = data->newCores.find(newCoreSmi); int core_idx = 0; if (newcore == data->newCores.end()) { core_idx = data->newCores[newCoreSmi] = data->newCoreLabel--; data->cores[core_idx] = RCore(newCore); return add(inmol); } } } } } if (match.size()) { auto numberUserGroupsInMatch = std::accumulate( match.begin(), match.end(), 0, [](int sum, std::pair> p) { return p.first > 0 && !p.second->is_hydrogen ? ++sum : sum; }); int numberMissingUserGroups = rcore->numberUserRGroups - numberUserGroupsInMatch; CHECK_INVARIANT(numberMissingUserGroups >= 0, "Data error in missing user rgroup count"); potentialMatches.emplace_back( core_idx, numberMissingUserGroups, match, hasCoreDummies || !data->params.onlyMatchAtRGroups ? coreCopy : nullptr); } } } if (potentialMatches.size() == 0) { BOOST_LOG(rdDebugLog) << "No attachment points in side chains" << std::endl; return -2; } // in case the value ends up being changed in a future version of the code: if (data->prunePermutations) { data->permutationProduct = 1; } if (data->params.matchingStrategy != GA) { size_t N = data->permutationProduct; for (auto matche = data->matches.begin() + data->previousMatchSize; matche != data->matches.end(); ++matche) { size_t sz = matche->size(); N *= sz; } // oops, exponential is a pain if (N * potentialMatches.size() > 100000) { data->permutationProduct = N; data->process(data->prunePermutations); } } data->matches.push_back(potentialMatches); if (data->matches.size()) { if (data->params.matchingStrategy & Greedy || (data->params.matchingStrategy & GreedyChunks && data->matches.size() > 1 && data->matches.size() % data->params.chunkSize == 0)) { data->process(data->prunePermutations); } } return data->matches.size() - 1; } bool RGroupDecomposition::process() { return processAndScore().success; } RGroupDecompositionProcessResult RGroupDecomposition::processAndScore() { try { const bool finalize = true; return data->process(data->prunePermutations, finalize); } catch (...) { return RGroupDecompositionProcessResult(false, -1); } } std::vector RGroupDecomposition::getRGroupLabels() const { // this is a bit of a cheat RGroupColumns cols = getRGroupsAsColumns(); std::vector labels; for (auto it : cols) { labels.push_back(it.first); } std::sort(labels.begin(), labels.end()); return labels; } RWMOL_SPTR RGroupDecomposition::outputCoreMolecule( const RGroupMatch &match, const UsedLabelMap &usedLabelMap) const { const auto &core = data->cores[match.core_idx]; if (!match.matchedCore) { return core.labelledCore; } auto coreWithMatches = core.coreWithMatches(*match.matchedCore); for (auto atomIdx = coreWithMatches->getNumAtoms(); atomIdx--;) { auto atom = coreWithMatches->getAtomWithIdx(atomIdx); if (atom->getAtomicNum()) { continue; } auto label = data->getRlabel(atom); Atom *nbrAtom = nullptr; for (const auto &nbri : boost::make_iterator_range(coreWithMatches->getAtomNeighbors(atom))) { nbrAtom = (*coreWithMatches)[nbri]; break; } if (nbrAtom) { bool isUserDefinedLabel = usedLabelMap.isUserDefined(label); auto numExplicitHs = nbrAtom->getNumExplicitHs(); if (usedLabelMap.getIsUsed(label)) { if (numExplicitHs) { nbrAtom->setNumExplicitHs(numExplicitHs - 1); } } else if (!isUserDefinedLabel || data->params.removeAllHydrogenRGroupsAndLabels) { coreWithMatches->removeAtom(atomIdx); // if we remove an unused label from an aromatic atom, // we need to check whether we need to adjust its explicit // H count, or it will fail to kekulize if (isUserDefinedLabel && nbrAtom->getIsAromatic()) { nbrAtom->updatePropertyCache(false); if (!numExplicitHs) { nbrAtom->setNumExplicitHs(nbrAtom->getExplicitValence() - nbrAtom->getDegree()); } } } nbrAtom->updatePropertyCache(false); } } return coreWithMatches; } RGroupRows RGroupDecomposition::getRGroupsAsRows() const { std::vector permutation = data->GetCurrentBestPermutation(); RGroupRows groups; auto usedLabelMap = UsedLabelMap(data->finalRlabelMapping); for (auto it = permutation.begin(); it != permutation.end(); ++it) { auto Rs_seen(usedLabelMap); // make a new rgroup entry groups.push_back(RGroupRow()); RGroupRow &out_rgroups = groups.back(); const R_DECOMP &in_rgroups = it->rgroups; for (const auto &rgroup : in_rgroups) { const auto realLabel = data->finalRlabelMapping.find(rgroup.first); CHECK_INVARIANT(realLabel != data->finalRlabelMapping.end(), "unprocessed rlabel, please call process() first."); Rs_seen.setIsUsed(realLabel->second); out_rgroups[RPREFIX + std::to_string(realLabel->second)] = rgroup.second->combinedMol; } out_rgroups[CORE] = outputCoreMolecule(*it, Rs_seen); } return groups; } //! return rgroups in column order group[attachment_point][molidx] = ROMol RGroupColumns RGroupDecomposition::getRGroupsAsColumns() const { std::vector permutation = data->GetCurrentBestPermutation(); RGroupColumns groups; std::unordered_set rGroupWithRealMol{CORE}; auto usedLabelMap = UsedLabelMap(data->finalRlabelMapping); unsigned int molidx = 0; for (auto it = permutation.begin(); it != permutation.end(); ++it, ++molidx) { auto Rs_seen(usedLabelMap); const R_DECOMP &in_rgroups = it->rgroups; for (const auto &rgroup : in_rgroups) { const auto realLabel = data->finalRlabelMapping.find(rgroup.first); CHECK_INVARIANT(realLabel != data->finalRlabelMapping.end(), "unprocessed rlabel, please call process() first."); CHECK_INVARIANT(rgroup.second->combinedMol->hasProp(done), "Not done! Call process()"); CHECK_INVARIANT(!Rs_seen.getIsUsed(realLabel->second), "R group label appears multiple times!"); Rs_seen.setIsUsed(realLabel->second); std::string r = RPREFIX + std::to_string(realLabel->second); RGroupColumn &col = groups[r]; if (molidx && col.size() < molidx - 1) { col.resize(molidx - 1); } col.push_back(rgroup.second->combinedMol); rGroupWithRealMol.insert(r); } groups[CORE].push_back(outputCoreMolecule(*it, Rs_seen)); // add empty entries to columns where this molecule didn't appear for (const auto &realLabel : data->finalRlabelMapping) { if (!Rs_seen.getIsUsed(realLabel.second)) { std::string r = RPREFIX + std::to_string(realLabel.second); groups[r].push_back(boost::make_shared()); } } } // purge R-group entries that have no mols for (auto it = groups.begin(); it != groups.end();) { auto itToErase = groups.end(); if (!rGroupWithRealMol.count(it->first)) { itToErase = it; } ++it; if (itToErase != groups.end()) { groups.erase(itToErase); } } return groups; } const RGroupDecompositionParameters &RGroupDecomposition::params() const { return data->params; } namespace { std::vector Decomp(RGroupDecomposition &decomp, const std::vector &mols) { auto t0 = std::chrono::steady_clock::now(); std::vector unmatched; for (size_t i = 0; i < mols.size(); ++i) { int v = decomp.add(*mols[i].get()); if (v == -1) { unmatched.push_back(i); } checkForTimeout(t0, decomp.params().timeout); } decomp.process(); return unmatched; } } // namespace unsigned int RGroupDecompose(const std::vector &cores, const std::vector &mols, RGroupRows &rows, std::vector *unmatchedIndices, const RGroupDecompositionParameters &options) { RGroupDecomposition decomp(cores, options); std::vector unmatched = Decomp(decomp, mols); if (unmatchedIndices) { *unmatchedIndices = unmatched; } rows = decomp.getRGroupsAsRows(); return mols.size() - unmatched.size(); } unsigned int RGroupDecompose(const std::vector &cores, const std::vector &mols, RGroupColumns &columns, std::vector *unmatchedIndices, const RGroupDecompositionParameters &options) { RGroupDecomposition decomp(cores, options); std::vector unmatched = Decomp(decomp, mols); if (unmatchedIndices) { *unmatchedIndices = unmatched; } columns = decomp.getRGroupsAsColumns(); return mols.size() - unmatched.size(); } } // namespace RDKit