A docking or simulation workflow can be ready to run—and still stumble over the structure you feed it. Alternate atom locations, unnecessary solvent, missing hydrogens, or incomplete residues can turn preparation into a frustrating detour. The key is not to apply every cleanup option automatically, but to identify what your next step needs and prepare the structure accordingly.
SAMSON brings quick cleanup, targeted validation, and deeper repair together in one workflow. Here’s a practical way to decide where to start.
Start with the question your structure needs to answer
Before deleting anything, consider the purpose of the model. A structure prepared for a particular docking workflow may not need the same contents as one being assembled for molecular dynamics. Ligands, cofactors, ions, and water molecules can be removed using SAMSON’s preparation tools, but first decide whether any of them are relevant to your system. Keeping that decision tied to the task helps avoid treating cleanup as a one-size-fits-all operation.
If the model looks complete and you mainly need routine cleanup, use Home > Prepare. This one-step process can remove alternate locations, delete selected classes of molecules, strip water, clear monatomic ions, and add hydrogens. It is a convenient starting point when you know which contents you want removed.

Resolve alternate locations, then inspect
Some structures contain multiple positions for atoms. These alternate locations can leave more than one candidate position in the model, even though a downstream workflow may expect a single set. In the quick preparation step, SAMSON keeps the highest-occupancy atoms. If occupancies are tied or unavailable, the selection follows a defined preference: location A when present, otherwise B, and so on.
When you want to review the issue before changing the structure, open Home > Validate, choose the Alt. locations tab, and click Find alternate locations. Review the reported atoms, then select Remove alt. locations to keep the highest-occupancy atoms. This manual route is useful when you want visibility into what will be removed.

Use validation to catch more than cleanup issues
Removing waters or adding hydrogens does not by itself tell you whether the model is otherwise ready. The Structure Validation module can also find bonds outside expected length ranges, detect non-standard residue aliases, and highlight clashes and contacts. These checks give you a chance to inspect potential problems instead of assuming that a clean-looking structure is a valid one.
If a clash involves side chains, the documentation points to the Rotamers editor as an option for changing side-chain conformations using a backbone-dependent rotamer library. Validation also includes tools to merge nodes, reorder atoms in a connected component, and renumber atom serial numbers—useful for keeping atom and node lists orderly for simulations.
Know when a one-click pass is not enough
Routine preparation is different from repairing an incomplete model. If residues or atoms are missing, the PDBFixer extension offers deeper fixes. It can add missing residues based on SEQRES records, build missing heavy atoms and side chains, convert non-standard residues to standard equivalents, resolve alternate locations, and add hydrogens for a specified pH. It can also remove water or heterogens, prepare explicit-solvent water boxes, and build lipid membranes around membrane proteins.
For hydrogens, SAMSON’s Edit > Add hydrogens command adds standard hydrogens at pH 7 for standard amino and nucleic acid residues, and uses valences for other structures. If you need pH-specific protonation, use PDBFixer instead. Whether minimization is needed after adding hydrogens depends on the downstream task; the documentation notes, for example, that AutoDock Vina needs only polar hydrogens for determining hydrogen bonds.
Preparing many structures?
For batches, the Batch Protein Prepare extension can process files in 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.
A useful sequence is: decide what the next workflow requires, remove only what is unnecessary, inspect the structure with validation, and use deeper repair when residues or atoms are missing. For full instructions and details, see the SAMSON protein preparation and validation tutorial.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
