git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@9788 f3b2605a-c512-4ea7-a41b-209d697bcdaa

This commit is contained in:
sjplimp 2013-04-23 20:53:50 +00:00
parent 8492c4149e
commit d7aa786175
4 changed files with 161 additions and 29 deletions

View File

@ -195,7 +195,7 @@ are point particles. See the discussion of ellipsoidflag and the
</P>
<UL><LI><I>Atoms, Velocities, Masses, Ellipsoids, Lines, Triangles, Bodies</I> = atom-property sections
<LI><I>Bonds, Angles, Dihedrals, Impropers</I> = molecular topology sections
<LI><I>Pair Coeffs, Bond Coeffs, Angle Coeffs, Dihedral Coeffs, Improper Coeffs</I> = force field sections
<LI><I>Pair Coeffs, PairIJ Coeffs, Bond Coeffs, Angle Coeffs, Dihedral Coeffs, Improper Coeffs</I> = force field sections
<LI><I>BondBond Coeffs, BondAngle Coeffs, MiddleBondTorsion Coeffs, EndBondTorsion Coeffs, AngleTorsion Coeffs, AngleAngleTorsion Coeffs, BondBond13 Coeffs, AngleAngle Coeffs</I> = class 2 force field sections
</UL>
<P>Each section is listed below in alphabetic order. The format of each
@ -814,8 +814,42 @@ e.g. <A HREF = "atom_style.html">atom_style sphere</A>.
</UL>
<P>The number and meaning of the coefficients are specific to the defined
pair style. See the <A HREF = "pair_style.html">pair_style</A> and
<A HREF = "pair_coeff.html">pair_coeff</A> commands for details. Coefficients can
also be set via the <A HREF = "pair_coeff.html">pair_coeff</A> command in the input
<A HREF = "pair_coeff.html">pair_coeff</A> commands for details. Since pair
coefficients for types I != J are not specified, these will be
generated automatically by the pair style's mixing rule. See the
individual pair_style doc pages and the <A HREF = "pair_modify.html">pair_modify
mix</A> command for details. Pair coefficients can also
be set via the <A HREF = "pair_coeff.html">pair_coeff</A> command in the input
script.
</P>
<HR>
<P><I>PairIJ Coeffs</I> section:
</P>
<UL><LI>one line per pair of atom types for all I,J with I <= J
<LI>line syntax: ID1 ID2 coeffs
<PRE> ID1 = atom type I = 1-N
ID2 = atom type J = I-N, with I <= J
coeffs = list of coeffs
</PRE>
<LI>examples:
<PRE> 3 3 0.022 2.35197 0.022 2.35197
3 5 0.022 2.35197 0.022 2.35197
</PRE>
</UL>
<P>This section must have N*(N+1)/2 lines where N = # of atom types. The
number and meaning of the coefficients are specific to the defined
pair style. See the <A HREF = "pair_style.html">pair_style</A> and
<A HREF = "pair_coeff.html">pair_coeff</A> commands for details. Since pair
coefficients for types I != J are all specified, these values will
turn off the default mixing rule defined by the pair style. See the
individual pair_style doc pages and the <A HREF = "pair_modify.html">pair_modify
mix</A> command for details. Pair coefficients can also
be set via the <A HREF = "pair_coeff.html">pair_coeff</A> command in the input
script.
</P>
<HR>

View File

@ -189,7 +189,7 @@ These are the section keywords for the body of the file.
{Atoms, Velocities, Masses, Ellipsoids, Lines, Triangles, Bodies} = atom-property sections
{Bonds, Angles, Dihedrals, Impropers} = molecular topology sections
{Pair Coeffs, Bond Coeffs, Angle Coeffs, Dihedral Coeffs, \
{Pair Coeffs, PairIJ Coeffs, Bond Coeffs, Angle Coeffs, Dihedral Coeffs, \
Improper Coeffs} = force field sections
{BondBond Coeffs, BondAngle Coeffs, MiddleBondTorsion Coeffs, \
EndBondTorsion Coeffs, AngleTorsion Coeffs, AngleAngleTorsion Coeffs, \
@ -716,8 +716,37 @@ example: :l
The number and meaning of the coefficients are specific to the defined
pair style. See the "pair_style"_pair_style.html and
"pair_coeff"_pair_coeff.html commands for details. Coefficients can
also be set via the "pair_coeff"_pair_coeff.html command in the input
"pair_coeff"_pair_coeff.html commands for details. Since pair
coefficients for types I != J are not specified, these will be
generated automatically by the pair style's mixing rule. See the
individual pair_style doc pages and the "pair_modify
mix"_pair_modify.html command for details. Pair coefficients can also
be set via the "pair_coeff"_pair_coeff.html command in the input
script.
:line
{PairIJ Coeffs} section:
one line per pair of atom types for all I,J with I <= J :ulb,l
line syntax: ID1 ID2 coeffs :l
ID1 = atom type I = 1-N
ID2 = atom type J = I-N, with I <= J
coeffs = list of coeffs :pre
examples: :l
3 3 0.022 2.35197 0.022 2.35197
3 5 0.022 2.35197 0.022 2.35197 :pre
:ule
This section must have N*(N+1)/2 lines where N = # of atom types. The
number and meaning of the coefficients are specific to the defined
pair style. See the "pair_style"_pair_style.html and
"pair_coeff"_pair_coeff.html commands for details. Since pair
coefficients for types I != J are all specified, these values will
turn off the default mixing rule defined by the pair style. See the
individual pair_style doc pages and the "pair_modify
mix"_pair_modify.html command for details. Pair coefficients can also
be set via the "pair_coeff"_pair_coeff.html command in the input
script.
:line

View File

@ -13,9 +13,19 @@
</H3>
<P><B>Syntax:</B>
</P>
<PRE>write_data file
<PRE>write_data file keyword value ...
</PRE>
<UL><LI>file = name of data file to write out
<LI>zero or more keyword/value pairs may be appended
<LI>keyword = <I>pair</I>
<PRE> <I>pair</I> value = <I>ii</I> or <I>ij</I>
<I>ii</I> = write one line of pair coefficient info per atom type
<I>ij</I> = write one line of pair coefficient info per IJ atom type pair
</PRE>
</UL>
<P><B>Examples:</B>
</P>
@ -34,15 +44,14 @@ wild-card character. The "*" is replaced with the current timestep
value.
</P>
<P>IMPORTANT NOTE: The write-data command is not yet fully implemented in
two respects. First, most pair, bond, angle, dihedral, improper
styles do not yet write their coefficient information into the data
file. This means you will need to specify that information in your
input script that reads the data file, e.g. with the
<A HREF = "pair_coeff.html">pair_coeff</A> command. Second, a few of the <A HREF = "atom_style.html">atom
styles</A> (body, ellipsoid, line, tri) that store
auxiliary "bonus" information about aspherical particles, do not yet
write the bonus info into the data file. Both these functionalities
will be added to the write_data command later.
two respects. First, most pair styles do not yet write their
coefficient information into the data file. This means you will need
to specify that information in your input script that reads the data
file, via the <A HREF = "pair_coeff.html">pair_coeff</A> command. Second, a few of
the <A HREF = "atom_style.html">atom styles</A> (body, ellipsoid, line, tri) that
store auxiliary "bonus" information about aspherical particles, do not
yet write the bonus info into the data file. Both these
functionalities will be added to the write_data command later.
</P>
<P>Because a data file is in text format, if you use a data file written
out by this command to restart a simulation, the initial state of the
@ -76,6 +85,31 @@ read.
written to the data file. Thus these bonds will not exist when the
data file is read.
</P>
<HR>
<P>The <I>pair</I> keyword lets you specify in what format the pair
coefficient information is written into the data file. If the value
is specified as <I>ii</I>, then one line per atom type is written, to
specify the coefficients for each of the I=J interactions. This means
that no cross-interactions for I != J will be specified in the data
file and the pair style will apply its mixing rule, as documented on
individual <A HREF = "pair_style.html">pair_style</A> doc pages. Of course this
behavior can be overridden in the input script after reading the data
file, by specifying additional <A HREF = "pair_coeff.html">pair_coeff</A> commands
for any desired I,J pairs.
</P>
<P>If the value is specified as <I>ij</I>, then one line of coefficients is
written for all I,J pairs where I <= J. These coefficients will
include any specific settings made in the input script up to that
point. The presence of these I != J coefficients in the data file
will effectively turn off the default mixing rule for the pair style.
Again, the coefficient values in the data file can can be overridden
in the input script after reading the data file, by specifying
additional <A HREF = "pair_coeff.html">pair_coeff</A> commands for any desired I,J
pairs.
</P>
<HR>
<P><B>Restrictions:</B>
</P>
<P>This command requires inter-processor communication to migrate atoms
@ -87,6 +121,8 @@ setup, atom masses initialized, etc).
</P>
<P><A HREF = "read_data.html">read_data</A>, <A HREF = "write_restart.html">write_restart</A>
</P>
<P><B>Default:</B> none
<P><B>Default:</B>
</P>
<P>The option defaults are pair = ii.
</P>
</HTML>

View File

@ -10,9 +10,15 @@ write_data command :h3
[Syntax:]
write_data file :pre
write_data file keyword value ... :pre
file = name of data file to write out :ul
file = name of data file to write out :ulb,l
zero or more keyword/value pairs may be appended :l
keyword = {pair} :l
{pair} value = {ii} or {ij}
{ii} = write one line of pair coefficient info per atom type
{ij} = write one line of pair coefficient info per IJ atom type pair :pre
:ule
[Examples:]
@ -31,15 +37,14 @@ wild-card character. The "*" is replaced with the current timestep
value.
IMPORTANT NOTE: The write-data command is not yet fully implemented in
two respects. First, most pair, bond, angle, dihedral, improper
styles do not yet write their coefficient information into the data
file. This means you will need to specify that information in your
input script that reads the data file, e.g. with the
"pair_coeff"_pair_coeff.html command. Second, a few of the "atom
styles"_atom_style.html (body, ellipsoid, line, tri) that store
auxiliary "bonus" information about aspherical particles, do not yet
write the bonus info into the data file. Both these functionalities
will be added to the write_data command later.
two respects. First, most pair styles do not yet write their
coefficient information into the data file. This means you will need
to specify that information in your input script that reads the data
file, via the "pair_coeff"_pair_coeff.html command. Second, a few of
the "atom styles"_atom_style.html (body, ellipsoid, line, tri) that
store auxiliary "bonus" information about aspherical particles, do not
yet write the bonus info into the data file. Both these
functionalities will be added to the write_data command later.
Because a data file is in text format, if you use a data file written
out by this command to restart a simulation, the initial state of the
@ -73,6 +78,31 @@ Bonds that are broken (e.g. by a bond-breaking potential) are not
written to the data file. Thus these bonds will not exist when the
data file is read.
:line
The {pair} keyword lets you specify in what format the pair
coefficient information is written into the data file. If the value
is specified as {ii}, then one line per atom type is written, to
specify the coefficients for each of the I=J interactions. This means
that no cross-interactions for I != J will be specified in the data
file and the pair style will apply its mixing rule, as documented on
individual "pair_style"_pair_style.html doc pages. Of course this
behavior can be overridden in the input script after reading the data
file, by specifying additional "pair_coeff"_pair_coeff.html commands
for any desired I,J pairs.
If the value is specified as {ij}, then one line of coefficients is
written for all I,J pairs where I <= J. These coefficients will
include any specific settings made in the input script up to that
point. The presence of these I != J coefficients in the data file
will effectively turn off the default mixing rule for the pair style.
Again, the coefficient values in the data file can can be overridden
in the input script after reading the data file, by specifying
additional "pair_coeff"_pair_coeff.html commands for any desired I,J
pairs.
:line
[Restrictions:]
This command requires inter-processor communication to migrate atoms
@ -84,4 +114,7 @@ setup, atom masses initialized, etc).
"read_data"_read_data.html, "write_restart"_write_restart.html
[Default:] none
[Default:]
The option defaults are pair = ii.