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

doc/Section_howto.html

@@ -1914,15 +1914,18 @@ void *lammps_extract_atom(void *, char *)
 void *lammps_extract_compute(void *, char *, int, int)
 void *lammps_extract_fix(void *, char *, int, int, int, int)
 void *lammps_extract_variable(void *, char *, char *)
+int lammps_set_variable(void *, char *, char *)
 int lammps_get_natoms(void *)
 void lammps_get_coords(void *, double *)
 void lammps_put_coords(void *, double *) 
 </PRE>
 <P>These can extract various global or per-atom quantities from LAMMPS as
-well as values calculated by a compute, fix, or variable.  The "get"
-and "put" operations can retrieve and reset atom coordinates.
-See the library.cpp file and its associated header file library.h for
-details.
+well as values calculated by a compute, fix, or variable.  The
+"set_variable" function can set an existing string-style variable to a
+new value, so that subsequent LAMMPS commands can access the variable.
+The "get" and "put" operations can retrieve and reset atom
+coordinates.  See the library.cpp file and its associated header file
+library.h for details.
 </P>
 <P>The key idea of the library interface is that you can write any
 functions you wish to define how your code talks to LAMMPS and add

doc/Section_howto.txt

@@ -1901,15 +1901,18 @@ void *lammps_extract_atom(void *, char *)
 void *lammps_extract_compute(void *, char *, int, int)
 void *lammps_extract_fix(void *, char *, int, int, int, int)
 void *lammps_extract_variable(void *, char *, char *)
+int lammps_set_variable(void *, char *, char *)
 int lammps_get_natoms(void *)
 void lammps_get_coords(void *, double *)
 void lammps_put_coords(void *, double *) :pre
 
 These can extract various global or per-atom quantities from LAMMPS as
-well as values calculated by a compute, fix, or variable.  The "get"
-and "put" operations can retrieve and reset atom coordinates.
-See the library.cpp file and its associated header file library.h for
-details.
+well as values calculated by a compute, fix, or variable.  The
+"set_variable" function can set an existing string-style variable to a
+new value, so that subsequent LAMMPS commands can access the variable.
+The "get" and "put" operations can retrieve and reset atom
+coordinates.  See the library.cpp file and its associated header file
+library.h for details.
 
 The key idea of the library interface is that you can write any
 functions you wish to define how your code talks to LAMMPS and add

doc/Section_python.html

@@ -429,7 +429,8 @@ v3 = lmp.extract_fix(id,style,type,i,j)   # extract value(s) from a fix
 					     # flag = 0 = equal-style variable
 					     #        1 = atom-style variable 
 </PRE>
-<PRE>natoms = lmp.get_natoms()                 # total # of atoms as int
+<PRE>flag = lmp.set_variable(name,value)       # set existing named string-style variable to value, flag = 0 if successful
+natoms = lmp.get_natoms()                 # total # of atoms as int
 data = lmp.gather_atoms(name,type,count)  # return atom attribute of all atoms gathered into data, ordered by atom ID
                                           # name = "x", "charge", "type", etc
                                           # count = # of per-atom values, 1 or 3, etc

doc/Section_python.txt

@@ -424,6 +424,7 @@ var = lmp.extract_variable(name,group,flag)  # extract value(s) from a variable
 					     # flag = 0 = equal-style variable
 					     #        1 = atom-style variable :pre
 
+flag = lmp.set_variable(name,value)       # set existing named string-style variable to value, flag = 0 if successful
 natoms = lmp.get_natoms()                 # total # of atoms as int
 data = lmp.gather_atoms(name,type,count)  # return atom attribute of all atoms gathered into data, ordered by atom ID
                                           # name = "x", "charge", "type", etc