pdbeccdutils 0.5.6

Toolkit to deal with wwPDB chemical components definitions for small molecules.

pdbeccdutils

• A set of python tools to deal with PDB chemical components definitions for small molecules, taken from the wwPDB Chemical Component Dictionary

• The tools use:

  • RDKit for chemistry
  • PDBeCIF cif parser.
  • scipy for depiction quality check.
  • numpy for molecular scaling.

• Please note that the project is under active development.

Installation instructions

• pdbeccdutils requires RDKit to be installed. The official RDKit documentation has installation instructions for a variety of platforms. For linux/mac OS this is most easily done using the anaconda python with commands similar to:

  conda create -c conda-forge -n rdkit-env rdkit python=3.7
  conda activate rdkit-env
  

• Once you have installed RDKit, as described above then install pdbeccdutils using pip:

  pip install pdbeccdutils
  

Features

• mmCIF CCD read/write.
• Generation of 2D depictions (No image available generated if the flattening cannot be done) along with the quality check.
• Generation of 3D conformations.
• Fragment library search.
• Chemical scaffolds (Murcko scaffold, Murcko general, BRICS).
• Lightweight implementation of parity method by Jon Tyczak.
• RDKit molecular properties per component.
• UniChem mapping.

TODO list

• Port rest of the important functionality implemented by Oliver
• Add more unit/regression tests to get at least 100% code coverage.
• Further improvement of the documentation.

Notes

• Protein-ligand interaction has been extracted here. This was because of the fact that at the end of the day it was not using any of the pdbeccdutils functionality and introduced additional dependencies on the package.

Documentation

The documentation depends on the following packages:

• sphinx
• sphinx_rtd_theme
• recommonmark
• sphinx-autodoc-typehints

Note that sphinx needs to be a part of the virtual environment, if you want to generate documentation by yourself. Otherwise it cannot pick rdkit module. sphinx_rtd_theme is a theme providing nice ReadtheDocs mobile friendly style.

• Generate .rst files to be included as a part of the documentation. Inside the directory pdbeccdutils/doc run the following commands to generate documentation.
• Alternatively, use the recommonmark package along with the proper configuration to get the Markdown working.

Use the following to generate initial markup files to be used by sphinx. This needs to be used when adding another sub-packages.

sphinx-apidoc -f -o /path/to/output/dir ../pdbeccdutils/

Use this to re-generate the documentation from the doc/ directory:

make html