99 lines
3.6 KiB
HTML
99 lines
3.6 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 ipi command
|
||
</H3>
|
||
<P><B>Syntax:</B>
|
||
</P>
|
||
<PRE>fix ID group-ID ipi address port [unix]
|
||
</PRE>
|
||
<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command
|
||
<LI>ipi = style name of this fix command
|
||
<LI>address = internet address (FQDN or IP), or UNIX socket name
|
||
<LI>port = port number (ignored for UNIX sockets)
|
||
<LI>optional keyword = <I>unix</I>, if present uses a unix socket
|
||
</UL>
|
||
<P><B>Examples:</B>
|
||
</P>
|
||
<P>fix 1 all ipi my.server.com 12345
|
||
fix 1 all ipi mysocket 666 unix
|
||
</P>
|
||
<P><B>Description:</B>
|
||
</P>
|
||
<P>This fix enables LAMMPS to be run as a client for the i-PI Python
|
||
wrapper <A HREF = "#IPI">(IPI)</A> for performing a path integral molecular dynamics
|
||
(PIMD) simulation. The philosophy behind i-PI is described in the
|
||
following publication <A HREF = "#IPICPC">(IPI-CPC)</A>.
|
||
</P>
|
||
<P>A version of the i-PI package, containing only files needed for use
|
||
with LAMMPS, is provided in the tools/i-pi directory. See the
|
||
tools/i-pi/manual.pdf for an introduction to i-PI. The
|
||
examples/USER/i-pi directory contains example scripts for using i-PI
|
||
with LAMMPS.
|
||
</P>
|
||
<P>In brief, the path integral molecular dynamics is performed by the
|
||
Python wrapper, while the client (LAMMPS in this case) simply computes
|
||
forces and energy for each configuration. The communication between
|
||
the two components takes place using sockets, and is reduced to the
|
||
bare minimum. All the parameters of the dynamics are specified in the
|
||
input of i-PI, and all the parameters of the force field must be
|
||
specified as LAMMPS inputs, preceding the <I>fix ipi</I> command.
|
||
</P>
|
||
<P>The server address must be specified by the <I>address</I> argument, and
|
||
can be either the IP address, the fully-qualified name of the server,
|
||
or the name of a UNIX socket for local, faster communication. In the
|
||
case of internet sockets, the <I>port</I> argument specifies the port
|
||
number on which i-PI is listening, while the <I>unix</I> optional switch
|
||
specifies that the socket is a UNIX socket.
|
||
</P>
|
||
<P>Note that there is no check of data integrity, or that the atomic
|
||
configurations make sense. It is assumed that the species in the i-PI
|
||
input are listed in the same order as in the data file of LAMMPS. The
|
||
initial configuration is ignored, as it will be substituted with the
|
||
coordinates received from i-PI before forces are ever evaluated.
|
||
</P>
|
||
<P><B>Restart, fix_modify, output, run start/stop, minimize info:</B>
|
||
</P>
|
||
<P>There is no restart information associated with this fix, since all
|
||
the dynamical parameters are dealt with by i-PI.
|
||
</P>
|
||
<P><B>Restrictions:</B>
|
||
</P>
|
||
<P>Using this fix on anything other than all atoms requires particular
|
||
care, since i-PI will know nothing on atoms that are not those whose
|
||
coordinates are transferred. However, one could use this strategy to
|
||
define an external potential acting on the atoms that are moved by
|
||
i-PI.
|
||
</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. Because of
|
||
the use of UNIX domain sockets, this fix will only work in a UNIX
|
||
environment.
|
||
</P>
|
||
<P><B>Related commands:</B>
|
||
</P>
|
||
<P><A HREF = "fix_nve.html">fix nve</A>
|
||
</P>
|
||
<HR>
|
||
|
||
<A NAME = "IPICPC"></A>
|
||
|
||
<P><B>(IPI-CPC)</B> Ceriotti, More and Manolopoulos,
|
||
Comp. Phys. Comm., 185, 1019–1026 (2014)
|
||
</P>
|
||
<A NAME = "IPI"></A>
|
||
|
||
<P><B>(IPI)</B>
|
||
<A HREF = "http://epfl-cosmo.github.io/gle4md/index.html?page=ipi">http://epfl-cosmo.github.io/gle4md/index.html?page=ipi</A>
|
||
</P>
|
||
</HTML>
|