forked from lijiext/lammps
253 lines
10 KiB
HTML
253 lines
10 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>pair_style reax/c command
|
||
|
|
</H3>
|
||
|
|
<P><B>Syntax:</B>
|
||
|
|
</P>
|
||
|
|
<PRE>pair_style reax/c cfile
|
||
|
|
</PRE>
|
||
|
|
<UL><LI>cfile = NULL or name of a control file
|
||
|
|
</UL>
|
||
|
|
<P><B>Examples:</B>
|
||
|
|
</P>
|
||
|
|
<PRE>pair_style reax/c NULL
|
||
|
|
pair_style reax/c controlfile
|
||
|
|
pair_coeff * * ffield.reax 1 2 2 3
|
||
|
|
</PRE>
|
||
|
|
<P><B>Description:</B>
|
||
|
|
</P>
|
||
|
|
<P>Style <I>reax/c</I> computes the ReaxFF potential of van Duin, Goddard and
|
||
|
|
co-workers. ReaxFF uses distance-dependent bond-order functions to
|
||
|
|
represent the contributions of chemical bonding to the potential
|
||
|
|
energy. There is more than one version of ReaxFF. The version
|
||
|
|
implemented in LAMMPS uses the functional forms documented in the
|
||
|
|
supplemental information of the following paper: <A HREF = "#Chenoweth_2008">(Chenoweth et al.,
|
||
|
|
2008)</A>. The version integrated into LAMMPS matches
|
||
|
|
the most up-to-date version of ReaxFF as of summer 2010.
|
||
|
|
</P>
|
||
|
|
<P>The <I>reax/c</I> style differs from the <A HREF = "pair_reax.html">pair_style reax</A>
|
||
|
|
command in the lo-level implementation details. The <I>reax</I> style is a
|
||
|
|
Fortran library, linked to LAMMPS. The <I>reax/c</I> style was initially
|
||
|
|
implemented as stand-alone C code and is now integrated into LAMMPS as
|
||
|
|
a package.
|
||
|
|
</P>
|
||
|
|
<P>The version integrated into LAMMPS matches the most up-to-date version
|
||
|
|
of ReaxFF as of summer 2010. The parameter files supplied in the
|
||
|
|
potentials directory use parameters from the following publications:
|
||
|
|
</P>
|
||
|
|
<UL><LI>ffield.CHO: <A HREF = "#Chenoweth">(Chenoweth)</A>
|
||
|
|
<LI>ffield.NiCH: <A HREF = "#Mueller">(Mueller)</A>
|
||
|
|
<LI>ffield.RDX: <A HREF = "#Zhang">(Zhang)</A>
|
||
|
|
<LI>ffield.NaH: <A HREF = "#Ojwang">(Ojwang)</A>
|
||
|
|
<LI>ffield.CuOH: ???
|
||
|
|
</UL>
|
||
|
|
<P>The format of these files is identical to that used originally by van
|
||
|
|
Duin. We have tested the accuracy of <I>pair_style reax/c</I> potential
|
||
|
|
against the original ReaxFF code for the systems mentioned above. You
|
||
|
|
can use other ffield files for specific chemical systems that may be
|
||
|
|
available elsewhere (but note that their accuracy may not have been
|
||
|
|
tested).
|
||
|
|
</P>
|
||
|
|
<P>The <I>cfile</I> setting can be specified as NULL, in which case default
|
||
|
|
settings are used. Or a control file can be specified which contains
|
||
|
|
cutoff values for the ReaxFF potential in addition to some performance
|
||
|
|
and output controls. Each line in the control specifies the value for
|
||
|
|
a control variable. The format of the control file is described
|
||
|
|
below. See examples of such files in the examples/USER/reax
|
||
|
|
sub-directories.
|
||
|
|
</P>
|
||
|
|
<P>Use of this pair style requires that a charge be defined for every
|
||
|
|
atom. See the <A HREF = "atom_style.html">atom_style</A> and
|
||
|
|
<A HREF = "read_data.html">read_data</A> commands for details on how to specify
|
||
|
|
charges.
|
||
|
|
</P>
|
||
|
|
<P>The ReaxFF parameter files provided were created using a charge
|
||
|
|
equilibration (QEq) model for handling the electrostatic interactions.
|
||
|
|
Therefore it is highly recommended that the <A HREF = "fix_qeq_reax.html">fix
|
||
|
|
qeq/reax</A> command be used with pair style <I>reax/c</I>
|
||
|
|
when simulating a ReaxFF model, to equilibrate charge each timestep.
|
||
|
|
See the <A HREF = "fix_qeq.html">fix_qeq</A> command for details.
|
||
|
|
</P>
|
||
|
|
<P>However, performing charge equilibration is not a prerequisite for
|
||
|
|
performing a ReaxFF simulation. In this case, the static charges you
|
||
|
|
assign to each atom will be used for computing the electrostatic
|
||
|
|
interactions in the system.
|
||
|
|
</P>
|
||
|
|
<P>The thermo variable <I>evdwl</I> stores the sum of all the ReaxFF potential
|
||
|
|
energy contributions, with the exception of the Coulombic and charge
|
||
|
|
equilibration contributions which are stored in the thermo variable
|
||
|
|
<I>ecoul</I>. The output of these quantities is controlled by the
|
||
|
|
<A HREF = "thermo.html">thermo</A> command.
|
||
|
|
</P>
|
||
|
|
<P>Only a single pair_coeff command is used with the <I>reax</I> style which
|
||
|
|
specifies a ReaxFF potential file with parameters for all needed
|
||
|
|
elements. These are mapped to LAMMPS atom types by specifying N
|
||
|
|
additional arguments after the filename in the pair_coeff command,
|
||
|
|
where N is the number of LAMMPS atom types:
|
||
|
|
</P>
|
||
|
|
<UL><LI>filename
|
||
|
|
<LI>N indices = mapping of ReaxFF elements to atom types
|
||
|
|
</UL>
|
||
|
|
<P>The filename is the ReaxFF potential file. Unlike for the <I>reax</I>
|
||
|
|
pair style, any filename can be used.
|
||
|
|
</P>
|
||
|
|
<P>In the ReaxFF potential file, near the top, after the general
|
||
|
|
parameters, is the atomic parameters section that contains element
|
||
|
|
names, each with a couple dozen numeric parameters. If there are M
|
||
|
|
elements specified in the <I>ffield</I> file, think of these as numbered 1
|
||
|
|
to M. Each of the N indices you specify for the N atom types of LAMMPS
|
||
|
|
atoms must be an integer from 1 to M. Atoms with LAMMPS type 1 will
|
||
|
|
be mapped to whatever element you specify as the first index value,
|
||
|
|
etc. If a mapping value is specified as NULL, the mapping is not
|
||
|
|
performed. This can be used when the <I>reax/c</I> style is used as part
|
||
|
|
of the <I>hybrid</I> pair style. The NULL values are placeholders for atom
|
||
|
|
types that will be used with other potentials.
|
||
|
|
</P>
|
||
|
|
<P>As an example, say your LAMMPS simulation has 4 atom types and the
|
||
|
|
elements are ordered as C, H, O, N in the <I>ffield</I> file. If you want
|
||
|
|
the LAMMPS atom type 1 and 2 to be C, type 3 to be N, and type 4 to be
|
||
|
|
H, you would use the following pair_coeff command:
|
||
|
|
</P>
|
||
|
|
<PRE>pair_coeff * * ffield.reax 1 1 4 2
|
||
|
|
</PRE>
|
||
|
|
<HR>
|
||
|
|
|
||
|
|
<P>The format of a line in the control file is as follows:
|
||
|
|
</P>
|
||
|
|
<PRE>variable_name value
|
||
|
|
</PRE>
|
||
|
|
<P>and it may be followed by an "!" character and a trailing comment.
|
||
|
|
</P>
|
||
|
|
<P>If the value of a control variable is not specified, then default
|
||
|
|
values are used. What follows is the list of variables along with a
|
||
|
|
brief description of their use and default values.
|
||
|
|
</P>
|
||
|
|
<P>simulation_name: Output files produced by <I>pair_style reax/c</I> carry
|
||
|
|
this name + extensions specific to their contents. Partial energies
|
||
|
|
are reported with a ".pot" extension, while the trajectory file has
|
||
|
|
".trj" extension.
|
||
|
|
</P>
|
||
|
|
<P>tabulate_long_range: To improve performance, long range interactions
|
||
|
|
can optionally be tabulated (0 means no tabulation). Value of this
|
||
|
|
variable denotes the size of the long range interaction table. The
|
||
|
|
range from 0 to long range cutoff (defined in the <I>ffield</I> file) is
|
||
|
|
divided into <I>tabulate_long_range</I> points. Then at the start of
|
||
|
|
simulation, we fill in the entries of the long range interaction table
|
||
|
|
by computing the energies and forces resulting from van der Waals and
|
||
|
|
Coulomb interactions between every possible atom type pairs present in
|
||
|
|
the input system. During the simulation we consult to the long range
|
||
|
|
interaction table to estimate the energy and forces between a pair of
|
||
|
|
atoms. Linear interpolation is used for estimation. (default value =
|
||
|
|
0)
|
||
|
|
</P>
|
||
|
|
<P>energy_update_freq: Denotes the frequency (in number of steps) of
|
||
|
|
writes into the partial energies file. (default value = 0)
|
||
|
|
</P>
|
||
|
|
<P>nbrhood_cutoff: Denotes the near neighbors cutoff (in Angstroms)
|
||
|
|
regarding the bonded interactions. (default value = 4)
|
||
|
|
</P>
|
||
|
|
<P>hbond_cutoff: Denotes the cutoff distance (in Angstroms) for hydrogen
|
||
|
|
bond interactions.(default value = 0 - means no hydrogen bonds are
|
||
|
|
present)
|
||
|
|
</P>
|
||
|
|
<P>bond_graph_cutoff: is the threshold used in determining what is a
|
||
|
|
physical bond, what is not. Bonds and angles reported in the
|
||
|
|
trajectory file rely on this cutoff. (default value = 0.3)
|
||
|
|
</P>
|
||
|
|
<P>thb_cutoff: cutoff value for the strength of bonds to be considered in
|
||
|
|
three body interactions. (default value = 0.001)
|
||
|
|
</P>
|
||
|
|
<P>write_freq: Frequency of writes into the trajectory file. (default
|
||
|
|
value = 0)
|
||
|
|
</P>
|
||
|
|
<P>traj_title: Title of the trajectory - not the name of the trajectory
|
||
|
|
file.
|
||
|
|
</P>
|
||
|
|
<P>atom_info: 1 means print only atomic positions + charge (default = 0)
|
||
|
|
</P>
|
||
|
|
<P>atom_forces: 1 adds net forces to atom lines in the trajectory file
|
||
|
|
(default = 0)
|
||
|
|
</P>
|
||
|
|
<P>atom_velocities: 1 adds atomic velocities to atoms line (default = 0)
|
||
|
|
</P>
|
||
|
|
<P>bond_info: 1 prints bonds in the trajectory file (default = 0)
|
||
|
|
</P>
|
||
|
|
<P>angle_info: 1 prints angles in the trajectory file (default = 0)
|
||
|
|
</P>
|
||
|
|
<HR>
|
||
|
|
|
||
|
|
<P><B>Mixing, shift, table, tail correction, restart, rRESPA info</B>:
|
||
|
|
</P>
|
||
|
|
<P>This pair style does not support the <A HREF = "pair_modify.html">pair_modify</A>
|
||
|
|
mix, shift, table, and tail options.
|
||
|
|
</P>
|
||
|
|
<P>This pair style does not write its information to <A HREF = "restart.html">binary restart
|
||
|
|
files</A>, since it is stored in potential files. Thus, you
|
||
|
|
need to re-specify the pair_style and pair_coeff commands in an input
|
||
|
|
script that reads a restart file.
|
||
|
|
</P>
|
||
|
|
<P>This pair style can only be used via the <I>pair</I> keyword of the
|
||
|
|
<A HREF = "run_style.html">run_style respa</A> command. It does not support the
|
||
|
|
<I>inner</I>, <I>middle</I>, <I>outer</I> keywords.
|
||
|
|
</P>
|
||
|
|
<P><B>Restrictions:</B>
|
||
|
|
</P>
|
||
|
|
<P>This pair style is part of the "user-reaxc" package. It is only
|
||
|
|
enabled if LAMMPS was built with that package. See the <A HREF = "Section_start.html#2_3">Making
|
||
|
|
LAMMPS</A> section for more info.
|
||
|
|
</P>
|
||
|
|
<P>The ReaxFF potential files provided with LAMMPS in the potentials
|
||
|
|
directory are parameterized for real <A HREF = "units.html">units</A>. You can use
|
||
|
|
the ReaxFF potential with any LAMMPS units, but you would need to
|
||
|
|
create your own potential file with coefficients listed in the
|
||
|
|
appropriate units if your simulation doesn't use "real" units.
|
||
|
|
</P>
|
||
|
|
<P><B>Related commands:</B>
|
||
|
|
</P>
|
||
|
|
<P><A HREF = "pair_coeff.html">pair_coeff</A>, <A HREF = "fix_qeq_reax.html">fix_qeq_reax</A>,
|
||
|
|
<A HREF = "pair_reax.html">pair_style reax</A>
|
||
|
|
</P>
|
||
|
|
<P><B>Default:</B> none
|
||
|
|
</P>
|
||
|
|
<HR>
|
||
|
|
|
||
|
|
<A NAME = "Chenoweth"></A>
|
||
|
|
|
||
|
|
<P><B>(Chenoweth)</B> Chenoweth, van Duin, and Goddard,
|
||
|
|
Journal of Physical Chemistry A, 112, 1040-1053 (2008).
|
||
|
|
</P>
|
||
|
|
<A NAME = "Mueller"></A>
|
||
|
|
|
||
|
|
<P><B>(Mueller)</B> Mueller, van Duin, and Goddard,
|
||
|
|
submitted for publication in Journal of Physical Chemistry A.
|
||
|
|
</P>
|
||
|
|
<A NAME = "Zhang"></A>
|
||
|
|
|
||
|
|
<P><B>(Zhang)</B> Zhang, van Duin, Zybin, and Goddard,
|
||
|
|
Journal of Physical Chemistry A 113, 10770-10778 (2009).
|
||
|
|
</P>
|
||
|
|
<P>Zhang, van Duin, Kober, Zybin, and Goddard,
|
||
|
|
"HMX/TATB carbon cluster formation",
|
||
|
|
accepted for publication in Journal of Physical Chemistry A.
|
||
|
|
</P>
|
||
|
|
<P>Zhang, van Duin, Zybin, and Goddard,
|
||
|
|
"Sensitivity test for RDX, HMX using fast compression",
|
||
|
|
submitted for publication to Journal of Physical Chemistry A.
|
||
|
|
</P>
|
||
|
|
<A NAME = "Ojwang"></A>
|
||
|
|
|
||
|
|
<P><B>(Ojwang)</B> Ojwang, van Santen, Kramer, van Duin, and Goddard,
|
||
|
|
"Modeling the sorption dynamics of NaH using a reactive force field",
|
||
|
|
Journal of Chemical Physics 128, 164714 (2008).
|
||
|
|
</P>
|
||
|
|
</HTML>
|