Man Linux: Main Page and Category List

NAME

       g_analyze - analyzes data sets

       VERSION 4.0.1

SYNOPSIS

       g_analyze  -f  graph.xvg  -ac autocorr.xvg -msd msd.xvg -cc coscont.xvg
       -dist distr.xvg -av average.xvg -ee  errest.xvg  -g  fitlog.log  -[no]h
       -nice  int -[no]w -[no]xvgr -[no]time -b real -e real -n int -[no]d -bw
       real   -errbar   enum   -[no]integrate   -aver_start   real   -[no]xydy
       -[no]regression  -[no]luzar  -temp  real  -fitstart  real  -smooth real
       -filter   real   -[no]power   -[no]subav   -[no]oneacf   -acflen    int
       -[no]normalize  -P  enum -fitfn enum -ncskip int -beginfit real -endfit
       real

DESCRIPTION

       g_analyze reads an ascii file and analyzes data sets.  A  line  in  the
       input  file may start with a time (see option  -time) and any number of
       y values may follow.  Multiple sets can also  be  read  when  they  are
       seperated by & (option  -n), in this case only one y value is read from
       each line.  All lines starting with  and @ are skipped.   All  analyses
       can also be done for the derivative of a set (option  -d).

       All  options,  except  for   -av and  -power assume that the points are
       equidistant in time.

       g_analyze always shows the average and standard deviation of each  set.
       For  each  set  it  also  shows the relative deviation of the third and
       forth cumulant from those of a  Gaussian  distribution  with  the  same
       standard deviation.

       Option  -ac produces the autocorrelation function(s).

       Option   -cc  plots  the  resemblance  of  set  i  with a cosine of i/2
       periods. The formula is: 2 (int0-T y(t) cos(i pi t) dt)2 / int0-T  y(t)
       y(t) dt

       This  is  useful  for  principal  components  obtained  from covariance
       analysis, since the principal components of random diffusion  are  pure
       cosines.

       Option  -msd produces the mean square displacement(s).

       Option  -dist produces distribution plot(s).

       Option   -av  produces  the  average  over the sets.  Error bars can be
       added with the  option   -errbar.   The  errorbars  can  represent  the
       standard  deviation, the error (assuming the points are independent) or
       the interval containing 90% of the points,  by  discarding  5%  of  the
       points at the top and the bottom.

       Option   -ee  produces error estimates using block averaging.  A set is
       divided in a number of blocks and  averages  are  calculated  for  each
       block.  The error for the total average is calculated from the variance
       between averages of the m blocks B_i as follows: error2 =  Sum  (B_i  -
       B)2  /  (m*(m-1)).  These errors are plotted as a function of the block
       size.  Also an analytical block average curve is plotted, assuming that
       the autocorrelation is a sum of two exponentials.  The analytical curve
       for the block average is:

       f(t) = sigma sqrt(2/T (  a   (tau1 ((exp(-t/tau1) - 1) tau1/t + 1)) +

                              (1-a) (tau2 ((exp(-t/tau2) - 1) tau2/t +  1)))),
       where  T  is  the total time.  a, tau1 and tau2 are obtained by fitting
       f2(t) to error2.  When the actual block average is very  close  to  the
       analytical  curve,  the error is sigma*sqrt(2/T (a tau1 + (1-a) tau2)).
       The  complete  derivation  is  given  in  B.  Hess,  J.   Chem.   Phys.
       116:209-217, 2002.

       Option   -filter  prints the RMS high-frequency fluctuation of each set
       and over all sets with respect to a filtered average.   The  filter  is
       proportional to cos(pi t/len) where t goes from -len/2 to len/2. len is
       supplied with the option  -filter.  This  filter  reduces  oscillations
       with period len/2 and len by a factor of 0.79 and 0.33 respectively.

       Option  -g fits the data to the function given with option  -fitfn.

       Option   -power fits the data to b ta, which is accomplished by fitting
       to a t + b on log-log  scale.  All  points  after  the  first  zero  or
       negative value are ignored.

       Option   -luzar performs a Luzar & Chandler kinetics analysis on output
       from  g_hbond. The input file can be taken directly from  g_hbond  -ac,
       and then the same result should be produced.

FILES

       -f graph.xvg Input
        xvgr/xmgr file

       -ac autocorr.xvg Output, Opt.
        xvgr/xmgr file

       -msd msd.xvg Output, Opt.
        xvgr/xmgr file

       -cc coscont.xvg Output, Opt.
        xvgr/xmgr file

       -dist distr.xvg Output, Opt.
        xvgr/xmgr file

       -av average.xvg Output, Opt.
        xvgr/xmgr file

       -ee errest.xvg Output, Opt.
        xvgr/xmgr file

       -g fitlog.log Output, Opt.
        Log file

OTHER OPTIONS

       -[no]hno
        Print help info and quit

       -nice int 0
        Set the nicelevel

       -[no]wno
        View output xvg, xpm, eps and pdb files

       -[no]xvgryes
        Add  specific  codes  (legends  etc.)  in the output xvg files for the
       xmgrace program

       -[no]timeyes
        Expect a time in the input

       -b real -1
        First time to read from set

       -e real -1
        Last time to read from set

       -n int 1
        Read  sets seperated by &

       -[no]dno
        Use the derivative

       -bw real 0.1
        Binwidth for the distribution

       -errbar enum none
        Error bars for -av:  none,  stddev,  error or  90

       -[no]integrateno
        Integrate data function(s) numerically using trapezium rule

       -aver_start real 0
        Start averaging the integral from here

       -[no]xydyno
        Interpret second data set as error in the y values for integrating

       -[no]regressionno
        Perform a linear regression analysis on the data

       -[no]luzarno
        Do a Luzar and Chandler analysis on a correlation function and related
       as  produced  by  g_hbond. When in addition the -xydy flag is given the
       second and fourth column will be interpreted  as  errors  in  c(t)  and
       n(t).

       -temp real 298.15
        Temperature for the Luzar hydrogen bonding kinetics analysis

       -fitstart real 1
        Time  (ps)  from  which  to start fitting the correlation functions in
       order to obtain the forward and backward rate constants for HB breaking
       and formation

       -smooth real -1
        If  =  0,  the  tail  of  the ACF will be smoothed by fitting it to an
       exponential function: y = A exp(-x/tau)

       -filter real 0
        Print the high-frequency fluctuation after  filtering  with  a  cosine
       filter of length

       -[no]powerno
        Fit data to: b ta

       -[no]subavyes
        Subtract the average before autocorrelating

       -[no]oneacfno
        Calculate one ACF over all sets

       -acflen int -1
        Length of the ACF, default is half the number of frames

       -[no]normalizeyes
        Normalize ACF

       -P enum 0
        Order of Legendre polynomial for ACF (0 indicates none):  0,  1,  2 or
       3

       -fitfn enum none
        Fit function:  none,  exp,  aexp,   exp_exp,   vac,   exp5,   exp7  or
       exp9

       -ncskip int 0
        Skip N points in the output file of correlation functions

       -beginfit real 0
        Time where to begin the exponential fit of the correlation function

       -endfit real -1
        Time  where to end the exponential fit of the correlation function, -1
       is till the end

SEE ALSO

       gromacs(7)

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

                                Thu 16 Oct 2008                   g_analyze(1)