ICODE-ADC/lammps
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Added average keyword

Browse Source 
git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@14278 f3b2605a-c512-4ea7-a41b-209d697bcdaa
This commit is contained in:
athomps
2015-12-02 05:06:52 +00:00
parent 3ca986fc6a
commit 00738a8baa
3 changed files with 77 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
doc/compute_msd.txt
View File

@ -15,14 +15,15 @@ compute ID group-ID msd keyword values ... :pre
ID, group-ID are documented in "compute"_compute.html command :ulb,l
msd = style name of this compute command :l
zero or more keyword/value pairs may be appended :l
keyword = {com} :l
{com} value = {yes} or {no} :pre
keyword = {com} or {average} :l
{com} value = {yes} or {no}
{average} value = {yes} or {no} :pre
:ule
[Examples:]
compute 1 all msd
compute 1 upper msd com yes :pre
compute 1 upper msd com yes average yes :pre
[Description:]
@ -41,13 +42,19 @@ averaged over atoms in the group.
The slope of the mean-squared displacement (MSD) versus time is
proportional to the diffusion coefficient of the diffusing atoms.
The displacement of an atom is from its original position at the time
the compute command was issued. The value of the displacement will be
The displacement of an atom is from its reference position. This is
normally the original position at the time
the compute command was issued, unless the {average} keyword is set to {yes}.
The value of the displacement will be
0.0 for atoms not in the specified compute group.
If the {com} option is set to {yes} then the effect of any drift in
the center-of-mass of the group of atoms is subtracted out before xhe
displacment of each atom is calcluated.
the center-of-mass of the group of atoms is subtracted out before the
displacment of each atom is calculated.
If the {average} option is set to {yes} then the reference position of
an atom is a running average of the atom position over all the calls
to the msd calculation since the compute was invoked.
IMPORTANT NOTE: Initial coordinates are stored in "unwrapped" form, by
using the image flags associated with each atom. See the "dump
@ -62,7 +69,13 @@ to be continuous when running from a "restart file"_read_restart.html,
then you should use the same ID for this compute, as in the original
run. This is so that the fix this compute creates to store per-atom
quantities will also have the same ID, and thus be initialized
correctly with time=0 atom coordinates from the restart file.
correctly with atom reference positions from the restart file.
When {average} is set to yes, then the atom reference positions
are restored correctly, but not the number of samples used
obtain them. As a result, the reference positions from the restart
file are combined with subsequent positions as if they were from a
single sample, instead of many, which will change the values of msd
somewhat.
[Output info:]
@ -86,4 +99,4 @@ msd/chunk"_compute_msd_chunk.html
[Default:]
The option default is com = no.
The option default are com = no, average = no.