Skip to content

Update Hamiltonian simulation compilation tutorial to new template#4969

Open
henryzou50 wants to merge 4 commits intoQiskit:mainfrom
henryzou50:update-cmhsc
Open

Update Hamiltonian simulation compilation tutorial to new template#4969
henryzou50 wants to merge 4 commits intoQiskit:mainfrom
henryzou50:update-cmhsc

Conversation

@henryzou50
Copy link
Copy Markdown
Collaborator

Summary

Revised compilation-methods-for-hamiltonian-simulation-circuits.ipynb to follow the Tutorial_Template structure, focusing exclusively on benchmarking SABRE, AI transpiler, and Rustiq compilation methods on Hamiltonian simulation circuits from the Hamlib collection.

Key changes from the old notebook:

  • Removed EfficientSU2 section: The old notebook started with a separate Part 1 using efficient_su2 circuits. The revised version focuses entirely on Hamlib Hamiltonian simulation circuits built with PauliEvolutionGate
  • Split benchmarks by scale: Circuits are now grouped into small-scale (<20 qubits) and large-scale (>=20 qubits) with separate analysis for each
  • Added circuit filtering: Filters out circuits exceeding backend qubit count or 5000 decomposed gates to keep benchmarks practical
  • Added execution and fidelity testing: The old notebook had no execution ("focused on the transpilation process"). The revised version uses mirror circuits to measure survival probability on both an Aer simulator (small-scale) and real hardware (large-scale)
  • Improved visualizations: Line charts by circuit index, % improvement over SABRE bar charts, and grouped bar charts for best-performing method with tie tracking
  • Added quantitative analysis: Styled summary tables with mean/stdev and per-circuit comparison tables with best-value highlighting
  • Updated dependencies: Bumped to Qiskit SDK v2.0+, added Qiskit Aer dependency, switched backend from ibm_torino to least_busy()
  • Template compliance: Added learning outcomes, prerequisites, and structured background sections following the standard tutorial template

Tutorial structure:

  • Small-scale example (<20 qubits): Full walkthrough with Aer simulator noise evaluation using mirror circuits and survival probability
  • Large-scale example (>=20 qubits): Compressed workflow with real hardware submission and fidelity comparison across all three compilation methods

…utorial

Replace the old notebook with a revised version that follows the tutorial
template and focuses exclusively on Hamiltonian simulation circuits from
the Hamlib benchmark collection (removing the EfficientSU2 section).

Key changes:
- Compare SABRE, AI transpiler, and Rustiq on Hamlib circuits split into
  small-scale (<20 qubits) and large-scale (>=20 qubits) groups
- Filter out circuits exceeding backend qubit count or 5000 decomposed gates
- Add styled summary tables with mean/stdev and % improvement over SABRE
- Add per-circuit comparison tables with best-value highlighting
- Improve plots: line charts by circuit index, % improvement over SABRE,
  grouped bar charts for best-performing method with tie tracking
- Add mirror circuit execution for noise evaluation (Aer sim for small-scale,
  real hardware for large-scale) with survival probability metric
- Revise all commentary to reflect benchmark observations
@henryzou50 henryzou50 requested a review from a team April 10, 2026 09:25
@qiskit-bot
Copy link
Copy Markdown
Contributor

One or more of the following people are relevant to this code:

  • @henryzou50
  • @nathanearnestnoble

@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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

2 participants