forked from lijiext/lammps
196 lines
8.0 KiB
HTML
196 lines
8.0 KiB
HTML
<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 pimd command
|
|
</H3>
|
|
<P><B>Syntax:</B>
|
|
</P>
|
|
<PRE>fix ID group-ID pimd keyword value ...
|
|
</PRE>
|
|
<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command
|
|
|
|
<LI>pimd = style name of this fix command
|
|
|
|
<LI>zero or more keyword/value pairs may be appended
|
|
|
|
<LI>keyword = <I>method</I> or <I>fmass</I> or <I>sp</I> or <I>temp</I> or <I>nhc</I>
|
|
|
|
<PRE> <I>method</I> value = <I>pimd</I> or <I>nmpimd</I> or <I>cmd</I>
|
|
<I>fmass</I> value = scaling factor on mass
|
|
<I>sp</I> value = scaling factor on Planck constant
|
|
<I>temp</I> value = temperature (temperarate units)
|
|
<I>nhc</I> value = Nc = number of chains in Nose-Hoover thermostat
|
|
</PRE>
|
|
|
|
</UL>
|
|
<P><B>Examples:</B>
|
|
</P>
|
|
<PRE>fix 1 all pimd method nmpimd fmass 1.0 sp 2.0 temp 300.0 nhc 4
|
|
</PRE>
|
|
<P><B>Description:</B>
|
|
</P>
|
|
<P>This command performs quantum molecular dynamics simulations based on
|
|
the Feynman path integral to include effects of tunneling and
|
|
zero-point motion. In this formalism, the isomorphism of a quantum
|
|
partition function for the original system to a classical partition
|
|
function for a ring-polymer system is exploited, to efficiently sample
|
|
configurations from the canonical ensemble <A HREF = "#Feynman">(Feynman)</A>.
|
|
The classical partition function and its components are given
|
|
by the following equations:
|
|
</P>
|
|
<CENTER><IMG SRC = "Eqs/fix_pimd.jpg">
|
|
</CENTER>
|
|
<P>The interested user is referred to any of the numerous references on
|
|
this methodology, but briefly, each quantum particle in a path
|
|
integral simulation is represented by a ring-polymer of P quasi-beads,
|
|
labeled from 1 to P. During the simulation, each quasi-bead interacts
|
|
with beads on the other ring-polymers with the same imaginary time
|
|
index (the second term in the effective potential above). The
|
|
quasi-beads also interact with the two neighboring quasi-beads through
|
|
the spring potential in imaginary-time space (first term in effective
|
|
potential). To sample the canonical ensemble, a Nose-Hoover massive
|
|
chain thermostat is applied <A HREF = "#Tuckerman">(Tuckerman)</A>. With the
|
|
massive chain algorithm, a chain of NH thermostats is coupled to each
|
|
degree of freedom for each quasi-bead. The keyword <I>temp</I> sets the
|
|
target temperature for the system and the keyword <I>nhc</I> sets the
|
|
number <I>Nc</I> of thermostats in each chain. For example, for a
|
|
simulation of N particles with P beads in each ring-polymer, the total
|
|
number of NH thermostats would be 3 x N x P x Nc.
|
|
</P>
|
|
<P>IMPORTANT NOTE: This fix implements a complete velocity-verlet
|
|
integrator combined with NH massive chain thermostat, so no
|
|
other time integration fix should be used.
|
|
</P>
|
|
<P>The <I>method</I> keyword determines what style of PIMD is performed. A
|
|
value of <I>pimd</I> is standard PIMD. A value of <I>nmpimd</I> is for
|
|
normal-mode PIMD. A value of <I>cmd</I> is for centroid molecular dynamics
|
|
(CMD). The difference between the styles is as follows.
|
|
</P>
|
|
<P>In standard PIMD, the value used for a bead's fictitious mass is
|
|
arbitrary. A common choice is to use Mi = m/P, which results in the
|
|
mass of the entire ring-polymer being equal to the real quantum
|
|
particle. But it can be difficult to efficiently integrate the
|
|
equations of motion for the stiff harmonic interactions in the ring
|
|
polymers.
|
|
</P>
|
|
<P>A useful way to resolve this issue is to integrate the equations of
|
|
motion in a normal mode representation, using Normal Mode
|
|
Path-Integral Molecular Dynamics (NMPIMD) <A HREF = "#Cao1">(Cao1)</A>. In NMPIMD,
|
|
the NH chains are attached to each normal mode of the ring-polymer and
|
|
the fictitious mass of each mode is chosen as Mk = the eigenvalue of
|
|
the Kth normal mode for k > 0. The k = 0 mode, referred to as the
|
|
zero-frequency mode or centroid, corresponds to overall translation of
|
|
the ring-polymer and is assigned the mass of the real particle.
|
|
</P>
|
|
<P>Motion of the centroid can be effectively uncoupled from the other
|
|
normal modes by scaling the fictitious masses to achieve a partial
|
|
adiabatic separation. This is called a Centroid Molecular Dynamics
|
|
(CMD) approximation <A HREF = "#Cao2">(Cao2)</A>. The time-evolution (and resulting
|
|
dynamics) of the quantum particles can be used to obtain centroid time
|
|
correlation functions, which can be further used to obtain the true
|
|
quantum correlation function for the original system. The CMD method
|
|
also uses normal modes to evolve the system, except only the k > 0
|
|
modes are thermostatted, not the centroid degrees of freedom.
|
|
</P>
|
|
<P>The keyword <I>fmass</I> sets a further scaling factor for the fictitious
|
|
masses of beads, which can be used for the Partial Adiabatic CMD
|
|
<A HREF = "#Hone">(Hone)</A>, or to be set as P, which results in the fictitious
|
|
masses to be equal to the real particle masses.
|
|
</P>
|
|
<P>The keyword <I>sp</I> is a scaling factor on Planck's constant, which can
|
|
be useful for debugging or other purposes. The default value of 1.0
|
|
is appropriate for most situations.
|
|
</P>
|
|
<P>The PIMD algorithm in LAMMPS is implemented as a hyper-parallel scheme
|
|
as described in <A HREF = "#Calhoun">(Calhoun)</A>. In LAMMPS this is done by using
|
|
<A HREF = "Section_howto.html#howto_5">multi-replica feature</A> in LAMMPS, where
|
|
each quasi-particle system is stored and simulated on a separate
|
|
partition of processors. The following diagram illustrates this
|
|
approach. The original system with 2 ring polymers is shown in red.
|
|
Since each ring has 4 quasi-beads (imaginary time slices), there are 4
|
|
replicas of the system, each running on one of the 4 partitions of
|
|
processors. Each replica (shown in green) owns one quasi-bead in each
|
|
ring.
|
|
</P>
|
|
<CENTER><IMG SRC = "JPG/pimd.jpg">
|
|
</CENTER>
|
|
<P>To run a PIMD simulation with M quasi-beads in each ring polymer using
|
|
N MPI tasks for each partition's domain-decomposition, you would use P
|
|
= MxN processors (cores) and run the simulation as follows:
|
|
</P>
|
|
<PRE>mpirun -np P lmp_mpi -partition MxN -in script
|
|
</PRE>
|
|
<P>Note that in the LAMMPS input script for a multi-partition simulation,
|
|
it is often very useful to define a <A HREF = "variable.html">uloop-style
|
|
variable</A> such as
|
|
</P>
|
|
<PRE>variable ibead uloop M pad
|
|
</PRE>
|
|
<P>where M is the number of quasi-beads (partitions) used in the
|
|
calculation. The uloop variable can then be used to manage I/O
|
|
related tasks for each of the partitions, e.g.
|
|
</P>
|
|
<PRE>dump dcd all dcd 10 system_${ibead}.dcd
|
|
restart 1000 system_${ibead}.restart1 system_${ibead}.restart2
|
|
read_restart system_${ibead}.restart2
|
|
</PRE>
|
|
<P><B>Restrictions:</B>
|
|
</P>
|
|
<P>This fix is part of the USER-MISC package. It is only enabled if
|
|
LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
|
LAMMPS</A> section for more info.
|
|
</P>
|
|
<P>A PIMD simulation can be initialized with a single data file read via
|
|
the <A HREF = "read_data.html">read_data</A> command. However, this means all
|
|
quasi-beads in a ring polymer will have identical positions and
|
|
velocities, resulting in identical trajectories for all quasi-beads.
|
|
To avoid this, users can simply initialize velocities with different
|
|
random number seeds assigned to each partition, as defined by the
|
|
uloop variable, e.g.
|
|
</P>
|
|
<PRE>velocity all create 300.0 1234${ibead} rot yes dist gaussian
|
|
</PRE>
|
|
<P><B>Default:</B>
|
|
</P>
|
|
<P>The keyword defaults are method = pimd, fmass = 1.0, sp = 1.0, temp = 300.0,
|
|
and nhc = 2.
|
|
</P>
|
|
<HR>
|
|
|
|
<A NAME = "Feynman"></A>
|
|
|
|
<P><B>(Feynman)</B> R. Feynman and A. Hibbs, Chapter 7, Quantum Mechanics and
|
|
Path Integrals, McGraw-Hill, New York (1965).
|
|
</P>
|
|
<A NAME = "Tuckerman"></A>
|
|
|
|
<P><B>(Tuckerman)</B> M. Tuckerman and B. Berne, J Chem Phys, 99, 2796 (1993).
|
|
</P>
|
|
<A NAME = "Cao1"></A>
|
|
|
|
<P><B>(Cao1)</B> J. Cao and B. Berne, J Chem Phys, 99, 2902 (1993).
|
|
</P>
|
|
<A NAME = "Cao2"></A>
|
|
|
|
<P><B>(Cao2)</B> J. Cao and G. Voth, J Chem Phys, 100, 5093 (1994).
|
|
</P>
|
|
<A NAME = "Hone"></A>
|
|
|
|
<P><B>(Hone)</B> T. Hone, P. Rossky, G. Voth, J Chem Phys, 124,
|
|
154103 (2006).
|
|
</P>
|
|
<A NAME = "Calhoun"></A>
|
|
|
|
<P><B>(Calhoun)</B> A. Calhoun, M. Pavese, G. Voth, Chem Phys Letters, 262,
|
|
415 (1996).
|
|
</P>
|
|
</HTML>
|