Action: HBONDS
| Module | colvar |
|---|---|
| Description | Usage |
| Calculate the number of hydrogen bonds using the Wernet-Nilsson criterion. | |
| output value | type |
| the number of hydrogen bonds | scalar |
Details and examples
Calculate the number of hydrogen bonds using the Wernet-Nilsson criterion.
This action counts the hydrogen bonds between a set of donors (with their hydrogens) and a set of acceptors.
A donor D, one of its hydrogens H and an acceptor A form a hydrogen bond according to the criterion of Wernet and Nilsson
(the one used by the wernet_nilsson function of mdtraj) if
where is the donor-acceptor distance and is the angle, in degrees, between the D-H and the D-A vectors. The criterion is a condition on a single variable,
which has to be smaller than 0.33 nm. The step function is replaced by a switching function of , so that the CV is
and it has continuous derivatives. The default switching function is {CUBIC D_0=0.31 D_MAX=0.35} (in nm),
which is one below 0.31 nm, zero above 0.35 nm and 1/2 at 0.33 nm. You can change it with the SWITCH keyword
(see LESS_THAN for the available switching functions). For instance a very sharp switching function
such as {CUBIC D_0=0.3299 D_MAX=0.3301} reproduces the number of hydrogen bonds computed by mdtraj, but should not be used to bias a simulation.
The angle cutoff of 45 degrees that mdtraj also applies is not needed here: at that angle the criterion
already requires a donor-acceptor distance shorter than 0.24 nm.
The donors, the hydrogens and the acceptors are given as three lists of atoms, in any order. Each hydrogen is assigned to the closest donor, which must be closer than 0.13 nm (a covalent D-H bond). This assignment is done once, on the first configuration. Hydrogens that are not bonded to any of the donors are ignored, as are the donors without hydrogens, and the number of each is written in the log. A donor that is also an acceptor does not accept from itself. An atom cannot be both in DONORS and in HYDROGENS, and an atom cannot be repeated in the same list.
The MOLINFO shortcuts @hbdonors, @polarhydrogens and @hbacceptors select the N and O atoms bonded to a hydrogen,
the hydrogens bonded to an N or an O atom and all the N and O atoms of the reference structure respectively.
As in mdtraj, all N and O atoms are acceptors.
In the example below all the hydrogen bonds formed within a protein are counted:
#SETTINGS MOLFILE=regtest/basic/rt-hbonds/ref.pdb MOLINFOThis command is used to provide information on the molecules that are present in your system. More details STRUCTUREa file in pdb format containing a reference structure=regtest/basic/rt-hbonds/ref.pdbClick here to see an extract from this file.hb: HBONDSCalculate the number of hydrogen bonds using the Wernet-Nilsson criterion. More details DONORSThe atoms that can donate a hydrogen bond (usually the N and O atoms bonded to a hydrogen, e=@hbdonorsthe N and O atoms bonded to a hydrogen (the hydrogen-bond donors of HBONDS). Click here for more information. HYDROGENSThe hydrogens that can be donated (e=@polarhydrogensthe hydrogens bonded to an N or O atom, i.e. whose closest C, N or O atom is an N or O atom within 0.13 nm (the hydrogens of HBONDS). Click here for more information. ACCEPTORSThe atoms that can accept a hydrogen bond (usually the N and O atoms, e=@hbacceptorsall N and O atoms (the hydrogen-bond acceptors of HBONDS). Click here for more information. PRINTPrint quantities to a file. More details ARGthe labels of the values that you would like to print to the file=hb FILEthe name of the file on which to output these quantities=colvar
The atoms can also be given explicitly. This input counts the hydrogen bonds in a box of 64 water molecules, in which the oxygens are atoms 1, 4, 7... and the hydrogens are the atoms that follow each oxygen. The oxygens are both donors and acceptors, and a neighbor list on the donor-acceptor distance is used (as for COORDINATION, NL_CUTOFF should be larger than D_MAX of the switching function):
hb: HBONDSCalculate the number of hydrogen bonds using the Wernet-Nilsson criterion. More details ... DONORSThe atoms that can donate a hydrogen bond (usually the N and O atoms bonded to a hydrogen, e=1-192:3 HYDROGENSThe hydrogens that can be donated (e=2-192:3,3-192:3 ACCEPTORSThe atoms that can accept a hydrogen bond (usually the N and O atoms, e=1-192:3 SWITCHThe switching function applied to s = r_DA + k delta^2. Options for this keyword are explained in the documentation for LESS_THAN.={CUBIC D_0=0.31 D_MAX=0.35} NLISTCELLS Use a neighbor list of the donor-acceptor pairs to speed up the calculation - use the cell list implementation instead of the classical one NL_CUTOFFThe cutoff on the donor-acceptor distance for the neighbor list (it should be larger than D_MAX of the switching function)=0.6 NL_STRIDEThe frequency with which the neighbor list is updated=10 ... PRINTPrint quantities to a file. More details ARGthe labels of the values that you would like to print to the file=hb FILEthe name of the file on which to output these quantities=colvar
Only N and O atoms (or other electronegative atoms) should be given as donors and acceptors: the hydrogens bonded to any atom in DONORS are used, so if a carbon was in the list its hydrogens would be donated.
Input
The atoms that serve as the input for this action are specified using one or more of the keywords in the following table.
| Keyword | Type | Description |
|---|---|---|
| DONORS | atoms | The atoms that can donate a hydrogen bond (usually the N and O atoms bonded to a hydrogen, e |
| HYDROGENS | atoms | The hydrogens that can be donated (e |
| ACCEPTORS | atoms | The atoms that can accept a hydrogen bond (usually the N and O atoms, e |
Full list of keywords
The following table describes the keywords and options that can be used with this action
| Keyword | Type | Default | Description |
|---|---|---|---|
| DONORS | input | none | The atoms that can donate a hydrogen bond (usually the N and O atoms bonded to a hydrogen, e |
| HYDROGENS | input | none | The hydrogens that can be donated (e |
| ACCEPTORS | input | none | The atoms that can accept a hydrogen bond (usually the N and O atoms, e |
| NUMERICAL_DERIVATIVESThis keyword do not have examples | optional | false | calculate the derivatives for these quantities numerically |
| NOPBCThis keyword do not have examples | optional | false | ignore the periodic boundary conditions when calculating distances |
| SWITCH | optional | not used | The switching function applied to s = r_DA + k delta^2. Options for this keyword are explained in the documentation for LESS_THAN. |
| SERIALThis keyword do not have examples | optional | false | Perform the calculation in serial - for debug purpose |
| NLISTThis keyword do not have examples | optional | false | Use a neighbor list of the donor-acceptor pairs to speed up the calculation |
| NLISTCELLS | optional | false | Use a neighbor list of the donor-acceptor pairs to speed up the calculation - use the cell list implementation instead of the classical one |
| NL_CUTOFF | optional | not used | The cutoff on the donor-acceptor distance for the neighbor list (it should be larger than D_MAX of the switching function) |
| NL_STRIDE | optional | not used | The frequency with which the neighbor list is updated |