pdbeccdutils
An RDKit-based python toolkit for parsing and processing small molecule definitions in wwPDB Chemical Component Dictionary and wwPDB The Biologically Interesting Molecule Reference Dictionary.pdbeccdutils provides streamlined access to all metadata of small molecules in the PDB and offers a set of convenient methods to compute various properties of small molecules using RDKIt such as 2D depictions, 3D conformers, physicochemical properties, matching common fragments and scaffolds, mapping to small-molecule databases using UniChem.
Features
gemmiCCD read/write.- Generation of 2D depictions (
No image availablegenerated if the flattening cannot be done) along with the quality check. - Generation of 3D conformations.
- Fragment library search (PDBe hand-curated library, ENAMINE, DSI).
- Chemical scaffolds (Murcko scaffold, Murcko general, BRICS).
- Lightweight implementation of parity method by Jon Tyzack.
- RDKit molecular properties per component.
- UniChem mapping.
- Generating complete representation of multiple Covalently Linked Components (CLC)
Dependencies
- RDKit for small molecule representation. Presently tested with
2023.9.6 - GEMMI for parsing mmCIF files.
- scipy for depiction quality check.
- numpy for molecular scaling.
- networkx for bound-molecules.
Installation
create a virtual environment and install using pip
pip install pdbeccdutils
Contribution
We encourage you to contribute to this project. The package uses poetry for packaging and dependency management. You can develop locally using:
git clone https://github.com/PDBeurope/ccdutils.git
cd ccdutils
pip install poetry
poetry install --with tests,docs
pre-commit install
The pre-commit hook will run linting, formatting and update poetry.lock. The poetry.lock file will lock all dependencies and ensure that they match pyproject.toml versions.
To add a new dependency
# Latest resolvable version
poetry add <package>
# Optionally fix a version
poetry add <package>@<version>
To change a version of a dependency, either edit pyproject.toml and run:
poetry sync --with dev
or
poetry add <package>@<version>
Documentation
The documentation is generated using sphinx in sphinx_rtd_theme and hosted on GitHub Pages. To generate the documentation locally,
cd doc
poetry run sphinx-build -b html . _build/html
# See the documentation at http://localhost:8080.
python -m http.server 8080 -d _build/html
1 maintainer
Release files for pdbeccdutils 1.0.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pdbeccdutils-1.0.4.tar.gz | 1.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pdbeccdutils-1.0.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.2 MB
Release files / pdbeccdutils-1.0.4.tar.gz
| Download URL | pdbeccdutils-1.0.4.tar.gz |
|---|---|
| Size | 1.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
aa9d4ff0832becce7d60508a1355838e9c0aba780631b51accde6e797da57db6
|
|
BLAKE2b-256 checksum How to use checksums |
166205fd7611d09fe43276a685c7498b77282ebacda31a096460b696a8d4ed47
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / pdbeccdutils-1.0.4-py3-none-any.whl
| Download URL | pdbeccdutils-1.0.4-py3-none-any.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fb664589ddd9fc593bc14294daa581e2245475021f6b77d72273f6142da843ba
|
|
BLAKE2b-256 checksum How to use checksums |
192642d94dfb9667fadedb91427eb03db917cd4c828c4a284456a004b3072dc3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
