Changelog#
1.0.0 - 2026-10-28#
Added#
safiretoolsPython package, replacingafqmctoolsWalker weight bound.
Versioning of all HDF5 files written by SAFIRE and safiretools. Starting at format version 1.
binsizeinput parameter.BCC Na momentum distribution example.
Changed#
The executable takes a single positional argument, the job file (–filenames is gone).
Various changes to the job file format
timestepandstepsare now mandatory.n_walkers_per_mpi_taskwas replaced bynum_walkers, the total number of walkers.walker_typeis now optional and inferred from the wavefunction and Hamiltonian.seedmoved to the top level. The driver moved from a top-level key into adriverfield, andprojectwas renamed tooutput_name.Out-of-line
ham,wfn,wset, andpropblocks were renamed to their plurals. Input paths are resolved relative to the job file. A wavefunction-only file can fall back to the Hamiltonian filename.New estimator parameter format.
measurement_intervalis decoupled from the population control interval.Renamed
use_real_vbiastoproject_force_bias,substractMFtosubtractMF, anddshifttoEshift_relaxation_rate.equilibration_timehas a reasonable default.
HDF5 formats: scalars are stored as attributes, Cholesky storage is unified, the sparse format is simplified, the dense
hcoreis rank 5, and the k-point factorized format resembles the dense one.Walkers are always initialized from a wavefunction. The PHMSD type is inferred from
Psi_T.All results of a run are written to a single output file in a new measurement format.
Population control was simplified to the comb method with asynchronous exchange.
serial_combis the automatic choice.The \(\mathrm{Re}(v_\mathrm{MF}^2/2)\) factori and \(E_0\) are now always included in the hybrid energy so that it matches the local energy.
Eshiftis always initialized from the starting energy.The vbias bound no longer includes \(\sqrt{\Delta\tau}\).
Lattice basis vectors are given in fractional coordinates.
from_latticeexposes all terms, andspin_symmis inferred inHamiltonianBuilder.from_input.PySCF SCF objects are accepted directly instead of checkpoint files.
The Python sources moved from
utilstopython.The default colormap for lattice visualizations is
RdBu_r.Functional tests use
safiretools, with a continuous crossover between machine and statistical tolerance.Documentation was rewritten for
safiretoolsand the new input format. The HamiltonianBuilder tutorial was merged into the models tutorial on building and writing a Hamiltonian.
Removed#
afqmctools.--filenamescommand line option.importance_sampling,apply_constraint,external_field, excitations, and CSAFQMC leftovers.Psi0,dimsarrays, and other unnecessary HDF5 datasets.AutoHF,
nelecon Hamiltonians, MPI in the periodic Cholesky factorization, the numba dependency, andforce_hermitianfromsafiretools.
Fixed#
G_MFwith multiple determinants.Estimator GPU path.
free_propagation.Eshiftinitialization.Out-of-bounds PHMSD excitations.
SAFIRE now aborts when the Hamiltonian has no interaction.