# kalika-molecular-dynamics (Python interop)

Python interoperability for the `@kalika/molecular-dynamics` library.

- **`ase_calculator`** — expose Kalika force fields as an ASE `Calculator`,
  including bidirectional `Atoms` / `MDSystemState` conversion, energy, force,
  virial/stress, optimizer, NEB, and phonon workflow compatibility.
- **`lammps_input`** — generate LAMMPS input scripts from a `SimulationConfig`
  (units, pair_style/pair_coeff, NVE/NVT/NPT fixes, thermo, dump).
- **`plumed`** — generate PLUMED input files for metadynamics and umbrella
  sampling, and parse PLUMED `COLVAR` / `HILLS` output.

## Tests

```bash
cd libs/kalika/molecular-dynamics/python
PYTHONPATH=. pytest -q
```

Install the ASE interoperability extra with
`pip install 'kalika-molecular-dynamics[ase]'`.
