X!Tandem Viewer Tutorial: Visualizing and Interpreting Search Results

X!Tandem Viewer: Quick Guide to Getting Started

X!Tandem Viewer is a lightweight tool for visualizing and inspecting peptide-spectrum matches (PSMs) from X!Tandem search outputs. This quick guide covers installation, loading results, basic navigation, interpreting key panels, and simple tips to speed up your initial analyses.

1. Install and launch

1. Download the latest X!Tandem Viewer release for your OS from the project site or repository.
2. Unpack the archive (if needed) and run the executable or script for your platform.
3. If the program requires Java, ensure you have a compatible JRE installed (check the Viewer’s documentation for version requirements).

2. Prepare input files

• X!Tandem Viewer reads X!Tandem XML output files (.tandem.xml).
• Also useful: corresponding FASTA used for the search and raw spectrum files (if you want spectrum display).
• Place related files in the same directory or note their paths before loading.

3. Load a result file

1. Use File → Open (or drag-and-drop) to load a .tandem.xml file.
2. The Viewer will parse identifications and populate the main tables and summary panels.
3. Loading large files may take time; monitor any progress indicator.

4. Main layout and panels

• Top/Left: Peptide/PSM list — lists identified peptides with scores, e-values, charge, and protein mappings.
• Top/Right: Protein list — shows protein groups and sequence coverage.
• Bottom: Spectrum viewer — displays the MS/MS spectrum for the selected PSM with annotated fragment ions.
• Filters/Search bar — filter by score, e-value, charge, modifications, or sequence.
• Status bar — shows file info and selected item summary.

5. Inspecting peptide-spectrum matches

1. Select a PSM in the peptide list. The spectrum viewer will load the corresponding MS/MS.
2. Look for major annotated peaks matching expected b/y ions; good matches have many annotated intense peaks.
3. Check precursor mass error (ppm or Da) and charge state — consistent low mass error supports the match.
4. Review post-translational modifications: they’ll be shown in sequence annotation and in mass tables.

6. Interpreting scores and confidence

• E-value / Expect score: lower is better; indicates how likely the match is due to chance.
• Hyperscore / Score: higher typically better; compare with dataset-specific distributions.
• Use conservative cutoffs (e.g., e-value < 0.01) or downstream FDR estimation with complementary tools for robust identification lists.

7. Protein view and coverage

• Select proteins to view mapped peptides and sequence coverage.
• Note shared peptides that map to multiple proteins; they reduce protein-level certainty.
• Use coverage visualization to prioritize well-supported proteins.

8. Exporting results

• Export peptide lists, protein lists, or spectral annotations via File → Export or right-click context menus.
• Common formats: CSV/TSV for tables and image/PDF for spectrum snapshots.

9. Troubleshooting common issues

• If spectra don’t display, confirm raw spectrum files are available and paths match the XML references.
• Slow performance on large files: try splitting results, increase Java memory (if applicable), or use machine with more RAM.
• Unexpected low identifications: verify search parameters (enzyme, modifications, precursor/fragment tolerances) and input quality.

10. Quick tips

• Sort by score or e-value to rapidly find high-confidence PSMs.
• Use mass error histograms (if available) to check calibration.
• Save frequently used filters as presets if the Viewer supports it.
• Combine Viewer inspection with FDR tools (Percolator or target-decoy approaches) for rigorous filtering.

If you want, I can provide a short checklist for validating a set of identifications or a sample filter preset (e.g., e-value, mass error, minimum peaks matched).