# Atom-gap cavity optimizer dashboard

```{admonition} Active research checkpoint
:class: important

This page shows the latest saved **exact-binary projection**, not a finished result. Q and Purcell below are differentiable 0.68 ps optimization proxies. They become final claims only after the independent 3 ps ringdown and phasor validation reaches both targets.
```

```{raw} html
<div class="optimizer-dashboard-meta">
  <span class="validation-badge">checkpoint e684f253d6</span>
  <span class="validation-badge">update 135</span>
  <span class="validation-badge">hard gap binary relaxation</span>
  <span class="validation-badge metric-pass">field matches geometry</span>
</div>
<div class="optimizer-metrics">
  <div class="optimizer-metric"><span>Q proxy</span><strong>718.9</strong><small>target 1,000</small></div>
  <div class="optimizer-metric"><span>Purcell proxy</span><strong>2.054</strong><small>target 5</small></div>
  <div class="optimizer-metric"><span>Mode volume</span><strong>64.65</strong><small>µm³ proxy</small></div>
  <div class="optimizer-metric"><span>Vacuum gap</span><strong>1.000</strong><small>µm · hard constraint</small></div>
</div>
<div class="optimizer-target-row"><span>Q target attainment</span><div><i style="width:71.9%"></i></div><b>71.9%</b></div>
<div class="optimizer-target-row"><span>Purcell target attainment</span><div><i style="width:41.1%"></i></div><b>41.1%</b></div>
```

## Current physical geometry

```{figure} ../_static/generated/atom_gap_current_geometry.png
:alt: Current unfolded binary atom-gap cavity geometry
:class: figure-shell

The literal, symmetry-unfolded z=0 material projection. Cyan is silicon, dark is vacuum, dashed lines bound the exact 1 µm exclusion region, and the marker is the centered Ey-oriented atom. The plotted free-form domain is 7 × 3 µm at 25 nm design spacing with a 75 nm conic filter.
```

## Current electric field

```{figure} ../_static/generated/atom_gap_current_ey.png
:alt: Current atom-gap cavity Ey field at the tracked resonance
:class: figure-shell

The phase-aligned real Ey phasor from a separate forward solve of the fingerprinted binary geometry. White contours mark the dielectric boundary. **Snapshot status:** 2026-08-19T12:28:18.063280+00:00
```

## How to read this checkpoint

- The geometry shown is the exact β=16 hard projection with the gap forcibly set to vacuum; gray optimization density is never presented as the device.
- The optimizer uses x/y mirror symmetries and restores both halves for these plots.
- While either target is unmet, each accepted binary step may lose at most 5% Q or 2% Purcell and must improve at least one of them.
- A stalled hard projection triggers a dual-projection relaxation cycle. Soft controls may explore, but transfer requires a better exact-binary score.
- The field image is accepted only when its stored SHA-256 control fingerprint equals the displayed geometry fingerprint.

| Checkpoint provenance | Value |
|---|---|
| Saved | 2026-08-19 12:34:07 UTC |
| Artifact version | `freeform_atom_gap_v32_longitudinal_domain_expansion` |
| Control shape | `140 × 60` quarter-domain |
| Hard-gap update | 136 |
| Metric source | `hard_gap_binary_q_ascent` |
| Latest step accepted | `false` |
| Control fingerprint | `e684f253d666845ab3a34bc5a194bb5026a5efd1b41b2b413062a48a4b3d6b3a` |

## Refresh locally

Geometry and metrics are CPU-only:

```bash
JAX_PLATFORMS=cpu uv run python scripts/generate_atom_gap_dashboard.py
```

Capture a matching forward field when the optimization GPU is idle:

```bash
TF_GPU_ALLOCATOR=cuda_malloc_async uv run python scripts/generate_atom_gap_dashboard.py --capture-field
```