Commit JT 073019

- modified doc doc/src/min_modify.txt
- tested lattice minimizers with norm styles
This commit is contained in:
julient31
2019-07-30 08:58:12 -06:00
parent aa3c44ad4a
commit 74fa4f7415
3 changed files with 17 additions and 15 deletions

View File

@ -13,7 +13,7 @@ min_modify command :h3
min_modify keyword values ... :pre
one or more keyword/value pairs may be listed :ulb,l
keyword = {dmax} or {line} or {alpha_damp} or {discrete_factor}
keyword = {dmax} or {line} or {norm} or {alpha_damp} or {discrete_factor}
{dmax} value = max
max = maximum distance for line search to move (distance units)
{line} value = {backtrack} or {quadratic} or {forcezero} or {spin_cubic} or {spin_none}
@ -71,13 +71,12 @@ 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.
The choice of a norm can be modified for the min styles {fire},
{quickmin}, {sd}, {spin}, {spin_oso_cg} and {spin_oso_lbfgs}
using the {norm} keyword.
The choice of a norm can be modified for the min styles {cg}, {sd},
{quickmin}, {fire}, {spin}, {spin_oso_cg} and {spin_oso_lbfgs} using
the {norm} keyword.
The default {euclidean} norm computes the 2-norm (length) of the
global force vector. The {max} norm computes the maximum value
of the 2-norms of all forces in the system.
of the 2-norms across all forces in the system.
Keywords {alpha_damp} and {discrete_factor} only make sense when
a "min_spin"_min_spin.html command is declared.
@ -88,7 +87,6 @@ Keyword {discrete_factor} defines a discretization factor for the
adaptive timestep used in the {spin} minimization.
See "min_spin"_min_spin.html for more information about those
quantities.
Default values are {alpha_damp} = 1.0 and {discrete_factor} = 10.0.
The choice of a line search algorithm for the {spin_oso_cg} and
{spin_oso_lbfgs} styles can be specified via the {line} keyword.
@ -112,4 +110,9 @@ explanation.
[Default:]
The option defaults are dmax = 0.1 and line = quadratic.
The option defaults are dmax = 0.1, line = quadratic and norm =
euclidean.
For the {spin}, {spin_oso_cg} and {spin_oso_lbfgs} styles, the
option defaults are alpha_damp = 1.0, discrete_factor = 10.0,
line = spin_none, and norm = euclidean.

View File

@ -56,7 +56,7 @@ Style {spin_oso_cg} defines an orthogonal spin optimization
The "min_modify"_min_modify.html command can be used to
couple the {spin_oso_cg} to a line search procedure, and to modify the
discretization factor {discrete_factor}.
By defualt, the style {spin_oso_cg} does not employ line search procedure and
By default, style {spin_oso_cg} does not employ the line search procedure
and uses the adaptive time-step technique in the same way as style {spin}.
Style {spin_oso_lbfgs} defines an orthogonal spin optimization
@ -66,8 +66,8 @@ By default, style {spin_oso_lbfgs} does not employ line search procedure.
If the line search procedure is not used then the discrete factor defines
the maximum root mean squared rotation angle of spins by equation {pi/(5*Kappa)}.
The default value for Kappa is 10.
The {spin_cubic} line search can improve
the convergence of the {spin_oso_lbfgs} algorithm.
The {spin_cubic} line search can improve the convergence of the
{spin_oso_lbfgs} algorithm.
The "min_modify"_min_modify.html command can be used to
activate the line search procedure, and to modify the
@ -95,8 +95,8 @@ freedom for a frozen lattice configuration.
[Default:]
The option defaults are {alpha_damp} = 1.0 and {discrete_factor} =
10.0.
The option defaults are {alpha_damp} = 1.0, {discrete_factor} =
10.0, {line} = spin_none and {norm} = euclidean.
:line

View File

@ -11,8 +11,7 @@ min_style command :h3
min_style style :pre
style = {cg} or {hftn} or {sd} or {quickmin} or {fire} or {spin}
or {spin_oso_cg} or {spin_oso_lbfgs} :ul
style = {cg} or {hftn} or {sd} or {quickmin} or {fire} or {spin} or {spin_oso_cg} or {spin_oso_lbfgs} :ul
[Examples:]