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

doc/group.html

@@ -22,14 +22,16 @@
 <PRE>  <I>delete</I> = no args
   <I>region</I> args = region-ID
   <I>type</I> or <I>id</I> or <I>molecule</I>
-    args = one or more atom types, atom IDs, or molecule IDs
+    args = list of one or more atom types, atom IDs, or molecule IDs
+      any entry in list can be a sequence formatted as A:B or A:B:C where
+      A = starting index, B = ending index,
+      C = increment between indices, 1 if not specified
     args = logical value
       logical = "<" or "<=" or ">" or ">=" or "==" or "!="
       value = an atom type or atom ID or molecule ID (depending on <I>style</I>)
     args = logical value1 value2
       logical = "<>"
-      value1,value2 = atom types or atom IDs or molecule IDs
-      	(depending on <I>style</I>)
+      value1,value2 = atom types or atom IDs or molecule IDs (depending on <I>style</I>)
   <I>variable</I> args  = variable-ID
   <I>subtract</I> args = two or more group IDs
   <I>union</I> args = one or more group IDs
@@ -41,6 +43,9 @@
 </P>
 <PRE>group edge region regstrip
 group water type 3 4
+group sub id 10 25 50
+group sub id 10 25 50 500:1000
+group sub id 100:10000:10
 group sub id <= 150
 group polyA molecule <> 50 250
 group hienergy variable eng
@@ -74,16 +79,27 @@ the region volume.
 </P>
 <P>The <I>type</I>, <I>id</I>, and <I>molecule</I> styles put all atoms with the
 specified atom types, atom IDs, or molecule IDs into the group.  These
-3 styles can have their arguments specified in one of two formats.
-The 1st format is a list of values (types or IDs).  For example, the
+3 styles can use arguments specified in one of two formats.
+</P>
+<P>The first format is a list of values (types or IDs).  For example, the
 2nd command in the examples above puts all atoms of type 3 or 4 into
-the group named <I>water</I>.  The 2nd format is a <I>logical</I> followed by
-one or two values (type or ID).  The 7 valid logicals are listed
-above.  All the logicals except <> take a single argument.  The 3rd
-example above adds all atoms with IDs from 1 to 150 to the group named
-<I>sub</I>.  The logical <> means "between" and takes 2 arguments.  The 4th
-example above adds all atoms belonging to molecules with IDs from 50
-to 250 (inclusive) to the group named polyA.
+the group named <I>water</I>.  Each entry in the list can be a
+colon-separated sequence A:B or A:B:C, as in two of the examples
+above.  A "sequence" generates a sequence of values (types or IDs),
+with an optional increment.  The first example with 500:1000 has the
+default increment of 1 and would add all atom IDs from 500 to 1000
+(inclusive) to the group sub, along with 10,25,50 since they also
+appear in the list of values.  The second example with 100:10000:10
+uses an increment of 10 and would thus would add atoms IDs
+100,110,120, ...  9990, 10000 to the group sub.
+</P>
+<P>The second format is a <I>logical</I> followed by one or two values (type
+or ID).  The 7 valid logicals are listed above.  All the logicals
+except <> take a single argument.  The 3rd example above adds all
+atoms with IDs from 1 to 150 to the group named <I>sub</I>.  The logical <>
+means "between" and takes 2 arguments.  The 4th example above adds all
+atoms belonging to molecules with IDs from 50 to 250 (inclusive) to
+the group named polyA.
 </P>
 <P>The <I>variable</I> style evaluates a variable to determine which atoms to
 add to the group.  It must be an <A HREF = "variable.html">atom-style variable</A>

doc/group.txt

@@ -18,14 +18,16 @@ style = {delete} or {region} or {type} or {id} or {molecule} or {variable} or \
   {delete} = no args
   {region} args = region-ID
   {type} or {id} or {molecule}
-    args = one or more atom types, atom IDs, or molecule IDs
+    args = list of one or more atom types, atom IDs, or molecule IDs
+      any entry in list can be a sequence formatted as A:B or A:B:C where
+      A = starting index, B = ending index,
+      C = increment between indices, 1 if not specified
     args = logical value
       logical = "<" or "<=" or ">" or ">=" or "==" or "!="
       value = an atom type or atom ID or molecule ID (depending on {style})
     args = logical value1 value2
       logical = "<>"
-      value1,value2 = atom types or atom IDs or molecule IDs
-      	(depending on {style})
+      value1,value2 = atom types or atom IDs or molecule IDs (depending on {style})
   {variable} args  = variable-ID
   {subtract} args = two or more group IDs
   {union} args = one or more group IDs
@@ -36,6 +38,9 @@ style = {delete} or {region} or {type} or {id} or {molecule} or {variable} or \
 
 group edge region regstrip
 group water type 3 4
+group sub id 10 25 50
+group sub id 10 25 50 500:1000
+group sub id 100:10000:10
 group sub id <= 150
 group polyA molecule <> 50 250
 group hienergy variable eng
@@ -69,16 +74,27 @@ the region volume.
 
 The {type}, {id}, and {molecule} styles put all atoms with the
 specified atom types, atom IDs, or molecule IDs into the group.  These
-3 styles can have their arguments specified in one of two formats.
-The 1st format is a list of values (types or IDs).  For example, the
+3 styles can use arguments specified in one of two formats.
+
+The first format is a list of values (types or IDs).  For example, the
 2nd command in the examples above puts all atoms of type 3 or 4 into
-the group named {water}.  The 2nd format is a {logical} followed by
-one or two values (type or ID).  The 7 valid logicals are listed
-above.  All the logicals except <> take a single argument.  The 3rd
-example above adds all atoms with IDs from 1 to 150 to the group named
-{sub}.  The logical <> means "between" and takes 2 arguments.  The 4th
-example above adds all atoms belonging to molecules with IDs from 50
-to 250 (inclusive) to the group named polyA.
+the group named {water}.  Each entry in the list can be a
+colon-separated sequence A:B or A:B:C, as in two of the examples
+above.  A "sequence" generates a sequence of values (types or IDs),
+with an optional increment.  The first example with 500:1000 has the
+default increment of 1 and would add all atom IDs from 500 to 1000
+(inclusive) to the group sub, along with 10,25,50 since they also
+appear in the list of values.  The second example with 100:10000:10
+uses an increment of 10 and would thus would add atoms IDs
+100,110,120, ...  9990, 10000 to the group sub.
+
+The second format is a {logical} followed by one or two values (type
+or ID).  The 7 valid logicals are listed above.  All the logicals
+except <> take a single argument.  The 3rd example above adds all
+atoms with IDs from 1 to 150 to the group named {sub}.  The logical <>
+means "between" and takes 2 arguments.  The 4th example above adds all
+atoms belonging to molecules with IDs from 50 to 250 (inclusive) to
+the group named polyA.
 
 The {variable} style evaluates a variable to determine which atoms to
 add to the group.  It must be an "atom-style variable"_variable.html