git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@14509 f3b2605a-c512-4ea7-a41b-209d697bcdaa
This commit is contained in:
@ -155,7 +155,7 @@ angle_coeff 1 300.0 107.0 50.0 3.0
|
|||||||
<p>with an additional Urey_Bradley term based on the distance <em>r</em> between
|
<p>with an additional Urey_Bradley term based on the distance <em>r</em> between
|
||||||
the 1st and 3rd atoms in the angle. K, theta0, Kub, and Rub are
|
the 1st and 3rd atoms in the angle. K, theta0, Kub, and Rub are
|
||||||
coefficients defined for each angle type.</p>
|
coefficients defined for each angle type.</p>
|
||||||
<p>See <a class="reference internal" href="dihedral_charmm.html#mackerell"><span>(MacKerell)</span></a> for a description of the CHARMM force
|
<p>See <a class="reference internal" href="special_bonds.html#mackerell"><span>(MacKerell)</span></a> for a description of the CHARMM force
|
||||||
field.</p>
|
field.</p>
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
<p>The following coefficients must be defined for each angle type via the
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a> command as in the example above, or in
|
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a> command as in the example above, or in
|
||||||
|
|||||||
@ -152,9 +152,9 @@ dihedral_coeff 1 120.0 1 60 0.5
|
|||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
||||||
<p>The <em>charmm</em> dihedral style uses the potential</p>
|
<p>The <em>charmm</em> dihedral style uses the potential</p>
|
||||||
<img alt="_images/dihedral_charmm.jpg" class="align-center" src="_images/dihedral_charmm.jpg" />
|
<img alt="_images/dihedral_charmm.jpg" class="align-center" src="_images/dihedral_charmm.jpg" />
|
||||||
<p>See <a class="reference internal" href="#mackerell"><span>(MacKerell)</span></a> for a description of the CHARMM force
|
<p>See <a class="reference internal" href="special_bonds.html#mackerell"><span>(MacKerell)</span></a> for a description of the CHARMM force
|
||||||
field. This dihedral style can also be used for the AMBER force field
|
field. This dihedral style can also be used for the AMBER force field
|
||||||
(see comment on weighting factors below). See <a class="reference internal" href="#cornell"><span>(Cornell)</span></a>
|
(see comment on weighting factors below). See <a class="reference internal" href="special_bonds.html#cornell"><span>(Cornell)</span></a>
|
||||||
for a description of the AMBER force field.</p>
|
for a description of the AMBER force field.</p>
|
||||||
<p>The following coefficients must be defined for each dihedral type via the
|
<p>The following coefficients must be defined for each dihedral type via the
|
||||||
<a class="reference internal" href="dihedral_coeff.html"><em>dihedral_coeff</em></a> command as in the example above, or in
|
<a class="reference internal" href="dihedral_coeff.html"><em>dihedral_coeff</em></a> command as in the example above, or in
|
||||||
|
|||||||
@ -155,8 +155,10 @@
|
|||||||
<em>line</em> = color width
|
<em>line</em> = color width
|
||||||
color = <em>type</em>
|
color = <em>type</em>
|
||||||
width = numeric value for line width (distance units)
|
width = numeric value for line width (distance units)
|
||||||
<em>tri</em> = color
|
<em>tri</em> = color tflag width
|
||||||
color = <em>type</em>
|
color = <em>type</em>
|
||||||
|
tflag = 1 for just triangle, 2 for just tri edges, 3 for both
|
||||||
|
width = numeric value for tringle edge width (distance units)
|
||||||
<em>body</em> = color bflag1 bflag2
|
<em>body</em> = color bflag1 bflag2
|
||||||
color = <em>type</em>
|
color = <em>type</em>
|
||||||
bflag1,bflag2 = 2 numeric flags to affect how bodies are drawn
|
bflag1,bflag2 = 2 numeric flags to affect how bodies are drawn
|
||||||
@ -421,12 +423,14 @@ lines will be drawn as cylinders with that diameter, e.g. 1.0, which
|
|||||||
is in whatever distance <a class="reference internal" href="units.html"><em>units</em></a> the input script defines,
|
is in whatever distance <a class="reference internal" href="units.html"><em>units</em></a> the input script defines,
|
||||||
e.g. Angstroms.</p>
|
e.g. Angstroms.</p>
|
||||||
<p>The <em>tri</em> keyword can be used when <a class="reference internal" href="atom_style.html"><em>atom_style tri</em></a> is
|
<p>The <em>tri</em> keyword can be used when <a class="reference internal" href="atom_style.html"><em>atom_style tri</em></a> is
|
||||||
used to define particles as triangles, and will draw them as
|
used to define particles as triangles, and will draw them as triangles
|
||||||
triangles. If this keyword is not used, such particles will be drawn
|
or edges (3 lines) or both, depending on the setting for <em>tflag</em>. If
|
||||||
as spheres, the same as if they were regular atoms. The only setting
|
edges are drawn, the <em>width</em> setting determines the diameters of the
|
||||||
currently allowed for the <em>color</em> value is <em>type</em>, which will color
|
line segments. If this keyword is not used, triangle particles will
|
||||||
the triangles according to the atom type of the particle. By default
|
be drawn as spheres, the same as if they were regular atoms. The only
|
||||||
the mapping of types to colors is as follows:</p>
|
setting currently allowed for the <em>color</em> value is <em>type</em>, which will
|
||||||
|
color the triangles according to the atom type of the particle. By
|
||||||
|
default the mapping of types to colors is as follows:</p>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li>type 1 = red</li>
|
<li>type 1 = red</li>
|
||||||
<li>type 2 = green</li>
|
<li>type 2 = green</li>
|
||||||
|
|||||||
@ -31,8 +31,10 @@ keyword = {atom} or {adiam} or {bond} or {line} or {tri} or {body} or {size} or
|
|||||||
{line} = color width
|
{line} = color width
|
||||||
color = {type}
|
color = {type}
|
||||||
width = numeric value for line width (distance units)
|
width = numeric value for line width (distance units)
|
||||||
{tri} = color
|
{tri} = color tflag width
|
||||||
color = {type}
|
color = {type}
|
||||||
|
tflag = 1 for just triangle, 2 for just tri edges, 3 for both
|
||||||
|
width = numeric value for tringle edge width (distance units)
|
||||||
{body} = color bflag1 bflag2
|
{body} = color bflag1 bflag2
|
||||||
color = {type}
|
color = {type}
|
||||||
bflag1,bflag2 = 2 numeric flags to affect how bodies are drawn
|
bflag1,bflag2 = 2 numeric flags to affect how bodies are drawn
|
||||||
@ -317,12 +319,14 @@ is in whatever distance "units"_units.html the input script defines,
|
|||||||
e.g. Angstroms.
|
e.g. Angstroms.
|
||||||
|
|
||||||
The {tri} keyword can be used when "atom_style tri"_atom_style.html is
|
The {tri} keyword can be used when "atom_style tri"_atom_style.html is
|
||||||
used to define particles as triangles, and will draw them as
|
used to define particles as triangles, and will draw them as triangles
|
||||||
triangles. If this keyword is not used, such particles will be drawn
|
or edges (3 lines) or both, depending on the setting for {tflag}. If
|
||||||
as spheres, the same as if they were regular atoms. The only setting
|
edges are drawn, the {width} setting determines the diameters of the
|
||||||
currently allowed for the {color} value is {type}, which will color
|
line segments. If this keyword is not used, triangle particles will
|
||||||
the triangles according to the atom type of the particle. By default
|
be drawn as spheres, the same as if they were regular atoms. The only
|
||||||
the mapping of types to colors is as follows:
|
setting currently allowed for the {color} value is {type}, which will
|
||||||
|
color the triangles according to the atom type of the particle. By
|
||||||
|
default the mapping of types to colors is as follows:
|
||||||
|
|
||||||
type 1 = red
|
type 1 = red
|
||||||
type 2 = green
|
type 2 = green
|
||||||
|
|||||||
@ -134,11 +134,11 @@
|
|||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="fix.html"><em>fix</em></a> command</li>
|
<li>ID, group-ID are documented in <a class="reference internal" href="fix.html"><em>fix</em></a> command</li>
|
||||||
<li>pour = style name of this fix command</li>
|
<li>pour = style name of this fix command</li>
|
||||||
<li>N = # of atoms to insert</li>
|
<li>N = # of particles to insert</li>
|
||||||
<li>type = atom type to assign to inserted atoms (offset for molecule insertion)</li>
|
<li>type = atom type to assign to inserted particles (offset for molecule insertion)</li>
|
||||||
<li>seed = random # seed (positive integer)</li>
|
<li>seed = random # seed (positive integer)</li>
|
||||||
<li>one or more keyword/value pairs may be appended to args</li>
|
<li>one or more keyword/value pairs may be appended to args</li>
|
||||||
<li>keyword = <em>region</em> or <em>diam</em> or <em>dens</em> or <em>vol</em> or <em>rate</em> or <em>vel</em> or <em>mol</em> or <em>rigid</em> or <em>shake</em></li>
|
<li>keyword = <em>region</em> or <em>diam</em> or <em>vol</em> or <em>rate</em> or <em>dens</em> or <em>vel</em> or <em>mol</em> or <em>rigid</em> or <em>shake</em> or <em>ignore</em></li>
|
||||||
</ul>
|
</ul>
|
||||||
<pre class="literal-block">
|
<pre class="literal-block">
|
||||||
<em>region</em> value = region-ID
|
<em>region</em> value = region-ID
|
||||||
@ -153,12 +153,16 @@
|
|||||||
Npoly = # of (D,P) pairs
|
Npoly = # of (D,P) pairs
|
||||||
D1,D2,... = diameter for subset of inserted particles (distance units)
|
D1,D2,... = diameter for subset of inserted particles (distance units)
|
||||||
P1,P2,... = percentage of inserted particles with this diameter (0-1)
|
P1,P2,... = percentage of inserted particles with this diameter (0-1)
|
||||||
|
<em>id</em> values = idflag
|
||||||
|
idflag = <em>max</em> or <em>next</em> = how to choose IDs for inserted particles and molecules
|
||||||
<em>vol</em> values = fraction Nattempt
|
<em>vol</em> values = fraction Nattempt
|
||||||
fraction = desired volume fraction for filling insertion volume
|
fraction = desired volume fraction for filling insertion volume
|
||||||
Nattempt = max # of insertion attempts per atom
|
Nattempt = max # of insertion attempts per particle
|
||||||
<em>rate</em> value = V
|
<em>rate</em> value = V
|
||||||
V = z velocity (3d) or y velocity (2d) at which
|
V = z velocity (3d) or y velocity (2d) at which
|
||||||
insertion volume moves (velocity units)
|
insertion volume moves (velocity units)
|
||||||
|
<em>dens</em> values = Rholo Rhohi
|
||||||
|
Rholo,Rhohi = range of densities for inserted particles (mass/volume units)
|
||||||
<em>vel</em> values (3d) = vxlo vxhi vylo vyhi vz
|
<em>vel</em> values (3d) = vxlo vxhi vylo vyhi vz
|
||||||
<em>vel</em> values (2d) = vxlo vxhi vy
|
<em>vel</em> values (2d) = vxlo vxhi vy
|
||||||
vxlo,vxhi = range of x velocities for inserted particles (velocity units)
|
vxlo,vxhi = range of x velocities for inserted particles (velocity units)
|
||||||
@ -173,6 +177,9 @@
|
|||||||
fix-ID = ID of <a class="reference internal" href="fix_rigid.html"><em>fix rigid/small</em></a> command
|
fix-ID = ID of <a class="reference internal" href="fix_rigid.html"><em>fix rigid/small</em></a> command
|
||||||
<em>shake</em> value = fix-ID
|
<em>shake</em> value = fix-ID
|
||||||
fix-ID = ID of <a class="reference internal" href="fix_shake.html"><em>fix shake</em></a> command
|
fix-ID = ID of <a class="reference internal" href="fix_shake.html"><em>fix shake</em></a> command
|
||||||
|
<em>ignore</em> value = none
|
||||||
|
skip any line or triangle particles when detecting possible
|
||||||
|
overlaps with inserted particles
|
||||||
</pre>
|
</pre>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="examples">
|
<div class="section" id="examples">
|
||||||
@ -242,6 +249,14 @@ timestep. Particles are inserted again after enough time has elapsed
|
|||||||
that the previously inserted particles fall out of the insertion
|
that the previously inserted particles fall out of the insertion
|
||||||
volume under the influence of gravity. Insertions continue every so
|
volume under the influence of gravity. Insertions continue every so
|
||||||
many timesteps until the desired # of particles has been inserted.</p>
|
many timesteps until the desired # of particles has been inserted.</p>
|
||||||
|
<div class="admonition note">
|
||||||
|
<p class="first admonition-title">Note</p>
|
||||||
|
<p class="last">If you are monitoring the temperature of a system where the
|
||||||
|
particle count is changing due to adding particles, you typically
|
||||||
|
should use the <a class="reference internal" href="compute_modify.html"><em>compute_modify dynamic yes</em></a>
|
||||||
|
command for the temperature compute you are using.</p>
|
||||||
|
</div>
|
||||||
|
<hr class="docutils" />
|
||||||
<p>All other keywords are optional with defaults as shown below.</p>
|
<p>All other keywords are optional with defaults as shown below.</p>
|
||||||
<p>The <em>diam</em> option is only used when inserting atoms and specifes the
|
<p>The <em>diam</em> option is only used when inserting atoms and specifes the
|
||||||
diameters of inserted particles. There are 3 styles: <em>one</em>, <em>range</em>,
|
diameters of inserted particles. There are 3 styles: <em>one</em>, <em>range</em>,
|
||||||
@ -257,11 +272,17 @@ or 1.5. 40% of the particles will be small; 60% will be large.</p>
|
|||||||
the molecule can be specified in the file read by the
|
the molecule can be specified in the file read by the
|
||||||
<a class="reference internal" href="molecule.html"><em>molecule</em></a> command. If not specified, the diameter of
|
<a class="reference internal" href="molecule.html"><em>molecule</em></a> command. If not specified, the diameter of
|
||||||
each atom in the molecule has a default diameter of 1.0.</p>
|
each atom in the molecule has a default diameter of 1.0.</p>
|
||||||
<p>The <em>dens</em> and <em>vel</em> options enable inserted particles to have a range
|
<p>The <em>id</em> option has two settings which are used to determine the atom
|
||||||
of densities or xy velocities. The specific values for a particular
|
or molecule IDs to assign to inserted particles/molecules. In both
|
||||||
inserted particle will be chosen randomly and uniformly between the
|
cases a check is done of the current system to find the maximum
|
||||||
specified bounds. The <em>vz</em> or <em>vy</em> value for option <em>vel</em> assigns a
|
current atom and molecule ID of any existing particle. Newly inserted
|
||||||
z-velocity (3d) or y-velocity (2d) to each inserted particle.</p>
|
particles and molecules are assigned IDs that increment those max
|
||||||
|
values. For the <em>max</em> setting, which is the default, this check is
|
||||||
|
done at every insertion step, which allows for particles to leave the
|
||||||
|
system, and their IDs to potentially be re-used. For the <em>next</em>
|
||||||
|
setting this check is done only once when the fix is specified, which
|
||||||
|
can be more efficient if you are sure particles will not be added in
|
||||||
|
some other way.</p>
|
||||||
<p>The <em>vol</em> option specifies what volume fraction of the insertion
|
<p>The <em>vol</em> option specifies what volume fraction of the insertion
|
||||||
volume will be filled with particles. For particles with a size
|
volume will be filled with particles. For particles with a size
|
||||||
specified by the <em>diam range</em> keyword, they are assumed to all be of
|
specified by the <em>diam range</em> keyword, they are assumed to all be of
|
||||||
@ -274,16 +295,27 @@ particles are inserted, LAMMPS will make up to a total of M tries to
|
|||||||
insert the new particles without overlaps, where M = # of inserted
|
insert the new particles without overlaps, where M = # of inserted
|
||||||
particles * Nattempt. If LAMMPS is unsuccessful at completing all
|
particles * Nattempt. If LAMMPS is unsuccessful at completing all
|
||||||
insertions, it prints a warning.</p>
|
insertions, it prints a warning.</p>
|
||||||
|
<p>The <em>dens</em> and <em>vel</em> options enable inserted particles to have a range
|
||||||
|
of densities or xy velocities. The specific values for a particular
|
||||||
|
inserted particle will be chosen randomly and uniformly between the
|
||||||
|
specified bounds. Internally, the density value for a particle is
|
||||||
|
converted to a mass, based on the radius (volume) of the particle.
|
||||||
|
The <em>vz</em> or <em>vy</em> value for option <em>vel</em> assigns a z-velocity (3d) or
|
||||||
|
y-velocity (2d) to each inserted particle.</p>
|
||||||
<p>The <em>rate</em> option moves the insertion volume in the z direction (3d)
|
<p>The <em>rate</em> option moves the insertion volume in the z direction (3d)
|
||||||
or y direction (2d). This enables pouring particles from a
|
or y direction (2d). This enables pouring particles from a
|
||||||
successively higher height over time.</p>
|
successively higher height over time.</p>
|
||||||
<div class="admonition note">
|
<p>The <em>ignore</em> option is useful when running a simulation that used line
|
||||||
<p class="first admonition-title">Note</p>
|
segment (2d) or triangle (3d) particles, typically to define
|
||||||
<p class="last">If you are monitoring the temperature of a system where the
|
boundaries for spherical granular particles to interact with. See the
|
||||||
particle count is changing due to adding particles, you typically
|
<a class="reference internal" href="atom_style.html"><em>atom_style line or tri</em></a> command for details. Lines
|
||||||
should use the <a class="reference internal" href="compute_modify.html"><em>compute_modify dynamic yes</em></a>
|
and triangles store their size, and if the size is large it may
|
||||||
command for the temperature compute you are using.</p>
|
overlap (in a spherical sense) with the insertion region, even if the
|
||||||
</div>
|
line/triangle is oriented such that there is no actual overlap. This
|
||||||
|
can prevent particles from being inserted. The <em>ignore</em> keyword
|
||||||
|
causes the overlap check to skip any line or triangle particles.
|
||||||
|
Obviously you should only use it if there is in fact no overlap of the
|
||||||
|
line or triangle particles with the insertion region.</p>
|
||||||
</div>
|
</div>
|
||||||
<hr class="docutils" />
|
<hr class="docutils" />
|
||||||
<div class="section" id="restart-fix-modify-output-run-start-stop-minimize-info">
|
<div class="section" id="restart-fix-modify-output-run-start-stop-minimize-info">
|
||||||
@ -327,7 +359,8 @@ defined by the <a class="reference internal" href="region.html"><em>region</em><
|
|||||||
setting is defined. If the <em>mol</em> keyword is used, the default for
|
setting is defined. If the <em>mol</em> keyword is used, the default for
|
||||||
<em>molfrac</em> is an equal probabilities for all molecules in the template.
|
<em>molfrac</em> is an equal probabilities for all molecules in the template.
|
||||||
Additional option defaults are diam = one 1.0, dens = 1.0 1.0, vol =
|
Additional option defaults are diam = one 1.0, dens = 1.0 1.0, vol =
|
||||||
0.25 50, rate = 0.0, vel = 0.0 0.0 0.0 0.0 0.0.</p>
|
0.25 50, rate = 0.0, vel = 0.0 0.0 0.0 0.0 0.0 (for 3d), vel = 0.0 0.0 0.0
|
||||||
|
(for 2d), and id = max.</p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|||||||
@ -14,11 +14,11 @@ fix ID group-ID pour N type seed keyword values ... :pre
|
|||||||
|
|
||||||
ID, group-ID are documented in "fix"_fix.html command :ulb,l
|
ID, group-ID are documented in "fix"_fix.html command :ulb,l
|
||||||
pour = style name of this fix command :l
|
pour = style name of this fix command :l
|
||||||
N = # of atoms to insert :l
|
N = # of particles to insert :l
|
||||||
type = atom type to assign to inserted atoms (offset for molecule insertion) :l
|
type = atom type to assign to inserted particles (offset for molecule insertion) :l
|
||||||
seed = random # seed (positive integer) :l
|
seed = random # seed (positive integer) :l
|
||||||
one or more keyword/value pairs may be appended to args :l
|
one or more keyword/value pairs may be appended to args :l
|
||||||
keyword = {region} or {diam} or {dens} or {vol} or {rate} or {vel} or {mol} or {rigid} or {shake} :l
|
keyword = {region} or {diam} or {vol} or {rate} or {dens} or {vel} or {mol} or {rigid} or {shake} or {ignore} :l
|
||||||
{region} value = region-ID
|
{region} value = region-ID
|
||||||
region-ID = ID of region to use as insertion volume
|
region-ID = ID of region to use as insertion volume
|
||||||
{diam} values = dstyle args
|
{diam} values = dstyle args
|
||||||
@ -31,12 +31,16 @@ keyword = {region} or {diam} or {dens} or {vol} or {rate} or {vel} or {mol} or {
|
|||||||
Npoly = # of (D,P) pairs
|
Npoly = # of (D,P) pairs
|
||||||
D1,D2,... = diameter for subset of inserted particles (distance units)
|
D1,D2,... = diameter for subset of inserted particles (distance units)
|
||||||
P1,P2,... = percentage of inserted particles with this diameter (0-1)
|
P1,P2,... = percentage of inserted particles with this diameter (0-1)
|
||||||
|
{id} values = idflag
|
||||||
|
idflag = {max} or {next} = how to choose IDs for inserted particles and molecules
|
||||||
{vol} values = fraction Nattempt
|
{vol} values = fraction Nattempt
|
||||||
fraction = desired volume fraction for filling insertion volume
|
fraction = desired volume fraction for filling insertion volume
|
||||||
Nattempt = max # of insertion attempts per atom
|
Nattempt = max # of insertion attempts per particle
|
||||||
{rate} value = V
|
{rate} value = V
|
||||||
V = z velocity (3d) or y velocity (2d) at which
|
V = z velocity (3d) or y velocity (2d) at which
|
||||||
insertion volume moves (velocity units)
|
insertion volume moves (velocity units)
|
||||||
|
{dens} values = Rholo Rhohi
|
||||||
|
Rholo,Rhohi = range of densities for inserted particles (mass/volume units)
|
||||||
{vel} values (3d) = vxlo vxhi vylo vyhi vz
|
{vel} values (3d) = vxlo vxhi vylo vyhi vz
|
||||||
{vel} values (2d) = vxlo vxhi vy
|
{vel} values (2d) = vxlo vxhi vy
|
||||||
vxlo,vxhi = range of x velocities for inserted particles (velocity units)
|
vxlo,vxhi = range of x velocities for inserted particles (velocity units)
|
||||||
@ -50,7 +54,10 @@ keyword = {region} or {diam} or {dens} or {vol} or {rate} or {vel} or {mol} or {
|
|||||||
{rigid} value = fix-ID
|
{rigid} value = fix-ID
|
||||||
fix-ID = ID of "fix rigid/small"_fix_rigid.html command
|
fix-ID = ID of "fix rigid/small"_fix_rigid.html command
|
||||||
{shake} value = fix-ID
|
{shake} value = fix-ID
|
||||||
fix-ID = ID of "fix shake"_fix_shake.html command :pre
|
fix-ID = ID of "fix shake"_fix_shake.html command
|
||||||
|
{ignore} value = none
|
||||||
|
skip any line or triangle particles when detecting possible
|
||||||
|
overlaps with inserted particles :pre
|
||||||
:ule
|
:ule
|
||||||
|
|
||||||
[Examples:]
|
[Examples:]
|
||||||
@ -128,6 +135,13 @@ that the previously inserted particles fall out of the insertion
|
|||||||
volume under the influence of gravity. Insertions continue every so
|
volume under the influence of gravity. Insertions continue every so
|
||||||
many timesteps until the desired # of particles has been inserted.
|
many timesteps until the desired # of particles has been inserted.
|
||||||
|
|
||||||
|
NOTE: If you are monitoring the temperature of a system where the
|
||||||
|
particle count is changing due to adding particles, you typically
|
||||||
|
should use the "compute_modify dynamic yes"_compute_modify.html
|
||||||
|
command for the temperature compute you are using.
|
||||||
|
|
||||||
|
:line
|
||||||
|
|
||||||
All other keywords are optional with defaults as shown below.
|
All other keywords are optional with defaults as shown below.
|
||||||
|
|
||||||
The {diam} option is only used when inserting atoms and specifes the
|
The {diam} option is only used when inserting atoms and specifes the
|
||||||
@ -146,11 +160,17 @@ the molecule can be specified in the file read by the
|
|||||||
"molecule"_molecule.html command. If not specified, the diameter of
|
"molecule"_molecule.html command. If not specified, the diameter of
|
||||||
each atom in the molecule has a default diameter of 1.0.
|
each atom in the molecule has a default diameter of 1.0.
|
||||||
|
|
||||||
The {dens} and {vel} options enable inserted particles to have a range
|
The {id} option has two settings which are used to determine the atom
|
||||||
of densities or xy velocities. The specific values for a particular
|
or molecule IDs to assign to inserted particles/molecules. In both
|
||||||
inserted particle will be chosen randomly and uniformly between the
|
cases a check is done of the current system to find the maximum
|
||||||
specified bounds. The {vz} or {vy} value for option {vel} assigns a
|
current atom and molecule ID of any existing particle. Newly inserted
|
||||||
z-velocity (3d) or y-velocity (2d) to each inserted particle.
|
particles and molecules are assigned IDs that increment those max
|
||||||
|
values. For the {max} setting, which is the default, this check is
|
||||||
|
done at every insertion step, which allows for particles to leave the
|
||||||
|
system, and their IDs to potentially be re-used. For the {next}
|
||||||
|
setting this check is done only once when the fix is specified, which
|
||||||
|
can be more efficient if you are sure particles will not be added in
|
||||||
|
some other way.
|
||||||
|
|
||||||
The {vol} option specifies what volume fraction of the insertion
|
The {vol} option specifies what volume fraction of the insertion
|
||||||
volume will be filled with particles. For particles with a size
|
volume will be filled with particles. For particles with a size
|
||||||
@ -166,14 +186,29 @@ insert the new particles without overlaps, where M = # of inserted
|
|||||||
particles * Nattempt. If LAMMPS is unsuccessful at completing all
|
particles * Nattempt. If LAMMPS is unsuccessful at completing all
|
||||||
insertions, it prints a warning.
|
insertions, it prints a warning.
|
||||||
|
|
||||||
|
The {dens} and {vel} options enable inserted particles to have a range
|
||||||
|
of densities or xy velocities. The specific values for a particular
|
||||||
|
inserted particle will be chosen randomly and uniformly between the
|
||||||
|
specified bounds. Internally, the density value for a particle is
|
||||||
|
converted to a mass, based on the radius (volume) of the particle.
|
||||||
|
The {vz} or {vy} value for option {vel} assigns a z-velocity (3d) or
|
||||||
|
y-velocity (2d) to each inserted particle.
|
||||||
|
|
||||||
The {rate} option moves the insertion volume in the z direction (3d)
|
The {rate} option moves the insertion volume in the z direction (3d)
|
||||||
or y direction (2d). This enables pouring particles from a
|
or y direction (2d). This enables pouring particles from a
|
||||||
successively higher height over time.
|
successively higher height over time.
|
||||||
|
|
||||||
NOTE: If you are monitoring the temperature of a system where the
|
The {ignore} option is useful when running a simulation that used line
|
||||||
particle count is changing due to adding particles, you typically
|
segment (2d) or triangle (3d) particles, typically to define
|
||||||
should use the "compute_modify dynamic yes"_compute_modify.html
|
boundaries for spherical granular particles to interact with. See the
|
||||||
command for the temperature compute you are using.
|
"atom_style line or tri"_atom_style.html command for details. Lines
|
||||||
|
and triangles store their size, and if the size is large it may
|
||||||
|
overlap (in a spherical sense) with the insertion region, even if the
|
||||||
|
line/triangle is oriented such that there is no actual overlap. This
|
||||||
|
can prevent particles from being inserted. The {ignore} keyword
|
||||||
|
causes the overlap check to skip any line or triangle particles.
|
||||||
|
Obviously you should only use it if there is in fact no overlap of the
|
||||||
|
line or triangle particles with the insertion region.
|
||||||
|
|
||||||
:line
|
:line
|
||||||
|
|
||||||
@ -225,4 +260,5 @@ Insertions are performed for individual particles, i.e. no {mol}
|
|||||||
setting is defined. If the {mol} keyword is used, the default for
|
setting is defined. If the {mol} keyword is used, the default for
|
||||||
{molfrac} is an equal probabilities for all molecules in the template.
|
{molfrac} is an equal probabilities for all molecules in the template.
|
||||||
Additional option defaults are diam = one 1.0, dens = 1.0 1.0, vol =
|
Additional option defaults are diam = one 1.0, dens = 1.0 1.0, vol =
|
||||||
0.25 50, rate = 0.0, vel = 0.0 0.0 0.0 0.0 0.0.
|
0.25 50, rate = 0.0, vel = 0.0 0.0 0.0 0.0 0.0 (for 3d), vel = 0.0 0.0 0.0
|
||||||
|
(for 2d), and id = max.
|
||||||
|
|||||||
File diff suppressed because one or more lines are too long
38
doc/set.html
38
doc/set.html
@ -135,7 +135,7 @@
|
|||||||
<li>style = <em>atom</em> or <em>type</em> or <em>mol</em> or <em>group</em> or <em>region</em></li>
|
<li>style = <em>atom</em> or <em>type</em> or <em>mol</em> or <em>group</em> or <em>region</em></li>
|
||||||
<li>ID = atom ID range or type range or mol ID range or group ID or region ID</li>
|
<li>ID = atom ID range or type range or mol ID range or group ID or region ID</li>
|
||||||
<li>one or more keyword/value pairs may be appended</li>
|
<li>one or more keyword/value pairs may be appended</li>
|
||||||
<li>keyword = <em>type</em> or <em>type/fraction</em> or <em>mol</em> or <em>x</em> or <em>y</em> or <em>z</em> or <em>charge</em> or <em>dipole</em> or <em>dipole/random</em> or <em>quat</em> or <em>quat/random</em> or <em>diameter</em> or <em>shape</em> or <em>length</em> or <em>tri</em> or <em>theta</em> or <em>theta/random</em> or <em>angmom</em> or <em>omega</em> or <em>mass</em> or <em>density</em> or <em>volume</em> or <em>image</em> or <em>bond</em> or <em>angle</em> or <em>dihedral</em> or <em>improper</em> or <em>meso_e</em> or <em>meso_cv</em> or <em>meso_rho</em> or <em>smd_contact_radius</em> or <em>smd_mass_density</em> or <em>i_name</em> or <em>d_name</em></li>
|
<li>keyword = <em>type</em> or <em>type/fraction</em> or <em>mol</em> or <em>x</em> or <em>y</em> or <em>z</em> or <em>charge</em> or <em>dipole</em> or <em>dipole/random</em> or <em>quat</em> or <em>quat/random</em> or <em>diameter</em> or <em>shape</em> or <em>length</em> or <em>tri</em> or <em>theta</em> or <em>theta/random</em> or <em>angmom</em> or <em>omega</em> or <em>mass</em> or <em>density</em> or <em>volume</em> or <em>image</em> or <em>bond</em> or <em>angle</em> or <em>dihedral</em> or <em>improper</em> or <em>meso/e</em> or <em>meso/cv</em> or <em>meso/rho</em> or <em>smd/contact/radius</em> or <em>smd/mass/density</em> or <em>i_name</em> or <em>d_name</em></li>
|
||||||
</ul>
|
</ul>
|
||||||
<pre class="literal-block">
|
<pre class="literal-block">
|
||||||
<em>type</em> value = atom type
|
<em>type</em> value = atom type
|
||||||
@ -195,15 +195,15 @@
|
|||||||
<em>angle</em> value = angle type for all angles between selected atoms
|
<em>angle</em> value = angle type for all angles between selected atoms
|
||||||
<em>dihedral</em> value = dihedral type for all dihedrals between selected atoms
|
<em>dihedral</em> value = dihedral type for all dihedrals between selected atoms
|
||||||
<em>improper</em> value = improper type for all impropers between selected atoms
|
<em>improper</em> value = improper type for all impropers between selected atoms
|
||||||
<em>meso_e</em> value = energy of SPH particles (need units)
|
<em>meso/e</em> value = energy of SPH particles (need units)
|
||||||
value can be an atom-style variable (see below)
|
value can be an atom-style variable (see below)
|
||||||
<em>meso_cv</em> value = heat capacity of SPH particles (need units)
|
<em>meso/cv</em> value = heat capacity of SPH particles (need units)
|
||||||
value can be an atom-style variable (see below)
|
value can be an atom-style variable (see below)
|
||||||
<em>meso_rho</em> value = density of SPH particles (need units)
|
<em>meso/rho</em> value = density of SPH particles (need units)
|
||||||
value can be an atom-style variable (see below)
|
value can be an atom-style variable (see below)
|
||||||
<em>smd_contact_radius</em> = radius for short range interactions, i.e. contact and friction
|
<em>smd/contact/radius</em> = radius for short range interactions, i.e. contact and friction
|
||||||
value can be an atom-style variable (see below)
|
value can be an atom-style variable (see below)
|
||||||
<em>smd_mass_density</em> = set particle mass based on volume by providing a mass density
|
<em>smd/mass/density</em> = set particle mass based on volume by providing a mass density
|
||||||
value can be an atom-style variable (see below)
|
value can be an atom-style variable (see below)
|
||||||
<em>i_name</em> value = value for custom integer vector with name
|
<em>i_name</em> value = value for custom integer vector with name
|
||||||
<em>d_name</em> value = value for custom floating-point vector with name
|
<em>d_name</em> value = value for custom floating-point vector with name
|
||||||
@ -413,18 +413,6 @@ mass is set from the density and triangle area (the input density is
|
|||||||
assumed to be in mass/distance^2 units). If none of these cases are
|
assumed to be in mass/distance^2 units). If none of these cases are
|
||||||
valid, then the mass is set to the density value directly (the input
|
valid, then the mass is set to the density value directly (the input
|
||||||
density is assumed to be in mass units).</p>
|
density is assumed to be in mass units).</p>
|
||||||
<p>Keyword <em>smd_mass_density</em> also sets the mass of all selected
|
|
||||||
particles, but it is only applicable to the Smooth Mach Dynamics
|
|
||||||
package USER-SMD. This command assumes that the particle volume has
|
|
||||||
already been correctly set and calculates particle mass from the
|
|
||||||
provided mass density value.</p>
|
|
||||||
<p>Keyword <em>smd_contact_radius</em> only applies to simulations with the
|
|
||||||
Smooth Mach Dynamics package USER-SMD. This command sets an
|
|
||||||
interaction radius for computing short-range interactions,
|
|
||||||
e.g. repulsive forces to prevent different individual physical bodies
|
|
||||||
from penetrating each other. Note that the SPH smoothing kernel
|
|
||||||
diameter used for computing long range, nonlocal interactions, is set
|
|
||||||
using the <em>diameter</em> keyword.</p>
|
|
||||||
<p>Keyword <em>volume</em> sets the volume of all selected particles.
|
<p>Keyword <em>volume</em> sets the volume of all selected particles.
|
||||||
Currently, only the <a class="reference internal" href="atom_style.html"><em>atom_style peri</em></a> command defines
|
Currently, only the <a class="reference internal" href="atom_style.html"><em>atom_style peri</em></a> command defines
|
||||||
particles with a volume attribute. Note that this command does not
|
particles with a volume attribute. Note that this command does not
|
||||||
@ -458,10 +446,22 @@ order for the change to be made. The value of nbondtype (nangletypes,
|
|||||||
etc) was set by the <em>bond types</em> (<em>angle types</em>, etc) field in the
|
etc) was set by the <em>bond types</em> (<em>angle types</em>, etc) field in the
|
||||||
header of the data file read by the <a class="reference internal" href="read_data.html"><em>read_data</em></a>
|
header of the data file read by the <a class="reference internal" href="read_data.html"><em>read_data</em></a>
|
||||||
command. These keywords do not allow use of an atom-style variable.</p>
|
command. These keywords do not allow use of an atom-style variable.</p>
|
||||||
<p>Keywords <em>meso_e</em>, <em>meso_cv</em>, and <em>meso_rho</em> set the energy, heat
|
<p>Keywords <em>meso/e</em>, <em>meso/cv</em>, and <em>meso/rho</em> set the energy, heat
|
||||||
capacity, and density of smmothed particle hydrodynamics (SPH)
|
capacity, and density of smmothed particle hydrodynamics (SPH)
|
||||||
particles. See <a class="reference external" href="USER/sph/SPH_LAMMPS_userguide.pdf">this PDF guide</a> to
|
particles. See <a class="reference external" href="USER/sph/SPH_LAMMPS_userguide.pdf">this PDF guide</a> to
|
||||||
using SPH in LAMMPS.</p>
|
using SPH in LAMMPS.</p>
|
||||||
|
<p>Keyword <em>smd/mass/density</em> sets the mass of all selected particles,
|
||||||
|
but it is only applicable to the Smooth Mach Dynamics package
|
||||||
|
USER-SMD. It assumes that the particle volume has already been
|
||||||
|
correctly set and calculates particle mass from the provided mass
|
||||||
|
density value.</p>
|
||||||
|
<p>Keyword <em>smd/contact/radius</em> only applies to simulations with the
|
||||||
|
Smooth Mach Dynamics package USER-SMD. Itsets an interaction radius
|
||||||
|
for computing short-range interactions, e.g. repulsive forces to
|
||||||
|
prevent different individual physical bodies from penetrating each
|
||||||
|
other. Note that the SPH smoothing kernel diameter used for computing
|
||||||
|
long range, nonlocal interactions, is set using the <em>diameter</em>
|
||||||
|
keyword.</p>
|
||||||
<p>Keywords <em>i_name</em> and <em>d_name</em> refer to custom integer and
|
<p>Keywords <em>i_name</em> and <em>d_name</em> refer to custom integer and
|
||||||
floating-point properties that have been added to each atom via the
|
floating-point properties that have been added to each atom via the
|
||||||
<a class="reference internal" href="fix_property_atom.html"><em>fix property/atom</em></a> command. When that command
|
<a class="reference internal" href="fix_property_atom.html"><em>fix property/atom</em></a> command. When that command
|
||||||
|
|||||||
44
doc/set.txt
44
doc/set.txt
@ -22,8 +22,8 @@ keyword = {type} or {type/fraction} or {mol} or {x} or {y} or {z} or \
|
|||||||
{angmom} or {omega} or \
|
{angmom} or {omega} or \
|
||||||
{mass} or {density} or {volume} or {image} or \
|
{mass} or {density} or {volume} or {image} or \
|
||||||
{bond} or {angle} or {dihedral} or {improper} or \
|
{bond} or {angle} or {dihedral} or {improper} or \
|
||||||
{meso_e} or {meso_cv} or {meso_rho} or \
|
{meso/e} or {meso/cv} or {meso/rho} or \
|
||||||
{smd_contact_radius} or {smd_mass_density} or \
|
{smd/contact/radius} or {smd/mass/density} or \
|
||||||
{i_name} or {d_name} :l
|
{i_name} or {d_name} :l
|
||||||
{type} value = atom type
|
{type} value = atom type
|
||||||
value can be an atom-style variable (see below)
|
value can be an atom-style variable (see below)
|
||||||
@ -82,15 +82,15 @@ keyword = {type} or {type/fraction} or {mol} or {x} or {y} or {z} or \
|
|||||||
{angle} value = angle type for all angles between selected atoms
|
{angle} value = angle type for all angles between selected atoms
|
||||||
{dihedral} value = dihedral type for all dihedrals between selected atoms
|
{dihedral} value = dihedral type for all dihedrals between selected atoms
|
||||||
{improper} value = improper type for all impropers between selected atoms
|
{improper} value = improper type for all impropers between selected atoms
|
||||||
{meso_e} value = energy of SPH particles (need units)
|
{meso/e} value = energy of SPH particles (need units)
|
||||||
value can be an atom-style variable (see below)
|
value can be an atom-style variable (see below)
|
||||||
{meso_cv} value = heat capacity of SPH particles (need units)
|
{meso/cv} value = heat capacity of SPH particles (need units)
|
||||||
value can be an atom-style variable (see below)
|
value can be an atom-style variable (see below)
|
||||||
{meso_rho} value = density of SPH particles (need units)
|
{meso/rho} value = density of SPH particles (need units)
|
||||||
value can be an atom-style variable (see below)
|
value can be an atom-style variable (see below)
|
||||||
{smd_contact_radius} = radius for short range interactions, i.e. contact and friction
|
{smd/contact/radius} = radius for short range interactions, i.e. contact and friction
|
||||||
value can be an atom-style variable (see below)
|
value can be an atom-style variable (see below)
|
||||||
{smd_mass_density} = set particle mass based on volume by providing a mass density
|
{smd/mass/density} = set particle mass based on volume by providing a mass density
|
||||||
value can be an atom-style variable (see below)
|
value can be an atom-style variable (see below)
|
||||||
{i_name} value = value for custom integer vector with name
|
{i_name} value = value for custom integer vector with name
|
||||||
{d_name} value = value for custom floating-point vector with name :pre
|
{d_name} value = value for custom floating-point vector with name :pre
|
||||||
@ -333,20 +333,6 @@ assumed to be in mass/distance^2 units). If none of these cases are
|
|||||||
valid, then the mass is set to the density value directly (the input
|
valid, then the mass is set to the density value directly (the input
|
||||||
density is assumed to be in mass units).
|
density is assumed to be in mass units).
|
||||||
|
|
||||||
Keyword {smd_mass_density} also sets the mass of all selected
|
|
||||||
particles, but it is only applicable to the Smooth Mach Dynamics
|
|
||||||
package USER-SMD. This command assumes that the particle volume has
|
|
||||||
already been correctly set and calculates particle mass from the
|
|
||||||
provided mass density value.
|
|
||||||
|
|
||||||
Keyword {smd_contact_radius} only applies to simulations with the
|
|
||||||
Smooth Mach Dynamics package USER-SMD. This command sets an
|
|
||||||
interaction radius for computing short-range interactions,
|
|
||||||
e.g. repulsive forces to prevent different individual physical bodies
|
|
||||||
from penetrating each other. Note that the SPH smoothing kernel
|
|
||||||
diameter used for computing long range, nonlocal interactions, is set
|
|
||||||
using the {diameter} keyword.
|
|
||||||
|
|
||||||
Keyword {volume} sets the volume of all selected particles.
|
Keyword {volume} sets the volume of all selected particles.
|
||||||
Currently, only the "atom_style peri"_atom_style.html command defines
|
Currently, only the "atom_style peri"_atom_style.html command defines
|
||||||
particles with a volume attribute. Note that this command does not
|
particles with a volume attribute. Note that this command does not
|
||||||
@ -384,11 +370,25 @@ etc) was set by the {bond types} ({angle types}, etc) field in the
|
|||||||
header of the data file read by the "read_data"_read_data.html
|
header of the data file read by the "read_data"_read_data.html
|
||||||
command. These keywords do not allow use of an atom-style variable.
|
command. These keywords do not allow use of an atom-style variable.
|
||||||
|
|
||||||
Keywords {meso_e}, {meso_cv}, and {meso_rho} set the energy, heat
|
Keywords {meso/e}, {meso/cv}, and {meso/rho} set the energy, heat
|
||||||
capacity, and density of smmothed particle hydrodynamics (SPH)
|
capacity, and density of smmothed particle hydrodynamics (SPH)
|
||||||
particles. See "this PDF guide"_USER/sph/SPH_LAMMPS_userguide.pdf to
|
particles. See "this PDF guide"_USER/sph/SPH_LAMMPS_userguide.pdf to
|
||||||
using SPH in LAMMPS.
|
using SPH in LAMMPS.
|
||||||
|
|
||||||
|
Keyword {smd/mass/density} sets the mass of all selected particles,
|
||||||
|
but it is only applicable to the Smooth Mach Dynamics package
|
||||||
|
USER-SMD. It assumes that the particle volume has already been
|
||||||
|
correctly set and calculates particle mass from the provided mass
|
||||||
|
density value.
|
||||||
|
|
||||||
|
Keyword {smd/contact/radius} only applies to simulations with the
|
||||||
|
Smooth Mach Dynamics package USER-SMD. Itsets an interaction radius
|
||||||
|
for computing short-range interactions, e.g. repulsive forces to
|
||||||
|
prevent different individual physical bodies from penetrating each
|
||||||
|
other. Note that the SPH smoothing kernel diameter used for computing
|
||||||
|
long range, nonlocal interactions, is set using the {diameter}
|
||||||
|
keyword.
|
||||||
|
|
||||||
Keywords {i_name} and {d_name} refer to custom integer and
|
Keywords {i_name} and {d_name} refer to custom integer and
|
||||||
floating-point properties that have been added to each atom via the
|
floating-point properties that have been added to each atom via the
|
||||||
"fix property/atom"_fix_property_atom.html command. When that command
|
"fix property/atom"_fix_property_atom.html command. When that command
|
||||||
|
|||||||
Reference in New Issue
Block a user