[](https://badge.fury.io/py/proteusPy)
[](https://joss.theoj.org/papers/45de839b48a550d6ab955c5fbbc508f2)
[](http://makeapullrequest.com)
# Summary
**proteusPy** is a Python package specializing in the modeling and analysis of proteins of known structure with an emphasis on Disulfide bonds. This package reprises my molecular modeling program [Proteus](https://doi.org/10.1021/bi00368a023), a structure-based program developed as part of my graduate thesis. The package relies on the [Turtle3D](https://suchanek.github.io/proteusPy/proteusPy/turtle3D.html) class to create and manipulate local coordinate systems. It does this by implementing the functions ``Move``, ``Roll``, ``Yaw``, ``Pitch`` and ``Turn`` for movement in a three-dimensional space. The initial implementation focuses on the [Disulfide](https://suchanek.github.io/proteusPy/proteusPy/Disulfide.html) class. The class implements methods to analyze the protein structure stabilizing element known as a *Disulfide Bond*. This class and its underlying methods are being used to perform a structural analysis of over 35,800 disulfide-bond containing proteins in the RCSB protein data bank (https://www.rcsb.org).
# General Capabilities
- Interactively display disulfides contained in the RCSB in a variety of display styles
- Calculate geometric and energetic properties about these disulfides
- Create binary and sextant structural classes by characterizing the disulfide torsional angles into *n* classes
- Build idealized disulfide bonds from dihedral angle input
- Find disulfide neighbors based on dihedral angle input
- Overlap disulfides onto a common frame of reference for display
- Build protein backbones from backbone phi, psi dihedral angle templates
- More in development
*See [API Reference](https://suchanek.github.io/proteusPy/proteusPy.html) for the API documentation with examples*.
# Requirements
1. PC running MacOS, Linux, Windows with git, git-lfs, make and C compiler installed.
2. 8 GB RAM
3. 1 GB disk space
# Installation
It's simplest to clone the repo via GitHub since it contains all of the notebooks, data and test programs. Installation includes installing my Biopython fork which is required to rebuild the database (this is not needed generally). I highly recommend using Miniforge since it includes mamba. The installation instructions below assume a clean install with no package manager or compiler installed.
## MacOS/Linux
- Install Miniforge: <https://github.com/conda-forge/miniforge> (existing Anaconda installations are fine but please install mamba)
- Install git-lfs:
- <https://help.github.com/en/github/managing-large-files/installing-git-large-file-storage>
- Install `make` on your system.
- From a shell prompt while sitting in your repo dir:
```console
$ git clone https://github.com/suchanek/proteusPy.git
$ cd proteusPy
$ make pkg
$ conda activate proteusPy
$ make install
```
## Windows
- Install Miniforge: <https://github.com/conda-forge/miniforge> (existing Anaconda installations are fine but please install mamba)
- Install git for Windows and configure for Bash:
- https://git-scm.com/download/win
- Install git-lfs:
- https://git-lfs.github.com/
- Install GNU make:
- https://gnuwin32.sourceforge.net/packages/make.htm
- Open a Miniforge prompt and cd into your repo dir:
```console
(base) C:\Users\egs\repos> git clone https://github.com/suchanek/proteusPy.git
(base) C:\Users\egs\repos> cd proteusPy
(base) C:\Users\egs\repos\proteuspy> make pkg
(base) C:\Users\egs\repos>\proteuspy> conda activate proteusPy
(proteusPy) C:\Users\egs\repos> make install
```
# Testing
I currently have ``pytest`` and docstring testing for the modules in place. To run them ``cd`` into the repository and run:
```console
$ make tests
```
The modules will run their docstring tests and disulfide visualization windows will open. Simply close them. If all goes normally there will be no errors. If you're not running the development version of proteusPy you may need to install ``pytest``. Simply perform: ``pip install pytest``. Docstring testing is sensitive to formatting; occasionally the ``black`` formatter changes the docstrings. As a result there may be some docstring tests that fail.
# Usage
Once the package is installed it's possible to load, visualize and analyze the Disulfide bonds in the RCSB Disulfide database. The general approach is:
- Load the database
- Access disulfide(s)
- Analyze
- Visualize
A simple example is shown below:
```python
import proteusPy
from proteusPy import Load_PDB_SS, Disulfide
PDB_SS = Load_PDB_SS(verbose=True)
best_ss = PDB_SS["2q7q_75D_140D"]
best_ss.display(style="sb", light=True)
```
The [notebooks](https://github.com/suchanek/proteusPy/blob/master/notebooks/) directory contains my Jupyter notebooks and is a good place to start:
- [Analysis_2q7q.ipynb](https://github.com/suchanek/proteusPy/blob/master/notebooks/Analysis_2q7q.ipynb) provides an example of visualizing the lowest energy Disulfide contained in the database and searching for nearest neighbors on the basis of conformational similarity.
- [Anearest_relatives.ipynb](https://github.com/suchanek/proteusPy/blob/master/notebooks/Anearest_relatives.ipynb) gives an example of searching for disulfides based on sequence similarity.
The [programs](https://github.com/suchanek/proteusPy/tree/master/programs) subdirectory contains the primary programs for downloading the RCSB disulfide-containing structure files, extracting the disulfides and creating the disulfide database:
* [DisulfideDownloader.py](https://github.com/suchanek/proteusPy/blob/master/programs/DisulfideDownloader.py): Downloads the raw RCSB structure files.
* [DisulfideExtractor.py](https://github.com/suchanek/proteusPy/blob/master/programs/DisulfideExtractor.py): Extracts the disulfides and creating the database loaders
* [DisulfideClass_Analysis.py](https://github.com/suchanek/proteusPy/blob/master/programs/DisulfideClass_Analysis.py): Performs binary or sextant analysis on the disulfide database.
The first time one loads the database via [Load_PDB_SS()](https://suchanek.github.io/proteusPy/proteusPy/DisulfideLoader.html#Load_PDB_SS) the system will attempt to download the full and subset database from Google Drive. If this fails the system will attempt to rebuild the database from the repo's **data** subdirectory (not the package's). If you've downloaded from github this will work correctly. If you've installed from pyPi via **pip** it will fail.
## Quickstart
After installation is complete launch jupyter lab:
```console
$ jupyter notebook
```
and open ``notebooks/Analysis_2q7q.ipynb``. This notebook looks at the disulfide bond with the lowest energy in the entire database. There are several other notebooks in this directory that illustrate using the program. Some of these reflect active development work so may not be 'fully baked'.
## Visualizing Disulfides with pyVista
PyVista is an excellent 3D visualization framework and I've used it for the Disulfide visualization engine. It uses the VTK library on the back end and provides high-level access to 3d rendering. The menu strip provided in the Disulfide visualization windows allows the user to turn borders, rulers, bounding boxes on and off and reset the orientations. Please try them out! There is also a button for *local* vs *server* rendering. *Local* rendering is usually much smoother. To manipulate:
- Click and drag your mouse to rotate
- Use the mouse wheel to zoom (3 finger zoom on trackpad)
## Performance
- Manipulating and searching through long lists of disulfides can take time. I've added progress bars for many of these operations.
- Rendering many disulfides in **pyvista** can also take time to load and may be slow to display in real time, depending on your hardware. I added optimization to reduce cylinder complexity as a function of total cylinders rendered, but it can still be less than perfect. The faster your GPU the better!
## Contributing/Reporting
I welcome anyone interested in collaborating on proteusPy! Feel free to contact me at suchanek@mac.com, fork the repository: https://github.com/suchanek/proteusPy/ and get coding. Issues can be reported to https://github.com/suchanek/proteusPy/issues.
## Citing proteusPy
The proteusPy package was developed by Eric G. Suchanek, PhD. If you find it useful in your research and wish to cite it please use the following BibTeX entry:
```
@software{proteusPy2024,
author = {Eric G. Suchanek, PhD},
title = {proteusPy: A Package for Modeling and Analyzing Proteins of Known Structure},
year = {2024},
publisher = {GitHub},
version = {0.92},
journal = {GitHub repository},
url = {https://github.com/suchanek/proteusPy}
}
```
## Publications
- [Computer-aided Strategies for Protein Design](https://doi.org/10.1021/bi00368a023)
- [An engineered intersubunit disulfide enhances the stability and DNA binding of the N-terminal domain of .lambda. repressor](https://doi.org/10.1021/bi00368a024)
- [Introduction of intersubunit disulfide bonds in the membrane-distal region of the influenza hemagglutinin abolishes membrane fusion activity](https://doi.org/10.1016/0092-8674(92)90140-8)
- [Analysis of disulfide bonds in protein structures](http://dx.doi.org/10.1111/j.1538-7836.2010.03894.x)
Raw data
{
"_id": null,
"home_page": "https://github.com/suchanek/proteusPy/",
"name": "proteusPy",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "proteusPy suchanek disulfide",
"author": "Eric G. Suchanek, PhD",
"author_email": "suchanek@mac.com",
"download_url": null,
"platform": null,
"description": "\n[](https://badge.fury.io/py/proteusPy)\n\n[](https://joss.theoj.org/papers/45de839b48a550d6ab955c5fbbc508f2)\n[](http://makeapullrequest.com)\n\n# Summary\n**proteusPy** is a Python package specializing in the modeling and analysis of proteins of known structure with an emphasis on Disulfide bonds. This package reprises my molecular modeling program [Proteus](https://doi.org/10.1021/bi00368a023), a structure-based program developed as part of my graduate thesis. The package relies on the [Turtle3D](https://suchanek.github.io/proteusPy/proteusPy/turtle3D.html) class to create and manipulate local coordinate systems. It does this by implementing the functions ``Move``, ``Roll``, ``Yaw``, ``Pitch`` and ``Turn`` for movement in a three-dimensional space. The initial implementation focuses on the [Disulfide](https://suchanek.github.io/proteusPy/proteusPy/Disulfide.html) class. The class implements methods to analyze the protein structure stabilizing element known as a *Disulfide Bond*. This class and its underlying methods are being used to perform a structural analysis of over 35,800 disulfide-bond containing proteins in the RCSB protein data bank (https://www.rcsb.org).\n\n# General Capabilities\n- Interactively display disulfides contained in the RCSB in a variety of display styles\n- Calculate geometric and energetic properties about these disulfides\n- Create binary and sextant structural classes by characterizing the disulfide torsional angles into *n* classes\n- Build idealized disulfide bonds from dihedral angle input\n- Find disulfide neighbors based on dihedral angle input\n- Overlap disulfides onto a common frame of reference for display\n- Build protein backbones from backbone phi, psi dihedral angle templates\n- More in development\n\n*See [API Reference](https://suchanek.github.io/proteusPy/proteusPy.html) for the API documentation with examples*.\n\n# Requirements\n\n1. PC running MacOS, Linux, Windows with git, git-lfs, make and C compiler installed.\n2. 8 GB RAM\n3. 1 GB disk space\n\n# Installation \n\nIt's simplest to clone the repo via GitHub since it contains all of the notebooks, data and test programs. Installation includes installing my Biopython fork which is required to rebuild the database (this is not needed generally). I highly recommend using Miniforge since it includes mamba. The installation instructions below assume a clean install with no package manager or compiler installed.\n\n## MacOS/Linux\n- Install Miniforge: <https://github.com/conda-forge/miniforge> (existing Anaconda installations are fine but please install mamba)\n- Install git-lfs:\n - <https://help.github.com/en/github/managing-large-files/installing-git-large-file-storage>\n- Install `make` on your system.\n- From a shell prompt while sitting in your repo dir:\n ```console\n $ git clone https://github.com/suchanek/proteusPy.git\n $ cd proteusPy\n $ make pkg\n $ conda activate proteusPy\n $ make install\n ```\n\n## Windows\n- Install Miniforge: <https://github.com/conda-forge/miniforge> (existing Anaconda installations are fine but please install mamba)\n- Install git for Windows and configure for Bash:\n - https://git-scm.com/download/win\n- Install git-lfs:\n - https://git-lfs.github.com/\n- Install GNU make:\n - https://gnuwin32.sourceforge.net/packages/make.htm\n- Open a Miniforge prompt and cd into your repo dir:\n ```console\n (base) C:\\Users\\egs\\repos> git clone https://github.com/suchanek/proteusPy.git\n (base) C:\\Users\\egs\\repos> cd proteusPy\n (base) C:\\Users\\egs\\repos\\proteuspy> make pkg\n (base) C:\\Users\\egs\\repos>\\proteuspy> conda activate proteusPy\n (proteusPy) C:\\Users\\egs\\repos> make install\n ```\n\n# Testing\nI currently have ``pytest`` and docstring testing for the modules in place. To run them ``cd`` into the repository and run:\n```console\n$ make tests\n```\nThe modules will run their docstring tests and disulfide visualization windows will open. Simply close them. If all goes normally there will be no errors. If you're not running the development version of proteusPy you may need to install ``pytest``. Simply perform: ``pip install pytest``. Docstring testing is sensitive to formatting; occasionally the ``black`` formatter changes the docstrings. As a result there may be some docstring tests that fail.\n\n\n# Usage\n\nOnce the package is installed it's possible to load, visualize and analyze the Disulfide bonds in the RCSB Disulfide database. The general approach is:\n- Load the database\n- Access disulfide(s)\n- Analyze\n- Visualize\n\nA simple example is shown below:\n\n```python\nimport proteusPy\nfrom proteusPy import Load_PDB_SS, Disulfide\n\nPDB_SS = Load_PDB_SS(verbose=True)\n\nbest_ss = PDB_SS[\"2q7q_75D_140D\"]\nbest_ss.display(style=\"sb\", light=True)\n```\n\n\nThe [notebooks](https://github.com/suchanek/proteusPy/blob/master/notebooks/) directory contains my Jupyter notebooks and is a good place to start: \n- [Analysis_2q7q.ipynb](https://github.com/suchanek/proteusPy/blob/master/notebooks/Analysis_2q7q.ipynb) provides an example of visualizing the lowest energy Disulfide contained in the database and searching for nearest neighbors on the basis of conformational similarity. \n- [Anearest_relatives.ipynb](https://github.com/suchanek/proteusPy/blob/master/notebooks/Anearest_relatives.ipynb) gives an example of searching for disulfides based on sequence similarity.\n\nThe [programs](https://github.com/suchanek/proteusPy/tree/master/programs) subdirectory contains the primary programs for downloading the RCSB disulfide-containing structure files, extracting the disulfides and creating the disulfide database:\n* [DisulfideDownloader.py](https://github.com/suchanek/proteusPy/blob/master/programs/DisulfideDownloader.py): Downloads the raw RCSB structure files.\n* [DisulfideExtractor.py](https://github.com/suchanek/proteusPy/blob/master/programs/DisulfideExtractor.py): Extracts the disulfides and creating the database loaders\n* [DisulfideClass_Analysis.py](https://github.com/suchanek/proteusPy/blob/master/programs/DisulfideClass_Analysis.py): Performs binary or sextant analysis on the disulfide database.\n\nThe first time one loads the database via [Load_PDB_SS()](https://suchanek.github.io/proteusPy/proteusPy/DisulfideLoader.html#Load_PDB_SS) the system will attempt to download the full and subset database from Google Drive. If this fails the system will attempt to rebuild the database from the repo's **data** subdirectory (not the package's). If you've downloaded from github this will work correctly. If you've installed from pyPi via **pip** it will fail.\n\n\n## Quickstart\n\nAfter installation is complete launch jupyter lab:\n\n```console\n$ jupyter notebook \n```\nand open ``notebooks/Analysis_2q7q.ipynb``. This notebook looks at the disulfide bond with the lowest energy in the entire database. There are several other notebooks in this directory that illustrate using the program. Some of these reflect active development work so may not be 'fully baked'.\n\n## Visualizing Disulfides with pyVista\nPyVista is an excellent 3D visualization framework and I've used it for the Disulfide visualization engine. It uses the VTK library on the back end and provides high-level access to 3d rendering. The menu strip provided in the Disulfide visualization windows allows the user to turn borders, rulers, bounding boxes on and off and reset the orientations. Please try them out! There is also a button for *local* vs *server* rendering. *Local* rendering is usually much smoother. To manipulate:\n- Click and drag your mouse to rotate\n- Use the mouse wheel to zoom (3 finger zoom on trackpad)\n\n## Performance\n\n- Manipulating and searching through long lists of disulfides can take time. I've added progress bars for many of these operations. \n- Rendering many disulfides in **pyvista** can also take time to load and may be slow to display in real time, depending on your hardware. I added optimization to reduce cylinder complexity as a function of total cylinders rendered, but it can still be less than perfect. The faster your GPU the better! \n\n## Contributing/Reporting\n\nI welcome anyone interested in collaborating on proteusPy! Feel free to contact me at suchanek@mac.com, fork the repository: https://github.com/suchanek/proteusPy/ and get coding. Issues can be reported to https://github.com/suchanek/proteusPy/issues. \n\n## Citing proteusPy\n\nThe proteusPy package was developed by Eric G. Suchanek, PhD. If you find it useful in your research and wish to cite it please use the following BibTeX entry:\n\n```\n@software{proteusPy2024,\n author = {Eric G. Suchanek, PhD},\n title = {proteusPy: A Package for Modeling and Analyzing Proteins of Known Structure},\n year = {2024},\n publisher = {GitHub},\n version = {0.92},\n journal = {GitHub repository},\n url = {https://github.com/suchanek/proteusPy}\n}\n```\n\n## Publications\n\n- [Computer-aided Strategies for Protein Design](https://doi.org/10.1021/bi00368a023)\n- [An engineered intersubunit disulfide enhances the stability and DNA binding of the N-terminal domain of .lambda. repressor](https://doi.org/10.1021/bi00368a024)\n- [Introduction of intersubunit disulfide bonds in the membrane-distal region of the influenza hemagglutinin abolishes membrane fusion activity](https://doi.org/10.1016/0092-8674(92)90140-8)\n- [Analysis of disulfide bonds in protein structures](http://dx.doi.org/10.1111/j.1538-7836.2010.03894.x)\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "proteusPy - Protein Structure Analysis and Modeling Tools",
"version": "0.95.5",
"project_urls": {
"Documentation": "https://suchanek.github.io/proteusPy/",
"Homepage": "https://github.com/suchanek/proteusPy/",
"Source": "https://github.com/suchanek/proteusPy/",
"Tracker": "https://github.com/suchanek/proteusPy/issues"
},
"split_keywords": [
"proteuspy",
"suchanek",
"disulfide"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cefd2039777c7ca56445ba12110153735c0d50ebe236855d753a5be58fd5e577",
"md5": "c7f17c6ea689d7ffbbe393a9ec36c5c8",
"sha256": "7d00cb839486d78fbba3be7236116484e66094e91dd3847fdd0f3c1be41dce54"
},
"downloads": -1,
"filename": "proteusPy-0.95.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c7f17c6ea689d7ffbbe393a9ec36c5c8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 19032630,
"upload_time": "2024-04-24T19:25:57",
"upload_time_iso_8601": "2024-04-24T19:25:57.971462Z",
"url": "https://files.pythonhosted.org/packages/ce/fd/2039777c7ca56445ba12110153735c0d50ebe236855d753a5be58fd5e577/proteusPy-0.95.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-24 19:25:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "suchanek",
"github_project": "proteusPy",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"lcname": "proteuspy"
}
JSON
