Back to the tutorial main page

ProSMART Tutorial - Part 1

Restraining a Low-Resolution Structure
Using A Homologous Higher-Resolution Model

In this tutorial, we will generate ProSMART external restraints for the deposited 3.5Å structure with PDB code 1ryx using the sequence-identical 2.15Å structure 2d3i, which adopts a different global conformation and was solved in a different space group.

A basic working knowledge of the CCP4i GUI is assumed.

Before We Start

Required files:

Please click these three links to access the files individually and save them to a suitable location (e.g. your CCP4 working directory), or alternatively click here to get a .tar.gz containing all three files.

Contents


Automatic Generation Of External Restraints And Usage In Refinement

Follow these steps to automatically generate external restraints and use them in refinement using the REFMAC5 CCP4i GUI:

Essentially, that's all that's required in order to auto-generate ProSMART restraints using an exteral reference structure, and use them in refinement by REFMAC5! Indeed, clicking the "Run" button would not cause an error, and external restraints would be used in refinement.

However, it is always a good idea to really think about what options/parameters are being used when running ProSMART and REFMAC5, as suitable parameters will depend on the particular case. For example, there is only one chain in both target and reference structures in this scenario. However, in cases where multiple chains are present in either structure, careful thought must be given to which chains are to be used as target and reference structures. This can be achieved using the ProSMART CCP4i GUI or by providing the REFMAC5 CCP4i GUI with suitable ProSMART keywords - more information on this topic can be found in the ProSMART documentation. Whether or not local NCS restraints are used is also of importance.

Certain parameters/options in the REFMAC5 GUI have to be adjusted in order to use external restraints successfully. If you don't check these values, you will be unlikely to get good results when using external restraints. Now let's go back to the REFMAC5 CCP4i GUI:

That's it!!! Now it's time to re-refine the structure! Run the job, close the REFMAC5 GUI window, and return to the main CCP4i job list. While we're waiting for ProSMART and REFMAC5 to run, let's quickly consider how we could have done this using the command line instead of the REFMAC5 GUI.

(Optional) Generating And Using External Restraints Via The Command Line:

(Warning - only recommended for those who like using the command line!)

Whilst it's very convenient to use the CCP4i GUI for running jobs, it's a good idea to also gain experience in running programs via the command line in order to really understand what's going on.

  • Open the command line prompt, and navigate to the directory containing the data files 1ryx.pdb, 1ryx.mtz and 2d3i.pdb.
  • To generate the external restraints, type:
    prosmart -p1 1ryx.pdb -p2 2d3i.pdb -side
    and hit ENTER. This command specifies that ProSMART should generate restraints for 1ryx (keyword: -p1) using the homologous structure 2d3i (keyword: -p2), and to generate restraints for side chain atoms (keyword: -side) as well as main chain atoms. A list of other keywords can be found in the ProSMART documentation.
  • If successful, a directory called "ProSMART_Output" has been created, and the final external restraints file, called "1ryx.txt", has been created within this directory.
  • Create a simple script specifying the command to run REFMAC5, with the appropriate keywords (rather than typing it all out, you can access this script here):
    refmac5 > refmac_log.txt \
        XYZIN 1ryx.pdb  \
        HKLIN 1ryx.mtz  \
        XYZOUT pdb_out.pdb \
        HKLOUT mtz_out.mtz \
    <<EOF
    MAKE -
        HYDROGEN NO -
        NEWLIGAND CONTINUE
    NCYC 40
    EXTERNAL WEIGHT SCALE 10
    EXTERNAL WEIGHT GMWT 0.02
    EXTERNAL DMAX 4.2
    @ProSMART_Output/1ryx.txt
    MONI DIST 1000000
    END
    EOF
    
    The "EXTERNAL" keywords specify options that will be applied to any external restraints specified below that point in the script. The "@ProSMART_Output/1ryx.txt" line tells REFMAC5 to use all external restraints that are in our restraints file. The "MONI DIST 1000000" keyword avoids any restraint outliers being recorded as warnings in the REFMAC5 log file.
    Note that you can always see what keywords CCP4i uses by highlighting a job, selecting "View Files from Job", and selecting "View Command Scripts".
  • Run (source) this script in order to execute REFMAC5.

How To Check That External Restraints Are Actually Being Used

Hopefully, by now our REFMAC5 job in the CCP4i GUI should have finished successfully.

It is worth checking the REFMAC5 logfile to ensure that the external restraints were used as expected. Open the REFMAC5 logfile in CCP4i. You will notice that information regarding the execution of ProSMART is present at the top of the logfile. Now scroll down through the logfile to where the first refinement cycle begins (which is identified by the text: "CGMAT cycle number = 1"). Just above this position, you should see two tables containing information regarding the external restraints:

--------------------------------------------------------------------------------
 External restraints group   :            1
 External restraints file    :input_keywords
 Fail if one of the atoms involved in the restraints is missing in the pdb file
 Use restraints for all defined atoms
 Ignore restraints if abs(dmod-drest) >    50.00000     *sigma
 Ignore retraints if input dist >    4.200000    
 Weight scale sigmas         :   10.00000    
 Weight min sigma            :  0.0000000E+00
 Weight max sigma            :   100.0000    
 GM parameter                :  2.0000000E-02
 Number of distances         :       19248
 Number of angles            :           0
 Number of torsions          :           0
 Number of planes            :           0
 Number of chirals           :           0
 Number of intervals         :           0
--------------------------------------------------------------------------------
---------------------------------------
                        Standard  External       All
                Bonds:      4754     19248     24002
               Angles:      6510         0      6510
              Chirals:       770         0       770
               Planes:       859         0       859
             Torsions:      3176         0      3176
---------------------------------------
In our case, 19248 external bond restraints are being used, which is correct.

Inspection And Interpretation Of Results

Compare the initial and final R factor and R free values. What do you notice? Do you think the final model is better than the initial model?

Whilst R-factors (and other global statistics) are generally considered good indicators of refinement success/quality, when using external restraints it is often more important to inspect the local structure and density than to worry too much about R-factors, at least to begin with.

Consequently, we should now look at model and density in Coot, before and after refinement.

Manual inspection is an important part of the process. At your leisure, compare the two models/maps by looking at different regions of local structure. You can use Coot's Display Manager to switch models/maps on and off. Keep in mind the following questions:

Making use of ProSMART structural analysis in model building/refinement:

Whilst it can be tedious and time-consuming to manually go through the whole structure looking for issues, manual consideration is vital. Fortunately, the ProSMART structural analysis features can help you to quickly and easily identify regions that have changed during refinement, i.e. identify the regions that are in most desperate need of manual attention. We will introduce this ProSMART functionality later on in part 2 of this tutorial.

Now compare the Ramachandran plots of the two models in Coot (select "Validate -> Ramachandran Plot -> [model]"). Which of the models appears to have the most reasonable backbone geometry, overall? Why do you think this is? Would you expect this? What solid conclusions can you draw?

In this particular case, there are various regions that have undergone noteable changes during refinement with external restraints. We shall now focus on two such regions:

Visualising and Editting ProSMART Restraints in Coot

In Coot, you should see a "Restraints" tab next to the "Extensions" tab. If not, follow these instructions:

To visualise the ProSMART restraints:

You should see all of the restraints appear on the model (like a spider’s web). Red and blue restraints are those that indicate large differences between the interatomic differences in the target and reference models.

Strategy For Subsequent Refinement Iterations

If you want, try using Coot’s real space refinement and model building tools to get the two identified regions (residues 472-477 and 92, 191 and 209) into a reasonable conformation, and save this corrected file for further refinement. Otherwise, click here to access a pre-prepared modified model. If you were trying to properly refine this structure, you would go through the whole structure in Coot manually addressing all issues before continuing with further refinement, but for the purposes of this tutorial we will continue anyway.

Now that the external restraints have been used to improve the model, we release the external restraints in subsequent refinement iterations. This allows the model to find it's own density, instead of re-inforcing the bias towards the externally-derived information (i.e. in this case 2d3i.pdb). However, this has the negative consequence that we are no longer regularising refinement using external restraints. Consequently, we now use jelly-body restraints in place of the external restraints, which are also regularisers, but do not present any further external bias.

For our next round of refinement:

That's it!!! Note that we are not using external restraints, so "Use Prosmart" has been left at "no". Now it's time to re-refine the structure - run the job!

After the job has finished running, re-inspect the regions of interest (residues 472-477, and residues 92 and 191) in the jelly-body refined structure. You will see that the model sinks nicely into the density, suggesting that our re-modelling and refinement was reasonable (although of course it is not implied that these regions are now completely fixed - more model building/refinement and manual inspection would still be required).

Note that the effect of the external restraints has been maintained, even though the external restraints have been released.

In practice, further rounds of model re-building and refinement would be required. These would be performed using jelly-body restraints.

It is recommended to use external restraints in early/medium stages of refinement, followed by subsequent rounds of jelly-body refinement (without external restraints). Ultimately, the crystallographer should decide what strategy makes the most sense in their particular case. Further to injecting external information obtained from reliable sources (e.g. homologous structures), external restraints can be used to help stabilize a desired conformation whenever the density alone is of too poor quality to maintain it.

In the next tutorial, we will continue with this example case, exploring how we can use ProSMART to analyse local conformational differences between two structures. This can be useful for identifying which regions have changed during refinement with external restraints ProSMART can also be used to compare models from different stages of refinement, or to compare homologous models from different sources/crystals.


Back to the tutorial main page

------

Disclaimer - it is important to note that we are not criticizing the authors of the original deposited low-resolution model. Rather, due to improvements in macromolecular crystallographic refinement tools in recent years, we are now able to gain further insight that was not routinely possible at the time of original structure solution. Furthermore, we do not imply that the modifications applied to the model during this tutorial are necessarily accurate – this could only be confirmed/re-evaluated after performing extensive model rebuilding and refinement.