rdkit-headers 2022.3.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (320) hide show
  1. rdkit_headers/__init__.py +13 -0
  2. rdkit_headers/include/rdkit/CIPLabeler/CIPLabeler.h +59 -0
  3. rdkit_headers/include/rdkit/CIPLabeler/TooManyNodesException.h +28 -0
  4. rdkit_headers/include/rdkit/Catalogs/Catalog.h +461 -0
  5. rdkit_headers/include/rdkit/Catalogs/CatalogEntry.h +48 -0
  6. rdkit_headers/include/rdkit/Catalogs/CatalogParams.h +42 -0
  7. rdkit_headers/include/rdkit/ChemicalFeatures/ChemicalFeature.h +38 -0
  8. rdkit_headers/include/rdkit/ChemicalFeatures/FreeChemicalFeature.h +97 -0
  9. rdkit_headers/include/rdkit/DataManip/MetricMatrixCalc/MetricFuncs.h +54 -0
  10. rdkit_headers/include/rdkit/DataManip/MetricMatrixCalc/MetricMatrixCalc.h +106 -0
  11. rdkit_headers/include/rdkit/DataStructs/BitOps.h +337 -0
  12. rdkit_headers/include/rdkit/DataStructs/BitVect.h +68 -0
  13. rdkit_headers/include/rdkit/DataStructs/BitVectUtils.h +35 -0
  14. rdkit_headers/include/rdkit/DataStructs/BitVects.h +25 -0
  15. rdkit_headers/include/rdkit/DataStructs/DatastructsException.h +31 -0
  16. rdkit_headers/include/rdkit/DataStructs/DatastructsStreamOps.h +72 -0
  17. rdkit_headers/include/rdkit/DataStructs/DiscreteDistMat.h +30 -0
  18. rdkit_headers/include/rdkit/DataStructs/DiscreteValueVect.h +146 -0
  19. rdkit_headers/include/rdkit/DataStructs/ExplicitBitVect.h +96 -0
  20. rdkit_headers/include/rdkit/DataStructs/FPBReader.h +281 -0
  21. rdkit_headers/include/rdkit/DataStructs/MultiFPBReader.h +213 -0
  22. rdkit_headers/include/rdkit/DataStructs/SparseBitVect.h +101 -0
  23. rdkit_headers/include/rdkit/DataStructs/SparseIntVect.h +571 -0
  24. rdkit_headers/include/rdkit/DataStructs/base64.h +41 -0
  25. rdkit_headers/include/rdkit/DistGeom/BoundsMatrix.h +121 -0
  26. rdkit_headers/include/rdkit/DistGeom/ChiralSet.h +58 -0
  27. rdkit_headers/include/rdkit/DistGeom/ChiralViolationContrib.h +96 -0
  28. rdkit_headers/include/rdkit/DistGeom/DistGeomUtils.h +195 -0
  29. rdkit_headers/include/rdkit/DistGeom/DistViolationContrib.h +54 -0
  30. rdkit_headers/include/rdkit/DistGeom/FourthDimContrib.h +65 -0
  31. rdkit_headers/include/rdkit/DistGeom/TriangleSmooth.h +36 -0
  32. rdkit_headers/include/rdkit/Features/Feature.h +96 -0
  33. rdkit_headers/include/rdkit/ForceField/Contrib.h +40 -0
  34. rdkit_headers/include/rdkit/ForceField/ForceField.h +253 -0
  35. rdkit_headers/include/rdkit/ForceField/MMFF/AngleBend.h +78 -0
  36. rdkit_headers/include/rdkit/ForceField/MMFF/AngleConstraint.h +64 -0
  37. rdkit_headers/include/rdkit/ForceField/MMFF/BondStretch.h +67 -0
  38. rdkit_headers/include/rdkit/ForceField/MMFF/Contribs.h +26 -0
  39. rdkit_headers/include/rdkit/ForceField/MMFF/DistanceConstraint.h +61 -0
  40. rdkit_headers/include/rdkit/ForceField/MMFF/Nonbonded.h +105 -0
  41. rdkit_headers/include/rdkit/ForceField/MMFF/OopBend.h +65 -0
  42. rdkit_headers/include/rdkit/ForceField/MMFF/Params.h +1134 -0
  43. rdkit_headers/include/rdkit/ForceField/MMFF/PositionConstraint.h +55 -0
  44. rdkit_headers/include/rdkit/ForceField/MMFF/StretchBend.h +70 -0
  45. rdkit_headers/include/rdkit/ForceField/MMFF/TorsionAngle.h +79 -0
  46. rdkit_headers/include/rdkit/ForceField/MMFF/TorsionConstraint.h +70 -0
  47. rdkit_headers/include/rdkit/ForceField/UFF/AngleBend.h +92 -0
  48. rdkit_headers/include/rdkit/ForceField/UFF/AngleConstraint.h +64 -0
  49. rdkit_headers/include/rdkit/ForceField/UFF/BondStretch.h +83 -0
  50. rdkit_headers/include/rdkit/ForceField/UFF/Contribs.h +23 -0
  51. rdkit_headers/include/rdkit/ForceField/UFF/DistanceConstraint.h +62 -0
  52. rdkit_headers/include/rdkit/ForceField/UFF/Inversion.h +81 -0
  53. rdkit_headers/include/rdkit/ForceField/UFF/Nonbonded.h +87 -0
  54. rdkit_headers/include/rdkit/ForceField/UFF/Params.h +153 -0
  55. rdkit_headers/include/rdkit/ForceField/UFF/PositionConstraint.h +55 -0
  56. rdkit_headers/include/rdkit/ForceField/UFF/TorsionAngle.h +115 -0
  57. rdkit_headers/include/rdkit/ForceField/UFF/TorsionConstraint.h +70 -0
  58. rdkit_headers/include/rdkit/Geometry/Grid3D.h +55 -0
  59. rdkit_headers/include/rdkit/Geometry/GridUtils.h +64 -0
  60. rdkit_headers/include/rdkit/Geometry/Transform.h +19 -0
  61. rdkit_headers/include/rdkit/Geometry/Transform2D.h +85 -0
  62. rdkit_headers/include/rdkit/Geometry/Transform3D.h +101 -0
  63. rdkit_headers/include/rdkit/Geometry/UniformGrid3D.h +217 -0
  64. rdkit_headers/include/rdkit/Geometry/Utils.h +97 -0
  65. rdkit_headers/include/rdkit/Geometry/point.h +585 -0
  66. rdkit_headers/include/rdkit/GraphMol/Abbreviations/Abbreviations.h +132 -0
  67. rdkit_headers/include/rdkit/GraphMol/Atom.h +449 -0
  68. rdkit_headers/include/rdkit/GraphMol/AtomIterators.h +212 -0
  69. rdkit_headers/include/rdkit/GraphMol/Bond.h +393 -0
  70. rdkit_headers/include/rdkit/GraphMol/BondIterators.h +75 -0
  71. rdkit_headers/include/rdkit/GraphMol/Canon.h +130 -0
  72. rdkit_headers/include/rdkit/GraphMol/ChemReactions/Enumerate/CartesianProduct.h +147 -0
  73. rdkit_headers/include/rdkit/GraphMol/ChemReactions/Enumerate/Enumerate.h +187 -0
  74. rdkit_headers/include/rdkit/GraphMol/ChemReactions/Enumerate/EnumerateBase.h +200 -0
  75. rdkit_headers/include/rdkit/GraphMol/ChemReactions/Enumerate/EnumerateTypes.h +59 -0
  76. rdkit_headers/include/rdkit/GraphMol/ChemReactions/Enumerate/EnumerationPickler.h +60 -0
  77. rdkit_headers/include/rdkit/GraphMol/ChemReactions/Enumerate/EnumerationStrategyBase.h +227 -0
  78. rdkit_headers/include/rdkit/GraphMol/ChemReactions/Enumerate/RandomSample.h +163 -0
  79. rdkit_headers/include/rdkit/GraphMol/ChemReactions/Enumerate/RandomSampleAllBBs.h +184 -0
  80. rdkit_headers/include/rdkit/GraphMol/ChemReactions/PreprocessRxn.h +64 -0
  81. rdkit_headers/include/rdkit/GraphMol/ChemReactions/Reaction.h +491 -0
  82. rdkit_headers/include/rdkit/GraphMol/ChemReactions/ReactionFingerprints.h +147 -0
  83. rdkit_headers/include/rdkit/GraphMol/ChemReactions/ReactionParser.h +274 -0
  84. rdkit_headers/include/rdkit/GraphMol/ChemReactions/ReactionPickler.h +119 -0
  85. rdkit_headers/include/rdkit/GraphMol/ChemReactions/ReactionRunner.h +116 -0
  86. rdkit_headers/include/rdkit/GraphMol/ChemReactions/ReactionUtils.h +74 -0
  87. rdkit_headers/include/rdkit/GraphMol/ChemReactions/SanitizeRxn.h +169 -0
  88. rdkit_headers/include/rdkit/GraphMol/ChemTransforms/ChemTransforms.h +270 -0
  89. rdkit_headers/include/rdkit/GraphMol/ChemTransforms/MolFragmenter.h +120 -0
  90. rdkit_headers/include/rdkit/GraphMol/Chirality.h +137 -0
  91. rdkit_headers/include/rdkit/GraphMol/Conformer.h +183 -0
  92. rdkit_headers/include/rdkit/GraphMol/CoordGen.h +195 -0
  93. rdkit_headers/include/rdkit/GraphMol/Depictor/DepictUtils.h +366 -0
  94. rdkit_headers/include/rdkit/GraphMol/Depictor/EmbeddedFrag.h +544 -0
  95. rdkit_headers/include/rdkit/GraphMol/Depictor/RDDepictor.h +284 -0
  96. rdkit_headers/include/rdkit/GraphMol/Deprotect/Deprotect.h +105 -0
  97. rdkit_headers/include/rdkit/GraphMol/Descriptors/AUTOCORR2D.h +49 -0
  98. rdkit_headers/include/rdkit/GraphMol/Descriptors/AUTOCORR3D.h +51 -0
  99. rdkit_headers/include/rdkit/GraphMol/Descriptors/AtomFeat.h +39 -0
  100. rdkit_headers/include/rdkit/GraphMol/Descriptors/BCUT.h +66 -0
  101. rdkit_headers/include/rdkit/GraphMol/Descriptors/ConnectivityDescriptors.h +211 -0
  102. rdkit_headers/include/rdkit/GraphMol/Descriptors/CoulombMat.h +42 -0
  103. rdkit_headers/include/rdkit/GraphMol/Descriptors/Crippen.h +137 -0
  104. rdkit_headers/include/rdkit/GraphMol/Descriptors/Data3Ddescriptors.h +55 -0
  105. rdkit_headers/include/rdkit/GraphMol/Descriptors/EEM.h +59 -0
  106. rdkit_headers/include/rdkit/GraphMol/Descriptors/GETAWAY.h +51 -0
  107. rdkit_headers/include/rdkit/GraphMol/Descriptors/Lipinski.h +169 -0
  108. rdkit_headers/include/rdkit/GraphMol/Descriptors/MORSE.h +50 -0
  109. rdkit_headers/include/rdkit/GraphMol/Descriptors/MQN.h +47 -0
  110. rdkit_headers/include/rdkit/GraphMol/Descriptors/MolData3Ddescriptors.h +62 -0
  111. rdkit_headers/include/rdkit/GraphMol/Descriptors/MolDescriptors.h +86 -0
  112. rdkit_headers/include/rdkit/GraphMol/Descriptors/MolDescriptors3D.h +25 -0
  113. rdkit_headers/include/rdkit/GraphMol/Descriptors/MolSurf.h +120 -0
  114. rdkit_headers/include/rdkit/GraphMol/Descriptors/PBF.h +60 -0
  115. rdkit_headers/include/rdkit/GraphMol/Descriptors/PMI.h +128 -0
  116. rdkit_headers/include/rdkit/GraphMol/Descriptors/Property.h +123 -0
  117. rdkit_headers/include/rdkit/GraphMol/Descriptors/RDF.h +52 -0
  118. rdkit_headers/include/rdkit/GraphMol/Descriptors/RegisterDescriptor.h +84 -0
  119. rdkit_headers/include/rdkit/GraphMol/Descriptors/USRDescriptor.h +137 -0
  120. rdkit_headers/include/rdkit/GraphMol/Descriptors/WHIM.h +51 -0
  121. rdkit_headers/include/rdkit/GraphMol/DistGeomHelpers/BoundsMatrixBuilder.h +77 -0
  122. rdkit_headers/include/rdkit/GraphMol/DistGeomHelpers/Embedder.h +437 -0
  123. rdkit_headers/include/rdkit/GraphMol/FMCS/FMCS.h +194 -0
  124. rdkit_headers/include/rdkit/GraphMol/FMCS/Graph.h +43 -0
  125. rdkit_headers/include/rdkit/GraphMol/FileParsers/FileParserUtils.h +231 -0
  126. rdkit_headers/include/rdkit/GraphMol/FileParsers/FileParsers.h +399 -0
  127. rdkit_headers/include/rdkit/GraphMol/FileParsers/GeneralFileReader.h +170 -0
  128. rdkit_headers/include/rdkit/GraphMol/FileParsers/MolFileStereochem.h +60 -0
  129. rdkit_headers/include/rdkit/GraphMol/FileParsers/MolSupplier.h +444 -0
  130. rdkit_headers/include/rdkit/GraphMol/FileParsers/MolWriters.h +338 -0
  131. rdkit_headers/include/rdkit/GraphMol/FileParsers/MultithreadedMolSupplier.h +102 -0
  132. rdkit_headers/include/rdkit/GraphMol/FileParsers/MultithreadedSDMolSupplier.h +65 -0
  133. rdkit_headers/include/rdkit/GraphMol/FileParsers/MultithreadedSmilesMolSupplier.h +66 -0
  134. rdkit_headers/include/rdkit/GraphMol/FileParsers/PNGParser.h +203 -0
  135. rdkit_headers/include/rdkit/GraphMol/FileParsers/SequenceParsers.h +117 -0
  136. rdkit_headers/include/rdkit/GraphMol/FileParsers/SequenceWriters.h +47 -0
  137. rdkit_headers/include/rdkit/GraphMol/FilterCatalog/FilterCatalog.h +260 -0
  138. rdkit_headers/include/rdkit/GraphMol/FilterCatalog/FilterCatalogEntry.h +276 -0
  139. rdkit_headers/include/rdkit/GraphMol/FilterCatalog/FilterMatcherBase.h +152 -0
  140. rdkit_headers/include/rdkit/GraphMol/FilterCatalog/FilterMatchers.h +576 -0
  141. rdkit_headers/include/rdkit/GraphMol/FilterCatalog/FunctionalGroupHierarchy.h +52 -0
  142. rdkit_headers/include/rdkit/GraphMol/Fingerprints/AtomPairGenerator.h +188 -0
  143. rdkit_headers/include/rdkit/GraphMol/Fingerprints/AtomPairs.h +268 -0
  144. rdkit_headers/include/rdkit/GraphMol/Fingerprints/FingerprintGenerator.h +372 -0
  145. rdkit_headers/include/rdkit/GraphMol/Fingerprints/FingerprintUtil.h +160 -0
  146. rdkit_headers/include/rdkit/GraphMol/Fingerprints/Fingerprints.h +167 -0
  147. rdkit_headers/include/rdkit/GraphMol/Fingerprints/MACCS.h +32 -0
  148. rdkit_headers/include/rdkit/GraphMol/Fingerprints/MHFP.h +285 -0
  149. rdkit_headers/include/rdkit/GraphMol/Fingerprints/MorganFingerprints.h +210 -0
  150. rdkit_headers/include/rdkit/GraphMol/Fingerprints/MorganGenerator.h +251 -0
  151. rdkit_headers/include/rdkit/GraphMol/Fingerprints/RDKitFPGenerator.h +162 -0
  152. rdkit_headers/include/rdkit/GraphMol/Fingerprints/TopologicalTorsionGenerator.h +127 -0
  153. rdkit_headers/include/rdkit/GraphMol/ForceFieldHelpers/CrystalFF/TorsionAngleM6.h +72 -0
  154. rdkit_headers/include/rdkit/GraphMol/ForceFieldHelpers/CrystalFF/TorsionPreferences.h +41 -0
  155. rdkit_headers/include/rdkit/GraphMol/ForceFieldHelpers/FFConvenience.h +130 -0
  156. rdkit_headers/include/rdkit/GraphMol/ForceFieldHelpers/MMFF/AtomTyper.h +236 -0
  157. rdkit_headers/include/rdkit/GraphMol/ForceFieldHelpers/MMFF/Builder.h +141 -0
  158. rdkit_headers/include/rdkit/GraphMol/ForceFieldHelpers/MMFF/MMFF.h +105 -0
  159. rdkit_headers/include/rdkit/GraphMol/ForceFieldHelpers/UFF/AtomTyper.h +57 -0
  160. rdkit_headers/include/rdkit/GraphMol/ForceFieldHelpers/UFF/Builder.h +129 -0
  161. rdkit_headers/include/rdkit/GraphMol/ForceFieldHelpers/UFF/UFF.h +82 -0
  162. rdkit_headers/include/rdkit/GraphMol/FragCatalog/FragCatGenerator.h +33 -0
  163. rdkit_headers/include/rdkit/GraphMol/FragCatalog/FragCatParams.h +94 -0
  164. rdkit_headers/include/rdkit/GraphMol/FragCatalog/FragCatalogEntry.h +136 -0
  165. rdkit_headers/include/rdkit/GraphMol/FragCatalog/FragCatalogUtils.h +62 -0
  166. rdkit_headers/include/rdkit/GraphMol/FragCatalog/FragFPGenerator.h +38 -0
  167. rdkit_headers/include/rdkit/GraphMol/GenericGroups/GenericGroups.h +301 -0
  168. rdkit_headers/include/rdkit/GraphMol/GraphMol.h +22 -0
  169. rdkit_headers/include/rdkit/GraphMol/MMPA/MMPA.h +81 -0
  170. rdkit_headers/include/rdkit/GraphMol/MolAlign/AlignMolecules.h +183 -0
  171. rdkit_headers/include/rdkit/GraphMol/MolAlign/O3AAlignMolecules.h +354 -0
  172. rdkit_headers/include/rdkit/GraphMol/MolBundle.h +121 -0
  173. rdkit_headers/include/rdkit/GraphMol/MolCatalog/MolCatalog.h +20 -0
  174. rdkit_headers/include/rdkit/GraphMol/MolCatalog/MolCatalogEntry.h +109 -0
  175. rdkit_headers/include/rdkit/GraphMol/MolCatalog/MolCatalogParams.h +40 -0
  176. rdkit_headers/include/rdkit/GraphMol/MolChemicalFeatures/FeatureParser.h +58 -0
  177. rdkit_headers/include/rdkit/GraphMol/MolChemicalFeatures/MolChemicalFeature.h +98 -0
  178. rdkit_headers/include/rdkit/GraphMol/MolChemicalFeatures/MolChemicalFeatureDef.h +68 -0
  179. rdkit_headers/include/rdkit/GraphMol/MolChemicalFeatures/MolChemicalFeatureFactory.h +78 -0
  180. rdkit_headers/include/rdkit/GraphMol/MolDraw2D/MolDraw2D.h +539 -0
  181. rdkit_headers/include/rdkit/GraphMol/MolDraw2D/MolDraw2DHelpers.h +284 -0
  182. rdkit_headers/include/rdkit/GraphMol/MolDraw2D/MolDraw2DJS.h +62 -0
  183. rdkit_headers/include/rdkit/GraphMol/MolDraw2D/MolDraw2DSVG.h +88 -0
  184. rdkit_headers/include/rdkit/GraphMol/MolDraw2D/MolDraw2DUtils.h +179 -0
  185. rdkit_headers/include/rdkit/GraphMol/MolDraw2D/MolDraw2Dwx.h +107 -0
  186. rdkit_headers/include/rdkit/GraphMol/MolEnumerator/LinkNode.h +159 -0
  187. rdkit_headers/include/rdkit/GraphMol/MolEnumerator/MolEnumerator.h +276 -0
  188. rdkit_headers/include/rdkit/GraphMol/MolHash/MolHash.h +12 -0
  189. rdkit_headers/include/rdkit/GraphMol/MolHash/nmmolhash.h +60 -0
  190. rdkit_headers/include/rdkit/GraphMol/MolInterchange/MolInterchange.h +93 -0
  191. rdkit_headers/include/rdkit/GraphMol/MolInterchange/details.h +49 -0
  192. rdkit_headers/include/rdkit/GraphMol/MolOps.h +1016 -0
  193. rdkit_headers/include/rdkit/GraphMol/MolPickler.h +314 -0
  194. rdkit_headers/include/rdkit/GraphMol/MolStandardize/AcidBaseCatalog/AcidBaseCatalogEntry.h +56 -0
  195. rdkit_headers/include/rdkit/GraphMol/MolStandardize/AcidBaseCatalog/AcidBaseCatalogParams.h +65 -0
  196. rdkit_headers/include/rdkit/GraphMol/MolStandardize/AcidBaseCatalog/AcidBaseCatalogUtils.h +37 -0
  197. rdkit_headers/include/rdkit/GraphMol/MolStandardize/Charge.h +145 -0
  198. rdkit_headers/include/rdkit/GraphMol/MolStandardize/Fragment.h +105 -0
  199. rdkit_headers/include/rdkit/GraphMol/MolStandardize/FragmentCatalog/FragmentCatalogEntry.h +60 -0
  200. rdkit_headers/include/rdkit/GraphMol/MolStandardize/FragmentCatalog/FragmentCatalogParams.h +63 -0
  201. rdkit_headers/include/rdkit/GraphMol/MolStandardize/FragmentCatalog/FragmentCatalogUtils.h +35 -0
  202. rdkit_headers/include/rdkit/GraphMol/MolStandardize/Metal.h +73 -0
  203. rdkit_headers/include/rdkit/GraphMol/MolStandardize/MolStandardize.h +178 -0
  204. rdkit_headers/include/rdkit/GraphMol/MolStandardize/Normalize.h +104 -0
  205. rdkit_headers/include/rdkit/GraphMol/MolStandardize/Tautomer.h +428 -0
  206. rdkit_headers/include/rdkit/GraphMol/MolStandardize/TautomerCatalog/TautomerCatalogEntry.h +59 -0
  207. rdkit_headers/include/rdkit/GraphMol/MolStandardize/TautomerCatalog/TautomerCatalogParams.h +69 -0
  208. rdkit_headers/include/rdkit/GraphMol/MolStandardize/TautomerCatalog/TautomerCatalogUtils.h +81 -0
  209. rdkit_headers/include/rdkit/GraphMol/MolStandardize/TransformCatalog/TransformCatalogEntry.h +57 -0
  210. rdkit_headers/include/rdkit/GraphMol/MolStandardize/TransformCatalog/TransformCatalogParams.h +66 -0
  211. rdkit_headers/include/rdkit/GraphMol/MolStandardize/TransformCatalog/TransformCatalogUtils.h +37 -0
  212. rdkit_headers/include/rdkit/GraphMol/MolStandardize/Validate.h +199 -0
  213. rdkit_headers/include/rdkit/GraphMol/MolTransforms/MolTransforms.h +222 -0
  214. rdkit_headers/include/rdkit/GraphMol/MonomerInfo.h +138 -0
  215. rdkit_headers/include/rdkit/GraphMol/PartialCharges/GasteigerCharges.h +27 -0
  216. rdkit_headers/include/rdkit/GraphMol/PartialCharges/GasteigerParams.h +86 -0
  217. rdkit_headers/include/rdkit/GraphMol/PeriodicTable.h +325 -0
  218. rdkit_headers/include/rdkit/GraphMol/QueryAtom.h +161 -0
  219. rdkit_headers/include/rdkit/GraphMol/QueryBond.h +146 -0
  220. rdkit_headers/include/rdkit/GraphMol/QueryOps.h +1110 -0
  221. rdkit_headers/include/rdkit/GraphMol/RDKitBase.h +35 -0
  222. rdkit_headers/include/rdkit/GraphMol/RDKitQueries.h +25 -0
  223. rdkit_headers/include/rdkit/GraphMol/RGroupDecomposition/RGroupDecomp.h +225 -0
  224. rdkit_headers/include/rdkit/GraphMol/ROMol.h +844 -0
  225. rdkit_headers/include/rdkit/GraphMol/RWMol.h +222 -0
  226. rdkit_headers/include/rdkit/GraphMol/ReducedGraphs/ReducedGraphs.h +85 -0
  227. rdkit_headers/include/rdkit/GraphMol/Resonance.h +236 -0
  228. rdkit_headers/include/rdkit/GraphMol/RingInfo.h +274 -0
  229. rdkit_headers/include/rdkit/GraphMol/Rings.h +90 -0
  230. rdkit_headers/include/rdkit/GraphMol/SLNParse/SLNAttribs.h +93 -0
  231. rdkit_headers/include/rdkit/GraphMol/SLNParse/SLNParse.h +70 -0
  232. rdkit_headers/include/rdkit/GraphMol/SLNParse/SLNParseOps.h +328 -0
  233. rdkit_headers/include/rdkit/GraphMol/SanitException.h +120 -0
  234. rdkit_headers/include/rdkit/GraphMol/ScaffoldNetwork/ScaffoldNetwork.h +195 -0
  235. rdkit_headers/include/rdkit/GraphMol/ShapeHelpers/ShapeEncoder.h +73 -0
  236. rdkit_headers/include/rdkit/GraphMol/ShapeHelpers/ShapeUtils.h +279 -0
  237. rdkit_headers/include/rdkit/GraphMol/SmilesParse/SmartsWrite.h +46 -0
  238. rdkit_headers/include/rdkit/GraphMol/SmilesParse/SmilesParse.h +160 -0
  239. rdkit_headers/include/rdkit/GraphMol/SmilesParse/SmilesParseOps.h +53 -0
  240. rdkit_headers/include/rdkit/GraphMol/SmilesParse/SmilesWrite.h +288 -0
  241. rdkit_headers/include/rdkit/GraphMol/SmilesParse/primes.h +18 -0
  242. rdkit_headers/include/rdkit/GraphMol/StereoGroup.h +74 -0
  243. rdkit_headers/include/rdkit/GraphMol/Subgraphs/SubgraphUtils.h +57 -0
  244. rdkit_headers/include/rdkit/GraphMol/Subgraphs/Subgraphs.h +154 -0
  245. rdkit_headers/include/rdkit/GraphMol/SubstanceGroup.h +297 -0
  246. rdkit_headers/include/rdkit/GraphMol/Substruct/SubstructMatch.h +232 -0
  247. rdkit_headers/include/rdkit/GraphMol/Substruct/SubstructUtils.h +44 -0
  248. rdkit_headers/include/rdkit/GraphMol/SubstructLibrary/PatternFactory.h +40 -0
  249. rdkit_headers/include/rdkit/GraphMol/SubstructLibrary/SubstructLibrary.h +951 -0
  250. rdkit_headers/include/rdkit/GraphMol/SubstructLibrary/SubstructLibrarySerialization.h +231 -0
  251. rdkit_headers/include/rdkit/GraphMol/TautomerQuery/TautomerQuery.h +104 -0
  252. rdkit_headers/include/rdkit/GraphMol/Trajectory/Snapshot.h +69 -0
  253. rdkit_headers/include/rdkit/GraphMol/Trajectory/Trajectory.h +105 -0
  254. rdkit_headers/include/rdkit/GraphMol/atomic_data.h +76 -0
  255. rdkit_headers/include/rdkit/GraphMol/details.h +15 -0
  256. rdkit_headers/include/rdkit/GraphMol/new_canon.h +772 -0
  257. rdkit_headers/include/rdkit/Numerics/Alignment/AlignPoints.h +49 -0
  258. rdkit_headers/include/rdkit/Numerics/Conrec.h +203 -0
  259. rdkit_headers/include/rdkit/Numerics/EigenSolvers/PowerEigenSolver.h +68 -0
  260. rdkit_headers/include/rdkit/Numerics/Matrix.h +347 -0
  261. rdkit_headers/include/rdkit/Numerics/Optimizer/BFGSOpt.h +397 -0
  262. rdkit_headers/include/rdkit/Numerics/SquareMatrix.h +89 -0
  263. rdkit_headers/include/rdkit/Numerics/SymmMatrix.h +361 -0
  264. rdkit_headers/include/rdkit/Numerics/Vector.h +327 -0
  265. rdkit_headers/include/rdkit/Query/AndQuery.h +57 -0
  266. rdkit_headers/include/rdkit/Query/EqualityQuery.h +88 -0
  267. rdkit_headers/include/rdkit/Query/GreaterEqualQuery.h +74 -0
  268. rdkit_headers/include/rdkit/Query/GreaterQuery.h +74 -0
  269. rdkit_headers/include/rdkit/Query/LessEqualQuery.h +75 -0
  270. rdkit_headers/include/rdkit/Query/LessQuery.h +74 -0
  271. rdkit_headers/include/rdkit/Query/NullQueryAlgebra.h +86 -0
  272. rdkit_headers/include/rdkit/Query/OrQuery.h +58 -0
  273. rdkit_headers/include/rdkit/Query/Query.h +210 -0
  274. rdkit_headers/include/rdkit/Query/QueryObjects.h +38 -0
  275. rdkit_headers/include/rdkit/Query/RangeQuery.h +116 -0
  276. rdkit_headers/include/rdkit/Query/SetQuery.h +87 -0
  277. rdkit_headers/include/rdkit/Query/XOrQuery.h +63 -0
  278. rdkit_headers/include/rdkit/RDGeneral/BadFileException.h +39 -0
  279. rdkit_headers/include/rdkit/RDGeneral/BoostEndInclude.h +69 -0
  280. rdkit_headers/include/rdkit/RDGeneral/BoostStartInclude.h +95 -0
  281. rdkit_headers/include/rdkit/RDGeneral/ConcurrentQueue.h +132 -0
  282. rdkit_headers/include/rdkit/RDGeneral/Dict.h +350 -0
  283. rdkit_headers/include/rdkit/RDGeneral/Exceptions.h +73 -0
  284. rdkit_headers/include/rdkit/RDGeneral/FileParseException.h +36 -0
  285. rdkit_headers/include/rdkit/RDGeneral/Invariant.h +198 -0
  286. rdkit_headers/include/rdkit/RDGeneral/LocaleSwitcher.h +54 -0
  287. rdkit_headers/include/rdkit/RDGeneral/RDAny.h +217 -0
  288. rdkit_headers/include/rdkit/RDGeneral/RDConfig.h +49 -0
  289. rdkit_headers/include/rdkit/RDGeneral/RDExportMacros.h +40 -0
  290. rdkit_headers/include/rdkit/RDGeneral/RDLog.h +142 -0
  291. rdkit_headers/include/rdkit/RDGeneral/RDProps.h +172 -0
  292. rdkit_headers/include/rdkit/RDGeneral/RDThreads.h +44 -0
  293. rdkit_headers/include/rdkit/RDGeneral/RDValue-doublemagic.h +478 -0
  294. rdkit_headers/include/rdkit/RDGeneral/RDValue-taggedunion.h +518 -0
  295. rdkit_headers/include/rdkit/RDGeneral/RDValue.h +285 -0
  296. rdkit_headers/include/rdkit/RDGeneral/Ranking.h +87 -0
  297. rdkit_headers/include/rdkit/RDGeneral/StreamOps.h +637 -0
  298. rdkit_headers/include/rdkit/RDGeneral/export.h +559 -0
  299. rdkit_headers/include/rdkit/RDGeneral/hanoiSort.h +167 -0
  300. rdkit_headers/include/rdkit/RDGeneral/hash/detail/float_functions.hpp +156 -0
  301. rdkit_headers/include/rdkit/RDGeneral/hash/detail/hash_float.hpp +179 -0
  302. rdkit_headers/include/rdkit/RDGeneral/hash/extensions.hpp +152 -0
  303. rdkit_headers/include/rdkit/RDGeneral/hash/hash.hpp +463 -0
  304. rdkit_headers/include/rdkit/RDGeneral/hash/hash_fwd.hpp +51 -0
  305. rdkit_headers/include/rdkit/RDGeneral/test.h +274 -0
  306. rdkit_headers/include/rdkit/RDGeneral/types.h +401 -0
  307. rdkit_headers/include/rdkit/RDGeneral/utils.h +106 -0
  308. rdkit_headers/include/rdkit/RDGeneral/versions.h +27 -0
  309. rdkit_headers/include/rdkit/RDStreams/streams.h +19 -0
  310. rdkit_headers/include/rdkit/RingDecomposerLib.h +751 -0
  311. rdkit_headers/include/rdkit/SimDivPickers/DistPicker.h +92 -0
  312. rdkit_headers/include/rdkit/SimDivPickers/HierarchicalClusterPicker.h +107 -0
  313. rdkit_headers/include/rdkit/SimDivPickers/LeaderPicker.h +470 -0
  314. rdkit_headers/include/rdkit/SimDivPickers/MaxMinPicker.h +303 -0
  315. rdkit_headers-2022.3.3.dist-info/METADATA +24 -0
  316. rdkit_headers-2022.3.3.dist-info/RECORD +320 -0
  317. rdkit_headers-2022.3.3.dist-info/WHEEL +4 -0
  318. rdkit_headers-2022.3.3.dist-info/entry_points.txt +4 -0
  319. rdkit_headers-2022.3.3.dist-info/licenses/LICENSE +29 -0
  320. rdkit_headers-2022.3.3.dist-info/licenses/NOTICE +5 -0
@@ -0,0 +1,437 @@
1
+ //
2
+ // Copyright (C) 2004-2017 Greg Landrum and Rational Discovery LLC
3
+ //
4
+ // @@ All Rights Reserved @@
5
+ // This file is part of the RDKit.
6
+ // The contents are covered by the terms of the BSD license
7
+ // which is included in the file license.txt, found at the root
8
+ // of the RDKit source tree.
9
+ //
10
+
11
+ #include <RDGeneral/export.h>
12
+ #ifndef RD_EMBEDDER_H_GUARD
13
+ #define RD_EMBEDDER_H_GUARD
14
+
15
+ #include <map>
16
+ #include <utility>
17
+ #include <Geometry/point.h>
18
+ #include <GraphMol/ROMol.h>
19
+ #include <boost/shared_ptr.hpp>
20
+ #include <DistGeom/BoundsMatrix.h>
21
+
22
+ namespace RDKit {
23
+ namespace DGeomHelpers {
24
+
25
+ //! Parameter object for controlling embedding
26
+ /*!
27
+ numConfs Number of conformations to be generated
28
+ numThreads Sets the number of threads to use (more than one thread
29
+ will only be used if the RDKit was build with multithread
30
+ support) If set to zero, the max supported by the system will
31
+ be used.
32
+ maxIterations Max. number of times the embedding will be tried if
33
+ coordinates are not obtained successfully. The default
34
+ value is 10x the number of atoms.
35
+ randomSeed provides a seed for the random number generator (so that
36
+ the same coordinates can be obtained for a
37
+ molecule on multiple runs) If -1, the
38
+ RNG will not be seeded.
39
+ clearConfs Clear all existing conformations on the molecule
40
+ useRandomCoords Start the embedding from random coordinates instead of
41
+ using eigenvalues of the distance matrix.
42
+ boxSizeMult Determines the size of the box that is used for
43
+ random coordinates. If this is a positive number, the
44
+ side length will equal the largest element of the distance
45
+ matrix times \c boxSizeMult. If this is a negative number,
46
+ the side length will equal \c -boxSizeMult (i.e. independent
47
+ of the elements of the distance matrix).
48
+ randNegEig Picks coordinates at random when a embedding process produces
49
+ negative eigenvalues
50
+ numZeroFail Fail embedding if we find this many or more zero eigenvalues
51
+ (within a tolerance)
52
+ pruneRmsThresh Retain only the conformations out of 'numConfs' after
53
+ embedding that are at least this far apart from each other.
54
+ RMSD is computed on the heavy atoms.
55
+ Prunining is greedy; i.e. the first embedded conformation is
56
+ retained and from then on only those that are at least
57
+ \c pruneRmsThresh away from already
58
+ retained conformations are kept. The pruning is done
59
+ after embedding and bounds violation minimization.
60
+ No pruning by default.
61
+ coordMap a map of int to Point3D, between atom IDs and their locations
62
+ their locations. If this container is provided, the
63
+ coordinates are used to set distance constraints on the
64
+ embedding. The resulting conformer(s) should have distances
65
+ between the specified atoms that reproduce those between the
66
+ points in \c coordMap. Because the embedding produces a
67
+ molecule in an arbitrary reference frame, an alignment step
68
+ is required to actually reproduce the provided coordinates.
69
+ optimizerForceTol set the tolerance on forces in the DGeom optimizer
70
+ (this shouldn't normally be altered in client code).
71
+ ignoreSmoothingFailures try to embed the molecule even if triangle bounds
72
+ smoothing fails
73
+ enforceChirality enforce the correct chirality if chiral centers are present
74
+ useExpTorsionAnglePrefs impose experimental torsion-angle preferences
75
+ useBasicKnowledge impose "basic knowledge" terms such as flat
76
+ aromatic rings, ketones, etc.
77
+ ETversion version of the experimental torsion-angle preferences
78
+ verbose print output of experimental torsion-angle preferences
79
+ basinThresh set the basin threshold for the DGeom force field,
80
+ (this shouldn't normally be altered in client code).
81
+ onlyHeavyAtomsForRMS only use the heavy atoms when doing RMS filtering
82
+ boundsMat custom bound matrix to specify upper and lower bounds of atom
83
+ pairs
84
+ embedFragmentsSeparately embed each fragment of molecule in turn
85
+ useSmallRingTorsions optional torsions to improve small ring conformer
86
+ sampling
87
+ useMacrocycleTorsions optional torsions to improve macrocycle conformer
88
+ sampling
89
+ useMacrocycle14config If 1-4 distances bound heuristics for
90
+ macrocycles is used
91
+ CPCI custom columbic interactions between atom pairs
92
+ callback void pointer to a function for reporting progress,
93
+ will be called with the current iteration number.
94
+ forceTransAmides constrain amide bonds to be trans.
95
+ useSymmetryForPruning use molecule symmetry when doing the RMSD pruning.
96
+ NOTE that for reasons of computational efficiency,
97
+ setting this will also set onlyHeavyAtomsForRMS to
98
+ true.
99
+
100
+
101
+ */
102
+ struct RDKIT_DISTGEOMHELPERS_EXPORT EmbedParameters {
103
+ unsigned int maxIterations{0};
104
+ int numThreads{1};
105
+ int randomSeed{-1};
106
+ bool clearConfs{true};
107
+ bool useRandomCoords{false};
108
+ double boxSizeMult{2.0};
109
+ bool randNegEig{true};
110
+ unsigned int numZeroFail{1};
111
+ const std::map<int, RDGeom::Point3D> *coordMap{nullptr};
112
+ double optimizerForceTol{1e-3};
113
+ bool ignoreSmoothingFailures{false};
114
+ bool enforceChirality{true};
115
+ bool useExpTorsionAnglePrefs{false};
116
+ bool useBasicKnowledge{false};
117
+ bool verbose{false};
118
+ double basinThresh{5.0};
119
+ double pruneRmsThresh{-1.0};
120
+ bool onlyHeavyAtomsForRMS{false};
121
+ unsigned int ETversion{1};
122
+ boost::shared_ptr<const DistGeom::BoundsMatrix> boundsMat;
123
+ bool embedFragmentsSeparately{true};
124
+ bool useSmallRingTorsions{false};
125
+ bool useMacrocycleTorsions{false};
126
+ bool useMacrocycle14config{false};
127
+ std::shared_ptr<std::map<std::pair<unsigned int, unsigned int>, double>> CPCI;
128
+ void (*callback)(unsigned int);
129
+ bool forceTransAmides{true};
130
+ bool useSymmetryForPruning{true};
131
+ double boundsMatForceScaling{1.0};
132
+ EmbedParameters() : boundsMat(nullptr), CPCI(nullptr), callback(nullptr) {}
133
+ EmbedParameters(
134
+ unsigned int maxIterations, int numThreads, int randomSeed,
135
+ bool clearConfs, bool useRandomCoords, double boxSizeMult,
136
+ bool randNegEig, unsigned int numZeroFail,
137
+ const std::map<int, RDGeom::Point3D> *coordMap, double optimizerForceTol,
138
+ bool ignoreSmoothingFailures, bool enforceChirality,
139
+ bool useExpTorsionAnglePrefs, bool useBasicKnowledge, bool verbose,
140
+ double basinThresh, double pruneRmsThresh, bool onlyHeavyAtomsForRMS,
141
+ unsigned int ETversion = 1,
142
+ const DistGeom::BoundsMatrix *boundsMat = nullptr,
143
+ bool embedFragmentsSeparately = true, bool useSmallRingTorsions = false,
144
+ bool useMacrocycleTorsions = false, bool useMacrocycle14config = false,
145
+ std::shared_ptr<std::map<std::pair<unsigned int, unsigned int>, double>>
146
+ CPCI = nullptr,
147
+ void (*callback)(unsigned int) = nullptr)
148
+ : maxIterations(maxIterations),
149
+ numThreads(numThreads),
150
+ randomSeed(randomSeed),
151
+ clearConfs(clearConfs),
152
+ useRandomCoords(useRandomCoords),
153
+ boxSizeMult(boxSizeMult),
154
+ randNegEig(randNegEig),
155
+ numZeroFail(numZeroFail),
156
+ coordMap(coordMap),
157
+ optimizerForceTol(optimizerForceTol),
158
+ ignoreSmoothingFailures(ignoreSmoothingFailures),
159
+ enforceChirality(enforceChirality),
160
+ useExpTorsionAnglePrefs(useExpTorsionAnglePrefs),
161
+ useBasicKnowledge(useBasicKnowledge),
162
+ verbose(verbose),
163
+ basinThresh(basinThresh),
164
+ pruneRmsThresh(pruneRmsThresh),
165
+ onlyHeavyAtomsForRMS(onlyHeavyAtomsForRMS),
166
+ ETversion(ETversion),
167
+ boundsMat(boundsMat),
168
+ embedFragmentsSeparately(embedFragmentsSeparately),
169
+ useSmallRingTorsions(useSmallRingTorsions),
170
+ useMacrocycleTorsions(useMacrocycleTorsions),
171
+ useMacrocycle14config(useMacrocycle14config),
172
+ CPCI(std::move(CPCI)),
173
+ callback(callback) {}
174
+ };
175
+
176
+ //*! update parameters from a JSON string
177
+ RDKIT_DISTGEOMHELPERS_EXPORT void updateEmbedParametersFromJSON(
178
+ EmbedParameters &params, const std::string &json);
179
+
180
+ //*! Embed multiple conformations for a molecule
181
+ RDKIT_DISTGEOMHELPERS_EXPORT void EmbedMultipleConfs(
182
+ ROMol &mol, INT_VECT &res, unsigned int numConfs,
183
+ const EmbedParameters &params);
184
+ inline INT_VECT EmbedMultipleConfs(ROMol &mol, unsigned int numConfs,
185
+ const EmbedParameters &params) {
186
+ INT_VECT res;
187
+ EmbedMultipleConfs(mol, res, numConfs, params);
188
+ return res;
189
+ }
190
+
191
+ //! Compute an embedding (in 3D) for the specified molecule using Distance
192
+ /// Geometry
193
+ inline int EmbedMolecule(ROMol &mol, const EmbedParameters &params) {
194
+ INT_VECT confIds;
195
+ EmbedMultipleConfs(mol, confIds, 1, params);
196
+
197
+ int res;
198
+ if (confIds.size()) {
199
+ res = confIds[0];
200
+ } else {
201
+ res = -1;
202
+ }
203
+ return res;
204
+ }
205
+
206
+ //! Compute an embedding (in 3D) for the specified molecule using Distance
207
+ /// Geometry
208
+ /*!
209
+ The following operations are performed (in order) here:
210
+ -# Build a distance bounds matrix based on the topology, including 1-5
211
+ distances but not VDW scaling
212
+ -# Triangle smooth this bounds matrix
213
+ -# If step 2 fails - repeat step 1, this time without 1-5 bounds and with vdW
214
+ scaling, and repeat step 2
215
+ -# Pick a distance matrix at random using the bounds matrix
216
+ -# Compute initial coordinates from the distance matrix
217
+ -# Repeat steps 3 and 4 until maxIterations is reached or embedding is
218
+ successful
219
+ -# Adjust initial coordinates by minimizing a Distance Violation error
220
+ function
221
+ **NOTE**: if the molecule has multiple fragments, they will be embedded
222
+ separately,
223
+ this means that they will likely occupy the same region of space.
224
+ \param mol Molecule of interest
225
+ \param maxIterations Max. number of times the embedding will be tried if
226
+ coordinates are not obtained successfully. The default
227
+ value is 10x the number of atoms.
228
+ \param seed provides a seed for the random number generator (so that
229
+ the same coordinates can be obtained for a molecule on
230
+ multiple runs). If negative, the RNG will not be seeded.
231
+ \param clearConfs Clear all existing conformations on the molecule
232
+ \param useRandomCoords Start the embedding from random coordinates instead of
233
+ using eigenvalues of the distance matrix.
234
+ \param boxSizeMult Determines the size of the box that is used for
235
+ random coordinates. If this is a positive number, the
236
+ side length will equal the largest element of the
237
+ distance matrix times \c boxSizeMult. If this is a
238
+ negative number, the side length will equal
239
+ \c -boxSizeMult (i.e. independent of the elements of the
240
+ distance matrix).
241
+ \param randNegEig Picks coordinates at random when a embedding process
242
+ produces negative eigenvalues
243
+ \param numZeroFail Fail embedding if we find this many or more zero
244
+ eigenvalues (within a tolerance)
245
+ \param coordMap a map of int to Point3D, between atom IDs and their locations
246
+ their locations. If this container is provided, the
247
+ coordinates are used to set distance constraints on the
248
+ embedding. The resulting conformer(s) should have distances
249
+ between the specified atoms that reproduce those between the
250
+ points in \c coordMap. Because the embedding produces a
251
+ molecule in an arbitrary reference frame, an alignment step
252
+ is required to actually reproduce the provided coordinates.
253
+ \param optimizerForceTol set the tolerance on forces in the distgeom optimizer
254
+ (this shouldn't normally be altered in client code).
255
+ \param ignoreSmoothingFailures try to embed the molecule even if triangle
256
+ bounds smoothing fails
257
+ \param enforceChirality enforce the correct chirality if chiral centers are
258
+ present
259
+ \param useExpTorsionAnglePrefs impose experimental torsion-angle preferences
260
+ \param useBasicKnowledge impose "basic knowledge" terms such as flat
261
+ aromatic rings, ketones, etc.
262
+ \param verbose print output of experimental torsion-angle preferences
263
+ \param basinThresh set the basin threshold for the DGeom force field,
264
+ (this shouldn't normally be altered in client code).
265
+ \param onlyHeavyAtomsForRMS only use the heavy atoms when doing RMS filtering
266
+ \param ETversion version of torsion preferences to use
267
+ \param useSmallRingTorsions optional torsions to improve small ring
268
+ conformer sampling
269
+
270
+ \param useMacrocycleTorsions optional torsions to improve macrocycle
271
+ conformer sampling \param useMacrocycle14config If 1-4 distances bound
272
+ heuristics for macrocycles is used \return ID of the conformations added to
273
+ the molecule, -1 if the emdedding failed
274
+ */
275
+ inline int EmbedMolecule(
276
+ ROMol &mol, unsigned int maxIterations = 0, int seed = -1,
277
+ bool clearConfs = true, bool useRandomCoords = false,
278
+ double boxSizeMult = 2.0, bool randNegEig = true,
279
+ unsigned int numZeroFail = 1,
280
+ const std::map<int, RDGeom::Point3D> *coordMap = nullptr,
281
+ double optimizerForceTol = 1e-3, bool ignoreSmoothingFailures = false,
282
+ bool enforceChirality = true, bool useExpTorsionAnglePrefs = false,
283
+ bool useBasicKnowledge = false, bool verbose = false,
284
+ double basinThresh = 5.0, bool onlyHeavyAtomsForRMS = false,
285
+ unsigned int ETversion = 1, bool useSmallRingTorsions = false,
286
+ bool useMacrocycleTorsions = false, bool useMacrocycle14config = false) {
287
+ EmbedParameters params(
288
+ maxIterations, 1, seed, clearConfs, useRandomCoords, boxSizeMult,
289
+ randNegEig, numZeroFail, coordMap, optimizerForceTol,
290
+ ignoreSmoothingFailures, enforceChirality, useExpTorsionAnglePrefs,
291
+ useBasicKnowledge, verbose, basinThresh, -1.0, onlyHeavyAtomsForRMS,
292
+ ETversion, nullptr, true, useSmallRingTorsions, useMacrocycleTorsions,
293
+ useMacrocycle14config);
294
+ return EmbedMolecule(mol, params);
295
+ };
296
+
297
+ //*! Embed multiple conformations for a molecule
298
+ /*!
299
+ This is kind of equivalent to calling EmbedMolecule multiple times - just that
300
+ the bounds
301
+ matrix is computed only once from the topology
302
+ **NOTE**: if the molecule has multiple fragments, they will be embedded
303
+ separately,
304
+ this means that they will likely occupy the same region of space.
305
+ \param mol Molecule of interest
306
+ \param res Used to return the resulting conformer ids
307
+ \param numConfs Number of conformations to be generated
308
+ \param numThreads Sets the number of threads to use (more than one thread
309
+ will only be used if the RDKit was build with
310
+ multithread
311
+ support). If set to zero, the max supported by the
312
+ system
313
+ will be used.
314
+ \param maxIterations Max. number of times the embedding will be tried if
315
+ coordinates are not obtained successfully. The default
316
+ value is 10x the number of atoms.
317
+ \param seed provides a seed for the random number generator (so that
318
+ the same coordinates can be obtained for a molecule on
319
+ multiple runs). If negative, the RNG will not be seeded.
320
+ \param clearConfs Clear all existing conformations on the molecule
321
+ \param useRandomCoords Start the embedding from random coordinates instead of
322
+ using eigenvalues of the distance matrix.
323
+ \param boxSizeMult Determines the size of the box that is used for
324
+ random coordinates. If this is a positive number, the
325
+ side length will equal the largest element of the
326
+ distance matrix times \c boxSizeMult. If this is a
327
+ negative number, the side length will equal
328
+ \c -boxSizeMult (i.e. independent of the elements of the
329
+ distance matrix).
330
+ \param randNegEig Picks coordinates at random when a embedding process
331
+ produces negative eigenvalues
332
+ \param numZeroFail Fail embedding if we find this many or more zero
333
+ eigenvalues (within a tolerance)
334
+ \param pruneRmsThresh Retain only the conformations out of 'numConfs' after
335
+ embedding that are at least this far apart from each
336
+ other. RMSD is computed on the heavy atoms.
337
+ Pruning is greedy; i.e. the first embedded conformation
338
+ is retained and from then on only those that are at
339
+ least
340
+ pruneRmsThresh away from already retained conformations
341
+ are kept. The pruning is done after embedding and
342
+ bounds violation minimization. No pruning by default.
343
+ \param coordMap a map of int to Point3D, between atom IDs and their locations
344
+ their locations. If this container is provided, the
345
+ coordinates are used to set distance constraints on the
346
+ embedding. The resulting conformer(s) should have distances
347
+ between the specified atoms that reproduce those between the
348
+ points in \c coordMap. Because the embedding produces a
349
+ molecule in an arbitrary reference frame, an alignment step
350
+ is required to actually reproduce the provided coordinates.
351
+ \param optimizerForceTol set the tolerance on forces in the DGeom optimizer
352
+ (this shouldn't normally be altered in client code).
353
+ \param ignoreSmoothingFailures try to embed the molecule even if triangle
354
+ bounds smoothing fails
355
+ \param enforceChirality enforce the correct chirality if chiral centers are
356
+ present
357
+ \param useExpTorsionAnglePrefs impose experimental torsion-angle preferences
358
+ \param useBasicKnowledge impose "basic knowledge" terms such as flat
359
+ aromatic rings, ketones, etc.
360
+ \param verbose print output of experimental torsion-angle preferences
361
+ \param basinThresh set the basin threshold for the DGeom force field,
362
+ (this shouldn't normally be altered in client code).
363
+ \param onlyHeavyAtomsForRMS only use the heavy atoms when doing RMS filtering
364
+ \param ETversion version of torsion preferences to use
365
+ \param useSmallRingTorsions optional torsions to improve small ring
366
+ conformer sampling
367
+
368
+ \param useMacrocycleTorsions optional torsions to improve macrocycle
369
+ conformer sampling \param useMacrocycle14config If 1-4 distances bound
370
+ heuristics for macrocycles is used
371
+
372
+ */
373
+ inline void EmbedMultipleConfs(
374
+ ROMol &mol, INT_VECT &res, unsigned int numConfs = 10, int numThreads = 1,
375
+ unsigned int maxIterations = 30, int seed = -1, bool clearConfs = true,
376
+ bool useRandomCoords = false, double boxSizeMult = 2.0,
377
+ bool randNegEig = true, unsigned int numZeroFail = 1,
378
+ double pruneRmsThresh = -1.0,
379
+ const std::map<int, RDGeom::Point3D> *coordMap = nullptr,
380
+ double optimizerForceTol = 1e-3, bool ignoreSmoothingFailures = false,
381
+ bool enforceChirality = true, bool useExpTorsionAnglePrefs = false,
382
+ bool useBasicKnowledge = false, bool verbose = false,
383
+ double basinThresh = 5.0, bool onlyHeavyAtomsForRMS = false,
384
+ unsigned int ETversion = 1, bool useSmallRingTorsions = false,
385
+ bool useMacrocycleTorsions = false, bool useMacrocycle14config = false) {
386
+ EmbedParameters params(
387
+ maxIterations, numThreads, seed, clearConfs, useRandomCoords, boxSizeMult,
388
+ randNegEig, numZeroFail, coordMap, optimizerForceTol,
389
+ ignoreSmoothingFailures, enforceChirality, useExpTorsionAnglePrefs,
390
+ useBasicKnowledge, verbose, basinThresh, pruneRmsThresh,
391
+ onlyHeavyAtomsForRMS, ETversion, nullptr, true, useSmallRingTorsions,
392
+ useMacrocycleTorsions, useMacrocycle14config);
393
+ EmbedMultipleConfs(mol, res, numConfs, params);
394
+ };
395
+ //! \overload
396
+ inline INT_VECT EmbedMultipleConfs(
397
+ ROMol &mol, unsigned int numConfs = 10, unsigned int maxIterations = 30,
398
+ int seed = -1, bool clearConfs = true, bool useRandomCoords = false,
399
+ double boxSizeMult = 2.0, bool randNegEig = true,
400
+ unsigned int numZeroFail = 1, double pruneRmsThresh = -1.0,
401
+ const std::map<int, RDGeom::Point3D> *coordMap = nullptr,
402
+ double optimizerForceTol = 1e-3, bool ignoreSmoothingFailures = false,
403
+ bool enforceChirality = true, bool useExpTorsionAnglePrefs = false,
404
+ bool useBasicKnowledge = false, bool verbose = false,
405
+ double basinThresh = 5.0, bool onlyHeavyAtomsForRMS = false,
406
+ unsigned int ETversion = 1, bool useSmallRingTorsions = false,
407
+ bool useMacrocycleTorsions = false, bool useMacrocycle14config = false) {
408
+ EmbedParameters params(
409
+ maxIterations, 1, seed, clearConfs, useRandomCoords, boxSizeMult,
410
+ randNegEig, numZeroFail, coordMap, optimizerForceTol,
411
+ ignoreSmoothingFailures, enforceChirality, useExpTorsionAnglePrefs,
412
+ useBasicKnowledge, verbose, basinThresh, pruneRmsThresh,
413
+ onlyHeavyAtomsForRMS, ETversion, nullptr, true, useSmallRingTorsions,
414
+ useMacrocycleTorsions, useMacrocycle14config);
415
+ INT_VECT res;
416
+ EmbedMultipleConfs(mol, res, numConfs, params);
417
+ return res;
418
+ };
419
+
420
+ //! Parameters corresponding to Sereina Riniker's KDG approach
421
+ RDKIT_DISTGEOMHELPERS_EXPORT extern const EmbedParameters KDG;
422
+ //! Parameters corresponding to Sereina Riniker's ETDG approach
423
+ RDKIT_DISTGEOMHELPERS_EXPORT extern const EmbedParameters ETDG;
424
+ //! Parameters corresponding to Sereina Riniker's ETKDG approach
425
+ RDKIT_DISTGEOMHELPERS_EXPORT extern const EmbedParameters ETKDG;
426
+ //! Parameters corresponding to Sereina Riniker's ETKDG approach - version 2
427
+ RDKIT_DISTGEOMHELPERS_EXPORT extern const EmbedParameters ETKDGv2;
428
+ //! Parameters corresponding improved ETKDG by Wang, Witek, Landrum and Riniker
429
+ //! (10.1021/acs.jcim.0c00025) - the macrocycle part
430
+ RDKIT_DISTGEOMHELPERS_EXPORT extern const EmbedParameters ETKDGv3;
431
+ //! Parameters corresponding improved ETKDG by Wang, Witek, Landrum and Riniker
432
+ //! (10.1021/acs.jcim.0c00025) - the small ring part
433
+ RDKIT_DISTGEOMHELPERS_EXPORT extern const EmbedParameters srETKDGv3;
434
+ } // namespace DGeomHelpers
435
+ } // namespace RDKit
436
+
437
+ #endif
@@ -0,0 +1,194 @@
1
+ //
2
+ // Copyright (C) 2014 Novartis Institutes for BioMedical Research
3
+ //
4
+ // @@ All Rights Reserved @@
5
+ // This file is part of the RDKit.
6
+ // The contents are covered by the terms of the BSD license
7
+ // which is included in the file license.txt, found at the root
8
+ // of the RDKit source tree.
9
+ //
10
+ #include <RDGeneral/export.h>
11
+ #pragma once
12
+ #include <vector>
13
+ #include <string>
14
+ #include <stdexcept>
15
+ #include "../RDKitBase.h"
16
+ #include "Graph.h"
17
+
18
+ namespace RDKit {
19
+ struct MCSParameters;
20
+
21
+ typedef enum {
22
+ AtomCompareAny,
23
+ AtomCompareElements,
24
+ AtomCompareIsotopes,
25
+ AtomCompareAnyHeavyAtom
26
+ } AtomComparator;
27
+
28
+ typedef enum {
29
+ BondCompareAny,
30
+ BondCompareOrder,
31
+ BondCompareOrderExact
32
+ } BondComparator;
33
+
34
+ typedef enum {
35
+ IgnoreRingFusion,
36
+ PermissiveRingFusion,
37
+ StrictRingFusion
38
+ } RingComparator;
39
+
40
+ struct RDKIT_FMCS_EXPORT MCSAtomCompareParameters {
41
+ bool MatchValences = false;
42
+ bool MatchChiralTag = false;
43
+ bool MatchFormalCharge = false;
44
+ bool RingMatchesRingOnly = false;
45
+ bool CompleteRingsOnly = false;
46
+ bool MatchIsotope = false;
47
+ double MaxDistance = -1.0;
48
+ };
49
+
50
+ struct RDKIT_FMCS_EXPORT MCSBondCompareParameters {
51
+ bool RingMatchesRingOnly = false;
52
+ bool CompleteRingsOnly = false;
53
+ bool MatchFusedRings = false;
54
+ bool MatchFusedRingsStrict = false;
55
+ bool MatchStereo = false;
56
+ };
57
+
58
+ typedef bool (*MCSFinalMatchCheckFunction)(
59
+ const std::uint32_t c1[], const std::uint32_t c2[], const ROMol& mol1,
60
+ const FMCS::Graph& query, const ROMol& mol2, const FMCS::Graph& target,
61
+ const MCSParameters* p);
62
+ typedef bool (*MCSAtomCompareFunction)(const MCSAtomCompareParameters& p,
63
+ const ROMol& mol1, unsigned int atom1,
64
+ const ROMol& mol2, unsigned int atom2,
65
+ void* userData);
66
+ typedef bool (*MCSBondCompareFunction)(const MCSBondCompareParameters& p,
67
+ const ROMol& mol1, unsigned int bond1,
68
+ const ROMol& mol2, unsigned int bond2,
69
+ void* userData);
70
+
71
+ // Some predefined functors:
72
+ RDKIT_FMCS_EXPORT bool checkAtomRingMatch(const MCSAtomCompareParameters& p,
73
+ const ROMol& mol1, unsigned int atom1,
74
+ const ROMol& mol2,
75
+ unsigned int atom2);
76
+ RDKIT_FMCS_EXPORT bool checkAtomCharge(const MCSAtomCompareParameters& p,
77
+ const ROMol& mol1, unsigned int atom1,
78
+ const ROMol& mol2, unsigned int atom2);
79
+ RDKIT_FMCS_EXPORT bool checkAtomChirality(const MCSAtomCompareParameters& p,
80
+ const ROMol& mol1, unsigned int atom1,
81
+ const ROMol& mol2,
82
+ unsigned int atom2);
83
+ RDKIT_FMCS_EXPORT bool checkAtomDistance(const MCSAtomCompareParameters& p,
84
+ const ROMol& mol1, unsigned int atom1,
85
+ const ROMol& mol2, unsigned int atom2);
86
+
87
+ RDKIT_FMCS_EXPORT bool MCSAtomCompareAny(const MCSAtomCompareParameters& p,
88
+ const ROMol& mol1, unsigned int atom1,
89
+ const ROMol& mol2, unsigned int atom2,
90
+ void* userData);
91
+ RDKIT_FMCS_EXPORT bool MCSAtomCompareAnyHeavyAtom(
92
+ const MCSAtomCompareParameters& p, const ROMol& mol1, unsigned int atom1,
93
+ const ROMol& mol2, unsigned int atom2, void* userData);
94
+
95
+ RDKIT_FMCS_EXPORT bool MCSAtomCompareElements(
96
+ const MCSAtomCompareParameters& p, const ROMol& mol1, unsigned int atom1,
97
+ const ROMol& mol2, unsigned int atom2, void* userData);
98
+ RDKIT_FMCS_EXPORT bool MCSAtomCompareIsotopes(
99
+ const MCSAtomCompareParameters& p, const ROMol& mol1, unsigned int atom1,
100
+ const ROMol& mol2, unsigned int atom2, void* userData);
101
+
102
+ RDKIT_FMCS_EXPORT bool checkBondStereo(const MCSBondCompareParameters& p,
103
+ const ROMol& mol1, unsigned int bond1,
104
+ const ROMol& mol2, unsigned int bond2);
105
+ RDKIT_FMCS_EXPORT bool checkBondRingMatch(const MCSBondCompareParameters& p,
106
+ const ROMol& mol1, unsigned int bond1,
107
+ const ROMol& mol2, unsigned int bond2,
108
+ void* v_ringMatchMatrixSet);
109
+
110
+ RDKIT_FMCS_EXPORT bool MCSBondCompareAny(const MCSBondCompareParameters& p,
111
+ const ROMol& mol1, unsigned int bond1,
112
+ const ROMol& mol2, unsigned int bond2,
113
+ void* userData);
114
+ RDKIT_FMCS_EXPORT bool MCSBondCompareOrder(
115
+ const MCSBondCompareParameters& p, const ROMol& mol1, unsigned int bond1,
116
+ const ROMol& mol2, unsigned int bond2,
117
+ void* userData); // ignore Aromatization
118
+ RDKIT_FMCS_EXPORT bool MCSBondCompareOrderExact(
119
+ const MCSBondCompareParameters& p, const ROMol& mol1, unsigned int bond1,
120
+ const ROMol& mol2, unsigned int bond2, void* userData);
121
+
122
+ struct RDKIT_FMCS_EXPORT MCSProgressData {
123
+ unsigned NumAtoms{0};
124
+ unsigned NumBonds{0};
125
+ unsigned SeedProcessed{0};
126
+
127
+ public:
128
+ MCSProgressData() {}
129
+ };
130
+
131
+ typedef bool (*MCSProgressCallback)(const MCSProgressData& stat,
132
+ const MCSParameters& params,
133
+ void* userData);
134
+ RDKIT_FMCS_EXPORT bool MCSProgressCallbackTimeout(const MCSProgressData& stat,
135
+ const MCSParameters& params,
136
+ void* userData);
137
+
138
+ struct RDKIT_FMCS_EXPORT MCSParameters {
139
+ bool MaximizeBonds = true;
140
+ double Threshold = 1.0; // match all molecules
141
+ unsigned Timeout = -1; // in seconds
142
+ bool Verbose = false;
143
+ MCSAtomCompareParameters AtomCompareParameters;
144
+ MCSBondCompareParameters BondCompareParameters;
145
+ MCSAtomCompareFunction AtomTyper = MCSAtomCompareElements;
146
+ MCSBondCompareFunction BondTyper = MCSBondCompareOrder;
147
+ void* CompareFunctionsUserData = nullptr;
148
+ MCSProgressCallback ProgressCallback =
149
+ nullptr; // return false to interrupt execution
150
+ void* ProgressCallbackUserData = nullptr;
151
+ MCSFinalMatchCheckFunction FinalMatchChecker =
152
+ nullptr; // FinalMatchCheckFunction() to check chirality and ring fusion
153
+ std::string InitialSeed = ""; // user defined or empty string (default)
154
+ void setMCSAtomTyperFromEnum(AtomComparator atomComp);
155
+ void setMCSAtomTyperFromConstChar(const char* atomComp);
156
+ void setMCSBondTyperFromEnum(BondComparator bondComp);
157
+ void setMCSBondTyperFromConstChar(const char* bondComp);
158
+ };
159
+
160
+ struct RDKIT_FMCS_EXPORT MCSResult {
161
+ unsigned NumAtoms{0};
162
+ unsigned NumBonds{0};
163
+ std::string SmartsString;
164
+ bool Canceled{false}; // interrupted by timeout or user defined progress
165
+ // callback. Contains valid current MCS !
166
+ ROMOL_SPTR QueryMol;
167
+
168
+ public:
169
+ MCSResult() {}
170
+ bool isCompleted() const { return !Canceled; }
171
+ };
172
+
173
+ RDKIT_FMCS_EXPORT void parseMCSParametersJSON(const char* json,
174
+ MCSParameters* params);
175
+
176
+ RDKIT_FMCS_EXPORT MCSResult findMCS(const std::vector<ROMOL_SPTR>& mols,
177
+ const MCSParameters* params = nullptr);
178
+ RDKIT_FMCS_EXPORT MCSResult findMCS_P(const std::vector<ROMOL_SPTR>& mols,
179
+ const char* params_json);
180
+
181
+ RDKIT_FMCS_EXPORT MCSResult findMCS(
182
+ const std::vector<ROMOL_SPTR>& mols, bool maximizeBonds, double threshold,
183
+ unsigned timeout, bool verbose, bool matchValences,
184
+ bool ringMatchesRingOnly, bool completeRingsOnly, bool matchChiralTag,
185
+ AtomComparator atomComp, BondComparator bondComp, RingComparator ringComp);
186
+ RDKIT_FMCS_EXPORT MCSResult
187
+ findMCS(const std::vector<ROMOL_SPTR>& mols, bool maximizeBonds,
188
+ double threshold = 1.0, unsigned timeout = 3600, bool verbose = false,
189
+ bool matchValences = false, bool ringMatchesRingOnly = false,
190
+ bool completeRingsOnly = false, bool matchChiralTag = false,
191
+ AtomComparator atomComp = AtomCompareElements,
192
+ BondComparator bondComp = BondCompareOrder);
193
+
194
+ } // namespace RDKit
@@ -0,0 +1,43 @@
1
+ //
2
+ // Copyright (C) 2014 Novartis Institutes for BioMedical Research
3
+ //
4
+ // @@ All Rights Reserved @@
5
+ // This file is part of the RDKit.
6
+ // The contents are covered by the terms of the BSD license
7
+ // which is included in the file license.txt, found at the root
8
+ // of the RDKit source tree.
9
+ //
10
+
11
+ // graph topology in terms of indices in source molecule
12
+ #include <RDGeneral/export.h>
13
+ #pragma once
14
+ #include <RDGeneral/BoostStartInclude.h>
15
+ #include <boost/graph/adjacency_list.hpp>
16
+ #include <RDGeneral/BoostEndInclude.h>
17
+
18
+ namespace RDKit {
19
+ namespace FMCS {
20
+ typedef unsigned AtomIdx_t;
21
+ typedef unsigned BondIdx_t;
22
+ typedef boost::adjacency_list<boost::vecS, boost::vecS, boost::undirectedS,
23
+ AtomIdx_t, BondIdx_t>
24
+ Graph_t;
25
+
26
+ class RDKIT_FMCS_EXPORT Graph : public Graph_t {
27
+ public:
28
+ typedef edge_iterator EDGE_ITER;
29
+ typedef std::pair<EDGE_ITER, EDGE_ITER> BOND_ITER_PAIR;
30
+
31
+ void addAtom(unsigned atom) {
32
+ Graph::vertex_descriptor which = boost::add_vertex(*this);
33
+ (*this)[which] = atom;
34
+ }
35
+ void addBond(unsigned bond, unsigned beginAtom, unsigned endAtom) {
36
+ bool res;
37
+ Graph_t::edge_descriptor which;
38
+ boost::tie(which, res) = boost::add_edge(beginAtom, endAtom, *this);
39
+ (*this)[which] = bond;
40
+ }
41
+ };
42
+ } // namespace FMCS
43
+ } // namespace RDKit