ADP_EM Chimera Plugin

This is a tutorial to use the ADP EM molecular fitting tool in Chimera.  As a user, you will be able to load the plugin and fit your PDB's into density maps with fuzzy resolution. Just follow the instructions and enjoy :) 

Loading the plugin

To load the plugin in Chimera:

  • If you don't already have a directory on your computer that is specific for external plugins for chimera, create one called 'Plugins' wherever you want.
     
  • If you haven't downloaded the plugin, do it here
  • Uncompress the file in the 'Plugins' directory.
  • In Chimera, go to Favorites → Preferences, from Category select Tools and add the 'Plugins' directory containing the ADP EM folder to the Locations.

The ADP EM module will be under the Tools → EM Fitting menu.

Using the plugin

When loaded, you will see this new window:

Captura de pantalla 2017 05 15 a las 19 03 40

In the first row, you could choose you atomic structures and your maps loaded in Chimera. 

There are three required parameters to run the ADP EM fitting process:

  • Bandwidth: corresponds to the bandwidth in the harmonic transformation. Its values are set to 16, 24, 32, 48 or 64. 
  • Resolution: depending on the type of element to fit:
      - if a Pdb file is fitted → nominal resolution of the projection map in Å.
      - If a 3d map is fitted → density threshold value for the fitted map.
  • Cut-off: is the density threshold value for the experimental map. All density levels below this value will be not considered. You can get this value from the level parameter showed in the Volume Viewer to adjust with more precision your map density.

 

These parameters are the minimum required to perform the fitting. The next ones are advanced features that should be used carefully by the user:

  • Fitting criterion: this option sets the fitting criterion used:
      - Standard linear cross-correlation → the scalar product between the density maps of the low resolution map and the low-pass filtered atomic structure. Recommended for resolutions < 15Å and when the atomic model accounts all the density of the map.
      - Laplacian filter → is applied by default (as told in 2.2) to maximize the fitting contrast. Recommended for resolutions > 15Å and when the atomic model only accounts a part of the density of the experimental map.
  • Saved solutions: number of the saved solutions that ADP EM will compute (50 by default).
  • Translational sampling: in Å, by default twice of voxel size of the density map. Values > 6Å should not be used.
  • Translational scan: translational scan strategy:
      - Full search → all the translational points inside the target EM map will be explored.
      - Limited →  radial search starting from the center of mass.
      - Masking search →  default (as told in 2.2).

 

In addition to these parameters, some extra features had been provided to expertise users that know how to use the ADP EM tool and what objectives are they looking for. These parameters can be found in the Options button, which displays a new panel to insert them:

Captura de pantalla 2017 05 15 a las 19 30 42

  • Number peaks explored per docking: default 30.
  • Number peaks stored per iteration: default 20.
  • Number peaks stored in the search: default 100.
  • Number peaks stored in the multi-docking search: default 500.
  • Translational threshold in grid units: default 2.0.
  • Rotational threshold in degrees: default 360/bandwidth.
  • Width between spherical layers: default 1.0.
  • Density cut-off of the simulated map: default 0.0

Once you have inserted the parameters you want for the adjustment, simply click Fit and enjoy. You will see the process log in a new window and, when it is finished, you could check the results in the correspondet panel.

Credits

The plugin was developed by Pablo Solar for Pablo Chacón's group (chaconlab). Acknowledgements go to Pablo Chacón and José Ramón López Blanco, CSIC, for sharing their time with me, wisdom and friendliness, and to Tom Goddard, UCSF, for providing useful insights.

Citation

Jose Ignacio Garzón, Julio A. Kovacs, Ruben Abagyan, and P. Chacón. (2007) ADP_EM: Fast exhaustive multi-resolution docking for high-throughput coverage. Bioinformatics. 23(4):427-33abs pdf