Provided by: gromacs-data_5.1.2-1ubuntu1_all bug

NAME

       gmx-nmeig - Diagonalize the Hessian for normal mode analysis

SYNOPSIS

          gmx nmeig [-f [<.mtx>]] [-s [<.tpr>]] [-of [<.xvg>]] [-ol [<.xvg>]]
                    [-os [<.xvg>]] [-qc [<.xvg>]] [-v [<.trr/.cpt/...>]]
                    [-xvg <enum>] [-[no]m] [-first <int>] [-last <int>]
                    [-maxspec <int>] [-T <real>] [-[no]constr] [-width <real>]

DESCRIPTION

       gmx  nmeig  calculates  the  eigenvectors/values  of  a  (Hessian)  matrix,  which  can be
       calculated with gmx mdrun.  The eigenvectors are written to a trajectory file  (-v).   The
       structure  is  written  first  with  t=0.  The eigenvectors are written as frames with the
       eigenvector number as timestamp.  The eigenvectors can be analyzed with  gmx  anaeig.   An
       ensemble  of  structures  can be generated from the eigenvectors with gmx nmens. When mass
       weighting is used, the generated eigenvectors will  be  scaled  back  to  plain  Cartesian
       coordinates  before  generating  the  output. In this case, they will no longer be exactly
       orthogonal in the standard Cartesian norm, but in the mass-weighted norm they would be.

       This program can be optionally used to compute quantum corrections to  heat  capacity  and
       enthalpy  by  providing  an extra file argument -qcorr. See the GROMACS manual, Chapter 1,
       for details. The result includes subtracting a harmonic degree of  freedom  at  the  given
       temperature.  The total correction is printed on the terminal screen.  The recommended way
       of getting the corrections out is:

       gmx nmeig -s topol.tpr -f nm.mtx -first 7 -last 10000 -T 300 -qc [-constr]

       The -constr option should be used when bond constraints were used  during  the  simulation
       for  all  the  covalent  bonds.  If  this  is  not  the  case,  you  need  to  analyze the
       quant_corr.xvg file yourself.

       To make things more flexible, the program can also take virtual sites  into  account  when
       computing quantum corrections. When selecting -constr and -qc, the -begin and -end options
       will be set automatically as well.  Again, if you think you know it better,  please  check
       the eigenfreq.xvg output.

OPTIONS

       Options to specify input files:

       -f [<.mtx>] (hessian.mtx)
              Hessian matrix

       -s [<.tpr>] (topol.tpr)
              Portable xdr run input file

       Options to specify output files:

       -of [<.xvg>] (eigenfreq.xvg)
              xvgr/xmgr file

       -ol [<.xvg>] (eigenval.xvg)
              xvgr/xmgr file

       -os [<.xvg>] (spectrum.xvg) (Optional)
              xvgr/xmgr file

       -qc [<.xvg>] (quant_corr.xvg) (Optional)
              xvgr/xmgr file

       -v [<.trr/.cpt/...>] (eigenvec.trr)
              Full precision trajectory: trr cpt tng

       Other options:

       -xvg <enum>
              xvg plot formatting: xmgrace, xmgr, none

       -[no]m (yes)
              Divide  elements  of  Hessian  by  product of sqrt(mass) of involved atoms prior to
              diagonalization. This should be used for 'Normal Modes' analysis

       -first <int> (1)
              First eigenvector to write away

       -last <int> (50)
              Last eigenvector to write away

       -maxspec <int> (4000)
              Highest frequency (1/cm) to consider in the spectrum

       -T <real> (298.15)
              Temperature for computing quantum heat capacity and enthalpy when using normal mode
              calculations to correct classical simulations

       -[no]constr (no)
              If  constraints  were  used  in  the simulation but not in the normal mode analysis
              (this is the recommended way of doing it) you will need to set this  for  computing
              the quantum corrections.

       -width <real> (1)
              Width (sigma) of the gaussian peaks (1/cm) when generating a spectrum

SEE ALSO

       gmx(1)

       More information about GROMACS is available at <http://www.gromacs.org/>.

COPYRIGHT

       2015, GROMACS development team