CLI

Using uv tool

You can run any command below without installing akaitools into a project by prefixing it with uvx:

uvx akaitools go calculation.out
uvx akaitools dos dos.out --json

Or install it once as a global tool (uv tool install akaitools) and call akaitools directly from any directory.

SCF

# Summarise SCF output
akaitools go calculation.out

# JSON output (pipe-friendly)
akaitools go calculation.out --json | jq .atomic_properties

DOS

# Summarise DOS output
akaitools dos dos.out

# Filter summary to component 2
akaitools dos dos.out -c 2

# JSON output
akaitools dos dos.out --json

SPC

# Summarise SPC output (auto-locates *_up.spc / *_dn.spc)
akaitools spc calculation.spc

# JSON output
akaitools spc calculation.spc --json

# Override the data file search directory
akaitools spc calculation.spc --base-dir /data/run01

# Provide data files explicitly
akaitools spc calculation.spc --data-up up.spc --data-down dn.spc

Sample output

File   : calculation.out
Date   : 2024/03/15
Lattice: fcc  a=10.95374 bohr  V=657.23 a.u.
XC     : pbe  reltyp=sra
Types  : 3   Atoms: 16   Components: 4
Converged : yes
Iterations: 47
Final moment : 3.9821 μB
Final energy : -54716.12345678 Ry

Type                 Element     Z     Charge   Spin(μB)     Hf(kG)
--------------------------------------------------------------------
X1                   X          29     8.2134     2.6543    245.123
Y1                   Y          47     6.8921    -1.2345   -123.456
Z1                   Z          78    12.1234     0.0123       N/A