Loading...
Searching...
No Matches
eonc::tunneling::RateInstantonOptions Struct Reference

#include <Tunneling.h>

Public Attributes

OwnedBatchPotential ownedPotential
 Stable bead identities and bounded derivative scratch slots.
std::shared_ptr< const PhysicalQuadraticBath > physicalBath
 Fixed physical quadratic bath, eliminated on the same primitive ring.
std::function< MatrixXd(const VectorXd &)> physicalHessian
 Exact physical potential Hessian at a retained bead, excluding springs and the eliminated bath.
long beads = 32
 N, beads on the ring.
long maxIterations = 1000
 translation steps
double forceTolerance = 1e-3
 largest per-bead |dU_N/dq|, eV / (amu^0.5 Angstrom)
long lanczosFirst = 30
 Lanczos steps for the first minimum mode.
long lanczosRestart = 6
 Lanczos steps from the previous mode.
double physicalHessianStep = 1e-4
 Central physical bead-Hessian displacement in sqrt(amu) Angstrom.
double lanczosStep = 1e-4
 finite-difference step, amu^0.5 Angstrom
double maxStep = 0.05
 largest bead move per step, amu^0.5 Angstrom
long memory = 10
 L-BFGS correction pairs.
bool halfRing = true
 Even N, when the guess already matches under j -> N - j: evaluate the potential from one turning point to the other and copy it.
bool checkOddSector = true
 A half ring that has converged, or that is stationary at the wrong index, is probed for an unstable mode odd under j -> N - j (two copies of the instanton on one ring), at about lanczosFirst * N gradient calls; the search then finishes on the whole ring.
double collapseFraction = 1e-4
 The search stops, with RateInstanton::collapsed set, when B_N falls below this fraction of the starting ring's.
double energyShift = 0.0
 subtracted from every bead potential, eV
std::vector< double > discretization
 Empty keeps every spring equal.
std::int64_t newtonLimit = std::numeric_limits<std::int64_t>::max()
 Active coordinates at or below this take the Newton step.
std::string initialHessians = "saddle"
 Where the bead Hessian blocks start: "saddle" copies the saddle's Hessian to every bead and lets the Bofill update carry it; "finite_difference" takes 2 f gradient calls per bead first.
std::vector< double > rigidSqrtMasses
 Rigid motions of the ring: a translation, or one rotation about the ring's centre of mass, applied to every bead alike leaves U_N unchanged.
VectorXd rigidReference
std::array< bool, 3 > rigidRotations {{false, false, false}}
bool friction = false
 Litman friction bath on the rate ring.
bool frictionExplicit = false
double frictionEta = 0.0
std::vector< double > frictionEtaBeads

Detailed Description

Definition at line 384 of file Tunneling.h.

Member Data Documentation

◆ beads

long eonc::tunneling::RateInstantonOptions::beads = 32

N, beads on the ring.

Definition at line 395 of file Tunneling.h.

◆ checkOddSector

bool eonc::tunneling::RateInstantonOptions::checkOddSector = true

A half ring that has converged, or that is stationary at the wrong index, is probed for an unstable mode odd under j -> N - j (two copies of the instanton on one ring), at about lanczosFirst * N gradient calls; the search then finishes on the whole ring.

A cooling schedule probes only its last temperature.

Definition at line 417 of file Tunneling.h.

◆ collapseFraction

double eonc::tunneling::RateInstantonOptions::collapseFraction = 1e-4

The search stops, with RateInstanton::collapsed set, when B_N falls below this fraction of the starting ring's.

0 never stops.

Definition at line 420 of file Tunneling.h.

◆ discretization

std::vector<double> eonc::tunneling::RateInstantonOptions::discretization

Empty keeps every spring equal.

Otherwise one positive weight per bead: the spring from bead j to bead j + 1 is divided by that weight. A half ring keeps the uniform spring and refuses a weight list.

Definition at line 425 of file Tunneling.h.

◆ energyShift

double eonc::tunneling::RateInstantonOptions::energyShift = 0.0

subtracted from every bead potential, eV

Definition at line 421 of file Tunneling.h.

◆ forceTolerance

double eonc::tunneling::RateInstantonOptions::forceTolerance = 1e-3

largest per-bead |dU_N/dq|, eV / (amu^0.5 Angstrom)

Definition at line 397 of file Tunneling.h.

◆ friction

bool eonc::tunneling::RateInstantonOptions::friction = false

Litman friction bath on the rate ring.

Off leaves U_N unchanged. Implicit uses frictionEta on every bead. Explicit uses frictionEtaBeads, one value per bead.

Definition at line 453 of file Tunneling.h.

◆ frictionEta

double eonc::tunneling::RateInstantonOptions::frictionEta = 0.0

Definition at line 455 of file Tunneling.h.

◆ frictionEtaBeads

std::vector<double> eonc::tunneling::RateInstantonOptions::frictionEtaBeads

Definition at line 456 of file Tunneling.h.

◆ frictionExplicit

bool eonc::tunneling::RateInstantonOptions::frictionExplicit = false

Definition at line 454 of file Tunneling.h.

◆ halfRing

bool eonc::tunneling::RateInstantonOptions::halfRing = true

Even N, when the guess already matches under j -> N - j: evaluate the potential from one turning point to the other and copy it.

An odd N, or a guess without that symmetry, evaluates every bead.

Definition at line 411 of file Tunneling.h.

◆ initialHessians

std::string eonc::tunneling::RateInstantonOptions::initialHessians = "saddle"

Where the bead Hessian blocks start: "saddle" copies the saddle's Hessian to every bead and lets the Bofill update carry it; "finite_difference" takes 2 f gradient calls per bead first.

Below the crossover the copied blocks already hold a negative k = 1 ring mode, which counts as drift, so "saddle" rebuilds them from finite differences on the first entry and costs the same.

Definition at line 437 of file Tunneling.h.

◆ lanczosFirst

long eonc::tunneling::RateInstantonOptions::lanczosFirst = 30

Lanczos steps for the first minimum mode.

Definition at line 399 of file Tunneling.h.

◆ lanczosRestart

long eonc::tunneling::RateInstantonOptions::lanczosRestart = 6

Lanczos steps from the previous mode.

Definition at line 400 of file Tunneling.h.

◆ lanczosStep

double eonc::tunneling::RateInstantonOptions::lanczosStep = 1e-4

finite-difference step, amu^0.5 Angstrom

Definition at line 404 of file Tunneling.h.

◆ maxIterations

long eonc::tunneling::RateInstantonOptions::maxIterations = 1000

translation steps

Definition at line 396 of file Tunneling.h.

◆ maxStep

double eonc::tunneling::RateInstantonOptions::maxStep = 0.05

largest bead move per step, amu^0.5 Angstrom

Definition at line 405 of file Tunneling.h.

◆ memory

long eonc::tunneling::RateInstantonOptions::memory = 10

L-BFGS correction pairs.

Definition at line 407 of file Tunneling.h.

◆ newtonLimit

std::int64_t eonc::tunneling::RateInstantonOptions::newtonLimit = std::numeric_limits<std::int64_t>::max()

Active coordinates at or below this take the Newton step.

Zero keeps minimum-mode following. The step solves through the block chain, so the default admits every size a batch potential can evaluate. int64, not long, so the Windows default matches the 64-bit maximum.

Definition at line 430 of file Tunneling.h.

◆ ownedPotential

OwnedBatchPotential eonc::tunneling::RateInstantonOptions::ownedPotential

Stable bead identities and bounded derivative scratch slots.

Empty preserves the BatchPotential callback contract.

Definition at line 387 of file Tunneling.h.

◆ physicalBath

std::shared_ptr<const PhysicalQuadraticBath> eonc::tunneling::RateInstantonOptions::physicalBath

Fixed physical quadratic bath, eliminated on the same primitive ring.

The potential callback supplies retained coordinates and the declared frozen-bath or relaxed potential of this model.

Definition at line 391 of file Tunneling.h.

◆ physicalHessian

std::function<MatrixXd(const VectorXd &)> eonc::tunneling::RateInstantonOptions::physicalHessian

Exact physical potential Hessian at a retained bead, excluding springs and the eliminated bath.

Empty selects finite differences and Bofill.

Definition at line 394 of file Tunneling.h.

◆ physicalHessianStep

double eonc::tunneling::RateInstantonOptions::physicalHessianStep = 1e-4

Central physical bead-Hessian displacement in sqrt(amu) Angstrom.

Independent of the Lanczos directional finite-difference step.

Definition at line 403 of file Tunneling.h.

◆ rigidReference

VectorXd eonc::tunneling::RateInstantonOptions::rigidReference

Definition at line 448 of file Tunneling.h.

◆ rigidRotations

std::array<bool, 3> eonc::tunneling::RateInstantonOptions::rigidRotations {{false, false, false}}

Definition at line 449 of file Tunneling.h.

449{{false, false, false}};

◆ rigidSqrtMasses

std::vector<double> eonc::tunneling::RateInstantonOptions::rigidSqrtMasses

Rigid motions of the ring: a translation, or one rotation about the ring's centre of mass, applied to every bead alike leaves U_N unchanged.

The search rebuilds those directions from the current beads at every step (the rigid quotient) and keeps them out of the step and out of the classification; the imaginary-time cycle stays out of the classification only. Empty masses switch it off (atoms fixed). rigidSqrtMasses holds sqrt(m) per atom, rigidReference the Cartesian positions q is measured from (3 per atom), rigidRotations which rotations are free (a free cluster).

Definition at line 447 of file Tunneling.h.


The documentation for this struct was generated from the following file: