Skip to content

elfes.io.basis

Read and write ELFES basis sets and prepared overlap tables.

The JSON and HDF5 formats store complete radial basis definitions rather than references to an external basis library or source file. Standalone HDF5 basis files use the same group structure as complete basis definitions embedded in an ELFES HDF5 dataset. Overlap-table files separately store derived two-center integrals and the shell layout needed to use them.

read_gaussian_basis

read_gaussian_basis(path: StrPath) -> GaussianBasisSet

Read and validate a Gaussian-basis JSON file.

write_gaussian_basis

write_gaussian_basis(path: StrPath, basis_set: GaussianBasisSet) -> None

Write deterministic Gaussian-basis JSON.

read_hdf5_basis

read_hdf5_basis(path: StrPath) -> CompleteBasisSet

Read one complete basis set from a standalone ELFES HDF5 file.

write_hdf5_basis

write_hdf5_basis(
    path: StrPath, basis_set: CompleteBasisSet, *, overwrite: bool = False
) -> None

Atomically write one complete basis set to a standalone ELFES HDF5 file.

read_hdf5_overlap_tables

read_hdf5_overlap_tables(path: StrPath) -> UniformNumericalOverlapTables

Load tables into memory, retaining their stored precision and channel order.

write_hdf5_overlap_tables

write_hdf5_overlap_tables(path: StrPath, tables: UniformNumericalOverlapTables) -> None

Write FP32/FP64 table arrays without converting their precision.

Distances and shell cutoffs are in Å. Pair datasets follow the channel ordering documented by UniformNumericalOverlapTables; the distance grid starts at zero. No source radial functions are stored.

read_spline_numerical_basis

read_spline_numerical_basis(path: StrPath) -> SplineNumericalBasisSet

Read and validate a spline numerical basis JSON file.

write_spline_numerical_basis

write_spline_numerical_basis(path: StrPath, basis_set: SplineNumericalBasisSet) -> None

Write deterministic spline numerical basis JSON.

read_uniform_numerical_basis

read_uniform_numerical_basis(path: StrPath) -> UniformNumericalBasisSet

Read and validate a uniform-numerical-basis JSON file.

write_uniform_numerical_basis

write_uniform_numerical_basis(
    path: StrPath, basis_set: UniformNumericalBasisSet
) -> None

Write deterministic uniform-numerical-basis JSON.