1g_dielectric(1)           GROMACS suite, VERSION 4.5           g_dielectric(1)
2
3
4

NAME

6       g_dielectric - calculates frequency dependent dielectric constants
7
8       VERSION 4.5
9

SYNOPSIS

11       g_dielectric -f dipcorr.xvg -d deriv.xvg -o epsw.xvg -c cole.xvg -[no]h
12       -[no]version -nice int -b time  -e  time  -dt  time  -[no]w  -xvg  enum
13       -[no]fft  -[no]x1  -eint  real -bfit real -efit real -tail real -A real
14       -tau1 real -tau2 real  -eps0  real  -epsRF  real  -fix  int  -ffn  enum
15       -nsmooth int
16

DESCRIPTION

18       dielectric calculates frequency dependent dielectric constants from the
19       autocorrelation function of the total dipole moment in your simulation.
20       This  ACF  can be generated by g_dipoles.  For an estimate of the error
21       you can run g_statistics on the ACF, and use the output thus  generated
22       for this program.  The functional forms of the available functions are:
23
24
25       One  parameter   :  y = Exp[-a1 x], Two parameters : y = a2 Exp[-a1 x],
26       Three parameters: y = a2 Exp[-a1 x] + (1 - a2) Exp[-a3 x].  Start  val‐
27       ues for the fit procedure can be given on the command line.  It is also
28       possible to fix parameters at their start value, use -fix with the num‐
29       ber of the parameter you want to fix.
30
31
32       Three  output files are generated, the first contains the ACF, an expo‐
33       nential fit to it with 1, 2 or 3 parameters, and the numerical  deriva‐
34       tive  of  the  combination data/fit.  The second file contains the real
35       and imaginary parts of the frequency-dependent dielectric constant, the
36       last  gives  a plot known as the Cole-Cole plot, in which the imaginary
37       component is plotted as a function of the real component.  For  a  pure
38       exponential relaxation (Debye relaxation) the latter plot should be one
39       half of a circle.
40

FILES

42       -f dipcorr.xvg Input
43        xvgr/xmgr file
44
45       -d deriv.xvg Output
46        xvgr/xmgr file
47
48       -o epsw.xvg Output
49        xvgr/xmgr file
50
51       -c cole.xvg Output
52        xvgr/xmgr file
53
54

OTHER OPTIONS

56       -[no]hno
57        Print help info and quit
58
59       -[no]versionno
60        Print version info and quit
61
62       -nice int 19
63        Set the nicelevel
64
65       -b time 0
66        First frame (ps) to read from trajectory
67
68       -e time 0
69        Last frame (ps) to read from trajectory
70
71       -dt time 0
72        Only use frame when t MOD dt = first time (ps)
73
74       -[no]wno
75        View output xvg, xpm, eps and pdb files
76
77       -xvg enum xmgrace
78        xvg plot formatting:  xmgrace,  xmgr or  none
79
80       -[no]fftno
81        use fast fourier transform for correlation function
82
83       -[no]x1yes
84        use first column as X axis rather than first data set
85
86       -eint real 5
87        Time were to end the integration of the data and start to use the fit
88
89       -bfit real 5
90        Begin time of fit
91
92       -efit real 500
93        End time of fit
94
95       -tail real 500
96        Length of function including data and tail from fit
97
98       -A real 0.5
99        Start value for fit parameter A
100
101       -tau1 real 10
102        Start value for fit parameter tau1
103
104       -tau2 real 1
105        Start value for fit parameter tau2
106
107       -eps0 real 80
108        Epsilon 0 of your liquid
109
110       -epsRF real 78.5
111        Epsilon of the reaction field used in your simulation. A  value  of  0
112       means infinity.
113
114       -fix int 0
115        Fix parameters at their start values, A (2), tau1 (1), or tau2 (4)
116
117       -ffn enum none
118        Fit  function:   none,   exp,   aexp,   exp_exp,  vac,  exp5,  exp7 or
119       exp9
120
121       -nsmooth int 3
122        Number of points for smoothing
123
124

SEE ALSO

126       gromacs(7)
127
128       More  information  about  GROMACS  is  available  at   <http://www.gro
129       macs.org/>.
130
131
132
133                                Thu 26 Aug 2010                g_dielectric(1)
Impressum