posebusters


Nameposebusters JSON
Version 0.2.12 PyPI version JSON
download
home_pageNone
SummaryPoseBusters: Plausibility checks for generated molecule poses.
upload_time2024-03-19 15:44:42
maintainerNone
docs_urlNone
authorNone
requires_python~=3.7
licenseNone
keywords posebusters docking tests metric
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ![posebusters_banner](https://github.com/maabuu/posebusters/blob/b5f4c2caed1499c2b73f5297a08e60ec7d263c61/docs/source/_static/logo_banner.png?raw=true "PoseBusters")

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](https://pubs.rsc.org/en/content/articlelanding/2024/sc/d3sc04185a) or [preprint](https://arxiv.org/abs/2308.05777):

```
@article{buttenschoen2023posebusters,
  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 = "2023",
  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.7",
    "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/23/99/502954a2eb3343813a8dc67a0148f4002aad91eb9033eb6088b59b46de07/posebusters-0.2.12.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](https://pubs.rsc.org/en/content/articlelanding/2024/sc/d3sc04185a) or [preprint](https://arxiv.org/abs/2308.05777):\n\n```\n@article{buttenschoen2023posebusters,\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 = \"2023\",\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.2.12",
    "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": "83f31ec63bb6143470881bfa11905191564ccb5ecf3cdb1842ea33006e1b851b",
                "md5": "d1dd47e5abc77c53e6e3c44cec356d71",
                "sha256": "c090375828522e3e76151dcc5fbbc8e06d17ffea0f1d7aa7be301185db1bb76b"
            },
            "downloads": -1,
            "filename": "posebusters-0.2.12-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "d1dd47e5abc77c53e6e3c44cec356d71",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": "~=3.7",
            "size": 551001,
            "upload_time": "2024-03-19T15:44:40",
            "upload_time_iso_8601": "2024-03-19T15:44:40.958463Z",
            "url": "https://files.pythonhosted.org/packages/83/f3/1ec63bb6143470881bfa11905191564ccb5ecf3cdb1842ea33006e1b851b/posebusters-0.2.12-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "2399502954a2eb3343813a8dc67a0148f4002aad91eb9033eb6088b59b46de07",
                "md5": "2f4e084008334b03eec67c0d58a3a4d6",
                "sha256": "233b75aa31d62c6de622ccc5d7e532cb3814f759fcbc22652429881dea7b8197"
            },
            "downloads": -1,
            "filename": "posebusters-0.2.12.tar.gz",
            "has_sig": false,
            "md5_digest": "2f4e084008334b03eec67c0d58a3a4d6",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "~=3.7",
            "size": 4824325,
            "upload_time": "2024-03-19T15:44:42",
            "upload_time_iso_8601": "2024-03-19T15:44:42.531466Z",
            "url": "https://files.pythonhosted.org/packages/23/99/502954a2eb3343813a8dc67a0148f4002aad91eb9033eb6088b59b46de07/posebusters-0.2.12.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-19 15:44:42",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "maabuu",
    "github_project": "posebusters",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "posebusters"
}
        
Elapsed time: 0.20852s