# 2023 QIS Class Hardware Pictures

## Scope

This folder is a reveal.js hardware gallery for a UMass CICS QIS class. It is image-heavy and organized as a tour of quantum hardware platforms rather than a narrative research talk.

## Likely Entry Points

- `presentation.html` is the actual deck to open and edit.
- Use `python3 tools/reveal_text.py 2023-QIS_class_hardware_pics/presentation.html` from the archive root to inspect rough slide text.
- `compile.sh` is legacy or stale in the current folder state: it references `index.md` and writes `index.html`, but those files are not present. Do not rely on it unless the missing source is restored.

## Content Themes

- Rydberg atoms: highly excited atoms, Rydberg cavities, optical tweezer arrays, and shuttling for computation.
- Trapped ions: cryostats, chips, traps, and racetrack layouts.
- Transmons and transmons in cavities: dilution refrigerators, cold stages, transmon chips, single transmons, and cavity analogies.
- Color centers in diamond: nitrogen-vacancy centers and chiplets.
- Photonics: fiber optics, whispering-gallery modes, microdisk resonators, waveguides, and photonic crystals.

## Assets And Patterns

- Most top-level image files are slide content, not decoration. Preserve existing names unless updating references in `presentation.html`.
- Many slides include source URLs as visible code text. Keep citations with the image they support.
- The deck uses vertical reveal.js sections for topic groups and simple level-two slides for individual hardware examples.
- `mario.gif` and `quera_ecc.webp` are used for the shuttling sequence.
- The deck links local reveal support in `dist/` and `plugin/`, and also retains generated pandoc-era CDN links. Treat `dist/` and `plugin/` as support/vendor content.

## Editing Guidance

- Edit `presentation.html` directly unless a real markdown source is reintroduced.
- Keep image sizing local to the affected slide when matching the existing style; this deck already uses inline sizing for special cases.
- If adding a new hardware platform, follow the existing pattern: topic title slide, image slide, short caption when useful, and visible source URL.
- After edits, run `python3 tools/reveal_text.py 2023-QIS_class_hardware_pics/presentation.html` and scan for missing headings or broken-looking slide text.
- Do not spend time modernizing reveal.js support files for content edits.

## Do Not Edit For Normal Content Work

- `dist/`
- `plugin/`