# Reference

Use this section while building and operating simulations. The [API map](api.md) documents the public surface used by the validated examples; configuration and CLI pages cover repeatable execution.

::::{grid} 1 2 2 2
:gutter: 3

:::{grid-item-card} Python API
:link: api
:link-type: doc

Core configuration, geometry, sources, detectors, modes, and execution functions.
:::

:::{grid-item-card} Configuration recipes
:link: configuration
:link-type: doc

Automatic grids, boundaries, symmetry, gradients, and memory-aware defaults.
:::

:::{grid-item-card} Benchmark CLI
:link: benchmark_cli
:link-type: doc

List, run, diagnose, smoke-test, and report validation cases.
:::

:::{grid-item-card} Output and diagnostics
:link: output
:link-type: doc

Field state, detector state, plotting, VTK export, and reliable normalization.
:::

::::

```{toctree}
:hidden:
:maxdepth: 1

api
configuration
benchmark_cli
output
```