# kalika-phonons (Python)

DFPT integration scripts and Phonopy/Phono3py validation utilities that
accompany the TypeScript/Rust `@kalika/phonons` library.

This package deliberately contains no result-fabricating stubs. Where an
external code (Phonopy, Phono3py, Quantum ESPRESSO `ph.x`) is required, the
driver either shells out to the real executable or raises a clear error if it is
not installed — it never invents phonon frequencies.

## Modules

- `kalika_phonons.force_constants` — read/write Phonopy `FORCE_CONSTANTS`
  format, validate the acoustic sum rule, and fold to primitive-cell blocks.
- `kalika_phonons.validation` — compare frequency sets against a reference
  (RMS/max deviation, per-branch statistics) for regression-testing the Kalika
  solver against Phonopy output.
- `kalika_phonons.dfpt` — build Quantum ESPRESSO `ph.x` / `matdyn.x` input
  decks and parse their `dynmat`/`.freq` output.

## Usage

```bash
pip install -e ".[dev]"
pytest
```
