{ "info": { "author": "Joao Rodrigues", "author_email": "j.p.g.l.m.rodrigues@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Science/Research", "License :: OSI Approved :: Apache Software License", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Scientific/Engineering", "Topic :: Scientific/Engineering :: Bio-Informatics", "Topic :: Scientific/Engineering :: Chemistry" ], "description": "# pdb-tools\n\n[![PyPI version](https://badge.fury.io/py/pdb-tools.svg)](https://badge.fury.io/py/pdb-tools)\n[![Travis (.org) branch](https://img.shields.io/travis/haddocking/pdb-tools/master.svg?style=flat&label=TravisCI)](https://travis-ci.org/haddocking/pdb-tools)\n[![AppVeyor branch](https://img.shields.io/appveyor/ci/JoaoRodrigues/pdb-tools-2coq6.svg?style=flat&label=AppVeyor)](https://ci.appveyor.com/project/JoaoRodrigues/pdb-tools-2coq6)\n[![codecov](https://codecov.io/gh/haddocking/pdb-tools/branch/master/graph/badge.svg)](https://codecov.io/gh/haddocking/pdb-tools)\n[![DOI](https://zenodo.org/badge/27217350.svg)](https://zenodo.org/badge/latestdoi/27217350)\n\nA swiss army knife for manipulating and editing PDB files.\n\n\n## Looking for the _other_ pdb-tools?\nThe Harms lab maintains a set of tools also called `pdbtools`, which perform a\nslightly different set of functions. You can find them [here](https://github.com/harmslab/pdbtools).\n\n\n## About\nManipulating PDB files is often painful. Extracting a particular chain or set of\nresidues, renumbering residues, splitting or merging models and chains, or just\nensuring the file is conforming to the PDB specifications are examples of tasks\nthat can be done using any decent parsing library or graphical interface. These,\nhowever, almost always require 1) scripting knowledge, 2) time, and 3) installing\none or more programs.\n\n`pdb-tools` were designed to be a swiss-knife for the PDB format. They have no\nexternal dependencies, besides obviously the [Python programming language](http://www.python.org).\nThey are the descendant of a set of old FORTRAN77 programs that had the \nparticular advantage of working with streams, i.e. the output of one script \ncould be piped into another. Since FORTRAN77 is a pain too, I rewrote them in\nPython and added a few more utilities. \n\nThe philosophy of the scripts is simple: one script, one task. If you want to \ndo two things, pipe the scripts together. Requests for new scripts will be taken\ninto consideration - use the Issues button or write them yourself and create a\nPull Request.\n\n\n## Installation Instructions\n`pdb-tools` are available on PyPi and can be installed though `pip`. This is the\nrecommended way as it makes updating/uninstalling rather simple:\n```bash\npip install pdb-tools\n```\n\nIf you want to install the latest development version, which might give you new\nfeatures but also some bugs, see [here](#Installing-from-Source).\n\n\n## What can I do with them?\nThe names of the tools should be self-explanatory. Their command-line interface\nis also pretty consistent. Therefore, here is a couple of examples to get you\nstarted:\n\n* Downloading a structure\n ```bash\n pdb_fetch 1brs > 1brs.pdb # 6 chains\n pdb_fetch -biounit 1brs > 1brs.pdb # 2 chains\n ```\n\n* Renumbering a structure\n ```bash\n pdb_reres -1 1ctf.pdb > 1ctf_renumbered.pdb\n ```\n\n* Selecting chain(s)\n ```bash\n pdb_selchain -A 1brs.pdb > 1brs_A.pdb\n pdb_selchain -A,D 1brs.pdb > 1brs_AD.pdb\n ```\n\n* Deleting hydrogens\n ```bash\n pdb_delelem -H 1brs.pdb > 1brs_noH.pdb\n ```\n\n* Selecting backbone atoms\n ```bash\n pdb_selatom -CA,C,N,O 1brs.pdb > 1brs_bb.pdb\n ```\n\n* Selecting chains, removing HETATM, and producing a valid PDB file\n ```bash\n pdb_selchain -A,D 1brs.pdb | pdb_delhetatm | pdb_tidy > 1brs_AD_noHET.pdb\n ```\n\n*Note: On Windows the tools will have the `.exe` extension.*\n\n\n## What _can't_ I do with them?\nOperations that involve coordinates or numerical calculations are usually not in\nthe scope of `pdb-tools`. Use a proper library for that, it will be much faster\nand scalable. Also, although we provide mmCIF<->PDB converters, we do not support\nlarge mmCIF files with more than 99999 atoms, or 9999 residues in a single chain.\nOur tools will complain if you try using them on such a molecule. \n\n\n## Citation\nWe finally decided to write up a small publication describing the tools. If you\nused them in a project that is going to be published, please cite us:\n\n```\nRodrigues, J. P. G. L. M., Teixeira, J. M. C., Trellet, M. & Bonvin, A. M. J. J.\npdb-tools: a swiss army knife for molecular structures. bioRxiv (2018). \ndoi:10.1101/483305\n```\n\nIf you use a reference manager that supports BibTex, use this record:\n```\n@article {Rodrigues483305,\n author = {Rodrigues, Jo{\\~a}o P.G.L.M. and Teixeira, Jo{\\~a}o M.C. and Trellet, Mika{\\\"e}l and Bonvin, Alexandre M.J.J.},\n title = {pdb-tools: a swiss army knife for molecular structures},\n elocation-id = {483305},\n year = {2018},\n doi = {10.1101/483305},\n publisher = {Cold Spring Harbor Laboratory},\n abstract = {The pdb-tools are a collection of Python scripts for working with molecular structure data in the PDB format. They allow users to edit, convert, and validate PDB files, from the command-line, in a simple but efficient manner. The pdb-tools are implemented in Python, without any external dependencies, and are freely available under the open-source Apache License at https://github.com/haddocking/pdb-tools/ and on PyPI (https://pypi.org/project/pdb-tools/).},\n URL = {https://www.biorxiv.org/content/early/2018/12/04/483305},\n eprint = {https://www.biorxiv.org/content/early/2018/12/04/483305.full.pdf},\n journal = {bioRxiv}\n}\n```\n\n## Requirements\n`pdb-tools` should run on Python 2.7+ and Python 3.x. We test on Python 2.7, 3.6,\nand 3.7. There are no dependencies.\n\n\n## Installing from Source\nDownload the zip archive or clone the repository with git. We recommend the `git`\napproach since it makes updating the tools extremely simple.\n\n```bash\n# To download\ngit clone https://github.com/haddocking/pdb-tools\ncd pdb-tools\n\n# To update\ngit pull origin master\n\n# To install\npython setup.py install\n```\n\n## Contributing\nIf you want to contribute to the development of `pdb-tools`, provide a bug fix,\nor a new tools, read our `CONTRIBUTING` instructions [here](https://github.com/haddocking/pdb-tools/blob/master/CONTRIBUTING.md).\n\n## License\n`pdb-tools` are open-source and licensed under the Apache License, version 2.0.\nFor details, see the LICENSE file.\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://bonvinlab.org/pdb-tools", "keywords": "bioinformatics protein structural-biology pdb", "license": "Apache Software License, version 2", "maintainer": "", "maintainer_email": "", "name": "pdb-tools", "package_url": "https://pypi.org/project/pdb-tools/", "platform": "", "project_url": "https://pypi.org/project/pdb-tools/", "project_urls": { "Bug Reports": "https://github.com/haddocking/pdb-tools/issues", "Homepage": "http://bonvinlab.org/pdb-tools", "Source": "https://github.com/haddocking/pdb-tools" }, "release_url": "https://pypi.org/project/pdb-tools/2.0.0/", "requires_dist": null, "requires_python": "", "summary": "A swiss army knife for PDB files.", "version": "2.0.0" }, "last_serial": 5458881, "releases": { "2.0.0": [ { "comment_text": "", "digests": { "md5": "c056c031cc28ea10ef097e6cabc36614", "sha256": "2cbb9a79deee8ff64db7502732caac0aeefc3f2c672164a80d01d7bb6f180ac6" }, "downloads": -1, "filename": "pdb_tools-2.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "c056c031cc28ea10ef097e6cabc36614", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 175699, "upload_time": "2019-06-27T20:48:06", "url": "https://files.pythonhosted.org/packages/db/39/a2bca197e9ce636da023e461697b333d99c8fc5e00438ee7c199f0684d88/pdb_tools-2.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ffb304e8e0aa4b385601b1314dd312e1", "sha256": "660e6b67ced3eaf151b31eb2f5513b25c2429ab4a7870ecd4fb81f3b08e7b625" }, "downloads": -1, "filename": "pdb-tools-2.0.0.tar.gz", "has_sig": false, "md5_digest": "ffb304e8e0aa4b385601b1314dd312e1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 44386, "upload_time": "2019-06-27T20:48:07", "url": "https://files.pythonhosted.org/packages/e9/6f/b627405007012d4a0866e43acccefc28a2b21f58864dc8f0682df6873f13/pdb-tools-2.0.0.tar.gz" } ], "2.0.0b1": [ { "comment_text": "", "digests": { "md5": "566a80218e63cda3aca2d9ca1bac0b5c", "sha256": "e2b0f57487a1795bffc90c42aaf34ebba7af948fac851b94ead8a231c9a4f816" }, "downloads": -1, "filename": "pdb_tools-2.0.0b1-py3-none-any.whl", "has_sig": false, "md5_digest": "566a80218e63cda3aca2d9ca1bac0b5c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 79822, "upload_time": "2018-11-13T19:56:03", "url": "https://files.pythonhosted.org/packages/92/da/36c58eb320b6e7cb8c16929569b46cff3159ed870d8c09d8f87beaab4c92/pdb_tools-2.0.0b1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bd7f94980785b0d119717570de43eaf9", "sha256": "f358b06f6193c555160e315de4864125add910452d4a6857afc96673e95fb2f9" }, "downloads": -1, "filename": "pdb-tools-2.0.0b1.tar.gz", "has_sig": false, "md5_digest": "bd7f94980785b0d119717570de43eaf9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 26007, "upload_time": "2018-11-13T19:56:05", "url": "https://files.pythonhosted.org/packages/54/b5/d43597b244fffe5c4c52dd1414ba070efde15f4a724336b3c6c403f30c63/pdb-tools-2.0.0b1.tar.gz" } ], "2.0.0b2": [ { "comment_text": "", "digests": { "md5": "85b149836de61442c6c15649e35f093d", "sha256": "82348cd379d9062042a8f352b08cad4e77ff81cae7e577669f179b050d0cfeae" }, "downloads": -1, "filename": "pdb_tools-2.0.0b2-py3-none-any.whl", "has_sig": false, "md5_digest": "85b149836de61442c6c15649e35f093d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 155754, "upload_time": "2018-11-27T10:58:08", "url": "https://files.pythonhosted.org/packages/5c/e7/59a199f002c1406df03a6c4240f8d75014c406d1aca10726685a15636e79/pdb_tools-2.0.0b2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0de26440ef6feb1a1616f16a4e0285ef", "sha256": "df96136fc3c538c9c4332c293b63490c87f3808f12728a38689d6087fcbd5e3d" }, "downloads": -1, "filename": "pdb-tools-2.0.0b2.tar.gz", "has_sig": false, "md5_digest": "0de26440ef6feb1a1616f16a4e0285ef", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45079, "upload_time": "2018-11-27T10:58:10", "url": "https://files.pythonhosted.org/packages/d9/5c/ca6c73a10cd4b7315e1d0876cace43c69dad27f9eb4b5a14e2033560d979/pdb-tools-2.0.0b2.tar.gz" } ], "2.0.0b3": [ { "comment_text": "", "digests": { "md5": "cceaa4c6df262ec9c76cfc8a83dbc1b4", "sha256": "a5aa23ef779c5674464e041ff7e7756c63b9f7ad8d49e126445888b41b2e6dec" }, "downloads": -1, "filename": "pdb_tools-2.0.0b3-py3-none-any.whl", "has_sig": false, "md5_digest": "cceaa4c6df262ec9c76cfc8a83dbc1b4", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 155704, "upload_time": "2018-11-29T20:20:34", "url": "https://files.pythonhosted.org/packages/6f/cd/bc667ffa00d84258d6a1c557bb1cdd2fa8eabf7e6fad93f44bc030f566e1/pdb_tools-2.0.0b3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f17e3b4689f8507c022c256d97eebb6f", "sha256": "9b770a9ebaddea33b1938a6d309393613764036defbb9ae8b7738b31757c3715" }, "downloads": -1, "filename": "pdb-tools-2.0.0b3.tar.gz", "has_sig": false, "md5_digest": "f17e3b4689f8507c022c256d97eebb6f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 42789, "upload_time": "2018-11-29T20:20:35", "url": "https://files.pythonhosted.org/packages/68/7d/fb3db62b3b1094cbe54a4e3ee6a8defc673f4d5860860f76aeb6d080c714/pdb-tools-2.0.0b3.tar.gz" } ], "2.0.0b4": [ { "comment_text": "", "digests": { "md5": "930fe7be091f3552d9bfbde2a5f99e19", "sha256": "f73d01821a41a0ea0057d444b98973bfb4033622a026de45d62fae01029664b2" }, "downloads": -1, "filename": "pdb_tools-2.0.0b4-py3-none-any.whl", "has_sig": false, "md5_digest": "930fe7be091f3552d9bfbde2a5f99e19", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 155719, "upload_time": "2018-11-30T01:23:11", "url": "https://files.pythonhosted.org/packages/51/56/d9c2efa897328f9f034d11736d26c9f304ded1e278f2f0f2651ebcc1a2ad/pdb_tools-2.0.0b4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8dd60ca4b23387dbc29fdf2715574f8a", "sha256": "8831b05412eb286705ee96d203f309ce8edf473bedd09b43b0f8cb4bb40b0bfa" }, "downloads": -1, "filename": "pdb-tools-2.0.0b4.tar.gz", "has_sig": false, "md5_digest": "8dd60ca4b23387dbc29fdf2715574f8a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 42810, "upload_time": "2018-11-30T01:23:13", "url": "https://files.pythonhosted.org/packages/5d/28/8a5100a52af89466ac31b221032e3a774c23620836120b3510c84d73d3a4/pdb-tools-2.0.0b4.tar.gz" } ], "2.0.0b5": [ { "comment_text": "", "digests": { "md5": "f8d14a2ca584fbc03da41c081d45a4e7", "sha256": "0a1473d71da21a1653ee87241d34a51a3fa7606f1422a62ac499b1cf8d5b961c" }, "downloads": -1, "filename": "pdb_tools-2.0.0b5-py3-none-any.whl", "has_sig": false, "md5_digest": "f8d14a2ca584fbc03da41c081d45a4e7", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 155715, "upload_time": "2018-12-03T18:59:36", "url": "https://files.pythonhosted.org/packages/8c/ad/9e5d3053e40bf2e5a20276f77f0090f4afd9ed4380dc2f4e2efc25cf464e/pdb_tools-2.0.0b5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "34894c996dd3630ffa6f75de3e31f25d", "sha256": "426323ab34383832f62415c9ccdb08adad768ade47516ea7d0b821d045af948a" }, "downloads": -1, "filename": "pdb-tools-2.0.0b5.tar.gz", "has_sig": false, "md5_digest": "34894c996dd3630ffa6f75de3e31f25d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 42826, "upload_time": "2018-12-03T18:59:38", "url": "https://files.pythonhosted.org/packages/5d/07/e43b54e6a3dd2dc408d389ed35d071acaaf6b38c054814d7aabfd940ee26/pdb-tools-2.0.0b5.tar.gz" } ], "2.0.0b6": [ { "comment_text": "", "digests": { "md5": "2ca1c0a38d3d51dea7d692e2cbb259bf", "sha256": "248ec6bf66384bf80e81147005fb428eb52be35ca69814641013d547e6705cc7" }, "downloads": -1, "filename": "pdb_tools-2.0.0b6-py3-none-any.whl", "has_sig": false, "md5_digest": "2ca1c0a38d3d51dea7d692e2cbb259bf", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 156170, "upload_time": "2018-12-05T00:55:19", "url": "https://files.pythonhosted.org/packages/21/b2/63aac5325cbd0c812ec7b45003a542d00c35e94bace767fcd695e27567c5/pdb_tools-2.0.0b6-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ba165c02282c23d24bb6b7d1513295b4", "sha256": "42c69e7a710489b064d34ad2443175f4334c1a2f83137d64466af299346a71e4" }, "downloads": -1, "filename": "pdb-tools-2.0.0b6.tar.gz", "has_sig": false, "md5_digest": "ba165c02282c23d24bb6b7d1513295b4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 40662, "upload_time": "2018-12-05T00:55:30", "url": "https://files.pythonhosted.org/packages/89/77/e9f2bc5d7b95a00eae6f1519dc74e1841c15275f7131d6648aae03d0bfc4/pdb-tools-2.0.0b6.tar.gz" } ], "2.0.0b7": [ { "comment_text": "", "digests": { "md5": "af907b39b1834aa076e33bf8f42bf011", "sha256": "bd809765ee108ce8cb128a13e86a64c0fb00823d5b2c307b0ff061a2eef35163" }, "downloads": -1, "filename": "pdb_tools-2.0.0b7-py3-none-any.whl", "has_sig": false, "md5_digest": "af907b39b1834aa076e33bf8f42bf011", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 164902, "upload_time": "2018-12-07T06:07:58", "url": "https://files.pythonhosted.org/packages/26/b2/6880a741d1a31779dff4263048fa3eb832e43fb3ae7887193425984cafa9/pdb_tools-2.0.0b7-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1c95dbc1d4ffa1e4824106d12a061ddb", "sha256": "d454ab195d43453de8fd0408912ab1965c76991c9c4ec22f557ce8ee619400b1" }, "downloads": -1, "filename": "pdb-tools-2.0.0b7.tar.gz", "has_sig": false, "md5_digest": "1c95dbc1d4ffa1e4824106d12a061ddb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 43049, "upload_time": "2018-12-07T06:07:59", "url": "https://files.pythonhosted.org/packages/02/30/b94bdfc798230818e8ffb965974a15dd12365493c6682ef336b2e1565b45/pdb-tools-2.0.0b7.tar.gz" } ], "2.0.0rc1": [ { "comment_text": "", "digests": { "md5": "e4de5a1990db086c3295d5c467554187", "sha256": "e0d2c022d977184d718034f79a89fcd070c45962a46370a3d2defe5b74d359c0" }, "downloads": -1, "filename": "pdb_tools-2.0.0rc1-py3-none-any.whl", "has_sig": false, "md5_digest": "e4de5a1990db086c3295d5c467554187", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 167276, "upload_time": "2018-12-10T18:13:30", "url": "https://files.pythonhosted.org/packages/bd/e8/739e5a9098336d72b8ab0918220b2774a2465512780a13d95a397def0ea2/pdb_tools-2.0.0rc1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1d79b5c9962520126812dd88b7a02b79", "sha256": "18aec8b0995334350d27d950a2184e2860c50291e32f4d809cd0f10722342421" }, "downloads": -1, "filename": "pdb-tools-2.0.0rc1.tar.gz", "has_sig": false, "md5_digest": "1d79b5c9962520126812dd88b7a02b79", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 43428, "upload_time": "2018-12-10T18:13:32", "url": "https://files.pythonhosted.org/packages/5c/a6/8031ac528cd215b54fd7e1decd6012ab7b14b4245c64b058ef5704699d3e/pdb-tools-2.0.0rc1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "c056c031cc28ea10ef097e6cabc36614", "sha256": "2cbb9a79deee8ff64db7502732caac0aeefc3f2c672164a80d01d7bb6f180ac6" }, "downloads": -1, "filename": "pdb_tools-2.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "c056c031cc28ea10ef097e6cabc36614", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 175699, "upload_time": "2019-06-27T20:48:06", "url": "https://files.pythonhosted.org/packages/db/39/a2bca197e9ce636da023e461697b333d99c8fc5e00438ee7c199f0684d88/pdb_tools-2.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ffb304e8e0aa4b385601b1314dd312e1", "sha256": "660e6b67ced3eaf151b31eb2f5513b25c2429ab4a7870ecd4fb81f3b08e7b625" }, "downloads": -1, "filename": "pdb-tools-2.0.0.tar.gz", "has_sig": false, "md5_digest": "ffb304e8e0aa4b385601b1314dd312e1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 44386, "upload_time": "2019-06-27T20:48:07", "url": "https://files.pythonhosted.org/packages/e9/6f/b627405007012d4a0866e43acccefc28a2b21f58864dc8f0682df6873f13/pdb-tools-2.0.0.tar.gz" } ] }