INDOCK for DOCK 3.6: Difference between revisions
No edit summary |
m (note that remove_positive_solvation will be removed) |
||
Line 182: | Line 182: | ||
check_clashes yes | check_clashes yes | ||
If set to yes, this removes the positive solvation from each ligand atom and spreads it evenly over the molecule. This is | If set to yes, this removes the positive solvation from each ligand atom and spreads it evenly over the molecule. This is deprecated because it does unexpected things to solvation, and will be removed entirely soon. | ||
remove_positive_solvation no | remove_positive_solvation no |
Revision as of 01:43, 17 October 2011
What follows is a documented sample INDOCK file for DOCK 3.6. Many lines are required, lines starting with # are comments.
Required first line:
DOCK 3.5 parameter ############################################################################### ################## DOCK 3.5 INPUT PARAMETERS 2011/09/07 ####################### ############################################################################### ############################################################################### # INPUT/OUTPUT #
This is the path to the receptor matching spheres file. Most scripts make a set of directories and copy the INDOCK file into them, so this path sometimes has an extra set of "../" in it compared to what you might think. If you use DOCK Blaster. Generally, match3 has more spheres than match2, so produces more possible orientations. These spheres are matched to ligand spheres, generated from heavy atoms in the "rigid component" of each ligand. For more about the rigid component, see Flexibase Format.
receptor_sphere_file ../../sph/match3.sph
The next line is always 1, and is marked for deprecation.
cluster_numbers 1
The next line refers to which ligand file to use. If using many of the automated scripts, split_database_index is used, as this allows many ligand files (or just 1) to be placed in the split_database_index file and read in one after another during a DOCK run. If docking small things on your own, you can change this to any file.
# NOTE: split_database_index is reserved to specify a list of files ligand_atom_file split_database_index
This will control the file output, again many of the automated scripts expect it to be test. OUTDOCK files are always named OUTDOCK.
output_file_prefix test.
This controls the random seed used in the minimization procedure. Changing this will produce slightly different results.
random_seed 777 # ############################################################################### # MATCHING #
distance_tolerance is how different the distances can be between a pair of receptor matching spheres and a pair of ligand matching spheres for them to still be considered matched.
distance_tolerance 1.5
This changes how many spheres must be matched to generate an orientation. 3 as a minimum, 4 as a maximum is generally accepted as the right thing to use. Less than 3 is too degenerate to generate an actual orientation, and requiring more than 4 matched spheres does not work well, since we only use heavy atoms in ring systems to generate ligand matching spheres.
nodes_maximum 4 nodes_minimum 3
The next 4 parameters control how the histograms of distance differences are generated. The binsize is how big the bins are, the overlap controls if a sphere can be put into multiple bins. The ligand & receptor parameters are not required to be the same.
ligand_binsize 0.4 ligand_overlap 0.2 receptor_binsize 0.4 receptor_overlap 0.2
Bumping is using a quick check of distances when placing ligand atoms in the binding site to determine if they have a steric clash. The maximum is how many can be 'bumped' or in close steric contact per rigid or flexible component of the ligand, as per the Flexibase Format. Even ligands with some steric clashes can sometimes be rescued by minimization. Setting this number very high will cause many clashed orientations to be scored, which can be prohibitively slow.
bump_maximum 1
The next four parameters are unused and unsupported.
focus_cycles 0 focus_bump 0 focus_type energy critical_clusters no # ############################################################################### # COLORING #
This controls whether chemical matching or coloring is used at all. If yes, many match lines are necessary. These may not be perfect, but DOCK Blaster has been using these for a long time. Setting this to no produces many more matched orientations, which can be slow, but can help you understand exactly what the energy function is doing.
chemical_matching yes case_sensitive no # ligand color, receptor color match positive negative match positive negative_or_acceptor match positive not_neutral match negative positive match negative positive_or_donor match negative not_neutral match donor acceptor match donor donacc match donor negative_or_acceptor match donor neutral_or_acceptor_or_donor match donor not_neutral match acceptor donor match acceptor donacc match acceptor positive_or_donor match acceptor neutral_or_acceptor_or_donor match acceptor not_neutral match neutral neutral match neutral neutral_or_acceptor_or_donor match ester_o donor match ester_o donacc match ester_o positive_or_donor match ester_o not_neutral match amide_o donor match amide_o donacc match amide_o positive_or_donor match amide_o not_neutral
Single mode is deprecated, these parameters won't work. See Dock Ligand Clustering
# ############################################################################### # SINGLE MODE # #rmsd_override 0.0 #contact_minimum 0 #energy_maximum 1.0e+6 ##truncate_output 1000.0 #
Search mode is now the default/only mode of docking. Each parameter is described below.
############################################################################### # SEARCH MODE #
The ratio_minimum parameter has been slated for deprecation.
ratio_minimum 0.0
These parameters control how many atoms are necessary in the ligand for it to be docked.
atom_minimum 5 atom_maximum 100
How many of the top molecules will be saved in the output test.* file.
number_save 50000
The maximum number of molecules that will be scored in any given run.
molecules_maximum 300000
How many molecules will be skipped, this feature currently does not work.
initial_skip 0
How long a molecule is processed before quitting. This feature currently may not work as expected.
timeout 180
There are many scoring options:
# ############################################################################### # SCORING #
Valid options for ligand_desolvation are 'volume' (partial desolvation a la Mysinger & Shoichet 2010), 'full' meaning that the entire ligand is assumed to be desolvated in the binding site and 'none', where no desolvation penalties are applied.
ligand_desolvation volume
See the note about relative paths for the matching spheres above, the same comments apply here. There are 2 ways to run 'volume' or partial desolvation, one is to use one grid for every ligand atom like this:
solvmap_file ../../grids/solvmap_sev
The other option is to use one grid for ligand heavy atoms and one for ligand hydrogen atoms, you'll want to uncomment these lines to use them (and comment out the other solvmap_file line).
#solvmap_file ../../grids/solvmap_sev.heavy #hydrogen_solvmap_file ../../grids/solvmap.sev.hydrogen
This is the phimap file used for electrostatic scoring. For a better understanding of this grid, see Visualizing delphi.
delphi_file ../../grids/rec+sph.phi
This controls the chemgrid file, which contains the van der Waals scoring for every coordinate (chem.vdw will be called) as well as the distance map grids that will be used for deciphering bumping (chem.bmp will be called).
chemgrid_file_prefix ../../grids/chem
This is the parameter file that contains the atom type definitions:
vdw_parameter_file ../../grids/vdw.parms.amb.mindock
The following options allow the electrostatics and van der Waals parameters to be scaled relative to each other and the solvation scoring.
electrostatic_scale 1.0 vdw_scale 1.0
The following parameter lets ligands with internal steric clashes attempt to find a ligand conformation that scores well but does not have any internal clashes. Sometimes this procedure will fail in circumstances where there are many flexible branches, or where a ligand that is too large for the binding site is being docked.
check_clashes yes
If set to yes, this removes the positive solvation from each ligand atom and spreads it evenly over the molecule. This is deprecated because it does unexpected things to solvation, and will be removed entirely soon.
remove_positive_solvation no
After each orientation of the rigid component is processed and the many ligand conformations have been examined, the best ligand conformation for that orientation can be minimized using the following parameters.
# ############################################################################### # MINIMIZATION #
No turns off minimization completely.
minimize yes
Don't minimize molecules that score above the minimization_max.
minimization_max 1.0e15
If set to yes, this checks to see if the orientation has already been scored and quits. This has not been tested recently.
check_degeneracy no
How many iterations of minimization to do. More means longer run times, but potentially better poses.
simplex_iterations 250
How much the total energy can changed to be considered converged. Setting this higher will stop faster, setting it lower will cause it to do more iterations before converging (or potentially hitting the iteration max above).
simplex_convergence 0.1
If the energy changes by this much, restart the minimizer from this newest position.
simplex_restart 1.0
This is the initial distance in angstroms the molecule is translated (note that translation and rotation used to be swapped for many releases of DOCK).
simplex_initial_translation 0.2
How many degrees of initial rotation are done.
simplex_initial_rotation 5.0 # ############################################################################### ###############################################################################