rdkit.Chem.rdSynthonSpaceSearch module

Module containing implementation of SynthonSpace search of Synthon-based chemical libraries such as Enamine REAL. NOTE: This functionality is experimental and the API and/or results may change in future releases.

class rdkit.Chem.rdSynthonSpaceSearch.SubstructureResult

Bases: instance

Used to return results of SynthonSpace searches.

Raises an exception This class cannot be instantiated from Python

GetHitMolecules((SubstructureResult)self) → list :

A function returning hits from the search

C++ signature :

boost::python::list GetHitMolecules(RDKit::SynthonSpaceSearch::SearchResults)

property GetMaxNumResults

The upper bound on number of results possible. There may be fewer than this in practice for several reasons such as duplicate reagent sets being removed or the final product not matching the query even though the synthons suggested they would.

class rdkit.Chem.rdSynthonSpaceSearch.SynthonSpace((object)arg1)

Bases: instance

SynthonSpaceSearch object.

C++ signature :

void __init__(_object*)

BuildSynthonFingerprints((SynthonSpace)self, (FingerprintGenerator64)fingerprintGenerator) → None :

Build the synthon fingerprints ready for similarity searching. This is done automatically when the first similarity search is done, but if converting a text file to binary format it might need to be done explicitly.

C++ signature :

void BuildSynthonFingerprints(RDKit::SynthonSpaceSearch::SynthonSpace {lvalue},RDKit::FingerprintGenerator<unsigned long>)

FingerprintSearch((SynthonSpace)self, (Mol)query, (AtomPairsParameters)fingerprintGenerator[, (AtomPairsParameters)params=None]) → SubstructureResult :

Does a fingerprint search in the SynthonSpace using the FingerprintGenerator passed in.

C++ signature :

RDKit::SynthonSpaceSearch::SearchResults FingerprintSearch(RDKit::SynthonSpaceSearch::SynthonSpace {lvalue},RDKit::ROMol,boost::python::api::object [,boost::python::api::object=None])

GetNumProducts((SynthonSpace)self) → int :

Returns number of products in the SynthonSpace, with multiple counting of any duplicates.

C++ signature :

long GetNumProducts(RDKit::SynthonSpaceSearch::SynthonSpace {lvalue})

GetNumReactions((SynthonSpace)self) → int :

Returns number of reactions in the SynthonSpace.

C++ signature :

unsigned long GetNumReactions(RDKit::SynthonSpaceSearch::SynthonSpace {lvalue})

ReadDBFile((SynthonSpace)self, (str)inFile) → None :

Reads binary database file.

C++ signature :

void ReadDBFile(RDKit::SynthonSpaceSearch::SynthonSpace {lvalue},std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> >)

ReadTextFile((SynthonSpace)self, (str)inFile) → None :

Reads text file of the sort used by ChemSpace/Enamine.

C++ signature :

void ReadTextFile(RDKit::SynthonSpaceSearch::SynthonSpace {lvalue},std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> >)

SubstructureSearch((SynthonSpace)self, (Mol)query[, (AtomPairsParameters)params=None]) → SubstructureResult :

Does a substructure search in the SynthonSpace.

C++ signature :

RDKit::SynthonSpaceSearch::SearchResults SubstructureSearch(RDKit::SynthonSpaceSearch::SynthonSpace {lvalue},RDKit::ROMol [,boost::python::api::object=None])

Summarise((SynthonSpace)self) → None :

Writes a summary of the SynthonSpace to stdout.

C++ signature :

void Summarise(RDKit::SynthonSpaceSearch::SynthonSpace)

WriteDBFile((SynthonSpace)self, (str)outFile) → None :

Writes binary database file.

C++ signature :

void WriteDBFile(RDKit::SynthonSpaceSearch::SynthonSpace {lvalue},std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> >)

WriteEnumeratedFile((SynthonSpace)self, (str)outFile) → None :

Writes enumerated library to file.

C++ signature :

void WriteEnumeratedFile(RDKit::SynthonSpaceSearch::SynthonSpace {lvalue},std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> >)

class rdkit.Chem.rdSynthonSpaceSearch.SynthonSpaceSearchParams((object)arg1)

Bases: instance

SynthonSpaceSearch parameters.

C++ signature :

void __init__(_object*)

property buildHits

If false, reports the maximum number of hits that the search could produce, but doesn’t return them.

property fragSimilarityAdjuster

Similarities of fragments are generally low due to low bit densities. For the fragment matching, reduce the similarity cutoff off by this amount. Default=0.3.

property hitStart

The sequence number of the hit to start from. So that you can return the next N hits of a search having already obtained N-1. Default=0

property maxBondSplits

The maximum number of bonds to break in the query. It should be between 1 and 4 and will be constrained to be so. Default=4.

property maxHits

The maximum number of hits to return. Default=1000.Use -1 for no maximum.

property numRandomSweeps

The random sampling doesn’t always produce the required number of hits in 1 go. This parameter controls how many loops it makes to try and get the hits before giving up. Default=10.

property randomSample

If True, returns a random sample of the hits, up to maxHits in number. Default=False.

property randomSeed

If using randomSample, this seeds the random number generator so as to give reproducible results. Default=-1 means use a random seed.

property similarityCutoff

Similarity cutoff for returning hits by fingerprint similarity. At present the fp is hard-coded to be Morgan, bits, radius=2. Default=0.5.