Before the Docking Run: A Practical Protein-Preparation Checklist

A docking workflow can be ready to run while the protein structure still needs attention. Alternate atom locations, unwanted waters, missing hydrogens, or incomplete residues can complicate the next step—or lead you to spend time troubleshooting a structure that was never ready for it.

The useful question is not “How do I clean everything?” but “What does this workflow need, and what problems does this structure actually have?” Here’s a practical way to decide, using SAMSON’s preparation and validation tools.

Start with the task, not the cleanup button

Protein preparation is not one universal recipe. A structure intended for docking may need different treatment from one being set up for molecular dynamics or inspected for structural features. Before removing anything, consider whether waters, ions, cofactors, or ligands are relevant to your specific system. The one-click preparation option can delete ligands—including covalently attached ligands—along with water and monatomic ions, so review what is present and decide what should remain.

If the structure looks clean and you need routine preparation, go to Home > Prepare. The dialog can remove alternate locations, delete selected categories of small molecules, strip water, clear monatomic ions, and add hydrogens. For many everyday workflows, this is a convenient first pass.

SAMSON Prepare dialog

Understand what “remove alternate locations” means

Some structures contain alternate positions for atoms. Keeping all alternatives can leave multiple positions represented where a downstream workflow expects a single structure. SAMSON’s preparation step keeps the highest-occupancy atoms. When occupancies are tied or missing, it uses the available alternate-location labels in a defined order, preferring A when present, then B, and so on.

If you want to inspect before changing the structure, open Home > Validate, choose the Alt. locations tab, and click Find alternate locations. Review the results, then use Remove alt. locations when you’re ready. This inspect-first approach is especially useful when you want to understand what the file contains before applying cleanup.

Structure validation alternate locations

Use validation to catch issues a cleanup pass won’t solve

Removing water or adding hydrogens does not, by itself, establish that a structure is ready for every purpose. The Structure Validation module can also check bond lengths, identify non-standard residue aliases, and highlight clashes and contacts. It includes utilities for merging nodes, reordering atoms in a connected component, and renumbering atom serial numbers.

For side-chain clashes, the documentation points to the Rotamers editor, which can change side chains using a backbone-dependent rotamer library. Treat a flagged issue as something to investigate in the context of your model, rather than assuming every alert has the same significance for every workflow.

Know when to move beyond quick preparation

Routine preparation and repairing an incomplete structure are different jobs. If residues or atoms are missing, use the PDBFixer extension rather than expecting the one-click preparation step to build them. PDBFixer can add missing residues based on SEQRES records, add missing heavy atoms and side chains, convert non-standard residues to standard equivalents, and add hydrogens at a specified pH. It can also resolve alternate locations, remove water or heterogens, and build explicit-solvent water boxes or lipid membranes.

For hydrogens alone, Edit > Add hydrogens adds standard hydrogens at pH 7, using residue types for standard amino and nucleic acids and valences for other atoms. You can select a sub-structure first to limit where they are added. If a particular pH is important, PDBFixer provides the pH-specific option. Minimization may be appropriate for some downstream tasks, but it is not automatically required after adding hydrogens; for example, the cited AutoDock Vina workflow needs only polar hydrogens for determining hydrogen bonds.

Preparing more than one structure

When the task involves many files, Batch Protein Prepare can apply the same cleaning steps to a folder while preserving its internal subfolder structure. It accepts PDB, PDBx/mmCIF, MMTF, and MOL2 inputs. It can also download and prepare structures from PDB identifiers supplied as a string or in a text file. That can make a repeated preparation task more consistent and reduce manual file handling.

A simple decision path: use Prepare for routine cleanup; use Validate when you need to inspect specific structural issues; use PDBFixer when residues or atoms are missing or you need a deeper repair. Then continue with the docking, simulation, or analysis workflow your model is intended for.

For full instructions and related tutorials, see the SAMSON Protein Preparation & Validation tutorial.

Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.

Comments are closed.