Repository navigation
ace-jax 0.5.2
Highlights. POPS uncertainty (aj fit --uq pops) is numerically defined on fits that nearly
interpolate their data, and its defaults follow the reference package POPSRegression. Fits can be
resumed after an interruption.
Upgrading from 0.5.1. Saved models and posteriors are unchanged. An aj fit --uq pops run can give
a different, narrower POPS box than in 0.5.1:
- The box is built from the rows at or above the median leverage (
FitConfig.pops_leverage_pct = 50,
POPSRegression'sleverage_percentiledefault). 0.5.1 used every row, and on the silicon
accuracy-cost fits the low-leverage rows made the box unphysical. Setpops_leverage_pct=0in
Python for the 0.5.1 behaviour. - The ridge selection stops at a relative ridge of
1e-10(predict.POPS_MIN_RIDGE). The 0.5.1 grid
went down to1e-14, where the box is set by round-off.
Fixed
- POPS numerics (#141). On the silicon o3d12 fit (condition number 5e16, with sigma_c on its
bound), the Cholesky of the ridge system was not finite. The BLR mean, the test predictions and every
ridge-selection score were then NaN, and the selection silently returned the first grid value.- The POPS mean now falls back, with a warning, to the streamed QR (
solve.posterior_qr). The QR
does not square the condition number. - Ridge selection raises
FloatingPointErrorwhen every score of a quantity is non-finite. POPS_MIN_RIDGE = 1e-10: below it the box is set by the round-off of the eigendecomposition. Four
equivalent evaluations of one box at1e-14gave bulk-energy spreads from 1.6 to 78 meV/atom. A
smaller ridge warns, and the default grid stops at it.- The default leverage cut is 50 % (see Upgrading). With the same rows, mean, ridge and cut,
POPSRegression's own hypercube step agrees with a stable evaluation of the port.
- The POPS mean now falls back, with a warning, to the streamed QR (
Added
- Resumable fits (
aj fit --checkpoint DIR,--checkpoint-every MIN, default 45). The training
statistics pass saves its QR factors to DIR at that interval, and the MAP saves its best
hyperparameters after each evaluation. Run the same command again to resume. A complete statistics pass
is kept, so a fit stopped later does not repeat it. The statistics checkpoint applies on the CPU
backend. It needs 8 L^2 bytes per quantity on disk (approximately 9 GB at L = 20,000).