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

This commit is contained in:
sjplimp 2007-10-22 22:00:52 +00:00
parent ce13f68784
commit e5bb1dec27
4 changed files with 105 additions and 107 deletions

View File

@ -51,17 +51,16 @@ curvatures <A HREF = "#Everaers">(Everaers)</A>:
<P>The variable names utilized as potential parameters are for the most
part taken from <A HREF = "#Everaers">(Everaers)</A> in order to be consistent with
its RE-squared potential fix. Details on the upsilon and mu
parameters are given <A HREF = "Eqs/pair_gayberne_extra.pdf">here</A>. Use of this pair style requires
parameters are given <A HREF = "gbdoc">here</A>. Use of this pair style requires
the NVE, NVT, or NPT fixes with the <I>asphere</I> extension (e.g. <A HREF = "fix_nve_asphere.html">fix
nve/asphere</A>) in order to integrate particle
rotation. Additionally, <A HREF = "atom_style.html">atom_style ellipsoid</A> should
be used since it defines the rotational state of the ellipsoidal
particles.
</P>
<P>More details of the Gay-Berne formulation are given in the references
listed below and in <A HREF = "Eqs/pair_gayberne_extra.pdf">this document</A>.
listed below and in <A HREF = "Eqs/pair_gayberne_extra.pdf">this supplementary
document</A>.
</P>
<P>The following coefficients must be defined for each pair of atoms
types via the <A HREF = "pair_coeff.html">pair_coeff</A> command as in the examples

View File

@ -55,10 +55,9 @@ rotation. Additionally, "atom_style ellipsoid"_atom_style.html should
be used since it defines the rotational state of the ellipsoidal
particles.
:link(gbdoc,Eqs/pair_gayberne_extra.pdf)
More details of the Gay-Berne formulation are given in the references
listed below and in "this document"_Eqs/pair_gayberne_extra.pdf.
listed below and in "this supplementary
document"_Eqs/pair_gayberne_extra.pdf.
The following coefficients must be defined for each pair of atoms
types via the "pair_coeff"_pair_coeff.html command as in the examples

View File

@ -25,25 +25,23 @@ pair_coeff * * 1.0 1.0 1.7 3.4 3.4 1.0 1.0 1.0
<P><B>Description:</B>
</P>
<P>Style <I>resquared</I> computes the RE-squared anisotropic interaction
<A HREF = "#Everaers">(Everaers,Babadi)</A> between pairs of ellipsoidal and/or
spherical Lennard-Jones particles. For ellipsoidal interactions,
the potential considers the ellipsoid as being comprised of small
spheres of size sigma. LJ particles are a single sphere of size
sigma. The distinction is made to allow the pair style to make
<A HREF = "#Everaers">(Everaers)</A>, <A HREF = "#Babadi">(Babadi)</A> between pairs of
ellipsoidal and/or spherical Lennard-Jones particles. For ellipsoidal
interactions, the potential considers the ellipsoid as being comprised
of small spheres of size sigma. LJ particles are a single sphere of
size sigma. The distinction is made to allow the pair style to make
efficient calculations of ellipsoid/solvent interactions.
</P>
<P>Details for the equations used are given in the references below
and <A HREF = "#redoc">this document</A>.
<P>Details for the equations used are given in the references below and
in <A HREF = "Eqs/pair_resquqred_extra.pdf">this supplementary document</A>.
</P>
<P>Use of this pair style requires the NVE, NVT, or NPT fixes
with the <I>asphere</I> extension (e.g. <A HREF = "fix_nve_asphere.html">fix
nve/asphere</A>) in order to integrate particle
rotation. Additionally, <A HREF = "atom_style.html">atom_style ellipsoid</A> should
be used since it defines the rotational state of the ellipsoidal
particles and the <A HREF = "shape.html">shape</A> command should be used to
specify ellipsoid diameters.
<P>Use of this pair style requires the NVE, NVT, or NPT fixes with the
<I>asphere</I> extension (e.g. <A HREF = "fix_nve_asphere.html">fix nve/asphere</A>) in
order to integrate particle rotation. Additionally, <A HREF = "atom_style.html">atom_style
ellipsoid</A> should be used since it defines the
rotational state of the ellipsoidal particles and the
<A HREF = "shape.html">shape</A> command should be used to specify ellipsoid
diameters.
</P>
<P>The following coefficients must be defined for each pair of atoms
types via the <A HREF = "pair_coeff.html">pair_coeff</A> command as in the examples
@ -61,52 +59,52 @@ commands:
<LI>epsilon_j_c = relative well depth of type J for end-to-end interactions
<LI>cutoff (distance units)
</UL>
<P>The parameters used depend on the type of particles interacting -
ellipsoid or LJ sphere. The type of particle is determined by
the diameters specified with the <A HREF = "shape.html">shape</A>
command. LJ spheres have diameters equal to zero and thus
represent a single particle with size sigma. The epsilon_i_* or
epsilon_j_* parameters are ignored for LJ sphere interactions.
The interactions between two LJ sphere particles are computed
using the standard Lennard-Jones formula.
<P>The parameters used depend on the type of the interacting particles,
i.e. ellipsoid or LJ sphere. The type of particle is determined by
the diameters specified with the <A HREF = "shape.html">shape</A> command. LJ
spheres have diameters equal to zero and thus represent a single
particle with size sigma. The epsilon_i_* or epsilon_j_* parameters
are ignored for LJ sphere interactions. The interactions between two
LJ sphere particles are computed using the standard Lennard-Jones
formula.
</P>
<P>A12 specifies the energy prefactor which depends on
the type of particles interacting. For ellipsoid-ellipsoid
interactions, A12 is the Hamaker constant as described in
<A HREF = "#Everaers">(Everaers)</A>. In LJ units:
<P>A12 specifies the energy prefactor which depends on the type of
particles interacting. For ellipsoid-ellipsoid interactions, A12 is
the Hamaker constant as described in <A HREF = "#Everaers">(Everaers)</A>. In LJ
units:
</P>
<CENTER><IMG SRC = "Eqs/pair_resquared.jpg">
</CENTER>
<P>where rho gives the number density of the spherical particles
composing the ellipsoids and epsilon_LJ determines the
interaction strength of the spherical particles.
composing the ellipsoids and epsilon_LJ determines the interaction
strength of the spherical particles.
</P>
<P>For ellipsoid-LJ sphere interactions, A12 gives the energy
prefactor (see <A HREF = "Eqs/pair_resquared_extra.pdf">here</A> for details:
<P>For ellipsoid-LJ sphere interactions, A12 gives the energy prefactor
(see <A HREF = "Eqs/pair_resquared_extra.pdf">here</A> for details:
</P>
<CENTER><IMG SRC = "Eqs/pair_resquared2.jpg">
</CENTER>
<P>For LJ sphere-LJ sphere interactions, A12 is the standard
epsilon used in Lennard-Jones pair styles:
<P>For LJ sphere-LJ sphere interactions, A12 is the standard epsilon used
in Lennard-Jones pair styles:
</P>
<CENTER><IMG SRC = "Eqs/pair_resquared3.jpg">
</CENTER>
<P>sigma specifies the diameter of the continuous distribution of
constituent particles within each ellipsoid used to model
the RE-squared potential. Therefore, the effective shape
of an ellipsoid is given by the specified diameters
(see the <A HREF = "shape.html">shape</A> command) plus sigma.
<P>sigma specifies the diameter of the continuous distribution of
constituent particles within each ellipsoid used to model the
RE-squared potential. Therefore, the effective shape of an ellipsoid
is given by the specified diameters (see the <A HREF = "shape.html">shape</A>
command) plus sigma.
</P>
<P>For large uniform molecules it has been shown that the epsilon_*_*
energy parameters are approximately representable in terms of
local contact curvatures <A HREF = "#Everaers">(Everaers)</A>:
<P>For large uniform molecules it has been shown that the epsilon_*_*
energy parameters are approximately representable in terms of local
contact curvatures <A HREF = "#Everaers">(Everaers)</A>:
</P>
<CENTER><IMG SRC = "Eqs/pair_resquared4.jpg">
</CENTER>
<P>where a, b, and c give the particle diameters.
</P>
<P>The last coefficient is optional. If not specified, the global
cutoff specified in the pair_style command is used.
<P>The last coefficient is optional. If not specified, the global cutoff
specified in the pair_style command is used.
</P>
<P>The epsilon_i and epsilon_j coefficients are actually defined for atom
types, not for pairs of atom types. Thus, in a series of pair_coeff
@ -135,12 +133,14 @@ that type in a "pair_coeff I J" command.
<P><B>Mixing, shift, table, tail correction, per-atom energy/stress,
restart, rRESPA info</B>:
</P>
<P>Automatic mixing is supported only between LJ sphere
pairs due to the different meanings of the energy prefactors used
to calculate the interactions and the implicit dependance of
the ellipsoid-LJ sphere interaction on the equation for the
Hamaker constant presented here. Mixing of sigma and epsilon
followed by calculation of the energy prefactors using the
<P>For atom type pairs I,J and I != J, the epsilon and sigma coefficients
and cutoff distance can be mixed, but only for LJ sphere pairs. The
default mix value is <I>geometric</I>. See the "pair_modify" command for
details. Other type pairs cannot be mixed, due to the different
meanings of the energy prefactors used to calculate the interactions
and the implicit dependance of the ellipsoid-LJ sphere interaction on
the equation for the Hamaker constant presented here. Mixing of sigma
and epsilon followed by calculation of the energy prefactors using the
equations above is recommended.
</P>
<P>This pair styles supports the <A HREF = "pair_modify.html">pair_modify</A> shift

View File

@ -22,25 +22,23 @@ pair_coeff * * 1.0 1.0 1.7 3.4 3.4 1.0 1.0 1.0 :pre
[Description:]
Style {resquared} computes the RE-squared anisotropic interaction
"(Everaers,Babadi)"_#Everaers between pairs of ellipsoidal and/or
spherical Lennard-Jones particles. For ellipsoidal interactions,
the potential considers the ellipsoid as being comprised of small
spheres of size sigma. LJ particles are a single sphere of size
sigma. The distinction is made to allow the pair style to make
"(Everaers)"_#Everaers, "(Babadi)"_#Babadi between pairs of
ellipsoidal and/or spherical Lennard-Jones particles. For ellipsoidal
interactions, the potential considers the ellipsoid as being comprised
of small spheres of size sigma. LJ particles are a single sphere of
size sigma. The distinction is made to allow the pair style to make
efficient calculations of ellipsoid/solvent interactions.
:link(redoc,Eqs/pair_resquared_extra.pdf)
Details for the equations used are given in the references below and
in "this supplementary document"_Eqs/pair_resquqred_extra.pdf.
Details for the equations used are given in the references below
and "this document"_#redoc.
Use of this pair style requires the NVE, NVT, or NPT fixes
with the {asphere} extension (e.g. "fix
nve/asphere"_fix_nve_asphere.html) in order to integrate particle
rotation. Additionally, "atom_style ellipsoid"_atom_style.html should
be used since it defines the rotational state of the ellipsoidal
particles and the "shape"_shape.html command should be used to
specify ellipsoid diameters.
Use of this pair style requires the NVE, NVT, or NPT fixes with the
{asphere} extension (e.g. "fix nve/asphere"_fix_nve_asphere.html) in
order to integrate particle rotation. Additionally, "atom_style
ellipsoid"_atom_style.html should be used since it defines the
rotational state of the ellipsoidal particles and the
"shape"_shape.html command should be used to specify ellipsoid
diameters.
The following coefficients must be defined for each pair of atoms
types via the "pair_coeff"_pair_coeff.html command as in the examples
@ -58,52 +56,52 @@ epsilon_j_b = relative well depth of type J for face-to-face interactions
epsilon_j_c = relative well depth of type J for end-to-end interactions
cutoff (distance units) :ul
The parameters used depend on the type of particles interacting -
ellipsoid or LJ sphere. The type of particle is determined by
the diameters specified with the "shape"_shape.html
command. LJ spheres have diameters equal to zero and thus
represent a single particle with size sigma. The epsilon_i_* or
epsilon_j_* parameters are ignored for LJ sphere interactions.
The interactions between two LJ sphere particles are computed
using the standard Lennard-Jones formula.
The parameters used depend on the type of the interacting particles,
i.e. ellipsoid or LJ sphere. The type of particle is determined by
the diameters specified with the "shape"_shape.html command. LJ
spheres have diameters equal to zero and thus represent a single
particle with size sigma. The epsilon_i_* or epsilon_j_* parameters
are ignored for LJ sphere interactions. The interactions between two
LJ sphere particles are computed using the standard Lennard-Jones
formula.
A12 specifies the energy prefactor which depends on
the type of particles interacting. For ellipsoid-ellipsoid
interactions, A12 is the Hamaker constant as described in
"(Everaers)"_#Everaers. In LJ units:
A12 specifies the energy prefactor which depends on the type of
particles interacting. For ellipsoid-ellipsoid interactions, A12 is
the Hamaker constant as described in "(Everaers)"_#Everaers. In LJ
units:
:c,image(Eqs/pair_resquared.jpg)
where rho gives the number density of the spherical particles
composing the ellipsoids and epsilon_LJ determines the
interaction strength of the spherical particles.
composing the ellipsoids and epsilon_LJ determines the interaction
strength of the spherical particles.
For ellipsoid-LJ sphere interactions, A12 gives the energy
prefactor (see "here"_Eqs/pair_resquared_extra.pdf for details:
For ellipsoid-LJ sphere interactions, A12 gives the energy prefactor
(see "here"_Eqs/pair_resquared_extra.pdf for details:
:c,image(Eqs/pair_resquared2.jpg)
For LJ sphere-LJ sphere interactions, A12 is the standard
epsilon used in Lennard-Jones pair styles:
For LJ sphere-LJ sphere interactions, A12 is the standard epsilon used
in Lennard-Jones pair styles:
:c,image(Eqs/pair_resquared3.jpg)
sigma specifies the diameter of the continuous distribution of
constituent particles within each ellipsoid used to model
the RE-squared potential. Therefore, the effective shape
of an ellipsoid is given by the specified diameters
(see the "shape"_shape.html command) plus sigma.
sigma specifies the diameter of the continuous distribution of
constituent particles within each ellipsoid used to model the
RE-squared potential. Therefore, the effective shape of an ellipsoid
is given by the specified diameters (see the "shape"_shape.html
command) plus sigma.
For large uniform molecules it has been shown that the epsilon_*_*
energy parameters are approximately representable in terms of
local contact curvatures "(Everaers)"_#Everaers:
For large uniform molecules it has been shown that the epsilon_*_*
energy parameters are approximately representable in terms of local
contact curvatures "(Everaers)"_#Everaers:
:c,image(Eqs/pair_resquared4.jpg)
where a, b, and c give the particle diameters.
The last coefficient is optional. If not specified, the global
cutoff specified in the pair_style command is used.
The last coefficient is optional. If not specified, the global cutoff
specified in the pair_style command is used.
The epsilon_i and epsilon_j coefficients are actually defined for atom
types, not for pairs of atom types. Thus, in a series of pair_coeff
@ -132,12 +130,14 @@ that type in a "pair_coeff I J" command.
[Mixing, shift, table, tail correction, per-atom energy/stress,
restart, rRESPA info]:
Automatic mixing is supported only between LJ sphere
pairs due to the different meanings of the energy prefactors used
to calculate the interactions and the implicit dependance of
the ellipsoid-LJ sphere interaction on the equation for the
Hamaker constant presented here. Mixing of sigma and epsilon
followed by calculation of the energy prefactors using the
For atom type pairs I,J and I != J, the epsilon and sigma coefficients
and cutoff distance can be mixed, but only for LJ sphere pairs. The
default mix value is {geometric}. See the "pair_modify" command for
details. Other type pairs cannot be mixed, due to the different
meanings of the energy prefactors used to calculate the interactions
and the implicit dependance of the ellipsoid-LJ sphere interaction on
the equation for the Hamaker constant presented here. Mixing of sigma
and epsilon followed by calculation of the energy prefactors using the
equations above is recommended.
This pair styles supports the "pair_modify"_pair_modify.html shift