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

This commit is contained in:
sjplimp
2009-03-17 15:41:12 +00:00
parent 5dc6a9e054
commit dec203161a
8 changed files with 50 additions and 23 deletions

View File

@ -17,9 +17,10 @@
</PRE> </PRE>
<UL><LI>ID = user-defined name of the group <UL><LI>ID = user-defined name of the group
<LI>style = <I>region</I> or <I>type</I> or <I>id</I> or <I>molecule</I> or <I>subtract</I> or <I>union</I> or <I>intersect</I> <LI>style = <I>delete</I> or <I>region</I> or <I>type</I> or <I>id</I> or <I>molecule</I> or <I>subtract</I> or <I>union</I> or <I>intersect</I>
<PRE> <I>region</I> args = region-ID <PRE> <I>delete</I> = no args
<I>region</I> args = region-ID
<I>type</I> or <I>id</I> or <I>molecule</I> <I>type</I> or <I>id</I> or <I>molecule</I>
args = one or more atom types, atom IDs, or molecule IDs args = one or more atom types, atom IDs, or molecule IDs
args = logical value args = logical value
@ -44,16 +45,26 @@ group polyA molecule <> 50 250
group boundary subtract all a2 a3 group boundary subtract all a2 a3
group boundary union lower upper group boundary union lower upper
group boundary intersect upper flow group boundary intersect upper flow
group boundary delete
</PRE> </PRE>
<P><B>Description:</B> <P><B>Description:</B>
</P> </P>
<P>Identify a collection of atoms as belonging to a group. The group ID <P>Identify a collection of atoms as belonging to a group. The group ID
can then be used in other commands such as fix, velocity, dump, or can then be used in other commands such as <A HREF = "fix.html">fix</A>,
temperature to act on the atoms together. <A HREF = "compute.html">compute</A>, <A HREF = "dump.html">dump</A>, or <A HREF = "velocity.html">velocity</A>
to act on those atoms together.
</P> </P>
<P>If the group ID already exists, the group command adds the specified <P>If the group ID already exists, the group command adds the specified
atoms to the group. atoms to the group.
</P> </P>
<P>The <I>delete</I> style removes the named group and un-assigns all atoms
that were assigned to that group. Since there is a restriction (see
below) that no more than 32 groups can be defined at any time, the
<I>delete</I> style allows you to remove groups that are no longer needed,
so that more can be specified. You cannot delete a group if it has
been used to define a current <A HREF = "fix.html">fix</A> or <A HREF = "compute.html">compute</A>
or <A HREF = "dump.html">dump</A>.
</P>
<P>The <I>region</I> style puts all atoms in the region volume into the group. <P>The <I>region</I> style puts all atoms in the region volume into the group.
Note that this is a static one-time assignment. The atoms remain Note that this is a static one-time assignment. The atoms remain
assigned (or not assigned) to the group even in they later move out of assigned (or not assigned) to the group even in they later move out of
@ -85,11 +96,12 @@ as arguments. Atoms that belong to every one of the listed groups are
added to the specified group. added to the specified group.
</P> </P>
<P>A group with the ID <I>all</I> is predefined. All atoms belong to this <P>A group with the ID <I>all</I> is predefined. All atoms belong to this
group. group. This group cannot be deleted.
</P> </P>
<P><B>Restrictions:</B> <P><B>Restrictions:</B>
</P> </P>
<P>There can be no more than 32 defined groups, including "all". <P>There can be no more than 32 groups defined at one time, including
"all".
</P> </P>
<P><B>Related commands:</B> <P><B>Related commands:</B>
</P> </P>

View File

@ -13,8 +13,9 @@ group command :h3
group ID style args :pre group ID style args :pre
ID = user-defined name of the group :ulb,l ID = user-defined name of the group :ulb,l
style = {region} or {type} or {id} or {molecule} or {subtract} or \ style = {delete} or {region} or {type} or {id} or {molecule} or {subtract} or \
{union} or {intersect} :l {union} or {intersect} :l
{delete} = no args
{region} args = region-ID {region} args = region-ID
{type} or {id} or {molecule} {type} or {id} or {molecule}
args = one or more atom types, atom IDs, or molecule IDs args = one or more atom types, atom IDs, or molecule IDs
@ -38,17 +39,27 @@ group sub id <= 150
group polyA molecule <> 50 250 group polyA molecule <> 50 250
group boundary subtract all a2 a3 group boundary subtract all a2 a3
group boundary union lower upper group boundary union lower upper
group boundary intersect upper flow :pre group boundary intersect upper flow
group boundary delete :pre
[Description:] [Description:]
Identify a collection of atoms as belonging to a group. The group ID Identify a collection of atoms as belonging to a group. The group ID
can then be used in other commands such as fix, velocity, dump, or can then be used in other commands such as "fix"_fix.html,
temperature to act on the atoms together. "compute"_compute.html, "dump"_dump.html, or "velocity"_velocity.html
to act on those atoms together.
If the group ID already exists, the group command adds the specified If the group ID already exists, the group command adds the specified
atoms to the group. atoms to the group.
The {delete} style removes the named group and un-assigns all atoms
that were assigned to that group. Since there is a restriction (see
below) that no more than 32 groups can be defined at any time, the
{delete} style allows you to remove groups that are no longer needed,
so that more can be specified. You cannot delete a group if it has
been used to define a current "fix"_fix.html or "compute"_compute.html
or "dump"_dump.html.
The {region} style puts all atoms in the region volume into the group. The {region} style puts all atoms in the region volume into the group.
Note that this is a static one-time assignment. The atoms remain Note that this is a static one-time assignment. The atoms remain
assigned (or not assigned) to the group even in they later move out of assigned (or not assigned) to the group even in they later move out of
@ -80,11 +91,12 @@ as arguments. Atoms that belong to every one of the listed groups are
added to the specified group. added to the specified group.
A group with the ID {all} is predefined. All atoms belong to this A group with the ID {all} is predefined. All atoms belong to this
group. group. This group cannot be deleted.
[Restrictions:] [Restrictions:]
There can be no more than 32 defined groups, including "all". There can be no more than 32 groups defined at one time, including
"all".
[Related commands:] [Related commands:]

View File

@ -43,8 +43,7 @@
N = number of pairs stored in a single neighbor page N = number of pairs stored in a single neighbor page
<I>one</I> value = N <I>one</I> value = N
N = max number of neighbors of one atom N = max number of neighbors of one atom
</PRE> <I>binsize</I> value = size
<PRE> <I>binsize</I> value = size
size = bin size for neighbor list construction (distance units) size = bin size for neighbor list construction (distance units)
</PRE> </PRE>

View File

@ -38,7 +38,7 @@ keyword = {delay} or {every} or {check} or {once} or {include} or {exclude} or {
{page} value = N {page} value = N
N = number of pairs stored in a single neighbor page N = number of pairs stored in a single neighbor page
{one} value = N {one} value = N
N = max number of neighbors of one atom :pre N = max number of neighbors of one atom
{binsize} value = size {binsize} value = size
size = bin size for neighbor list construction (distance units) :pre size = bin size for neighbor list construction (distance units) :pre
:ule :ule

View File

@ -27,7 +27,8 @@
evdwl, ecoul, epair, ebond, eangle, edihed, eimp, evdwl, ecoul, epair, ebond, eangle, edihed, eimp,
emol, elong, etail, emol, elong, etail,
vol, lx, ly, lz, xlo, xhi, ylo, yhi, zlo, zhi, vol, lx, ly, lz, xlo, xhi, ylo, yhi, zlo, zhi,
pxx, pyy, pzz, pxy, pxz, pyz xy, xz, yz,
pxx, pyy, pzz, pxy, pxz, pyz,
c_ID, c_ID[n], f_ID, f_ID[n], v_name c_ID, c_ID[n], f_ID, f_ID[n], v_name
step = timestep step = timestep
atoms = # of atoms atoms = # of atoms
@ -51,6 +52,7 @@
vol = volume vol = volume
lx,ly,lz = box lengths in x,y,z lx,ly,lz = box lengths in x,y,z
xlo,xhi,ylo,yhi,zlo,zhi = box boundaries xlo,xhi,ylo,yhi,zlo,zhi = box boundaries
xy,xz,yz = box tilt for triclinic (non-orthogonal) simulation boxes
pxx,pyy,pzz,pxy,pxz,pyz = 6 components of pressure tensor pxx,pyy,pzz,pxy,pxz,pyz = 6 components of pressure tensor
c_ID = global scalar value calculated by a compute with ID c_ID = global scalar value calculated by a compute with ID
c_ID[N] = Nth component of global vector calculated by a compute with ID c_ID[N] = Nth component of global vector calculated by a compute with ID

View File

@ -22,7 +22,8 @@ args = list of arguments for a particular style :l
evdwl, ecoul, epair, ebond, eangle, edihed, eimp, evdwl, ecoul, epair, ebond, eangle, edihed, eimp,
emol, elong, etail, emol, elong, etail,
vol, lx, ly, lz, xlo, xhi, ylo, yhi, zlo, zhi, vol, lx, ly, lz, xlo, xhi, ylo, yhi, zlo, zhi,
pxx, pyy, pzz, pxy, pxz, pyz xy, xz, yz,
pxx, pyy, pzz, pxy, pxz, pyz,
c_ID, c_ID\[n\], f_ID, f_ID\[n\], v_name c_ID, c_ID\[n\], f_ID, f_ID\[n\], v_name
step = timestep step = timestep
atoms = # of atoms atoms = # of atoms
@ -46,6 +47,7 @@ args = list of arguments for a particular style :l
vol = volume vol = volume
lx,ly,lz = box lengths in x,y,z lx,ly,lz = box lengths in x,y,z
xlo,xhi,ylo,yhi,zlo,zhi = box boundaries xlo,xhi,ylo,yhi,zlo,zhi = box boundaries
xy,xz,yz = box tilt for triclinic (non-orthogonal) simulation boxes
pxx,pyy,pzz,pxy,pxz,pyz = 6 components of pressure tensor pxx,pyy,pzz,pxy,pxz,pyz = 6 components of pressure tensor
c_ID = global scalar value calculated by a compute with ID c_ID = global scalar value calculated by a compute with ID
c_ID\[N\] = Nth component of global vector calculated by a compute with ID c_ID\[N\] = Nth component of global vector calculated by a compute with ID

View File

@ -118,7 +118,7 @@ for example, in a loop.
<P>Second, as described below, if a variable is iterated on to the end of <P>Second, as described below, if a variable is iterated on to the end of
its list of strings via the <A HREF = "next.html">next</A> command, it is removed its list of strings via the <A HREF = "next.html">next</A> command, it is removed
from the list of active variables, and is thus available to be from the list of active variables, and is thus available to be
re-defined in a subsequent variable command. The <I>delete</I> option does re-defined in a subsequent variable command. The <I>delete</I> style does
the same thing. the same thing.
</P> </P>
<HR> <HR>
@ -138,7 +138,7 @@ skipped. This enables the construction of simple loops in the input
script that are iterated over and then exited from. script that are iterated over and then exited from.
</P> </P>
<P>As explained above, an exhausted variable can be re-used in an input <P>As explained above, an exhausted variable can be re-used in an input
script. The <I>delete</I> option also removes the variable, the same as if script. The <I>delete</I> style also removes the variable, the same as if
it were exhausted, allowing it to be redefined later in the input it were exhausted, allowing it to be redefined later in the input
script or when the input script is looped over. This can be useful script or when the input script is looped over. This can be useful
when breaking out of a loop via the <A HREF = "if.html">if</A> and <A HREF = "jump.html">jump</A> when breaking out of a loop via the <A HREF = "if.html">if</A> and <A HREF = "jump.html">jump</A>

View File

@ -112,7 +112,7 @@ for example, in a loop.
Second, as described below, if a variable is iterated on to the end of Second, as described below, if a variable is iterated on to the end of
its list of strings via the "next"_next.html command, it is removed its list of strings via the "next"_next.html command, it is removed
from the list of active variables, and is thus available to be from the list of active variables, and is thus available to be
re-defined in a subsequent variable command. The {delete} option does re-defined in a subsequent variable command. The {delete} style does
the same thing. the same thing.
:line :line
@ -132,7 +132,7 @@ skipped. This enables the construction of simple loops in the input
script that are iterated over and then exited from. script that are iterated over and then exited from.
As explained above, an exhausted variable can be re-used in an input As explained above, an exhausted variable can be re-used in an input
script. The {delete} option also removes the variable, the same as if script. The {delete} style also removes the variable, the same as if
it were exhausted, allowing it to be redefined later in the input it were exhausted, allowing it to be redefined later in the input
script or when the input script is looped over. This can be useful script or when the input script is looped over. This can be useful
when breaking out of a loop via the "if"_if.html and "jump"_jump.html when breaking out of a loop via the "if"_if.html and "jump"_jump.html