← Back to branch summary

~liggghts-dev/+junk/liggghts-dev

« back to all changes in this revision

Viewing changes to doc/fix_insert.html

  • Committer: Anton Gladky
  • Date: 2011-12-03 07:21:52 UTC
  • Revision ID: gladky.anton@gmail.com-20111203072152-kuse4ike0ac0g8fx
New upstream version

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/fix_insert.html
48
48
  <I>insert_every</I> value = once or ie
49
49
    once = value to signalise that isertion takes place only once (the step after the fix is issued)
50
50
    ie = every how many time-steps particles are inserted - insertion happens periodically (positive integer)
 
51
  <I>start</I> value = ts
 
52
    ts = time-step at which insertion should start (positive integer larger than current time-step)
51
53
  <I>overlapcheck</I> value = yes or no
52
54
  <I>all_in</I> value = yes or no
53
55
  <I>vel</I> values = vx vy vz
77
79
<PRE>  <I>insertion_face</I> value = mesh-ID
78
80
    mesh-ID = ID of the <A HREF = "fix_mesh_gran.html">fix mesh/gran</A> to use as starting face for particle generation
79
81
  <I>extrude_length</I> values = L
80
 
    L =  length for extruding the insertion face in normal direction so to generate in insertion volume 
 
82
    L =  length for extruding the insertion face in normal direction so to generate in insertion volume
 
83
  <I>duration</I> values = du
 
84
    du =  duration of insertion in time-steps 
81
85
</PRE>
82
86
 
83
87
</UL>
99
103
<P>To specify the numbe of particles to be inserted, you must use either
100
104
the <I>nparticles</I> or the <I>mass</I> keyword (but not both). In the latter
101
105
case, the number of particles to be inserted is calculated from the
102
 
mass expectancy given by the particle distribution. 
 
106
mass expectancy given by the particle distribution. The <I>start</I> keyword
 
107
can be used to set the time-step at which the insertion should start,
103
108
</P>
104
109
<P>Likewise, you can use the <I>particlerate</I> or the <I>massrate</I> keyword (but not both) 
105
110
to control the insertion rate. Particles are not inserted continuously,
162
167
the insertion volume so as to mimic a stream of poured particles. The 
163
168
insertion volume is generated by extruding the insertion face as 
164
169
specified via <I>insertion_face</I> in the direction of the face normal.
165
 
The amount of extrusion is either specified directly by <I>extrude_length</I>
166
 
or calculated from the insertion frequency (keyword <I>insert_every</I>).
 
170
</P>
 
171
<P>The amount of extrusion is either calculated from the insertion frequency 
 
172
(keyword <I>insert_every</I>) or specified directly via keyword <I>extrude_length</I>.
 
173
In case the former case, you have the possibility to define the duration
 
174
of each insertion via the <I>duration</I> keyword. <I>duration</I> < <I>insert_every</I>
 
175
will generate a "pulsed" stream as opposed to a continuous stream.
 
176
Example: Setting <I>insert_every</I> = 1000 and <I>duration</I> = 600 will produce
 
177
a stream that pour material for 600 time-steps, will pause for 400 time-steps,
 
178
pour for another 600 time-steps etc. 
 
179
<I>duration</I> and <I>extrude_length</I> cannot be used together.
167
180
</P>
168
181
<P>Particles are inserted again after enough time has elapsed
169
182
that the previously inserted particles have left the insertion
204
217
want to generate large systems, you are advised to turn <I>overlapcheck</I> 
205
218
off and let the packing relax afterwards to generate a valid packing.
206
219
</P>
 
220
<P>Keywords <I>duration</I> and <I>extrude_length</I> can not be used together.
 
221
</P>
207
222
<P>Currently <I>all_in yes</I> is not yet supported for all types of insertion.
208
223
</P>
209
224
<P><B>Related commands:</B>
214
229
<P><B>Default:</B>
215
230
</P>
216
231
<P>The defaults are maxattempt = 50, all_in = no, overlapcheck = yes
217
 
vel = 0.0 0.0 0.0, omega = 0.0 0.0 0.0.
 
232
vel = 0.0 0.0 0.0, omega = 0.0 0.0 0.0, start = next time-step,
 
233
duration = insert_every
218
234
</P>
219
235
<P>For fix insert/pack, defaults are ntry_mc = 100000
220
236
</P>