Skip to content

add new QMOO tutorial #5499

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

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

add new QMOO tutorial #5499

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
3bbd770
add new QMOO tutorial
kcmccormibm Aug 11, 2026
544d8dc
change default backend to any heron device
kcmccormibm Aug 11, 2026
1baa306
change dataset path
kcmccormibm Aug 11, 2026
093d3ee
add params.json file
kcmccormibm Aug 11, 2026
519fbec
Merge remote-tracking branch 'origin/main' into km/add-qmoo-portfolio
henryzou50 Aug 19, 2026
64728bf
tox -e fix
henryzou50 Aug 19, 2026
47d59ff
Format qaoa_params.json with prettier
henryzou50 Aug 19, 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
41 changes: 41 additions & 0 deletions datasets/tutorials/qmoo/market_data.csv
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
ticker,mu,AAPL,MSFT,NVDA,CRM,ADBE,XOM,CVX,COP,SLB,EOG,JPM,BAC,GS,MS,BLK,JNJ,UNH,PFE,ABT,TMO,PG,KO,PEP,WMT,COST,CAT,HON,UPS,GE,RTX,NEE,DUK,SO,D,AEP,AMT,PLD,CCI,EQIX,SPG
AAPL,0.272,0.0796,0.0282,0.0505,0.0281,0.0300,0.0118,0.0156,0.0207,0.0314,0.0153,0.0252,0.0304,0.0397,0.0382,0.0350,0.0024,-0.0016,0.0150,0.0071,0.0237,0.0083,0.0053,0.0087,0.0186,0.0181,0.0329,0.0242,0.0302,0.0309,0.0087,0.0066,-0.0038,-0.0023,0.0063,-0.0004,-0.0000,0.0295,0.0041,0.0160,0.0269
MSFT,0.021,0.0282,0.0609,0.0609,0.0445,0.0331,-0.0011,0.0046,0.0071,0.0121,0.0047,0.0188,0.0186,0.0284,0.0294,0.0221,-0.0081,0.0014,0.0020,-0.0010,0.0136,-0.0041,-0.0055,-0.0053,0.0083,0.0112,0.0175,0.0113,0.0124,0.0219,0.0057,-0.0030,-0.0064,-0.0072,-0.0038,-0.0049,-0.0059,0.0110,-0.0013,0.0131,0.0120
NVDA,0.579,0.0505,0.0609,0.2360,0.0503,0.0370,0.0033,0.0127,0.0217,0.0353,0.0156,0.0363,0.0324,0.0652,0.0634,0.0424,-0.0249,0.0003,-0.0027,-0.0078,0.0239,-0.0173,-0.0188,-0.0190,0.0056,0.0143,0.0575,0.0218,0.0128,0.0656,0.0188,-0.0024,-0.0233,-0.0236,-0.0156,-0.0193,-0.0281,0.0142,-0.0184,0.0320,0.0226
CRM,-0.195,0.0281,0.0445,0.0503,0.1373,0.0758,0.0047,0.0108,0.0194,0.0212,0.0134,0.0246,0.0266,0.0369,0.0382,0.0264,-0.0080,0.0177,0.0081,0.0029,0.0269,-0.0046,-0.0074,-0.0039,0.0051,0.0113,0.0185,0.0138,0.0152,0.0169,0.0091,-0.0087,-0.0091,-0.0088,-0.0057,-0.0099,-0.0092,0.0122,-0.0021,0.0160,0.0212
ADBE,-0.301,0.0300,0.0331,0.0370,0.0758,0.1186,0.0051,0.0098,0.0145,0.0195,0.0123,0.0212,0.0217,0.0290,0.0293,0.0256,-0.0038,0.0151,0.0107,0.0056,0.0259,0.0010,-0.0004,0.0017,0.0077,0.0167,0.0131,0.0167,0.0154,0.0144,0.0042,-0.0033,-0.0038,-0.0055,-0.0038,-0.0081,-0.0001,0.0204,0.0064,0.0197,0.0190
XOM,0.186,0.0118,-0.0011,0.0033,0.0047,0.0051,0.0565,0.0457,0.0586,0.0529,0.0506,0.0139,0.0137,0.0145,0.0132,0.0115,0.0065,0.0024,0.0096,0.0033,0.0110,0.0023,0.0059,0.0079,0.0029,0.0032,0.0182,0.0112,0.0137,0.0045,0.0106,0.0137,0.0053,0.0065,0.0088,0.0066,0.0030,0.0157,0.0079,0.0034,0.0113
CVX,0.139,0.0156,0.0046,0.0127,0.0108,0.0098,0.0457,0.0548,0.0577,0.0526,0.0497,0.0184,0.0174,0.0187,0.0190,0.0152,0.0050,0.0062,0.0116,0.0040,0.0145,0.0007,0.0039,0.0073,0.0042,0.0038,0.0211,0.0126,0.0158,0.0099,0.0104,0.0112,0.0036,0.0044,0.0086,0.0042,0.0019,0.0172,0.0066,0.0048,0.0139
COP,0.073,0.0207,0.0071,0.0217,0.0194,0.0145,0.0586,0.0577,0.0960,0.0709,0.0721,0.0252,0.0251,0.0271,0.0284,0.0217,0.0042,0.0072,0.0129,0.0008,0.0190,-0.0020,0.0010,0.0060,0.0068,0.0037,0.0298,0.0190,0.0193,0.0130,0.0166,0.0142,0.0033,0.0041,0.0093,0.0034,0.0002,0.0207,0.0071,0.0117,0.0208
SLB,0.160,0.0314,0.0121,0.0353,0.0212,0.0195,0.0529,0.0526,0.0709,0.1190,0.0584,0.0344,0.0351,0.0476,0.0443,0.0357,0.0055,0.0132,0.0211,0.0080,0.0352,0.0058,0.0040,0.0096,0.0102,0.0080,0.0569,0.0346,0.0370,0.0309,0.0205,0.0172,-0.0001,0.0026,0.0111,0.0020,0.0037,0.0350,0.0072,0.0140,0.0277
EOG,0.097,0.0153,0.0047,0.0156,0.0134,0.0123,0.0506,0.0497,0.0721,0.0584,0.0752,0.0180,0.0160,0.0199,0.0202,0.0147,0.0034,0.0062,0.0099,0.0009,0.0120,-0.0019,0.0018,0.0051,0.0051,0.0053,0.0233,0.0144,0.0140,0.0109,0.0122,0.0116,0.0027,0.0039,0.0076,0.0018,0.0004,0.0189,0.0052,0.0093,0.0167
JPM,0.252,0.0252,0.0188,0.0363,0.0246,0.0212,0.0139,0.0184,0.0252,0.0344,0.0180,0.0639,0.0504,0.0618,0.0577,0.0358,0.0031,0.0108,0.0112,0.0090,0.0219,0.0016,0.0009,0.0020,0.0145,0.0117,0.0425,0.0234,0.0230,0.0381,0.0203,0.0040,0.0014,0.0007,0.0076,0.0007,-0.0029,0.0233,0.0028,0.0140,0.0276
BAC,0.181,0.0304,0.0186,0.0324,0.0266,0.0217,0.0137,0.0174,0.0251,0.0351,0.0160,0.0504,0.0649,0.0576,0.0588,0.0397,0.0015,0.0106,0.0136,0.0086,0.0237,0.0030,0.0000,0.0023,0.0158,0.0101,0.0397,0.0235,0.0282,0.0368,0.0156,0.0061,0.0005,0.0010,0.0087,0.0004,-0.0025,0.0284,0.0019,0.0161,0.0300
GS,0.437,0.0397,0.0284,0.0652,0.0369,0.0290,0.0145,0.0187,0.0271,0.0476,0.0199,0.0618,0.0576,0.0941,0.0806,0.0537,0.0012,0.0105,0.0147,0.0094,0.0315,-0.0014,-0.0026,-0.0005,0.0165,0.0142,0.0608,0.0293,0.0316,0.0516,0.0241,0.0044,-0.0022,-0.0023,0.0082,-0.0024,-0.0058,0.0329,0.0013,0.0214,0.0337
MS,0.405,0.0382,0.0294,0.0634,0.0382,0.0293,0.0132,0.0190,0.0284,0.0443,0.0202,0.0577,0.0588,0.0806,0.0894,0.0521,0.0003,0.0100,0.0138,0.0095,0.0302,-0.0029,-0.0028,-0.0010,0.0165,0.0138,0.0541,0.0265,0.0285,0.0482,0.0223,0.0047,-0.0022,-0.0033,0.0083,-0.0027,-0.0053,0.0335,0.0009,0.0203,0.0318
BLK,0.207,0.0350,0.0221,0.0424,0.0264,0.0256,0.0115,0.0152,0.0217,0.0357,0.0147,0.0358,0.0397,0.0537,0.0521,0.0648,0.0052,0.0162,0.0158,0.0101,0.0302,0.0067,0.0019,0.0061,0.0152,0.0124,0.0430,0.0280,0.0278,0.0352,0.0158,0.0113,0.0011,0.0029,0.0108,0.0025,0.0075,0.0310,0.0117,0.0200,0.0313
JNJ,0.254,0.0024,-0.0081,-0.0249,-0.0080,-0.0038,0.0065,0.0050,0.0042,0.0055,0.0034,0.0031,0.0015,0.0012,0.0003,0.0052,0.0320,0.0069,0.0180,0.0159,0.0116,0.0135,0.0125,0.0162,0.0086,0.0044,0.0037,0.0085,0.0087,0.0007,0.0088,0.0139,0.0131,0.0139,0.0154,0.0134,0.0165,0.0113,0.0163,0.0039,0.0071
UNH,-0.015,-0.0016,0.0014,0.0003,0.0177,0.0151,0.0024,0.0062,0.0072,0.0132,0.0062,0.0108,0.0106,0.0105,0.0100,0.0162,0.0069,0.1792,0.0092,0.0071,0.0221,0.0050,0.0015,0.0021,0.0058,0.0071,0.0095,0.0100,0.0150,0.0036,0.0055,0.0030,0.0038,0.0058,0.0091,0.0021,0.0033,0.0076,0.0072,0.0079,0.0136
PFE,0.039,0.0150,0.0020,-0.0027,0.0081,0.0107,0.0096,0.0116,0.0129,0.0211,0.0099,0.0112,0.0136,0.0147,0.0138,0.0158,0.0180,0.0092,0.0589,0.0153,0.0367,0.0113,0.0114,0.0173,0.0062,0.0041,0.0169,0.0186,0.0231,0.0096,0.0107,0.0148,0.0076,0.0096,0.0158,0.0096,0.0182,0.0227,0.0176,0.0113,0.0182
ABT,-0.059,0.0071,-0.0010,-0.0078,0.0029,0.0056,0.0033,0.0040,0.0008,0.0080,0.0009,0.0090,0.0086,0.0094,0.0095,0.0101,0.0159,0.0071,0.0153,0.0504,0.0155,0.0134,0.0113,0.0115,0.0110,0.0083,0.0035,0.0135,0.0112,0.0183,0.0088,0.0139,0.0130,0.0143,0.0162,0.0132,0.0154,0.0210,0.0144,0.0102,0.0124
TMO,-0.102,0.0237,0.0136,0.0239,0.0269,0.0259,0.0110,0.0145,0.0190,0.0352,0.0120,0.0219,0.0237,0.0315,0.0302,0.0302,0.0116,0.0221,0.0367,0.0155,0.0826,0.0092,0.0047,0.0156,0.0068,0.0062,0.0308,0.0232,0.0241,0.0225,0.0179,0.0065,-0.0009,0.0022,0.0091,0.0022,0.0077,0.0275,0.0100,0.0110,0.0227
PG,-0.034,0.0083,-0.0041,-0.0173,-0.0046,0.0010,0.0023,0.0007,-0.0020,0.0058,-0.0019,0.0016,0.0030,-0.0014,-0.0029,0.0067,0.0135,0.0050,0.0113,0.0134,0.0092,0.0344,0.0175,0.0203,0.0149,0.0107,0.0009,0.0137,0.0143,0.0049,0.0047,0.0167,0.0125,0.0141,0.0165,0.0129,0.0178,0.0120,0.0168,0.0087,0.0117
KO,0.165,0.0053,-0.0055,-0.0188,-0.0074,-0.0004,0.0059,0.0039,0.0010,0.0040,0.0018,0.0009,0.0000,-0.0026,-0.0028,0.0019,0.0125,0.0015,0.0114,0.0113,0.0047,0.0175,0.0268,0.0199,0.0110,0.0086,-0.0044,0.0080,0.0046,0.0037,0.0063,0.0162,0.0133,0.0135,0.0154,0.0132,0.0170,0.0093,0.0165,0.0070,0.0084
PEP,-0.037,0.0087,-0.0053,-0.0190,-0.0039,0.0017,0.0079,0.0073,0.0060,0.0096,0.0051,0.0020,0.0023,-0.0005,-0.0010,0.0061,0.0162,0.0021,0.0173,0.0115,0.0156,0.0203,0.0199,0.0428,0.0113,0.0081,0.0034,0.0114,0.0136,-0.0008,0.0045,0.0200,0.0131,0.0147,0.0181,0.0135,0.0191,0.0137,0.0195,0.0073,0.0106
WMT,0.438,0.0186,0.0083,0.0056,0.0051,0.0077,0.0029,0.0042,0.0068,0.0102,0.0051,0.0145,0.0158,0.0165,0.0165,0.0152,0.0086,0.0058,0.0062,0.0110,0.0068,0.0149,0.0110,0.0113,0.0554,0.0288,0.0155,0.0166,0.0122,0.0187,0.0096,0.0111,0.0088,0.0096,0.0134,0.0095,0.0114,0.0182,0.0117,0.0175,0.0164
COST,0.167,0.0181,0.0112,0.0143,0.0113,0.0167,0.0032,0.0038,0.0037,0.0080,0.0053,0.0117,0.0101,0.0142,0.0138,0.0124,0.0044,0.0071,0.0041,0.0083,0.0062,0.0107,0.0086,0.0081,0.0288,0.0410,0.0080,0.0137,0.0055,0.0161,0.0065,0.0063,0.0057,0.0055,0.0074,0.0052,0.0060,0.0120,0.0062,0.0144,0.0147
CAT,0.538,0.0329,0.0175,0.0575,0.0185,0.0131,0.0182,0.0211,0.0298,0.0569,0.0233,0.0425,0.0397,0.0608,0.0541,0.0430,0.0037,0.0095,0.0169,0.0035,0.0308,0.0009,-0.0044,0.0034,0.0155,0.0080,0.1038,0.0319,0.0430,0.0490,0.0230,0.0118,-0.0027,-0.0005,0.0087,0.0057,-0.0019,0.0345,0.0039,0.0213,0.0266
HON,0.108,0.0242,0.0113,0.0218,0.0138,0.0167,0.0112,0.0126,0.0190,0.0346,0.0144,0.0234,0.0235,0.0293,0.0265,0.0280,0.0085,0.0100,0.0186,0.0135,0.0232,0.0137,0.0080,0.0114,0.0166,0.0137,0.0319,0.0536,0.0244,0.0300,0.0199,0.0147,0.0060,0.0083,0.0133,0.0066,0.0121,0.0239,0.0128,0.0164,0.0229
UPS,-0.105,0.0302,0.0124,0.0128,0.0152,0.0154,0.0137,0.0158,0.0193,0.0370,0.0140,0.0230,0.0282,0.0316,0.0285,0.0278,0.0087,0.0150,0.0231,0.0112,0.0241,0.0143,0.0046,0.0136,0.0122,0.0055,0.0430,0.0244,0.0932,0.0134,0.0075,0.0122,0.0013,0.0036,0.0146,0.0057,0.0094,0.0356,0.0083,0.0118,0.0251
GE,0.351,0.0309,0.0219,0.0656,0.0169,0.0144,0.0045,0.0099,0.0130,0.0309,0.0109,0.0381,0.0368,0.0516,0.0482,0.0352,0.0007,0.0036,0.0096,0.0183,0.0225,0.0049,0.0037,-0.0008,0.0187,0.0161,0.0490,0.0300,0.0134,0.1051,0.0368,0.0109,0.0012,0.0020,0.0083,0.0048,0.0006,0.0274,0.0053,0.0249,0.0292
RTX,0.308,0.0087,0.0057,0.0188,0.0091,0.0042,0.0106,0.0104,0.0166,0.0205,0.0122,0.0203,0.0156,0.0241,0.0223,0.0158,0.0088,0.0055,0.0107,0.0088,0.0179,0.0047,0.0063,0.0045,0.0096,0.0065,0.0230,0.0199,0.0075,0.0368,0.0615,0.0077,0.0066,0.0063,0.0120,0.0073,0.0078,0.0152,0.0091,0.0137,0.0161
NEE,0.173,0.0066,-0.0030,-0.0024,-0.0087,-0.0033,0.0137,0.0112,0.0142,0.0172,0.0116,0.0040,0.0061,0.0044,0.0047,0.0113,0.0139,0.0030,0.0148,0.0139,0.0065,0.0167,0.0162,0.0200,0.0111,0.0063,0.0118,0.0147,0.0122,0.0109,0.0077,0.0701,0.0231,0.0254,0.0318,0.0250,0.0281,0.0200,0.0283,0.0163,0.0127
DUK,0.143,-0.0038,-0.0064,-0.0233,-0.0091,-0.0038,0.0053,0.0036,0.0033,-0.0001,0.0027,0.0014,0.0005,-0.0022,-0.0022,0.0011,0.0131,0.0038,0.0076,0.0130,-0.0009,0.0125,0.0133,0.0131,0.0088,0.0057,-0.0027,0.0060,0.0013,0.0012,0.0066,0.0231,0.0270,0.0240,0.0250,0.0228,0.0221,0.0103,0.0215,0.0077,0.0072
SO,0.133,-0.0023,-0.0072,-0.0236,-0.0088,-0.0055,0.0065,0.0044,0.0041,0.0026,0.0039,0.0007,0.0010,-0.0023,-0.0033,0.0029,0.0139,0.0058,0.0096,0.0143,0.0022,0.0141,0.0135,0.0147,0.0096,0.0055,-0.0005,0.0083,0.0036,0.0020,0.0063,0.0254,0.0240,0.0304,0.0271,0.0241,0.0231,0.0111,0.0215,0.0092,0.0074
D,0.154,0.0063,-0.0038,-0.0156,-0.0057,-0.0038,0.0088,0.0086,0.0093,0.0111,0.0076,0.0076,0.0087,0.0082,0.0083,0.0108,0.0154,0.0091,0.0158,0.0162,0.0091,0.0165,0.0154,0.0181,0.0134,0.0074,0.0087,0.0133,0.0146,0.0083,0.0120,0.0318,0.0250,0.0271,0.0445,0.0257,0.0257,0.0211,0.0267,0.0124,0.0160
AEP,0.221,-0.0004,-0.0049,-0.0193,-0.0099,-0.0081,0.0066,0.0042,0.0034,0.0020,0.0018,0.0007,0.0004,-0.0024,-0.0027,0.0025,0.0134,0.0021,0.0096,0.0132,0.0022,0.0129,0.0132,0.0135,0.0095,0.0052,0.0057,0.0066,0.0057,0.0048,0.0073,0.0250,0.0228,0.0241,0.0257,0.0348,0.0235,0.0118,0.0230,0.0092,0.0076
AMT,0.007,-0.0000,-0.0059,-0.0281,-0.0092,-0.0001,0.0030,0.0019,0.0002,0.0037,0.0004,-0.0029,-0.0025,-0.0058,-0.0053,0.0075,0.0165,0.0033,0.0182,0.0154,0.0077,0.0178,0.0170,0.0191,0.0114,0.0060,-0.0019,0.0121,0.0094,0.0006,0.0078,0.0281,0.0221,0.0231,0.0257,0.0235,0.0646,0.0201,0.0534,0.0189,0.0116
PLD,0.198,0.0295,0.0110,0.0142,0.0122,0.0204,0.0157,0.0172,0.0207,0.0350,0.0189,0.0233,0.0284,0.0329,0.0335,0.0310,0.0113,0.0076,0.0227,0.0210,0.0275,0.0120,0.0093,0.0137,0.0182,0.0120,0.0345,0.0239,0.0356,0.0274,0.0152,0.0200,0.0103,0.0111,0.0211,0.0118,0.0201,0.0656,0.0207,0.0273,0.0389
CCI,0.003,0.0041,-0.0013,-0.0184,-0.0021,0.0064,0.0079,0.0066,0.0071,0.0072,0.0052,0.0028,0.0019,0.0013,0.0009,0.0117,0.0163,0.0072,0.0176,0.0144,0.0100,0.0168,0.0165,0.0195,0.0117,0.0062,0.0039,0.0128,0.0083,0.0053,0.0091,0.0283,0.0215,0.0215,0.0267,0.0230,0.0534,0.0207,0.0688,0.0170,0.0138
EQIX,0.198,0.0160,0.0131,0.0320,0.0160,0.0197,0.0034,0.0048,0.0117,0.0140,0.0093,0.0140,0.0161,0.0214,0.0203,0.0200,0.0039,0.0079,0.0113,0.0102,0.0110,0.0087,0.0070,0.0073,0.0175,0.0144,0.0213,0.0164,0.0118,0.0249,0.0137,0.0163,0.0077,0.0092,0.0124,0.0092,0.0189,0.0273,0.0170,0.0630,0.0234
SPG,0.228,0.0269,0.0120,0.0226,0.0212,0.0190,0.0113,0.0139,0.0208,0.0277,0.0167,0.0276,0.0300,0.0337,0.0318,0.0313,0.0071,0.0136,0.0182,0.0124,0.0227,0.0117,0.0084,0.0106,0.0164,0.0147,0.0266,0.0229,0.0251,0.0292,0.0161,0.0127,0.0072,0.0074,0.0160,0.0076,0.0116,0.0389,0.0138,0.0234,0.0550
7 changes: 7 additions & 0 deletions datasets/tutorials/qmoo/qaoa_params.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"p_layers": 1,
"betas": [-0.36782342420310354],
"gammas": [0.3167897610520054],
"k_truncate": 2,
"note": "40-asset QAP-truncated risk (k=2) + sector ring, XY mixer. Trained with ScipyTrainer(MPSAerEvaluator, bond 24) on -mean(H_k), matching the small-scale workflow."
}
4 changes: 4 additions & 0 deletions docs/tutorials/_toc.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,10 @@
"title": "Warm-start QAOA with the Optimization Mapper Qiskit addon",
"url": "/docs/tutorials/warm-start-qaoa"
},
{
"title": "Quantum approximate multi-objective optimization",
"url": "/docs/tutorials/quantum-approximate-multi-objective-optimization"
},
{
"title": "Pauli correlation encoding to reduce Max-Cut requirements",
"url": "/docs/tutorials/pauli-correlation-encoding-for-qaoa"
Expand Down
2 changes: 2 additions & 0 deletions docs/tutorials/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,8 @@ The tutorials highlight techniques where repeated sampling enables estimation of

* [Warm-start QAOA with the Optimization Mapper Qiskit addon](/docs/tutorials/warm-start-qaoa)

* [Quantum approximate multi-objective optimization](/docs/tutorials/quantum-approximate-multi-objective-optimization)

* [Pauli correlation encoding to reduce max-cut requirements](/docs/tutorials/pauli-correlation-encoding-for-qaoa)

* [Implicit solvent calculations using Qiskit Serverless](/docs/tutorials/implicit-solvent-calculations)
Expand Down
Loading
Loading