Skip to content

Add magic state distillation tutorial #311

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
david-pl merged 12 commits into from
Jan 29, 2026
Merged

Add magic state distillation tutorial #311

Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
87dc401
Add magic state distillation tutorial
rafaelha Jan 27, 2026
1ea1219
Update bloqade-circuit dep
rafaelha Jan 27, 2026
9e2dbeb
Update mkdocs.yml to use execute_ignore instead of ignore
rafaelha Jan 27, 2026
95402db
Add space
rafaelha Jan 27, 2026
78349ff
Convert to jupytext
rafaelha Jan 29, 2026
cef0d41
Lint
rafaelha Jan 29, 2026
0532526
Fix batch size and bug where incorrect distillation angle was used
rafaelha Jan 29, 2026
3844573
Add typo-ignores
rafaelha Jan 29, 2026
7773410
Revert "Lint"
rafaelha Jan 29, 2026
ece9138
Turn black off and remove isort globally
rafaelha Jan 29, 2026
d9ae52e
13.7 -> 14
rafaelha Jan 29, 2026
653a50c
Trailing spaces
rafaelha Jan 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6,183 changes: 6,183 additions & 0 deletions docs/digital/examples/tsim/magic_state_distillation.ipynb
View file
Open in desktop

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions docs/scripts/gen_ref_nav.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@


skip_keywords = [
".venv", ## skip virtual environment
"julia", ## [KHW] skip for now since we didn't have julia codegen rdy
"builder/base", ## hiding from user
"builder/terminate", ## hiding from user
Expand Down
5 changes: 5 additions & 0 deletions docs/stylesheets/extra.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,3 +29,8 @@
.md-typeset .grid.cards {
font-size: small;
} */

/* Hide Jupyter notebook input/output prompts (In[ ] and Out[ ]) */
.jp-InputPrompt, .jp-OutputPrompt {
display: none !important;
Comment thread
rafaelha marked this conversation as resolved.
}
4 changes: 3 additions & 1 deletion mkdocs.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,8 @@ nav:
- Squin dialect examples:
- Deutsch-Jozsa Algorithm: digital/examples/squin/deutsch_squin.py
- GHZ state preparation with noise: digital/examples/squin/ghz.py
- TSIM examples:
- Magic state distillation: digital/examples/tsim/magic_state_distillation.ipynb
- Integration with other SDKs:
- Noisy GHZ states with cirq: "digital/examples/interop/noisy_ghz.py"
- Bloqade Analog:
Expand Down Expand Up @@ -135,7 +137,7 @@ plugins:
- mkdocs-jupyter:
execute: true
allow_errors: false
ignore: ["scripts/*", "digital/examples/qasm2/*"]
execute_ignore: ["scripts/*", "digital/examples/qasm2/*", "digital/examples/tsim/magic_state_distillation.ipynb"]

@rafaelha rafaelha Jan 27, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When ignore is used, pages are actually not rendered, but downloaded.

I assume what was meant is execute_ignore

@david-pl david-pl Jan 28, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, that's the appropriate fix for #310. Anyway, that's good, thanks!

Why aren't we executing the new notebook though?

@rafaelha rafaelha Jan 28, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Two reasons: It would only run once the new version of bloqade-circuit is released (with the tsim integration). The other reason is it takes about 10 mins to run on CI (2 mins locally). If we really wanted it to run, I might have to do some optimizing (or remove some slow parts)

- mike

extra_javascript:
Expand Down
1 change: 1 addition & 0 deletions pyproject.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ authors = [
{ name = "kaihsin", email="khwu@quera.com" },
{ name = "weinbe58", email="pweinberg@quera.com"},
{ name = "johnzl-777", email="jlong@quera.com"},
{ name = "rafaelha", email="rhaenel@quera.com"},
]
classifiers = [
"Development Status :: 3 - Alpha",
Expand Down
Loading