Package: provis
provis - A python based PROtein VISualization toolkitWelcome to the repository of Provis - a python based protein visualization library.Documentation,installation instructions.InstallationThe easiest way to install is withpip install provisor by cloning this github repo and running: "python3 setup.py develop" from the base directory.The library has a few dependencies that have to be installed seperately.FOLLOW THE INSTRUCTIONS IN "Requirements for Provis" AND "Setting up Provis"Otherwiseproviswill not work.Requirements for ProvisProvis is based on the idea of not to reinvent the wheel, so it requires quite a few third party packages and binaries.BinariesOpenBabelEasiest to install on Linux is by calling:sudo apt install openbabelAlterantively:http://openbabel.org/wiki/Main_PagePDB2PQR and APBSThese binaries arerequired, as they are used to extract surface inforamtion.Download from:https://www.poissonboltzmann.org/MSMSMSMS is optional. It is used to compute the surface, but a native method for the surface computation also exists in provis.Download MSMS form:https://ccsb.scripps.edu/mgltools/downloads/This tutorial might help:http://biskit.pasteur.fr/install/applications/deprecated/msmsPipAll of the following can be dowloaded using pip and should be automatically installed when installing pip with provis:BioPythonTrimeshPyVistaBiopandasTorchPyvtkOpen3drTreePanelImageio-ffmpegSetting up ProvisSome file paths are hard coded in provis in order to maintain an uncluttered and organized directory structure.However, this also means, that for provis to work this specific directory structure has to exist.Directory structure::provis
   ├── data
   │   ├── data/
   │   ├── pdb/
   │   ├── img/
   │   ├── meshes/
   │   └── tmp/
   └── binaries          
       ├── apbs
       ├── msms
       └── pdb2pqr
	    └── pdb2pqrEasy option
^^^^^^^^^^^^
Clone provis fromgithub <https://github.com/czirjakkethz/provis>_ and simply use this git directory (provis) as the base directory.More versitile option
^^^^^^^^^^^^^^^^^^^^^^^A data/ and (potentially) a binaries/ directory within the root directory will have to be created.-- If the environment variables for the binaries are set then the binaries/ directory is not needed (as provis will then use these variables to find the binaries). Otherwise the binaries from the Requirements
:ref:reqsection will all have to be copied into the binaries/ directory. --Subdirectiories of the data/ directory:
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
::data
├── data
├── pdb
├── img   
├── meshes
└── tmpThe pdb directory is the location to store the pdb files. If a.pdbfile is stored here then it is enough to pass the pdb id (filename without extension) to provis. Otherwise the full path to the.pdbfile needs to be passed.The img directory stores all the screenshots of the outputted plots.The tmp directory stores all temporary files created by provis, such as the.faceand.vertfiles of MSMS or the.mol2files needed for the bonds.BinariesAfter installing the binaries either set the environment variables to specify the path of their location or manually move the binaries to where provis can find them.Binaries directory
^^^^^^^^^^^^^^^^^^^^If you are running Ubuntu (20.04.3 LTS) and installed provis by cloning the github repository then you are all set.Otherwise move the binary files to the 'binaries' directory as explained below.Subdirectiories and executables of the binaries/ directory:
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
::binaries
├── apbs
├── msms       
└── pdb2pqr     
     └── pdb2pqrapbsandmsmsare executables andpdb2pqris the directory downloaded from the official website, containing thepdb2pqrbinary.Setting environment variables
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^Alternatively the environment variables can be set to point to the binary files.Set the MSMS_BIN, PDB2PQR_BIN and APBS_BIN variables to the full path to their appropriate binary files.Example:.. code-block::export MSMS_BIN='/home/username/Downloads/msms'