Page Menu
Home
c4science
Search
Configure Global Search
Log In
Files
F80863759
min_modify.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
Mon, Sep 2, 23:37
Size
8 KB
Mime Type
text/html
Expires
Wed, Sep 4, 23:37 (2 d)
Engine
blob
Format
Raw Data
Handle
20461526
Attached To
rLAMMPS lammps
min_modify.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>
min_modify 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"
>
<!-- Local TOC -->
<div
class=
"local-toc"
><ul>
<li><a
class=
"reference internal"
href=
"#"
>
min_modify command
</a><ul>
<li><a
class=
"reference internal"
href=
"#syntax"
>
Syntax
</a></li>
<li><a
class=
"reference internal"
href=
"#examples"
>
Examples
</a></li>
<li><a
class=
"reference internal"
href=
"#description"
>
Description
</a></li>
<li><a
class=
"reference internal"
href=
"#restrictions"
>
Restrictions
</a></li>
<li><a
class=
"reference internal"
href=
"#related-commands"
>
Related commands
</a></li>
<li><a
class=
"reference internal"
href=
"#default"
>
Default
</a></li>
</ul>
</li>
</ul>
</div>
</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>
min_modify 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=
"min-modify-command"
>
<span
id=
"index-0"
></span><h1>
min_modify command
</h1>
<div
class=
"section"
id=
"syntax"
>
<h2>
Syntax
</h2>
<div
class=
"highlight-default"
><div
class=
"highlight"
><pre><span></span><span
class=
"n"
>
min_modify
</span>
<span
class=
"n"
>
keyword
</span>
<span
class=
"n"
>
values
</span>
<span
class=
"o"
>
...
</span>
</pre></div>
</div>
<ul
class=
"simple"
>
<li>
one or more keyword/value pairs may be listed
</li>
</ul>
<pre
class=
"literal-block"
>
keyword =
<em>
dmax
</em>
or
<em>
line
</em>
<em>
dmax
</em>
value = max
max = maximum distance for line search to move (distance units)
<em>
line
</em>
value =
<em>
backtrack
</em>
or
<em>
quadratic
</em>
or
<em>
forcezero
</em>
backtrack,quadratic,forcezero = style of linesearch to use
</pre>
</div>
<div
class=
"section"
id=
"examples"
>
<h2>
Examples
</h2>
<div
class=
"highlight-default"
><div
class=
"highlight"
><pre><span></span><span
class=
"n"
>
min_modify
</span>
<span
class=
"n"
>
dmax
</span>
<span
class=
"mf"
>
0.2
</span>
</pre></div>
</div>
</div>
<div
class=
"section"
id=
"description"
>
<h2>
Description
</h2>
<p>
This command sets parameters that affect the energy minimization
algorithms selected by the
<a
class=
"reference internal"
href=
"min_style.html"
><span
class=
"doc"
>
min_style
</span></a>
command. The
various settings may affect the convergence rate and overall number of
force evaluations required by a minimization, so users can experiment
with these parameters to tune their minimizations.
</p>
<p>
The
<em>
cg
</em>
and
<em>
sd
</em>
minimization styles have an outer iteration and an
inner iteration which is steps along a one-dimensional line search in
a particular search direction. The
<em>
dmax
</em>
parameter is how far any
atom can move in a single line search in any dimension (x, y, or z).
For the
<em>
quickmin
</em>
and
<em>
fire
</em>
minimization styles, the
<em>
dmax
</em>
setting
is how far any atom can move in a single iteration (timestep). Thus a
value of 0.1 in real
<a
class=
"reference internal"
href=
"units.html"
><span
class=
"doc"
>
units
</span></a>
means no atom will move
further than 0.1 Angstroms in a single outer iteration. This prevents
highly overlapped atoms from being moved long distances (e.g. through
another atom) due to large forces.
</p>
<p>
The choice of line search algorithm for the
<em>
cg
</em>
and
<em>
sd
</em>
minimization
styles can be selected via the
<em>
line
</em>
keyword.
The default
<em>
quadratic
</em>
line search algorithm starts out using
the robust backtracking method described below. However, once
the system gets close to a local
minimum and the linesearch steps get small, so that the energy
is approximately quadratic in the step length, it uses the
estimated location of zero gradient as the linesearch step,
provided the energy change is downhill.
This becomes more efficient than backtracking
for highly-converged relaxations. The
<em>
forcezero
</em>
line search algorithm is similar to
<em>
quadratic
</em>
.
It may be more efficient than
<em>
quadratic
</em>
on some systems.
</p>
<p>
The backtracking search is robust and should always find a local energy
minimum. However, it will
“
converge
”
when it can no longer reduce the
energy of the system. Individual atom forces may still be larger than
desired at this point, because the energy change is measured as the
difference of two large values (energy before and energy after) and
that difference may be smaller than machine epsilon even if atoms
could move in the gradient direction to reduce forces further.
</p>
</div>
<div
class=
"section"
id=
"restrictions"
>
<h2>
Restrictions
</h2>
<blockquote>
<div>
none
</div></blockquote>
</div>
<div
class=
"section"
id=
"related-commands"
>
<h2>
Related commands
</h2>
<p><a
class=
"reference internal"
href=
"min_style.html"
><span
class=
"doc"
>
min_style
</span></a>
,
<a
class=
"reference internal"
href=
"minimize.html"
><span
class=
"doc"
>
minimize
</span></a></p>
</div>
<div
class=
"section"
id=
"default"
>
<h2>
Default
</h2>
<p>
The option defaults are dmax = 0.1 and line = quadratic.
</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