Difference between revisions of "APBS"

From PyMOLWiki
Jump to navigation Jump to search
m
 
(update lots of outdated information)
 
(68 intermediate revisions by 15 users not shown)
Line 1: Line 1:
−
== Introduction ==
+
[[Image:Rna_surface_apbs.png|thumb|APBS-generated electrostatic surface displayed in PyMOL]]
−
PyMol currently supports the '''APBS''' plugin. See [http://www-personal.umich.edu/~mlerner/PyMOL/ Michael Lerner's Page] for more details.
+
[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.
  
−
More edits needed.
+
== APBS Plugins for PyMOL ==
 +
 
 +
* [[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==
 +
 
 +
The plugins require '''apbs''' and '''pdb2pqr'''.
 +
 
 +
* [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:
 +
 
 +
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. <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>
 +
 
 +
[[Image:Apbs_ex.png|thumb|right|300px|PyMOL visualizing two maps at once]]
 +
 
 +
==Using APBS==
 +
 
 +
See [[APBS Electrostatics Plugin]] and [[apbsplugin|APBS Tools2.1]].
 +
 
 +
[[Category:Electrostatics]]
 +
[[Category:Biochemical_Properties]]
 +
[[Category:Plugins]]

Latest revision as of 15:05, 26 July 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 ) 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 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.

Retrieved from "http://pymolwiki.org/index.php?title=APBS&oldid=12790"