---
title: "Pyro values over time: keyframes and easing on any animatable spec field"
description: "How pyro fields change during a clip: a constant or keys over simulated seconds, with linear, smooth or step easing, on emitters, forces, obstacles and solver."
canonical: https://appliedmanifold.com/docs/pyro/values-over-time/
site: "Applied Manifold: The spatial compute cloud for 3D reality"
---

1.  [Home](https://appliedmanifold.com/)
2.  [Docs](https://appliedmanifold.com/docs/)
3.  [Pyro](https://appliedmanifold.com/docs/pyro/)
4.  Values over time

DOCS // PYRO 0.4.1

# Values over time

Any field marked animatable takes either a constant or keys over simulated seconds, such as `fuel = [[0.0, 4.0], [0.5, 0.0]]`. The value blends between keys with linear, smooth or step easing and holds outside them.

## Syntax

This excerpt comes from the spec reference:

values over time

```
fuel = 4.0                                        # constant
fuel = [[0.0, 4.0], [0.5, 0.0]]                   # keys: [seconds, value]
position_m = [[0, -3, 1, 0], [2, 3, 1, 0]]        # keys of a vector: [seconds, x, y, z]
fuel = { keys = [[0, 4], [0.5, 0]], ease = "smooth" }   # ease: linear (default), smooth or step
```

-   A key is `[seconds, value]`, or `[seconds, x, y, z]` for a vector.
-   The value blends between keys and holds before the first key and after the last. Key times must rise.
-   `ease` is `linear` (the default), `smooth` or `step`.
-   `spatial-compiler schema` marks these fields `"animatable": true`.
-   Keys work on the command line too: `--set emitters.0.fuel=[[0,4],[0.5,0]]`.

## Which fields take keys

| Section | Fields |
| --- | --- |
| `[[emitters]]` | `position_m`, `size_m`, `thickness_m`, `rotation_deg`, `fuel`, `temperature_k`, `smoke`, `dust`, `velocity_mps`, `direction`, `spread_deg`, `jitter`, `lumpiness` |
| `[[forces]]` | `position_m`, `size_m`, `rotation_deg`, `falloff`, `strength`, `direction`, `max_speed_mps` |
| `[[obstacles]]` | `position_m`, `size_m`, `height_m`, `rotation_deg` |
| `[solver]` | `buoyancy`, `burn_rate`, `ignition_k`, `flame_k`, `expansion` and more |

`schema` is the full list for the version you run.

## Moving things

Keys on `position_m` move an [emitter](https://appliedmanifold.com/docs/pyro/emitters/) or an [obstacle](https://appliedmanifold.com/docs/pyro/obstacles/), and keys on `rotation_deg` turn it. A moving solid pushes the gas ahead of it, and a spinning one drags the gas at its surface.
