Skip to content

Physical data and calculations

elfes.physics defines the physical objects shared by DFT readers, datasets, and model predictions. It gives numerical values a common interpretation: which atoms and basis functions they belong to, how boundary conditions enter, and how the quantities transform under rotations. Its data objects and calculations use NumPy.

Geometry and samples is the starting point. A geometry describes the atomic system; a sample brings that geometry together with its basis sets and physical quantities. Atom-centered bases define the functions and orbital ordering used to interpret quantities expressed in a basis.

The quantities themselves retain the information needed for the task. Cartesian quantities describe scalars, vectors, and tensors such as energies, forces, and stress. Orbital quantities retain basis-function indices, while grids and volumetric quantities describe functions sampled in real space. These forms can coexist within one sample.

Symmetry operations provide the spherical harmonics, rotation matrices, and Pauli conversions used by these representations. Physical calculations build on the objects to evaluate basis functions and integrals, project densities, and solve orbital eigenproblems. Differentiable Torch operations are documented separately under elfes.modules.