|Register New User | Download | Documentation | Tutorials | FAQ | Top Tips | Bugs | Publications | Developers|
What does Phaser do?
Phaser is a program for phasing macromolecular crystal structures with maximum likelihood methods. It currently has methods for brute force and fast likelihood-based rotation and translation functions for molecular replacement. Methods for experimental phasing are under development.
Where do I report bugs and make suggestions?
Email the Phaser development team at firstname.lastname@example.org.
If I manage to solve my structure by molecular replacement using Phaser, what paper should I cite?
J. Appl. Cryst. (2007). 40, 658-674. Phaser crystallographic software. A. J. McCoy, R. W. Grosse-Kunstleve, P. D. Adams, M. D. Winn, L.C. Storoni and R.J. Read.
I registered some time ago but my password hasn't arrived yet.
In order for your password to arrive, your email address
has to be valid. If your password hasn't arrived within one hour, it
is likely that you entered your email incorrectly. In that case, please
What can I do if Phaser fails to solve my structure with default parameters?
Try some of the suggestions for difficult cases.
What does LLG stand for?
LLG stands for Log Likelihood Gain. The likelihood is the probability that the data would have been measured, given the model, so it allows us to compare how well different models agree with the data. (In the case of molecular replacement, the model consists of the atomic coordinates plus rotation and/or translation operators applied to those coordinates.) The LLG is the difference between the likelihood of the model and the likelihood calculated from a Wilson distribution, so it measures how much better the data can be predicted with your model than with a random distribution of the same atoms. The LLG allows us to compare different models against the same data set, but the LLG values for different data sets should not be compared with each other. See our publications for more details.
What does it mean if the best LLG is negative?
This means that your model is worse than a collection of random atoms! The LLG should always be positive, and it should increase as the solution progresses. If the LLG is negative (or if it decreases, say, when carrying out a translation search after a rotation search), that tells you that you are being too optimistic about how well your model can predict the data. Check whether you might have underestimated the content of the asymmetric unit, so that your model is less complete than you thought it was. If you're certain about the content, then your molecular replacement model is not as accurate as Phaser was assuming. Look at the model (or better yet a series of related models) to see whether there might be any domain movements. If there are, either search with separate domains or with a series of models with different hinge angles. If hinge movements don't explain the problem, try increasing the RMS error that Phaser has estimated from the sequence identity. If none of this works, think about other possibilities: do you have the wrong space group? have you crystallised the wrong protein?
I get the error "No scattering atoms" (version 1.3) or "program assert (total Mw >0) failure" (version 1.2).
This error detects when no atoms are accepted by the program. Phaser throws away water molecules and atoms with zero occupancy. Please check the PDB file that you're using to make sure that it has non-water atoms with occupancy greater than zero.
I get the error "Negative F".
Only structure factor amplitudes greater than or equal to zero make physical sense, and Phaser assumes that their values will be positive. If your MTZ file contains negative amplitudes, Phaser interprets this as a serious problem that you should fix before continuing. Check that the column really contains amplitudes, and not intensities (negative net intensities are physically sensible measurements). Avoid using programs that use negative values to flag amplitudes that arise from negative intensities; instead, convert intensities to amplitudes using a program like Truncate.
I get the error "CHECK INPUT: Molecular weight of x.pdb (x) deviates more than 10% from the mean (x). This pdb file may contain domains or water not present in the other files."
The models in an ensemble must be very similar for the ensembling procedure to make sense. If you have extra loops or domains in one or more of the pdb files in an ensemble, Phaser detects this by using the variation in the molecular weight and exits. You will need to look at your pdb files and edit them appropriately.
My input space group, as specified in the mtz-file, is X. The space group reported in phaser is Y.
The important thing for Phaser is the set of symmetry operators in the MTZ header, which defines the space group uniquely, not the name of the space group recorded in the header, which can be ambiguous if people use non-standard settings. Phaser uses Ralf Grosse-Kunstleve's cctbx library to look up the space group from the symmetry operations, and then reports the space group name from cctbx.
Phaser runs out of memory. What can I do?
Large problems consume a lot of memory, and we sometimes need more than 256Mb.
How can I use electron density as a model?
The procedure to prepare structure factors representing a masked region of electron density is discussed here. You will need to remember both the extent of the mask and the location of its centre to supply as input to Phaser.
How can I obtain a "mixed model", as described by Schwarzenbacher et al. (Acta Cryst. D60:1229-1236, 2004)?
Use the FFAS server maintained by the Godzik lab. However, the procedure to get a "mixed model" with the original conformation of conserved side chains is not immediately obvious.
I have installed Phaser both on its own and as part of Phenix. How do I make sure that the ccp4i interface finds the correct version of Phaser?
This shouldn't be a problem with recent versions of Phenix. To avoid this problem, recent versions of Phenix have a wrapper, phenix.phaser, which is used to run the Phenix version of Phaser. However, if you have other versions of Phaser on your system, you can use the information below to control which one is used by the ccp4i GUI.
By default, ccp4i uses the program name as a command, and leaves it to the $PATH variable (at least in Unix) to find the executable. If you have more than one executable with the same name, the one that comes first in your $PATH will be used. The best way to sort this out is by using a mechanism implemented in ccp4i for resolving name conflicts, by specifying unambiguously the location of the program that ccp4i should use.
I have installed Phaser and the ccp4i interface, but when I try to run Phaser from the interface I get the error message "couldn't execute "phaser": no such file or directory". How can I fix this?
The problem is that the phaser executable is not in your path. You either need to put it in your path (which you do either by putting the phaser executable in a directory that is already in your path, or by changing the definition of the $PATH environment variable in your setup files, e.g. .cshrc or .bashrc), or you need to tell the ccp4i interface where to find it, as in the answer to the question just above.
I am using Phaser to solve the structure of a nucleic acid, but it fails to detect serious clashes in the packing. What is going wrong?
The most likely problem is that Phaser is not recognising the residues as belonging to a nucleic acid. The residue name should be right-justified in the residue name field of ATOM records in a PDB file. So whereas 3-letter residue names for amino acids are in columns 18-20, 1-letter residue names for nucleic acids should be in column 20. If they are in column 18 or 19, they will not be recognised, and the trace atoms to detect clashes will not be picked up. A second possibility is that the atom names differ from those expected for the trace atoms.
The recent remediation of the PDB files to version 3 has created a problem for older versions of Phaser. Versions of Phaser up to 2.1.4 expect the pre-remediation residue names (e.g. A for the adenine residue in RNA, +A for modified versions such as deoxy in DNA). In the version 3 remediation of the PDB, a "D" was added to the standard names for the deoxy residues, so a new PDB file would now have DA for the adenine residue of DNA. To work around this, you can rename the residues to use the old convention (e.g. A or +A instead of DA) and Phaser will find the trace atoms for the clash detection. Newer versions of Phaser will recognise the new nomenclature.
Last updated: 9 April, 2009