Loading...
Searching...
No Matches
Tunneling.h
Go to the documentation of this file.
1/*
2** This file is part of eOn.
3**
4** SPDX-License-Identifier: BSD-3-Clause
5**
6** Copyright (c) 2010--present, eOn Development Team
7** All rights reserved.
8**
9** Repo:
10** https://github.com/TheochemUI/eOn
11*/
12#pragma once
13
14// One-dimensional tunnelling along a mass-weighted minimum energy path.
15//
16// A two-level system in a glass is a pair of adjacent minima that the system
17// tunnels between at about one kelvin. Its splitting follows from a WKB
18// integral along the mass-weighted path joining the minima (Damart and
19// Rodney; Khomenko et al.; Mocanu et al.). Energies are in eV, lengths in
20// Angstrom and masses in amu, so mass-weighted lengths are in
21// amu^0.5 Angstrom and hbar is kHbar.
22
23#include "Matter.h"
25
26#include <array>
27#include <cstdint>
28#include <functional>
29#include <limits>
30#include <memory>
31#include <string>
32#include <vector>
33
34namespace eonc::tunneling {
35
39inline constexpr double kHbar = 0.06465415129579072;
40
43inline constexpr double kBoltzmann = 8.617333262145177e-5;
44
46double massWeightedDistance(const Matter &a, const Matter &b);
47
49std::vector<double>
50massWeightedPath(const std::vector<std::shared_ptr<Matter>> &band);
51
56class Profile {
57public:
58 Profile(std::vector<double> s, std::vector<double> v);
59 double operator()(double x) const;
60 const std::vector<double> &s() const { return s_; }
61 const std::vector<double> &v() const { return v_; }
62
63private:
64 std::vector<double> s_, v_, m_;
65};
66
71double wellCurvature(const Profile &p, bool leftEnd);
72
74std::array<double, 2> wellFit(const Profile &p, bool leftEnd);
75
77double hbarOmega(double curvature);
78
80double wkbAction(const Profile &p, double energy, int points = 4001);
81
82struct Splitting {
83 double delta = 0.0;
84 double barrier = 0.0;
85 double hwReactant = 0.0;
86 double hwProduct = 0.0;
87 double referenceEnergy = 0.0;
88 double action = 0.0;
89 double delta0 = 0.0;
92 bool deepWells = false;
96 double asymmetry() const;
97 double tlsEnergy() const;
98};
99
104Splitting wkbSplitting(const Profile &p, double hwReactant, double hwProduct);
105
108Splitting bandSplitting(const std::vector<std::shared_ptr<Matter>> &band,
109 double referenceEnergy);
110
113Profile bandProfile(const std::vector<std::shared_ptr<Matter>> &band,
114 double referenceEnergy);
115
124struct Levels {
125 double gap = 0.0;
126 double asymmetry = 0.0;
127 double delta0 = 0.0;
128};
129
133inline constexpr long kDvrPointsPerLength = 20;
135inline constexpr double kDvrPadLengths = 7.0;
137inline constexpr long kDvrMaxPoints = 1500;
138
143Levels dvrLevels(const std::function<double(double)> &v, double sReactant,
144 double sProduct, double sTop, double hwReactant,
145 double hwProduct);
146
150struct BandWall {
151 std::vector<double> distance;
152 std::vector<double> energy;
153};
158
163Levels bandLevels(const Profile &p, const BandWalls *walls = nullptr);
164
169BandWalls bandWalls(const std::vector<std::shared_ptr<Matter>> &band,
170 double referenceEnergy, long points);
171
175bool singleBarrier(const Profile &p);
176
185struct RingSeed {
186 double energy = 0.0;
187 double period = 0.0;
188 double pathLow = 0.0;
189 bool reached = false;
190};
191std::vector<VectorXd> ringFromPath(const std::vector<VectorXd> &path,
192 const std::vector<double> &energies,
193 double betaHbar, long beads,
194 RingSeed *seed = nullptr);
195
199double wkbLogRateAlongPath(const Profile &profile, double beta,
200 double hwReactant);
201
202// Ring-polymer instanton for the splitting between two minima.
203//
204// A path of P + 1 beads in mass-weighted coordinates q runs from one minimum
205// to the other in imaginary time beta hbar, the ends fixed at the minima. The
206// instanton is the path that minimises the discretised Euclidean action
207//
208// S = sum_j |q_{j+1} - q_j|^2 / (2 dtau) + dtau sum_j' V(q_j),
209//
210// dtau = beta hbar / P, with half weight on the two ends (trapezoid). The
211// splitting follows from the ratio of the off-diagonal to the diagonal
212// imaginary-time propagator, both in the same steepest-descent
213// approximation:
214//
215// delta0 = 2 hbar sqrt(S0 / (2 pi hbar dtau))
216// sqrt(det J_well / det' J) exp(-(S - S_well) / hbar),
217//
218// with J the Hessian of S over the interior beads, det' leaving out its
219// zero mode (the kink's position in imaginary time), S0 the integral of
220// |dq/dtau|^2 and J_well the same Hessian with every bead at a minimum.
221// Time runs in amu^0.5 Angstrom eV^-0.5, so hbar is kHbar. Where the minimum
222// energy path curves, the instanton cuts the corner and follows the
223// transverse zero-point energy, which a one-dimensional WKB integral along
224// the path cannot.
225
227 long beads = 256;
228 double betaHbarOmega = 30.0;
230 long maxIterations = 5000;
231 double forceTolerance = 1e-4;
233 long memory = 20;
234};
235
239 std::function<void(const std::vector<VectorXd> &q, std::vector<double> &v,
240 std::vector<VectorXd> &grad)>;
241
243using OwnedBatchPotential = std::function<void(
244 const std::vector<VectorXd> &q, std::vector<double> &v,
245 std::vector<VectorXd> &grad, const std::vector<long> &owners)>;
246
248using BeadHessian = std::function<MatrixXd(long j, const VectorXd &q)>;
249
250struct Instanton {
251 std::vector<VectorXd> path;
252 std::vector<double> energies;
253 double betaHbar = 0.0;
254 double dtau = 0.0;
255 double action = 0.0;
256 double s0 = 0.0;
257 double zeroMode = 0.0;
258 double delta0 = 0.0;
259 double asymmetry = 0.0;
260 long iterations = 0;
261 bool converged = false;
264 bool symmetricEnough = false;
267 double modeSeparation = 0.0;
268};
269
272double pathOmega(const MatrixXd &hessStart, const MatrixXd &hessEnd,
273 const VectorXd &start, const VectorXd &end);
274
278Instanton optimizeInstanton(const VectorXd &start, const VectorXd &end,
279 double betaHbar, std::vector<VectorXd> guess,
280 const BatchPotential &potential,
281 const InstantonOptions &options);
282
285void instantonSplitting(Instanton &inst, const BeadHessian &hessian,
286 const MatrixXd &hessStart, const MatrixXd &hessEnd);
287
296double zeroPointDifference(const MatrixXd &hessStart, const MatrixXd &hessEnd,
297 long rigidModes);
298
309public:
310 EnergyBias(const VectorXd &start, const VectorXd &end, double delta);
311 double value(const VectorXd &q) const;
312 VectorXd gradient(const VectorXd &q) const;
313 MatrixXd hessian(const VectorXd &q) const;
314 double delta() const { return delta_; }
315
316private:
317 double xi(const VectorXd &q) const;
318 VectorXd start_, d_;
319 double dd_ = 0.0;
320 double delta_ = 0.0;
321};
322
323// Ring-polymer instanton for the thermal rate below the crossover
324// temperature (Richardson and Althorpe, J. Chem. Phys. 131, 214106 (2009)).
325//
326// A closed ring of N beads in mass-weighted coordinates q, beta_N = beta / N,
327// has the potential
328//
329// U_N = sum_j V(q_j) + sum_j |q_{j+1} - q_j|^2 / (2 beta_N^2 hbar^2),
330//
331// q_N = q_0. Below T_c = hbar omega_b / (2 pi kB), omega_b the imaginary
332// frequency at the saddle, the instanton is a first-order saddle of U_N:
333// one negative mode, and one zero mode that cycles the beads. The rate is
334//
335// k Z_r = (1 / (beta_N hbar)) sqrt(B_N / (2 pi beta_N hbar^2))
336// prod'_k 1 / (beta_N hbar |omega_k|) exp(-beta_N U_N),
337//
338// B_N = sum_j |q_{j+1} - q_j|^2, omega_k^2 the eigenvalues of the
339// mass-weighted Hessian of U_N with the zero mode left out, and Z_r the
340// ring-polymer partition function of the harmonic reactant,
341//
342// Z_r = exp(-beta V_r) prod_{k=0}^{N-1} prod_m
343// 1 / (beta_N hbar sqrt(lambda_m + 4 sin^2(pi k / N) / (beta_N
344// hbar)^2)),
345//
346// lambda_m the eigenvalues of the reactant's mass-weighted Hessian. Above
347// T_c the ring collapses onto the saddle and the formula no longer applies.
348
350inline constexpr double kTimeUnitSeconds = 1.0180505717871193e-14;
351
354double crossoverTemperature(const MatrixXd &hessSaddle);
355
358double parabolicFactor(double temperature, double crossover);
359
366double harmonicTstLogRate(const MatrixXd &hessReactant,
367 const MatrixXd &hessSaddle, double beta,
368 double barrier, long rigidModes);
369
380double quantumHarmonicTstLogRate(const MatrixXd &hessReactant,
381 const MatrixXd &hessSaddle, double beta,
382 double barrier, long rigidModes);
383
391 std::shared_ptr<const PhysicalQuadraticBath> physicalBath;
394 std::function<MatrixXd(const VectorXd &)> physicalHessian;
395 long beads = 32;
396 long maxIterations = 1000;
397 double forceTolerance = 1e-3;
399 long lanczosFirst = 30;
400 long lanczosRestart = 6;
403 double physicalHessianStep = 1e-4;
404 double lanczosStep = 1e-4;
405 double maxStep = 0.05;
407 long memory = 10;
411 bool halfRing = true;
417 bool checkOddSector = true;
420 double collapseFraction = 1e-4;
421 double energyShift = 0.0;
425 std::vector<double> discretization;
430 std::int64_t newtonLimit = std::numeric_limits<std::int64_t>::max();
437 std::string initialHessians = "saddle";
447 std::vector<double> rigidSqrtMasses;
449 std::array<bool, 3> rigidRotations{{false, false, false}};
453 bool friction = false;
454 bool frictionExplicit = false;
455 double frictionEta = 0.0;
456 std::vector<double> frictionEtaBeads;
457};
458
462void addFrictionBath(const std::vector<VectorXd> &q, double &u,
463 std::vector<VectorXd> &grad,
464 const std::vector<double> &eta);
465
469double closedRingPotential(const std::vector<VectorXd> &beads, double spring,
470 const BatchPotential &potential,
471 const std::vector<double> &discretization = {});
472
476 double logDetPrime = 0.0;
481 double zeroEigenvalue = 0.0;
482};
483
490RingSpectrum ringSpectrum(const std::vector<MatrixXd> &beadHessians, double c,
491 const std::vector<VectorXd> &tau);
492
494 std::shared_ptr<const PhysicalQuadraticBath> physicalBath;
495 std::vector<VectorXd> beads;
496 std::vector<double> energies;
497 double beta = 0.0;
498 double betaN = 0.0;
499 double temperature = 0.0;
500 double crossover = 0.0;
501 double ringPotential = 0.0;
502 double bN = 0.0;
504 std::vector<double> discretization;
506 std::vector<double> bathEta;
508 std::vector<double> bathSignedCurvatures;
509 double bathLogAbsDet = std::numeric_limits<double>::quiet_NaN();
510 double bathReactantLogAbsDet = std::numeric_limits<double>::quiet_NaN();
511 double bathSymmetryResidual = std::numeric_limits<double>::quiet_NaN();
512 double bathRoundoffScale = std::numeric_limits<double>::quiet_NaN();
513 double phaseEigenResidual = std::numeric_limits<double>::quiet_NaN();
515 double logAbsoluteGaussianWeight = std::numeric_limits<double>::quiet_NaN();
516 bool phaseZeroVerified = false;
519 bool rateValid = false;
520 std::string rateValidity = "not_evaluated";
521
522 double negativeEigenvalue = 0.0;
523 double zeroEigenvalue = 0.0;
524 long negativeModes = 0;
525 long iterations = 0;
526 bool converged = false;
530 bool collapsed = false;
531 double logRateTimesZr = 0.0;
534 double logRotationRatio = 0.0;
535 double logZr = 0.0;
536 double logRate = 0.0;
537 double rate = 0.0;
539 double effectiveBarrier = 0.0;
543 double classicalRate = 0.0;
544 double classicalLogRate = 0.0;
545};
546
557RateInstanton optimizeRateInstanton(const VectorXd &saddle,
558 const MatrixXd &hessSaddle, double beta,
559 std::vector<VectorXd> guess,
560 const BatchPotential &potential,
561 const RateInstantonOptions &options);
562
567 double sMin = 0.0;
568 double sMax = 0.0;
571 double chordOverlap = 0.0;
574 double crossingOffset = 0.0;
579 bool belongs = false;
580};
581
584RingChannel ringChannel(const std::vector<VectorXd> &beads,
585 const VectorXd &saddle, const VectorXd &mode);
586
597inline constexpr double kRotationZeroFraction = 0.1;
599 std::array<bool, 3> zero{{false, false, false}};
600 std::array<double, 3> residual{{0.0, 0.0, 0.0}};
601 double softestVibration = 0.0;
602};
604 const MatrixXd &generators,
605 double fraction = kRotationZeroFraction);
606
612void bofillKeepingInertia(MatrixXd &h, const VectorXd &dq, const VectorXd &dg,
613 long allowedNegatives);
614
616using RingBeadHessian = std::function<MatrixXd(long j, const VectorXd &q)>;
617
625 std::vector<double> sqrtMasses;
626 VectorXd reference;
627 std::array<bool, 3> rotations{{false, false, false}};
628 VectorXd saddle;
629};
630
641double logRotationalRatio(const std::vector<VectorXd> &beads,
642 const RingRigidBodies &bodies);
643
671void instantonRate(RateInstanton &inst, const RingBeadHessian &hessian,
672 const MatrixXd &hessReactant, double vReactant,
673 const MatrixXd &hessSaddle = MatrixXd(),
674 double vSaddle = 0.0, long rigidModes = 0,
675 long denseLimit = 4096,
676 const RingRigidBodies &rigidBodies = {});
677
683double cyclicRingLogAbsDet(double c, const std::vector<MatrixXd> &diag);
684
687std::vector<VectorXd> cyclicRingSolve(double c,
688 const std::vector<MatrixXd> &diag,
689 const std::vector<VectorXd> &rhs);
690
691} // namespace eonc::tunneling
Eigen::Matrix< double, Eigen::Dynamic, Eigen::Dynamic, eOnStorageOrder > MatrixXd
Definition Eigen.h:33
VectorXd gradient(const VectorXd &q) const
MatrixXd hessian(const VectorXd &q) const
EnergyBias(const VectorXd &start, const VectorXd &end, double delta)
double value(const VectorXd &q) const
double xi(const VectorXd &q) const
Energy along the path, interpolated as a monotone cubic (Fritsch and Carlson), flat at both ends beca...
Definition Tunneling.h:56
std::vector< double > m_
Definition Tunneling.h:64
std::vector< double > s_
Definition Tunneling.h:64
std::vector< double > v_
Definition Tunneling.h:64
Profile(std::vector< double > s, std::vector< double > v)
Definition Tunneling.cpp:88
const std::vector< double > & v() const
Definition Tunneling.h:61
double operator()(double x) const
const std::vector< double > & s() const
Definition Tunneling.h:60
std::function< MatrixXd(long j, const VectorXd &q)> BeadHessian
The mass-weighted Hessian d2V/dq2 at interior bead j (1..P-1).
Definition Tunneling.h:248
RingSpectrum ringSpectrum(const std::vector< MatrixXd > &beadHessians, double c, const std::vector< VectorXd > &tau)
The ring Hessian of bead Hessians beadHessians (d2V/dq2 at each of the N beads) and spring constant c...
constexpr double kDvrPadLengths
Oscillator lengths the grid reaches past each minimum.
Definition Tunneling.h:135
double zeroPointDifference(const MatrixXd &hessStart, const MatrixXd &hessEnd, long rigidModes)
Harmonic zero-point energy of the end minimum minus that of the start, in eV: (hbar / 2) times the di...
constexpr long kDvrMaxPoints
Largest grid; a longer path takes a coarser spacing.
Definition Tunneling.h:137
double cyclicRingLogAbsDet(double c, const std::vector< MatrixXd > &diag)
log|det| of the cyclic block-tridiagonal ring Hessian.
Splitting bandSplitting(const std::vector< std::shared_ptr< Matter > > &band, double referenceEnergy)
The splitting of a converged band, with the well frequencies from the band's curvature at each end.
void bofillKeepingInertia(MatrixXd &h, const VectorXd &dq, const VectorXd &dg, long allowedNegatives)
The Bofill update of a bead block (Powell symmetric Broyden and SR1 mixed by the angle between the se...
std::vector< VectorXd > cyclicRingSolve(double c, const std::vector< MatrixXd > &diag, const std::vector< VectorXd > &rhs)
Solves that same cyclic ring Hessian.
double closedRingPotential(const std::vector< VectorXd > &beads, double spring, const BatchPotential &potential, const std::vector< double > &discretization)
U_N of a closed ring.
constexpr long kDvrPointsPerLength
Grid points per oscillator length hbar / sqrt(hbar omega) of the stiffer well.
Definition Tunneling.h:133
void instantonRate(RateInstanton &inst, const RingBeadHessian &hessian, const MatrixXd &hessReactant, double vReactant, const MatrixXd &hessSaddle, double vSaddle, long rigidModes, long denseLimit, const RingRigidBodies &rigidBodies)
Fills the rate from the bead Hessians, the reactant minimum's Hessian and energy, and optionally the ...
BandWalls bandWalls(const std::vector< std::shared_ptr< Matter > > &band, double referenceEnergy, long points)
The walls of both ends of a band, after Khomenko et al.
double wkbAction(const Profile &p, double energy, int points)
(1/hbar) integral sqrt(2 (V(s) - E)) ds over the path where V > E.
double parabolicFactor(double temperature, double crossover)
(pi T_c / T) / sin(pi T_c / T).
void instantonSplitting(Instanton &inst, const BeadHessian &hessian, const MatrixXd &hessStart, const MatrixXd &hessEnd)
Fills delta0, zeroMode and modeSeparation from the bead Hessians and the Hessians of the two minima.
constexpr double kTimeUnitSeconds
One unit of time, sqrt(amu Angstrom^2 / eV), in seconds.
Definition Tunneling.h:350
double pathOmega(const MatrixXd &hessStart, const MatrixXd &hessEnd, const VectorXd &start, const VectorXd &end)
omega along the straight line between the minima from the curvature of each well there,...
std::function< MatrixXd(long j, const VectorXd &q)> RingBeadHessian
The mass-weighted Hessian d2V/dq2 at ring bead j (0..N-1).
Definition Tunneling.h:616
constexpr double kRotationZeroFraction
Which rotations of a structure are zero modes of its mass-weighted Hessian.
Definition Tunneling.h:597
double logRotationalRatio(const std::vector< VectorXd > &beads, const RingRigidBodies &bodies)
ln of the classical rotational partition function of beads over that of as many copies of the referen...
bool singleBarrier(const Profile &p)
Whether a profile is one double well: its images rise to exactly one maximum between the two ends.
RateInstanton optimizeRateInstanton(const VectorXd &saddle, const MatrixXd &hessSaddle, double beta, std::vector< VectorXd > guess, const BatchPotential &potential, const RateInstantonOptions &request)
Finds the rate instanton at inverse temperature beta (1 / eV).
RingChannel ringChannel(const std::vector< VectorXd > &beads, const VectorXd &saddle, const VectorXd &mode)
The channel test above for a ring of beads, a saddle and its unstable mode (normalised inside).
void addFrictionBath(const std::vector< VectorXd > &q, double &u, std::vector< VectorXd > &grad, const std::vector< double > &eta)
Position-independent (one eta) or bead-wise friction on a closed ring.
constexpr double kHbar
hbar in eV^0.5 amu^0.5 Angstrom, correctly rounded from the exact SI values (h = 6....
Definition Tunneling.h:39
Splitting wkbSplitting(const Profile &p, double hwReactant, double hwProduct)
delta0 = (hbar omega / pi) exp(-S) with the Landau and Lifshitz prefactor.
double harmonicTstLogRate(const MatrixXd &hessReactant, const MatrixXd &hessSaddle, double beta, double barrier, long rigidModes)
ln(k) for classical harmonic transition-state theory, k in 1/time.
double wellCurvature(const Profile &p, bool leftEnd)
d2V/ds2 at one end of the path, in eV / (amu Angstrom^2), from a least squares fit of a s^2 + b s^3 t...
double massWeightedDistance(const Matter &a, const Matter &b)
sqrt(sum_i m_i |b_i - a_i|^2) under the minimum image of a's cell.
Definition Tunneling.cpp:61
std::function< void(const std::vector< VectorXd > &q, std::vector< double > &v, std::vector< VectorXd > &grad)> BatchPotential
V (eV) and dV/dq (eV / (amu^0.5 Angstrom)) at every point of q, all in one call so a potential can sp...
Definition Tunneling.h:238
double quantumHarmonicTstLogRate(const MatrixXd &hessReactant, const MatrixXd &hessSaddle, double beta, double barrier, long rigidModes)
ln(k) for quantum harmonic transition-state theory, k in 1/time: (1 / (2 pi beta hbar)) prod_r 2 sinh...
double crossoverTemperature(const MatrixXd &hessSaddle)
T_c = hbar omega_b / (2 pi kB) from the mass-weighted Hessian at the saddle, in K; throws when the He...
std::vector< VectorXd > ringFromPath(const std::vector< VectorXd > &path, const std::vector< double > &energies, double betaHbar, long beads, RingSeed *seed)
Levels dvrLevels(const std::function< double(double)> &v, double sReactant, double sProduct, double sTop, double hwReactant, double hwProduct)
The levels of -hbar^2/2 d2/ds2 + V(s) at unit mass on a mass-weighted path coordinate s,...
double wkbLogRateAlongPath(const Profile &profile, double beta, double hwReactant)
ln(k), k in 1/time, for the one-dimensional thermal rate along profile.
Levels bandLevels(const Profile &p, const BandWalls *walls)
dvrLevels on a band: the profile between the images, and past each end the well's fit a s^2 + b s^3 c...
std::array< double, 2 > wellFit(const Profile &p, bool leftEnd)
{a, b} of that fit, s measured inward from the end: wellCurvature is 2 a.
Profile bandProfile(const std::vector< std::shared_ptr< Matter > > &band, double referenceEnergy)
The energy of a band against its mass-weighted arc length, measured from referenceEnergy.
std::function< void( const std::vector< VectorXd > &q, std::vector< double > &v, std::vector< VectorXd > &grad, const std::vector< long > &owners)> OwnedBatchPotential
Explicit electronic-state owners for each evaluated geometry.
Definition Tunneling.h:243
double hbarOmega(double curvature)
hbar omega in eV for a mass-weighted curvature.
RotationZeroModes rotationZeroModes(const MatrixXd &hess, const MatrixXd &generators, double fraction)
std::vector< double > massWeightedPath(const std::vector< std::shared_ptr< Matter > > &band)
Cumulative mass-weighted arc length at each image of a band.
Definition Tunneling.cpp:79
Instanton optimizeInstanton(const VectorXd &start, const VectorXd &end, double betaHbar, std::vector< VectorXd > guess, const BatchPotential &potential, const InstantonOptions &options)
Minimises the action from guess (P + 1 beads, ends at the minima, or empty for a tanh kink along the ...
constexpr double kBoltzmann
Boltzmann constant in eV / K, correctly rounded from the exact 1.380649e-23 J / K.
Definition Tunneling.h:43
One well's outer wall: increasing mass-weighted distances outward from the minimum along the reaction...
Definition Tunneling.h:150
std::vector< double > distance
Definition Tunneling.h:151
std::vector< double > energy
Definition Tunneling.h:152
long maxIterations
L-BFGS iterations.
Definition Tunneling.h:230
double forceTolerance
largest per-bead |dS/dq| / dtau, eV / (amu^0.5 Angstrom)
Definition Tunneling.h:231
long beads
P: segments from one minimum to the other.
Definition Tunneling.h:227
long memory
L-BFGS correction pairs.
Definition Tunneling.h:233
double betaHbarOmega
beta hbar omega of the stiffer end along the path; sets the imaginary time
Definition Tunneling.h:228
double asymmetry
V(end) - V(start), eV.
Definition Tunneling.h:259
std::vector< double > energies
V at every bead, eV.
Definition Tunneling.h:252
double zeroMode
the eigenvalue det' leaves out
Definition Tunneling.h:257
double action
(S - S_well) / hbar
Definition Tunneling.h:255
double s0
integral of |dq/dtau|^2 dtau
Definition Tunneling.h:256
bool symmetricEnough
beta |asymmetry| < 0.1: the propagator ratio reads delta0 only when the wells lie within a small frac...
Definition Tunneling.h:264
double modeSeparation
The second smallest eigenvalue of J over the zero mode's: small means the kink is not isolated in ima...
Definition Tunneling.h:267
double betaHbar
imaginary time the path spans
Definition Tunneling.h:253
double dtau
betaHbar / P
Definition Tunneling.h:254
double delta0
tunnelling splitting, eV
Definition Tunneling.h:258
std::vector< VectorXd > path
P + 1 beads, ends at the minima.
Definition Tunneling.h:251
The two lowest levels of a one-dimensional double well, in eV.
Definition Tunneling.h:124
std::vector< double > frictionEtaBeads
Definition Tunneling.h:456
OwnedBatchPotential ownedPotential
Stable bead identities and bounded derivative scratch slots.
Definition Tunneling.h:387
long memory
L-BFGS correction pairs.
Definition Tunneling.h:407
std::shared_ptr< const PhysicalQuadraticBath > physicalBath
Fixed physical quadratic bath, eliminated on the same primitive ring.
Definition Tunneling.h:391
double collapseFraction
The search stops, with RateInstanton::collapsed set, when B_N falls below this fraction of the starti...
Definition Tunneling.h:420
std::vector< double > rigidSqrtMasses
Rigid motions of the ring: a translation, or one rotation about the ring's centre of mass,...
Definition Tunneling.h:447
std::array< bool, 3 > rigidRotations
Definition Tunneling.h:449
double maxStep
largest bead move per step, amu^0.5 Angstrom
Definition Tunneling.h:405
double energyShift
subtracted from every bead potential, eV
Definition Tunneling.h:421
std::int64_t newtonLimit
Active coordinates at or below this take the Newton step.
Definition Tunneling.h:430
long beads
N, beads on the ring.
Definition Tunneling.h:395
long lanczosRestart
Lanczos steps from the previous mode.
Definition Tunneling.h:400
double forceTolerance
largest per-bead |dU_N/dq|, eV / (amu^0.5 Angstrom)
Definition Tunneling.h:397
bool halfRing
Even N, when the guess already matches under j -> N - j: evaluate the potential from one turning poin...
Definition Tunneling.h:411
std::function< MatrixXd(const VectorXd &)> physicalHessian
Exact physical potential Hessian at a retained bead, excluding springs and the eliminated bath.
Definition Tunneling.h:394
double lanczosStep
finite-difference step, amu^0.5 Angstrom
Definition Tunneling.h:404
std::string initialHessians
Where the bead Hessian blocks start: "saddle" copies the saddle's Hessian to every bead and lets the ...
Definition Tunneling.h:437
bool friction
Litman friction bath on the rate ring.
Definition Tunneling.h:453
long lanczosFirst
Lanczos steps for the first minimum mode.
Definition Tunneling.h:399
std::vector< double > discretization
Empty keeps every spring equal.
Definition Tunneling.h:425
bool checkOddSector
A half ring that has converged, or that is stationary at the wrong index, is probed for an unstable m...
Definition Tunneling.h:417
long maxIterations
translation steps
Definition Tunneling.h:396
double physicalHessianStep
Central physical bead-Hessian displacement in sqrt(amu) Angstrom.
Definition Tunneling.h:403
double logAbsoluteGaussianWeight
Absolute labelled-saddle Gaussian weight, without contour/rate factors.
Definition Tunneling.h:515
long negativeModes
eigenvalues below the zero mode
Definition Tunneling.h:524
std::vector< double > bathSignedCurvatures
Exact finite bath fluctuation diagnostics after declared rigid projection.
Definition Tunneling.h:508
bool collapsed
The search stopped because B_N fell below collapseFraction of the starting ring's: the beads fell tog...
Definition Tunneling.h:530
double zeroEigenvalue
the eigenvalue left out
Definition Tunneling.h:523
bool rateValid
A physical rate requires a converged index-one stationary ring.
Definition Tunneling.h:519
double beta
1 / (kB T), 1 / eV
Definition Tunneling.h:497
std::shared_ptr< const PhysicalQuadraticBath > physicalBath
Definition Tunneling.h:494
std::vector< double > energies
V at every bead, eV.
Definition Tunneling.h:496
std::vector< double > discretization
Empty keeps every spring equal. Otherwise one positive weight per bead.
Definition Tunneling.h:504
double bN
sum_j |q_{j+1} - q_j|^2, amu Angstrom^2
Definition Tunneling.h:502
std::vector< double > bathEta
Resolved fixed bath coefficients: empty, one value or one per bead.
Definition Tunneling.h:506
double logRotationRatio
ln of the ring's rotational partition function over the reactant's, included in logRateTimesZr; zero ...
Definition Tunneling.h:534
double logRate
ln k, k in 1 / time
Definition Tunneling.h:536
std::vector< VectorXd > beads
N beads, q_N = q_0 implied.
Definition Tunneling.h:495
double classicalRate
Classical harmonic transition-state theory at the same T, 1 / s, when the saddle Hessian was given; i...
Definition Tunneling.h:543
double logRateTimesZr
ln(k Z_r), k in 1 / time
Definition Tunneling.h:531
double negativeEigenvalue
of the ring Hessian, 1 / time^2
Definition Tunneling.h:522
double effectiveBarrier
-kB T ln(2 pi hbar beta k): the barrier an Eyring rate would need, eV.
Definition Tunneling.h:539
Where a ring sits against the saddle it was seeded from, in mass-weighted coordinates.
Definition Tunneling.h:566
bool belongs
Beads on both sides of the dividing plane, the chord within 60 degrees of the mode,...
Definition Tunneling.h:579
double sMin
least s over the beads, amu^0.5 Angstrom
Definition Tunneling.h:567
double chordOverlap
|cos| of the angle between the chord joining the turning points and the unstable mode.
Definition Tunneling.h:571
double crossingOffset
Largest distance from the saddle, across the mode, of a point where the ring crosses the dividing pla...
Definition Tunneling.h:574
double sMax
greatest s over the beads
Definition Tunneling.h:568
The atoms behind a ring's mass-weighted coordinates, for its rigid motions: sqrt(m) per atom,...
Definition Tunneling.h:624
std::array< bool, 3 > rotations
Definition Tunneling.h:627
std::vector< double > sqrtMasses
Definition Tunneling.h:625
Closed ring of beads samples of path whose imaginary-time period is betaHbar.
Definition Tunneling.h:185
double pathLow
the higher of the path's two end energies
Definition Tunneling.h:188
Spectrum of a closed ring's Hessian without forming it.
Definition Tunneling.h:474
double logDetPrime
ln |det' J|: the product over every eigenvalue but the one along tau.
Definition Tunneling.h:476
long negativeModes
Eigenvalues below zero, the one along tau left out.
Definition Tunneling.h:478
std::array< bool, 3 > zero
Definition Tunneling.h:599
double softestVibration
lowest eigenvalue on the complement
Definition Tunneling.h:601
std::array< double, 3 > residual
Definition Tunneling.h:600
bool deepWells
Both barriers stand above hbar omega; below that WKB is not the right tool and the number is reported...
Definition Tunneling.h:92
double hwReactant
hbar omega of the reactant well, eV
Definition Tunneling.h:85
double delta0
tunnelling splitting, eV
Definition Tunneling.h:89
double barrier
path maximum above the reactant, eV
Definition Tunneling.h:84
double asymmetry() const
The diagonal term of the two-level Hamiltonian, the difference of the two local ground states: delta ...
double referenceEnergy
the level tunnelling happens at, eV
Definition Tunneling.h:87
double action
the WKB exponent, dimensionless
Definition Tunneling.h:88
double tlsEnergy() const
sqrt(asymmetry()^2 + delta0^2), eV
double hwProduct
hbar omega of the product well, eV
Definition Tunneling.h:86
double delta
product minus reactant, eV
Definition Tunneling.h:83