|
| Python-based Hierarchical ENvironment for Integrated Xtallography |
| Documentation Home |
The phenix.xtriage graphical interfaceConfiguration
The configuration of Xtriage is much simpler than most of the other programs
in the Phenix GUI; the minimum input is a reflection file and symmetry
information, which for MTZ files is automatically extracted. Xtriage is also
run automatically by the wizards (AutoSol, AutoBuild, and AutoMR) and the
graphical results can be viewed from the GUIs for those programs as well.
 The Parameters button opens a window containing the most essential information about the reflection data, including choice of data to analyze if more than one suitable Miller array is present. Xtriage will accept any reflection file format and both intensities and amplitudes, but a Scalepack or MTZ file with separate I+/I- is the most typical input. Most of this information will be extracted automatically if possible; at a minimum, only the input data and crystal symmetry are required. A complete listing of parameters can be found in the manual for the command-line version. Interpreting Xtriage output
The output of the GUI is nearly identical in content to the output of the
command-line version. The analyses performed can be divided into three
categories: data strength and completeness, lattice and symmetry properties,
and twinning detection. These are shown on three separate tabs in the results
window; at the top of each tab, a drop-down menu can be used to scroll to each
sub-section. Buttons on the toolbar open this page, the full Xtriage log
file, and a dialog for saving individual graphs, respectively.
 Suggestions for interpreting the results are given where appropriate; more detail explanations are hidden by default but may be shown by clicking the "Details. . ." text buttons. In general, many of the plots described have a distinctive and easily recognizable shape for strong, problem-free data. In some cases pathologies may be immediately recognized on the basis of abnormal curves (see for instance the section on twinning and pseudotranslation below). Data quality analyses
Data strength. Xtriage displays two graphs of signal-to-noise ratio, one
overall plot by resolution range, and a second combining signal-to-noise and
completeness (shown below). These are very similar to the output of
data-processing programs such as HKL2000 and the CCP4 suite (MOSFLM/SCALA),
and usually do not vary greatly unless the data are systematically incomplete
and/or very weak.
 This analysis is also used in the automatic determination of the high resolution limit used in the intensity statistics and twin analyses. A separate table shows completeness for low-resolution data alone. Low resolution completeness analysis.Most data processing software do not provide a clear picture of the completeness of the data at low resolution. For this reason, xtriage lists the completeness of the data up to 5 Angstrom: This analysis allows one to quickly see if there is any unusually low completeness at low resolution, for instance due to missing overloads. Wilson scaling.A Wilson plot analysis a la ARP/wARP is carried out, albeit with a slightly different standard curve. This determines overall B-factors (isotropic and anisotropic) for the data. A large spread in the diagonal values indicates anisotropy, as shown below (however, this example, the p9-sad structure included in the examples directory of the Phenix distribution, is actually very good data). The shape of the curve does not vary greatly for most data, and a large deviation from expected values is unusual. However, the resolution at which the maximum of the curve is found will be different depending on the type of molecule crystallized (protein vs. nucleic acid). Problems with the Wilson plot will be identified and reported; again, the p9-sad example is relatively free of pathologies:  A very long list of warnings could indicate a serious problem with your data. Decisions on whether or not the data is useful, should be cut or should thrown away altogether, is not straightforward and falls beyond the scope of Xtriage. Ice ring detection.Ice rings in the data are detected by analyzing the completeness and the mean intensity: Anomalous signal.If the input reflection file contains separate intensities for each Friedel mate, a quality measure of the anomalous signal is reported. The p9-sad example, a high-resolution SeMet SAD dataset, is shown again: Suggested resolution cutoffs at which the anomalous signal disappears are shown by the vertical lines. The p9-sad example is unusually excellent; a more difficult (but still solvable) dataset, the sec17 example in the Phenix distribution, is below:  Measurability values above 0.05 are encouraging; if the data do not reach this threshold at a usable resolution, successful phasing by SAD/MAD is extremely unlikely. Twinning analyses
Xtriage will print a summary of its interpretation of twinning analyses at
the top of the tab, including merohedral and pseudo-merohedral twin laws
compatible with the lattice. Below is the output for the pseudo-merohedrally
twinned porin-twin example data:
 Intensity distribution statisticsTwo separate tests for twinning rely on the cumulative distribution of intensities. Both of these result in plots with a distinctive shapes for normal vs. twinned data. The first, the NZ test, is shown below for the untwinned p9-sad data: The plot for a twinned dataset has sigmoidal curve instead:  Translational NCS (and translational pseudosymmetry) will also result in an abnormal curve, shifted up relative to the expected distribution. Below is the NZ test plot for an untwinned dataset with translational pseudosymmetry:  Because the combination of twinning and translational NCS may result in a curve that appears close to normal, it is important to consider the second test for twinning, the L-test. Here, twinning is indicated by an upwards shift of the curve relative to expected values:  Twin law testsIf the crystal symmetry is compatible with one or more twin laws, each of these will be analyzed separately to determine the expected twin fraction. Most of these will result in a very low twin fraction whether or not twinning is present, but the actual twin law, if any, will usually have a significantly higher value, reflected in the shape of the curves. Results from an untwinned crystal typically look like this: The actual twin law for the porin-twin example:  | |