gmx x2top¶
Synopsis¶
gmx x2top [-f [<.gro/.g96/...>]] [-o [<.top>]] [-r [<.rtp>]]
[-ff <string>] [-[no]v] [-nexcl <int>] [-[no]H14]
[-[no]alldih] [-[no]remdih] [-[no]pairs] [-name <string>]
[-[no]pbc] [-[no]pdbq] [-n2t <string>] [-[no]smear]
[-[no]param] [-[no]round] [-kb <real>] [-kt <real>]
[-ktH <real>] [-dM <real>] [-dH <real>] [-aH <real>]
[-kp <real>]
Description¶
gmx x2top generates a primitive topology from a coordinate file.
The program assumes all hydrogens are present when defining
the hybridization from the atom name and the number of bonds.
The program can also make an .rtp entry, which you can then add
to the .rtp database.
When -param is set, equilibrium distances and angles
and force constants will be printed in the topology for all
interactions. The equilibrium distances and angles are taken
from the input coordinates, the force constant are set with
command line options.
The force fields somewhat supported currently are:
G53a5 GROMOS96 53a5 Forcefield (official distribution)
oplsaa OPLS-AA/L all-atom force field (2001 aminoacid dihedrals)
min MINFF force field for minerals (alias: minff)
The corresponding data files can be found in the library directory
with name atomname2type.n2t. Check Chapter 5 of the manual for more
information about file formats. By default, the force field selection
is interactive, but you can use the -ff option to specify
one of the short names above on the command line instead. In that
case gmx x2top just looks for the corresponding file.
The MINFF force field is described in Holmboe, Lavauzelle and Swai, MINFF: A Family of Classical Force Fields for Minerals with Tunable Angle Terms, arXiv preprint (2026), doi:10.48550/arXiv.2610.18220, and its parameters are available at https://github.com/mholmboe/minff.
With -ff min (or -ff minff) the topology is written in the compact
MINFF format. Only bonds involving hydrogen are listed in [ bonds ],
without parameters unless -kb is given, and the [ angles ]
get the measured angle and the force constant, annotated with the atom types.
No pairs or dihedrals are written. For these force fields the defaults are
441050 for -kb, 500 for -kt, 110 for -ktH, 1 for
-nexcl and MIN for -name. The bonded parameters are measured
from the structure, with periodic boundary conditions taken into account when
-pbc is set. With -dM and -dH the printed bond length
can be set for all bonds or for bonds to hydrogen only, and with -aH the
angles involving hydrogen are printed with a fixed value. Any of these, as
well as -kb, also adds the bond length and force constant columns to
[ bonds ].
Hydrogen atoms (for -ktH) are recognized from the atomic mass given in the
atomname2type.n2t file (below 2.5 u), otherwise from the element column of a
.pdb file, and as a last resort from the atom name starting with an H.
With -smear (-ff min only) the charges of oxygens (and structural
fluorines, type Fs) are not read from the table but computed from their
neighbors: q = -2 + sum((Z - q_j)/CN_j) over the bonded neighbors, with Z the formal
valence of the neighbor, q_j its charge from the table and CN_j its number of
bonds. This smears out the charge of isomorphic substitutions, see Tournassat et al.,
Clays and Clay Minerals 64, 374-388 (2016), doi:10.1346/CCMN.2016.0640403 and
Lammers et al., J. Colloid Interface Sci. 2017, doi:10.1016/j.jcis.2016.11.084.
The formal valence is derived from the MINFF atom type name (Si 4, Al 3, Fe2/Fe3,
Ti 4, Li 1, Mg 2, Ca 2, H 1). A non-integer total charge is then rounded to the
nearest integer by shifting all oxygens equally.
Options¶
Options to specify input files:
Options to specify output files:
-o[<.top>] (out.top) (Optional)Topology file
-r[<.rtp>] (out.rtp) (Optional)Residue Type file used by pdb2gmx
Other options:
-ff<string> (oplsaa)Force field for your simulation. Type “select” for interactive selection.
-[no]v(no)Generate verbose output in the top file.
-nexcl<int> (3)Number of exclusions
-[no]H14(yes)Use 3rd neighbour interactions for hydrogen atoms
-[no]alldih(no)Generate all proper dihedrals
-[no]remdih(no)Remove dihedrals on the same bond as an improper
-[no]pairs(yes)Output 1-4 interactions (pairs) in topology file
-name<string> (ICE)Name of your molecule
-[no]pbc(yes)Use periodic boundary conditions.
-[no]pdbq(no)Use the B-factor supplied in a .pdb file for the atomic charges
-n2t<string>Read the atom name to type translation from this file instead of the
atomname2type.n2tfiles of the force field-[no]smear(no)-ff min only: compute the charges of oxygens and fluorines from the charges of their neighbors (charge smearing) instead of reading them from the n2t table
-[no]param(yes)Print parameters in the output
-[no]round(yes)Round off measured values
-kb<real> (400000)Bonded force constant (kJ/mol/nm^2)
-kt<real> (400)Angle force constant (kJ/mol/rad^2)
-ktH<real> (-1)Angle force constant for angles involving hydrogen atoms (kJ/mol/rad^2). Negative means use
-ktfor all angles-dM<real> (-1)MINFF format only: print this bond length (nm) for all bonds instead of the default
-dH<real> (0)MINFF format only: print this bond length (nm) for bonds involving hydrogen
-aH<real> (0)MINFF format only: print this angle (degrees) for angles involving hydrogen instead of the measured one
-kp<real> (5)Dihedral angle force constant (kJ/mol/rad^2)
Known Issues¶
The atom type selection is primitive. Virtually no chemical knowledge is used
Periodic boundary conditions screw up the bonding
No improper dihedrals are generated
The atoms to atomtype translation table is incomplete (
atomname2type.n2tfile in the data directory). Please extend it and send the results back to the GROMACS crew.