Drawing Fingerprint Score Histogram

Problem

You want to plot the histogram of molecular similarity scores of a dataset (see Figure 1).

Figure 1. Similarity scores of molecules with the same activity class

Ingredients

Difficulty level

../_images/chilly6.png ../_images/chilly6.png

Download

Download code

fphist2img.py

See also the Usage subsection.

Solution

The plot_similarity_score_histogram function shows how to calculate the similarity scores histogram by calling the the OEFastFPDatabase.GetHistogram method. The OEFastFPDatabase.GetHistogram method calculates the similarity scores for all pairs of fingerprints stored in the fingerprint database and returns the scores in OEFPHistogram object (line 19). The plot is then initialized iterating over the bins of the OEFPHistogram object. Finally, the average similarity score along with the corresponding legend are plotted.

Note

For symmetric similarity measures, the histogram will only contain upper-triangular similarity scores (excluding the diagonal). In case of the asymmetric OETversky similarity measure, the histogram for the whole NxN matrix is returned.

 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
def plot_similarity_score_histogram(fpdb, opts, nrbins):
    """
    Plots similarity score histograms

    :type fpdb: oegraphsim.OEFastFPDatabase
    :type opts: oegraphsim.OEFPDatabaseOptions
    :type  nrbins: int
    """

    nrfps = fpdb.NumFingerPrints()
    fptype = fpdb.GetFPTypeBase()
    memtypestr = fpdb.GetMemoryTypeString()
    simfuncstr = oegraphsim.OEGetSimilarityMeasureName(opts.GetSimFunc())

    # get histogram

    timer = oechem.OEWallTimer()
    timer.Start()
    hist = fpdb.GetHistogram(opts, nrbins)
    oechem.OEThrow.Info("%5.2f sec to get histogram for %d fingerprints (%s)" % (timer.Elapsed(), nrfps, memtypestr))

    # plot histogram

    plt.xlim(hist.GetMin(), hist.GetMax())

    centers = [c for c in hist.GetBinCenters()]
    densities = [d for d in hist.GetDensity()]

    plt.plot(centers, densities, 'r', linewidth=2, drawstyle='steps-mid')

    plt.axis([hist.GetMin(), hist.GetMax(), 0.0,  max(densities)])

    plt.title(fptype.GetFPTypeString(), fontsize=10)

    plt.ylabel('Probability', fontsize=18)
    plt.xlabel('Similarity score (%s)' % simfuncstr, fontsize=18)
    plt.yticks(fontsize=16)
    plt.xticks(fontsize=16)

    mean = hist.Mean()
    plt.plot([mean, mean], [0.0, 1.0], linestyle='dashed', color='blue', linewidth=2, label='mean=%.3f' % hist.Mean())

    plt.legend(loc='upper right', fontsize=20)

Usage

Usage

fphist2img.py

First use the makefastfp.py script (described in the Rapid Similarity Searching of Large Molecule Files recipe) with drugs.sdf supporting data to generate a binary fingerprint file.

prompt > python3 makefastfp.py -in drugs.sdf -fpdbfname drugs-tree.fpbin -fptype Tree

Then the fphist2img.py script can be used to plot the histogram of the similarity scores.

prompt > python3 fphist2img.py -fpdbfname drugs-tree.fpbin -out drugs-tree.svg

Command Line Parameters

Simple parameter list
    fingerprint database options
      -memorytype : Fingerprint database memory type

    fingerprint database search options
      -simfunc : Similarity measure

    input/output options
      -fpdbfname : Input filename of binary fingerprint database
      -out : Output filename of the generated image

    histogram options
      -nrbins : Number of bins in the histogram

Discussion

When using GraphSim TK to identify molecules that are similar to a query molecule, no default cutoff value is given. The reason for this that the score distribution highly depends on not only the similarity measure used to calculate the scores (see Table 1) but also the fingerprint types (see Table 2).

Table 1: Histograms of various similarity measures of the same dataset with Tree fingerprint type
Tanimoto Euclid Tversky
Table 2: Histograms of Tanimoto scores of the same dataset with various fingerprint types
Tree Circular Path

Plotting the similarity score distribution of molecules that belong the same activity class as the query as well as molecules with different activity classes could gives an idea about what a reasonable cutoff value would be.

Table 3: Similarity scores of molecule with the same and different activity classes
molecules with same activity class molecules with different activity classes

Performance

the fphist2img.py script can run in three different modes that determine how fingerprints are stored and searched in the OEFastFPDatabase object:

prompt > python3 fphist2img.py --help -memorytype
Contents of parameter -memorytype
   Aliases : -m
   Type : string
   Default : memory-mapped
   Legal values : memory-mapped in-memory CUDA
   Brief : Fingerprint database memory type
   Detail

 API : OEFastFPDatabaseMemoryType namespace
in-memory
The in-memory mode involves pre-loading all fingerprints into memory prior to and performing the search in the memory. While this represents the fastest way to perform similarity searches once the fingerprints are loaded, searches are limited by memory availability.
memory-mapped
The memory-mapped mode has no load time penalty or memory limitation but the search itself takes more time.
CUDA
GPU-enabled calculation that provides 200x faster calculation than the two CPU modes above. CUDA mode involves pre-loading all fingerprints into GPU memory prior to performing similarity calculations. While this represents the fastest way to perform similarity searches once the fingerprints are loaded, searches are limited by GPU memory availability and will fall back to the memory-mapped CPU mode if the entire set of fingerprints cannot be preloaded into the GPU memory.

See also

Graph 1. The performance of generation of similarity score histogram
../_images/fp-histogram-performance.png
  • 16M 4096-bit long tree fingerprints = 8GB data
  • CPU benchmarked on m4.10xlarge AWS instance (single threaded)
  • GPU benchmarked on p3.8xlarge AWS instance
  • In-memory timings are extrapolated from shorter runs

See also in GraphSim TK manual

Theory

API

See also in matplotlib documentation