---
title: "Pyro obstacles: gas around spheres, boxes, cylinders, capsules and carved shapes"
description: "Pyro [[obstacles]] are solids the gas flows around: spheres, boxes, cylinders, capsules, carved holes and moving solids, with holdout and shadow in the sheets."
canonical: https://appliedmanifold.com/docs/pyro/obstacles/
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.  Obstacles

DOCS // PYRO 0.4.1

# Obstacles

`[[obstacles]]` are solids the gas flows around: spheres, boxes, cylinders and capsules, with `carve = true` cutting holes such as a window in a wall. Keys move and turn them, and `holdout` and `shadow` hide and shade the gas in the sheets.

## A wall with a window

The window fire example builds a room from three obstacles: a block, the room carved out of it, and the window carved through its front.

window\_fire.pyro.toml (excerpt)

```
# The building: fills the back of the box from the floor to the top. Its front is at Z = -0.5,
# which leaves 3 m of open air in front for the flame to roll out into.
[[obstacles]]
shape = "box"
position_m = [0, 4, -1.5]
size_m = [2.5, 4, 1.0]

# The room inside it, with a wall 0.2 m thick in front.
[[obstacles]]
shape = "box"
carve = true
position_m = [0, 1.3, -1.5]
size_m = [1.3, 1.1, 0.8]

# The window through that wall.
[[obstacles]]
shape = "box"
carve = true
position_m = [0, 1.5, -0.6]
size_m = [0.7, 0.65, 0.25]
```

## Fields

| Field | Meaning | Default |
| --- | --- | --- |
| `shape` | `sphere`, `box`, `cylinder` or `capsule`; a cylinder and a capsule stand along their own Y | `sphere` |
| `position_m` | Center (t). Keys move the solid, and it pushes the gas ahead of it. | `[0, 1, 0]` |
| `size_m` | Radius of a sphere, cylinder or capsule; half-extents of a box (t) | 0.5 |
| `height_m` | Full length of a cylinder; length of the straight part of a capsule (t) | 1.0 |
| `rotation_deg` | Turns the solid (t). Keys spin it, and the spin drags the gas at its surface. | `[0, 0, 0]` |
| `carve` | Removes its shape from the obstacles listed before it; the first obstacle cannot carve | false |
| `holdout` | Hides the gas behind it in the sheets, as the real object will once the engine draws it | true |
| `shadow` | Blocks the light, so gas in its shade is darker | true |
| `start_s`, `end_s` | When it is there; `end_s = 0` never leaves | 0, 0 |

## How solids combine

-   Obstacles are laid down in spec order, so a later solid fills a hole an earlier `carve` made, and a later `carve` cuts every solid before it.
-   A solid is never thinner than one cell, at draft too, and one cell stops the gas at any angle.
-   A solid may stand outside the part of the box the camera frames: it still hides and still shades.
-   The solid itself is not drawn; it stands in for an object the engine draws. With `holdout` on it leaves a clean hole in the sheet for that model.
-   Keep emitters clear of solids: an emitter that pokes through a wall also burns on the far side.
