Metadata-Version: 2.1
Name: bio-pyvol
Version: 1.2.29
Summary: a PyMOL plugin and python package for visualization, comparison, and volume calculation of protein drug-binding sites
Home-page: https://github.com/schlessingerlab/pyvol
Author: Ryan H.B. Smith
Author-email: ryan.smith@icahn.mssm.edu
License: MIT
Description: 
        ***********************************************************************
        PyVOL: Protein Pocket Visualization, Segmentation, and Characterization
        ***********************************************************************
        
        .. image:: https://img.shields.io/pypi/v/bio_pyvol.svg
           :target: https://pypi.python.org/pypi/bio_pyvol
           :alt: Pypi Version
        .. image:: https://img.shields.io/pypi/l/bio_pyvol.svg
           :target: https://pypi.python.org/pypi/bio_pyvol/
           :alt: License
        
        PyVOL is a python library packaged into a `PyMOL` GUI for identifying protein binding pockets, partitioning them into sub-pockets, and calculating their volumes. PyVOL can be run as a PyMOL plugin through its GUI or the PyMOL prompt, as an imported python library, or as a commandline program. Visualization of results is exclusively supported through PyMOL though exported surfaces are compatible with standard 3D geometry visualization programs.
        
        .. _PyMOL: https://pymol.org/2/
        
        Installation
        ============
        
        PyVOL can be installed into any python environment; however, for most users direct installation into PyMOL will be easiest.
        
        Installation into PyMOL
        -----------------------
        
        PyVOL is distributed as a GUI and a backend. Installation into PyMOL uses PyMOL's plugin manager to install the GUI and then the GUI to install the backend. The GUI is installed through the plugin manager through loading the `zipped GUI file <https://github.com/rhs2132/pyvol/blob/master/pyvolgui.zip>`_:
        
        .. code-block:: bash
        
            https://github.com/rhs2132/pyvol/blob/master/pyvolgui.zip
        
        This creates a new ``PyVOL`` menu entry under plugins. The third tab of the GUI allows installation of PyVOL from PyPI along with all available dependencies. For more information, especially on Windows, see the `installation page <https://schlessingerlab.github.io/pyvol/install.html>`_.
        
        Running PyVOL
        =============
        
        Quick Start
        -----------
        
        From within PyMOL, the simplest binding pocket calculation is simply run at the PyMOL prompt with:
        
        .. code-block:: python
        
           pocket protein_selection
        
        The two parameters that most dramatically affect calculations are the maximum and minimum radii used to respectively define the exterior surface of the protein and the boundary of the binding pocket itself. In practice, the minimum radius does not need to be changed as its default (1.4) is broadly useful. The maximum radius does often need to be adjusted to find a suitable value using the max_rad parameter:
        
        .. code-block:: python
        
           pocket protein_selection, min_rad=1.4, max_rad=3.4
        
        Further Examples
        ----------------
        
        For extensive explanations and documentations of the GUI and command line interfaces, see the `general usage page <https://schlessingerlab.github.io/pyvol/general.html>`_.
        
        Module Documentation
        ====================
        For full documentation of the code, see the `modules page <https://schlessingerlab.github.io/pyvol/modules.html>`_.
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
