Skip to content

Add Fault-Tolerance Engine end-to-end tutorial - #1730

Open
ronClassiq wants to merge 2 commits into
Classiq:mainfrom
ronClassiq:ec/ron/ft-engine-end-to-end-tutorial
Open

Add Fault-Tolerance Engine end-to-end tutorial#1730
ronClassiq wants to merge 2 commits into
Classiq:mainfrom
ronClassiq:ec/ron/ft-engine-end-to-end-tutorial

Conversation

@ronClassiq

Copy link
Copy Markdown
Member

What

An advanced tutorial (tutorials/technology_demonstrations/fault_tolerance_engine_end_to_end/) that runs a circuit through the full Classiq Fault-Tolerance Engine pipeline, end to end:

  1. Get a logical noise model — public public/depolarize_1e-3 by default; initialize_logical_noise from a PhysicalNoiseModel is shown behind an INITIALIZE_OWN_NOISE toggle (off by default, since it's a ~1h backend simulation).
  2. Model a QPE circuit in Qmod → synthesize.
  3. export to a Clifford+T circuit.
  4. route_circuit onto the 3-D surface-code lattice.
  5. view_program(show=True) — interactive 3-D viewer inline.
  6. Combined resources + fidelity + runtime summary (physical qubits per patch via (d+1)**2, total logical error / fidelity across code distances).

Includes tests/notebooks/test_fault_tolerance_engine_end_to_end.py and the metadata file.

Notes

  • Uses the error-correction SDK via its module paths; verified end-to-end against the backend on the project interpreter (released classiq 1.28.0).
  • First route_circuit call can take a few minutes (worker cold start); the notebook notes this.

Resolves part of CLS-6939.

CLS-6939. An advanced tutorial that runs a circuit through the full FT engine
pipeline: get a logical noise model (public public/depolarize_1e-3 by default,
with initialize_logical_noise shown behind a toggle), model a QPE in Qmod,
synthesize, export to Clifford+T, route onto the surface-code lattice, view the
routed program, and summarize resources/fidelity/runtime plus total logical
error across code distances.

Adds tests/notebooks/test_fault_tolerance_engine_end_to_end.py and a metadata
file.
@review-notebook-app

Copy link
Copy Markdown

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@github-actions

github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown

🔥 New notebook just dropped!

@amir-naveh , @TomerGoldfriend — come check out this shiny new addition to our repo.

@@ -0,0 +1,378 @@
{

@TomerGoldfriend TomerGoldfriend Sep 2, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

You can remove this line.

It will be nice to add the notebook with the cell outputs, for example, to see the output of logical_noise.plot_clifford(start=5, end=25) and all the other plots.


Reply via ReviewNB

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Don't you see the outputs? Should it be pushed after running so the cells are visible?

@ronClassiq ronClassiq closed this Sep 2, 2026
@ronClassiq ronClassiq reopened this Sep 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants