GeinDock Suite
Home › Step 2: Ligands

Step 2: Ligands

Adding compounds from files, folders, line notation or a drawing, checking what was read, and preparing them all for the search.

Step 2 collects the compounds you want to dock and turns each of them into a three dimensional, protonated, charged structure with its rotatable bonds identified. You can supply them as files, as a folder, as text formulae, or by drawing them, and they all end up in the same table and go through the same preparation.

Add Ligands opens the Ligand Upload and Preparation dialog.

The ligand upload and preparation dialog
The dialog has three sections: where the ligands come from, what was read in, and how to prepare them.

1. Adding ligands

Button What it does
Add Ligand FilesA file chooser that accepts several files at once. It lists MOL, SDF, PDB and MOL2 files, so convert a ligand held in any other format to one of those first.
Add FolderAdds every structure file in a folder in one action. This is how you set up a screen over a compound library.
Add SMILESA text box that takes one line notation string per line. Each becomes a ligand, and the preparation step generates three dimensional coordinates for it.
Draw LigandOpens the 2D sketcher, described in The 2D sketcher. Draw a structure and it is added as a ligand.
Clear AllEmpties the list.
The line notation entry box
One string per line. This is the quickest way to set up a small series of analogues without leaving the application.

2. Reviewing what was read

Every ligand appears as a row in the table, and the table is a check on the input rather than a simple list.

Column What it tells you
SelectA tick box. Only ticked ligands are prepared and docked, so you can load a folder and then dock part of it.
FilenameThe name the ligand will be reported under everywhere else in the application, including the progress line, the Job Queue and the pose table.
FormatThe format the reader recognised. Worth a glance: a file with the wrong extension shows up here.
Atoms and BondsCounts as read. A count of zero, or one far smaller than expected, means the file did not parse the way you assumed.
Size (KB)The file size, which is a quick way to spot an empty or truncated file.
StatusThe verdict. Valid means the structure was read and makes chemical sense. Anything else needs looking at before you dock it.

Select All, Deselect All and Remove Selected below the table manage the list.

Check the atom counts against what you expect. A line notation string that was truncated on the way into the application, or a structure file that contains only the first molecule of a multi record file, both look perfectly normal until you notice the atom count is wrong. The table is the cheapest place to catch that.

3. Preparation options

Option Default What it does
Add hydrogen atomsOnAdds the hydrogens the input is missing. Structures drawn in two dimensions and line notation strings both carry only implicit hydrogens, so this is nearly always needed.
Protonation pH7.4The pH at which ionisable groups on the ligand are protonated. Use the same value you used for the receptor, so that the two are consistent.
Generate 3D coordinates (for SMILES)Always onBuilds a three dimensional conformer for a ligand that arrives without one, which is every ligand entered as a line notation string. The box is ticked and greyed out because it is there to inform you rather than to be set: the step always happens, since a ligand without coordinates cannot be docked.
Energy minimizationOnRelaxes the generated geometry with a force field so that bond lengths and angles are reasonable before the search starts. A strained input costs the search effort it should be spending on the pose.
ForcefieldMMFF94Which force field the minimisation uses. MMFF94 is a good general purpose choice for drug like organic molecules.
Check and fix valence errorsOffLooks for atoms with impossible valences, usually from a mis-drawn structure or an imperfect file, and repairs them where it safely can. Turn it on when you are importing structures whose provenance you do not control.
Why the three dimensional step matters so much. A docking search explores the ligand's rotatable bonds, but it does not rebuild its bond lengths, its ring conformations or its stereochemistry. Those come from the input geometry and are carried through unchanged. A poor starting conformer therefore puts a ceiling on how good any pose can be, no matter how hard you search.

4. Preparing

Prepare Ligands runs the whole list in one pass and reports progress as it goes. When it finishes, the dialog closes and step 2 in the panel summarises what happened: the first few names, how many there are in total, and a prepared count in the form Prepared: 1 / 1.

The chip reads prepared only when every ligand succeeded. If it reads added, the counts differ and at least one ligand did not prepare; reopen the dialog and look at the status column to find which.

The panel with a ligand prepared
Steps 1 and 2 are both complete. The summary names the ligand and confirms that it prepared successfully.
A ligand loaded on its own is not yet placed in the site. When a ligand is added before docking, it is drawn wherever its own file places it, which is usually nowhere near the receptor. The status bar says so explicitly rather than leaving you to wonder. Nothing is fitted until a docking run produces a pose.

Docking many ligands at once

There is no separate batch mode to switch into. A run docks every prepared ligand in the list against the receptor, one after another, and reports them all into the same pose table. To screen a library, add the folder, prepare it, and run.

Two things are worth knowing before you start a large batch.