Page Menu
Home
c4science
Search
Configure Global Search
Log In
Files
F70523708
delete_atoms.html
No One
Temporary
Actions
Download File
Edit File
Delete File
View Transforms
Subscribe
Mute Notifications
Award Token
Subscribers
None
File Metadata
Details
File Info
Storage
Attached
Created
Sun, Jul 7, 07:49
Size
13 KB
Mime Type
text/html
Expires
Tue, Jul 9, 07:49 (2 d)
Engine
blob
Format
Raw Data
Handle
18844773
Attached To
rLAMMPS lammps
delete_atoms.html
View Options
<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!-->
<html
class=
"no-js"
lang=
"en"
>
<!--<![endif]-->
<head>
<meta
charset=
"utf-8"
>
<meta
name=
"viewport"
content=
"width=device-width, initial-scale=1.0"
>
<title>
delete_atoms command
—
LAMMPS documentation
</title>
<link
rel=
"stylesheet"
href=
"_static/css/theme.css"
type=
"text/css"
/>
<link
rel=
"stylesheet"
href=
"_static/sphinxcontrib-images/LightBox2/lightbox2/css/lightbox.css"
type=
"text/css"
/>
<link
rel=
"top"
title=
"LAMMPS documentation"
href=
"index.html"
/>
<script
src=
"_static/js/modernizr.min.js"
></script>
</head>
<body
class=
"wy-body-for-nav"
role=
"document"
>
<div
class=
"wy-grid-for-nav"
>
<nav
data-toggle=
"wy-nav-shift"
class=
"wy-nav-side"
>
<div
class=
"wy-side-nav-search"
>
<a
href=
"Manual.html"
class=
"icon icon-home"
>
LAMMPS
</a>
<div
role=
"search"
>
<form
id=
"rtd-search-form"
class=
"wy-form"
action=
"search.html"
method=
"get"
>
<input
type=
"text"
name=
"q"
placeholder=
"Search docs"
/>
<input
type=
"hidden"
name=
"check_keywords"
value=
"yes"
/>
<input
type=
"hidden"
name=
"area"
value=
"default"
/>
</form>
</div>
</div>
<div
class=
"wy-menu wy-menu-vertical"
data-spy=
"affix"
role=
"navigation"
aria-label=
"main navigation"
>
<ul>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_intro.html"
>
1. Introduction
</a></li>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_start.html"
>
2. Getting Started
</a></li>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_commands.html"
>
3. Commands
</a></li>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_packages.html"
>
4. Packages
</a></li>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_accelerate.html"
>
5. Accelerating LAMMPS performance
</a></li>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_howto.html"
>
6. How-to discussions
</a></li>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_example.html"
>
7. Example problems
</a></li>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_perf.html"
>
8. Performance
&
scalability
</a></li>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_tools.html"
>
9. Additional tools
</a></li>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_modify.html"
>
10. Modifying
&
extending LAMMPS
</a></li>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_python.html"
>
11. Python interface to LAMMPS
</a></li>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_errors.html"
>
12. Errors
</a></li>
<li
class=
"toctree-l1"
><a
class=
"reference internal"
href=
"Section_history.html"
>
13. Future and history
</a></li>
</ul>
</div>
</nav>
<section
data-toggle=
"wy-nav-shift"
class=
"wy-nav-content-wrap"
>
<nav
class=
"wy-nav-top"
role=
"navigation"
aria-label=
"top navigation"
>
<i
data-toggle=
"wy-nav-top"
class=
"fa fa-bars"
></i>
<a
href=
"Manual.html"
>
LAMMPS
</a>
</nav>
<div
class=
"wy-nav-content"
>
<div
class=
"rst-content"
>
<div
role=
"navigation"
aria-label=
"breadcrumbs navigation"
>
<ul
class=
"wy-breadcrumbs"
>
<li><a
href=
"Manual.html"
>
Docs
</a>
»
</li>
<li>
delete_atoms command
</li>
<li
class=
"wy-breadcrumbs-aside"
>
<a
href=
"http://lammps.sandia.gov"
>
Website
</a>
<a
href=
"Section_commands.html#comm"
>
Commands
</a>
</li>
</ul>
<hr/>
</div>
<div
role=
"main"
class=
"document"
itemscope=
"itemscope"
itemtype=
"http://schema.org/Article"
>
<div
itemprop=
"articleBody"
>
<div
class=
"section"
id=
"delete-atoms-command"
>
<span
id=
"index-0"
></span><h1>
delete_atoms command
</h1>
<div
class=
"section"
id=
"syntax"
>
<h2>
Syntax
</h2>
<div
class=
"highlight-default"
><div
class=
"highlight"
><pre><span></span><span
class=
"n"
>
delete_atoms
</span>
<span
class=
"n"
>
style
</span>
<span
class=
"n"
>
args
</span>
<span
class=
"n"
>
keyword
</span>
<span
class=
"n"
>
value
</span>
<span
class=
"o"
>
...
</span>
</pre></div>
</div>
<ul
class=
"simple"
>
<li>
style =
<em>
group
</em>
or
<em>
region
</em>
or
<em>
overlap
</em>
or
<em>
porosity
</em></li>
</ul>
<pre
class=
"literal-block"
>
<em>
group
</em>
args = group-ID
<em>
region
</em>
args = region-ID
<em>
overlap
</em>
args = cutoff group1-ID group2-ID
cutoff = delete one atom from pairs of atoms within the cutoff (distance units)
group1-ID = one atom in pair must be in this group
group2-ID = other atom in pair must be in this group
<em>
porosity
</em>
args = region-ID fraction seed
region-ID = region within which to perform deletions
fraction = delete this fraction of atoms
seed = random number seed (positive integer)
</pre>
<ul
class=
"simple"
>
<li>
zero or more keyword/value pairs may be appended
</li>
<li>
keyword =
<em>
compress
</em>
or
<em>
bond
</em>
or
<em>
mol
</em></li>
</ul>
<pre
class=
"literal-block"
>
<em>
compress
</em>
value =
<em>
no
</em>
or
<em>
yes
</em>
<em>
bond
</em>
value =
<em>
no
</em>
or
<em>
yes
</em>
<em>
mol
</em>
value =
<em>
no
</em>
or
<em>
yes
</em>
</pre>
</div>
<div
class=
"section"
id=
"examples"
>
<h2>
Examples
</h2>
<div
class=
"highlight-default"
><div
class=
"highlight"
><pre><span></span><span
class=
"n"
>
delete_atoms
</span>
<span
class=
"n"
>
group
</span>
<span
class=
"n"
>
edge
</span>
<span
class=
"n"
>
delete_atoms
</span>
<span
class=
"n"
>
region
</span>
<span
class=
"n"
>
sphere
</span>
<span
class=
"n"
>
compress
</span>
<span
class=
"n"
>
no
</span>
<span
class=
"n"
>
delete_atoms
</span>
<span
class=
"n"
>
overlap
</span>
<span
class=
"mf"
>
0.3
</span>
<span
class=
"nb"
>
all
</span>
<span
class=
"nb"
>
all
</span>
<span
class=
"n"
>
delete_atoms
</span>
<span
class=
"n"
>
overlap
</span>
<span
class=
"mf"
>
0.5
</span>
<span
class=
"n"
>
solvent
</span>
<span
class=
"n"
>
colloid
</span>
<span
class=
"n"
>
delete_atoms
</span>
<span
class=
"n"
>
porosity
</span>
<span
class=
"n"
>
cube
</span>
<span
class=
"mf"
>
0.1
</span>
<span
class=
"mi"
>
482793
</span>
<span
class=
"n"
>
bond
</span>
<span
class=
"n"
>
yes
</span>
</pre></div>
</div>
</div>
<div
class=
"section"
id=
"description"
>
<h2>
Description
</h2>
<p>
Delete the specified atoms. This command can be used to carve out
voids from a block of material or to delete created atoms that are too
close to each other (e.g. at a grain boundary).
</p>
<p>
For style
<em>
group
</em>
, all atoms belonging to the group are deleted.
</p>
<p>
For style
<em>
region
</em>
, all atoms in the region volume are deleted.
Additional atoms can be deleted if they are in a molecule for which
one or more atoms were deleted within the region; see the
<em>
mol
</em>
keyword discussion below.
</p>
<p>
For style
<em>
overlap
</em>
pairs of atoms whose distance of separation is
within the specified cutoff distance are searched for, and one of the
2 atoms is deleted. Only pairs where one of the two atoms is in the
first group specified and the other atom is in the second group are
considered. The atom that is in the first group is the one that is
deleted.
</p>
<p>
Note that it is OK for the two group IDs to be the same (e.g. group
<em>
all
</em>
), or for some atoms to be members of both groups. In these
cases, either atom in the pair may be deleted. Also note that if
there are atoms which are members of both groups, the only guarantee
is that at the end of the deletion operation, enough deletions will
have occurred that no atom pairs within the cutoff will remain
(subject to the group restriction). There is no guarantee that the
minimum number of atoms will be deleted, or that the same atoms will
be deleted when running on different numbers of processors.
</p>
<p>
For style
<em>
porosity
</em>
a specified
<em>
fraction
</em>
of atoms are deleted
within the specified region. For example, if fraction is 0.1, then
10% of the atoms will be deleted. The atoms to delete are chosen
randomly. There is no guarantee that the exact fraction of atoms will
be deleted, or that the same atoms will be deleted when running on
different numbers of processors.
</p>
<p>
If the
<em>
compress
</em>
keyword is set to
<em>
yes
</em>
, then after atoms are
deleted, then atom IDs are re-assigned so that they run from 1 to the
number of atoms in the system. Note that this is not done for
molecular systems (see the
<a
class=
"reference internal"
href=
"atom_style.html"
><span
class=
"doc"
>
atom_style
</span></a>
command),
regardless of the
<em>
compress
</em>
setting, since it would foul up the bond
connectivity that has already been assigned.
</p>
<p>
A molecular system with fixed bonds, angles, dihedrals, or improper
interactions, is one where the topology of the interactions is
typically defined in the data file read by the
<a
class=
"reference internal"
href=
"read_data.html"
><span
class=
"doc"
>
read_data
</span></a>
command, and where the interactions
themselves are defined with the
<a
class=
"reference internal"
href=
"bond_style.html"
><span
class=
"doc"
>
bond_style
</span></a>
,
<a
class=
"reference internal"
href=
"angle_style.html"
><span
class=
"doc"
>
angle_style
</span></a>
, etc commands. If you delete atoms
from such a system, you must be careful not to end up with bonded
interactions that are stored by remaining atoms but which include
deleted atoms. This will cause LAMMPS to generate a
“
missing atoms
”
error when the bonded interaction is computed. The
<em>
bond
</em>
and
<em>
mol
</em>
keywords offer two ways to do that.
</p>
<p>
It the
<em>
bond
</em>
keyword is set to
<em>
yes
</em>
then any bond or angle or
dihedral or improper interaction that includes a deleted atom is also
removed from the lists of such interactions stored by non-deleted
atoms. Note that simply deleting interactions due to dangling bonds
(e.g. at a surface) may result in a inaccurate or invalid model for
the remaining atoms.
</p>
<p>
It the
<em>
mol
</em>
keyword is set to
<em>
yes
</em>
, then for every atom that is
deleted, all other atoms in the same molecule (with the same molecule
ID) will also be deleted. This is not done for atoms with molecule ID
= 0, since such an ID is assumed to flag isolated atoms that are not
part of molecules.
</p>
<div
class=
"admonition note"
>
<p
class=
"first admonition-title"
>
Note
</p>
<p
class=
"last"
>
The molecule deletion operation in invoked after all individual
atoms have been deleted using the rules described above for each
style. This means additional atoms may be deleted that are not in the
group or region, that are not required by the overlap cutoff
criterion, or that will create a higher fraction of porosity than was
requested.
</p>
</div>
</div>
<div
class=
"section"
id=
"restrictions"
>
<h2>
Restrictions
</h2>
<p>
The
<em>
overlap
</em>
styles requires inter-processor communication to acquire
ghost atoms and build a neighbor list. This means that your system
must be ready to perform a simulation before using this command (force
fields setup, atom masses set, etc). Since a neighbor list is used to
find overlapping atom pairs, it also means that you must define a
<a
class=
"reference internal"
href=
"pair_style.html"
><span
class=
"doc"
>
pair style
</span></a>
with the minimum force cutoff distance
between any pair of atoms types (plus the
<a
class=
"reference internal"
href=
"neighbor.html"
><span
class=
"doc"
>
neighbor
</span></a>
skin)
>
= the specified overlap cutoff.
</p>
<p>
If the
<a
class=
"reference internal"
href=
"special_bonds.html"
><span
class=
"doc"
>
special_bonds
</span></a>
command is used with a
setting of 0, then a pair of bonded atoms (1-2, 1-3, or 1-4) will not
appear in the neighbor list, and thus will not be considered for
deletion by the
<em>
overlap
</em>
styles. You probably don
’
t want to be
deleting one atom in a bonded pair anyway.
</p>
<p>
The
<em>
bond yes
</em>
option cannot be used with molecular systems defined
using molecule template files via the
<a
class=
"reference internal"
href=
"molecule.html"
><span
class=
"doc"
>
molecule
</span></a>
and
<a
class=
"reference internal"
href=
"atom_style.html"
><span
class=
"doc"
>
atom_style template
</span></a>
commands.
</p>
</div>
<div
class=
"section"
id=
"related-commands"
>
<h2>
Related commands
</h2>
<p><a
class=
"reference internal"
href=
"create_atoms.html"
><span
class=
"doc"
>
create_atoms
</span></a></p>
</div>
<div
class=
"section"
id=
"default"
>
<h2>
Default
</h2>
<p>
The option defaults are compress = yes, bond = no, mol = no.
</p>
</div>
</div>
</div>
</div>
<footer>
<hr/>
<div
role=
"contentinfo"
>
<p>
©
Copyright 2013 Sandia Corporation.
</p>
</div>
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>
.
</footer>
</div>
</div>
</section>
</div>
<script
type=
"text/javascript"
>
var
DOCUMENTATION_OPTIONS
=
{
URL_ROOT
:
'./'
,
VERSION
:
''
,
COLLAPSE_INDEX
:
false
,
FILE_SUFFIX
:
'.html'
,
HAS_SOURCE
:
true
};
</script>
<script
type=
"text/javascript"
src=
"_static/jquery.js"
></script>
<script
type=
"text/javascript"
src=
"_static/underscore.js"
></script>
<script
type=
"text/javascript"
src=
"_static/doctools.js"
></script>
<script
type=
"text/javascript"
src=
"https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"
></script>
<script
type=
"text/javascript"
src=
"_static/sphinxcontrib-images/LightBox2/lightbox2/js/jquery-1.11.0.min.js"
></script>
<script
type=
"text/javascript"
src=
"_static/sphinxcontrib-images/LightBox2/lightbox2/js/lightbox.min.js"
></script>
<script
type=
"text/javascript"
src=
"_static/sphinxcontrib-images/LightBox2/lightbox2-customize/jquery-noconflict.js"
></script>
<script
type=
"text/javascript"
src=
"_static/js/theme.js"
></script>
<script
type=
"text/javascript"
>
jQuery
(
function
()
{
SphinxRtdTheme
.
StickyNav
.
enable
();
});
</script>
</body>
</html>
Event Timeline
Log In to Comment