Skip to content

Add warm-start QAOA tutorial#5064

Open
henryzou50 wants to merge 35 commits into
mainfrom
add-warm-start-qaoa-tut
Open

Add warm-start QAOA tutorial#5064
henryzou50 wants to merge 35 commits into
mainfrom
add-warm-start-qaoa-tut

Conversation

@henryzou50
Copy link
Copy Markdown
Collaborator

@henryzou50 henryzou50 commented May 4, 2026

Replaces #5039 — moved branch to upstream so CI can access the QiskitRuntimeService token. See #5039 for prior discussion.

@henryzou50
Add warm-start QAOA tutorial
200b8ed 
Adds a new tutorial demonstrating how to warm-start QAOA on Max-Cut
problems by initializing the circuit from a continuous relaxation
solution (Egger, Mareček, Woerner 2020), using the
qiskit-addon-opt-mapper package. Registers it in the tutorials TOC
and index, sets reviewer notifications, and excludes it from
notebook CI like other tutorials.
@henryzou50
Cspell and links
cfb82f3
@henryzou50
Testing
1a39b1e
@henryzou50 henryzou50 requested a review from a team May 4, 2026 17:41
@review-notebook-app
Copy link
Copy Markdown

review-notebook-app Bot commented May 4, 2026

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.

Powered by ReviewNB

@qiskit-bot
Copy link
Copy Markdown
Contributor

qiskit-bot commented May 4, 2026

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

  • @nathanearnestnoble

@henryzou50 henryzou50 self-assigned this May 4, 2026
abbycross
abbycross reviewed May 5, 2026
View reviewed changes
Comment thread docs/tutorials/_toc.json Outdated
abbycross
abbycross reviewed May 5, 2026
View reviewed changes
Comment thread docs/tutorials/index.mdx Outdated
abbycross
abbycross reviewed May 5, 2026
View reviewed changes
Comment thread docs/tutorials/warm-start-qaoa.ipynb Outdated
abbycross
abbycross reviewed May 5, 2026
View reviewed changes
Comment thread docs/tutorials/warm-start-qaoa.ipynb Outdated
abbycross
abbycross reviewed May 5, 2026
View reviewed changes
Comment thread docs/tutorials/warm-start-qaoa.ipynb Outdated
abbycross
abbycross reviewed May 5, 2026
View reviewed changes
Comment thread docs/tutorials/warm-start-qaoa.ipynb Outdated
abbycross
abbycross reviewed May 5, 2026
View reviewed changes
Comment thread docs/tutorials/warm-start-qaoa.ipynb Outdated
abbycross
abbycross reviewed May 5, 2026
View reviewed changes
Comment thread docs/tutorials/warm-start-qaoa.ipynb Outdated
abbycross
abbycross reviewed May 5, 2026
View reviewed changes
Comment thread docs/tutorials/warm-start-qaoa.ipynb Outdated
abbycross
abbycross reviewed May 5, 2026
View reviewed changes
Comment thread docs/tutorials/warm-start-qaoa.ipynb
henryzou50 and others added 6 commits May 5, 2026 11:38
@henryzou50 @abbycross
Update docs/tutorials/index.mdx
1784c0e 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/_toc.json
361712b 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
3188ca8 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
6b4cb1c 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
d29c159 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
0419f77 
Co-authored-by: abbycross <across@us.ibm.com>
abbycross
abbycross reviewed May 5, 2026
View reviewed changes
Comment thread docs/tutorials/warm-start-qaoa.ipynb
henryzou50 and others added 17 commits May 5, 2026 18:05
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
145c401 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
617c357 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
a1b8d33 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
3f5bea7 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
721f96a 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
7711852 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
82d786c 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
658c45a 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
003f2fb 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
b41589c 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
08eafbe 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
2a3790e 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
3f61a25 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
997fb8b 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
6d9ab12 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
36aae1c 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
bb5a1d4 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
bde3e64 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 @abbycross
Update docs/tutorials/warm-start-qaoa.ipynb
1be2628 
Co-authored-by: abbycross <across@us.ibm.com>
@henryzou50 henryzou50 mentioned this pull request May 5, 2026
Merged
abbycross
abbycross approved these changes May 6, 2026
View reviewed changes
Copy link
Copy Markdown
Collaborator

@abbycross abbycross left a comment

Choose a reason for hiding this comment

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

All set from my side, thanks! @nathanearnestnoble final review?

@nathanearnestnoble
Copy link
Copy Markdown
Collaborator

nathanearnestnoble commented May 12, 2026

@t-imamichi plans to review this -- lets come back once that is done.

@t-imamichi t-imamichi mentioned this pull request May 13, 2026
Open
@t-imamichi
Copy link
Copy Markdown
Member

t-imamichi commented May 13, 2026 •
edited
Loading

The tutorial looks good overall. I have some minor comments as follows.

  1. Cell [3]: Since opt-mapper includes Maxcut class , Cell [3] and "Large Scale Hardware Example" section can be simplified with the class.
  2. Cell [7]: I suggest using qaoa_ansatz link to generate the standard QAOA ansatz.
  3. Cell [14]: It would be nice to compare the probabilities of bitstrings with the optimal cut value 4 so that we can see the difference between the standard QAOA and the warm-start QAOA. (not a strong opinion)

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

Reviewers

@abbycross abbycross abbycross approved these changes

@nathanearnestnoble nathanearnestnoble Awaiting requested review from nathanearnestnoble

Assignees

@henryzou50 henryzou50

Labels

tutorial 📒

Projects

Docs Planning
Status: No status

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@henryzou50 @qiskit-bot @nathanearnestnoble @t-imamichi @abbycross