Skip to content

Add tutorial: Compilation methods for Hamiltonian simulation circuits #3553

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.

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

Open
wants to merge 8 commits into
base: main
Choose a base branch
from

Conversation

henryzou50
Copy link

Add tutorial: Compilation methods for Hamiltonian simulation circuits

This PR adds a new tutorial to the Qiskit documentation titled "Compilation methods for Hamiltonian simulation circuits" and addresses issue #3552

The notebook provides a comparative overview of three compilation methods in Qiskit for Hamiltonian simulation workloads:

  • SABRE transpiler: Efficient routing and layout optimization.
  • AI Transpiler: Intelligent, automated transpilation and synthesis for Pauli networks.
  • Rustiq plugin: Precise and low-depth synthesis for PauliEvolutionGate operations used in Trotterized dynamics.

What the tutorial covers

  • Compilation strategies for circuits relevant to quantum simulation.
  • Depth and gate count comparisons across methods.
  • Circuit examples created from Qiskit’s Patterns module.

Files added

  • docs/tutorials/100_representative.json
  • docs/tutorials/compilation-methods-for-hamiltonian-simulation-circuits.ipynb

Note: The location of 100_representative.json will likely need to be changed, as week as the notebook's reference of it. This json file is used as the file that contains the benchmarking circuits for Hamlib. What is the best location / most appropriate for this file?

Before finalizing this tutorial

  • Add a survey link to the end of the notebook (support appreciated).
  • Update notebook metadata and JSON headers to follow Qiskit documentation conventions (support appreciated).

…mpilation methods

This commit adds the initial version of the tutorial notebook on compilation methods
for Hamiltonian simulation circuits, along with the accompanying `100_representative.json`
file used for circuit examples.

Still to finalize:
- Placement of the notebook and resource file in the tutorials directory structure
- Internal documentation links and cross-references
- Survey link at the end of the notebook
…ademark symbol

Added the corresponding adjustments for creating a new tutorial.

Note that we still need to adjust the json and metadata of the tutorial, which would be done in the PR.
Copy link

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@CLAassistant
Copy link

CLAassistant commented Jul 16, 2025

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ abbycross
❌ henryzou50
You have signed the CLA already but the status is still pending? Let us recheck it.

@qiskit-bot
Copy link
Contributor

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

@kaelynj kaelynj requested review from beckykd and abbycross July 17, 2025 14:39
@abbycross
Copy link
Collaborator

Can we link to the SABRE deep-dive tutorial mentioned in the Compilation methods overview section? Or if it isn't published yet, we can add a note to that effect.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants