Debian Codegraph @

doc/gran_model_hertz_stiffness.html

raw
1
2
3 <!DOCTYPE html>
4 <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
5 <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
6 <head>
7 <meta charset="utf-8">
8
9 <meta name="viewport" content="width=device-width, initial-scale=1.0">
10
11 <title>gran model hertz/stiffness model &mdash; LIGGGHTS v3.X documentation</title>
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29 <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
30
31
32
33
34
35 <link rel="top" title="LIGGGHTS v3.X documentation" href="index.html"/>
36
37
38 <script src="_static/js/modernizr.min.js"></script>
39
40 </head>
41
42 <body class="wy-body-for-nav" role="document">
43
44
45 <div class="wy-grid-for-nav">
46
47
48 <nav data-toggle="wy-nav-shift" class="wy-nav-side">
49 <div class="wy-side-scroll">
50 <div class="wy-side-nav-search">
51
52
53
54 <a href="Manual.html" class="icon icon-home"> LIGGGHTS
55
56
57
58 </a>
59
60
61
62
63 <div class="version">
64 v3.X
65 </div>
66
67
68
69
70 <div role="search">
71 <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
72 <input type="text" name="q" placeholder="Search docs" />
73 <input type="hidden" name="check_keywords" value="yes" />
74 <input type="hidden" name="area" value="default" />
75 </form>
76 </div>
77
78
79 </div>
80
81 <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
82
83
84
85
86
87
88 <ul>
89 <li class="toctree-l1"><a class="reference internal" href="Section_intro.html">1. Introduction</a></li>
90 <li class="toctree-l1"><a class="reference internal" href="Section_start.html">2. Getting Started</a></li>
91 <li class="toctree-l1"><a class="reference internal" href="Section_input_script.html">3. Input Script</a></li>
92 <li class="toctree-l1"><a class="reference internal" href="Section_commands.html">4. Commands</a></li>
93 <li class="toctree-l1"><a class="reference internal" href="Section_gran_models.html">5. Contact models</a></li>
94 <li class="toctree-l1"><a class="reference internal" href="Section_mesh_modules.html">6. Mesh modules</a></li>
95 <li class="toctree-l1"><a class="reference internal" href="Section_packages.html">7. Packages</a></li>
96 <li class="toctree-l1"><a class="reference internal" href="Section_howto.html">8. How-to discussions</a></li>
97 <li class="toctree-l1"><a class="reference internal" href="Section_modify.html">9. Modifying &amp; extending LIGGGHTS(R)-PUBLIC</a></li>
98 <li class="toctree-l1"><a class="reference internal" href="Section_python.html">10. Python interface to LIGGGHTS(R)-PUBLIC</a></li>
99 <li class="toctree-l1"><a class="reference internal" href="Section_errors.html">11. Errors</a></li>
100 </ul>
101
102
103
104 </div>
105 </div>
106 </nav>
107
108 <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
109
110
111 <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
112
113 <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
114 <a href="Manual.html">LIGGGHTS</a>
115
116 </nav>
117
118
119
120 <div class="wy-nav-content">
121 <div class="rst-content">
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138 <div role="navigation" aria-label="breadcrumbs navigation">
139
140 <ul class="wy-breadcrumbs">
141
142 <li><a href="Manual.html">Docs</a> &raquo;</li>
143
144 <li>gran model hertz/stiffness model</li>
145
146
147 <li class="wy-breadcrumbs-aside">
148
149
150 <a href="_sources/gran_model_hertz_stiffness.txt" rel="nofollow"> View page source</a>
151
152 <a href="http://www.cfdem.com"> Website</a>
153
154 <a href="Section_commands.html#comm" rel="nofollow"> Commands</a>
155
156
157
158 </li>
159
160 </ul>
161
162
163 <hr/>
164
165 </div>
166 <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
167 <div itemprop="articleBody">
168
169 <div class="section" id="gran-model-hertz-stiffness-model">
170 <span id="index-0"></span><h1>gran model hertz/stiffness model<a class="headerlink" href="#gran-model-hertz-stiffness-model" title="Permalink to this headline">¶</a></h1>
171 <div class="section" id="syntax">
172 <h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
173 <pre class="literal-block">
174 model hertz [other model_type/model_name pairs as described <a class="reference internal" href="pair_gran.html"><em>here</em></a> ] keyword values
175 </pre>
176 <ul class="simple">
177 <li>zero or more keyword/value pairs may be appended to the end (after all models are specified)</li>
178 </ul>
179 <pre class="literal-block">
180 <em>limitForce</em> values = 'on' or 'off'
181 on = ensures that the normal force is never attractive (an artefact that can occur at the end of a collision).
182 off = standard implementation that might lead to attractive forces.
183 <em>tangential_damping</em> values = 'on' or 'off'
184 on = activates tangential damping
185 off = no tangential damping
186 </pre>
187 </div>
188 <div class="section" id="description">
189 <h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
190 <p>This granular model uses the following formula for the frictional force between two granular
191 particles, when the distance r between two particles of radii Ri and Rj is less than their
192 contact distance d = Ri + Rj. There is no force between the particles when r &gt; d:</p>
193 <img alt="_images/pair_gran_html_60b8ced2.png" class="align-center" src="_images/pair_gran_html_60b8ced2.png" />
194 <p>In the first term is the normal force between the two particles and the second term is the
195 tangential force. The normal force has 2 terms, a spring force and a damping force. The
196 tangential force also has 2 terms: a shear force and a damping force. The shear force is
197 a &#8220;history&#8221; effect that accounts for the tangential displacement (&#8220;tangential overlap&#8221;)
198 between the particles for the duration of the time they are in contact.
199 This term is controlled by the <a class="reference internal" href="Section_gran_models.html"><em>tangential model</em></a> in action
200 Keyword <em>tangential_damping</em> can be used to eliminate the second part of the force in
201 tangential direction. The way how the Coulomb friction limit acts is also controlled
202 by the <a class="reference internal" href="Section_gran_models.html"><em>tangential model</em></a> chosen by the user.</p>
203 <p>The quantities in the equations are as follows:</p>
204 <ul class="simple">
205 <li>delta_n = d - r = overlap distance of 2 particles</li>
206 <li>k_n = elastic constant for normal contact</li>
207 <li>k_t = elastic constant for tangential contact</li>
208 <li>gamma_n = viscoelastic damping constant for normal contact</li>
209 <li>gamma_t = viscoelastic damping constant for tangential contact</li>
210 <li>delta_t = tangential displacement vector between 2 spherical particles which is truncated to satisfy a frictional yield criterion</li>
211 <li>rmu = coefficient of rolling friction</li>
212 <li>contactradius = contact radius, equal to particle radius - 0.5 * delta_n</li>
213 <li>v_n = normal component of the relative velocity of the 2 particles</li>
214 <li>v_t = tangential component of the relative velocity of the 2 particles</li>
215 <li>w_r = relative rotational velocity of the 2 particles</li>
216 </ul>
217 <p>For hertz/stiffness the coefficients used for the force calculation are non-linear, thus they are linked to the specified values by:</p>
218 <div class="highlight-python"><div class="highlight"><pre>k_n = k_n_specified sqrt( delta_n R*)
219 k_t = k_t_specified sqrt( delta_n R*)
220 gamma_n = gamma_n_specified M* sqrt( delta_n R*)
221 gamma_t = gamma_t_specified M* sqrt( delta_n R*)
222 </pre></div>
223 </div>
224 <p>Where R* and M* are the effective radius and mass respectively.</p>
225 <p>To define those k_n_specified, k_t_specified, gamma_n_specified, and gamma_t_specified coefficients
226 (material properties), it is mandatory to use multiple <a class="reference internal" href="fix_property.html"><em>fix property/global</em></a> commands:</p>
227 <div class="highlight-python"><div class="highlight"><pre>fix id all property/global kn peratomtypepair n_atomtypes value_11 value_12 .. value_21 value_22 .. .
228 (value_ij=value for k_n between atom type i and j; n_atomtypes is the number of atom types you want to use in your simulation)
229 fix id all property/global kt peratomtypepair n_atomtypes value_11 value_12 .. value_21 value_22 .. .
230 (value_ij=value for k_t between atom type i and j; n_atomtypes is the number of atom types you want to use in your simulation)
231 fix id all property/global gamman peratomtypepair n_atomtypes value_11 value_12 .. value_21 value_22 .. .
232 (value_ij=value for gamma_n between atom type i and j; n_atomtypes is the number of atom types you want to use in your simulation)
233 fix id all property/global gammat peratomtypepair n_atomtypes value_11 value_12 .. value_21 value_22 .. .
234 (value_ij=value for gamma_t between atom type i and j; n_atomtypes is the number of atom types you want to use in your simulation)
235 </pre></div>
236 </div>
237 <div class="admonition warning">
238 <p class="first admonition-title">Warning</p>
239 <p class="last">You have to use atom styles beginning from 1, e.g. 1,2,3,...</p>
240 </div>
241 <p><strong>Force Limiting:</strong></p>
242 <p>Note, that not using limitForce might lead to attractive forces between particles and walls, especially in
243 case the coefficient of restitution is small. Be sure you include this key word for the pair style and the
244 wall model if you like to avoid this.</p>
245 </div>
246 <div class="section" id="restrictions">
247 <h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
248 <p>If using SI units, youngsModulus must be &gt; 5e6
249 If using CGS units, youngsModulus must be &gt; 5e5
250 When using the limitForce, the specified coefficient of restitution is only approximate. This might become
251 problematic for low coefficients of resitution as showin in Schwager and Poschel.</p>
252 <p><strong>Coarse-graining information:</strong></p>
253 <p>Using <code class="xref doc docutils literal"><span class="pre">coarsegraining</span></code> in
254 combination with this command might lead to
255 different dynamics or system state and thus to
256 inconsistancies.</p>
257 <div class="admonition note">
258 <p class="first admonition-title">Note</p>
259 <p class="last"><code class="xref doc docutils literal"><span class="pre">Coarsegraining</span></code> may or
260 may not be available in LIGGGHTS(R)-PUBLIC.</p>
261 </div>
262 </div>
263 <div class="section" id="default">
264 <h2>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h2>
265 <p><em>tangential_damping</em> = &#8216;on&#8217;
266 <em>limitForce</em> = &#8216;off&#8217;</p>
267 <p><strong>(Di Renzo)</strong> Alberto Di Renzo, Francesco Paolo Di Maio, CES, 59 (3), p 525-541 (2004).</p>
268 <p><strong>(Ai)</strong> Jun Ai, Jian-Fei Chen, J. Michael Rotter, Jin Y. Ooi, Powder Technology, 206 (3), p 269-282 (2011).</p>
269 <p><strong>(Brilliantov)</strong> Brilliantov, Spahn, Hertzsch, Poschel, Phys Rev E, 53, p 5382-5392 (1996).</p>
270 <p><strong>(Schwager)</strong> Schwager, Poschel, Gran Matt, 9, p 465-469 (2007).</p>
271 <p><strong>(Silbert)</strong> Silbert, Ertas, Grest, Halsey, Levine, Plimpton, Phys Rev E, 64, p 051302 (2001).</p>
272 <p><strong>(Zhang)</strong> Zhang and Makse, Phys Rev E, 72, p 011301 (2005).</p>
273 </div>
274 </div>
275
276
277 </div>
278 <div class="articleComments">
279
280 </div>
281 </div>
282 <footer>
283
284
285 <hr/>
286
287 <div role="contentinfo">
288 <p>
289 &copy; Copyright 2016, DCS Computing GmbH, JKU Linz and Sandia Corporation.
290
291 </p>
292 </div>
293 Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
294
295 </footer>
296
297 </div>
298 </div>
299
300 </section>
301
302 </div>
303
304
305
306
307
308 <script type="text/javascript">
309 var DOCUMENTATION_OPTIONS = {
310 URL_ROOT:'./',
311 VERSION:'v3.X',
312 LANGUAGE:'None',
313 COLLAPSE_INDEX:false,
314 FILE_SUFFIX:'.html',
315 HAS_SOURCE: true,
316 SOURCELINK_SUFFIX: ''
317 };
318 </script>
319 <script type="text/javascript" src="_static/jquery.js"></script>
320 <script type="text/javascript" src="_static/underscore.js"></script>
321 <script type="text/javascript" src="_static/doctools.js"></script>
322
323
324
325
326
327 <script type="text/javascript" src="_static/js/theme.js"></script>
328
329
330
331
332 <script type="text/javascript">
333 jQuery(function () {
334 SphinxRtdTheme.StickyNav.enable();
335 });
336 </script>
337
338
339 </body>
340 </html>