Name | posebusters JSON |
Version |
0.4.5
JSON |
| download |
home_page | None |
Summary | PoseBusters: Plausibility checks for generated molecule poses. |
upload_time | 2025-07-13 15:16:21 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.9 |
license | None |
keywords |
posebusters
docking
tests
metric
|
VCS |
 |
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|

PoseBusters: Plausibility checks for generated molecule poses.
### Paper in [Chemical Science](https://pubs.rsc.org/en/content/articlelanding/2024/sc/d3sc04185a) and preprint on [arXiv](https://arxiv.org/abs/2308.05777)
## Installation
```bash
# install with pip from PyPI
pip install posebusters
```
<!-- # install with conda from conda-forge
conda install posebusters -c conda-forge -->
## Usage
<!-- ### Command line usage -->
```bash
# Check generated molecule pose.
bust molecule_pred.sdf
bust molecule_a.sdf molecule_b.sdf
bust molecule_*.sdf
# Check new ligand generated for a given protein.
bust ligand_pred.sdf -p mol_cond.pdb
# Check re-docked ligand (a pose that should recover the ligand in a given protein-ligand crystal complex).
bust ligand_pred.sdf -l mol_true.sdf -p protein.pdb
# Check any of the three by providing a csv with files to check together
bust -t file_table.csv
```
<!-- ### Python API
```python
from dockbusters import DockBuster
# check re-docked ligand
DockBuster().bust(ligand_pred_file, ligand_crystal_file, protein_crystal_file)
# check docked ligand
DockBuster().bust(ligand_pred_file, protein_crystal_file)
# check molecule
DockBuster().bust(ligand_pred_file, protein_crystal_file)
``` -->
## Documentation
Documentation is available at [https://posebusters.readthedocs.io](https://posebusters.readthedocs.io).
For more information about the tests and for a study using PoseBusters to compare docking methods, refer to our [paper](http://dx.doi.org/10.1039/D3SC04185A) or [preprint](https://arxiv.org/abs/2308.05777):
```
@article{buttenschoen2024posebusters,
title = {{{PoseBusters}}: {{AI-based}} Docking Methods Fail to Generate Physically Valid Poses or Generalise to Novel Sequences},
shorttitle = {{{PoseBusters}}},
author = {Buttenschoen, Martin and Morris, Garrett M. and Deane, Charlotte M.},
year = "2024",
journal = "Chemical Science",
volume = "15",
issue = "9",
pages = "3130-3139",
publisher = "The Royal Society of Chemistry",
doi = "10.1039/D3SC04185A",
url = "http://dx.doi.org/10.1039/D3SC04185A",
}
```
The data used for the paper is available at [https://zenodo.org/record/8278563](https://zenodo.org/record/8278563).
## Feedback & Contact
We welcome all feedback. For code issues, please open an issue. For other inquiries contact us by email.
## Thanks
This program uses software written by other people. Notably:
- RDKit - [https://github.com/rdkit/rdkit](https://github.com/rdkit/rdkit)
- Pandas - [https://github.com/pandas-dev/pandas](https://github.com/pandas-dev/pandas)
Raw data
{
"_id": null,
"home_page": null,
"name": "posebusters",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "posebusters, docking, tests, metric",
"author": null,
"author_email": "Martin Buttenschoen <martin.buttenschoen@stats.ox.ac.uk>",
"download_url": "https://files.pythonhosted.org/packages/f9/e1/7646585f7620c7689c8542eceb93a09567469b5230cfdf1231d38a948eff/posebusters-0.4.5.tar.gz",
"platform": null,
"description": "\n\nPoseBusters: Plausibility checks for generated molecule poses.\n\n### Paper in [Chemical Science](https://pubs.rsc.org/en/content/articlelanding/2024/sc/d3sc04185a) and preprint on [arXiv](https://arxiv.org/abs/2308.05777)\n\n## Installation\n\n```bash\n# install with pip from PyPI\npip install posebusters\n```\n<!-- # install with conda from conda-forge\nconda install posebusters -c conda-forge -->\n\n## Usage\n\n<!-- ### Command line usage -->\n\n```bash\n\n# Check generated molecule pose.\nbust molecule_pred.sdf\nbust molecule_a.sdf molecule_b.sdf\nbust molecule_*.sdf\n\n# Check new ligand generated for a given protein.\nbust ligand_pred.sdf -p mol_cond.pdb\n\n# Check re-docked ligand (a pose that should recover the ligand in a given protein-ligand crystal complex).\nbust ligand_pred.sdf -l mol_true.sdf -p protein.pdb\n\n# Check any of the three by providing a csv with files to check together\nbust -t file_table.csv\n```\n\n<!-- ### Python API\n\n```python\nfrom dockbusters import DockBuster\n\n# check re-docked ligand\nDockBuster().bust(ligand_pred_file, ligand_crystal_file, protein_crystal_file)\n\n# check docked ligand\nDockBuster().bust(ligand_pred_file, protein_crystal_file)\n\n# check molecule\nDockBuster().bust(ligand_pred_file, protein_crystal_file)\n``` -->\n\n## Documentation\n\nDocumentation is available at [https://posebusters.readthedocs.io](https://posebusters.readthedocs.io).\n\nFor more information about the tests and for a study using PoseBusters to compare docking methods, refer to our [paper](http://dx.doi.org/10.1039/D3SC04185A) or [preprint](https://arxiv.org/abs/2308.05777):\n\n```\n@article{buttenschoen2024posebusters,\n title = {{{PoseBusters}}: {{AI-based}} Docking Methods Fail to Generate Physically Valid Poses or Generalise to Novel Sequences},\n shorttitle = {{{PoseBusters}}},\n author = {Buttenschoen, Martin and Morris, Garrett M. and Deane, Charlotte M.},\n year = \"2024\",\n journal = \"Chemical Science\",\n volume = \"15\",\n issue = \"9\",\n pages = \"3130-3139\",\n publisher = \"The Royal Society of Chemistry\",\n doi = \"10.1039/D3SC04185A\",\n url = \"http://dx.doi.org/10.1039/D3SC04185A\",\n}\n```\n\nThe data used for the paper is available at [https://zenodo.org/record/8278563](https://zenodo.org/record/8278563).\n\n## Feedback & Contact\n\nWe welcome all feedback. For code issues, please open an issue. For other inquiries contact us by email.\n\n## Thanks\n\nThis program uses software written by other people. Notably:\n\n- RDKit - [https://github.com/rdkit/rdkit](https://github.com/rdkit/rdkit)\n- Pandas - [https://github.com/pandas-dev/pandas](https://github.com/pandas-dev/pandas)\n",
"bugtrack_url": null,
"license": null,
"summary": "PoseBusters: Plausibility checks for generated molecule poses.",
"version": "0.4.5",
"project_urls": {
"Documentation": "https://posebusters.readthedocs.io/en/latest/",
"Source": "https://github.com/maabuu/posebusters/",
"Tracker": "https://github.com/maabuu/posebusters/issues/"
},
"split_keywords": [
"posebusters",
" docking",
" tests",
" metric"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b6036989d7d9d65aa19bcc91ea3f78d791141d4be0957a67f90fe82e6495832a",
"md5": "8b2cef6d3f80d42ac3cb012212d51740",
"sha256": "ec8f2b1634b95000efe6c9da0392eefdc681dda07646ef0ed1f4a5efca099ab9"
},
"downloads": -1,
"filename": "posebusters-0.4.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8b2cef6d3f80d42ac3cb012212d51740",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 556376,
"upload_time": "2025-07-13T15:16:20",
"upload_time_iso_8601": "2025-07-13T15:16:20.308410Z",
"url": "https://files.pythonhosted.org/packages/b6/03/6989d7d9d65aa19bcc91ea3f78d791141d4be0957a67f90fe82e6495832a/posebusters-0.4.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f9e17646585f7620c7689c8542eceb93a09567469b5230cfdf1231d38a948eff",
"md5": "1223ec0c14dcdd57dd7a9577afa32929",
"sha256": "d90f22d32f7ce3551d28d23e899059070211c91d7104ae4fbc7229b4696b9146"
},
"downloads": -1,
"filename": "posebusters-0.4.5.tar.gz",
"has_sig": false,
"md5_digest": "1223ec0c14dcdd57dd7a9577afa32929",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 5022845,
"upload_time": "2025-07-13T15:16:21",
"upload_time_iso_8601": "2025-07-13T15:16:21.846080Z",
"url": "https://files.pythonhosted.org/packages/f9/e1/7646585f7620c7689c8542eceb93a09567469b5230cfdf1231d38a948eff/posebusters-0.4.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-13 15:16:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "maabuu",
"github_project": "posebusters",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "posebusters"
}