File: fix_ti_rs.html

package info (click to toggle)
lammps 0~20140523.gite5e877d-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 193,012 kB
  • ctags: 48,147
  • sloc: cpp: 458,874; python: 21,769; fortran: 16,023; ansic: 12,503; perl: 3,687; sh: 3,221; makefile: 1,366; f90: 1,177; xml: 788; objc: 238; lisp: 169; tcl: 61; csh: 16; awk: 14
file content (156 lines) | stat: -rw-r--r-- 5,894 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
<HTML>
<CENTER><A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A> - <A HREF = "Manual.html">LAMMPS Documentation</A> - <A HREF = "Section_commands.html#comm">LAMMPS Commands</A> 
</CENTER>






<HR>

<H3>fix ti/rs command 
</H3>
<P><B>Syntax:</B>
</P>
<PRE>fix ID group-ID ti/rs lambda_initial lambda_final t_switch t_equil keyword value ... 
</PRE>
<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command 

<LI>ti/rs = style name of this fix command 

<LI>lambda_initial/lambda_final = initial/final values of the coupling parameter 

<LI>t_switch/t_equil = number of steps of the switching/equilibration procedure 

<LI>keyword = <I>function</I> 

<PRE>  <I>function</I> value = function-ID
    function-ID = ID of the switching function (1, 2 or 3) 
</PRE>

</UL>
<P><B>Example:</B>
</P>
<PRE>fix ref all ti/rs 50.0 2000 1000 
fix vf vacancy ti/rs 10.0 70000 50000 function 2 
</PRE>
<P><B>Description:</B>
</P>
<P>This fix allows you to compute the free energy temperature dependence
by performing a thermodynamic integration procedure known as
Reversible Scaling <A HREF = "#deKoning99">(de Koning99,</A> <A HREF = "#deKoning00a"">de
Koning00a)</A>. The thermodynamic integration is performed
using the nonequilibrium method of Adiabatic Switching
<A HREF = "#Watanabe">(Watanabe,</A> <A HREF = "#deKoning96">de Koning96)</A>.
</P>
<P>The forces on the atoms are dynamically scaled during the simulation,
the rescaling is done in the following manner:
</P>
<CENTER><IMG SRC = "Eqs/fix_ti_rs_force.jpg">
</CENTER>
<P>where F_int is the total force on the atoms due to the interatomic
potential and lambda is the coupling parameter of the thermodynamic
integration.
</P>
<P>The fix acts as follows: during the first <I>t_equil</I> steps after the
fix is defined the value of lambda is <I>lambda_initial</I> , this is the
period to equilibrate the system in the lambda = <I>lambda_initial</I>
state. After this the value of lambda changes continuously from
<I>lambda_initial</I> to <I>lambda_final</I> according to the function defined
using the keyword <I>function</I> (described below), this is done in
<I>t_switch</I> steps. Then comes the second equilibration period of
<I>t_equil</I> to equilibrate the system in the lambda = <I>lambda_final</I>
state. After that the switching back to the lambda = <I>lambda_initial</I>
state is done using <I>t_switch</I> timesteps and following the same
switching function. After this period the value of lambda is kept
equal to <I>lambda_initial</I> indefinitely or until a <A HREF = "unfix.html">unfix</A>
erase the fix.
</P>
<P>The description of thermodynamic integration in both directions is
done in <A HREF = "#deKoning00b">de Koning00b</A>, the main reason is to try to
eliminate the dissipated heat due to the nonequilibrium process.
</P>
<P>The <I>function</I> keyword allows the use of three different switching
rates. The option <I>1</I> results in a constant rescaling where the lambda
parameter changes at a constant rate during the switching time
according to the switching function
</P>
<CENTER><IMG SRC = "Eqs/fix_ti_rs_function_1.jpg">
</CENTER>
<P>where tau is the scaled time variable t/t_switch. This switching
function has the characteristic that the temperature scaling is faster
at temperatures closer to the final temperature of the procedure. The
option number <I>2</I> performs the switching at a rate defined by the
following switching function
</P>
<CENTER><IMG SRC = "Eqs/fix_ti_rs_function_2.jpg">
</CENTER>
<P>This switching function has the characteristic that the temperature
scaling occurs at a constant rate during all the procedure. The option
number <I>3</I> performs the switching at a rate defined by the following
switching function
</P>
<CENTER><IMG SRC = "Eqs/fix_ti_rs_function_3.jpg">
</CENTER>
<P>This switching function has the characteristic that the temperature
scaling is faster at temperatures closer to the initial temperature of
the procedure.
</P>
<P>An example script using this command is provided in the
examples/USER/misc/ti directory.
</P>
<P><B>Restart, fix_modify, output, run start/stop, minimize info:</B>
</P>
<P>No information about this fix is written to <A HREF = "restart.html">binary restart
files</A>.
</P>
<P>This fix computes a global vector quantitie which can be accessed by
various <A HREF = "Section_howto.html#howto_15">output commands</A>. The vector has
2 positions, the first one is the coupling parameter lambda and the
second one is the time derivative of lambda. The scalar and vector
values calculated by this fix are "extensive".
</P>
<P>No parameter of this fix can be used with the <I>start/stop</I> keywords of
the <A HREF = "run.html">run</A> command.
</P>
<P>The forces due to this fix are imposed during an energy minimization,
invoked by the <A HREF = "minimize.html">minimize</A> command.
</P>
<P><B>Related commands:</B>
</P>
<P><A HREF = "fix_ti_spring.html">fix ti/spring</A>
</P>
<P><B>Restrictions:</B>
</P>
<P>This command is part of the USER-MISC package.  It is only enabled if
LAMMPS was built with those packages.  See the <A HREF = "Section_start.html#start_3">Making
LAMMPS</A> section for more info.
</P>
<P><B>Default:</B>
</P>
<P>The keyword default is function = 1.
</P>
<HR>

<A NAME = "deKoning99"></A>

<P><B>(de Koning 99)</B> M. de Koning, A. Antonelli and S. Yip, Phys Rev Lett, 83, 3973 (1999).
</P>
<A NAME = "Watanabe"></A>

<P><B>(Watanabe)</B> M. Watanabe and W. P. Reinhardt, Phys Rev Lett, 65, 3301 (1990).
</P>
<A NAME = "deKoning96"></A>

<P><B>(de Koning 96)</B> M. de Koning and A. Antonelli, Phys Rev E, 53, 465 (1996).
</P>
<A NAME = "deKoning00a"></A>

<P><B>(de Koning 00a)</B> M. de Koning, A. Antonelli and S. Yip, J Chem Phys, 115, 11025 (2000).
</P>
<A NAME = "deKoning00b"></A>

<P><B>(de Koning 00b)</B> M. de Koning et al., Computing in Science & Engineering, 2, 88 (2000).
</P>
</HTML>