Repository navigation
Release on top of 0.6.1.
1. Uncertainty-driven exploration: grace_uq hal
grace_uq hal runs molecular dynamics biased towards high extrapolation grade γ and collects the structures where γ is high, as candidates for new training data.
- Ensembles:
nvt,nvt_ramp,npt,npt_stress,cluster. - Many walkers in one call:
--ensemble,-Tand--tautake several values,--repeats Kruns K walkers per setting,--walkers-per-gpu Mshares the GPUs. Several--tauvalues alone are a τ scan. - Each walker writes its frames, a history and a diagnostics plot;
walkers.csvsummarises all walkers.
Then grace_uq select --hal-dirs ... picks the structures to label.
Docs: UQ workflows tutorial, grace_uq hal
2. grace_uq select and grace_uq predict
- New default strategy
calm-greedy: picks the most extrapolative frame first, skips similar ones, and stops at the natural set (-nis optional). The old default wasrandom-extrap. - Several strategies in one call, applied in order, e.g.
--strategy calm-greedy fps-extrap:25 random-all:25. --hal-dirsfinds walker folders at any depth;--model-dirtakesmodel.yamland the checkpoint from a fit folder.grace_uq predictreads LAMMPS text dumps as--dataset, and--n-workers autois the default.
3. Changed defaults — please check
grace_fmswitches UQ off by default, because UQ makes the calculator slower. Before, UQ was on whenever the model had it. To get γ:grace_fm(name, enable_uq=True)orcalc.enable_uq().calc.enable_uq()uses thegamma_onlymode by default (γ and σ, no extra backward pass). Fordsigma_dr/virial_sigmausecalc.enable_uq(mode="full").grace_uq buildreads thresholds from a σ histogram with about 1 % wide bins (before: a fixed width of 0.4).grace_uq buildandgrace_uq infowarn about clusters whose σ spread is too narrow; rebuild such artifacts.
4. Fixes and smaller changes
grace_uq build --exportworks again with checkpoints written before mid-epoch saving existed.- A cache folder with only
kokkos.npzno longer counts as a downloaded model. - The calculator does not recompile for a small drop in the number of neighbours.
cutoff_dict: an explicit element pair wins over a wildcard entry.gen_tensor:[1, 2]tensors are checked as traceless only; metrics per tensor component.extxyz2df/df2extxyz: sensible default output names, and the input is never overwritten.gracemaker -twritesscheduler_paramskeys that the schedulers actually read.
5. Docs and examples
- New UQ workflows tutorial, with two small GRACE-1L tutorial models in
examples/data(Al-Li, ethanol). - Reworked pages: foundation models, input file, generic tensors, utilities, FAQ.
- The UQ method is now named CALM: Lysogorskiy, Bochkarev and Drautz, arXiv:2609.40060.