PDB2PQR examples


Back to the main PDB2PQR page.

This page provides some very basic examples on the features of PDB2PQR. It is under continual development and suggestions are appreciated!


Basic PDB file operations

This section outlines the basic process of adding hydrogens and assigning charge/radius parameters to an otherwise complete PDB structure.

Fasciculin-1 (1FAS)

This 3-finger toxin structure is available at high resolution (1.9 Å) and has all its heavy atoms present in the PDB file. We'll use one of the PDB2PQR servers to add hydrogens to this protein and optimize their positions.

  1. From the PDB2PQR server web page, enter 1FAS into the PDB ID field.
  2. Choose whichever forcefield and naming schemes you prefer.
  3. Under options, be sure the "Ensure that new atoms are not rebuilt too close to existing atoms" and "Optimize the hydrogen bonding network" options are selected. You can select other options as well, if interested.
  4. Hit the "Submit" button.

Once the calculations are complete, you should get a web page with a link to the new PQR file. You can download this PQR file and view it in your favorite molecular visualization package (e.g., VMD, PyMOL, or PMV). For comparison, you might download the the original PDB file and compare the PDB2PQR-generated structure with the original to see where hydrogens were placed.

Calmodulin-dependent protein kinase (1A06)

This kinase structure is available at somewhat lower (2.5 Å) resolution and is missing several sidechain atoms as well as portions of its sequence. We'll use this example to demonstrate how PDB2PQR can add missing sidechain atoms to an imcomplete structure but cannot fill in missing regions of the backbone. In particular, we'll use PDB2PQR to add/optimize hydrogens, reconstruct sidechains K53, N65, R140, E154, Q192, Y195, E221, N222, K225, E228, K232, and Q272 from model geometries, and assign parameters.

  1. From the PDB2PQR server web page, enter 1A06 into the PDB ID field.
  2. Choose whichever forcefield and naming schemes you prefer.
  3. Under options, be sure the "Ensure that new atoms are not rebuilt too close to existing atoms" and "Optimize the hydrogen bonding network" options are selected. You can select other options as well, if interested.
  4. Hit the "Submit" button.

Once the calculations are complete, you should see a web page with a link to the new PQR file and warnings about incomplete and poorly-positioned portions of the PQR structure. In particular, PDB2PQR will complain about missing regions between K53 and E64 and between F163 and P182. PDB2PQR may also complain "Unable to debump VAL A 189", referring to bad contacts between V189 and other residues that it was unable to resolve. You can download the resulting PQR file and view it in your favorite molecular visualization package (e.g., VMD, PyMOL, or PMV). For comparison, you might download the the original PDB file and compare the PDB2PQR-generated structure with the original to see where hydrogens were placed.


Assigning titration states with PROPKA

Interested users should read Li H, Robertson AD, Jensen JH. Very Fast Empirical Prediction and Rationalization of Protein pKa Values. Proteins, 61, 704-721 (2005). for a much more complete description and analysis of titration state assignment using PROPKA. The examples here are taken from this paper. Nearly all of these examples can be reproduced using PDB2PQR/PROPKA, we give a single example here for demonstration purposes.

HIV-1 protease (1HPX)

The PDB structure 1HPX includes HIV-1 protease complexed with an inhibitor at 2.0 Å resolution. HIV-1 protease has two chains; residue D25 is anionic on one chain and neutral on the other -- these titration states are important in the role of D25 as an acid in the catalytic mechanism.

  1. From the PDB2PQR server web page, enter 1HPX into the PDB ID field.
  2. Choose whichever forcefield and naming schemes you prefer.
  3. Under options, be sure the "Ensure that new atoms are not rebuilt too close to existing atoms", "Optimize the hydrogen bonding network", and "Use PROPKA to assign protonation states at pH" options are selected. Choose pH 7 for your initial calculations. You can select other options as well, if interested.
  4. Hit the "Submit" button.

Once the calculations are complete, you should see a web page with a link to the PROPKA output, a new PQR file, and warnings about the ligand KNI (since we didn't choose to parameterize it in this calculation -- see below). You can download the resulting PQR file and view it in your favorite molecular visualization package (e.g., VMD, PyMOL, or PMV). For comparison, you might download the the original PDB file and compare the PDB2PQR-generated structure with the original to see where hydrogens were placed.


Ligand parameterization

This section outlines the parameterization of ligands using the PEOE_PB methods (see Czodrowski P, Dramburg I, Sotriffer CA, Klebe G. Development, validation, and application of adapted peoe charges to estimate pka values of functional groups in protein-ligand complexes. Proteins. 65 (2), 424-37, 2006 for more information).

As described in the PDB2PQR user guide and on the PDB2PQR server page, ligand parameterization currently requires a MOL2-format representation of the ligand to provide the necessary bonding information. MOL2-format files can be obtained through the free PRODRG web server or some molecular modeling software packages. Please note that PRODRG provides documentation as well as several examples on ligand preparation on its web page; please refer to the PRODRG documentation for questions about ligand MOL2 file preparation.

HIV-1 protease (1HPX)

Mixing things up a little bit from above, we're now ready to look at the 1HPV crystal structure (HIV-1 protease) and parameterize its ligand, KNI-272. We're going to

  1. From the PDB2PQR server web page, enter 1HPX into the PDB ID field.
  2. Choose whichever forcefield and naming schemes you prefer.
  3. Under options, be sure the "Ensure that new atoms are not rebuilt too close to existing atoms", "Optimize the hydrogen bonding network", and "Assign charges to the ligand specified in a MOL2 file" options are selected. The necessary MOL2 file can be downloaded here. You can select other options as well, if interested.
  4. Hit the "Submit" button.

Once the calculations are complete, you should see a web page with a link to the new PQR file with a warning about debumping P81 (but no warnings about ligand parameterization!). You can download the resulting PQR file and view it in your favorite molecular visualization package (e.g., VMD, PyMOL, or PMV). For comparison, you might download the the original PDB file and compare the PDB2PQR-generated structure with the original to see where hydrogens were placed and how the ligand is bound to the active site.

L-Arabinose binding protein (1ABF)

Our next example uses PDB structure 1ABF of L-arabinose binding protein in complex with a sugar ligand at 1.90 Å resolution. To parameterize both this protein and its ligand:

  1. From the PDB2PQR server web page, enter 1ABF into the PDB ID field.
  2. Choose whichever forcefield and naming schemes you prefer.
  3. Under options, be sure the "Ensure that new atoms are not rebuilt too close to existing atoms", "Optimize the hydrogen bonding network", and "Assign charges to the ligand specified in a MOL2 file" options are selected. The necessary MOL2 file can be downloaded here. You can select other options as well, if interested.
  4. Hit the "Submit" button.

Once the calculations are complete, you should see a web page with a link to the new PQR file with a warning about debumping P66, K295, and K306 (but no warnings about ligand parameterization!). You can download the resulting PQR file and view it in your favorite molecular visualization package (e.g., VMD, PyMOL, or PMV). For comparison, you might download the the original PDB file and compare the PDB2PQR-generated structure with the original to see where hydrogens were placed and how the ligand is bound to the active site.


Running Poisson-Boltzmann calculations

The APBS web interface is an addition to PDB2PQR, which extends the PDB2PQR web interface by allowing the end user to use the output files from PDB2PQR in a Poisson-Boltzmann electrostatics calculation. The APBS Poisson-Boltzmann calculation can run either locally or on an Opal grid, much like PDB2PQR.

This tutorial walks you through the basic steps in performing Poisson-Boltzmann electrostatics calculations for visualization through PDB2PQR and APBS.

  1. Find a PDB2PQR webserver installation:
    1. Browse to one of the PDB2PQR web interface installations, or
    2. Download PDB2PQR, set up a local installation, and browse to that installation instead.
  2. Locate the text 'Please enter either:', located about halfway down the PDB2PQR web interface page.
    1. Enter a PDB ID, such as 1ubq, in the field prepended by the text 'a PDB ID:', or
    2. Browse your filesystem for a PDB file, such as the one for 1ubq, and enter it in the form field prepended by the text 'upload a PDB file:'.
  3. Optionally select an alternate radio button for the type of forcefield to use for the calculation.
  4. Optionally select an alternate radio button for the type of output naming scheme to use for the file generated by the calculation.
  5. Optionally check and/or uncheck any checkboxes under the 'Available options:' section as desired, and fill in the necessary corresponding form fields.
  6. Click on 'Submit' to launch the PDB2PQR calculation.
  7. Wait for the calculation to complete. The status page will automatically refresh and display updated information on the state of the calculation.
    1. If desired, the status page can be bookmarked and visited at a later time to find out if the calculation has been completed, rather than keeping the browser window open.
  8. When the calculation is complete, the status page will change to display links to the resulting files.
    1. Download the resulting files from the server for examination and/or further calculations, or
    2. If you have selected to output an APBS input file, continue on to the APBS web interface in the next step.
  9. Change the type of calculation in APBS and change any other settings as desired. All changes are completely optional, as valid default values are automatically entered for all required fields.
  10. Click on 'Submit' to launch the APBS calculation.
  11. Wait for the calculation to complete. The status page will automatically refresh and display updated information on the status of the calculation.
    1. If desired, the status page can be bookmarked and visited at a later time to find out if the calculation has been completed, rather than keeping the browser window open.
  12. When the calculation is complete, the status page will change to display links to the resulting files.
    1. Download the resulting files from the server for examination and/or further calculations, or
    2. Continue on to visualize the calculation via the web interface in the next step.
  13. Select the type of visualization desired (Jmol, VMD, or Chimera).
    1. If you have chosen Jmol, interact with the Java applet as desired.
    2. If you have chosen VMD or Chimera, select the images and/or videos you desire to have generated.
      1. Click 'Submit' to begin the rendering process.
        1. If desired, the status page can be bookmarked and visited at a later time to find out if the calculation has been completed, rather than keeping the browser window open.
      2. When the calculation is complete, the status page will change to display links to the resulting files.
      3. Download the resulting files from the server for examination and/or further calculations.

SourceForge Project Page

Last changed on: $Date: 2007-02-10 11:06:05 -0600 (Sat, 10 Feb 2007)$