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

This commit is contained in:
sjplimp 2012-05-22 16:09:28 +00:00
parent 4913d3f0d5
commit c676ea4d6d
8 changed files with 307 additions and 8 deletions

View File

@ -594,6 +594,14 @@ description:
<TR ALIGN="center"><TD WIDTH="100"><A HREF = "improper_harmonic.html">harmonic</A></TD><TD WIDTH="100"><A HREF = "improper_umbrella.html">umbrella</A>
</TD></TR></TABLE></DIV>
<P>These are improper styles contributed by users, which can be used if
<A HREF = "Section_start.html#start_3">LAMMPS is built with the appropriate
package</A>.
</P>
<DIV ALIGN=center><TABLE BORDER=1 >
<TR ALIGN="center"><TD ><A HREF = "improper_cossq.html">cossq</A></TD><TD ><A HREF = "improper_ring.html">ring</A>
</TD></TR></TABLE></DIV>
<P>These are accelerated improper styles, which can be used if LAMMPS is
built with the <A HREF = "Section_accelerate.html">appropriate accelerated
package</A>.

View File

@ -993,6 +993,13 @@ description:
"harmonic"_improper_harmonic.html,
"umbrella"_improper_umbrella.html :tb(c=4,ea=c,w=100)
These are improper styles contributed by users, which can be used if
"LAMMPS is built with the appropriate
package"_Section_start.html#start_3.
"cossq"_improper_cossq.html,
"ring"_improper_ring.html :tb(c=4,ea=c)
These are accelerated improper styles, which can be used if LAMMPS is
built with the "appropriate accelerated
package"_Section_accelerate.html.

70
doc/improper_cossq.html Normal file
View File

@ -0,0 +1,70 @@
<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>improper_style cossq command
</H3>
<P><B>Syntax:</B>
</P>
<PRE>improper_style cossq
</PRE>
<P><B>Examples:</B>
</P>
<PRE>improper_style cossq
improper_coeff 1 4.0 0.0
</PRE>
<P><B>Description:</B>
</P>
<P>The <I>cossq</I> improper style uses the potential
</P>
<CENTER><IMG SRC = "Eqs/improper_cossq.jpg">
</CENTER>
<P>where x is the improper angle, x0 is its equilibrium value, and K is a
prefactor.
</P>
<P>If the 4 atoms in an improper quadruplet (listed in the data file read
by the <A HREF = "read_data.html">read_data</A> command) are ordered I,J,K,L then X
is the angle between the plane of I,J,K and the plane of J,K,L.
Alternatively, you can think of atoms J,K,L as being in a plane, and
atom I above the plane, and X as a measure of how far out-of-plane I
is with respect to the other 3 atoms.
</P>
<P>Note that defining 4 atoms to interact in this way, does not mean that
bonds necessarily exist between I-J, J-K, or K-L, as they would in a
linear dihedral. Normally, the bonds I-J, I-K, I-L would exist for an
improper to be defined between the 4 atoms.
</P>
<P>The following coefficients must be defined for each improper type via
the <A HREF = "improper_coeff.html">improper_coeff</A> command as in the example
above, or in the data file or restart files read by the
<A HREF = "read_data.html">read_data</A> or <A HREF = "read_restart.html">read_restart</A>
commands:
</P>
<UL><LI>K (energy/radian^2)
<LI>X0 (degrees)
</UL>
<P>X0 is specified in degrees, but LAMMPS converts it to radians
internally; hence the units of K are in energy/radian^2.
</P>
<HR>
<P><B>Restrictions:</B>
</P>
<P>This improper style can only be used if LAMMPS was built with the
USER-MISC package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A>
section for more info on packages.
</P>
<P><B>Related commands:</B>
</P>
<P><A HREF = "improper_coeff.html">improper_coeff</A>
</P>
<P><B>Default:</B> none
</P>
</HTML>

65
doc/improper_cossq.txt Normal file
View File

@ -0,0 +1,65 @@
"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
improper_style cossq command :h3
[Syntax:]
improper_style cossq :pre
[Examples:]
improper_style cossq
improper_coeff 1 4.0 0.0 :pre
[Description:]
The {cossq} improper style uses the potential
:c,image(Eqs/improper_cossq.jpg)
where x is the improper angle, x0 is its equilibrium value, and K is a
prefactor.
If the 4 atoms in an improper quadruplet (listed in the data file read
by the "read_data"_read_data.html command) are ordered I,J,K,L then X
is the angle between the plane of I,J,K and the plane of J,K,L.
Alternatively, you can think of atoms J,K,L as being in a plane, and
atom I above the plane, and X as a measure of how far out-of-plane I
is with respect to the other 3 atoms.
Note that defining 4 atoms to interact in this way, does not mean that
bonds necessarily exist between I-J, J-K, or K-L, as they would in a
linear dihedral. Normally, the bonds I-J, I-K, I-L would exist for an
improper to be defined between the 4 atoms.
The following coefficients must be defined for each improper type via
the "improper_coeff"_improper_coeff.html command as in the example
above, or in the data file or restart files read by the
"read_data"_read_data.html or "read_restart"_read_restart.html
commands:
K (energy/radian^2)
X0 (degrees) :ul
X0 is specified in degrees, but LAMMPS converts it to radians
internally; hence the units of K are in energy/radian^2.
:line
[Restrictions:]
This improper style can only be used if LAMMPS was built with the
USER-MISC package. See the "Making LAMMPS"_Section_start.html#start_3
section for more info on packages.
[Related commands:]
"improper_coeff"_improper_coeff.html
[Default:] none

77
doc/improper_ring.html Normal file
View File

@ -0,0 +1,77 @@
<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>improper_style ring command
</H3>
<P><B>Syntax:</B>
</P>
<PRE>improper_style ring
</PRE>
<P><B>Examples:</B>
</P>
<PRE>improper_style ring
improper_coeff 1 8000 70.5
</PRE>
<P><B>Description:</B>
</P>
<P>The <I>ring</I> improper style uses the potential
</P>
<CENTER><IMG SRC = "Eqs/improper_ring.jpg">
</CENTER>
<P>where K is a prefactor, theta is the angle formed by the atoms
specified by (i,j,k,l) indices and theta0 its equilibrium value.
</P>
<P>If the 4 atoms in an improper quadruplet (listed in the data file read
by the <A HREF = "read_data.html">read_data</A> command) are ordered i,j,k,l then
theta_<I>ijl</I> is the angle between atoms i,j and l, theta_<I>ijk</I> is the
angle between atoms i,j and k, theta_<I>kjl</I> is the angle between atoms
j,k, and l.
</P>
<P>The "ring" improper style implements the improper potential introduced
by Destree et al., in Equation (9) of <A HREF = "#Destree">(Destree)</A>. This
potential does not affect small amplitude vibrations but is used in an
ad-hoc way to prevent the onset of accidentially large amplitude
fluctuations leading to the occurrence of a planar conformation of the
three bonds i-j, j-k and j-l, an intermediate conformation toward the
chiral inversion of a methine carbon. In the "Impropers" section of
data file four atoms: i, j, k and l are specified with i,j and l lying
on the backbone of the chain and k specifying the chirality of j.
</P>
<P>The following coefficients must be defined for each improper type via
the <A HREF = "improper_coeff.html">improper_coeff</A> command as in the example
above, or in the data file or restart files read by the
<A HREF = "read_data.html">read_data</A> or <A HREF = "read_restart.html">read_restart</A>
commands:
</P>
<UL><LI>K (energy/radian^2)
<LI>theta0 (degrees)
</UL>
<P>theta0 is specified in degrees, but LAMMPS converts it to radians
internally; hence the units of K are in energy/radian^2.
</P>
<HR>
<P><B>Restrictions:</B>
</P>
<P>This improper style can only be used if LAMMPS was built with the
USER-MISC package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A>
section for more info on packages.
</P>
<P><B>Related commands:</B>
</P>
<P><A HREF = "improper_coeff.html">improper_coeff</A>
</P>
<A NAME = "Destree"></A>
<P><B>(Destree)</B> M. Destree, F. Laupretre, A. Lyulin, and J.-P. Ryckaert,
J Chem Phys, 112, 9632 (2000).
</P>
</HTML>

72
doc/improper_ring.txt Normal file
View File

@ -0,0 +1,72 @@
"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
improper_style ring command :h3
[Syntax:]
improper_style ring :pre
[Examples:]
improper_style ring
improper_coeff 1 8000 70.5 :pre
[Description:]
The {ring} improper style uses the potential
:c,image(Eqs/improper_ring.jpg)
where K is a prefactor, theta is the angle formed by the atoms
specified by (i,j,k,l) indices and theta0 its equilibrium value.
If the 4 atoms in an improper quadruplet (listed in the data file read
by the "read_data"_read_data.html command) are ordered i,j,k,l then
theta_{ijl} is the angle between atoms i,j and l, theta_{ijk} is the
angle between atoms i,j and k, theta_{kjl} is the angle between atoms
j,k, and l.
The "ring" improper style implements the improper potential introduced
by Destree et al., in Equation (9) of "(Destree)"_#Destree. This
potential does not affect small amplitude vibrations but is used in an
ad-hoc way to prevent the onset of accidentially large amplitude
fluctuations leading to the occurrence of a planar conformation of the
three bonds i-j, j-k and j-l, an intermediate conformation toward the
chiral inversion of a methine carbon. In the "Impropers" section of
data file four atoms: i, j, k and l are specified with i,j and l lying
on the backbone of the chain and k specifying the chirality of j.
The following coefficients must be defined for each improper type via
the "improper_coeff"_improper_coeff.html command as in the example
above, or in the data file or restart files read by the
"read_data"_read_data.html or "read_restart"_read_restart.html
commands:
K (energy/radian^2)
theta0 (degrees) :ul
theta0 is specified in degrees, but LAMMPS converts it to radians
internally; hence the units of K are in energy/radian^2.
:line
[Restrictions:]
This improper style can only be used if LAMMPS was built with the
USER-MISC package. See the "Making LAMMPS"_Section_start.html#start_3
section for more info on packages.
[Related commands:]
"improper_coeff"_improper_coeff.html
:link(Destree)
[(Destree)] M. Destree, F. Laupretre, A. Lyulin, and J.-P. Ryckaert,
J Chem Phys, 112, 9632 (2000).

View File

@ -62,10 +62,10 @@ Click on the style to display the formula it computes and coefficients
specified by the associated <A HREF = "improper_coeff.html">improper_coeff</A>
command.
</P>
<P>There are also additional improper styles submitted by users which are
included in the LAMMPS distribution. The list of these with links to
the individual styles are given in the improper section of <A HREF = "Section_commands.html#cmd_5">this
page</A>.
<P>Note that there are also additional improper styles submitted by users
which are included in the LAMMPS distribution. The list of these with
links to the individual styles are given in the improper section of
<A HREF = "Section_commands.html#cmd_5">this page</A>.
</P>
<UL><LI><A HREF = "improper_none.html">improper_style none</A> - turn off improper interactions
<LI><A HREF = "improper_hybrid.html">improper_style hybrid</A> - define multiple styles of improper interactions

View File

@ -59,10 +59,10 @@ Click on the style to display the formula it computes and coefficients
specified by the associated "improper_coeff"_improper_coeff.html
command.
There are also additional improper styles submitted by users which are
included in the LAMMPS distribution. The list of these with links to
the individual styles are given in the improper section of "this
page"_Section_commands.html#cmd_5.
Note that there are also additional improper styles submitted by users
which are included in the LAMMPS distribution. The list of these with
links to the individual styles are given in the improper section of
"this page"_Section_commands.html#cmd_5.
"improper_style none"_improper_none.html - turn off improper interactions
"improper_style hybrid"_improper_hybrid.html - define multiple styles of improper interactions :ul