This is a read-only mirror of pymolwiki.org

Difference between revisions of "APBS"

From PyMOL Wiki
Jump to navigation Jump to search
m (1 revision)
 
(36 intermediate revisions by 11 users not shown)
Line 1: Line 1:
== Introduction ==
 
 
[[Image:Rna_surface_apbs.png|thumb|APBS-generated electrostatic surface displayed in PyMOL]]
 
[[Image:Rna_surface_apbs.png|thumb|APBS-generated electrostatic surface displayed in PyMOL]]
[http://apbs.sourceforge.net APBS], the Adaptive Poisson-Boltzmann Solver, is a [http://www.oreilly.com/openbook/freedom/ freely] available macromolecular electrostatics calculation program released under the [http://www.gnu.org/copyleft/gpl.html GPL]. It is a cost-effective but uncompromised alternative to [http://trantor.bioc.columbia.edu/grasp/ GRASP], and it can be used within pymol. Pymol can display the results of the calculations as an electrostatic potential molecular surface.
+
[http://www.poissonboltzmann.org/ APBS], the Adaptive Poisson-Boltzmann Solver, is a
 +
[http://www.oreilly.com/openbook/freedom/ freely]
 +
available macromolecular electrostatics calculation program released under a
 +
[http://apbs-pdb2pqr.readthedocs.io/en/latest/apbs/license.html BSD license].
 +
PyMOL can display the results of the calculations as an electrostatic potential molecular surface.
  
PyMol currently supports the '''APBS plugin''' written by Michael Lerner. This plugin makes it possible to run APBS from within PyMOL, and then display the results as a color-coded electrostatic surface (units k<sub>b</sub>T/e<sub>c</sub>) in the molecular display window (as with the image to the right).  See [http://www-personal.umich.edu/~mlerner/PyMOL/ Michael Lerner's Page] for more details, including instructions on how to download, install and use the plugin.
+
== APBS Plugins for PyMOL ==
  
'''Nucleic acids may prove problematic for the apbs plugin.''' If so, use the [http://pdb2pqr.sourceforge.net/ pdb2pqr] command-line tool to create a pqr file manually, instead of using the plugin to generate it. Then direct the APBS GUI on the [http://www-personal.umich.edu/~mlerner/PyMOL/images/main.png main menu] to read the pqr file you '''externally generated.'''
+
* [[APBS Electrostatics Plugin]], included in [https://pymol.org/ Incentive PyMOL 2.0]
 +
* [[apbsplugin|APBS Tools 2.1]], based on the original version by [[User:Mglerner|Michael Lerner]].
 +
 
 +
Both plugins make it possible to run APBS from within PyMOL, and then display
 +
the results as a color-coded electrostatic surface (units <math>K_bT/e_c</math>)
 +
in the molecular display window (as with the image to the right).
  
 
==Required Dependencies==
 
==Required Dependencies==
[http://apbs.sourceforge.net APBS] and its dependencies like [http://pdb2pqr.sourceforge.net pdb2pqr] and [http://scicomp.ucsd.edu/~mholst/codes/maloc/ maloc] are [http://www.oreilly.com/openbook/freedom/ freely] available under the [http://www.gnu.org/copyleft/gpl.html GPL].  The author of the software however [http://agave.wustl.edu/apbs/download/ asks that users register] with him to aid him in obtaining grant funding.
 
 
----
 
===Installing the Dependencies on OS X===
 
#First, [http://agave.wustl.edu/apbs/download/ register] your use of the software.  This will keep everyone happy.
 
#Second, if you don't already have the [http://fink.sourceforge.net fink package management system], now is a good time to get it. Here is a [http://xanana.ucsc.edu/~wgscott/xtal/wiki/index.php/Quick_Start quick-start set of instructions] for getting X-windows, compilers, and fink all installed.
 
#Once you are up and going, [http://xanana.ucsc.edu/~wgscott/xtal/wiki/index.php/How_to_Activate_the_Unstable_Branch activate the unstable branch in fink], and then issue the commands
 
 
fink self-update
 
fink install apbs
 
 
or if you want to use the multi-processor version, issue
 
 
fink self-update
 
fink install apbs
 
 
Then install the X-windows based version of pymol using the command
 
 
fink install pymol-py25
 
 
Note that the fink version of pymol '''already has''' the latest version of the APBS plugin.  You are set to go!
 
 
Further details, as well as screen shots, are given [http://www.pymolwiki.org/index.php/MAC_Install#Install_APBS_and_friends_with_fink elsewhere in this wiki].
 
 
----
 
 
===Installing the Dependencies on Linux===
 
 
====From Scratch====
 
Note that this tutorial assumes you're using the bash shell and have root privileges
 
<OL><LI>
 
Obtain APBS and MALOC from...<br>
 
APBS = http://apbs.sourceforge.net (currently 0.4)<br>
 
MALOC = http://www.fetk.org/codes/maloc/index.html#download (currently 0.1-2)<BR>
 
<LI>Set up some environment variables & directories (temporary for building)
 
<pre>
 
$ export FETK_SRC=/<building directory>/temp_apbs
 
$ export FETK_PREFIX=/usr/local/apbs-0.4.0  (or wherever you want it to live)
 
$ export FETK_INCLUDE=${FETK_PREFIX}/include
 
$ export FETK_LIBRARY=${FETK_PREFIX}/lib
 
$ mkdir -p ${FETK_SRC} ${FETK_INCLUDE} ${FETK_LIBRARY}
 
</pre></LI>
 
<LI>Unpack the source packages
 
<pre>
 
$ cd ${FETK_SRC}
 
$ gzip -dc maloc-0.1-2.tar.gz | tar xvf -
 
$ gzip -dc apbs-0.4.0.tar.gz | tar xvf -</pre>
 
</LI>
 
<LI>Compile MALOC
 
<pre>
 
$ cd ${FETK_SRC}/maloc
 
$ ./configure --prefix=${FETK_PREFIX}</pre>
 
If everything went well, then
 
<pre>$ make; make install</pre></LI>
 
<LI>Go get a coffee. Compilation/installation takes about 15 minutes on a 3GHz computer with 1GB of RAM.</LI>
 
<LI>Now on to compiling APBS itself
 
<pre>
 
$ cd ${FETK_SRC}/apbs-0.4.0
 
$ ./configure --prefix=${FETK_PREFIX}</pre>
 
If all goes well:
 
<pre>$ make all; make install</pre></LI>
 
<LI>No time for coffee. Takes about 5 minutes on that fast computer.</LI>
 
<LI> There will now be an APBS binary at
 
<pre>/usr/local/apbs-0.4.0/bin/i686-intel-linux/apbs</pre></LI>
 
<LI> Make appropriate links
 
<pre>
 
$ ln -s /usr/local/apbs-0.4.0/bin/i686-intel-linux/apbs /usr/local/bin/apbs
 
</pre></LI>
 
<LI> Get rid of /<building directory dir>/temp_apbs
 
<LI> Open PyMOL and make sure that the APBS plugin points to /usr/local/bin/apbs
 
<LI> Rock and or Roll.
 
</OL>
 
 
====Pre-Packaged====
 
=====RPMs=====
 
 
A variety of RPMs are available from the [http://sourceforge.net/project/showfiles.php?group_id=148472&package_id=163734&release_id=378273 APBS downloads website].  Again, please [http://agave.wustl.edu/apbs/download/ register] your use of the software if you have not yet done so.
 
 
=====Debian packages=====
 
  
For ubuntu and other debian linux distributions, probably the simplest thing is to download a promising looking rpm, convert it with the program [http://kitenet.net/programs/alien/ alien], and then install the [http://xanana.ucsc.edu/linux newly generated debian package] with the command
+
The plugins require '''apbs''' and '''pdb2pqr'''.
  
sudo dpkg -i apbs*.deb
+
* [https://pymol.org Incentive PyMOL] ships preconfigured with apbs and pdb2pqr
 +
* [https://github.com/Electrostatics/apbs-pdb2pqr/releases Official release downloads] for all platforms
 +
* Precompiled packages are also available in Ubuntu, Debian, Gentoo, [https://www.macports.org/ MacPorts], [http://www.finkproject.org/ Fink], and many other Unix-like distributions. Example for installation on Ubuntu:
  
=====Gentoo=====
+
apt-get install apbs pdb2pqr
  
You have to install apbs and pdb2pqr. Both are masked via keywords atm. Type as root:
+
After all components are installed, open the plugin and browse for apbs and pdb2pqr on the "Program Locations" tab (if they haven't been found automatically).
  
  echo sci-chemistry/pdb2pqr >> /etc/portage/packages.keywords
+
== Troubleshooting ==
 +
* ''(this might be outdated information):'' If the B-factor is <math>\geq 100,</math> then APBS doesn't properly read in the PDB file and thus outputs garbage (or dies). To fix this, set all b factors to be less than 100. <source lang="python">alter all, b=min(b,99.9)</source>  The problem stems from how to parse a PDB file.  The PDB file originally was written when most people used FORTRAN programs, and so the file format was specified by columns, not by the more modern comma separated value format we tend to prefer today.  For the latest on the PDB format see the [http://www.wwpdb.org/docs.html new PDB format docs].
 +
* APBS has problems, sometimes, in reading atoms with '''alternate conformations'''.  You can remove the alternate locations with a simple script [[removeAlt]].
 +
* For pdb2pqr, '''RNA''' resdiue names must be RA, RC, RG, and RU.<source lang="python">alter polymer & resn A+C+G+U, resn = "R" + resn</source>
 +
* Incomplete Residues: Some truncated PDB files include a single backbone atom of the next residue, e.g. [https://www.rcsb.org/structure/2xwu 2xwu] chain B residue 954 atom N. '''pdb2pqr''' reports: ''Error encountered: Too few atoms present to reconstruct or cap residue LEU B 954 in structure!''. The easiest solution is to remove that atom:<source lang="python">remove /2xwu//B/954</source>
  
echo sci-chemistry/apbs >> /etc/portage/packages.keywords
+
[[Image:Apbs_ex.png|thumb|right|300px|PyMOL visualizing two maps at once]]
  
emerge -av sci-chemistry/apbs sci-chemistry/pdb2pqr
+
==Using APBS==
  
----
+
See [[APBS Electrostatics Plugin]] and [[apbsplugin|APBS Tools2.1]].
  
==Further contributions and edits are needed.==
+
[[Category:Electrostatics]]
 +
[[Category:Biochemical_Properties]]
 +
[[Category:Plugins]]

Latest revision as of 02:21, 20 August 2018

APBS-generated electrostatic surface displayed in PyMOL

APBS, the Adaptive Poisson-Boltzmann Solver, is a freely available macromolecular electrostatics calculation program released under a BSD license. PyMOL can display the results of the calculations as an electrostatic potential molecular surface.

APBS Plugins for PyMOL

Both plugins make it possible to run APBS from within PyMOL, and then display the results as a color-coded electrostatic surface (units <math>K_bT/e_c</math>) in the molecular display window (as with the image to the right).

Required Dependencies

The plugins require apbs and pdb2pqr.

apt-get install apbs pdb2pqr

After all components are installed, open the plugin and browse for apbs and pdb2pqr on the "Program Locations" tab (if they haven't been found automatically).

Troubleshooting

  • (this might be outdated information): If the B-factor is <math>\geq 100,</math> then APBS doesn't properly read in the PDB file and thus outputs garbage (or dies). To fix this, set all b factors to be less than 100.
    alter all, b=min(b,99.9)
    
    The problem stems from how to parse a PDB file. The PDB file originally was written when most people used FORTRAN programs, and so the file format was specified by columns, not by the more modern comma separated value format we tend to prefer today. For the latest on the PDB format see the new PDB format docs.
  • APBS has problems, sometimes, in reading atoms with alternate conformations. You can remove the alternate locations with a simple script removeAlt.
  • For pdb2pqr, RNA resdiue names must be RA, RC, RG, and RU.
    alter polymer & resn A+C+G+U, resn = "R" + resn
    
  • Incomplete Residues: Some truncated PDB files include a single backbone atom of the next residue, e.g. 2xwu chain B residue 954 atom N. pdb2pqr reports: Error encountered: Too few atoms present to reconstruct or cap residue LEU B 954 in structure!. The easiest solution is to remove that atom:
    remove /2xwu//B/954
    
PyMOL visualizing two maps at once

Using APBS

See APBS Electrostatics Plugin and APBS Tools2.1.