File: fix_ave_euler.html

package info (click to toggle)
liggghts 3.0.3%2Brepack-2
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 106,076 kB
  • ctags: 34,406
  • sloc: cpp: 363,723; python: 21,138; ansic: 9,146; perl: 3,687; sh: 2,841; fortran: 2,802; xml: 788; makefile: 485; objc: 238; lisp: 169; f90: 145; csh: 16; awk: 14
file content (95 lines) | stat: -rw-r--r-- 3,570 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
<HTML>
<CENTER><A HREF = "http://www.cfdem.com">LIGGGHTS WWW Site</A> - <A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A> - <A HREF = "Manual.html">LIGGGHTS Documentation</A> - <A HREF = "Section_commands.html#comm">LIGGGHTS Commands</A> 
</CENTER>








<HR>

<H3>fix ave/euler command 
</H3>
<P><B>Syntax:</B>
</P>
<PRE>fix ID group-ID ave/euler nevery N cell_size_relative c 
</PRE>
<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command 

<LI>ave/euler = style name of this fix command 

<LI>nevery = obligatory keyword 

<LI>n = calculate average values every this many timesteps 

<LI>cell_size_relative = obligatory keyword 

<LI>c = cell size in multiples of max cutoff 


</UL>
<P><B>Examples:</B>
</P>
<PRE>fix 1 all ave/euler nevery 100 cell_size_relative 4.5 
</PRE>
<P><B>Description:</B>
</P>
<P>Calculate cell-based averages of velocity, radius, volume fraction, 
and pressure (-1/3 * trace of the stress tensor) every few timesteps,
as specified by the <I>nevery</I> keyword. The size of the cells is calculated
as multiple of the maximum cutoff, via the <I>cell_size_relative</I>.
Note that at least a relative cell size of 3 is required.
</P>
<P>Note that velocity is favre (mass) averaged, whereas radius is arithmetically
averaged. To calculate the stress, this command internally uses a 
<A HREF = "compute_stress_atom.html">compute stress/atom</A> . It includes the convective 
term correctly for granular particles with non-zero average velocity 
(which is not included  in <A HREF = "compute_stress_atom.html">compute stress/atom</A>).
However, it does not include bond, angle, diahedral or kspace contributions 
so that the stress tensor finally reads
</P>
<CENTER><IMG SRC = "Eqs/stress_tensor_granular.png">
</CENTER>
<P>where vave is the (cell-based) average velocity. 
The first term is a kinetic energy contribution for atom <I>I</I>.  The
second term is a pairwise energy contribution where <I>n</I> loops over the
<I>Np</I> neighbors of atom <I>I</I>, <I>r1</I> and <I>r2</I> are the positions of the 2
atoms in the pairwise interaction, and <I>F1</I> and <I>F2</I> are the forces on
the 2 atoms resulting from the pairwise interaction.
</P>
<HR>

<P><B>Restart, fix_modify, output, run start/stop, minimize info:</B>
</P>
<P>No information about this fix is written to <A HREF = "restart.html">binary restart
files</A>.  None of the <A HREF = "fix_modify.html">fix_modify</A> options
are relevant to this fix.
</P>
<P>This fix computes the above-mentioned quantities for output via a 
<A HREF = "dump.html">dump euler/vtk</A> command.  The values can
only be accessed on timesteps that are multiples of <I>nevery</I> since that
is when calculations are performed. 
</P>
<P>No parameter of this fix can be used with the <I>start/stop</I> keywords of
the <A HREF = "run.html">run</A> command.  This fix is not invoked during <A HREF = "minimize.html">energy
minimization</A>.
</P>
<P><B>Restrictions:</B>
</P>
<P>Volume fractions and stresses are calculated based on the assumption
of a structured (equidistant regular) grid, so volume fractions and
stresses near walls that are not alligned with the grid will be
incorrect.
</P>
<P><B>Related commands:</B>
</P>
<P><A HREF = "compute.html">compute</A>, <A HREF = "compute_stress_atom.html">compute stress/atom</A>,
<A HREF = "fix_ave_atom.html">fix ave/atom</A>, <A HREF = "fix_ave_histo.html">fix ave/histo</A>, 
<A HREF = "fix_ave_time.html">fix ave/time</A>, <A HREF = "fix_ave_spatial.html">fix ave/spatial</A>,
</P>
<P><B>Default:</B> none
</P>
</HTML>