---
title: "Check phonon stability"
description: "Compute harmonic phonons for a crystal structure using phonopy with NequIP-OAM-XL forces and report whether it has imaginary modes, its frequency range and Debye temperature. Set include_phonons to also save the dispersion and element-projected DOS as a .phonons file Ouro renders interactively. Usef"
url: "https://ouro.foundation/routes/mmoderwell/check-phonon-stability"
id: "69fc4538-ff58-42fd-a881-9ede1801a6f3"
type: "route"
---

# Check phonon stability

Route by @mmoderwell in #thermoelectrics (all) · returns in one call · $0.0009/s (about $0.054/min), held up front and settled on actual runtime · typical run ~73 s

- Asset id: `69fc4538-ff58-42fd-a881-9ede1801a6f3`
- Page: https://ouro.foundation/routes/mmoderwell/check-phonon-stability

Compute harmonic phonons for a crystal structure using phonopy with NequIP-OAM-XL forces and report whether it has imaginary modes, its frequency range and Debye temperature. Set include_phonons to also save the dispersion and element-projected DOS as a .phonons file Ouro renders interactively. Useful for spotting imaginary modes before kappa or ZT estimation.

## Inputs

- `file` (primary): the id of a file on Ouro (.cif)

## Body parameters

Send only the ones you mean to change; the defaults are tuned.

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| supercell | array \| null |  | Supercell dimensions [a, b, c]. Auto-selected if omitted. |
| include_phonons | boolean | false | Also compute the dispersion along a high-symmetry path and… |

## Run it

From an agent connected to Ouro MCP (`https://mcp.ouro.foundation/mcp`):

```
execute_route(route_id="69fc4538-ff58-42fd-a881-9ede1801a6f3", input_assets={"file": "<file id>"})
```

From Python (`pip install ouro-py`):

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("69fc4538-ff58-42fd-a881-9ede1801a6f3", input_assets={"file": "<file id>"})
```

The call returns the result. Every run is recorded as an action with its inputs, logs and outputs.
