Chimera Commands Index

Usage:
vina docking  receptor recmodel  ligand ligmodel  options

Like the Chimera AutoDock Vina tool, the vina command runs single-ligand docking calculations with AutoDock Vina. The process uses a web service provided by the National Biomedical Computation Resource (NBCR). Users should cite:

AutoDock Vina: improving the speed and accuracy of docking with a new scoring function, efficient optimization, and multithreading. Trott O, Olson AJ. J Comput Chem. 2010 Jan 30;31(2):455-61.
The receptor and ligand structures should be opened as separate models in Chimera and specified with the receptor and ligand keywords, respectively. The entire models containing the specified atoms will be used.

If the receptor contains MSE (selenomethionine) residues, incomplete side chains, or atoms with alternate locations, running Dock Prep beforehand to correct those issues is recommended. The vina command runs AutoDock accessory scripts locally to (further) prepare the structures, such as to add hydrogens if they have not been added already with Chimera.

Docking results will be shown automatically in ViewDock.

Options

Option keywords for vina can be truncated to unique strings and their case does not matter. A vertical bar “|” designates mutually exclusive options, and default values are indicated with bold. Synonyms for true: True, 1. Synonyms for false: False, 0.

output  name
Pathname (location and filename prefix) of output files. If the run is successful, the following files will be generated: If name is not specified, a temporary filename prefix and location will be used.
The default box in which to sample ligand positions will enclose the entire receptor, with extra space on all sides. If the region of interest is smaller, the desired box center and size should be specified to allow for a more efficient search:
search_center  x,y,z
In the receptor coordinate system, location of the center of the box in which to sample ligand positions.
search_size  xlen,ylen,zlen
In the receptor coordinate system, dimensions along X, Y, and Z of the box in which to sample ligand positions.
Settings for the receptor preparation script:
receptor_addh true | false
Whether to add hydrogens in Chimera (see addh) before calling the script. The receptor prep script will check for hydrogens and add them if they are missing. AutoDock Vina needs the polar (potentially H-bonding) hydrogens to identify atom types for scoring purposes.
receptor_nphs true | false
Whether to merge charges and remove nonpolar hydrogens. Note AutoDock Vina does not use charges or nonpolar hydrogens, so this setting is not expected to affect results except for the presence or absence of nonpolar hydrogens in the processed receptor.
receptor_lps true | false
Whether to merge charges and remove lone pairs. Note AutoDock Vina does not use charges or lone pairs, so this setting is not expected to affect results except for the presence or absence of lone pairs in the processed receptor (and there may not have been any lone pairs to start with).
receptor_waters true | false
Whether to remove water residues.
receptor_nonstdres true | false
Whether to remove chains composed entirely of residues other than the 20 standard amino acids.
receptor_nonstd true | false
Whether to remove all residues other than the 20 standard amino acids.
Settings for the ligand preparation script:
The ligand prep script will check for hydrogens and add them if they are missing. AutoDock Vina needs the polar (potentially H-bonding) hydrogens to identify atom types for scoring purposes.
ligand_nphs true | false
Whether to merge charges and remove nonpolar hydrogens. Note AutoDock Vina does not use charges or nonpolar hydrogens, so this setting is not expected to affect results except for the presence or absence of nonpolar hydrogens in the ligand output files.
ligand_lps true | false
Whether to merge charges and remove lone pairs. Note AutoDock Vina does not use charges or lone pairs, so this setting is not expected to affect results except for the presence or absence of lone pairs in the ligand output files (and there may not have been any lone pairs to start with).
Docking parameters:
num_modes  N
Maximum number of binding modes to generate (up to 20, default 9).
exhaustiveness  M
Thoroughness of search, roughly proportional to time (default 8).
energy_range  range
Maximum difference in score (default 3.0 kcal/mol); binding modes with scores not within range of the best score will be discarded.