Classes | |
| struct | BandWall |
| One well's outer wall: increasing mass-weighted distances outward from the minimum along the reaction path, and the energies there on the scale of the band's profile. More... | |
| struct | BandWalls |
| class | CyclicBlockBath |
| Exact factorization of diag(E_j) plus the cyclic primitive spring matrix. More... | |
| class | DerivativeRbfModel |
| Gaussian derivative interpolant with an explicit quadratic baseline. More... | |
| class | EnergyBias |
| delta sigma(xi) between two minima, xi = (q - start) . More... | |
| class | HarmonicReferenceAction |
| Exact nonnegative harmonic-reference links in mass-weighted coordinates. More... | |
| struct | Instanton |
| struct | InstantonOptions |
| struct | Levels |
| The two lowest levels of a one-dimensional double well, in eV. More... | |
| struct | PhysicalBathModel |
| struct | PhysicalQuadraticBath |
| V(q,b)=V_fixed(q)+source(q)^T b+b^T E(q)b/2. More... | |
| class | Profile |
| Energy along the path, interpolated as a monotone cubic (Fritsch and Carlson), flat at both ends because the ends of a band are minima. More... | |
| class | QuadraticBath |
| Exact Gaussian elimination of a stable physical mass-weighted harmonic bath. More... | |
| struct | RateInstanton |
| struct | RateInstantonOptions |
| struct | RbfEvaluation |
| struct | RingChannel |
| Where a ring sits against the saddle it was seeded from, in mass-weighted coordinates. More... | |
| class | RingPolymerPotential |
| One structure whose coordinates are the beads of a closed ring. More... | |
| struct | RingRigidBodies |
| The atoms behind a ring's mass-weighted coordinates, for its rigid motions: sqrt(m) per atom, the Cartesian positions q is measured from (3 per atom; the reactant minimum, q = 0, for the rotational ratio), and which rotations are free. More... | |
| struct | RingSeed |
| Closed ring of beads samples of path whose imaginary-time period is betaHbar. More... | |
| struct | RingSpectrum |
| Spectrum of a closed ring's Hessian without forming it. More... | |
| struct | RotationZeroModes |
| struct | Splitting |
Typedefs | |
| using | BatchPotential |
| V (eV) and dV/dq (eV / (amu^0.5 Angstrom)) at every point of q, all in one call so a potential can spread the beads over its calculators. | |
| using | OwnedBatchPotential |
| Explicit electronic-state owners for each evaluated geometry. | |
| using | BeadHessian = std::function<MatrixXd(long j, const VectorXd &q)> |
| The mass-weighted Hessian d2V/dq2 at interior bead j (1..P-1). | |
| using | RingBeadHessian = std::function<MatrixXd(long j, const VectorXd &q)> |
| The mass-weighted Hessian d2V/dq2 at ring bead j (0..N-1). | |
Functions | |
| 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. | |
| std::vector< double > | massWeightedPath (const std::vector< std::shared_ptr< Matter > > &band) |
| Cumulative mass-weighted arc length at each image of a band. | |
| 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 to the points within half the barrier above that end. | |
| 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. | |
| double | hbarOmega (double curvature) |
| hbar omega in eV for a mass-weighted curvature. | |
| double | wkbAction (const Profile &p, double energy, int points=4001) |
| (1/hbar) integral sqrt(2 (V(s) - E)) ds over the path where V > E. | |
| Splitting | wkbSplitting (const Profile &p, double hwReactant, double hwProduct) |
| delta0 = (hbar omega / pi) exp(-S) with the Landau and Lifshitz prefactor. | |
| std::vector< VectorXd > | ringFromPath (const std::vector< VectorXd > &path, const std::vector< double > &energies, double betaHbar, long beads, RingSeed *seed) |
| double | wkbLogRateAlongPath (const Profile &profile, double beta, double hwReactant) |
| ln(k), k in 1/time, for the one-dimensional thermal rate along profile. | |
| 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. | |
| 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. | |
| bool | singleBarrier (const Profile &p) |
| Whether a profile is one double well: its images rise to exactly one maximum between the two ends. | |
| 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, with V defined past both minima: fourth-order central differences on a uniform grid from kDvrPadLengths oscillator lengths before the reactant minimum to as far past the product's. | |
| Levels | bandLevels (const Profile &p, const BandWalls *walls=nullptr) |
| dvrLevels on a band: the profile between the images, and past each end the well's fit a s^2 + b s^3 continued, never softer than its parabola. | |
| 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 | 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, the larger of the two; in 1 / time. | |
| 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 straight line). | |
| 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. | |
| 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 difference of the sums of the vibrational frequencies of the two mass-weighted Hessians. | |
| 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 Hessian has no negative eigenvalue. | |
| 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. | |
| 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, with the normalised direction tau (N beads) lifted by c and taken out again through the determinant lemma det(J + c tau tau^T) = (c + lambda_0) det' J, exact when J tau = lambda_0 tau. | |
| double | cyclicRingLogAbsDet (double c, const std::vector< MatrixXd > &diag) |
| log|det| of the cyclic block-tridiagonal ring Hessian. | |
| std::vector< VectorXd > | cyclicRingSolve (double c, const std::vector< MatrixXd > &diag, const std::vector< VectorXd > &rhs) |
| Solves that same cyclic ring Hessian. | |
| RateInstanton | optimizeRateInstanton (const VectorXd &saddle, const MatrixXd &hessSaddle, double beta, std::vector< VectorXd > guess, const BatchPotential &potential, const RateInstantonOptions &options) |
| Finds the rate instanton at inverse temperature beta (1 / eV). | |
| 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 reference (q = 0), for the free rotations: half the log of the ratio of the products of their principal moments, the inertia of every bead's atoms about the beads' common centre of mass, which is the Gram matrix of the ring's rotation generators. | |
| double | closedRingPotential (const std::vector< VectorXd > &beads, double spring, const BatchPotential &potential, const std::vector< double > &discretization={}) |
| U_N of a closed ring. | |
| void | instantonRate (RateInstanton &inst, const RingBeadHessian &hessian, const MatrixXd &hessReactant, double vReactant, const MatrixXd &hessSaddle=MatrixXd(), double vSaddle=0.0, long rigidModes=0, long denseLimit=4096, const RingRigidBodies &rigidBodies={}) |
| Fills the rate from the bead Hessians, the reactant minimum's Hessian and energy, and optionally the saddle's Hessian and energy for the classical comparison (pass an empty matrix to skip it). | |
| RotationZeroModes | rotationZeroModes (const MatrixXd &hess, const MatrixXd &generators, double fraction) |
| 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 secant residual and the step), then any negative eigenvalues beyond allowedNegatives, the count the block's last exact (finite-difference) version had, mirrored to their absolute value. | |
| 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). | |
| double | parabolicFactor (double temperature, double crossover) |
| (pi T_c / T) / sin(pi T_c / T). | |
| 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 | 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(beta hbar omega_r / 2) / prod'_s 2 sinh(beta hbar omega_s / 2) exp(-beta barrier), the zero-point and quantised partition functions of every bound mode; the saddle's unstable mode leaves the product. | |
| std::vector< AtomMatrix > | readRateRingSeed (const std::string &filename, const Matter &reference, long beads) |
| Read closed-ring geometry on the reference's ordered physical coordinates. | |
| MatrixXd | readReferenceHessian (const std::string &filename, const Matter &reference, long dimension) |
| Read a mass-weighted reference matrix bound to filename + ".con". | |
Variables | |
| constexpr double | kHbar = 0.06465415129579072 |
| hbar in eV^0.5 amu^0.5 Angstrom, correctly rounded from the exact SI values (h = 6.62607015e-34 J s, e = 1.602176634e-19 C) and the CODATA 2022 dalton, 1.66053906892e-27 kg. | |
| constexpr double | kBoltzmann = 8.617333262145177e-5 |
| Boltzmann constant in eV / K, correctly rounded from the exact 1.380649e-23 J / K. | |
| constexpr long | kDvrPointsPerLength = 20 |
| Grid points per oscillator length hbar / sqrt(hbar omega) of the stiffer well. | |
| constexpr double | kDvrPadLengths = 7.0 |
| Oscillator lengths the grid reaches past each minimum. | |
| constexpr long | kDvrMaxPoints = 1500 |
| Largest grid; a longer path takes a coarser spacing. | |
| constexpr double | kTimeUnitSeconds = 1.0180505717871193e-14 |
| One unit of time, sqrt(amu Angstrom^2 / eV), in seconds. | |
| constexpr double | kRotationZeroFraction = 0.1 |
| Which rotations of a structure are zero modes of its mass-weighted Hessian. | |
V (eV) and dV/dq (eV / (amu^0.5 Angstrom)) at every point of q, all in one call so a potential can spread the beads over its calculators.
Definition at line 238 of file Tunneling.h.
| using eonc::tunneling::BeadHessian = std::function<MatrixXd(long j, const VectorXd &q)> |
The mass-weighted Hessian d2V/dq2 at interior bead j (1..P-1).
Definition at line 248 of file Tunneling.h.
Explicit electronic-state owners for each evaluated geometry.
Definition at line 243 of file Tunneling.h.
| using eonc::tunneling::RingBeadHessian = std::function<MatrixXd(long j, const VectorXd &q)> |
The mass-weighted Hessian d2V/dq2 at ring bead j (0..N-1).
Definition at line 616 of file Tunneling.h.
| void eonc::tunneling::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.
Empty or all-zero eta leaves u and grad unchanged. A negative eta is refused. J. Chem. Phys. 156, 194106 (2022).
Definition at line 1339 of file Tunneling.cpp.
dvrLevels on a band: the profile between the images, and past each end the well's fit a s^2 + b s^3 continued, never softer than its parabola.
A sampled wall adds the residual of its samples against that fit, a cubic spline flat at the minimum and straight past the last sample.
Definition at line 689 of file Tunneling.cpp.
| Profile eonc::tunneling::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.
Definition at line 540 of file Tunneling.cpp.
| Splitting eonc::tunneling::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.
Definition at line 550 of file Tunneling.cpp.
| BandWalls eonc::tunneling::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.
(PRL 124, 225901 (2020), SI): the potential at points distances past each minimum, along the band's end segment continued outward, out to kDvrPadLengths oscillator lengths of that well. Each point is one force call.
Definition at line 749 of file Tunneling.cpp.
| void eonc::tunneling::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 secant residual and the step), then any negative eigenvalues beyond allowedNegatives, the count the block's last exact (finite-difference) version had, mirrored to their absolute value.
A negative count applies the plain update.
Definition at line 5213 of file Tunneling.cpp.
| double eonc::tunneling::closedRingPotential | ( | const std::vector< VectorXd > & | beads, |
| double | spring, | ||
| const BatchPotential & | potential, | ||
| const std::vector< double > & | discretization = {} ) |
U_N of a closed ring.
An empty discretization is the uniform spring. Otherwise one positive weight per bead divides the spring that leaves that bead.
Definition at line 4431 of file Tunneling.cpp.
| double eonc::tunneling::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 Hessian has no negative eigenvalue.
Definition at line 1317 of file Tunneling.cpp.
| double eonc::tunneling::cyclicRingLogAbsDet | ( | double | c, |
| const std::vector< MatrixXd > & | diag ) |
log|det| of the cyclic block-tridiagonal ring Hessian.
Each diag[j] already contains the bead Hessian plus 2 c I, and the neighbour coupling is -c I, including the corner that closes the ring. A singular ring, one whose closing pivot falls to 1e-12 of the corner's scale, returns -infinity. Throws when the open chain is singular.
Definition at line 2083 of file Tunneling.cpp.
| std::vector< VectorXd > eonc::tunneling::cyclicRingSolve | ( | double | c, |
| const std::vector< MatrixXd > & | diag, | ||
| const std::vector< VectorXd > & | rhs ) |
Solves that same cyclic ring Hessian.
Throws when the ring is singular or the right-hand side does not match the blocks.
Definition at line 2088 of file Tunneling.cpp.
| Levels eonc::tunneling::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, with V defined past both minima: fourth-order central differences on a uniform grid from kDvrPadLengths oscillator lengths before the reactant minimum to as far past the product's.
Definition at line 574 of file Tunneling.cpp.
| double eonc::tunneling::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.
rigidModes eigenvalues nearest zero are omitted at each Hessian. The saddle's most negative eigenvalue is the barrier mode and leaves the product. Throws std::invalid_argument when another reactant or saddle eigenvalue off the rigid modes is not positive: the reactant is then no minimum, or the saddle not of first order.
Definition at line 5352 of file Tunneling.cpp.
| double eonc::tunneling::hbarOmega | ( | double | curvature | ) |
hbar omega in eV for a mass-weighted curvature.
Definition at line 174 of file Tunneling.cpp.
| void eonc::tunneling::instantonRate | ( | RateInstanton & | inst, |
| const RingBeadHessian & | hessian, | ||
| const MatrixXd & | hessReactant, | ||
| double | vReactant, | ||
| const MatrixXd & | hessSaddle = MatrixXd(), | ||
| double | vSaddle = 0.0, | ||
| long | rigidModes = 0, | ||
| long | denseLimit = 4096, | ||
| const RingRigidBodies & | rigidBodies = {} ) |
Fills the rate from the bead Hessians, the reactant minimum's Hessian and energy, and optionally the saddle's Hessian and energy for the classical comparison (pass an empty matrix to skip it).
rigidModes is the count of rigid-body zero modes to omit: the translations, plus a rotation only when the reactant Hessian leaves it null (a free cluster has them, a crystal does not, and an atom held fixed has none). They leave the centroid factors. The translational partition functions of reactant and instanton cancel; the rotational ones do not, since the ring's moments of inertia are not the reactant's. With rigidBodies given and a rotation free, k Z_r carries their ratio, logRotationalRatio of the beads (Richardson's moments averaged over the ring), and the classical comparison that of rigidBodies.saddle; without it both are left out. On the ring the omitted directions are its null vectors: with rigidBodies given, the translations and rotations of the beads themselves about the ring's centre of mass (a rotation moves each bead differently), otherwise the reactant Hessian's null vectors copied to every bead, which are exact only for a coordinate every bead shares. The bead Hessians must then keep their rotational part: projecting a rotation out of a bead that is not stationary removes the curvature that balances its springs.
Up to denseLimit ring degrees of freedom, and for any negative limit, the determinant, the negative-mode count and the lowest eigenvalue come from the dense eigenvalues of the lifted ring Hessian, and a block-chain determinant that disagrees with them throws. Beyond that, and for a limit of 0, the block chain gives the determinant and the inertia, and a Lanczos run on ring products the lowest eigenvalue.
Definition at line 4805 of file Tunneling.cpp.
| void eonc::tunneling::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.
Definition at line 1180 of file Tunneling.cpp.
| double eonc::tunneling::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 reference (q = 0), for the free rotations: half the log of the ratio of the products of their principal moments, the inertia of every bead's atoms about the beads' common centre of mass, which is the Gram matrix of the ring's rotation generators.
Moments below 1e-8 of the largest (a linear structure's axis) leave both products. Zero with empty masses or no free rotation; throws when the beads and the reference turn about different numbers of axes. With one bead it is the saddle's ratio sqrt(det I_saddle / det I_reactant) of harmonic TST for a free cluster.
Definition at line 4397 of file Tunneling.cpp.
sqrt(sum_i m_i |b_i - a_i|^2) under the minimum image of a's cell.
Definition at line 61 of file Tunneling.cpp.
| std::vector< double > eonc::tunneling::massWeightedPath | ( | const std::vector< std::shared_ptr< Matter > > & | band | ) |
Cumulative mass-weighted arc length at each image of a band.
Definition at line 79 of file Tunneling.cpp.
| Instanton eonc::tunneling::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 straight line).
Evaluates the interior beads once per iteration and line-search step.
Definition at line 1032 of file Tunneling.cpp.
| RateInstanton eonc::tunneling::optimizeRateInstanton | ( | const VectorXd & | saddle, |
| const MatrixXd & | hessSaddle, | ||
| double | beta, | ||
| std::vector< VectorXd > | guess, | ||
| const BatchPotential & | potential, | ||
| const RateInstantonOptions & | options ) |
Finds the rate instanton at inverse temperature beta (1 / eV).
guess holds N beads, or is empty for a ring stretched along the saddle's unstable mode to where V has dropped by (1 - T / T_c) of the lower of the two barriers. At or below newtonLimit active coordinates the step is an index-1 Newton step on a Bofill Hessian, and below 0.75 T_c an empty guess cools from 0.85 T_c. Beyond that limit the step is the dimer in MinModeSaddleSearch on one ring structure. An even ring whose beads match under j -> N - j is evaluated from one turning point to the other and mirrored. saddle and hessSaddle are mass-weighted.
Definition at line 4151 of file Tunneling.cpp.
| double eonc::tunneling::parabolicFactor | ( | double | temperature, |
| double | crossover ) |
(pi T_c / T) / sin(pi T_c / T).
Defined only above T_c. The factor diverges as T approaches T_c from above and tends to 1 at high T.
Definition at line 5261 of file Tunneling.cpp.
| double eonc::tunneling::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, the larger of the two; in 1 / time.
Definition at line 1021 of file Tunneling.cpp.
| double eonc::tunneling::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(beta hbar omega_r / 2) / prod'_s 2 sinh(beta hbar omega_s / 2) exp(-beta barrier), the zero-point and quantised partition functions of every bound mode; the saddle's unstable mode leaves the product.
Times the parabolic factor it is the steepest-descent ring-polymer rate above T_c as N -> infinity. That factor diverges at T_c, as the instanton's fluctuation prefactor does from below, so neither rate holds near the crossover and the two do not join there. Its high-temperature limit is harmonicTstLogRate. Checks the Hessians as harmonicTstLogRate does.
Definition at line 5375 of file Tunneling.cpp.
|
inline |
Read closed-ring geometry on the reference's ordered physical coordinates.
Cached energies and forces do not participate in the seed.
Definition at line 20 of file RateRingSeed.h.
|
inline |
Read a mass-weighted reference matrix bound to filename + ".con".
The caller verifies external-potential and finite-difference provenance.
Definition at line 22 of file ReferenceHessian.h.
| RingChannel eonc::tunneling::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).
Definition at line 5218 of file Tunneling.cpp.
| std::vector< VectorXd > eonc::tunneling::ringFromPath | ( | const std::vector< VectorXd > & | path, |
| const std::vector< double > & | energies, | ||
| double | betaHbar, | ||
| long | beads, | ||
| RingSeed * | seed ) |
Definition at line 304 of file Tunneling.cpp.
| RingSpectrum eonc::tunneling::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, with the normalised direction tau (N beads) lifted by c and taken out again through the determinant lemma det(J + c tau tau^T) = (c + lambda_0) det' J, exact when J tau = lambda_0 tau.
Block LU of the open chain plus a low-rank correction for the closure and tau, O(N f^3).
Definition at line 2062 of file Tunneling.cpp.
| RotationZeroModes eonc::tunneling::rotationZeroModes | ( | const MatrixXd & | hess, |
| const MatrixXd & | generators, | ||
| double | fraction ) |
Definition at line 5172 of file Tunneling.cpp.
| bool eonc::tunneling::singleBarrier | ( | const Profile & | p | ) |
Whether a profile is one double well: its images rise to exactly one maximum between the two ends.
A path with an intermediate minimum is no two-level system.
Definition at line 557 of file Tunneling.cpp.
| double eonc::tunneling::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 to the points within half the barrier above that end.
The cubic term takes the anharmonic part a parabola alone would fold into the curvature.
Definition at line 131 of file Tunneling.cpp.
| std::array< double, 2 > eonc::tunneling::wellFit | ( | const Profile & | p, |
| bool | leftEnd ) |
{a, b} of that fit, s measured inward from the end: wellCurvature is 2 a.
Definition at line 135 of file Tunneling.cpp.
| double eonc::tunneling::wkbAction | ( | const Profile & | p, |
| double | energy, | ||
| int | points ) |
(1/hbar) integral sqrt(2 (V(s) - E)) ds over the path where V > E.
Definition at line 181 of file Tunneling.cpp.
| double eonc::tunneling::wkbLogRateAlongPath | ( | const Profile & | profile, |
| double | beta, | ||
| double | hwReactant ) |
ln(k), k in 1/time, for the one-dimensional thermal rate along profile.
hwReactant is hbar omega of the reactant well, in eV. Below the barrier the transmission is the WKB factor; above it, the parabolic continuation.
Definition at line 468 of file Tunneling.cpp.
delta0 = (hbar omega / pi) exp(-S) with the Landau and Lifshitz prefactor.
The level is the higher of the two harmonic ground states, V_i + hbar omega_i / 2, and omega is the geometric mean of the wells; for a symmetric double well both reduce to the textbook formula.
Definition at line 200 of file Tunneling.cpp.
| double eonc::tunneling::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 difference of the sums of the vibrational frequencies of the two mass-weighted Hessians.
At each, the rigidModes eigenvalues nearest zero are left out, and another eigenvalue below zero is no vibration. Added to V(end) - V(start) it is the diagonal term of the two-level Hamiltonian, the asymmetry of the local ground states (Anderson, Halperin and Varma 1972; Jahr, Laude and Richardson, J. Chem. Phys. 153, 094101 (2020)).
Definition at line 1263 of file Tunneling.cpp.
|
inlineconstexpr |
Boltzmann constant in eV / K, correctly rounded from the exact 1.380649e-23 J / K.
Definition at line 43 of file Tunneling.h.
|
inlineconstexpr |
Largest grid; a longer path takes a coarser spacing.
Definition at line 137 of file Tunneling.h.
|
inlineconstexpr |
Oscillator lengths the grid reaches past each minimum.
Definition at line 135 of file Tunneling.h.
|
inlineconstexpr |
Grid points per oscillator length hbar / sqrt(hbar omega) of the stiffer well.
Fourth-order differences at this spacing put a quartic double well's gap within 2e-5.
Definition at line 133 of file Tunneling.h.
|
inlineconstexpr |
hbar in eV^0.5 amu^0.5 Angstrom, correctly rounded from the exact SI values (h = 6.62607015e-34 J s, e = 1.602176634e-19 C) and the CODATA 2022 dalton, 1.66053906892e-27 kg.
Definition at line 39 of file Tunneling.h.
|
inlineconstexpr |
Which rotations of a structure are zero modes of its mass-weighted Hessian.
generators holds three translations then three rotations as columns (a zero column for a rotation a linear molecule lacks). A rotation r is a zero mode when its Rayleigh quotient r^T H r / r^T r is at most fraction (default kRotationZeroFraction) of the softest vibration, the lowest eigenvalue of H on the complement of all six generators. Both sides scale with H and neither grows with the atom count, unlike a comparison with ||H||_F. The residual reported is that ratio; a structure with no positive vibration on the complement has no rotational zero modes.
Definition at line 597 of file Tunneling.h.
|
inlineconstexpr |
One unit of time, sqrt(amu Angstrom^2 / eV), in seconds.
Definition at line 350 of file Tunneling.h.