From be3847ff317e646d81f7d2d4668ae8c011eb41b4 Mon Sep 17 00:00:00 2001 From: sjplimp Date: Thu, 25 Jul 2013 22:03:32 +0000 Subject: [PATCH] git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@10363 f3b2605a-c512-4ea7-a41b-209d697bcdaa --- doc/Eqs/fix_gld1.jpg | Bin 0 -> 14274 bytes doc/Eqs/fix_gld1.tex | 13 ++++ doc/fix_gld.html | 161 +++++++++++++++++++++++++++++++++++++++++++ doc/fix_gld.txt | 145 ++++++++++++++++++++++++++++++++++++++ 4 files changed, 319 insertions(+) create mode 100644 doc/Eqs/fix_gld1.jpg create mode 100644 doc/Eqs/fix_gld1.tex create mode 100644 doc/fix_gld.html create mode 100644 doc/fix_gld.txt diff --git a/doc/Eqs/fix_gld1.jpg b/doc/Eqs/fix_gld1.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d54ce57a6c5398542f4e3a68cf0b89e039c5ecda GIT binary patch literal 14274 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 literal 0 HcmV?d00001 diff --git a/doc/Eqs/fix_gld1.tex b/doc/Eqs/fix_gld1.tex new file mode 100644 index 0000000000..baa0f32a5b --- /dev/null +++ b/doc/Eqs/fix_gld1.tex @@ -0,0 +1,13 @@ +\documentclass[12pt]{article} + +\usepackage{amsmath} + +\begin{document} + +\begin{align*} + &{\bf F}_{j}(t) = {\bf F}^C_j(t)-\int \limits_{0}^{t} \Gamma_j(t-s) {\bf v}_j(s)~\text{d}s + {\bf F}^R_j(t) \\ + &\Gamma_j(t-s) = \sum \limits_{k=1}^{N_k} \frac{c_k}{\tau_k} e^{-(t-s)/\tau_k} \\ + &\langle{\bf F}^R_j(t),{\bf F}^R_j(s)\rangle = \text{k$_\text{B}$T} ~\Gamma_j(t-s) +\end{align*} + +\end{document} diff --git a/doc/fix_gld.html b/doc/fix_gld.html new file mode 100644 index 0000000000..c7567078e6 --- /dev/null +++ b/doc/fix_gld.html @@ -0,0 +1,161 @@ + +
LAMMPS WWW Site - LAMMPS Documentation - LAMMPS Commands +
+ + + + + + +
+ +

fix gld command +

+

Syntax: +

+
fix ID group-ID gld Tstart Tstop N_k seed series c_1 tau_1 ... c_N_k tau_N_k keyword values ... 
+
+
  • ID, group-ID are documented in fix command + +
  • gld = style name of this fix command + +
  • Tstart,Tstop = desired temperature at start/end of run (temperature units) + +
  • N_k = number of terms in the Prony series representation of the memory kernel +seed = random number seed to use for white noise (positive integer) + +
  • series = pprony is presently the only available option + +
  • c_k = the weight of the kth term in the Prony series (mass per time units) + +
  • tau_k = the time constant of the kth term in the Prony series (time units) + +
  • zero or more keyword/value pairs may be appended + +
    keyword = frozen or zero
    +  frozen value = no or yes
    +    no = initialize extended variables using values drawn from equilibrium distribution at Tstart
    +    yes = initialize extended variables to zero (i.e., from equilibrium distribution at zero temperature) 
    +
    +
      zero value = no or yes
    +    no = do not set total random force to zero
    +    yes = set total random force to zero 
    +
    + +
+

Examples: +

+
fix 1 all gld 1.0 1.0 2 82885 pprony 0.5 1.0 1.0 2.0 frozen yes zero yes
+fix 3 rouse gld 7.355 7.355 4 48823 pprony 107.1 0.02415 186.0 0.04294 428.6 0.09661 1714 0.38643 
+
+

Description: +

+

Applies Generalized Langevin Dynamics to a group of atoms, as +described in (Baczewski). This is intended to model the +effect of an implicit solvent with a temporally non-local dissipative +force and a colored Gaussian random force, consistent with the +Fluctuation-Dissipation Theorem. The functional form of the memory +kernel associated with the temporally non-local force is constrained +to be a Prony series. +

+

With this fix active, the force on the jth atom is given as +

+
+
+

Here, the first term is representative of all conservative (pairwise, +bonded, etc) forces external to this fix, the second is the temporally +non-local dissipative force given as a Prony series, and the third is +the colored Gaussian random force. +

+

The Prony series form of the memory kernel is chosen to enable an +extended variable formalism, with a number of exemplary mathematical +features discussed in (Baczewski). In particular, 3N_k +extended variables are added to each atom, which effect the action of +the memory kernel without having to explicitly evaluate the integral +over time in the second term of the force. This also has the benefit +of requiring the generation of uncorrelated random forces, rather than +correlated random forces as specified in the third term of the force. +

+

Presently, the Prony series coefficients are limited to being greater +than or equal to zero, and the time constants are limited to being +greater than zero. To this end, the value of series MUST be set to +pprony, for now. Future updates will allow for negative coefficients +and other representations of the memory kernel. It is with these +updates in mind that the series option was included. +

+

The units of the Prony series coefficients are chosen to be mass per +time to ensure that the numerical integration scheme stably approaches +the Newtonian and Langevin limits. Details of these limits, and the +associated numerical concerns are discussed in +(Baczewski). +

+

While this fix bears many similarities to fix +langevin, it has one significant +difference. Namely, fix gld performs time integration, +whereas fix langevin does NOT. To this end, the +specification of another fix to perform time integration, such as fix +nve, is NOT necessary. +

+

The desired temperature at each timestep is ramped from Tstart to +Tstop over the course of the next run. +

+

The random # seed must be a positive integer. A Marsaglia random +number generator is used. Each processor uses the input seed to +generate its own unique seed and its own stream of random +numbers. Thus the dynamics of the system will not be identical on two +runs on different numbers of processors. +

+
+ +

The keyword/value option pairs are used in the following ways. +

+

The keyword frozen can be used to specify how the extended variables +associated with the GLD memory kernel are initialized. Specifying no +(the default), the initial values are drawn at random from an +equilibrium distribution at Tstart, consistent with the +Fluctuation-Dissipation Theorem. Specifying yes, initializes the +extended variables to zero. +

+

The keyword zero can be used to eliminate drift due to the +thermostat. Because the random forces on different atoms are +independent, they do not sum exactly to zero. As a result, this fix +applies a small random force to the entire system, and the +center-of-mass of the system undergoes a slow random walk. If the +keyword zero is set to yes, the total random force is set exactly +to zero by subtracting off an equal part of it from each atom in the +group. As a result, the center-of-mass of a system with zero initial +momentum will not drift over time. +

+

Restart, run start/stop, minimize info: +

+

The instantaneous values of the extended variables are written to +binary restart files. Because the state of the random +number generator is not saved in restart files, this means you cannot +do "exact" restarts with this fix, where the simulation continues on +the same as if no restart had taken place. However, in a statistical +sense, a restarted simulation should produce the same behavior. +

+

This fix can ramp its target temperature over multiple runs, using the +start and stop keywords of the run command. See the +run command for details of how to do this. +

+

This fix is not invoked during energy minimization. +

+

Restrictions: none +

+

Related commands: +

+

fix langevin, fix viscous, +pair_style dpd/tstat +

+

Default: +

+

The option defaults are frozen = no, zero = no. +

+
+ + + +

(Baczewski) A.D. Baczewski and S.D. Bond, J. Chem. Phys. 139, 044107 (2013). +

+ diff --git a/doc/fix_gld.txt b/doc/fix_gld.txt new file mode 100644 index 0000000000..965652a6c4 --- /dev/null +++ b/doc/fix_gld.txt @@ -0,0 +1,145 @@ +"LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c + +:link(lws,http://lammps.sandia.gov) +:link(ld,Manual.html) +:link(lc,Section_commands.html#comm) + +:line + +fix gld command :h3 + +[Syntax:] + +fix ID group-ID gld Tstart Tstop N_k seed series c_1 tau_1 ... c_N_k tau_N_k keyword values ... :pre + +ID, group-ID are documented in "fix"_fix.html command :ulb,l +gld = style name of this fix command :l +Tstart,Tstop = desired temperature at start/end of run (temperature units) :l +N_k = number of terms in the Prony series representation of the memory kernel +seed = random number seed to use for white noise (positive integer) :l +series = {pprony} is presently the only available option :l +c_k = the weight of the kth term in the Prony series (mass per time units) :l +tau_k = the time constant of the kth term in the Prony series (time units) :l +zero or more keyword/value pairs may be appended :l +keyword = {frozen} or {zero} + {frozen} value = {no} or {yes} + {no} = initialize extended variables using values drawn from equilibrium distribution at Tstart + {yes} = initialize extended variables to zero (i.e., from equilibrium distribution at zero temperature) :pre + {zero} value = {no} or {yes} + {no} = do not set total random force to zero + {yes} = set total random force to zero :pre +:ule + +[Examples:] + +fix 1 all gld 1.0 1.0 2 82885 pprony 0.5 1.0 1.0 2.0 frozen yes zero yes +fix 3 rouse gld 7.355 7.355 4 48823 pprony 107.1 0.02415 186.0 0.04294 428.6 0.09661 1714 0.38643 :pre + +[Description:] + +Applies Generalized Langevin Dynamics to a group of atoms, as +described in "(Baczewski)"_#Baczewski. This is intended to model the +effect of an implicit solvent with a temporally non-local dissipative +force and a colored Gaussian random force, consistent with the +Fluctuation-Dissipation Theorem. The functional form of the memory +kernel associated with the temporally non-local force is constrained +to be a Prony series. + +With this fix active, the force on the {j}th atom is given as + +:c,image(Eqs/fix_gld1.jpg) + +Here, the first term is representative of all conservative (pairwise, +bonded, etc) forces external to this fix, the second is the temporally +non-local dissipative force given as a Prony series, and the third is +the colored Gaussian random force. + +The Prony series form of the memory kernel is chosen to enable an +extended variable formalism, with a number of exemplary mathematical +features discussed in "(Baczewski)"_#Baczewski. In particular, 3N_k +extended variables are added to each atom, which effect the action of +the memory kernel without having to explicitly evaluate the integral +over time in the second term of the force. This also has the benefit +of requiring the generation of uncorrelated random forces, rather than +correlated random forces as specified in the third term of the force. + +Presently, the Prony series coefficients are limited to being greater +than or equal to zero, and the time constants are limited to being +greater than zero. To this end, the value of series MUST be set to +{pprony}, for now. Future updates will allow for negative coefficients +and other representations of the memory kernel. It is with these +updates in mind that the series option was included. + +The units of the Prony series coefficients are chosen to be mass per +time to ensure that the numerical integration scheme stably approaches +the Newtonian and Langevin limits. Details of these limits, and the +associated numerical concerns are discussed in +"(Baczewski)"_#Baczewski. + +While this fix bears many similarities to "fix +langevin"_fix_langevin.html, it has one significant +difference. Namely, "fix gld"_fix_gld.html performs time integration, +whereas "fix langevin"_fix_langevin.html does NOT. To this end, the +specification of another fix to perform time integration, such as "fix +nve"_fix_nve.html, is NOT necessary. + +The desired temperature at each timestep is ramped from {Tstart} to +{Tstop} over the course of the next run. + +The random # {seed} must be a positive integer. A Marsaglia random +number generator is used. Each processor uses the input seed to +generate its own unique seed and its own stream of random +numbers. Thus the dynamics of the system will not be identical on two +runs on different numbers of processors. + +:line + +The keyword/value option pairs are used in the following ways. + +The keyword {frozen} can be used to specify how the extended variables +associated with the GLD memory kernel are initialized. Specifying no +(the default), the initial values are drawn at random from an +equilibrium distribution at {Tstart}, consistent with the +Fluctuation-Dissipation Theorem. Specifying yes, initializes the +extended variables to zero. + +The keyword {zero} can be used to eliminate drift due to the +thermostat. Because the random forces on different atoms are +independent, they do not sum exactly to zero. As a result, this fix +applies a small random force to the entire system, and the +center-of-mass of the system undergoes a slow random walk. If the +keyword {zero} is set to {yes}, the total random force is set exactly +to zero by subtracting off an equal part of it from each atom in the +group. As a result, the center-of-mass of a system with zero initial +momentum will not drift over time. + +[Restart, run start/stop, minimize info:] + +The instantaneous values of the extended variables are written to +"binary restart files"_restart.html. Because the state of the random +number generator is not saved in restart files, this means you cannot +do "exact" restarts with this fix, where the simulation continues on +the same as if no restart had taken place. However, in a statistical +sense, a restarted simulation should produce the same behavior. + +This fix can ramp its target temperature over multiple runs, using the +{start} and {stop} keywords of the "run"_run.html command. See the +"run"_run.html command for details of how to do this. + +This fix is not invoked during "energy minimization"_minimize.html. + +[Restrictions:] none + +[Related commands:] + +"fix langevin"_fix_langevin.html, "fix viscous"_fix_viscous.html, +"pair_style dpd/tstat"_pair_dpd.html + +[Default:] + +The option defaults are frozen = no, zero = no. + +:line + +:link(Baczewski) +[(Baczewski)] A.D. Baczewski and S.D. Bond, J. Chem. Phys. 139, 044107 (2013).