Skip to main content

A Simple Pharmacophore-Toolkit

Pharmacophore-Toolkit Versions Python Versions Pharmacophore-Toolsets Test Read the Docs

The Pharmacophore-Toolkit is built on RDKit and allows for building simple pharmacophore models. The Pharmacophore-Toolset can generate models from crystal structures, docking poses, or SMILES string. To generate a 3D model, a .pml file will be generated. This files contains scripts to generate spheres with color and XYZ coordinates defined. The final 3D image can be rendered in PyMOL.

Documentation for the project can be found here.

Install

You can install the Pharmacophore-Toolkit using pip:

pip install pharmacophore-toolkit

Alternatively, the environment can be created by cloning the repository and then running the following conda script:

conda env create -f environment.yaml

Tutorials

Tutorials are written as Jupyter Notebooks and can be found here. The 3D drawing tools are also supported in Marimo notebooks, which can be found here. The Pharmacophore-Toolkit can generate several types of images:

Example Images

3D Model

A 3D conformation of molecules and alignment was performed using RDKit. Spheres can be generated for each query molecule to highlight pharmacophore features, such as Hydrogen Bond Donor/Acceptor, Hydrophobic, Aromatic, etc. The molecules can be generated in 3D using two methods:

The 3D model can be interactive in a Jupyter Notebook.
Images rendered in Jupyter Notebook using py3Dmol using a screenshot. The 3D models can also be rendered in Marimo notebooks. Pharmacophore features for each molecule is highlighted. Blue spheres represent Hydrogen Bond Donors, gold spheres for Aromatic rings, and green for Hydrophobes.
Images rendered in PyMOL using the generated .pml file. Molecules are colored using default settings and mirror those found using py3Dmol above. In this example, the spheres are mapped to Serotonin. Blue spheres represent Hydrogen Bond Donors and gold spheres represent Aromatic rings.

2D Model

The pharmacophore features can also be depicted as a 2D image, where each atom is highlighted with their respective pharmacophore features.

2D Pharmacophore images. Images were lightly edited to remove duplicate figure legends.

Similarity Map

For funsies, a method to generate Similarity Maps are also available. Final image generation requires Cairo installation. Additional information on how Similarity Maps work can be found on the RDKit blog.

Similarity map of molecules. All molecules were compared to Serotonin. More information can be seen at the RDKit documentation.

Citation

If you find this helpful in your work, consider a citation:

@software{lin_pharmacophore_toolkit,
  author  = {Lin, Tony Eight},
  title   = {Pharmacophore-Toolkit: Generate Simple Pharmacophore Models with RDKit},
  year    = {2023},
  version = {X.X.X},
  url     = {https://github.com/tlint101/pharmacophore-toolkit}
}

NOTE: Replace 'X.X.X' with the pharmacophore-toolkit version used.

Metadata

Release files for pharmacophore-toolkit 1.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pharmacophore-toolkit 1.2.2
File Size Uploaded
pharmacophore_toolkit-1.2.2.tar.gz 35.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pharmacophore-toolkit 1.2.2
File Interpreter ABI Platform
pharmacophore_toolkit-1.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 72.3 kB

Release files / pharmacophore_toolkit-1.2.2.tar.gz

Download URL pharmacophore_toolkit-1.2.2.tar.gz
Size 35.4 kB
Tags Source
SHA-256 checksum
How to use checksums
275ae4ab0eb660b34d88440b17a7bb7ef6d940772a6b520bb5d77adb6a753923
BLAKE2b-256 checksum
How to use checksums
7088d2e8e3bf8d91df1c387b6e79b1e2844a759a45e4cdd2449e1a2c413517c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.2.1 CPython/3.14.6 Darwin/25.6.0

Release files / pharmacophore_toolkit-1.2.2-py3-none-any.whl

Download URL pharmacophore_toolkit-1.2.2-py3-none-any.whl
Size 36.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
168eac99af4201d0c707157baca7211850a53fb785ee48c7f4b2c546fc7077a0
BLAKE2b-256 checksum
How to use checksums
5cdb0c30ebbad37c20541b2b685591a67b161acdf0d009d473d829333a962fa4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.2.1 CPython/3.14.6 Darwin/25.6.0

Release history Release notifications | RSS feed

This release

1.2.2 This release

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.0

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page