45 std::string_view metric) {
47 return freeForces.norm();
48 if (metric ==
"max_atom")
50 if (metric ==
"max_component")
51 return freeForces.size() == 0 ? 0.0 : freeForces.cwiseAbs().maxCoeff();
52 throw std::invalid_argument(
"OCINEB: unknown convergence metric");
58 2.0 *
cfg_.force_tolerance);
62 long climbingImage,
long numImages,
63 int ciStabilityCounter)
const {
64 if (!
cfg_.use_mmf || !ci_active)
66 if (climbingImage <= 0 || climbingImage > numImages)
68 if (ciStabilityCounter <=
static_cast<int>(
cfg_.ci_stability_count))
70 if (convForce <=
cfg_.force_tolerance)
90 "Triggering MMF. Force: {:.4f}, Threshold: {:.4f} "
97 const long walked =
neb.climbingImage;
99 const double previousWalkedForce =
101 neb.params.optimizer_options().convergence_metric);
104 const AtomMatrix savedForces =
neb.path[walked]->getForcesRaw();
105 const double savedEnergy =
neb.path[walked]->getPotentialEnergy();
107 double alignment = 0.0;
111 neb.movedAfterForceCall =
true;
113 double newForce =
neb.convergenceForce();
119 QUILL_LOG_DEBUG(
log,
"NEB converged after MMF. Force: {:.4f}", newForce);
120 return {newForce,
true,
false};
123 const double walkedForce =
125 neb.params.optimizer_options().convergence_metric);
126 const bool mmfHelped =
127 walkHelped(walkedForce, previousWalkedForce, mmfResult);
132 "MMF helped (status={}, walked={}, now_ci={}). "
133 "Walked force: {:.4f} -> {:.4f} ({:.2f}x baseline). "
134 "Band CI force: {:.4f}. New threshold: {:.4f}",
135 mmfResult, walked,
neb.climbingImage, previousWalkedForce,
144 const bool restore =
cfg_.restore_unhelpful || mmfResult == -2;
146 neb.path[walked]->setPositions(savedPositions);
147 neb.path[walked]->setEvaluation(savedForces, savedEnergy);
148 neb.movedAfterForceCall =
true;
150 newForce = convForce;
155 "MMF backoff (status={}, walked={}, now_ci={}). "
156 "Walked force: {:.4f} -> {:.4f}, band CI: {:.4f}, "
157 "Alignment: {:.3f}. {}New threshold: {:.4f} ({:.2f}x baseline)",
158 mmfResult, walked,
neb.climbingImage, previousWalkedForce, walkedForce,
167 std::span{
neb.path.data(),
neb.path.size()});
168 neb.movedAfterForceCall =
true;
172 mmfHelped || (savedPositions -
neb.path[walked]->getPositions()).norm() >
173 neb.params.optimizer_options().max_move *
174 neb.params.neb_options().image_count;
177 QUILL_LOG_DEBUG(
log,
"Resetting optimization history.");
182 return {newForce,
false, shouldReset};
190 if (
neb.climbingImage <= 0 ||
neb.climbingImage >
neb.numImages) {
191 QUILL_LOG_WARNING(
log,
"Invalid climbing image for MMF: {}",
200 initialMode = *
neb.tangent[
neb.climbingImage];
202 double tangentNorm = initialMode.norm();
203 if (tangentNorm < 1e-8) {
204 QUILL_LOG_WARNING(
log,
"Tangent too small for MMF initialization");
207 initialMode /= tangentNorm;
209 auto tempMinModeSearch = std::make_shared<MinModeSaddleSearch>(
210 neb.path[
neb.climbingImage], initialMode,
211 neb.path[
neb.climbingImage]->getPotentialEnergy(),
neb.params,
neb.pot);
215 minModeStatus = tempMinModeSearch->run(
cfg_.max_steps);
218 QUILL_LOG_DEBUG(
log,
"MMF: Dimer restored to best state");
221 QUILL_LOG_WARNING(
log,
"Dimer lost mode during MMF refinement");
226 double eigenvalue = tempMinModeSearch->getEigenvalue();
227 if (eigenvalue > 0.0) {
228 QUILL_LOG_WARNING(
log,
229 "MMF skipped: Positive curvature detected (eig={:.4f}).",
234 AtomMatrix finalModeMatrix = tempMinModeSearch->getEigenvector();
236 VectorXd::Map(finalModeMatrix.data(), finalModeMatrix.size());
237 VectorXd currentTangent =
238 VectorXd::Map(
neb.tangent[
neb.climbingImage]->data(),
239 neb.tangent[
neb.climbingImage]->size());
240 if (finalMode.size() != currentTangent.size()) {
241 QUILL_LOG_WARNING(
log,
242 "MMF mode size {} != tangent size {}; skip alignment",
243 finalMode.size(), currentTangent.size());
245 }
else if (finalMode.norm() == 0.0 || currentTangent.norm() == 0.0) {
249 std::abs(finalMode.normalized().dot(currentTangent.normalized()));
254 if (alignment <
cfg_.angle_tol) {
257 "MMF converged/restored but mode drifted (alignment={:.3f} < {:.3f})",
258 alignment,
cfg_.angle_tol);
267 QUILL_LOG_WARNING(
log,
"MMF failed. Mode-tangent alignment: {:.3f}",
277 2.0 *
cfg_.force_tolerance);
282 double alpha = std::clamp(alignment, 0.0, 1.0);
283 double penalty_factor = 0.5 + 0.5 * alpha;
290 double min_threshold = 2.0 *
cfg_.force_tolerance;
Eigen::Matrix< double, Eigen::Dynamic, 3, eOnStorageOrder > AtomMatrix
@ STATUS_BAD_MAX_ITERATIONS
@ STATUS_DIMER_RESTORED_BEST
const neb_options_t & neb_options() const
static bool walkHelped(double walkedForce, double convForce, int mmfStatus)
bool shouldTrigger(double convForce, bool ci_active, long climbingImage, long numImages, int ciStabilityCounter) const
static Config fromParams(const Parameters ¶ms)
OCINEBController(const Config &cfg)
void updateThresholdSuccess(double convForce, double newForce)
void updateStability(long climbingImage)
long previousClimbingImage_
MMFResult run(eonc::NudgedElasticBand &neb, double convForce)
int runDimer(eonc::NudgedElasticBand &neb, double &alignment)
void initBaseline(double baseline_force)
double current_threshold_
static double forceMeasure(const AtomMatrix &freeForces, std::string_view metric)
Measure free-atom forces with the band's configured convergence metric.
void updateThresholdBackoff(double alignment)
static bool convergedClimb(double bandForce, double forceTolerance, int mmfStatus)
void resamplePathInPlace(std::span< std::shared_ptr< Matter > > path)
In-place path reparameterization for NEB shared_ptr paths.
quill::Logger * get() noexcept
Get or create the default "combi" logger.
double maxFreeAtomForceNorm(const double *forces, const double *fixed, long nAtoms)
Max Euclidean norm over N x 3 row-major force rows.
struct eonc::neb_options_t::climbing_image_options_t::hybrid_dimer_t ocineb
struct eonc::neb_options_t::climbing_image_options_t climbing_image