| Name | posebusters JSON |
| Version |
0.5.0
JSON |
| download |
| home_page | None |
| Summary | PoseBusters: Plausibility checks for generated molecule poses. |
| upload_time | 2025-09-01 15:51:24 |
| 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/9a/2e/69ea5238ebecd0ab5e3d8431b64d1248f5b490803e94da4defc5e515257c/posebusters-0.5.0.tar.gz",
"platform": null,
"description": "![posebusters_banner](https://github.com/maabuu/posebusters/blob/b5f4c2caed1499c2b73f5297a08e60ec7d263c61/docs/source/_static/logo_banner.png?raw=true \"PoseBusters\")\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.5.0",
"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": "3256752da7003b037d9984127f71095249ac12a46cd8c50896326427f77ccfe8",
"md5": "674859a783a66516634a7263dfdb34b3",
"sha256": "b060630bd279ada2663f33a5f588d4d53effd772b2cb26d03acd4cfa42159ff8"
},
"downloads": -1,
"filename": "posebusters-0.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "674859a783a66516634a7263dfdb34b3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 566793,
"upload_time": "2025-09-01T15:51:22",
"upload_time_iso_8601": "2025-09-01T15:51:22.534342Z",
"url": "https://files.pythonhosted.org/packages/32/56/752da7003b037d9984127f71095249ac12a46cd8c50896326427f77ccfe8/posebusters-0.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9a2e69ea5238ebecd0ab5e3d8431b64d1248f5b490803e94da4defc5e515257c",
"md5": "595b3cdee8d58eb32c52d01948273f1b",
"sha256": "3ea75a92fdb3338036bf490bdb9e693f9cc528f0f2a97785f9783e2274033e3b"
},
"downloads": -1,
"filename": "posebusters-0.5.0.tar.gz",
"has_sig": false,
"md5_digest": "595b3cdee8d58eb32c52d01948273f1b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 5023689,
"upload_time": "2025-09-01T15:51:24",
"upload_time_iso_8601": "2025-09-01T15:51:24.435293Z",
"url": "https://files.pythonhosted.org/packages/9a/2e/69ea5238ebecd0ab5e3d8431b64d1248f5b490803e94da4defc5e515257c/posebusters-0.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-01 15:51:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "maabuu",
"github_project": "posebusters",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "posebusters"
}
