Findclash identifies interatomic clashes and contacts based on VDW radii and user-specified criteria. It is the command-line implementation of Find Clashes/Contacts. Terminology:
The overlap between two atoms is defined as the sum of their VDW radii minus the distance between them and minus an allowance for potentially hydrogen-bonded pairs:
overlapij = rVDWi + rVDWj – dij – allowanceij
Option keywords for findclash 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.
Whether to find all interactions between the specified atoms and other atoms (other or others, default), only intra-model interactions between the specified atoms and other atoms (model), or all interactions among the specified atoms (self).
Whether to look for interactions between submodels of the same model.
Pairs of atoms with overlap ≥ cutoff (default 0.6 Å) will be identified. A larger positive cutoff restricts the results to more severe clashes, whereas a negative cutoff can also identify favorable contacts.
An allowance > 0 (default 0.4 Å) reflects the observation that atoms sharing a hydrogen bond can favorably approach each other more closely than would be expected from their VDW radii. See above for suggested values. In the calculation of overlap, the allowance is only subtracted for pairs comprised of a donor (or donor-borne hydrogen) and an acceptor. This is equivalent to using smaller radii to characterize hydrogen-bonding interactions (for example, see Li and Nussinov, Proteins 32:111 (1998)). As in FindHBond, possible donor groups are hydrogen-bearing nitrogen, oxygen, and sulfur atoms, and possible acceptor groups are nitrogen, oxygen, and sulfur atoms with a lone pair.
Interactions between atoms that are ≤ N bonds apart will be ignored (N=4 by default).
Whether to ignore interactions between atoms in the same residue.
Whether to initiate continuous checking, which will continue until the specified atoms are removed, or ~findclash is used, or findclash is used again without setting this option to true (since false is the default).
Whether to select the identified clash/contact atoms (and deselect all other atoms).
Whether to color the identified clash/contact atoms the clashColor and the remaining atoms the nonclashColor.
Color to use for the identified clash/contact atoms when colorClashes is true (default red). Colorname can be none or any color name that specifies a single color.
Color to use for atoms other than the identified clash/contact atoms when colorClashes is true (default none, which removes per-atom color assignments and reveals the model-level colors). Colorname can be none or any color name that specifies a single color.
Whether to create pseudobonds to show the identified interactions. These pseudobonds can be removed with the command ~findclash. The PseudoBond Panel can also be used to close the pseudobond group (named contacts) or alter its display.
Color to use for the pseudobonds when makePseudobonds is true (default yellow). Colorname can be none or any color name that specifies a single color.
Line width to use for the pseudobonds when makePseudobonds is true (default 2.0 pixels).
Whether to assign the largest overlap per atom as an attribute named overlap. Disallowed with continuous monitoring.
Whether to write contact/clash information to a file (this option is off unless specified). The information includes atom specifications (see namingStyle), overlaps, and interatomic distances. File is the output file name/pathname; if it includes spaces, it must be enclosed in single or double quote marks. If file is browse or browser, a dialog for saving the file will appear (unless the word is enclosed in quotes, which would generate an output file by that name). Disallowed with continuous monitoring.
Whether to write contact/clash information (as described above for saveFile) to the Reply Log. Disallowed with continuous monitoring.
How to describe atoms in contact/clash information written to a file or the log:
Model number will be included when multiple models are present. If namingStyle is not supplied, the Atomspec display style specified in the General preferences will be used.
- simple - residue name, residue specifier, and atom name (for example, HIS 16.A ND1)
- command or command-line - command-line specifier (for example, :16.A@ND1)
- serial or serialnumber - atom serial number (for example, 126)
summary true|falseSee also: distance, hbonds, crystalcontacts, intersurf, minimize, Find Clashes/Contacts, the PseudoBond Panel
Whether to write the total number of interactions found to the status line and Reply Log.