← Back to branch summary

~ubuntu-branches/debian/sid/lammps/sid

« back to all changes in this revision

Viewing changes to doc/compute_vcm_chunk.html

  • Committer: Package Import Robot
  • Author(s): Anton Gladky
  • Date: 2015-04-29 23:44:49 UTC
  • mfrom: (5.1.3 experimental)
  • Revision ID: package-import@ubuntu.com-20150429234449-mbhy9utku6hp6oq8
Tags: 0~20150313.gitfa668e1-1
Upload into unstable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/compute_vcm_chunk.html
 
1
<HTML>
 
2
<CENTER><A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A> - <A HREF = "Manual.html">LAMMPS Documentation</A> - <A HREF = "Section_commands.html#comm">LAMMPS Commands</A> 
 
3
</CENTER>
 
4
 
 
5
 
 
6
 
 
7
 
 
8
 
 
9
 
 
10
<HR>
 
11
 
 
12
<H3>compute vcm/chunk command 
 
13
</H3>
 
14
<P><B>Syntax:</B>
 
15
</P>
 
16
<PRE>compute ID group-ID vcm/chunk chunkID 
 
17
</PRE>
 
18
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
 
19
<LI>vcm/chunk = style name of this compute command
 
20
<LI>chunkID = ID of <A HREF = "compute_chunk_atom.html">compute chunk/atom</A> command 
 
21
</UL>
 
22
<P><B>Examples:</B>
 
23
</P>
 
24
<PRE>compute 1 fluid vcm/chunk molchunk 
 
25
</PRE>
 
26
<P><B>Description:</B>
 
27
</P>
 
28
<P>Define a computation that calculates the center-of-mass velocity for
 
29
multiple chunks of atoms.
 
30
</P>
 
31
<P>In LAMMPS, chunks are collections of atoms defined by a <A HREF = "compute_chunk_atom.html">compute
 
32
chunk/atom</A> command, which assigns each atom
 
33
to a single chunk (or no chunk).  The ID for this command is specified
 
34
as chunkID.  For example, a single chunk could be the atoms in a
 
35
molecule or atoms in a spatial bin.  See the <A HREF = "compute_chunk_atom.html">compute
 
36
chunk/atom</A> doc page and "<A HREF = "Section_howto.html#howto_23">Section_howto
 
37
23</A> for details of how chunks can be
 
38
defined and examples of how they can be used to measure properties of
 
39
a system.
 
40
</P>
 
41
<P>This compute calculates the x,y,z components of the center-of-mass
 
42
velocity for each chunk.  This is done by summing mass*velocity for
 
43
each atom in the chunk and dividing the sum by the total mass of the
 
44
chunk.
 
45
</P>
 
46
<P>Note that only atoms in the specified group contribute to the
 
47
calculation.  The <A HREF = "compute_chunk_atom.html">compute chunk/atom</A> command
 
48
defines its own group; atoms will have a chunk ID = 0 if they are not
 
49
in that group, signifying they are not assigned to a chunk, and will
 
50
thus also not contribute to this calculation.  You can specify the
 
51
"all" group for this command if you simply want to include atoms with
 
52
non-zero chunk IDs.
 
53
</P>
 
54
<P>The simplest way to output the results of the compute vcm/chunk
 
55
calculation to a file is to use the <A HREF = "fix_ave_time.html">fix ave/time</A>
 
56
command, for example:
 
57
</P>
 
58
<PRE>compute cc1 all chunk/atom molecule
 
59
compute myChunk all vcm/chunk cc1
 
60
fix 1 all ave/time 100 1 100 c_myChunk file tmp.out mode vector 
 
61
</PRE>
 
62
<P><B>Output info:</B>
 
63
</P>
 
64
<P>This compute calculates a global array where the number of rows = the
 
65
number of chunks <I>Nchunk</I> as calculated by the specified <A HREF = "compute_chunk_atom.html">compute
 
66
chunk/atom</A> command.  The number of columns =
 
67
3 for the x,y,z center-of-mass velocity coordinates of each chunk.
 
68
These values can be accessed by any command that uses global array
 
69
values from a compute as input.  See <A HREF = "Section_howto.html#howto_15">Section_howto
 
70
15</A> for an overview of LAMMPS output
 
71
options.
 
72
</P>
 
73
<P>The array values are "intensive".  The array values will be in
 
74
velocity <A HREF = "units.html">units</A>.
 
75
</P>
 
76
<P><B>Restrictions:</B> none
 
77
</P>
 
78
<P><B>Related commands:</B> none
 
79
</P>
 
80
<P><B>Default:</B> none
 
81
</P>
 
82
</HTML>