Skip to content

Commit 824c3ed

Browse files
committed
Add GitHub-safe teaser image to README Overview
1 parent 5a42348 commit 824c3ed

1 file changed

Lines changed: 52 additions & 23 deletions

File tree

README.md

Lines changed: 52 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,13 @@
3939
</div>
4040

4141
---
42-
<a id="overview"></a>## Overview
42+
<a id="overview"></a>
43+
44+
## Overview
45+
46+
![Quantum Cinema teaser — scientific world models meet cinematic storytelling](docs/world-models/ion-trap/ion-trap-screenshots/ion-1.jpg)
47+
48+
*A science-meets-art preview frame from the Quantum Cinema world-model pipeline, illustrating the project’s focus on quantum hardware, narrative visualization, and frontier research communication.*
4349

4450
Quantum Cinema is a reproducible software artifact for academic publication. It demonstrates how immersive, browser-based visualizations can make quantum device architecture and performance legible to a broad audience.
4551

@@ -53,6 +59,7 @@ Quantum Cinema is a reproducible software artifact for academic publication. It
5359
- `CITATION.cff` — citation metadata for academic use
5460

5561
<a id="features"></a>
62+
5663
## Features
5764

5865
- Four-act immersive narrative flow: Nobel Prize → video showcase → world model → comparison
@@ -62,6 +69,7 @@ Quantum Cinema is a reproducible software artifact for academic publication. It
6269
- Paper-ready artifact with reproducibility and citation metadata
6370

6471
<a id="world-models-documentation"></a>
72+
6573
## World Models Documentation
6674

6775
The world-model documentation is located under `docs/world-models/` and includes the three technical note categories requested by the engineering team:
@@ -89,29 +97,22 @@ Captured still frames and videos are also available for all three platforms:
8997

9098
### Sample World-Model Videos
9199

92-
Read the ion-trap generation pipeline in [Ion-trap world creation: How the final world model was generated](https://github.com/QuantBlockchain/quantum-cinema/blob/main/docs/world-models/ion-trap/how-to-create-world.md#how-the-final-world-model-was-generated).
100+
The following table presents each platform’s creation pipeline documentation, a preview video embed, and a representative captured frame.
93101

94-
<figure style="display:inline-block; margin: 0 12px 12px 0; text-align:center; width:320px;">
95-
<video autoplay muted loop playsinline width="320" preload="metadata" style="border:1px solid #ddd; border-radius:8px;">
96-
<source src="https://raw.githubusercontent.com/QuantBlockchain/quantum-cinema/main/docs/world-models/ion-trap/ionq-world-explore.mp4" type="video/mp4">
102+
| Platform | Creation pipeline | Preview | Sample frame |
103+
|---|---|---|---|
104+
| **Ion-trap** | [How the final world model was generated](docs/world-models/ion-trap/how-to-create-world.md#how-the-final-world-model-was-generated) | <video autoplay muted loop playsinline width="260" preload="metadata" style="border:1px solid #ddd; border-radius:8px;">
105+
<source src="docs/world-models/ion-trap/ionq-world-explore.mp4" type="video/mp4">
97106
Your browser does not support HTML5 video.
98-
</video>
99-
<figcaption style="font-size:0.9rem; margin-top:8px;">Ion-trap world exploration (autoplay preview)</figcaption>
100-
</figure>
101-
<figure style="display:inline-block; margin: 0 12px 12px 0; text-align:center; width:320px;">
102-
<video controls muted loop playsinline width="320" preload="metadata" style="border:1px solid #ddd; border-radius:8px;">
103-
<source src="https://raw.githubusercontent.com/QuantBlockchain/quantum-cinema/main/docs/world-models/superconducting/superconducting-world-explore.mp4" type="video/mp4">
107+
</video> | ![Ion-trap screenshot](docs/world-models/ion-trap/ion-trap-screenshots/ion-1.jpg) |
108+
| **Superconducting** | [Superconducting world creation](docs/world-models/superconducting/how-to-create-world.md) | <video controls muted loop playsinline width="260" preload="metadata" style="border:1px solid #ddd; border-radius:8px;">
109+
<source src="docs/world-models/superconducting/superconducting-world-explore.mp4" type="video/mp4">
104110
Your browser does not support HTML5 video.
105-
</video>
106-
<figcaption style="font-size:0.9rem; margin-top:8px;">Superconducting world exploration</figcaption>
107-
</figure>
108-
<figure style="display:inline-block; margin: 0 12px 12px 0; text-align:center; width:320px;">
109-
<video controls muted loop playsinline width="320" preload="metadata" style="border:1px solid #ddd; border-radius:8px;">
110-
<source src="https://raw.githubusercontent.com/QuantBlockchain/quantum-cinema/main/docs/world-models/neutral-atoms/quera.mp4" type="video/mp4">
111+
</video> | ![Superconducting screenshot](docs/world-models/superconducting/superconducting-screenshots/super-1.jpg) |
112+
| **Neutral-atom** | [Neutral-atom world creation](docs/world-models/neutral-atoms/how-to-create-world.md) | <video controls muted loop playsinline width="260" preload="metadata" style="border:1px solid #ddd; border-radius:8px;">
113+
<source src="docs/world-models/neutral-atoms/quera.mp4" type="video/mp4">
111114
Your browser does not support HTML5 video.
112-
</video>
113-
<figcaption style="font-size:0.9rem; margin-top:8px;">Neutral-atom world exploration</figcaption>
114-
</figure>
115+
</video> | ![Neutral-atom screenshot](docs/world-models/neutral-atoms/neutral-atom-screenshots/atom-1.jpg) |
115116

116117
## Quick Start
117118

@@ -389,9 +390,37 @@ The core lesson of the Comparison act: **you cannot optimize all six at once.**
389390
├── design/
390391
│ └── design.md # research and design rationale
391392
├── docs/
392-
│ ├── en/ # English design and usage docs
393-
│ ├── zh/ # Chinese design and usage docs
394-
│ └── world-models/ # world-model creation pipeline and assets
393+
│ ├── en/
394+
│ │ ├── architecture.md # architecture overview and deployment notes
395+
│ │ ├── local-development.md # local setup and development guide
396+
│ │ ├── requirements.md # functional and non-functional requirements
397+
│ │ └── user-experience/
398+
│ │ └── Readme.md # UX flow, screens, and glossary
399+
│ ├── zh/
400+
│ │ ├── architecture.md # Chinese architecture overview
401+
│ │ ├── local-development.md # Chinese local development guide
402+
│ │ ├── requirements.md # Chinese requirements document
403+
│ │ └── user-experience/
404+
│ │ └── Readme.md # Chinese UX flow and glossary
405+
│ └── world-models/
406+
│ ├── README.md # summary of the world-model documentation package
407+
│ ├── architectural-contrast.md # cross-platform world-model comparison
408+
│ ├── significance-analysis.md # AWS Braket parameter analysis and metrics
409+
│ ├── ion-trap/
410+
│ │ ├── how-to-create-world.md
411+
│ │ ├── teaching-guide.md
412+
│ │ ├── ion-trap-screenshots/
413+
│ │ └── ionq-world-explore.mp4
414+
│ ├── superconducting/
415+
│ │ ├── how-to-create-world.md
416+
│ │ ├── teaching-guide.md
417+
│ │ ├── superconducting-screenshots/
418+
│ │ └── superconducting-world-explore.mp4
419+
│ └── neutral-atoms/
420+
│ ├── how-to-create-world.md
421+
│ ├── teaching-guide.md
422+
│ ├── neutral-atom-screenshots/
423+
│ └── quera.mp4
395424
├── lib/
396425
│ └── qc-worldlabs-stack.ts # AWS CDK infrastructure stack
397426
├── quantum-cinema/ # Next.js 16 application

0 commit comments

Comments
 (0)