From bb8cd08303b2d68f335d886a7da9224d2d70f1fe Mon Sep 17 00:00:00 2001 From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com> Date: Tue, 3 Oct 2023 23:38:25 -0400 Subject: [PATCH 1/9] Add acronym to spelling list --- cSpell.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/cSpell.json b/cSpell.json index 08b5a93c12..cc8b776527 100644 --- a/cSpell.json +++ b/cSpell.json @@ -238,7 +238,8 @@ "XIYY", "ZSXX", "qelib", - "QVSM" + "QVSM", + "ITTL" ], "ignoreRegExpList": [ // Markdown links From ff8d2a96d5bac36f764fbac8dedd924b1e2378a5 Mon Sep 17 00:00:00 2001 From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com> Date: Wed, 4 Oct 2023 12:33:32 -0400 Subject: [PATCH 2/9] Migrate images from closed source --- public/images/build/estimator.svg | 69 ++++++++++++++++++ public/images/build/estimator@dark.svg | 55 ++++++++++++++ public/images/build/options.png | Bin 0 -> 81283 bytes public/images/build/qasm2.png | Bin 0 -> 4726 bytes public/images/build/sampler.svg | 32 ++++++++ public/images/build/sampler@dark.svg | 17 +++++ public/images/build/visualize.png | Bin 0 -> 5472 bytes public/images/migration/account-231.png | Bin 0 -> 2312 bytes public/images/migration/admin-UI1.png | Bin 0 -> 157846 bytes public/images/migration/allocation.png | Bin 0 -> 53827 bytes public/images/migration/canary.svg | 8 ++ .../migration/circuits_shots_matrix1.png | Bin 0 -> 40594 bytes public/images/migration/dedicated_queue1.jpg | Bin 0 -> 215611 bytes .../migration/dedicated_queue_no_jobs1.jpg | Bin 0 -> 192021 bytes public/images/migration/eagle.svg | 11 +++ public/images/migration/egret.svg | 3 + public/images/migration/exp-card.png | Bin 0 -> 248307 bytes public/images/migration/fairshare3.png | Bin 0 -> 91766 bytes public/images/migration/fairshare4.png | Bin 0 -> 91579 bytes public/images/migration/falcon.svg | 9 +++ public/images/migration/filter.png | Bin 0 -> 2005 bytes public/images/migration/find-providers1.png | Bin 0 -> 51765 bytes .../images/migration/fixed_batch_circuit1.png | Bin 0 -> 404287 bytes .../migration/fixed_single_circuit1.png | Bin 0 -> 188233 bytes public/images/migration/graph-view1.png | Bin 0 -> 14943 bytes public/images/migration/hummingbird.svg | 16 ++++ public/images/migration/leaving1.png | Bin 0 -> 52121 bytes .../normal_queue_with_providers1.jpg | Bin 0 -> 177206 bytes public/images/migration/osprey.svg | 13 ++++ .../migration/overflow-menu--vertical.png | Bin 0 -> 1864 bytes public/images/migration/overflow-menu.png | Bin 0 -> 1937 bytes public/images/migration/providers1.jpg | Bin 0 -> 252975 bytes public/images/migration/seg-h.png | Bin 0 -> 19034 bytes public/images/migration/settings20.png | Bin 0 -> 2265 bytes public/images/migration/switcher-small1.png | Bin 0 -> 2242 bytes public/images/migration/switcher-small2.png | Bin 0 -> 2242 bytes public/images/migration/table-view.png | Bin 0 -> 264237 bytes public/images/migration/view-switcher1.png | Bin 0 -> 2438 bytes public/images/optimize/m3.png | Bin 0 -> 105037 bytes public/images/optimize/resiliance-2.png | Bin 0 -> 98534 bytes public/images/optimize/sampling-overhead.png | Bin 0 -> 31968 bytes public/images/optimize/stratified.png | Bin 0 -> 12969 bytes .../qiskit-ibm-runtime/noisy-sim-circuit.png | Bin 0 -> 4868 bytes .../noisy-sim-estimator-circuit.png | Bin 0 -> 3135 bytes .../noisy-sim-estimator-ideal.png | Bin 0 -> 16352 bytes .../noisy-sim-estimator-noisy.png | Bin 0 -> 19818 bytes .../noisy-sim-sampler-ideal.png | Bin 0 -> 14880 bytes .../noisy-sim-sampler-noisy.png | Bin 0 -> 18322 bytes public/images/run/batch.png | Bin 0 -> 35060 bytes public/images/run/iterative.png | Bin 0 -> 45796 bytes public/images/run/jobs-failing.png | Bin 0 -> 46335 bytes public/images/run/session-overview.png | Bin 0 -> 5641 bytes public/images/start/runtime-architecture.png | Bin 0 -> 58481 bytes 53 files changed, 233 insertions(+) create mode 100644 public/images/build/estimator.svg create mode 100644 public/images/build/estimator@dark.svg create mode 100644 public/images/build/options.png create mode 100644 public/images/build/qasm2.png create mode 100644 public/images/build/sampler.svg create mode 100644 public/images/build/sampler@dark.svg create mode 100644 public/images/build/visualize.png create mode 100644 public/images/migration/account-231.png create mode 100644 public/images/migration/admin-UI1.png create mode 100644 public/images/migration/allocation.png create mode 100644 public/images/migration/canary.svg create mode 100644 public/images/migration/circuits_shots_matrix1.png create mode 100644 public/images/migration/dedicated_queue1.jpg create mode 100644 public/images/migration/dedicated_queue_no_jobs1.jpg create mode 100644 public/images/migration/eagle.svg create mode 100644 public/images/migration/egret.svg create mode 100644 public/images/migration/exp-card.png create mode 100644 public/images/migration/fairshare3.png create mode 100644 public/images/migration/fairshare4.png create mode 100644 public/images/migration/falcon.svg create mode 100644 public/images/migration/filter.png create mode 100644 public/images/migration/find-providers1.png create mode 100644 public/images/migration/fixed_batch_circuit1.png create mode 100644 public/images/migration/fixed_single_circuit1.png create mode 100644 public/images/migration/graph-view1.png create mode 100644 public/images/migration/hummingbird.svg create mode 100644 public/images/migration/leaving1.png create mode 100644 public/images/migration/normal_queue_with_providers1.jpg create mode 100644 public/images/migration/osprey.svg create mode 100644 public/images/migration/overflow-menu--vertical.png create mode 100644 public/images/migration/overflow-menu.png create mode 100644 public/images/migration/providers1.jpg create mode 100644 public/images/migration/seg-h.png create mode 100644 public/images/migration/settings20.png create mode 100644 public/images/migration/switcher-small1.png create mode 100644 public/images/migration/switcher-small2.png create mode 100644 public/images/migration/table-view.png create mode 100644 public/images/migration/view-switcher1.png create mode 100644 public/images/optimize/m3.png create mode 100644 public/images/optimize/resiliance-2.png create mode 100644 public/images/optimize/sampling-overhead.png create mode 100644 public/images/optimize/stratified.png create mode 100644 public/images/qiskit-ibm-runtime/noisy-sim-circuit.png create mode 100644 public/images/qiskit-ibm-runtime/noisy-sim-estimator-circuit.png create mode 100644 public/images/qiskit-ibm-runtime/noisy-sim-estimator-ideal.png create mode 100644 public/images/qiskit-ibm-runtime/noisy-sim-estimator-noisy.png create mode 100644 public/images/qiskit-ibm-runtime/noisy-sim-sampler-ideal.png create mode 100644 public/images/qiskit-ibm-runtime/noisy-sim-sampler-noisy.png create mode 100644 public/images/run/batch.png create mode 100644 public/images/run/iterative.png create mode 100644 public/images/run/jobs-failing.png create mode 100644 public/images/run/session-overview.png create mode 100644 public/images/start/runtime-architecture.png diff --git a/public/images/build/estimator.svg b/public/images/build/estimator.svg new file mode 100644 index 0000000000..ca5da58de7 --- /dev/null +++ b/public/images/build/estimator.svg @@ -0,0 +1,69 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/public/images/build/estimator@dark.svg b/public/images/build/estimator@dark.svg new file mode 100644 index 0000000000..661e543bf9 --- /dev/null +++ b/public/images/build/estimator@dark.svg @@ -0,0 +1,55 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/public/images/build/options.png b/public/images/build/options.png new file mode 100644 index 0000000000000000000000000000000000000000..39a69a56ade4369c44030a25a9ab0d5bf132a3f9 GIT binary patch literal 81283 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

Zr6Iy*z}MGndrF_Mw;X356|*I0lxpf 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 literal 0 HcmV?d00001 diff --git a/public/images/build/qasm2.png b/public/images/build/qasm2.png new file mode 100644 index 0000000000000000000000000000000000000000..603fe85af2c1727ecbbb47284e86810011ed71d2 GIT binary patch literal 4726 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 literal 0 HcmV?d00001 diff --git a/public/images/build/sampler.svg b/public/images/build/sampler.svg new file mode 100644 index 0000000000..ed7a2e4d6b --- /dev/null +++ b/public/images/build/sampler.svg @@ -0,0 +1,32 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/public/images/build/sampler@dark.svg b/public/images/build/sampler@dark.svg new file mode 100644 index 0000000000..f376535d19 --- /dev/null +++ b/public/images/build/sampler@dark.svg @@ -0,0 +1,17 @@ + + + + + + + + + + + + + + + + + diff --git a/public/images/build/visualize.png b/public/images/build/visualize.png new file mode 100644 index 0000000000000000000000000000000000000000..5b34a571d342532ae339fd4af1039c1bbffe8c39 GIT binary patch literal 5472 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

asMeE;9L?K9t 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 + + + + + + + diff --git a/public/images/migration/circuits_shots_matrix1.png b/public/images/migration/circuits_shots_matrix1.png new file mode 100644 index 0000000000000000000000000000000000000000..13e82e2a77154bc0ba964c073b5dfdd35c8fc774 GIT binary patch literal 40594 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¾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 literal 0 HcmV?d00001 diff --git a/public/images/migration/dedicated_queue1.jpg b/public/images/migration/dedicated_queue1.jpg new file mode 100644 index 0000000000000000000000000000000000000000..b74670da7f59722c84e57be7c55dc30873dfad05 GIT binary patch literal 215611 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%0DufDqbhqo_O4_5kWC13CvnIjuy0lor&hxgOk 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 + + + + + + + + + + diff --git a/public/images/migration/egret.svg b/public/images/migration/egret.svg new file mode 100644 index 0000000000..a6c24d8ed0 --- /dev/null +++ b/public/images/migration/egret.svg @@ -0,0 +1,3 @@ + + + diff --git a/public/images/migration/exp-card.png b/public/images/migration/exp-card.png new file mode 100644 index 0000000000000000000000000000000000000000..2e6de9ab61b31e226f7567b5245e64ef2aa45f25 GIT binary patch literal 248307 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 z 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

N5Bi#Kg&L`P!UeB(Q7qq}xNbxLcod?Xbr0nO+ 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 literal 0 HcmV?d00001 diff --git a/public/images/migration/falcon.svg b/public/images/migration/falcon.svg new file mode 100644 index 0000000000..93c5d1cafb --- /dev/null +++ b/public/images/migration/falcon.svg @@ -0,0 +1,9 @@ + + + + + + + + + diff --git a/public/images/migration/filter.png b/public/images/migration/filter.png new file mode 100644 index 0000000000000000000000000000000000000000..74809aa812a25f6b9ba3ead307c05ecf50e16548 GIT binary patch literal 2005 zcmb7FZEO@p7+xrCpmJJ+L99s~wxN{b-hSNI?xrU#ceOp@l}meu5+z}7cec0mZfDuu z_OAUwuBa^-G*Ch$6_RR5T0?03Ni;!CN;DEpNHA*r2-F&5VuJoKss2D`uh*m07Vwh2 zot=5+dEfV$_kHJhqO;voU0Y32lqc2^?IQ0d-DiCj`M=q8V}iUkm>v6Vih5*|`>dhH z&uyWos%|~mJ16>W%`vP$; zZbndA?-;UB_fTh28R}CcmEQFnXwJ)oAd4Ib^4W}G%lR-}xl^=S#N8 zSC~#ajw!QjE|>G>d|qtzvb-coEGMvnzz_su4;l{4GlpHi$Ph)gV(F%%V*|L1FopY_ zFikvN2q9~hX$`w16A_HfLzCsboEuURs48Wg*>7cv##Mzy8I(naV-qZ2#+qsDU^|Uh zp)N1qV}M8-kC$z%=u0+RHeow$10;-+AS=UX}-i$oF@ z*7OWnu)ErKgIHT6$VBY63uyYaXjGi(PM3W`O;G?B)u>#FSc3H}fiG)C|RLX0oy z=a`h_6PaL&6H}t7X(9?O?vG-n-%S8_|3WROSRovD-4jE6z%PUp!Xc!X6!P6Wxqwu9h56D4wRoAgGfUG6Xo6v%!4ddw_7-Pc6m+|*Oqj~ML21< z?y%hF$w&F7Kn9_<$UU(Cr+ws}S<@JcwkA6~%E1D408CfSYQUJFLakr$h4E`2SIt}- zp5I>c&*a)Wl`|I$JsZ?~-Iac)oe1;fkl}%E>Y3A{CgceRKWX#Ej{i z+PeMv%--Esf8N1=f3$FGPyKhl*QaOOr{Lv^uEP^2US(UZe$~joe7xnwhCTXI=Qqy0 mRG0@fw<~5V5=UyczCme?r{0_P9DCorcw=py(dpd>kNyjChLRxw literal 0 HcmV?d00001 diff --git a/public/images/migration/find-providers1.png b/public/images/migration/find-providers1.png new file mode 100644 index 0000000000000000000000000000000000000000..bd3cfbb5dee7166b800b2f428f813792a75c1514 GIT binary patch literal 51765 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

Q|S<=<2B3Ow6Ws0py6Qn@{+j1_-Y^fqb!W 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%0AE^sz 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

}*A2X9R*E3o?iYwybAsm%L!*|Ln1 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

R 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 NHT=I+L) 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 a!}cP2?HkA~wRqfrma`qo5m{^P5%n)r;4WPN literal 0 HcmV?d00001 diff --git a/public/images/migration/settings20.png b/public/images/migration/settings20.png new file mode 100644 index 0000000000000000000000000000000000000000..8b94c16e1d898abb247667acfab678fcae4ab4e0 GIT binary patch literal 2265 zcmb_eeQXnD94-T8OqMK)EPS{eS4_so^*(y-U5|Bhw1X9GH@hYS6O^}iZ`;e-yYueW zcEf}?B{-&$1c8Wus8JJ00OJR;#0>dxgJcSrDMBD3Xb^)7A3~HEjPG@Asb+j=Y;wKp zd(Zp(J-_FDe(&4f*3i<*ikTHQo2@d?><^>+H0vtAAAP^l`$#3aP0^ZH7&e>3Ze0_y z?=_@tw#hYeWVyLK_=F&;DF=|$D0E~~8baG_bq!e!h#kan`4fC8kT39xJ`sTe}mi|67B=-C=3aV!ThJG^+K zl@MDVY{h)44l$R*O^7thV4TN6yD1ODF2op$=17VoX(vI^0_7H*9xVUCQ8rzQ31R<| zd@l6MiziG|6G$?X$v84jhpNX(+T-z%6hkr$fe?hzrI;W~D2BZd!4C~lmo-yX70ikV zqH3q<#Szo75>i?*tYYM4LV}T5ppmqLvP#MUC9#OpI`w2Oxg?S>2~$up4TPnOSS_KN zs*zA{6T0~NZwZjJ!C*1RxLi`HVhY1-N~1FJf{cqcB3&9J!_ZJWbrCkD5ly>QjVAbX z2uxLvsA{sXP^|^Zn9qmRw#$m7W{i0yaOejn^x_P~&;*4RjE~T6!Nmwpia;wzQDe}c zD#@{~aiP4xplKygWEcsU;I3dv6k@8L0;pU$1>%s@lsJwRMHGB$Qq@sn#Lihd9`N~E zbu}g@(F-HIbTJla^0{e`+f6VII!8Ac6atE20!4%YzZXZ+IAmE8c%B1PRALAh<8%=` z&qj$T&+-I_aZV@8xm`5lF3k6UvGVx0sKEmjg2B_u`yF^Z;~QNUTI z&-qAbmJPJRUHLX@gU{xlk}{UFjsQffCA_$3c>zjzepntyk9*3TpPxxU6!Z=*8Ov^{ zF*5^n*ceCJ-Nl3CZK!0`-0(>(3s-5yrrxq`ss3gi@MrqCPzUZA}6 zVge{}i1u(2|L>*ToA<{!j$2A;oBv;>kk-aM=3(-m_RhU4+2oN~azp6kupWy?7Wz>< z^q_)N($SGt@mpt^%{Bo9{EZQQc;{7jehK2f~?M-4o`#9Y3~b z+gp=s?PbF&cMm5v9{a8ydjSjAR_|8Nj;^^-J#~w5{pqXwT8@12`i<4~=R@<$d%j+H z<7RKo1Lv02_3rJT_Vc#y`JO|L(CMBxxQ*pU`W~HSPrp2{U})&bhKJ_$uRHwF1)AJ? zy=-qyd)0;?9^O&aTD|Vv<2zP|KAFGd++*zF?JwT9WpG{p`jMn6x>l&v>SC(INXluj|Y^Q$L^a>#VP?%>Llu zQ|nKheYd@4Xxc9`_dnlqY}3I7r;ZNtSEr{pcj(`4+S4;S=~ex~E44f4LZjtmvitba z?Zcb49Z*_7wy)>wPG5iS!#@PitdaVGy*I8^#0Flv6slv+ym@>!GgLED_2-ZqH%|18 wZ1rVX@94#A4L7M^+vte&{>g8o{VT3coZjE&n=Q(7tv?@urjUQv;#EC=0V6;Fg#Z8m literal 0 HcmV?d00001 diff --git a/public/images/migration/switcher-small1.png b/public/images/migration/switcher-small1.png new file mode 100644 index 0000000000000000000000000000000000000000..27f2c929b7451f0602494f01c831eec521cdd723 GIT binary patch literal 2242 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 z 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⁡V;J$(OV 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 z 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 znu≶VLO3GpX1t*R0J-J63yMH!D3=9wF!ZFq= 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 A;Q#;t literal 0 HcmV?d00001 diff --git a/public/images/run/session-overview.png b/public/images/run/session-overview.png new file mode 100644 index 0000000000000000000000000000000000000000..fbb6034fab9c7aeb9c986d3f57e0d5c19f5499a4 GIT binary patch literal 5641 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 literal 0 HcmV?d00001 From 0f78ca23490e02ec64f19554f97b515740f351d1 Mon Sep 17 00:00:00 2001 From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com> Date: Wed, 4 Oct 2023 12:33:32 -0400 Subject: [PATCH 3/9] Migrate TOC files from closed source MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Axel Hernández Ferrera --- docs/build/_toc.json | 98 +++++++++++++++++++++++++++++++++++++++++ docs/optimize/_toc.json | 21 +++++++++ docs/run/_toc.json | 74 +++++++++++++++++++++++++++++++ docs/start/_toc.json | 47 ++++++++++++++++++++ docs/test/_toc.json | 21 +++++++++ 5 files changed, 261 insertions(+) create mode 100644 docs/build/_toc.json create mode 100644 docs/optimize/_toc.json create mode 100644 docs/run/_toc.json create mode 100644 docs/start/_toc.json create mode 100644 docs/test/_toc.json diff --git a/docs/build/_toc.json b/docs/build/_toc.json new file mode 100644 index 0000000000..e44bdb2c2c --- /dev/null +++ b/docs/build/_toc.json @@ -0,0 +1,98 @@ +{ + "title": "Build", + "children": [ + { + "title": "Overview", + "url": "/build" + }, + { + "title": "Build circuits with Qiskit", + "children": [ + { + "title": "Build your first circuit", + "url": "/build/first-circuit" + }, + { + "title": "Circuit library", + "url": "/api/qiskit/circuit_library" + }, + { + "title": "Operators", + "url": "/build/operators_overview" + }, + { + "title": "Dynamic circuits", + "children": [ + { + "title": "Get started with dynamic circuits", + "url": "/build/getting-started-with-dynamic-circuits" + }, + { + "title": "Mid-circuit measurement", + "url": "/build/midcircuit_measurement" + }, + { + "title": "Dynamic circuits basics with Qiskit", + "url": "/build/dynamic-circuits-basics-with-qiskit" + }, + { + "title": "Dynamic circuits basics with OpenQASM 3", + "url": "/build/dynamic-circuits-basics-with-openqasm3" + } + ] + }, + { + "title": "Import Qiskit into OpenQASM", + "url": "/build/qasm-circuits" + } + ] + }, + { + "title": "Build with primitives", + "children": [ + { + "title": "Introduction to primitives", + "url": "/build/primitives" + }, + { + "title": "Get started with primitives", + "url": "/build/primitives-get-started" + }, + { + "title": "Primitives examples", + "url": "/build/primitives-examples" + }, + { + "title": "Specify advanced runtime options", + "url": "/build/primitive-options" + } + ] + }, + { + "title": "Build with OpenQASM", + "children": [ + { + "title": "OpenQASM 3 feature table", + "url": "/build/feature-table" + }, + { + "title": "OpenQASM 3.x Live Specification", + "url": "https://openqasm.com/" + } + ] + }, + { + "title": "Advanced circuit options", + "children": [ + { + "title": "Conditional reset", + "url": "/build/backend_reset" + }, + { + "title": "Pulse gates", + "url": "/build/pulse" + } + ] + } + ] +} diff --git a/docs/optimize/_toc.json b/docs/optimize/_toc.json new file mode 100644 index 0000000000..11549f377a --- /dev/null +++ b/docs/optimize/_toc.json @@ -0,0 +1,21 @@ +{ + "title": "Optimize", + "children": [ + { + "title": "Overview", + "url": "/optimize" + }, + { + "title": "Algorithm tuning options", + "url": "/optimize/algorithm-tuning-options" + }, + { + "title": "Configure error suppression", + "url": "/optimize/error-suppression" + }, + { + "title": "Configure error mitigation", + "url": "/optimize/error-mitigation" + } + ] +} diff --git a/docs/run/_toc.json b/docs/run/_toc.json new file mode 100644 index 0000000000..5e463d0e51 --- /dev/null +++ b/docs/run/_toc.json @@ -0,0 +1,74 @@ +{ + "title": "Run", + "children": [ + { + "title": "Run on quantum systems", + "url": "/run" + }, + { + "title": "Hardware overview", + "url": "/run/hardware" + }, + { + "title": "Manage your account", + "url": "/run/account-management" + }, + { + "title": "Instances", + "url": "/run/instances" + }, + { + "title": "Run on quantum backends", + "url": "/run/backends" + }, + { + "title": "Estimate job run time", + "url": "/run/estimate-job" + }, + { + "title": "Fair-share queuing", + "url": "/run/queue" + }, + { + "title": "Sessions", + "children": [ + { + "title": "About sessions", + "url": "/run/sessions" + }, + { + "title": "Run jobs in a session", + "url": "/run/run-sessions" + } + ] + }, + { + "title": "System circuit execution", + "url": "/run/circuit-execution" + }, + { + "title": "Monitor a job", + "url": "/run/monitor" + }, + { + "title": "Manage cost", + "url": "/run/cost" + }, + { + "title": "Maximum execution time", + "url": "/run/max-execution-time" + }, + { + "title": "Reserve system time", + "url": "/run/reserve-system-time" + }, + { + "title": "Retired systems", + "url": "/run/retired-systems" + }, + { + "title": "Error code registry", + "url": "/errors" + } + ] +} diff --git a/docs/start/_toc.json b/docs/start/_toc.json new file mode 100644 index 0000000000..4fca6ac90f --- /dev/null +++ b/docs/start/_toc.json @@ -0,0 +1,47 @@ +{ + "title": "Start", + "children": [ + { + "title": "Introduction", + "url": "/start" + }, + { + "title": "Install", + "url": "/start/install" + }, + { + "title": "Hello world", + "url": "/start/hello-world" + }, + { + "title": "What is Qiskit?", + "children": [ + { + "title": "Introduction to Qiskit open-source", + "url": "/start/intro-to-qiskit" + }, + { + "title": "Introduction to Qiskit Runtime", + "url": "/start/runtime" + } + ] + }, + { + "title": "Migration guides", + "children": [ + { + "title": "backend.run compared to Qiskit Runtime", + "url": "/start/compare" + }, + { + "title": "Migrate to Qiskit Runtime", + "url": "/start/migrate" + }, + { + "title": "Migration examples", + "url": "/start/migrate-examples" + } + ] + } + ] +} diff --git a/docs/test/_toc.json b/docs/test/_toc.json new file mode 100644 index 0000000000..ea26a01919 --- /dev/null +++ b/docs/test/_toc.json @@ -0,0 +1,21 @@ +{ + "title": "Test", + "children": [ + { + "title": "Overview", + "url": "/test" + }, + { + "title": "Simulators overview", + "url": "/test/simulators" + }, + { + "title": "Simulate with noise", + "url": "/test/noise" + }, + { + "title": "Building noise models", + "url": "/test/building_noise_models" + } + ] +} From fb238270e4580aed6556614c1a50309f43cd5cd0 Mon Sep 17 00:00:00 2001 From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com> Date: Wed, 4 Oct 2023 12:33:32 -0400 Subject: [PATCH 4/9] Migrate original content from closed source Co-authored-by: Abby Cross Co-authored-by: Rebecca Dimock <66339736+beckykd@users.noreply.github.com> --- docs/build/backend_reset.ipynb | 775 +++++++++++++++++++++ docs/build/feature-table.mdx | 69 ++ docs/build/first-circuit.mdx | 56 ++ docs/build/index.mdx | 12 + docs/build/operators_overview.ipynb | 741 ++++++++++++++++++++ docs/build/primitives-examples.mdx | 276 ++++++++ docs/build/primitives-get-started.mdx | 135 ++++ docs/build/primitives.mdx | 72 ++ docs/build/pulse.ipynb | 965 ++++++++++++++++++++++++++ docs/optimize/index.mdx | 13 + docs/run/backends.mdx | 192 +++++ docs/run/circuit-execution.mdx | 29 + docs/run/estimate-job.mdx | 60 ++ docs/run/hardware.mdx | 273 ++++++++ docs/run/instances.mdx | 87 +++ docs/run/queue.mdx | 63 ++ docs/run/reserve-system-time.mdx | 42 ++ docs/run/retired-systems.mdx | 72 ++ docs/start/index.mdx | 55 ++ docs/start/install.mdx | 266 +++++++ docs/start/intro-to-qiskit.ipynb | 630 +++++++++++++++++ docs/start/runtime.mdx | 137 ++++ docs/test/index.mdx | 12 + docs/test/simulators.mdx | 122 ++++ 24 files changed, 5154 insertions(+) create mode 100644 docs/build/backend_reset.ipynb create mode 100644 docs/build/feature-table.mdx create mode 100644 docs/build/first-circuit.mdx create mode 100644 docs/build/index.mdx create mode 100644 docs/build/operators_overview.ipynb create mode 100644 docs/build/primitives-examples.mdx create mode 100644 docs/build/primitives-get-started.mdx create mode 100644 docs/build/primitives.mdx create mode 100644 docs/build/pulse.ipynb create mode 100644 docs/optimize/index.mdx create mode 100644 docs/run/backends.mdx create mode 100644 docs/run/circuit-execution.mdx create mode 100644 docs/run/estimate-job.mdx create mode 100644 docs/run/hardware.mdx create mode 100644 docs/run/instances.mdx create mode 100644 docs/run/queue.mdx create mode 100644 docs/run/reserve-system-time.mdx create mode 100644 docs/run/retired-systems.mdx create mode 100644 docs/start/index.mdx create mode 100644 docs/start/install.mdx create mode 100644 docs/start/intro-to-qiskit.ipynb create mode 100644 docs/start/runtime.mdx create mode 100644 docs/test/index.mdx create mode 100644 docs/test/simulators.mdx diff --git a/docs/build/backend_reset.ipynb b/docs/build/backend_reset.ipynb new file mode 100644 index 0000000000..9d65d16c11 --- /dev/null +++ b/docs/build/backend_reset.ipynb @@ -0,0 +1,775 @@ +{ + "cells": [ + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Conditional reset" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "IBM Quantum systems support the `reset` instruction in Qiskit. This allows users to reset qubits into the ground state (`|0>`) with high fidelity. These instructions are comprised of a not-gate conditioned on the measurement outcome of the qubit, and demonstrate the real-time compute power of the IBM Quantum systems. They can be explored for the reuse of qubits in a circuit, to yield an increase in system throughput, and provide fidelity improvements over standard cavity-cooling methods. \n", + "\n", + "Here we provide several examples demonstrating how to use the `reset` instruction. " + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "We can now define the delay time between programs in a parameter called `rep_delay`. Reducing `rep_delay` enables faster executions and finer control over jobs. Previously, a user could only control this parameter with a finite list of `rep_times` (the overall time of program execution) for pulse jobs. Now, users can choose from a continuous backend `rep_delay_range` for both circuit and pulse jobs. We will review these flags in this tutorial.\n", + "\n", + "\n", + "Qubit initialization can now be turned off by users (previously qubits were always initialized). Here we demonstrate how this manifests itself through poor thermalization of the qubit to the ground state in conjunction with a small `rep_delay`." + ] + }, + { + "cell_type": "code", + "execution_count": 27, + "metadata": {}, + "outputs": [], + "source": [ + "import numpy as np\n", + "import matplotlib.pyplot as plt\n", + "\n", + "import qiskit\n", + "from qiskit import IBMQ, QuantumCircuit, execute, assemble, schedule, transpile\n", + "from qiskit.providers.ibmq.job import job_monitor\n", + "from qiskit.tools.visualization import plot_histogram" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Loading the IBM Quantum Account" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "IBMQ.load_account()\n", + "\n", + "# Replace with your provider.\n", + "provider = IBMQ.get_provider(group='deployed')\n", + "# ibmq_paris supports conditional reset.\n", + "backend = provider.get_backend('ibmq_paris')\n", + "\n", + "config = backend.configuration()" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "here `config` is the `backend.configuration()` that will be referenced throughout this tutorial." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Reset instruction" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "

" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We begin by demonstrating the `reset` instruction. Note that `reset` is currently only enabled for quantum circuits (not pulse schedules)." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "First, we check that the `reset` instruction is supported on the requested backend. This information is found in the backend configuration:" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "['acquire',\n", + " 'u2',\n", + " 'x',\n", + " 'measure',\n", + " 'shiftf',\n", + " 'play',\n", + " 'cx',\n", + " 'u3',\n", + " 'id',\n", + " 'setf',\n", + " 'reset',\n", + " 'u1',\n", + " 'delay']" + ] + }, + "execution_count": 5, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "config.supported_instructions" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Single-qubit reset experiment" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We perform the following sequences of one-qubit operations: `h -> x -> measure` and `h -> reset -> x -> measure`. Without reset, the expected result of the first circuit is $\\frac{1}{\\sqrt{2}}\\left(|0\\rangle+|1\\rangle\\right)$ and a uniform distribution of `0` and `1` bits at the output. However, when the `reset` is included, the superposition prepared by the Hadamard gate is reset to $|0\\rangle$ and the X-gate performs a bit flip to $|1\\rangle$.\n", + "\n", + "Below we define both of these circuits, and allow for a variable number of `reset` operations to be performed." + ] + }, + { + "cell_type": "code", + "execution_count": 31, + "metadata": {}, + "outputs": [], + "source": [ + "h_x_circ = QuantumCircuit(1, 1)\n", + "h_x_circ.h(0)\n", + "h_x_circ.x(0)\n", + "h_x_circ.measure(0, 0)\n", + "\n", + "def h_reset_x_circ(n_resets):\n", + " \"\"\"Do h, then n_resets reset instructions, then x on a single qubit.\"\"\"\n", + " qc = QuantumCircuit(1, 1)\n", + " qc.h(0)\n", + " qc.reset([0]*n_resets)\n", + " qc.x(0)\n", + " qc.measure(0,0)\n", + " return qc" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We run this experiment on qubit 0, with 0, 1, 3, and 5 `reset` operations. We see clear improvement after a single reset and further improvement with 3 resets. By 5 resets the improvement in the qubit state preparation has mostly saturated, and the final fidelity is close to the measurement fidelity of the qubit under consideration. " + ] + }, + { + "cell_type": "code", + "execution_count": 32, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Job Status: job has successfully run\n" + ] + } + ], + "source": [ + "circs0 = [h_x_circ, h_reset_x_circ(1), h_reset_x_circ(3), h_reset_x_circ(5)]\n", + "job1q_0 = execute(circs0, backend, initial_layout=[0])\n", + "job_monitor(job1q_0)" + ] + }, + { + "cell_type": "code", + "execution_count": 33, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAtQAAAFoCAYAAAB3zWxjAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8vihELAAAACXBIWXMAAAsTAAALEwEAmpwYAABLJElEQVR4nO3deVyWVf7/8ddhBwEDF1BEwI3EBTVKmUxNy5psMcs0l5xMndGyrKa0r2XWr9JpbFdbtM2c0rKyxilH01FzGRNRcgtBwUTFBTcWZT2/P1gGFRW8WVzez8fjfnTf13XOdX+u+5Z8czzXuYy1FhERERERuTBONV2AiIiIiMilTIFaRERERMQBCtQiIiIiIg5QoBYRERERcYACtYiIiIiIAxSoRUREREQc4FLTBdSkunXr2tDQ0JouQ0RERCrJ+vXrD1lr6522rb6Li8tMoDUaTJSKscaYY/n5+R8XFBS8e8011+SU1eiKDtShoaHExMTUdBkiIiJSSYwxu07f5uLiMjMwMLBlvXr1jjg5OekGHFJu1lpycnJc9+7dO/r48eMdgCFltdNvaSIiInK5a12vXr3jCtNSUcYY3N3dc0NCQo4Bnc/WToFaRERELndOCtPiiKI/P85n3V+NtYiIiIiIXHYUqEVERERqSFBQUJv58+f71HQd4pgr+qJEERERufIMf5NrqvL4M8awviqPLxcfjVCLiIiIXKJ2796twdGLgAK1iIiISA2KjY31atGiRYSPj0+7Xr16NcnKyjLl7dutW7fw6OjoFtOnT/dPT08vV66bMWOGX1BQUJvDhw87AXz55Ze+devWjdy7d6/C+QVSoBYRERGpQd9++63/okWLEhITEzdt27bNc+rUqXXL23fjxo3bBg8efGj27Nl1goKC2t5///0hP/30U61z9Rk+fPiRa665JmP48OGNU1NTnR955JHQd955J7lhw4Z5jp/NlUmBWkRERKQGjRw5cn9oaGhuQEBAfs+ePY9t3LjRs7x9fXx8CkaNGnV49erVCbGxsVtCQkKyhw0bFhYWFtZq5syZfmfr99FHH/2+evVqny5duoTfdNNNx+6///5jlXM2VyYFahEREZEa1LBhw9zi515eXgWZmZllrnfcrFmzVl5eXu29vLzaL1y40Pv0/SEhIbmRkZEnIiIisg4cOOCWkpLidrb3rFu3bv7tt99+JCEhwXPcuHGplXMmVy7NlRERERG5BCQmJm4pa/uqVas8P/roo7rfffedf3BwcPagQYMOzZ49O9nf37/gbMdavXq159y5c+vefvvthx9++OHGP//8c0LVVX750wi1iIiIyCWqU6dOLfr06dPcw8OjYOnSpb9t2LDhtyeffPLQucJ0VlaWGTJkSJPx48fv+fLLL5P379/vOnny5HrVWfflRiPUIiIickW5nNaJfumll/bceOONmc7OZ70r9hlGjx7dqEGDBjljx449CPDpp58m3XrrreG9evU63qZNm+wqK/YyZqy9cm9tHxUVZWNiYmq6DBEREakkxpj11tqo0tvi4uKSIyMjD9VUTXJ5iIuLqxsZGRla1j5N+RARERERcYACtYiIiIiIAxSoRUREREQcoEAtIiIiIuIABWoREREREQcoUIuIiIiIOECBWkRERETEAQrUIiIiIiIOUKAWERERqSFBQUFt5s+f71PTdYhjdOtxERERuaLsCJ94TVUev2n8xMvm1uaOWLBggc9DDz0Utn///l9rupaqphFqERERkUvU7t27HR4czc3NrYxSKsWJEydMWlqac03XUVEK1CIiIiI1KDY21qtFixYRPj4+7Xr16tUkKyvLlLdvt27dwqOjo1tMnz7dPz09vVy5Lj4+3s0Yc80bb7xRt0GDBm2io6PDAd588806TZo0aeXr69uuc+fOzbdv3+4GUFBQwEMPPRTs7+8f6e3t3b5FixYR69at84DCADxixIhGDRo0aFOnTp3IAQMGNM7IyDDHjx93uvfee5sfPHjQ1cvLq72Xl1f75ORk1/PVlpqa6hISEtL2zjvvDJs/f75Pfn5+uT6HgQMHNr7llluaFr8eOXJkUHR0dIuCgoJy9XeUArWIiIhIDfr222/9Fy1alJCYmLhp27ZtnlOnTq1b3r4bN27cNnjw4EOzZ8+uExQU1Pb+++8P+emnn2qVp++KFSu84+Pjtyxbtmz77Nmzr3r99dcbzJs3b0daWtrGP/zhDxn9+vVrUlSf73//+1/v7du3bz5+/PiGOXPm7Kxfv34+wCOPPNIoMTHRY+PGjVsTExM3paamuo0dO7ahr69vwbx58xLq1auXm5WVtSErK2tDaGjoeYfCw8LCcrdu3bqpXbt2WU8//XRwcHBwmzFjxjTcunWr27n6vffeeynx8fGeb7/9dp2FCxd6z5kzp+7s2bOTnJyqJ+oqUIuIiIjUoJEjR+4PDQ3NDQgIyO/Zs+exjRs3epa3r4+PT8GoUaMOr169OiE2NnZLSEhI9rBhw8LCwsJazZw50+9cfV9++eW9vr6+Bd7e3vaDDz6o9/jjj6d26NDhpKurK5MmTdr322+/eW7fvt3N1dXVZmZmOsfFxXlYa+nQocPJkJCQ3IKCAj7//PO677zzzu6AgIB8Pz+/gv/7v//bN3/+fH9HPo/GjRvnvfjii/u3b9++de7cuTuOHj3q3Llz55bXXXdd+Jo1a8r8bHx8fAo++uijpOeeey546NChYZMnT97dtGnTapvLokAtIiIiUoMaNmxYEvy8vLwKMjMzy5xD3KxZs1bF0ycWLlzoffr+kJCQ3MjIyBMRERFZBw4ccEtJSTnnqG7pwLlnzx638ePHB/v4+LTz8fFpd9VVV7Wz1ppdu3a53nnnnenDhg078OijjzauW7du5P333x9y+PBhp3379rmcPHnSqVOnTi2L+919993Njxw5Uq553QkJCW7F5+Pl5dW+rDatWrU6GRkZeSIkJCR7586dHocPHz7r/Oru3btnBgcHZ1treeihhw6Xp4bKokAtIiJymVq4cCHh4eE0a9aMyZMnn7F/165d9OjRg7Zt29KtWzdSUlJK9v3+++/07NmTli1bEhERQXJyMgAPPfQQkZGRtG3blnvvvZeMjIzqOp0rXmJi4pbi6RO33npryQe/atUqz4ceeii4QYMGka+++mqDHj16HN+9e3fcxIkT95/reE5OTrb4eYMGDXJee+21Xenp6RuLHydPnoy9+eabMwGeffbZA1u2bNm2efPmLTt27PB44YUXAgMDA/M8PDwKfv311y2l+2VlZW0AMMbYs703QPPmzXOKz6e4D0BeXh5ffvml7x133BEWEhLS9scff6z91FNP7du3b19cr169zvoHbtKkSfVycnJM/fr1c5977rnA83+ilUeBWkRE5DKUn5/Pww8/zI8//sjWrVv54osv2Lp16ylt/vrXv/LAAw/w66+/MmHCBJ555pmSfQ888ABPPfUU27Zt45dffqF+/foAvPHGG8TFxfHrr7/SuHFjpk6dWq3nJafq1KlTiz59+jT38PAoWLp06W8bNmz47cknnzzk7+9foavxRowYcfD1119vEBMT4wGQlpbm/NFHH/kBLF++3Gvp0qW1srOzjY+PT4G7u3uBk5MTzs7O9O/f/9DDDz8cvGfPHheApKQk16+//toXoGHDhnnHjh1zqciqHXv27HFp0KBB2+eff77Rddddl7l9+/bNixYt2jFgwIBjrq5nv6bx119/dZ80aVLQp59+mjR79uykadOmBa5evbrcU2ccpXWoRURESnnppZd48cUXsdbSo0cPFi5ceMr+VatWcccdd3DixAnc3d1ZvHgx1157LQDGGDw8PACoXbs2qampQOEqCTfccAPr1q3DGMPtt9/O119/XaXn8csvv9CsWTOaNGkCQP/+/fnuu++IiIgoabN161Zef/11AG688UZ69+5dsj0vL4+bb74ZAG/v/80u8PX1BcBay4kTJzCm3AtSXDQup3WiX3rppT033nhjprOzYyvNPfDAA0fT09OdBgwY0GTv3r3u3t7e+TfccMPxoUOHHjl69KjzU089FZySkuLu7u5ecMMNNxyfOHFiKsC0adNSnn766YYdO3ZsefToUZf69evnDB069CBwvH379ifvuOOOw02bNm2Tn5/Ppk2btpzvwkRvb++C77//PiE6OvpEeWvPzc1l4MCBTR555JHU4n7jx4/f86c//SksLi5um6en5zlHyiuDsbbK3+OiFRUVZWNiYmq6DBERuUjk5ORQq1YtFi9eTFRUFPXq1WPu3LnceeedJW0aNWrEH//4R2bMmMFrr73GtGnT2LlzJ1AYqMv6e3Xo0KEsX76c+Ph4XFxc2LJlC61atarSc5k3bx4LFy5k5syZAHz22WesXbv2lBHlAQMG0LFjRx577DG++eYb7rnnHg4dOsTPP//MzJkzcXNzIykpiZtuuonJkydTHNoefPBBfvjhByIiIvjXv/6Fl5dXlZ5LRRhj1ltro0pvi4uLS46MjDxUUzXJ5SEuLq5uZGRkaFn7NOVDRESkyCeffELt2rXp1q0b3t7edOnShWnTpp3S5tChQwwbNgyAxx9/nKSkpPMe98svv+SDDz7AxaXwH4arOkyX15QpU1i+fDnt27dn+fLlBAUF4ezsTF5eHj///DNTpkxh3bp17Ny5k08++aSk38cff8zevXtp2bIlc+fOrbkTELlIKFCLiIgUiY+Pp06dOiWvw8LC2Ldv3yltAgMD+dvf/gbAuHHjAEhISCjZX6tWLby9vU+Zj5yVlcXkyZOpVasW9erVY/HixVV5GgAEBQWx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2lzWMdu0aZP9z3/+Myk/P59Zs2b5/elPf2raq1evjcHBwTl333132pw5c3aV1a/0e5Tl888//x04YyrIjh07XD/88MM6c+fOrZObm2v69euXtn79+q3NmzfPOduxjh075jR27Njg++6779Df/va3hoMGDToSEBCQf673L8vFPodaRERERM6iU6dOLfr06dPcw8OjYOnSpb9t2LDhtyeffPLQucL0kiVLav373//2PnnypMnIyDDjx48PTEtLc+3SpUvm2fqUpVu3bpm1atXKHz9+fGBGRobJy8tj3bp1HsuXL/cCmD59uv/evXtdnJ2d8fPzywNwcnKyDz30UNpPP/101ddff+2bl5dHVlaWWbBggc+OHTtcAerVq5e3c+fOcy59fLonnniiYbt27Vpt377dY+rUqbuSk5M3//3vf993rjANMHz48OC2bdtmzZ07d1ePHj2OPfjggyEVed9iF/uNXUREREQqVUXWib7YvfTSS3tuvPHGTGfnMmeJlOnkyZPmiSeeaJySkuLu4uJiW7RocWLevHkJoaGhuefv/T8uLi788MMPiaNHj24UGhraNicnx4SFhZ184YUX9gD8+9//rv3ss88Gnzx50qlhw4Y5M2fO3Ont7W2bNWuW++WXXyaOHTu20dChQ5s4OTnZyMjIzBkzZvwOMGbMmP3Dhg0LmzVrVr0+ffqkffLJJ7vPV8u99957ZOLEiam+vr7lHpWfPXv2VcuWLau9adOmLQDvvffe7jZt2kS8++67/iNHjjxckc+ixm7scjHQjV1EREQuL+W5sYvIhTjXjV00Qi0iInIp+K7cSxNf/O66cgfz5PKkOdQiIiIiIg7QCLWIiFy2nhlyrKZLqDST+tR0BSJyNhqhFhERERFxgAK1iIiIiIgDFKhFRERERBygQC0iIiIi4gAFahERERERByhQi4iIiNSQoKCgNvPnz/ep6TrEMVo2T0RERK4s35lrqvT4d9mL/tbmxphrPDw8CowpvGHQHXfccXju3Lm7ivfHx8e7vf/++3Vff/31vdVdW1BQUJtp06Yl9+7dO7263/tCaYRaRERE5BK1e/fuCx4cXbdu3dasrKwNWVlZG4rD9JIlS2qNHTs2MDc31wD8+OOP3mPHjg08vW9BQQH5+fkXXnglc+RzqAwK1CIiIiI1KDY21qtFixYRPj4+7Xr16tUkKyur3PeZ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uFb0ZuA2a+2uoiZnrEdtjPEB+gMvnuWwbsDfgUbACQqDdS9r7Q+VXL6IiIiIyBmqe4Qaa+10YPpZ9nUrY1s64H2O470KvFpZ9YmIiIiIVES133pcRERERORyokAtIiIiIuKACgVqY4yTMcap1OtAY8wwY8z1lV+aiIiIiMjFr6Ij1P8CRgMYY7yBGAovCFxmjDl9ZQ4RERERkcteRQN1FLC06Hkf4DhQn8Kbrvy1EusSEREREbkkVDRQewNHi573BL611uZSGLKbVmJdIiIiIiKXhIoG6t+B640xtYBbgMVF2/2BrMosTERERETkUlDRdahfBz4DMoBdwIqi7V2ATZVYl4iIiIjIJaFCgdpa+74xZj0QDCy21hYU7doBPFfZxYmIiIiIXOwqfKdEa20Mhat7lN72r0qrSERERETkElLhG7sYY0YZY7YYY7KMMU2Kto01xtxX+eWJiIiIiFzcKnpjlzHAs8AHgCm1ay/wSOWVJSIiIiJyaajoCPVfgOHW2reAvFLbY4FWlVaViIiIiMgloqKBOgTYXMb2XMDT8XJERERERC4tFQ3UO4EOZWy/DdjqeDkiIiIiIpeWiq7yMQWYaozxonAOdbQxZjDwNDC0sosTEREREbnYVXQd6o+NMS7AK4AXhTd52Qs8aq2dWwX1iYiIiIhc1C5kHeoZwAxjTF3AyVp7oPLLEhERERG5NFQ4UBez1h6qzEJERERERC5F5w3Uxphfga7W2iPGmE2APVtba23byixORERERORiV54R6q+B7FLPzxqoRURERESuNOcN1NbaF0o9n1il1YiIiIiIXGIqeuvxpcaYq8rY7muMWVppVYmIiIiIXCIqemOXboBbGds9gBscrkZERERE5BJTrlU+jDGl747Y1hhzuNRrZ+AWYE9lFiYiIiIiciko77J5MRRejGiBRWXsPwGMrqyiREREREQuFeUN1GEU3mp8J3AdcLDUvhzggLU2v5JrExERERG56JUrUFtrdxU9reicaxERERGRy1p5buzSB/intTa36PlZWWu/qbTKREREREQuAeUZoZ4HBAIHip6fjaXwAkURERERkStGeW7s4lTWcxERERER0ZxoERERERGHlHcOdbloDrWIiIiIXGnKO4e6PDSHWkRERESuOBWaQy0iIiIiIqdSWBYRERERcYDWoRYRERERcYDWoRYRERERcYDW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6qJt26y1P1VmUSIiIiIil4pyB2pjjDNwDIi01i6mcOk8EREREZErWrmnfFhr84FdFK68ISIiIiIiVHwO9f8DJhtj6lZFMSIiIiIil5qKzqH+KxAG7DHGpACZpXdaa9tWVmEiIiIiIpeCigbqeRSuOW2qoBYRERERkUtOuQK1McaLwjsW9gZcKVxzerS19lDVlSYiIiIicvEr7xzqF4A/Af8CvgBuAt6toppERERERC4Z5Z3y0Qd4yFo7B8AY8w9glTHGuWj1DxERERGRK1J5R6iDgZ+LX1hrfwHygIZVUZSIiIiIyKWivIHaGcg5bVseFb+oUURERETkslLeQGyA2caY7FLbPIAZxpis4g3W2jsrszgRERERkYtdeQP1p2Vsm12ZhYiIiIiIXIrKFaittQ9WdSEiIiIiIpeiit56XERERERESlGgFhERERFxgAK1iIiIiIgDFKhFRERERBygQC0iIiIi4gAFahERERERByhQi4iIiIg4QIFaRERERMQBCtQiIiIiIg5QoBYRERERcYACtYiIiIiIAxSoRUREREQcoEAtIiIiIuIABWoREREREQcoUIuIiIiIOECBWkRERETEAQrUIiIiIiIOUKAWEREREXGAArWIiIiIiAMUqEVEREREHKBALSIiIiLiAAVqEREREREHKFCLiIiIiDhAgVpERERExAEK1CIiIiIiDlCgFhERERFxgAK1iIiIiIgDFKhFRERERBygQC0iIiIi4gAFahERERERByhQi4iIiIg4QIFaRERERMQBCtQiIiIiIg5QoBYRERERcYACtYiIiIiIAxSoRUREREQcoEAtIiIiIuIABWoREREREQcoUIuIiIiIOECBWkRERETEAQrUIiIiIiIOUKAWEREREXGAArWIiIiIiAOqPVAbY0YZY5KMMSeNMeuNMTeco20fY8wiY8xBY0y6MWatMebO09r8yRhjy3h4VP3ZiIiIiMiVrloDtTGmH/AW8ArQHlgN/GiMaXyWLl2BpUCvovY/AN+WEcKzgAalH9bak5V/BiIiIiIip3Kp5vd7AvjEWjuj6PVoY8ytwEjgmdMbW2sfO23TC8aYXkBv4OdTm9rUKqhXREREROScqm2E2hjjBlwDLDpt1yLgDxU4lA9w5LRtnsaYXcaYFGPMAmNMewdKFREREREpt+ocoa4LOAP7T9u+H7ipPAcwxjwMNAI+K7U5HhgKxFEYth8DVhljIq21CWUcYwQwAqBhw4YsW7YMgCZNmuDj40NcXBwAderUoVWrVqxYsQIAFxcXOnfuTGxsLMePHwcgKiqK/fv3s3v3bgCaN2+Ou7s7mzdvBrqV55QuCcuWLSM4OJiAgABiYmIA8PX1pUOHDqxcuZK8vDwAunTpwpYtW0hLSwMgMjKS9PR0du7cCUBoaCj+/v7ExsYC4OfnR2RkJMuXL8daizGGrl27EhcXx5Ejhb8zdejQgcOHD5OcnAxUxfcE9evXp0WLFqxcuRIAd3d3oqOjiYmJISMjA4COHTuSkpLCnj17AAgPD8fZ2ZmtW7cCEBgYSFhYGGvWrAHA09OTjh07snbtWk6cOAFAdHQ0SUlJpKYW/mNKREQE+fn5xMfHAxAUFESjRo1Yu3YtAN7e3kRFRbFmzRqys7MB6Ny5M9u3b+fAgQMAtG7dmuzsbBISCv+o63uq2e8JohGR8yv+u7cq/r8nUhOMtbZ63siYhsAeoKu1dkWp7ROAgdba8PP0v4fCIN3PWvvPc7RzBjYC/7HWPnquY0ZFRdmq+gEc/maVHLZGzBhT0xWIXBoup5/7ce9OrOkSKsXMTo/XdAmVZlKfq2q6hMpzV9VlD2PMemttVJW9gUgZqvOixENAPhBw2vYA4Jzzn40x91IYph84V5gGsNbmAzFA8wsvVURERESkfKotUFtrc4D1wM2n7bqZwtU+ymSMuY/CMP0na+28872PMcYAbYF9F16tiIiIiEj5VPcqH68DnxljfgFWAX8BGgLvARhjZgFYax8oet2fwjD9V2CFMSaw6Dg51trDRW2eB/4LJAC+wKMUBuqR1XROIiIiInIFq9ZAba2da4ypAzxL4XrRm4HbrLW7ipqcvh71Xyis8c2iR7Hl/O+qv6uAD4BA4BiwAehirf2l0k9AREREROQ01T1CjbV2OjD9LPu6nev1Wfo8Dlw+V52IiIiIyCWl2m89LiIiIiJyOVGgFhERERFxgAK1iIiIiIgDFKhFRERERBygQC0iIiIi4gAFaqkSQ4YMwRiDMYYWLVqcsf+xxx7DyckJYwx33HHHKfu+/fZbXF1dS/p/9dVXAIwYMQInJyecnJxwcXFh1qxZ1XIuIiIiIueiQC2V7sSJE8yaNYt//OMfpKWlkZiYyNSpU09p07lzZ/7+97/j7e19Rv++ffvywAMPYK0lMTGRjh07AjBjxgymTZtGQUEBkZGRPPLII9VyPiIiIiLnokAtlW7ixIm4uroyYMAA/P39adq0KW+99dYpbfr27cuTTz5J4Z3i/6c4eH/44YcANG3alMaN/3e/n5SUFACOHz+Or69vVZ6GiIiISLkoUEul27p1K56eniWvg4ODOXz4cLn6/uc//8HZ2RkPDw+cnJwIDAzkxIkTQOE0kVdeeQVjDImJiSxevLhK6hcRERGpCAVquajk5OSQk5PDRx99xPHjxzl27Bg33XQTAO+99x7/93//h7WWq6++mk6dOtVwtSIiIiIK1FIFIiIiSkaVAXbv3o2/v3+5+rZu3RpnZ2cGDBiAt7c30dHR/Pbbb6xatYrs7GxefvllAF555RWOHz9eJfWLiIiIVIQCtVS65557jtzcXObOncvhw4fZsWMHjz76aLn6TpgwgYKCAlatWgVATEwMISEhREZGAv+bWz1lyhQ8PDyq5gREREREKkCBWiqdt7c3AwYMoH///tSpU4cmTZowevRoGjduTN++fQF4/vnnMcaQnp7OggULcHIq/KPo6enJgw8+yA033FCy7aeffsLb25vevXszfPhwnJycWLt2bUm4FhEREalJxlpb0zXUmKioKBsTE1Mlxx7+ZpUctkbMGFPTFYhcGi6nn/tx706s6RIqxcxOj9d0CZVmUp+rarqEynNX1WUPY8x6a21Ulb2BSBk0Qi0iIiIi4gAFahERERERB7jUdAFy8dsRPrGmS6g0TeMn1nQJIiIicpnRCLWIiIiIiAMUqEVEREREHKBALSIiIiLiAAVqEREREREHKFCLiIiIiDhAgVpERERExAEK1CIiIiIiDlCgFhERERFxgAK1iIiIiIgDFKhFRERERBygQC0iIiIi4gAFahERERERByhQi4iIiIg4QIFaRERERMQBCtQiIiIiIg5QoBYRERERcYACtYiIiIiIAxSoRUREREQcoEAtIiIiIuIABWoREREREQcoUIuIiIiIOECBWkRERETEAQrUIiIiIiIOUKAWEREREXGAArXIObz00ku4ubnh6urKrbfeesb+48eP07hxY1xdXfH29mblypWn7F+zZg3GGG6//fZTtufk5ODl5UVAQECV1i8iIiJVT4Fa5CxycnJ44YUXWLRoEUeOHGH58uV8//33p7QZMWIE3t7e5ObmMnToUAYM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", + "text/plain": [ + "
" + ] + }, + "execution_count": 33, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "counts1 = job1q_0.result().get_counts()\n", + "\n", + "legend_1q = ['h -> x', 'h -> reset -> x', 'h -> 3*reset -> x', 'h -> 5*reset -> x' ]\n", + "plot_histogram(counts1, legend=legend_1q, figsize=(9, 6))" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Multi-qubit reset experiment" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The next experiment tests multi-qubit circuits. A complex circuit is considered with the possibility of multiple `reset` instructions in the middle. The expected result is given by the Aer qasm simulator (it can also be verified analytically). \n", + "\n", + "Without any `reset` instructions, we expect a unifrom distribution across 4 of the computational basis states ($|000\\rangle$, $|001\\rangle$, $|010\\rangle$, $|011\\rangle$). With `reset` added, we expect nearly all counts in the $|010\\rangle$ state.\n", + "\n", + "Once again, we run the circuit with 0, 1, and 3 `reset` instructions. We see an improvement for 1 reset and further improvement for 3 resets." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "
\n", + "**Note:** \n", + "\n", + "The `reset` operation can be time intensive, so when working with multiple qubits it is important to be careful how `reset` instructions are done.\n", + "\n", + "The backend will attempt to merge resets following standard commutation rules. However, if you attempt many resets on each individual qubit and they cannot be merged, it may lead to some states being favored as much of the qubit's T1 time is being used up. If you see results tending towards a single state as the number of resets increases, consider reducing the number of resets or performing the resets adjacent to one another. \n", + "
" + ] + }, + { + "cell_type": "code", + "execution_count": 34, + "metadata": {}, + "outputs": [], + "source": [ + "def multiq_custom_circ(n_resets):\n", + " \"\"\"Multi-qubit circuit on qubits 0, 1, 2 with ``n_resets`` reset instructions used.\"\"\"\n", + " qc = QuantumCircuit(3, 3)\n", + " qc.h(0)\n", + " qc.h(1)\n", + " qc.h(2)\n", + " qc.reset([0]*n_resets)\n", + " qc.cx(0, 2)\n", + " qc.reset([1]*n_resets)\n", + " qc.x(1)\n", + " qc.measure(range(2), range(2))\n", + " return qc" + ] + }, + { + "cell_type": "code", + "execution_count": 35, + "metadata": {}, + "outputs": [], + "source": [ + "multiq_circs = [multiq_custom_circ(0), multiq_custom_circ(1), multiq_custom_circ(3)]" + ] + }, + { + "cell_type": "code", + "execution_count": 36, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "No reset sim counts, custom circ: {'000': 241, '001': 258, '010': 279, '011': 246}\n", + "1 Reset sim counts, custom circ: {'010': 1024}\n" + ] + } + ], + "source": [ + "# verify expected output\n", + "from qiskit import Aer\n", + "job_multiq_sim = execute(multiq_circs, \n", + " backend=Aer.get_backend('qasm_simulator'))\n", + "counts_multiq_sim = job_multiq_sim.result().get_counts()\n", + "print(\"No reset sim counts, custom circ: \", counts_multiq_sim[0])\n", + "print(\"1 Reset sim counts, custom circ: \", counts_multiq_sim[1])" + ] + }, + { + "cell_type": "code", + "execution_count": 37, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Job Status: job has successfully run\n" + ] + } + ], + "source": [ + "job_multiq = execute(multiq_circs, backend)\n", + "job_monitor(job_multiq)" + ] + }, + { + "cell_type": "code", + "execution_count": 39, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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UL0D+MI590jJPo+Y2QUl5b+u2RaIiIiIyIk61e/x7A38X0nSedgnQGsgsUydeUfs9wnw81qPTkRERESq7FRPPFvhHWYva0eZbceq0woREREROWXUu3U8zewG4AaA1q1bM3/+fADat29PdHQ0y5cvByA2NpauXbuSlpYGQEhICH369GHp0qXk5uYCkJKSwo4dO9i6dSsAp59+OuHh4axcuRKAFi1a0KlTJxYuXAhAeHg4vXv3Jj09nby8PAB69epFZmYm27ZtAyApKYng4GBWr14NQKtWrWjXrh2LFi0CIDIykl69erF48WLy870Xgnv37k1GRgbbt28HoEuXLng8HtauXQtAfHw8CQkJLF68GICoqChSUlJYtGgRBQUFAPTp04d169axc+dOAM4880wKCgpYv349AG3atKFly5YcXn6qUaNG9OjRg4ULF1JUVARA3759WbVqFbt27QIgOTmZffv2sWmTd8mxxMREmjZtytKlSwGIiYkhOTmZBQsW4JzDzOjXrx/Lly8nJycHgB49erB79242b96sflI/qZ/UT+on9dNx+0lObX5bx9PM8oBbnXPTjlHndSDWOXd5mbJzgG+A9s65DDP7AZjsnHuiTJ17So592rFi0DqeIiIigUXrePpfXV7HcxFwvplFlCkbAPwIbC5TZ8AR+w0Avqr16ERERESkynw61G5mUUDHko9BQFsz6wbsds79YGaTgJ855y4qqfMW8CAwzcwmAp2APwEPuf9dqn0OSDOzPwHvAb8ELgD6+KBJIiIiUsdsTJrQszaP32HthG+rWvfRRx9t/tZbbzVbt25d5BVXXLH73Xff3VyLoVXJXXfd1Xrjxo3hc+fOzajpY/v6imcK8F3JKxJ4qOT9wyXb44AOhys75/bivXrZGkgHpgBPAU+XqfMVMAy4FlgBjASuds4trt2miIiIiJyc+Pj4Q2PGjMm68sorq30rwKFDVX5E+inDp4mnc26+c84qeF1bsv1a51ziEft875zr65yLcM7FOefKXu08XGeOc+4M51yYc66zc+4fvmuViIiIyIm55ppr9owYMWJPbGxs0fHqPv/887E9evQ4Y/To0W2aNGnS7e67726dn59vN9xwQ0JcXNxZsbGxycOHD2+bl5dnAFlZWSEXXHBBx+jo6G6NGzfu1rNnzySPxwPA5s2bQ1NTUzvExMQkx8fHnzVx4sQWAHPmzGk0efLkVh988EFMgwYNuiclJXWpyfbWu1ntIiIiInXVihUrGg4ZMmR3dnb2soKCArv11lsTMjIywpctW7Y6LCzMDRkypP2YMWNaT5kyZdvEiRNbxsXFFf7000/LAb744ouGZobH4+Hyyy/veOmll+6ZO3fupk2bNoVecsklSZ07dz44dOjQ3K+++mp7oAy1i4iIiMgJat68eeHYsWN3hoaG0qBBA/fWW281mzx58taWLVt6YmJiiu+///6s9957rylAaGio27FjR+j69evDwsPD3cCBA/OCgoJYsGBBw927d4c8+eSTWREREa5Lly6FI0aMyJ45c2bT2o5fVzxFRERE6oi4uLjSGzuzsrJCDh48GHTuued2LlvH4/EYwIMPPrj93nvvbT1w4MBOACNHjsx+9NFHt2/atCksOzs7LDo6utvhfYqLiy0lJWVfbcevxFNERCr18ccf84c//AGPx8N1113Hn/70p3Lbf/jhB6655hr27NmDx+Phscce47LLLqOwsJDf//73pKenExQUxHPPPUf//v0BGDhwIFlZWRQVFXH++eczZcoUgoOD/dA6kbrHzErnubRq1aooIiKieMWKFavatWt31EyjmJiY4qlTp2YCmUuWLIlITU1N6tWr1/7ExMTC+Pj4gi1btqw83jlqmobaRUSkQh6Ph1tuuYWPPvqI1atXM3PmzNKn1hw2ceJErrrqKr777jtmzZrFzTffDMDUqVMB+P777/n000+5++67KS4uBmD27NksX76clStXkp2dzTvvvOPbhomcQg4dOsSBAwfM4/GYx+OxAwcOWFVnqwcHBzNs2LCfbrnlljbbtm0LAcjIyAh99913GwHMnDmz8cqVK8OLi4uJiYnxBAcHu6CgIPr377+/YcOGnrFjx7bKy8uzoqIilixZErFgwYIGAC1btizKzMwMOzwRqSYp8RQRkQp98803dOzYkfbt2xMWFsawYcOYO3duuTpmVvqYxr1799K6dWsAVq9ezYUXXgh4H8/YpEmTco+eBCgqKqKwsBAz81WTRE45Y8aMad2wYcMeL774Yqu5c+c2bdiwYY8xY8a0rur+U6ZMyWzfvn1Br169OkdFRXW/6KKLOq1ZsyYCYN26deGpqamdGjZs2P28887rfO2112ZfccUV+0JCQvjwww83rFixIjIxMfHspk2bdrvuuusSc3JyggFGjhy5GyAmJqZbly5dOh/r/NXlt0dmngr0yEwRkcrNmTOHjz/+mFdeeQWAN954g8WLF/PCCy+U1snKyuKSSy4hJyeH/fv385///IeePXvy8ssv8+mnnzJz5ky2bt1K9+7defXVVxkyZAgAqampfPPNN1x66aW88cYbGmqXGqNHZvpfXX5kpoiInMJmzpzJtddeS2ZmJh9++CEjRoyguLiYUaNGkZCQQEpKCnfccQc///nPyyWXn3zyCVlZWRQUFPD555/7sQUi4kuaXCQiIhWKj49n69atpZ8zMzOJj48vV+fVV1/l448/BqB3794cPHiQn376iRYtWvDMM8+U1vv5z39Op06dyu0bERHB4MGDmTt3LgMGDKjFlojIqUJXPEVEpELnnHMO69evJyMjg8LCQmbNmsWgQYPK1Wnbti2fffYZAGvWrOHgwYM0b96cAwcOsH//fgA+/fRTQkJC6NKlC3l5eWRlZQHeezw/+OADzjjjDN82TET8Rlc8RUSkQiEhIbzwwgukpqbi8XgYNWoUXbt2Zfz48aSkpDBo0CCeeuoprr/+ep555hnMjGnTpmFm7Ny5k9TUVIKCgoiPj+eNN94AYP/+/QwaNIiCggKKi4u54IILuPHGG/3cUhHxFU0u0uQiERGRgKHJRf6nyUUiIiIi4ndKPEVERETEJ5R4ioiIiIhPKPEUEREREZ/QrHYRERGpV+67Zm/P2jz+pOmNv61q3cGDB7f76quvovPz84ObNWt26Pbbb99+1113+XUi1F133dV648aN4XPnzs2o6WMr8RQRERHxkwceeCCra9eumyMjI913330XMWDAgKRzzjnnwPnnn3/gePseOnSI0NBQX4RZYzTULiIiIuInKSkpByMjIx1AUFCQMzO3du3a8IrqPv/887E9evQ4Y/To0W2aNGnS7e67726dn59vN9xwQ0JcXNxZsbGxycOHD2+bl5dnAFlZWSEXXHBBx+jo6G6NGzfu1rNnzySPxwPA5s2bQ1NTUzvExMQkx8fHnzVx4sQWAHPmzGk0efLkVh988EFMgwYNuiclJXU5fO6EhISzGjZs2D0+Pv6sv/71r01PpL264ikiIiLiR7/97W/bvvvuu7EHDx4M6ty584Err7xyb2V1V6xY0XDIkCG7s7OzlxUUFNitt96akJGREb5s2bLVYWFhbsiQIe3HjBnTesqUKdsmTpzYMi4urvCnn35aDvDFF180NDM8Hg+XX355x0svvXTP3LlzN23atCn0kksuSercufPBoUOH5n711Vfbyw615+bmBt1///1tv/zyy9XJyckFW7ZsCc3Ozg4+kbbqiqeIiIiIH7355ps/7Nu377uPP/547f/7f/9vT0RERKVP92nevHnh2LFjd4aGhtKgQQP31ltvNZs8efLWli1bemJiYorvv//+rPfee68pQGhoqNuxY0fo+vXrw8LDw93AgQPzgoKCWLBgQcPdu3eHPPnkk1kRERGuS5cuhSNGjMieOXNmpVcxzcx99913kXl5eXbaaacdSklJOXgibVXiKSIiIuJnISEhpKam5mVmZoY+8cQTzSurFxcXd+jw+6ysrJCDBw8GnXvuuZ2jo6O7RUdHd/vlL395ek5OTgjAgw8+uL19+/YFAwcO7JSQkHDW/fff3wpg06ZNYdnZ2WGH94mOju72/PPPx2VnZ1c4Et6oUaPiadOmbXr55Zebx8XFJffv37/jd999F3FC7TyRnURERESk5nk8Htu4cWOF93iC98rj4fetWrUqioiIKF6xYsWqdu3aHTqybkxMTPHUqVMzgcwlS5ZEpKamJvXq1Wt/YmJiYXx8fMGWLVtWHu8chw0ZMiR3yJAhuXl5eXbnnXfGX3fddad9++23a6vbPl3xFBEREfGDbdu2hbz88ssxe/fuDSoqKuLdd99t9P777ze9+OKLc6uyf3BwMMOGDfvplltuabNt27YQgIyMjNB33323EcDMmTMbr1y5Mry4uJiYmBhPcHCwCwoKon///vsbNmzoGTt2bKu8vDwrKipiyZIlEQsWLGgA0LJly6LMzMywwxORtm7dGvLmm282yc3NDYqMjHRRUVHFQUEnlkIq8RQRERHxAzNj6tSpLRISEs5u0qRJ9/vuuy9h4sSJW3/zm99UOrnoSFOmTMls3759Qa9evTpHRUV1v+iiizqtWbMmAmDdunXhqampnRo2bNj9vPPO63zttddmX3HFFftCQkL48MMPN6xYsSIyMTHx7KZNm3a77rrrEnNycoIBRo4cuRsgJiamW5cuXToXFxfbc8891zI+Pv7sJk2adPvyyy+j//a3v205oTY7V+n9qwEvJSXFpaen+zsMERERqSFm9q1zLqVs2fLlyzcnJyf7dVH2+mT58uXNkpOTEyvapns8RUTkKPddU+ULLjVq0vTGfjmviPiGhtpFRERExCeUeIqIiIiITyjxFBERERGfUOIpIiIigc7V58nUvlTy91xc2XYlniIiIhLQzGxvYWFhqL/jqA8KCwtDzazS2YlKPEVERCSgeTye13788ceGxcXF5u9YAllxcbH9+OOPUR6PZ1pldbSckoiIiAS04uLiv+bm5vb4/vvv+wDB/o4ngHmAhcXFxX+trIISTxEREQloPXv2LASu8XccoqF2EREREfERJZ4iIiIi4hNKPEVERETEJ5R4ioiIiIhPKPEUEREREZ9Q4ikiIiIiPqHEU0RERER8QomniIiIiPiEEk8RERER8QklniIiIiLiE0o8RURERMQnlHiKiIiIiE8o8RQRERERn1DiKSIiIiI+ocRTRERERHxCiaeIiIiI+IQSTxERERHxCSWeIiIiIuITSjxFRERExCeUeIqIiIiITyjxFBERERGfUOIpIiIiIj6hxFNEREREfEKJp4iIiIj4hBJPEREREfEJJZ4iInXAxIkTCQsLIzQ0lIEDBx61vUePHkRGRhIZGUlYWBhmVrqtWbNmmBktW7Yst0/Hjh0JDQ0t3e/tt9+u9XaISP2mxFNE5BRXWFjIQw89xLx588jJyWHBggW8//775eosXbqU/Px88vPzGTRoEKeffnrptjFjxjBu3LgKj3377beX7nf11VfXajtERJR4ioic4qZNm0bjxo3p378/UVFR9O3blylTplRa/5NPPmHUqFGln++55x5iY2N9EaqIyDEp8RQROcWtXbu2XOLYrl07srKyKqz75ZdfcuDAAe66664qHXvy5MlERkbSo0cPcnNzayReEZHKKPEUEQkgEydOpGvXroSFhR237pw5czh48CA7duxg7969/OIXv6j9AEWkXvN54mlmN5tZhpkdNLNvzez8Y9SdZmaugtf+MnX6V1LnDN+0SESkdiUlJbFr167SzxkZGcTFxVVYd8GCBdxyyy1VOm63bt0ICgqiUaNG3HbbbaxatapG4hURqYxPE08zuxp4DngU6A58BXxkZm0r2eUPQNwRr03A7Arqdj2i3voaDV5ExE9GjhzJ3r17SUtLIy8vj7S0NG6++eaj6n344YcUFhZy/fXXV+m4y5YtA6C4uJjp06fTrl27mgxbROQovr7ieRcwzTk31Tm3xjl3G5AF3FRRZefcXufc9sMv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IiLHVNUrnm2A/zv8wTn3DVAEtK6NoEREREQk8FQ18QwGCo8oK6L6k5NEREREpJ6qauJowJtmVlCmLAKYamYHDhc45wbVZHAiIiIiEjiqmnhOr6DszZoMREREREQCW5UST+fc72o7EBEREREJbNV9ZKaIiIiIyAlR4ikiIiIiPqHEU0RERER8QomniIiIiPiEEk8RERER8QklniIiIiLiE0o8RURERMQnlHiKiIiIiE8o8RQRERERn1DiKSIiIiI+ocRTRERERHxCiaeIiIiI+IQSTxERERHxCSWeIiIiIuITSjxFRERExCeUeIqIiIiITyjxFBERERGfUOLpA9dccw1mhpnRqVOno7afeeaZmBlBQUGEhoby7rvvlm6Li4sjKCgIM6NZs2Z4PB7WrVtHUFBQ6cvMaN68uS+bJCIiIlJtSjxrWX5+Pq+//jozZsxg165dbNiwgRdeeKFcnb59+7JlyxaKi4tJTk5mxIgRANx7773s3LmT/fv3c+DAAXJycvjDH/5Ap06dKC4uLn2ZGcOHD/dH80RERESqTIlnLZswYQKhoaEMHz6cpk2b0qFDB5577rlydV588UXatm0LwJAhQygoKADAzHDOsXv3brKzswHo2rVruX1fffVVnHM8/fTTPmiNiIiIyIlT4lnLVq9eTWRkZOnnNm3asHv37krrP/nkkyQmJgLwl7/8hRYtWpCQkMBpp51GXFwcN910U7n6EydOpGXLlgQHB9dK/CIiIiI1RYnnKeSiiy5iz549fP311wC8/vrr5OTksGHDBjZs2EBWVhZ33HFHuX02b97MLbfc4odoRURERKpHiWct69KlC/n5+aWft27dStOmTY+qd/311/P555/zxRdflE4UmjRpEvHx8XTo0IEOHTrQtm1bPv7449J9Hn/8cQAeeOCBWm6FiMDJTRT85z//SWhoaOn+77zzDgA33nhj6UTB6Oho8vLyfNYeERFfU+JZyx544AEOHTrE22+/ze7du9m4cSO33357uTqTJk3ilVde4bXXXqNv376l5YmJiWzdupW8vDz27t1LZmYmycnJpdufffbZ0ntDRaR2ncxEQYArr7ySkSNH4pxjw4YN9OrVi8LCQl566SWmTp1KcXExMTExpKam+rppIiI+o8SzlkVFRTF8+HCGDRtGbGws7du357bbbqNt27ZceeWVAIwfPx6AUaNG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v//9b5544gk+//xzAB599FGmTp2Kx+Ph4osv5qKLLvJzpCIiIlJXKPEMUElJSezatav0c0ZGBnFxcVXePyUlBYD+/fuTmJjIBx98wJo1a8jOzmb06NEAjBs3js2bN9do3CIiIhK4lHgGqJEjR7J3717S0tLIy8sjLS2Nm2++uUr7ZmRkkJubC3iH7H/44Qf69etHu3bt8Hg8fPLJJwC89NJLNGvWrNbaICIiIoFFiWeAioiIYNy4cVx88cXExMTQp08fBg8eTN++fRk7diwA06dPJzg4mI0bN/LMM88QEREBwLx582jRogWRkZEkJyczfPhwBg0aREREBPfccw+DBw8mMjKS9957jxkzZvizmSIiIlKHmHPO3zH4TUpKiktPT6+VY1//bK0ctkqm3uG/c9c3/upn9bFv+auf//TXCf45MfDKuXf65byTpjf2y3n1MztwmNm3zrkUf8chFdMVTxERERHxCSWeIiIiIuITSjxFRERExCdC/B2A1LyNSRP8ct4Oa/1zXhEREakbdMVTRERERHxCiaeIiIiI+IQSTxERERHxCSWeIiIiIuITSjxFRERExCeUeIqIiJwCJk6cSFhYGKGhoQwcOPCo7ZMnT6ZBgwaYGXfffXe5bddffz1hYWGEhYVx/fXXl5afd955hISEYGa1Hr9IVSjxFBER8bPCwkIeeugh5s2bR05ODgsWLOD9998vV6d79+68/vrrtG/fvlz5xo0bmTZtGmvWrGHt2rVMmzaNjIwMAH73u99RW4+GFjkRSjxFRET8bNq0aTRu3Jj+/fsTFRVF3759mTJlSrk6ffr0YejQoUddvXz22Wfp2LEjHTp0oF27dnTs2JGnn34agOuuu45u3br5qhkix6XEU0RExM/Wrl1LbGxs6ed27dqRlZVVpX0zMjKIj48v/dy6devSK54ipxolniIiIiLiE0o8RURE/CwpKYldu3aVfs7IyCAuLq5K+7Zr145t27aVfv7xxx9p165djccoUhOUeIqIiPjZyJEj2bt3L2lpaeTl5ZGWlsbNN99cpX3vuOMONmzYQEZGBhkZGWzYsIE77rijdgMWOUFKPEVERPwsIiKCcePGcfHFFxMTE0OfPn0YPHgwffv2ZezYsQBMnz6d4OBgNm7cyDPPPENERAQAHTp04Le//S2dOnWiU6dOjBgxgg4dOgDws5/9jODgYACCg4Pp37+/X9oncliIvwMQERERePDBB3nwwQfLlaWlpZW+v+aaa7jmmmsq3Pe1117jtddeO6r8m2++qdkgRU6SrnhKrfj4449JSkqiY8eOPPbYY0dtLygo4Oqrr6Zjx4706tWLzZs3AzBjxgy6detW+goKCmLZsmUADBw4kOTkZLp27cqNN96Ix+PxYYtERETkZCnxlBrn8Xi45ZZb+Oijj1i9ejUzZ85k9erV5eq8+uqrxMTEsGHDBu68807GjBkDwG9+8xuWLVvGsmXLeOONN2jXrl3pGnSzZ89m+fLlrFy5kuzsbN555x1fN01EREROgobapcZ98803dOzYsfTpGsOGDWPu3Ll06dKltM7cuXOZMGECAEOHDuXWW2/FOVduYeSZM2cybNiw0s+NGjUCoKioiMLCQj0CTkQCwsakCX45b4e1/jmv1G+64ik1btu2bbRp06b0c0JCQrmlPo6sExISQuPGjcstJQLw9ttv8+tf/7pcWWpqKi1atCA6OpqhQ4fWUgtERESkNijxlFPS4sWLadCgAWeeeWa58k8++YSsrCwKCgr4/PPP/RSdiIiInAglnlLj4uPj2bp1a+nnzMzMco9zO7JOUVERe/fuLfe4uFmzZh11tfOwiIgIBg8ezNy5c2shehEREaktSjylxp1zzjmsX7+ejIwMCgsLmTVrFoMGDSpXZ9CgQUyfPh2AOXPmcOGFF5bes1lcXMzs2bPL3d+Zl5dX+tzioqIiPvjgA8444wwftUhERERqgiYXSY0LCQnhhRdeIDU1FY/Hw6hRo+jatSvjx48nJSWFQYMGMXr0aEaMGEHHjh1p2rQps2bNKt0/LS2NNm3alE5OAti/fz+DBg2ioKCA4uJiLrjgAm688UZ/NE9EREROkBJPqRWXXXYZl112Wbmyhx9+uPR9REREpcsh9e/fn6+//rpcWcuWLVmyZEnNByoiIiI+o6F2EREREfEJJZ4iIiIi4hMaapcac981e/1y3knTG/vlvCIiIlI9uuIpIiIiIj6hxFNEREREfEKJp4iIiIj4hBJPkTpu4sSJhIWFERoaysCBA4/anpubS9u2bQkNDSUqKoqFCxcC8Nhjj9GgQQMiIiJo0KABTz31VOk+eXl5dO7cmbCwMMLDw7nnnnt81h4REQlcSjxF6rDCwkIeeugh5s2bR05ODgsWLOD9998vV+eGG24gKiqKQ4cOMWrUKIYPHw7AaaedxsKFCzl48CAzZszg3nvvLd3n8ssvJzY2lsLCQvbv3891113n03aJiG99/PHHJCUl0bFjRx577LGjthcUFHD11VfTsWNHevXqxebNmwH49NNP6dmzJ2eddRY9e/bk888/L91n7NixtGnThqioKF81Q+oAJZ4iddi0adNo3Lgx/fv3Jyoqir59+zJlypRydf7zn/9wxx13APD444+TmZlJcXExv/71r+nRowcAgwcPxjlHbm4uAF9++SX/+Mc/AO+TqJKSknzXKBHxKY/Hwy233MJHH33E6tWrmTlzJqtXry5X59VXXyUmJoYNGzZw5513MmbMGACaNWvGv/71L77//numT5/OiBEjSve54oor+Oabb3zaFjn1KfEUqcPWrl1LbGxs6ed27dqVPtP+sLy8PLp37w54nxgVHBzM+vXry9W55557aNKkCY0aNWLLli0AXHrppTRo0ICEhARWrlxZyy0REX/55ptv6NixI+3btycsLIxhw4Yxd+7ccnXmzp3LNddcA8DQoUP57LPPcM7RvXt3WrduDUDXrl3Jz8+noKAAgHPPPZe4uDjfNkZOeUo8Req5uXPn8vzzzzNnzhwADh48iMfjoX///hw4cICePXsyaNCgo/Y70aG5Xbt2ccEFFxAVFcWtt95abp+BAweSnJxM165dufHGG/F4PDXfYBEpZ9u2bbRp06b0c0JCAtu2bau0TkhICI0bN2bXrl3l6rz77rv06NGD8PDw2g9a6iwlniJ1WFJSUrkf/hkZGUddYYiKiuK7774D/pdUnn766QAsWbKEK6+8kueff54LL7wQoHTbX/7yFwDuv/9+fvzxx3LHPJmhuYiICP785z/z5JNPHtWe2bNns3z5clauXEl2djbvvPPOCf/diIjvrFq1ijFjxvDSSy/5OxQ5xSnxFKnDRo4cyd69e0lLSyMvL4+0tDRuvvnmcnUuvPBCnn32WQDuvfde4uPjCQoKYsuWLfTt25c77riDm266qbR+UFAQbdq04bnnngNg6tSpNGvWrNwxT2ZormHDhvTp04eIiIij2tOoUSMAioqKKCwsxMxO7i9IRI4rPj6erVu3ln7OzMwkPj6+0jpFRUXs3bu39DafzMxMfvnLX/L666/ToUMH3wUudZIST5E6LCIignHjxnHxxRcTExNDnz59GDx4MH37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", + "text/plain": [ + "
" + ] + }, + "execution_count": 39, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "counts_multiq = job_multiq.result().get_counts()\n", + "legend_multiq = ['no reset', '1 reset', '3 resets']\n", + "plot_histogram(counts_multiq, legend=legend_multiq, figsize=(9, 6))" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Repetition delay and removing qubit initialization at the start of programs" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This section covers two new features: Setting the repetition delay, and removing qubit initialization at the start of circuits. \n", + "\n", + "The repetition delay defines the delay time between circuit executions. For instance, if you run a job with 5 circuits, the repetition delay (`rep_delay` for short) defines how long the backend is idle for between the conclusion of one circuit and start of the next. This parameter provides finer grained control over the execution of your quantum circuits on IBM Quantum systems.\n", + "\n", + "Shortening `rep_delay` can reduce execution time, and therefore reduce the sensitivity of your experiment to long term drifts in hardware parameter variations. However, setting too short a time may yield poorly initialized qubits.\n", + "\n", + "With the smaller `rep_delay`, users may prefer to initialize circuits themselves via the `reset` instruction introduced above. For this reason, we have added a flag `init_qubits` which determines whether the default backend initialization sequence will be inserted. This allows users to work with \"dirty qubits\" and perform experiments with non-initialized states.\n", + "\n", + "
\n", + "\n", + " \n", + "**Note:** If `init_qubits` is set to false and you want qubits to start in the ground state, you must insert resets at the start of your circuit. Otherwise, qubits will begin with their state from the previous shot (after undergoing some thermalization process for the interval between shots as set by `rep_delay`). Note that the first shot of the first circuit may still be in the thermal ground state due to a longer delay existing during the loading of your job to hardware.\n", + "
" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In order to use `rep_delay`, we must check if the backend supports it. This is controlled by a flag in the backend configuration `dynamic_reprate_enabled`." + ] + }, + { + "cell_type": "code", + "execution_count": 41, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 41, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "config.dynamic_reprate_enabled" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Since dynamic rep rates are enabled on this device, we can proceed with specifying the delay time.\n", + "\n", + "The backend specifies an allowed range of delay times, given by `rep_delay_range`. Having a continuous range provides users with fine-grained control of the delays. A default is also returned by the backend as `default_rep_delay`." + ] + }, + { + "cell_type": "code", + "execution_count": 42, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Range of delay times: [0.0, 0.0005]s\n", + "Default delay time: 0.00045999999999999996s\n" + ] + } + ], + "source": [ + "print(f\"Range of delay times: {config.rep_delay_range}s\")\n", + "print(f\"Default delay time: {config.default_rep_delay}s\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We conduct a simple experiment to demonstrate the effect of `rep_delay` as follows:\n", + "\n", + "1. Turn off qubit initialization using `init_qubits=False`.\n", + "2. Set `rep_delay` to something small (we use `rep_delay=0.005e-6 s`). \n", + "3. Define a `dirty_q_circ()` method which puts the qubits in an unpredictable state.\n", + "4. Run the dirty circuit and then run some known circuit with a defined result.\n", + "\n", + "The dirty circuit puts the qubits in an unknown state and then, since `rep_delay` is small and qubits are not initialized, we get an unpredictable (and often bad) result for our known circuit.\n", + "\n", + "We \"fix\" this by modifying the known circuit to add some number of resets to the front of the circuit, thus initializing our qubits manually.\n", + "\n", + "The circuits we run are `(some number of resets), measure` and `x, (some number of resets), measure`.\n", + "\n", + "When no resets are inserted, we see a poor result in each case. However, with resets inserted we observe results closer to what we expect (all `0`'s for the `measure` and all `1`'s for the `x, measure`)." + ] + }, + { + "cell_type": "code", + "execution_count": 49, + "metadata": {}, + "outputs": [], + "source": [ + "def dirty_q_circ():\n", + " \"\"\"Circuit to give bad qubit initialization.\"\"\"\n", + " # does random x rotation\n", + " qc = QuantumCircuit(1, 1)\n", + " theta = np.random.uniform(0, 2*np.pi)\n", + " qc.rx(theta, 0)\n", + " qc.measure(0, 0)\n", + " return qc\n", + "\n", + "def reset_x_circ(n_resets):\n", + " \"\"\"Reset, x circuit.\"\"\"\n", + " qc = QuantumCircuit(1, 1)\n", + " for _ in range(n_resets):\n", + " qc.reset(0)\n", + " qc.x(0)\n", + " qc.measure(0, 0)\n", + " return qc\n", + "\n", + "def reset_meas_circ(n_resets):\n", + " \"\"\"Reset, measure circuit.\"\"\"\n", + " qc = QuantumCircuit(1, 1)\n", + " for _ in range(n_resets):\n", + " qc.reset(0)\n", + " qc.measure(0, 0)\n", + " return qc" + ] + }, + { + "cell_type": "code", + "execution_count": 44, + "metadata": {}, + "outputs": [], + "source": [ + "circs_no_init = [dirty_q_circ(), reset_meas_circ(0), # 1\n", + " dirty_q_circ(), reset_x_circ(0), # 3\n", + " dirty_q_circ(), reset_meas_circ(1), # 5\n", + " dirty_q_circ(), reset_x_circ(1), # 7\n", + " dirty_q_circ(), reset_meas_circ(3), # 9\n", + " dirty_q_circ(), reset_x_circ(3)] # 11" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "`rep_delay` can be specified in `execute()` or `assemble()`. We choose `assemble()` so that we can print and verify our `rep_delay` in the `qobj.config`. Also note that `init_qubits=False`." + ] + }, + { + "cell_type": "code", + "execution_count": 50, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Job Status: job has successfully run\n" + ] + } + ], + "source": [ + "job_no_init = execute(circs_no_init, backend, init_qubits=False, optimization_level=0, rep_delay=0.005e-6)\n", + "job_monitor(job_no_init)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Like `rep_delay`, `init_qubits` can be set in `execute()` or `assemble()`." + ] + }, + { + "cell_type": "code", + "execution_count": 51, + "metadata": {}, + "outputs": [], + "source": [ + "counts_no_init = job_no_init.result().get_counts()\n", + "legend_no_init = ['0 resets', '1 reset', '3 resets']" + ] + }, + { + "cell_type": "code", + "execution_count": 53, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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IEr7IiIi0tT1a9++fb4Cp3eCgoJc+/btd+HrTa6+TQPWIyIiIhIIQQqc3vP/HdeYLRU6RURERMRzCp0iIiIi4rlmPZBIREREmp/Ln2CQl8d/7jq+rm3brVu3Bl9wwQVJCxYsaB0dHV161113bb7iiivyvKzvcMaOHZuUmJhY/OSTT/5Un8dV6BQREREJkMsuu6xLixYtXE5OTsZXX30VcdZZZ/VITU3dm5qauu9w+5aUlBAaGtoQZdYL3V4XERERCYD8/Pygjz76KPrBBx/c3KZNm/KRI0cW/Pa3v931r3/9K7a69jfccEPCqFGjup155pldIyMjBzz11FPtduzYEXzOOecc1b59+2Pj4uKOveaaaxJKS0sBWLlyZdjgwYOTo6Ki+kdHR6ecdtpp3fYf65tvvgn/zW9+07NNmzb9k5KS+j3//PPRAI888ki7OXPmxDzzzDMdIiIiBpx00kk9AG6//fYOcXFxx7Zq1WpAUlJSvzlz5kTV9XrV0ykiIiISAN99911YSEiIO/bYY4v2rzv22GP3LliwoMZA98knn7R98cUX17/99ttZhYWF9oc//KFb+/btS9etW7dy9+7dQaNGjer5+OOPF//lL3/ZfuuttyacdNJJu7766qtVRUVF9sUXX7QCX9gdPXp0r1tvvXXzlVdeuWbJkiUtTz/99F4DBgwovOmmm7YvWrQosvLt9YyMjLAXXnghbsmSJT8kJSWVrFq1qkVpaanV9XrV0ykiIiISALt37w5u1apVeeV1bdq0KSsoKAiuaZ/+/fvvufDCC38ODg5m586dwenp6W2effbZH1u3bl2emJhYevXVV2996623YgBCQkLcjz/+GLZhw4bQiIgIN3LkyAKAWbNmtUlMTCy69tprd4SGhnL88ccXjh49+ufXXnsturpzBgcHU1xcbN9++214UVGRJScnF/ft27eouraHotApIiIiEgBRUVFle/bsOSCL5efnB0dGRpbVtE9CQkLx/u9r165tUVpaah07dkyJiorqHxUV1f/GG288aseOHaEA06ZNy3bOMWTIkN49evTo+8QTT8QCbNy4scWKFSta7d8nKiqq/7vvvhuTk5NT7QOi/fr1K3rggQc2/fWvf01o3759yumnn95tw4YNdX6YVLfXRURERALgmGOOKSotLbXvvvsu7JhjjikCWLFiRcujjz66sKZ9zP7vrna3bt1KWrRo4fLy8r6tbkBRly5dSmfOnLkR4D//+U/kmDFjep188skFnTt3Lhk8ePDuhQsXrjncOfa74oor8q644oq8vLy8oIsuuuio6667rtO7776bVZfrVU+niIiISAC0bt26fOTIkT/fdtttCfn5+UHz5s1r9cknn7SdOHHijtrsf9RRR5Ucf/zxuyZNmtQ5Ly8vqKysjO+//z5s7ty5kQD/+te/otetWxcKEBsbW2pmBAUFuXPOOefnDRs2hE+fPj2mqKjIioqKLD09PWL58uXhAHFxcSVZWVlh+8+TkZER9t5770UVFhZaRESECw8Pd7/kDU/q6RQREZFmpS7zaHrthRde2Hj++ecnxcfHp7Rt27b04Ycf/rE20yXt98Ybb2y45pprEnv37t1v7969QZ06dSq+/vrrtwAsWbKk1S233NK5oKAgODY2tmTq1Kk/9unTpxjgww8/XH3ttdd2vuOOOzo75+zoo4/e+9hjj20C+POf/7z97LPP7h4VFdU/LS1t9/333//T7bff3um8884LDwkJcQMHDix48cUXN9b1Ws255vsq0tTUVLds2bJAlyEiIiL1xMy+ds6lVl6XkZGxISUlZXugampOMjIy2qWkpCRVt02310VERETEcwqdIiIiIuI5hU4RERER8ZxCp4iIiIh4TqFTRERERDyn0CkiIiIinlPoFBERERHPKXSKiIiIiOcUOkVERETEc3oNpoiIiDQr65LvGeTl8buvuqfWr9l84IEH2r/22mvtVq9e3fKMM87Imz179gYPS6uVG264IWHdunVhc+bMyarP4yp0ioiIiARIYmJiyc0337zlo48+ar1v37463YEuKSkhNDTUq9LqnW6vi4iIiATIRRdd9POFF174c2xsbOnh2j755JOxAwcOPPrSSy/t3LZt2/433nhjQmFhoU2aNKlTx44dj4mNjU0ZP358l4KCAgPYsmVLyIknntgjKiqqf5s2bfoPGjQouaysDIANGzaEjhw5snt0dHRKYmLiMVOnTo0DeOutt1o/9dRTHebOnRsdERExIDk5uU99Xat6OkVEREQaiRUrVrQaO3ZsXm5u7rdFRUV29dVXd8rKygr79ttvM1u0aOHGjh3b7eabb06YPn365qlTp8Z37NixePv27RkAn332WSszo6ysjNNOO63H6NGjf54zZ8769evXh/7ud79L7t27976zzjorf+HChTle3F5XT6eIiIhII9G+ffvi22+/fVtoaCgRERHutddea/fUU09tio+PL4uOji6/7bbbtrz77rsxAKGhoW7r1q2ha9asaREWFuZGjRpVEBQURHp6equ8vLyQRx55ZEt4eLjr06dP8YUXXpj7+uuvx3hZu3o6RURERBqJjh07luz/vmXLlpB9+/YFHXfccb0rtykrKzOAu+++O2fKlCkJo0aN6gUwYcKE3AceeCBn/fr1LXJzc1tERUX1379PeXm5paam7vaydoVOkUbmo48+4tprr6WsrIzLLruMW2655YDtGzduZOLEieTm5hITE8Orr75Kp06dAJgyZQpz586lvLycU045hWnTpmFmjBo1ii1btlBaWsoJJ5zA9OnTCQ4ODsTliYjIIZiZ2/+9Q4cOpeHh4eUrVqz4vmvXriVV20ZHR5c/99xz2UD20qVLw0eOHJmclpa2JykpqTgxMbFo48aNKw93jvqk2+sijUhZWRlXXXUVH374IZmZmbz++utkZmYe0Oamm25iwoQJrFixgrvuuotbb70VgIULF/Lll1+yYsUKVq5cydKlS0lPTwfgjTfeICMjg5UrV5Kbm8ubb77Z4NcmItIclZSUsHfvXisrK7OysjLbu3evlZQclB+rFRwczLnnnrv9qquu6rx58+YQgKysrNDZs2e3Bnj99dfbrFy5Mqy8vJzo6Oiy4OBgFxQUxIgRI/a0atWq7Pbbb+9QUFBgpaWlLF26NDw9PT0CID4+vjQ7O7vF/kFH9UU9nSKNyJIlS+jRowfdunUD4Nxzz2XOnDn06fN/gwszMzN57LHHADjxxBP5/e9/D4CZsW/fPoqLi3HOUVJSQnx8PACtW7cGoLS0lOLiYsysAa9KRKRh1WUeTa/dfPPNCY8//njH/cutWrWKuf7667c89thjP9Vm/+nTp2dPmTIlIS0trffPP/8cEhcXVzxx4sRcIH/16tVhN910U5e8vLyQ1q1bl1188cW5Z5xxxm6ADz74YO3kyZM7JSUlHVtcXGxdu3bdd++9924GmDBhQt6sWbNioqOj+3fq1KkoMzPzh/q4VnPOkx7URiE1NdUtW7Ys0GWI1Npbb73FRx99xPPPPw/AK6+8wuLFi3n66acr2owfP560tDSuvfZa3n77bcaOHcv27duJjY3lpptu4vnnn8c5x9VXX839999fsd/IkSNZsmQJo0eP5pVXXtHtdRFplMzsa+dcauV1GRkZG1JSUrYHqqbmJCMjo11KSkpSddt0e12kiXnkkUdIT09nwIABpKenk5iYSHBwMGvXruWHH34gOzubzZs38+mnn/LFF19U7Pef//yHLVu2UFRUxKeffhrAKxARkaZIoVOkEUlMTGTTpk0Vy9nZ2SQmJh7QJiEhgbfffptvvvmmoiezbdu2vPPOOxx33HFERkYSGRnJ6NGjWbRo0QH7hoeHc+aZZzJnzhzvL0ZERJoVhU6RRmTw4MGsWbOGrKwsiouLmTlzJmPGjDmgzfbt2ykvLwfgwQcfZOLEiQB06dKF9PR0SktLKSkpIT09nd69e1NQUMCWLVsA3zOdc+fO5eijj27YCxMRkSZPoVOkEQkJCeHpp59m5MiR9O7dm3POOYe+ffty11138d577wHw+eefk5ycTK9evdi6dSu33347AGeddRbdu3fnmGOOISUlhZSUFM444wz27NnDmDFjOPbYY+nfvz9xcXFcccUVgbxMERFpgjSQSAOJGo2pU6dy33334Zzjt7/9LR999NEB27/88kvOOOMMCgsLCQsL4+OPP2bw4MGAb+R2eHg4AG3atCEnJweA8vJyTjjhBJYuXYqZcfrppzN79uyGvTAREak3GkgUWBpIJI1ecXEx9957L/PmzWPnzp2kp6dX9OztN27cOMaOHUthYSF33nkn48aNO2B7YWEhhYWFFYET4LLLLiMnJ4e9e/dSVFTEfffd1yDXIyIi0twodEqj8NJLL9GmTRtGjBhBZGQkw4YNY/r06Qe02b59O5dddhkA119/PVlZWYc97htvvMGzzz5LSIhvytq+ffvWf/EiIiKi0CmNw6pVq4iNja1Y7tq1a8Xgl/06dOjA3/72N4CKV0OuWbOmYnurVq2IjIyseEMPwN69e3nooYdo1aoV7du35+OPP/byMkRERJothU5pMt5++22++uorIiIimDdvHkFBQbRo0QKApUuXsmfPHt5//30efvjhinkonXOEh4ezZ88eLrnkEs4666xAXoKIiEiTpddgSqOQnJzMjBkzKpazsrLo2LHjAW0GDhzITz/53hqWk5NDYmIiRx11FACpqb5nykeMGEFSUhJz587lpJNOokWLFvzlL38B4KGHHuLhhx9uiMsREZEAuvWiXYO8PP6DM9rU+jWb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3bp1A+Dcc89lzpw5B4TOOXPmcM89vnOeddZZXH311TjnaNWqFUOHDmXt2rU1Hn/16tVs27aNE044od5qluZNt9dFREQaoc2bN9O5c+eK5U6dOrF58+Ya24SEhNCmTRt27NhRq+PPnDmTcePGYWb1V7Q0awqdIiIicpCZM2dy3nnnBboMaUIUOkVERBqhxMRENm3aVLGcnZ190LvkK7cpLS1l165dB7zJqSYZGRmUlpYyaNCg+i1amjWFThERkUZo8ODBrFmzhqysLIqLi5k5cyZjxow5oM2YMWMqJtF/6623OOmkk2p1u/z1119XL6fUOw0kEhERaYRCQkJ4+umnGTlyJGVlZUycOJG+ffty1113kZqaypgxY7j00ku58MIL6dGjBzExMcycObNi/6SkJPLz8ykuLubdd99l3rx5FYOQ3njjDT744INAXZo0UQqdIiIijdSpp57KqaeeesC6++67r+J7eHg4b775ZrX77p+zszrr16+vl/pEKlPoFBERaSC3XrQr0CUcER6c0SbQJUgANPgznWZ2pZllmdk+M/vazA45AZiZDfe322dm683sil97TBERERFpWA0aOs1sHDANeAAYACwEPjSzLjW07wp84G83AHgQeMrMxv7SY4qIiIhIw2vons4bgJecc885535wzk0GtgB/rqH9FcBPzrnJ/vbPATOAm37FMUVERESkgTVY6DSzFsAgYF6VTfOA39Sw25Bq2v8HSDWz0F94TBERERFpYOaca5gTmSUAm4Hhzrn5ldbfBZzvnEuuZp/VwKvOufsqrRsGpAMJgP2CY04CJvkXk4FV9XB5cuRqB2wPdBEicsTQ74Sm7yjnXPtAFyEHa3aj151zzwLPBroOaRhmtsw5lxroOkTkyKDfCSKB05ChcztQBsRXWR8P5NSwT04N7Uv9x7NfcEwRERERaWAN9kync64Y+Bo4pcqmU/CNOK/OohraL3POlfzCY4qIiIhIA2vo2+uPAa+Y2RLgS3yj0xOAfwKY2csAzrkJ/vb/BK42syeA/waOBy4GzqvtMaXZ06MUIlKZfieIBEiDDSSqOKHZlcAUoCOwErh+/yAgM/scwDk3olL74cDjQF/gJ+Bvzrl/1vaYIiIiIhJ4DR46RURERKT5afDXYIqIiIhI86PQKSIiIiKeU+iUJsfMeppZ1Wm0REREJID0TKc0CWYWB1wIXA/k4pvLdQvwFjDbObcngOWJiIg0ewqd0iSY2UtAH+B9YAcQC/QHegPZwN+dcx8Hqj4RaXhm1hrY7fQfOpEjgkKnNHpmZsBu4NRK028Z0Ak4DrgcOAoY55z7NlB1ikjDMrP/Bpb4Pxudc/nVtIl1zu1o8OJEmiE90ylNQR8gCyjev8L5bHLOvQmcji+UjgtQfSLSwMzsPHz/w/koMAd42Mz+YGbdzaylv01L4AUzOyaApYo0G+rplEbP/x+O94EIYAKwzjlXXqXNZOBS51z/hq9QRBqamT0HlAF/B/4IXAR0B1YBHwD/D0gGpjnnWgSqTpHmRD2d0ug55wqB24GWwMvABDPrbGaRAGYWAQzH97YqEWnizCwE392Pn51z651zjzjnjgEGA+n4AugbwFPAK4GrVKR5UU+nNBlm1g+4ExgD7AEW4RvJfjK+keyXOee+C1yFItJQzCwaiHfO/a+ZtQBKKg8oMrNxwOvAQD3rLdIwFDqlyfFPn3Qa8HtgH74ezjedc/8byLpEJLDMLAjff/fKzOxyfLfWIwJdl0hzodApTZqZBVV9vlNExMxuAIKdcw8HuhaR5kKhU0REmh0zCwXK9D+lIg1HoVNEREREPKfR6yIiIiLiOYVOEREREfGcQqeIiIiIeE6hU0REREQ8p9ApIiIiIp5T6BQRERERz/1/GhXSy8r2micAAAAASUVORK5CYII=", + "text/plain": [ + "
" + ] + }, + "execution_count": 53, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram([counts_no_init[1], counts_no_init[5], counts_no_init[9]], \n", + " legend=legend_no_init, title='meas w/ dirty qubits', figsize=(9,6))" + ] + }, + { + "cell_type": "code", + "execution_count": 54, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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iisuLgZg1apVoX369EmKiorqGR0dnXzxxRd3KOtr+fLlYWeeeWanZs2a9UxMTOz+8ssvRwM89dRTLWbPnt38r3/9a+uIiIhe5557bkeAiRMntm7VqlWPJk2a9EpMTOw+e/bsqNqer0Y6RURERBrAN998ExoUFOR69OhRWLauR48e+xcuXFhtoPvkk09O+vvf/77xvffeyywoKLArrriiQ8uWLYs3bNiwau/evQGDBw/u9Oc//7noN7/5zc4HHngg7txzz93z5Zdfri0sLLTPP/+8CfjC7oUXXtj5gQce2Hr77bevX7p0afgll1zSuVevXgXjx4/fuXjx4siKl9czMjJCX3nllVZLly79NjEx8eDatWtDiouLrbbnq5FOERERkQawd+/ewCZNmpRWXNesWbOS/Pz8wOr26dmz574RI0b8GBgYyO7duwPT0tKaTZ069fumTZuWxsfHF995553bZ82a1RwgKCjIff/996GbNm0KjoiIcIMGDcoHmDlzZrP4+PjCu+++e1dwcDBnnXVWwYUXXvjjW2+9FV3VMQMDAykqKrIVK1aEFRYWWlJSUlG3bt0Kq2p7OAqdIiIiIg0gKiqqZN++fYdksby8vMDIyMiS6vaJi4srKnv/3XffhRQXF1ubNm2So6KiekZFRfW89957T961a1cwwLPPPpvlnKNv375dOnbs2O2ZZ56JAdi8eXPIypUrm5TtExUV1fP9999vnp2dXeUNot27dy984okntvzud7+La9myZfIll1zSYdOmTbW+mVSX10VEREQawGmnnVZYXFxs33zzTehpp51WCLBy5crwU089taC6fcz+/1XtDh06HAwJCXG5ubkrqnqgqF27dsVvv/32ZoB///vfkUOGDOl83nnn5bdt2/Zgnz599i5atGj9kY5R5tZbb8299dZbc3NzcwNuuOGGk++5556E999/P7M256uRThEREZEG0LRp09JBgwb9+OCDD8bl5eUFzJs3r8knn3xy0qhRo3bVZP+TTz754FlnnbVn9OjRbXNzcwNKSkpYvXp16EcffRQJ8Oqrr0Zv2LAhGCAmJqbYzAgICHBXX331j5s2bQp78cUXmxcWFlphYaGlpaVFLFu2LAygVatWBzMzM0PLjpORkRH6wQcfRBUUFFhERIQLCwtzR/MNTxrpFBERkRNKbebR9Norr7yy+brrrkuMjY1NPumkk4qffPLJ72syXVKZf/7zn5vuuuuu+C5dunTfv39/QEJCQtHYsWO3ASxdurTJ/fff3zY/Pz8wJibm4OTJk7/v2rVrEcCcOXPW3X333W0feuihts45O/XUU/c//fTTWwBuu+22nVddddUpUVFRPVNTU/c+/vjjP0ycODHh2muvDQsKCnK9e/fO//vf/765tudqzp24X0WakpLi0tPTG7oMERERqSNm9rVzLqXiuoyMjE3Jyck7G6qmE0lGRkaL5OTkxKq26fK6iIiIiHhOoVNEREREPKfQKSIiIiKeU+gUEREREc8pdIqIiIiI5xQ6RURERMRzCp0iIiIi4jmFThERERHxnEKniIiIiHhOX4MpIiIiJ5QNSZNO97L/U9ZOqvHXbD7xxBMt33rrrRbr1q0Lv/TSS3PffffdTR6WViPjxo2L27BhQ+js2bMz67JfhU4RERGRBhIfH3/wvvvu2zZ37tymBw4cqNUV6IMHDxIcHOxVaXVOl9dFREREGsgNN9zw44gRI36MiYkpPlLb5557LqZ3796n3nTTTW1POumknvfee29cQUGBjR49OqFNmzanxcTEJA8fPrxdfn6+AWzbti3onHPO6RgVFdWzWbNmPU8//fSkkpISADZt2hQ8aNCgU6Kjo5Pj4+NPmzx5ciuAWbNmNX3++edbf/TRR9ERERG9kpKSutbVuWqkU0REROQ4sXLlyiZDhw7NzcnJWVFYWGh33nlnQmZmZuiKFSvWhISEuKFDh3a477774l588cWtkydPjm3Tpk3Rzp07MwD++9//NjEzSkpKuPjiizteeOGFP86ePXvjxo0bgy+44IKkLl26HLjyyivzFi1alO3F5XWNdIqIiIgcJ1q2bFk0ceLEHcHBwURERLi33nqrxfPPP78lNja2JDo6uvTBBx/c9v777zcHCA4Odtu3bw9ev359SGhoqBs8eHB+QEAAaWlpTXJzc4OeeuqpbWFhYa5r165FI0aMyJkxY0ZzL2vXSKeIiIjIcaJNmzYHy95v27Yt6MCBAwFnnHFGl4ptSkpKDODRRx/NnjBhQtzgwYM7A4wcOTLniSeeyN64cWNITk5OSFRUVM+yfUpLSy0lJWWvl7VrpFNERI5LkydPJiQkhODgYAYPHvyT7V988QXNmzcnPDyck046ia+++qp8m5kRHh5OeHg4rVu3Ll/fuXPn8vUJCQlkZ2fXy7kcrblz55KUlETHjh35/e9//5Ptmzdv5pe//CU9evRg4MCBZGVllW8LDAykZ8+e9OzZkyFDhpSvv+6660hKSqJ79+6MGjWKgwcP/qRfaThm5sret27dujgsLKx05cqVq/fu3bui7LV///7lANHR0aXTpk3LysrK+uZf//rX+pdeeil29uzZUYmJiUXx8fGFFffZt2/f8rS0tO8qH6MuKXSKiMhxp6ioiMcee4x58+axe/du0tLS+OCDDw5pc8011zB06FAKCgp4+OGHueaaaw7ZXlBQQEFBwSHB8rPPPitfHxsby4033lgfp3NUSkpKuOOOO5gzZw5r1qxhxowZrFmz5pA248ePZ+TIkaxcuZJHHnmEBx54oHxbeHg4K1asYMWKFYf82V133XX83//9H9988w0FBQW8/PLL9XZOJ6KDBw+yf/9+KykpsZKSEtu/f7/VNOgHBgYybNiwnXfccUfbrVu3BgFkZmYGv/vuu00BZsyY0WzVqlWhpaWlREdHlwQGBrqAgAAGDhy4r0mTJiUTJ05snZ+fb8XFxXz11VdhaWlpEQCxsbHFWVlZIWUPHdUVXV4XEZHjzmuvvUazZs0YOHAgAP379+fFF188ZMRu586d3HzzzQCMHTuW8ePHH7HfhIQEAEpLSzlw4ABmVvfF15GlS5fSsWNHOnToAMCwYcOYPXs2Xbv+/4eN16xZw9NPPw3AOeecw+WXX37Efi+66KLy97/4xS8OGR1tLGozj6bX7rvvvrg///nPbcqWmzRp0nzs2LHbnn766R9qsv+LL76YNWHChLjU1NQuP/74Y1CrVq2KRo0alQPkrVu3LnT8+PHtcnNzg5o2bVpy44035lx66aV7AT7++OPvxowZk5CYmNijqKjI2rdvf+Cxxx7bCjBy5MjcmTNnNo+Oju6ZkJBQuGbNmm/r4lzNOU9GUI8LKSkpLj09vaHLEBGRWrr33nv58MMPWbt2LQC33norixYtYuXKleVtEhMT6d27N++99x4TJkzgySefZN26dXTq1AkzIyIiAjNjzJgxTJkypXy/Tp06sWHDBpo1a8b69etp0aJFvZ9fTcyaNYu5c+eWj0T+4x//YMmSJbzwwgvlbYYPH05qaip333037733HkOHDmXnzp3ExMQQFBREz549CQoK4v777/9JID148CCpqak8++yznH322fV5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R10VJiIiIiKNR21D5yx8c3KaB7WIiIiISCNVo9BpZhH4vgP9ciAY35ycY5xzO70rTUREREQai5re0/kYcCPwETADOA/4q0c1iYiIiEgjU9PL678CbnLOvQ1gZm8CX5hZoP+pdhERERGRatV0pLMt8HnZgnNuKVAMxHlRlIiIiIg0LjUNnYFAUaV1xdT+QSQREREROQHVNDQa8IaZFVZYFwZMM7P9ZSucc0PqsjgRERERaRxqGjpfr2LdG3VZiIiIiIg0XjUKnc65X3tdiIiIiIg0XrX9GkwRERERkVpT6BQRERERzyl0ioiIiIjnFDpFRERExHMKnSIiIiLiOYVOEREREfGcQqeIiIiIeE6hU0REREQ8p9ApIiIiIp5T6BQRERERzyl0ioiIiIjnFDpFRERExHMKnSIiIiLiOYVOEREREfGcQqeIiIiIeE6hU0REREQ8p9B5nLjhhhswM8yMzp07/2R7nz59CAgIICAggKCgIF544QUAli5dSnBwMGZGTEzMIfv87ne/IyAgADOjRYsWlJSU1Mu5iIiIyIlHofM4UFBQwPTp03nzzTfZtWsX3333XXmoLDN9+nRKS0spLS3liiuuYNy4cQC0bNmSMWPGkJKS8pN+J02axH333UdxcTF5eXnceOON9XE6IiIicgJS6DwOTJo0ieDgYIYPH07z5s055ZRTePbZZw9p06VLl/L3eXl55e/bt2/P008/TXh4+CHt//Of/1BaWsqUKVMIDAzknHPO4cMPP/T2REREROSEpdB5HFizZs0hobFt27bk5ub+pF3v3r0xM+bNm8fUqVMP2+eiRYsICgoqX+7SpQv79++vu6JFREREKlDobESWLVuGc47zzjuPMWPGNHQ5IiIiIuUUOo8DXbt2paCgoHx5y5YtNG/evNr2H330Efn5+Yft88wzz6S4uLh8+dtvvyUiIuLnFysiIiJSBYXO48DDDz/MwYMHmTlzJrm5uWzYsIG77rrrkDavvfZa+fsRI0YQEHD4j/b8888nICCABx54gJKSEv773/9y0UUXeVG+iIiIiELn8SAyMpLhw4czbNgwYmJi6NChA2PGjKFdu3ZcddVVAPzmN78pnzLpvffe45lnninf38z4/PPPyc3NxczKn3x/5JFH+MMf/kBQUBBRUVFMnz69IU5PRERETgBBR24ix4I333yTN99885B133//ffn7nJycavd1zlW5/tFHH+XRRx+tmwJFREREDkMjnSIiIiLiOYVOEREREfGcQqeIiIiIeE6hU0REREQ8pweJPHLLMw1dQcObdk9DVyAiIiLHCo10ioiIiIjnFDpFRERExHMKnSIiIiLiOYVOEREREfGcQqeIiIiIeE6hU0REREQ8p9ApIiIiIp5T6BQRERERzyl0ioiIiIjnFDpFRERExHMKnSIiIiLiOYVOEREREfGcQqeIiIiIeK7eQ6eZ3W5mmWZ2wMy+NrOzD9P2V2Y2z8xyzGyvmS0xsyGV2txoZq6KV5j3ZyMiIiIiNVGvodPMrgGeBZ4AegGLgDlm1q6aXQYAnwEX+9t/DPyriqC6H2hT8eWcO1D3ZyAiIiIiRyOono83DnjNOTfNvzzGzAYDtwEPVG7snLu70qrHzOxi4HLg80ObumwP6hURERGROlBvodPMQoDTgacqbZoHnFmLrqKA3ZXWhZvZZiAQWAE87JxbXk0do4HRAHFxccyfPx+ADh06EBUVRUZGBgAxMTF069aNBQsWABAUFES/fv1YtmwZeXl5AKSkpLB9+3a2bNkCQKdOnQgNDWXVqlXAwFqcUuO0e/du9u7dy8aNGwFITEykefPmLFu2DIDo6GiSk5NJS0vDOYeZMWDAADIyMti92/cR9+7dm9zcXDZt2gR48TlBq1at6Ny5MwsXLgQgNDSUvn37kp6eTn5+PgCpqalkZWWxdetWAJKSkggMDGTNmjUAtG7dmvbt27N48WIAwsPDSU1NZcmSJRQUFADQt29fMjMzyc72/fuoa9eulJSUsHbtWgDi4+NJSEhgyZIlAERGRpKSksLixYspLCwEoF+/fqxbt44dO3YA0L17dwoLC1m/fj0Abdu2JTY2lvT0dACaNm1K7969WbhwIcXFxQD079+f1atXs2vXLgCSk5P1OdXD5wQtEBGfst+9Xvzck2OXOefq50BmccBWYIBzbkGF9Y8A1znnkmrQxx3A74HuzrnN/nV9gc5ABr5AejdwEZDsnFt/uP5SUlKcV39Jb3nGk26PK9PuaegKRI4d+pkA9/91UkOX0OBePmNsQ5dwTJjyejPP+jazr51zKZ4dQI5afV9eP2pmNhR4ErimLHACOOcWA4srtFuEb7RzDHBXPZcpIiIiIlWozweJdgIlQGyl9bHAYe/HNLMrgX8AI51z/3u4ts65EiAd6HT0pYqIiIhIXaq30OmcKwK+Bs6vtOl8fE+xV8nMrsYXOG90zs060nHMzIAewLajr1ZERERE6lJ9X15/GviHmS0FvgBuBeKAlwDMbDqAc26kf3kYvsA5HlhgZq39/RQ553L9bR4FvgTWA03xXVLvge+JeBERERE5BtRr6HTOzTSzGOAhfPNprgIuqnCPZuX5Om/FV+Mz/leZNP7/4+EnAVOB1sAeYDnQ3zm3tM5PQERERESOSr0/SOSc+wvwl2q2DTzccjX7jAX0OKCIiIjIMUzfvS4iIiIinlPoFBERERHPKXSKiIiIiOcUOkVERETEcwqdIiIiIuI5hU4RERER8ZxCp4iIiIh4TqFTRERERDyn0CkiIiIinlPoFBERERHPKXSKiIiIiOcUOkVERETEcwqdIiIiIuI5hU4RERER8ZxCp4iIiIh4TqFTRERERDyn0CkiIiIinlPoFBERERHPKXSKiIiIiOcUOkVERETEcwqdIiIiIuI5hU4RERER8ZxCp4iIiIh4TqFTRERERDyn0CkiIiIinlPoFBERERHPKXSKiIiIiOcUOkVERETEcwqdIiIiIuI5hU4RERER8ZxCp4iIiIh4TqFTRERERDyn0CkiIiIinlPoFBERERHPKXSKiIiIiOcUOkVERETEcwqdIiIiIuI5hU4RERER8ZxCp4iIiIh4TqFTRERERDyn0CnHjcmTJxMSEkJwcDCDBw/+yfa8vDzatWtHcHAwkZGRLFy48JDtixcvxsy45JJLAJgzZw7h4eHlLzPjiiuuqJdz+Tnmzp1LUlISHTt25Pe///1PthcWFnLNNdfQsWNHUlNT2bRp0yHbv//+eyIjI3nqqafK1/35z3+mW7dudO/enWuvvZYDBw54fRoiInKCUeiU40JRURGPPfYY8+bNY/fu3aSlpfHBBx8c0mb06NFERkZy8OBBRo0axfDhww/ZftVVVxEfH1++fOGFF1JQUEBBQQF79uwhICCA8ePH18v5HK2SkhLuuOMO5syZw5o1a5gxYwZr1qw5pM0rr7xCdHQ03333HWPHjuW+++47ZPu4ceO48MILy5e3bt3Kc889R3p6OqtWraKkpIS33367Xs5HREROHAqdclx47bXXaNasGQMHDiQyMpL+/fvz4osvHtLmk08+4Z577gHgj3/8I1lZWZSWlgLwwAMP0KZNGzp27Fhl/3/6059o0qQJZ511lqfn8XMtXbqUjh070qFDB0JCQhg2bBizZ88+pM3s2bO54YYbALjyyiv59NNPcc4B8P7779O+fXu6det2yD7FxcUUFBRQXFzM/v37iYuLq58TEhGRE4ZCpxwX1q5dS0xMTPly+/bt2bZt2yFt8vPz6dWrFwBhYWEEBgayfv16srOzeeGFF/jf//3favv/+9//zqBBg7wpvg5t3bqVtm3bli8nJCSwdevWatsEBQXRrFkzdu3aRX5+Pn/4wx949NFHD2kfHx/P+PHjadeuHW3atKFZs2ZccMEF3p+MiIicUBQ6pdG75JJLuPnmm2ndunWV2/Pz8/nuu+9+EsYam0mTJjF27FgiIyMPWb97925mz55NZmYmP/zwA/v27eONN95ooCpFRKSxCmroAkRqIikpiddff718OTMzkzZt2hzSJjIykuXLl9OnTx8OHDhASUkJnTp1Yv369axYsYLnn3+ekpISzIyrrrqKd955B4AnnniC6OhounfvXq/ndDTi4+PZsmVL+XJWVtYh96lWbJOQkEBxcTF79uwhJiaGJUuWMGvWLCZMmMCPP/5IQEAAYWFhxMbG0r59e1q2bAnAr371KxYtWsT1119fr+cmIiKNm0Y65bgwcuRI9uzZw4IFC8jPz2fBggXcfvvth7Q599xzeeaZZwCYMGEC8fHxBAQEsGfPHoqLiykuLmbAgAFcdNFF5YET4I033uCyyy6rz9M5an369GH9+vVkZmZSVFTE22+/zZAhQw5pM2TIkPKAPmvWLM4991zMjM8//5xNmzaxadMm7rnnHh588EHuvPNO2rVrx5dffsn+/ftxzvHpp5/SpUuXhjg9ERFpxDTSKceFsLAwHnroIc477zyccwwcOJDLLruM/v37c/bZZ/P4448zdepUunfvTnBwMKGhoXz44YdH7HfHjh1kZWUxadIk70+iDgQFBfHCCy8waNAgSkpKGDVqFN26deORRx4hJSWFIUOGcNNNNzFixAg6duxI8+bNj/gkempqKldeeSW9e/cmKCiIXr16MXr06Ho6IxEROVFY2VOtJ6KUlBSXnp7uSd+3PONJt8eVafc0dAUixw79TID7/zqpoUtocC+fMbahSzgmTHm9mWd9m9nXzrkUzw4gR02X10VERETEc7q8Lp7ZkDSpoUs4Jmhkw9tRDREROT5opFNEREREPKfQKSIiIiKeU+gUEREREc8pdIqIiIiI5xQ6RURERMRzCp0iIiIi4jmFThERERHxnEKniIiIiHhOoVNEREREPFfvodPMbjezTDM7YGZfm9nZR2g/wN/ugJltNLNbf26fIiIiIlK/6jV0mtk1wLPAE0AvYBEwx8zaVdO+PfCxv10vYArwvJkNPdo+RURERKT+1fdI5zjgNefcNOfct865McA24LZq2t8K/OCcG+NvPw14HRj/M/oUERERkXpWb6HTzEKA04F5lTbNA86sZre+VbT/N5BiZsFH2aeIiIiI1DNzztXPgczigK3AAOfcggrrHwGuc84lVbHPOuAN59xvK6zrD6QBcYAdRZ+jgdH+xSRgbR2cnhy7WgA7G7oIETlm6GdC43eyc65lQxchPxXU0AXUN+fcVGBqQ9ch9cPM0p1zKQ1dh4gcG/QzQaTh1Gfo3AmUALGV1scC2dXsk11N+2J/f3YUfYqIiIhIPau3ezqdc0XA18D5lTadj++J86osrqZ9unPu4FH2KSIiIiL1rL4vrz8N/MPMlgJf4Hs6PQ54CcDMpgM450b6278E3GlmzwB/A84CbgSurWmfcsLTrRQiUpF+Jog0kHp7kKj8gGa3AxOANsAqYGzZQ0BmNh/AOTewQvsBwJ+BbsAPwB+ccy/VtE8RERERaXj1HjpFRERE5MSj714XEREREc8pdIqIiIiI5xQ6pdExs05mVnkaLREREWlAuqdTGgUzawWMAMYCOfjmct0GzALedc7ta8DyRERETngKndIomNlrQFfgQ2AXEAP0BLoAWcAfnXP/aaj6RKT+mVlTYK/TLzqRY4JCpxz3zMyAvcBFFabfMiABOAO4BTgZuMY5t6Kh6hSR+mVmfwOW+l+bnXN5VbSJcc7tqvfiRE5AuqdTGoOuQCZQVLbC+Wxxzr0DXIIvlF7TQPWJSD0zs2vx/YPzT8Bs4Ekzu8LMTjGzcH+bcOAVMzutAUsVOWFopFOOe/5fHB8CEcBIYINzrrRSmzHATc65nvVfoYjUNzObBpQAfwR+BdwAnAKsBT4GPgWSgGedcyENVafIiUQjnXLcc84VABOBcGA6MNLM2ppZJICZRQAD8H1blYg0cmYWhO/qx4/OuY3Ouaecc6cBfYA0fAH0n8DzwD8arlKRE4tGOqXRMLPuwMPAEGAfsBjfk+zn4XuS/Wbn3DcNV6GI1BcziwZinXP/Z2YhwMGKDxSZ2TXADKC37vUWqR8KndLo+KdPuhi4HDiAb4TzHefc/zVkXSLSsMwsAN/vvRIzuwXfpfWIhq5L5ESh0CmNmpkFVL6/U0TEzMYBgc65Jxu6FpEThUKniIiccMwsGCjRP0pF6o9Cp4iIiIh4Tk+vi4iIiIjnFDpFRERExHMKnSIiIiLiOYVOEREREfGcQqeIiIiIeE6hU0REREQ89/8Ajdob/HZ6svgAAAAASUVORK5CYII=", + "text/plain": [ + "
" + ] + }, + "execution_count": 54, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram([counts_no_init[3], counts_no_init[7], counts_no_init[11]], \n", + " legend=legend_no_init, title='x w/ dirty qubits', figsize=(9,6))" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Next, we consider how measurement fidelity varies with `rep_delay` when we add a `reset` at the beginning versus when we don't.\n", + "\n", + "We replace `dirty_q_circ()` with an `x` gate as this is as far as we can get from $|0>$. We then run either `measure` or `reset, measure`. The `rep_delay` is varied from `0.005-350 us`, with 10 data points (you can run more, but it will take longer). \n", + "\n", + "Qubit initialization is again turned off. \n", + "\n", + "With a `reset`, the measurement fidelity is above 90% for all `rep_delay`s (the fidelity here is defined by the probability of measuring a `0`). However, without the `reset`, the fidelity begins low and steadily rises as `rep_delay` increases. This is because increasing `rep_delay` gives the qubit more time to cool back to its ground state." + ] + }, + { + "cell_type": "code", + "execution_count": 56, + "metadata": {}, + "outputs": [], + "source": [ + "def x_circ():\n", + " qc = QuantumCircuit(1, 1)\n", + " qc.x(0)\n", + " qc.measure(0, 0)\n", + " return qc\n", + "\n", + "circs_no_reset = [x_circ(), reset_meas_circ(0)]\n", + "circs_reset = [x_circ(), reset_meas_circ(1)]\n", + "circs_no_reset = qiskit.transpile(circs_no_reset, backend=backend, optimization_level=0)\n", + "circs_reset = qiskit.transpile(circs_reset, backend=backend, optimization_level=0)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We have used `optimization_level=0` to avoid the `RemoveResetInZeroState` optimization pass from Qiskit (see [here](/api/qiskit/qiskit.transpiler.passes.RemoveResetInZeroState)). There is an open Qiskit issue discussing how best to align this pass with the new `reset` capabilities (see [here](https://github.com/Qiskit/qiskit-terra/issues/5127))." + ] + }, + { + "cell_type": "code", + "execution_count": 57, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "rep_delays (us): [5.00000000e-09 3.88933333e-05 7.77816667e-05 1.16670000e-04\n", + " 1.55558333e-04 1.94446667e-04 2.33335000e-04 2.72223333e-04\n", + " 3.11111667e-04 3.50000000e-04]s\n" + ] + } + ], + "source": [ + "# NOTE: If you run into an issue running more than 5 concurrent jobs, simply split up the loop.\n", + "no_reset_jobs = []\n", + "reset_jobs = []\n", + "rep_delays = np.linspace(0.005e-6, 350e-6, 10) # rep delays to use in sec\n", + "print(f\"rep_delays (us): {rep_delays}s\")\n", + "\n", + "for rep_delay in rep_delays:\n", + " qobj_no_reset = assemble(circs_no_reset, backend, init_qubits=False, optimization_level=0, rep_delay=rep_delay)\n", + " qobj_reset = assemble(circs_reset, backend, init_qubits=False, optimization_level=0, rep_delay=rep_delay)\n", + " job_no_reset = backend.run(qobj_no_reset)\n", + " job_reset = backend.run(qobj_reset)\n", + " no_reset_jobs.append(job_no_reset)\n", + " reset_jobs.append(job_reset)" + ] + }, + { + "cell_type": "code", + "execution_count": 58, + "metadata": {}, + "outputs": [], + "source": [ + "def prob0(counts):\n", + " \"\"\"Probability of 0 from a counts dict of the form {'0': int, '1': int}.\"\"\"\n", + " zero_counts = counts.get('0', 0)\n", + " total_counts = zero_counts + counts.get('1', 0)\n", + " return zero_counts / total_counts" + ] + }, + { + "cell_type": "code", + "execution_count": 59, + "metadata": {}, + "outputs": [], + "source": [ + "# this could take few minutes\n", + "no_reset_counts = [no_reset_jobs[i].result().get_counts()[1] for i in range(10)]\n", + "reset_counts = [reset_jobs[i].result().get_counts()[1] for i in range(10)]\n", + "\n", + "no_reset_prob0 = [prob0(counts) for counts in no_reset_counts]\n", + "reset_prob0 = [prob0(counts) for counts in reset_counts]" + ] + }, + { + "cell_type": "code", + "execution_count": 60, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "metadata": { + "needs_background": "light" + }, + "output_type": "display_data" + } + ], + "source": [ + "plt.plot(rep_delays*1e6, no_reset_prob0, '.', label='no reset')\n", + "plt.plot(rep_delays*1e6, reset_prob0, '.', label='reset')\n", + "plt.legend()\n", + "plt.xlabel('rep_delay (us)')\n", + "plt.ylabel('Success probability ($\\Pr(|0>)$)')\n", + "plt.title('Reset vs. no reset measurement fidelity as function of program delay')\n", + "plt.show()" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "import qiskit.tools.jupyter\n", + "%qiskit_version_table" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "%qiskit_copyright" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.7.9" + }, + "title": "Conditional reset", + "description": "Conditional reset" + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/docs/build/feature-table.mdx b/docs/build/feature-table.mdx new file mode 100644 index 0000000000..3419aac9be --- /dev/null +++ b/docs/build/feature-table.mdx @@ -0,0 +1,69 @@ +--- +title: OpenQASM 3 feature table +description: A list of the OpenQASM 3 language features + +--- + +# OpenQASM 3 feature table + +Below is a list of the `OpenQASM 3` language features. + +For more details on these capabilities, see the [OpenQASM 3.X Live Specification](https://openqasm.com/) . + +Key: + +* ❌ Not supported +* 🟡 Partial support +* ✅ Supported + +| Feature | Support | Comments | +| ------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------- | +| comments | ✅ | | +| QASM version string | ✅ | | +| `include` | ✅ | | +| unicode names | ✅ | | +| `qubit` | 🟡 | Only supports physical qubits, and no arrays. | +| `bit` | ✅ | | +| `bool` | ✅ | | +| `int` | ✅ | Some support for comparisons against integers and casting. | +| `uint` | ❌ | | +| `float` | ❌ | | +| `angle` | ❌ | | +| `complex` | ❌ | | +| `const` | ❌ | | +| `pi`/`π`/`tau`/`τ`/`euler`/`ℇ` | ❌ | | +| Aliasing: let | ❌ | | +| register concatenation | ❌ | | +| casting | 🟡 | Casting between arrays of bits, int, and bool is supported | +| `duration` | ✅ | | +| `durationof` | ❌ | | +| `ns`/`µs`/`us`/`ms`/`s`/`dt` | ✅ | | +| `stretch` | ❌ | | +| `delay` | ✅ | | +| `barrier` | ✅ | | +| `box` | ❌ | | +| Built-in `U` | ✅ | | +| `gate` | ✅ | No support for non-basis gates | +| `gphase` | ❌ | | +| `ctrl @`/ `negctrl @` | ❌ | | +| `inv @` | ❌ | | +| `pow(k) @` | ❌ | | +| `reset` | ✅ | | +| `measure` | ✅ | | +| bit operations | ✅ | | +| boolean operations | ✅ | | +| arithmetic expressions | ❌ | | +| comparisons | ✅ | | +| `if` | ✅ | | +| `else` | ✅ | | +| `else if` | ❌ | | +| `for` loops | 🟡 | Discrete sets and negative stepping is not supported. | +| `while` loops | ❌ | | +| `continue` | ❌ | | +| `break` | ❌ | | +| `return` | ❌ | | +| `extern` | 🟡 | Only for certain extern subroutines exposed by backend devices. It is currently not possible for clients to submit these. | +| `def` subroutines (classical) | ❌ | | +| `def` subroutines (quantum) | ❌ | | +| `input` | ❌ | | +| `output` | ❌ | | diff --git a/docs/build/first-circuit.mdx b/docs/build/first-circuit.mdx new file mode 100644 index 0000000000..62f9442c8e --- /dev/null +++ b/docs/build/first-circuit.mdx @@ -0,0 +1,56 @@ +--- +title: Build your first circuit +description: Build your first quantum circuit with Qiskit + +--- + +# Build your first circuit + + +The basic element needed for your first program in Qiskit is a `QuantumCircuit`. We begin by creating a `QuantumCircuit` comprised of three qubits. + +```python +# Create a Quantum Circuit acting on a quantum register of three qubits +circ = QuantumCircuit(3) +``` + +After you create the circuit with its registers, you can add _gates_ (“operations”) to manipulate the registers. Following is an example of a quantum circuit that makes a three-qubit GHZ state: + +$$|\psi\rangle = \left(|000\rangle+|111\rangle\right)/\sqrt{2}.$$ + +To create such a state, we start with a three-qubit quantum register. By default, each qubit in the register is initialized to $|0\rangle$. To make the GHZ state, we apply the following gates: +- A Hadamard gate $H$ on qubit 0, which puts it into the superposition state $\left(|0\rangle+|1\rangle\right)/\sqrt{2}$. +- A Controlled-NOT operation ($C_{X}$) between qubit 0 and qubit 1. +- A Controlled-NOT operation between qubit 0 and qubit 2. + +On an ideal quantum computer, the state produced by running this circuit would be the GHZ state above. + +Operations can be added to the circuit one by one, as shown below. + +```python +# Add a H gate on qubit 0, putting this qubit in superposition. +circ.h(0) +# Add a CX (CNOT) gate on control qubit 0 and target qubit 1, putting +# the qubits in a Bell state. +circ.cx(0, 1) +# Add a CX (CNOT) gate on control qubit 0 and target qubit 2, putting +# the qubits in a GHZ state. +circ.cx(0, 2) +``` +## Visualize the circuit +You can visualize your circuit using Qiskit `QuantumCircuit.draw()`, which plots the circuit in the form found in many textbooks. + +```python +circ.draw('mpl') +``` + +(![circ.draw output](/images/build/visualize.png)) + + + - [Install and set up](../start/install) + - [Create your first circuit in Lab](/lab/first-circuit) + - [Build a circuit with Composer](https://learning.quantum-computing.ibm.com/tutorial/composer-user-guide#build-edit-and-inspect-quantum-circuits) + - [Advanced Circuits tutorial](https://qiskit.org/documentation/tutorials/circuits_advanced/01_advanced_circuits.html) + - [Test your program](../test/) + - [Run on quantum backends](../run/backends) + \ No newline at end of file diff --git a/docs/build/index.mdx b/docs/build/index.mdx new file mode 100644 index 0000000000..f32fbb6c92 --- /dev/null +++ b/docs/build/index.mdx @@ -0,0 +1,12 @@ +--- +title: Build circuits with Qiskit +description: Build circuits with Qiskit and Qiskit Runtime + +--- + +# Build circuits with Qiskit + +In the build phase, you create quantum programs that represent the problem you are solving. The foundation of quantum programs are quantum circuits, which are made up of gates (or operations) that are used to manipulate qubits in the quantum computer. You can also use _primitives_, which provide methods that make it easier to build modular algorithms and other higher-order programs, as well as providing the interface to run those circuits on a backend and get outputs in a specific format. Depending on your needs, you can use Qiskit or OpenQASM to create your circuits, followed by Qiskit Runtime to initialize your chosen primitive for an IBM Quantum backend. In summary, the build phase consists of these processes: + +1. Defining quantum circuits +2. Initializing primitives diff --git a/docs/build/operators_overview.ipynb b/docs/build/operators_overview.ipynb new file mode 100644 index 0000000000..c39c789f40 --- /dev/null +++ b/docs/build/operators_overview.ipynb @@ -0,0 +1,741 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Operators" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The `Operator` class is used in Qiskit to represent matrix operators acting on a quantum system. It has several methods to build composite operators using tensor products of smaller operators, and to compose operators.\n", + "\n", + "### Creating Operators\n", + "\n", + "The easiest way to create an operator object is to initialize it with a matrix given as a list or a Numpy array. For example, to create a two-qubit Pauli-XX operator:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:02:56.554914Z", + "start_time": "2019-08-21T09:02:54.249612Z" + } + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "\n", + "from qiskit import QuantumCircuit, ClassicalRegister, QuantumRegister\n", + "from qiskit import BasicAer\n", + "from qiskit.compiler import transpile\n", + "from qiskit.quantum_info.operators import Operator, Pauli\n", + "from qiskit.quantum_info import process_fidelity\n", + "\n", + "from qiskit.extensions import RXGate, XGate, CXGate" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:02:56.572857Z", + "start_time": "2019-08-21T09:02:56.566140Z" + } + }, + "outputs": [], + "source": [ + "XX = Operator([[0, 0, 0, 1], [0, 0, 1, 0], [0, 1, 0, 0], [1, 0, 0, 0]])\n", + "XX" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Operator Properties\n", + "\n", + "The operator object stores the underlying matrix, and the input and output dimension of subsystems. \n", + "\n", + "* `data`: To access the underlying Numpy array, we may use the `Operator.data` property.\n", + "* `dims`: To return the total input and output dimension of the operator, we may use the `Operator.dim` property. *Note: the output is returned as a tuple* `(input_dim, output_dim)`, *which is the reverse of the shape of the underlying matrix.*" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:02:56.589962Z", + "start_time": "2019-08-21T09:02:56.585681Z" + } + }, + "outputs": [], + "source": [ + "XX.data" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:02:56.615497Z", + "start_time": "2019-08-21T09:02:56.611146Z" + } + }, + "outputs": [], + "source": [ + "input_dim, output_dim = XX.dim\n", + "input_dim, output_dim" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Input and Output Dimensions\n", + "\n", + "The operator class also keeps track of subsystem dimensions, which can be used for composing operators together. These can be accessed using the `input_dims` and `output_dims` functions.\n", + "\n", + "For $2^N$ by $2^M$ operators, the input and output dimension will be automatically assumed to be M-qubit and N-qubit:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:02:56.804167Z", + "start_time": "2019-08-21T09:02:56.798857Z" + } + }, + "outputs": [], + "source": [ + "op = Operator(np.random.rand(2 ** 1, 2 ** 2))\n", + "print('Input dimensions:', op.input_dims())\n", + "print('Output dimensions:', op.output_dims())" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If the input matrix is not divisible into qubit subsystems, then it will be stored as a single-qubit operator. For example, if we have a $6\\times6$ matrix:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:02:57.764881Z", + "start_time": "2019-08-21T09:02:57.760401Z" + } + }, + "outputs": [], + "source": [ + "op = Operator(np.random.rand(6, 6))\n", + "print('Input dimensions:', op.input_dims())\n", + "print('Output dimensions:', op.output_dims())" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The input and output dimension can also be manually specified when initializing a new operator:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:02:58.292849Z", + "start_time": "2019-08-21T09:02:58.287354Z" + } + }, + "outputs": [], + "source": [ + "# Force input dimension to be (4,) rather than (2, 2)\n", + "op = Operator(np.random.rand(2 ** 1, 2 ** 2), input_dims=[4])\n", + "print('Input dimensions:', op.input_dims())\n", + "print('Output dimensions:', op.output_dims())" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:02:58.779572Z", + "start_time": "2019-08-21T09:02:58.774878Z" + } + }, + "outputs": [], + "source": [ + "# Specify system is a qubit and qutrit\n", + "op = Operator(np.random.rand(6, 6),\n", + " input_dims=[2, 3], output_dims=[2, 3])\n", + "print('Input dimensions:', op.input_dims())\n", + "print('Output dimensions:', op.output_dims())" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We can also extract just the input or output dimensions of a subset of subsystems using the `input_dims` and `output_dims` functions:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:03:02.187313Z", + "start_time": "2019-08-21T09:03:02.183719Z" + } + }, + "outputs": [], + "source": [ + "print('Dimension of input system 0:', op.input_dims([0]))\n", + "print('Dimension of input system 1:', op.input_dims([1]))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Converting classes to Operators\n", + "\n", + "Several other classes in Qiskit can be directly converted to an `Operator` object using the operator initialization method. For example:\n", + "\n", + "* `Pauli` objects\n", + "* `Gate` and `Instruction` objects\n", + "* `QuantumCircuit` objects\n", + "\n", + "Note that the last point means we can use the `Operator` class as a unitary simulator to compute the final unitary matrix for a quantum circuit, without having to call a simulator backend. If the circuit contains any unsupported operations, an exception will be raised. Unsupported operations are: measure, reset, conditional operations, or a gate that does not have a matrix definition or decomposition in terms of gate with matrix definitions." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:03:02.854419Z", + "start_time": "2019-08-21T09:03:02.842387Z" + } + }, + "outputs": [], + "source": [ + "# Create an Operator from a Pauli object\n", + "\n", + "pauliXX = Pauli('XX')\n", + "Operator(pauliXX)" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:03:03.064145Z", + "start_time": "2019-08-21T09:03:03.058953Z" + } + }, + "outputs": [], + "source": [ + "# Create an Operator for a Gate object\n", + "Operator(CXGate())" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:03:03.353613Z", + "start_time": "2019-08-21T09:03:03.345462Z" + } + }, + "outputs": [], + "source": [ + "# Create an operator from a parameterized Gate object\n", + "Operator(RXGate(np.pi / 2))" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:03:47.550069Z", + "start_time": "2019-08-21T09:03:47.408126Z" + } + }, + "outputs": [], + "source": [ + "# Create an operator from a QuantumCircuit object\n", + "circ = QuantumCircuit(10)\n", + "circ.h(0)\n", + "for j in range(1, 10):\n", + " circ.cx(j-1, j)\n", + "\n", + "# Convert circuit to an operator by implicit unitary simulation\n", + "Operator(circ)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Using Operators in circuits\n", + "\n", + "Unitary `Operators` can be directly inserted into a `QuantumCircuit` using the `QuantumCircuit.append` method. This converts the `Operator` into a `UnitaryGate` object, which is added to the circuit.\n", + "\n", + "If the operator is not unitary, an exception will be raised. This can be checked using the `Operator.is_unitary()` function, which will return `True` if the operator is unitary and `False` otherwise." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:03:49.196556Z", + "start_time": "2019-08-21T09:03:49.161398Z" + }, + "tags": [ + "nbsphinx-thumbnail" + ] + }, + "outputs": [], + "source": [ + "# Create an operator\n", + "XX = Operator(Pauli('XX'))\n", + "\n", + "# Add to a circuit\n", + "circ = QuantumCircuit(2, 2)\n", + "circ.append(XX, [0, 1])\n", + "circ.measure([0,1], [0,1])\n", + "circ.draw('mpl')" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that in the above example we initialize the operator from a `Pauli` object. However, the `Pauli` object may also be directly inserted into the circuit itself and will be converted into a sequence of single-qubit Pauli gates:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "backend = BasicAer.get_backend('qasm_simulator')\n", + "circ = transpile(circ, backend, basis_gates=['u1','u2','u3','cx'])\n", + "job = backend.run(circ)\n", + "job.result().get_counts(0)" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:12.017240Z", + "start_time": "2019-08-21T09:04:11.989825Z" + } + }, + "outputs": [], + "source": [ + "# Add to a circuit\n", + "circ2 = QuantumCircuit(2, 2)\n", + "circ2.append(Pauli('XX'), [0, 1])\n", + "circ2.measure([0,1], [0,1])\n", + "circ2.draw()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Combining Operators\n", + "\n", + "Operators may be combined using several methods. \n", + "\n", + "### Tensor Product\n", + "\n", + "Two operators $A$ and $B$ may be combined into a tensor product operator $A\\otimes B$ using the `Operator.tensor` function. Note that if both $A$ and $B$ are single-qubit operators, then `A.tensor(B)` = $A\\otimes B$ will have the subsystems indexed as matrix $B$ on subsystem 0, and matrix $A$ on subsystem 1." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:14.208734Z", + "start_time": "2019-08-21T09:04:14.201058Z" + } + }, + "outputs": [], + "source": [ + "A = Operator(Pauli('X'))\n", + "B = Operator(Pauli('Z'))\n", + "A.tensor(B)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Tensor Expansion\n", + "\n", + "A closely related operation is `Operator.expand`, which acts like a tensor product but in the reverse order. Hence, for two operators $A$ and $B$ we have `A.expand(B)` = $B\\otimes A$ where the subsystems indexed as matrix $A$ on subsystem 0, and matrix $B$ on subsystem 1." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:14.899024Z", + "start_time": "2019-08-21T09:04:14.891072Z" + } + }, + "outputs": [], + "source": [ + "A = Operator(Pauli('X'))\n", + "B = Operator(Pauli('Z'))\n", + "A.expand(B)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Composition\n", + "\n", + "We can also compose two operators $A$ and $B$ to implement matrix multiplication using the `Operator.compose` method. We have that `A.compose(B)` returns the operator with matrix $B.A$:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:15.655155Z", + "start_time": "2019-08-21T09:04:15.648295Z" + } + }, + "outputs": [], + "source": [ + "A = Operator(Pauli('X'))\n", + "B = Operator(Pauli('Z'))\n", + "A.compose(B)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We can also compose in the reverse order by applying $B$ in front of $A$ using the `front` kwarg of `compose`: `A.compose(B, front=True)` = $A.B$:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:16.460560Z", + "start_time": "2019-08-21T09:04:16.452319Z" + } + }, + "outputs": [], + "source": [ + "A = Operator(Pauli('X'))\n", + "B = Operator(Pauli('Z'))\n", + "A.compose(B, front=True)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Subsystem Composition\n", + "\n", + "Note that the previous compose requires that the total output dimension of the first operator $A$ is equal to total input dimension of the composed operator $B$ (and similarly, the output dimension of $B$ must be equal to the input dimension of $A$ when composing with `front=True`).\n", + "\n", + "We can also compose a smaller operator with a selection of subsystems on a larger operator using the `qargs` kwarg of `compose`, either with or without `front=True`. In this case, the relevant input and output dimensions of the subsystems being composed must match. *Note that the smaller operator must always be the argument of* `compose` *method.*\n", + "\n", + "For example, to compose a two-qubit gate with a three-qubit Operator:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:17.113510Z", + "start_time": "2019-08-21T09:04:17.105398Z" + } + }, + "outputs": [], + "source": [ + "# Compose XZ with an 3-qubit identity operator\n", + "op = Operator(np.eye(2 ** 3))\n", + "XZ = Operator(Pauli('XZ'))\n", + "op.compose(XZ, qargs=[0, 2])" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:17.324353Z", + "start_time": "2019-08-21T09:04:17.315952Z" + } + }, + "outputs": [], + "source": [ + "# Compose YX in front of the previous operator\n", + "op = Operator(np.eye(2 ** 3))\n", + "YX = Operator(Pauli('YX'))\n", + "op.compose(XZ, qargs=[0, 2], front=True)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Linear combinations\n", + "\n", + "Operators may also be combined using standard linear operators for addition, subtraction and scalar multiplication by complex numbers. " + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:18.829988Z", + "start_time": "2019-08-21T09:04:18.812834Z" + } + }, + "outputs": [], + "source": [ + "XX = Operator(Pauli('XX'))\n", + "YY = Operator(Pauli('YY'))\n", + "ZZ = Operator(Pauli('ZZ'))\n", + "\n", + "op = 0.5 * (XX + YY - 3 * ZZ)\n", + "op" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "An important point is that while `tensor`, `expand` and `compose` will preserve the unitarity of unitary operators, linear combinations will not; hence, adding two unitary operators will, in general, result in a non-unitary operator:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:19.151814Z", + "start_time": "2019-08-21T09:04:19.147497Z" + } + }, + "outputs": [], + "source": [ + "op.is_unitary()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Implicit Conversion to Operators\n", + "\n", + "Note that for all the following methods, if the second object is not already an `Operator` object, it will be implicitly converted into one by the method. This means that matrices can be passed in directly without being explicitly converted to an `Operator` first. If the conversion is not possible, an exception will be raised." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:20.045005Z", + "start_time": "2019-08-21T09:04:20.039841Z" + } + }, + "outputs": [], + "source": [ + "# Compose with a matrix passed as a list\n", + "Operator(np.eye(2)).compose([[0, 1], [1, 0]])" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Comparison of Operators\n", + "\n", + "Operators implement an equality method that can be used to check if two operators are approximately equal. " + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:20.821642Z", + "start_time": "2019-08-21T09:04:20.815611Z" + } + }, + "outputs": [], + "source": [ + "Operator(Pauli('X')) == Operator(XGate())" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that this checks that each matrix element of the operators is approximately equal; two unitaries that differ by a global phase will not be considered equal:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:21.146256Z", + "start_time": "2019-08-21T09:04:21.141242Z" + } + }, + "outputs": [], + "source": [ + "Operator(XGate()) == np.exp(1j * 0.5) * Operator(XGate())" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Process Fidelity\n", + "\n", + "We may also compare operators using the `process_fidelity` function from the *Quantum Information* module. This is an information theoretic quantity for how close two quantum channels are to each other, and in the case of unitary operators it does not depend on global phase." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:22.171481Z", + "start_time": "2019-08-21T09:04:22.147477Z" + } + }, + "outputs": [], + "source": [ + "# Two operators which differ only by phase\n", + "op_a = Operator(XGate()) \n", + "op_b = np.exp(1j * 0.5) * Operator(XGate())\n", + "\n", + "# Compute process fidelity\n", + "F = process_fidelity(op_a, op_b)\n", + "print('Process fidelity =', F)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that process fidelity is generally only a valid measure of closeness if the input operators are unitary (or CP in the case of quantum channels), and an exception will be raised if the inputs are not CP." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-21T09:04:44.743744Z", + "start_time": "2019-08-21T09:04:44.734826Z" + } + }, + "outputs": [], + "source": [ + "import qiskit.tools.jupyter\n", + "%qiskit_version_table\n", + "%qiskit_copyright" + ] + } + ], + "metadata": { + "title": "Operators", + "description": "Operators notebook", + "anaconda-cloud": {}, + "celltoolbar": "Tags", + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.9.9" + }, + "varInspector": { + "cols": { + "lenName": 16, + "lenType": 16, + "lenVar": 40 + }, + "kernels_config": { + "python": { + "delete_cmd_postfix": "", + "delete_cmd_prefix": "del ", + "library": "var_list.py", + "varRefreshCmd": "print(var_dic_list())" + }, + "r": { + "delete_cmd_postfix": ") ", + "delete_cmd_prefix": "rm(", + "library": "var_list.r", + "varRefreshCmd": "cat(var_dic_list()) " + } + }, + "types_to_exclude": [ + "module", + "function", + "builtin_function_or_method", + "instance", + "_Feature" + ], + "window_display": false + } + }, + "nbformat": 4, + "nbformat_minor": 1 +} diff --git a/docs/build/primitives-examples.mdx b/docs/build/primitives-examples.mdx new file mode 100644 index 0000000000..41521b906b --- /dev/null +++ b/docs/build/primitives-examples.mdx @@ -0,0 +1,276 @@ +--- +title: Primitives examples +description: Practical examples of primitive usage + +--- + +# Primitives examples + +The examples in this section illustrate some common ways to use primitives. Before running these examples, follow the instructions in [Install and set up.](../start/install) + + + These examples all use the primitives from Qiskit Runtime, but you could use the base primitives instead. + + +## Estimator examples + +Efficiently calculate and interpret expectation values of the quantum operators required for many algorithms with Estimator. Explore uses in molecular modeling, machine learning, and complex optimization problems. + +### Run a single experiment + +Use Estimator to determine the expectation value of a single circuit-observable pair. + +```python +from qiskit.circuit.random import random_circuit +from qiskit.quantum_info import SparsePauliOp +from qiskit_ibm_runtime import QiskitRuntimeService, Estimator + +service = QiskitRuntimeService() + +# Run on a simulator +backend = service.get_backend("ibmq_qasm_simulator") +# Use the next line if you want to run on a system +# backend = service.least_busy(simulator=False) + +circuit = random_circuit(2, 2, seed=1234) +observable = SparsePauliOp("IY") + +estimator = Estimator(backend) +job = estimator.run(circuit, observable) +result = job.result() + +print(circuit) +print(f" > Observable: {observable.paulis}") +print(f" > Expectation value: {result.values}") +print(f" > Metadata: {result.metadata}") +``` + +### Run multiple experiments in a single job + +Use Estimator to determine the expectation values of multiple circuit-observable pairs. + +```python +from qiskit.circuit.random import random_circuit +from qiskit.quantum_info import SparsePauliOp +from qiskit_ibm_runtime import QiskitRuntimeService, Estimator + +service = QiskitRuntimeService() + +# Run on a simulator +backend = service.get_backend("ibmq_qasm_simulator") +# Use the following line if you want to run on a system +# backend = service.least_busy(simulator=False) + +circuits = [random_circuit(2, 2, seed=i) for i in range(4)] +observables = [ + SparsePauliOp("IY"), + SparsePauliOp("XY"), + SparsePauliOp("ZI"), + SparsePauliOp("ZX"), +] + +estimator = Estimator(backend) +job = estimator.run(circuits, observables) +result = job.result() + +print(f" > Expectation values: {result.values}") +``` + +### Run parameterized circuits + +Use Estimator to run three experiments in a single job, leveraging parameter values to increase circuit reusability. + +```python +from qiskit.circuit.library import RealAmplitudes +from qiskit.quantum_info import SparsePauliOp +from qiskit_ibm_runtime import QiskitRuntimeService, Estimator + +service = QiskitRuntimeService() + +# Run on a simulator +backend = service.get_backend("ibmq_qasm_simulator") +# Use the following line if you want to run on a system instead of a simulator: +# backend = service.least_busy(simulator=False) + +circuit = RealAmplitudes(num_qubits=2, reps=2) +# Define three sets of parameters for the circuit +parameter_values = [ + [0, 1, 2, 3, 4, 5], + [1, 1, 2, 3, 5, 8], + [0, 0.1, 0.2, 0.3, 0.4, 0.5], +] +observable = SparsePauliOp("ZI") + +estimator = Estimator(backend) +job = estimator.run([circuit] * 3, [observable] * 3, parameter_values) +result = job.result() + +print(f" > Expectation values: {result.values}") +``` +### Leverage sessions and advanced options + +Explore sessions and advanced options to optimize circuit performance on quantum systems. + +```python +from qiskit.circuit.random import random_circuit +from qiskit.quantum_info import SparsePauliOp +from qiskit_ibm_runtime import QiskitRuntimeService, Session, Estimator, Options + +circuit = random_circuit(2, 2, seed=1) +another_circuit = random_circuit(3, 3, seed=1) +observable = SparsePauliOp("IY") +another_observable = SparsePauliOp("XYZ") + +options = Options() +options.optimization_level = 2 +options.resilience_level = 2 + +service = QiskitRuntimeService() + +# Run on a simulator +backend = service.get_backend("ibmq_qasm_simulator") +# Use the following line if you want to run on a system instead of a simulator: +# backend = service.least_busy(simulator=False) + +with Session(service=service, backend=backend) as session: + estimator = Estimator(session=session, options=options) + job = estimator.run(circuit, observable) + another_job = estimator.run(another_circuit, another_observable) + result = job.result() + another_result = another_job.result() + +# first job +print(f" > Expectation values job 1: {result.values}") + +# second job +print(f" > Expectation values job 2: {another_result.values}") +``` + +## Sampler examples + +Generate entire error-mitigated quasi-probability distributions sampled from quantum circuit outputs. Leverage Sampler’s capabilities for search and classification algorithms like Grover’s and QVSM. + +### Run a single experiment + +Use Sampler to determine the quasi-probability distribution of a single circuit. + +```python +from qiskit.circuit.random import random_circuit +from qiskit_ibm_runtime import QiskitRuntimeService, Sampler + +service = QiskitRuntimeService() + +# Run on a simulator +backend = service.get_backend("ibmq_qasm_simulator") +# Use the following line if you want to run on a system instead of a simulator: +# backend = service.least_busy(simulator=False) + +circuit = random_circuit(2, 2, seed=1234) +circuit.measure_all() + +sampler = Sampler(backend) +job = sampler.run(circuit) +result = job.result() + +print(circuit) +print(f" > Quasi-probability distribution: {result.quasi_dists}") +print(f" > Metadata: {result.metadata}") +``` + +### Run multiple experiments in a single job + +Use Sampler to determine the quasi-probability distributions of multiple circuits in one job. + +```python +from qiskit.circuit.random import random_circuit +from qiskit_ibm_runtime import QiskitRuntimeService, Sampler + +service = QiskitRuntimeService() + +# Run on a simulator +backend = service.get_backend("ibmq_qasm_simulator") +# Use the following line if you want to run on a system instead of a simulator: +# backend = service.least_busy(simulator=False) + +circuits = [random_circuit(2, 2, measure=True, seed=i) for i in range(4)] + +sampler = Sampler(backend) +job = sampler.run(circuits) +result = job.result() + +print(f" > Quasi-probability distribution: {result.quasi_dists}") +``` + +### Run paramaterized circuits + +Run three experiments in a single job, leveraging parameter values to increase circuit reusability. + +```python +from qiskit.circuit.library import RealAmplitudes +from qiskit_ibm_runtime import QiskitRuntimeService, Sampler + +service = QiskitRuntimeService() + +# Run on a simulator +backend = service.get_backend("ibmq_qasm_simulator") +# Use the following line if you want to run on a system instead of a simulator: +# backend = service.least_busy(simulator=False) + +circuit = RealAmplitudes(num_qubits=2, reps=2) +circuit.measure_all() +# Define three sets of parameters for the circuit +parameter_values = [ + [0, 1, 2, 3, 4, 5], + [1, 1, 2, 3, 5, 8], + [0, 0.1, 0.2, 0.3, 0.4, 0.5], +] + +sampler = Sampler(backend) +job = sampler.run([circuit] * 3, parameter_values) +result = job.result() + +print(f" > Quasi-probability distribution: {result.quasi_dists}") +``` + +### Use sessions and advanced options + +Explore sessions and advanced options to optimize circuit performance on quantum systems. + +```python +from qiskit.circuit.random import random_circuit +from qiskit.quantum_info import SparsePauliOp +from qiskit_ibm_runtime import QiskitRuntimeService, Session, Sampler, Options + +circuit = random_circuit(2, 2, measure=True, seed=1) +another_circuit = random_circuit(3, 3, measure=True, seed=1) + +options = Options() +options.optimization_level = 2 +options.resilience_level = 0 + +service = QiskitRuntimeService() + +# Run on a simulator +backend = service.get_backend("ibmq_qasm_simulator") +# Use the following line if you want to run on a system instead of a simulator: +# backend = service.least_busy(simulator=False) + +with Session(service=service, backend=backend) as session: + sampler = Sampler(session=session, options=options) + job = sampler.run(circuit) + another_job = sampler.run(another_circuit) + result = job.result() + another_result = another_job.result() + +# first job +print(f" > Quasi-probability distribution job 1: {result.quasi_dists}") + +# second job +print(f" > Quasi-probability distribution job 2: {another_result.quasi_dists}") +``` + +## Next steps + + + [Specify advanced runtime options.](primitive-options) + \ No newline at end of file diff --git a/docs/build/primitives-get-started.mdx b/docs/build/primitives-get-started.mdx new file mode 100644 index 0000000000..c357060f0e --- /dev/null +++ b/docs/build/primitives-get-started.mdx @@ -0,0 +1,135 @@ +--- +title: Get started with primitives +description: Use Estimator and Sampler + +--- + +# Get started with primitives + +The steps in this topic describes how to set up primitives, explore the options you can use to configure them, then invoke them in a program. + + + These examples all use the primitives from Qiskit Runtime, but you could use the base primitives instead. + + + +## Get started with Estimator + +### 1. Initialize the account + +Since Qiskit Runtime `Estimator` is a managed service, you will first need to initialize your account. You can then select the simulator or real backend you want to use to calculate the expectation value. + +Follow the steps in the [Install and set up topic](../start/install) if you don't already have an account. + +```python +from qiskit_ibm_runtime import QiskitRuntimeService + +service = QiskitRuntimeService() +backend = service.backend("ibmq_qasm_simulator") +``` + +### 2. Create a circuit and an observable + +Just like the section before, you will need at least one circuit and one observable as inputs to the `Estimator` primitive. + +```python +from qiskit.circuit.random import random_circuit +from qiskit.quantum_info import SparsePauliOp + +circuit = random_circuit(2, 2, seed=0).decompose(reps=1) +display(circuit.draw("mpl")) + +observable = SparsePauliOp("XZ") +print(f">>> Observable: {observable.paulis}") +``` + +### 3. Initialize the Qiskit Runtime Estimator + +Here we are initializing an instance of `qiskit_ibm_runtime.Estimator` instead of `qiskit.primitives.Estimator` to use Qiskit Runtime's implementation of the `Estimator`. + +When you initialize the `Estimator`, you'll need to pass in the backend you previously selected as the target device (or simulator). You could also do this within the `session` parameter. + +```python +from qiskit_ibm_runtime import Estimator + +estimator = Estimator(backend=backend) +``` + +### 4. Invoke the Estimator and get results + +You can then invoke the `run()` method to calculate expectation values for the input circuits and observables. + +```python +job = estimator.run(circuit, observable) +print(f">>> Job ID: {job.job_id()}") +print(f">>> Job Status: {job.status()}") +``` + +```python +result = job.result() +print(f">>> {result}") +print(f" > Expectation value: {result.values[0]}") +print(f" > Metadata: {result.metadata[0]}") +``` + + +## Get started with Sampler + +### 1. Initialize the account + +Since Qiskit Runtime `Sampler` is a managed service, you will first need to initialize your account. You can then select the simulator or real backend you want to use to calculate the expectation value. + +Follow the steps in the [Install and set up topic](../start/install) if you don't already have an account set up. + +```python +from qiskit_ibm_runtime import QiskitRuntimeService + +# Initialize the service and set the channel to ibm_quantum or ibm_cloud if you didn't set a default channel. +service = QiskitRuntimeService(channel="ibm_quantum") +backend = service.backend("ibmq_qasm_simulator") +``` + +### 2. Create a circuit + +Just like the section before, you will need at least one circuit as the input to the `Sampler` primitive. + +```python +from qiskit.circuit.random import random_circuit + +circuit = random_circuit(2, 2, seed=0, measure=True).decompose(reps=1) +display(circuit.draw("mpl")) +``` + +### 3. Initialize the Qiskit Runtime Sampler + +Here we are initializing an instance of `qiskit_ibm_runtime.Sampler` instead of `qiskit.primitives.Sampler` to use Qiskit Runtime's implementation of the `Sampler`. + +When you initialize the `Sampler`, you'll need to pass in the backend you previously selected as the target device (or simulator). You could also do this within the `session` parameter. + +```python +from qiskit_ibm_runtime import Sampler + +sampler = Sampler(backend=backend) +``` + +### 4. Invoke the Sampler and get results + +You can then invoke the `run()` method generate a quasi-probability distribution for the input circuits and quantum states. + +```python +job = sampler.run(circuit) +print(f">>> Job ID: {job.job_id()}") +print(f">>> Job Status: {job.status()}") +``` +```python +result = job.result() +print(f">>> {result}") +print(f" > Quasi-probability distribution: {result.quasi_dists[0]}") +print(f" > Metadata: {result.metadata[0]}") +``` +## Next steps + + + - Review detailed [primitives examples.](primitives-examples) + - Practice with primitives by working through the [Cost function lesson](https://learning.quantum-computing.ibm.com/course/variational-algorithm-design/cost-functions#primitives) in IBM Quantum Learning. + diff --git a/docs/build/primitives.mdx b/docs/build/primitives.mdx new file mode 100644 index 0000000000..13e920a020 --- /dev/null +++ b/docs/build/primitives.mdx @@ -0,0 +1,72 @@ +--- +title: Introduction to primitives +description: Introduction to primitives in Qiskit and Qiskit Runtime, and an explanation of available primitives + +--- + +# Introduction to primitives + +In computing, a primitive is the smallest processing instruction for a given abstraction level. Put simply, they are the simplest building blocks from which a user can create something useful - and since primitives abstract away implementation details, users can accomplish tasks without needing to worry about low-level specifics. The computational model proposed by primitives moves quantum programming one step closer to where classical programming is today, where the focus is less on the hardware details and more on the results you are trying to achieve. + +## Primitives in Qiskit + +The existing Qiskit interface to backends (`backend.run()`) was originally designed to accept a list of circuits and return counts for every job. Over time, it became clear that users have diverse purposes for quantum computing, and therefore the ways in which they define the requirements for their computing jobs are expanding. Therefore, their results also look different. + +For example, an algorithm researcher and developer cares about information beyond counts; they are more focused on efficiently calculating quasi-probability distributions and expectation values of observables. + +Our primitives provide methods that make it easier to build modular algorithms and other higher-order programs. Rather than simply returning counts, they return more immediately meaningful information. Additionally, they provide a seamless way to access the latest optimizations in IBM Quantum hardware and software. + +The basic operations that one can perform with a probability distribution is to sample from it or to estimate quantities on it. Therefore, these operations form the fundamental building blocks of quantum algorithm development. Our first two Qiskit Runtime primitives (Sampler and Estimator) use these sampling and estimating operations as core interfaces to our quantum systems. + +The following primitives are available: + + | Primitive | Description | Example output | + |-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------| +| Estimator | Computes expectation values of observables with respect to states prepared by quantum circuits. Users generally specify a list of circuits, observables, and possibly some additional configuration, with which the program can efficiently evaluate expectation values and variances. | ![estimator](/images/build/estimator.svg) | +| Sampler | Calculates probabilities or quasi-probability distributions of bitstrings from quantum circuits. Quasi-probability distributions are similar to regular probabilities, except they may include negative values, which can occur when using certain error mitigation techniques. | ![sampler](/images/build/sampler.svg) | + +Primitives work most effectively when they are supported by both Qiskit and the backend provider. The Qiskit module `qiskit.primitives` provides the required support on the Qiskit side, and providers like IBM Qiskit Runtime enable access to appropriate backends through native implementations of their own primitives. + +## Benefits of Qiskit primitives + +For Qiskit users, primitives allow you to write quantum code for a specific backend without having to explicitly manage every detail. In addition, because of the additional layer of abstraction, you may be able to more easily access advanced hardware capabilities of a given provider. For example, with Qiskit Runtime primitives, you can leverage the latest advancements in error mitigation and suppression by toggling options such as `optimization_level` and `resilience_level`, rather than building your own implementation of these techniques. + +For hardware providers, implementing primitives natively means you can provide your users with a more “out-of-the-box” way to access your hardware features. It is therefore easier for your users to benefit from your hardware's best capabilities. + +## Should I use Estimator or Sampler? + +When choosing which primitive to use, you first need to understand whether the algorithm uses a quasi-probability distribution sampled from a quantum state (a list of quasi-probabilities), or an expectation value of a certain observable with respect to a quantum state (a real number). + +A probability distribution is often of interest in optimization problems that return a classical bit string, encoding a certain solution to a problem at hand. In these cases, you might be interested in finding a bit string that corresponds to a ket value with the largest probability of being measured from a quantum state, for example. + +An expectation value of an observable could be the target quantity in scenarios where knowing a quantum state is not relevant. This often occurs in optimization problems or chemistry applications. For example, when trying to discover the extremal energy of a system. + +## What is the difference between the open-source primitives and primitives available through Qiskit Runtime? + +The open-source primitives contain the base classes (to define interfaces) and a reference implementation. The Qiskit Runtime primitives provide a more sophisticated implementation (such as with error mitigation) as a cloud-based service. + +## Where should I import the primitive from? + +There are different primitive implementations in the ``qiskit``, ``qiskit_aer``, and ``qiskit_ibm_runtime`` libraries. +Each implementation serves a specific purpose: + +* The primitives in ``qiskit`` can perform local state vector simulations - useful for quickly prototyping algorithms. + * The `qiskit.primitives` module enables the development of primitive-style quantum programs and was specifically designed to simplify switching between different types of backends. The module provides three separate classes for each primitive type: + + 1. `Sampler` and `Estimator` + These classes are reference implementations of both primitives and use Qiskit’s built-in simulator. They leverage Qiskit’s `quantum_info` module in the background, producing results based on ideal statevector simulations. + + 2. `BaseSampler` and `BaseEstimator` + These are abstract base classes that define a common interface for implementing primitives. All other classes in the `qiskit.primitives` module inherit from these base classes, and developers should use these if they are interested in developing their own primitives-based execution model for a specific backend provider. These classes may also be useful for those who want to do highly customized processing and find the existing primitives implementations too simple for their needs. + + 3. `BackendSampler` and `BackendEstimator` + If a provider does not support primitives natively, you can use these classes to “wrap” any backend into a primitive. Users can write primitive-style code for providers that don’t yet have a primitives-based interface. These classes can be used just like the regular Sampler and Estimator, except they should be initialized with an additional backend argument for selecting which backend to run on. + +* The primitives in ``qiskit_ibm_runtime`` provide access to cloud simulators and real hardware through the Qiskit Runtime service. They include exclusive features such as built-in circuit optimization and error mitigation support. + +## Next steps + + + - Review detailed [primitives examples.](primitives-examples) + - Practice with primitives by working through the [Cost function lesson](https://learning.quantum-computing.ibm.com/course/variational-algorithm-design/cost-functions#primitives) in IBM Quantum Learning. + \ No newline at end of file diff --git a/docs/build/pulse.ipynb b/docs/build/pulse.ipynb new file mode 100644 index 0000000000..553301ea88 --- /dev/null +++ b/docs/build/pulse.ipynb @@ -0,0 +1,965 @@ +{ + "cells": [ + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Pulse gates\n", + "\n", + "## Overview\n", + "\n", + "Most quantum algorithms can be described with circuit operations alone. When we need more control over the low-level implementation of our program, we can use _pulse gates_. Pulse gates remove the constraint of executing circuits with basis gates only, and also allow you to override the default implementation of any basis gate.\n", + "\n", + "Pulse gates allow you to map a logical circuit gate (e.g., `X`) to a Qiskit Pulse program, called a `Schedule`. This mapping is referred to as a _calibration_. A high fidelity calibration is one which faithfully implements the logical operation it is mapped from (e.g., whether the `X` gate calibration drives $|0\\rangle$ to $|1\\rangle$, etc.).\n", + "\n", + "A schedule specifies the exact time dynamics of the input signals across all input _channels_ to the device. There are usually multiple channels per qubit, such as drive and measure. This interface is more powerful, and requires a deeper understanding of the underlying device physics.\n", + "\n", + "It's important to note that Pulse programs operate on physical qubits. A drive pulse on qubit $a$ will not enact the same logical operation on the state of qubit $b$ -- in other words, gate calibrations are not interchangeable across qubits. This is in contrast to the circuit level, where an `X` gate is defined independent of its qubit operand.\n", + "\n", + "This page shows you how to add a calibration to your circuit.\n", + "\n", + "**Note:** Not all providers support pulse gates." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Build your circuit\n", + "\n", + "Let's start with a very simple example, a Bell state circuit." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAXEAAADuCAYAAADPwDeGAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAAAdm0lEQVR4nO3de3SU1d328W/OJxKSAJpAAgEBBQIBAjwmUjUU5CxgRW2poBUVixVaS1B8HytdFkSo632tDxWEarXlUJVaCwjUokIpIAGCIGc0NgkZHkMCYRIChMn7xzQpIRPITGYysyfXZy1WMvdh37+B4Zp97/sUUF1dXY2IiBgp0NsFiIiI6xTiIiIGU4iLiBhMIS4iYjCFuIiIwRTiIiIGU4iLiBhMIS4iYjCFuIiIwRTiIiIGU4iLiBhMIS4iYjCFuIiIwRTiIiIGU4iLiBhMIS4iYjCFuIiIwRTiIiIGU4iLiBhMIS4iYjCFuIiIwRTiIiIGU4iLiBhMIS4iYjCFuIiIwRTiIiIGU4iLiBhMIS4iYjCFuIiIwRTiIiIGU4iLiBhMIS4iYjCFuIiIwRTiIiIGU4iLiBhMIS4iYjCFuIiIwYK9XYDUV10NFy97uwrnhAZBQIC3q/Af1dXVVFRUeLsMp0RGRhKgD0GzU4j7oIuXYfZqb1fhnAX3Q5g+TW5TUVFBq1atvF2GU6xWK1FRUd4uo8XRcIqIiMEU4iIiBlOIi4gYTCEuImIwhbiIiMEU4iIiBlOIi4gYTCEuImIwhbiIiMEU4iIiBlOIi7QQbdq0oXPnznTp0oWEhASn1582bRrJyckeqEyaQne7EPFTSUlJTJ48mVtvvZX09HTat29fZ/6ZM2fYs2cPu3btYuXKlezbt6/Btp599lnmzZvHiRMnyMrKIj8/39PlSyOpJy7iZwYPHsyaNWvIy8vjV7/6FWPHjq0X4ACxsbEMGTKE2bNnk5uby7Zt27j//vvrLVcT4AA33XQTI0eO9Ph7kMbz+xAvLi4mOzubrl27Eh4eTnJyMjNmzKC8vJxHHnmEgIAAXnvtNW+XKR5ks8GBAlixHd74FN7aChv3w9nz3q7MvVq1asVvf/tbtm7dyoQJEwgKCqqdV1payt///ndWrFjBH//4R9atW0dBQUGd9TMzM1m1ahWbNm2iY8eOQN0AB8jOzmbp0qXN84akUfx6OCU3N5eRI0disViIioqiZ8+enDx5kldffZUTJ05QUlICQN++fb1bqIcUHPyU9+dlMfj7C0kf/XOHy/y/HwaQ0nc0436+tpmrax47T8CGL6D0qltz5/7LHuRpHeHegRAV5p363KV///6sWbOGTp061U4rLCxk6dKlrFixguPHjztcLyEhgXHjxvHjH/+YPn36ADBs2DAOHDjA2rVr+f73v1+7bHZ2NgsXLvTsGxGn+W1PvLi4mLFjx2KxWHj66acpKipiz549WCwWFixYwLp169i1axcBAQG1H17xLxv2w8od9QO8hq0a9n4D/3cjlBncK8/MzOSTTz6pDXCr1cr06dNJSUnhl7/8ZYMBDmCxWFiyZAlpaWmMGjWqdqw7OjpaAW4Ivw3xp556ioKCAp588kkWLVpEdHR07bzs7GzS0tKoqqoiJSWFmJgYL1YqnrAnz94Db4xvz8Gyz+yhbprevXuzfv362s/wP//5T3r37s3ixYupqqpyqq2PPvqI1NRU9u7dW2f6H/7wBwW4D/PLED906BCrV6+mbdu2zJ8/3+Ey6enpAKSlpdWZ/vXXX3P33XcTHR1NXFwckydP5vTp0x6vWdynuhr+dsC5df51Go5aPFOPp4SGhrJixQpat24NwMaNGxk6dCh5eXkutzl9+nT69etXZ9rdd9+tUwt9mF+G+MqVK7HZbEyaNKnBR1xFREQAdUP83LlzZGVlUVBQwMqVK1m6dClbt25lzJgx2Gy2ZqndE6ouVnD+XLHDP/7oq2+h6Kzz6/3jqPtr8aTnn3+e1NRUAPbu3cs999zD+fOujwtdfRBz9+7dAMTExLBs2bKmFSse45cHNjdv3gxAVlZWg8vUHJm/MsSXLl1KYWEhW7ZsqT06n5SURGZmJh9++CHjx4/3XNEetOP9X7Dj/V94u4xmc/ika+sdOmnvxZvwrN+uXbsye/ZsAC5evMjkyZOb9GBlR2ehLFmyhAMHDpCcnMxdd93FxIkTeffdd5tcu7iXX4b4N998A1DnSP2Vqqqq2LZtG1A3xNeuXcvgwYNrAxwgIyODLl268Ne//tXlEB8wYAAWS+P31YNCIpjw4jGXtuVIatZjdPuviQ7n/fmlYW7ZRvdu3bh8yTeODvYd9yJdMx9yer3LNujU+SZsVRfcX5STrrfn98QTTxAcbP/vO3/+fA4ccHL86AqOArxmDHzatGmsW7cOgJ/85CfXDPFu3boRGOiXO/fNIiEhgZycHKfX88sQLy8vB2hw13L16tUUFxcTHR1N586da6cfPHiQiRPrh12vXr04ePCgy/VYLBYKCwsbvXxwWKTL23IkNqEbHVOHurXNq50sOknVBdd7gu6UUvK/Lq1nu1xF/jdfubka94uIiODhhx8G7J/xV1991eW2rhXgAOvXr+fAgQOkpqbyne98h969e7N//36HbRUVFblch7jOL0M8ISGB0tJS9uzZQ0ZGRp15RUVFzJo1C4A+ffoQcMW+c2lpKbGxsfXai4+P58iRI02qxxlBIREub8tb2ie295me+KUzJ1xar7RgHx06dHBzNa6x2WwNhuKIESOIi4sDYNWqVbXXOzjregFeY/HixSxevBiAH/zgBzz77LMO20tMTFRPvAlcuZ8N+GmIDx06lEOHDrFgwQKGDRtG9+7dAdi1axcPPvggxcX2A3rNdZGPs7tIF6pg9moPFeMhR48dI8xHPk2XbTD3A+fP/X7qgXTemVNw/QWbQXl5eYMH5QcMGFD7+1/+8heX2m9sgNdsoybEr9z21Y4dO0ZUVJRL9Yjr/PJrMzs7mzZt2pCfn0+vXr3o3bs33bp1Y9CgQXTp0oUhQ4YA9U8vjIuL48yZM/XaKykpIT4+vjlKFzcICoTB3Z1bJyYC+jo+hOJzak6PBec7COBcgAOcPHmydq+gf//+Tm9PPMsvQzwpKYmtW7cyevRowsPDycvLIz4+niVLlrBu3TqOHrWfS3Z1iPfo0cPh2PfBgwfp0aNHs9Qu7vHdnpCa1Lhlw4Jh6h0QEnT9ZX3BLbfcAsDp06edOtYCzgd4jdzcXMA+tHjjjTc6tU3xLB/ZAXa/Hj16sHZt/fuBWK1W8vLyCAwMrD3HtsaYMWOYM2cOBQUFJCXZE2Dnzp2cOHFCV6wZJigQHhoM7+fAjuPQ0MWYbVrBw9+BJIN2tCwWC4GBgU6d8QQwa9YslwIcID8/n8LCQs6fP197Voz4hoDq6moDLzZ23c6dO7n11lu5+eabOXz4cJ15ZWVl9O7dm7Zt2zJ37lwqKyvJzs6mXbt2bN++vdkO2pg4Jr7gfnxmTPxqp62w/Th8kQ/fltkDPTgQHr4deiSCLx6Lu9aYuKuGDx/OBx98QHh4uEfuhWK1WjUm7gU++PH1rJrTo64eSgH7lWmbN28mMTGRBx54gKlTp5KZmcnatWt11N1gbVrBmL4wZ6x97Bvsdy3s1cE3A9xTNm7cyPjx43n66ae1Z+lHfLTv5DnXCnGw3/Te0TCMiD/YuHEjGzdu9HYZ4kYtqB9id70QFxExSYvridfcV0VExB+0uJ64iIg/UYiLiBhMIS4iYjCFuIiIwRTiIiIGU4iLiBhMIS4iYjCFuIiIwRTiIiIGU4iLiBhMIS4iYrAWd+8UE4QG2e/PbZJQQ56KY4rIyEisVqvb2lu4ZBVl5RXEREUy6/EH6r12h8jISLe0I85RiPuggADffcCCNI+AgAC3PmAhNCyc0EuXCQ0LJyoqqt5rMZeGU0REDKYQFxExmEJcRMRgCnEREYMpxEVEDKYQFxExmEJcRMRgCnEREYMpxEVEDKYQFxExmEJcRMRgCnEREYMpxEVEDKYQFxExmEJcRMRgCnEREYMpxEVEDKbnx4iIT6qurqaiosLbZTRaZGQkAQEBzb5dhbiI+KSKigpatWrl7TIazWq1euVRdxpOERExmEJcRMRgCnEREYMpxEVEDKYQlxbDVg3V1fbfa36KmE5np4jfOnUWvsiHghLIL4GS8v/MK6uEVzdBUjzcdAP06gDBQd6rVcRVCnHxK7Zq2J8P/zgKx05de9mvvrX/2XIEosMhoyvc1h1aRzRPrSLuoBAXv3HaCqt2XD+8HTlXCZsO2AN9QjoM6gJeuG5DxGkKcfELn38F7+2Ci1VNa6fyEqzcAfv+BT/MhMgw99Qn4ik6sCnG++QQrNje9AC/0sGT8NrHYK10X5sinqAQF6P94yj8ZY9n2j55Bl7fbO+di4SEhJCQkODtMurRcIoYq6AE1uR4eBul8Ofd8P1bPbsd8YyIiAgGDBhAeno66enpJCYmEhoaysWLFzl58iS7d+9m9+7d5OTkUFnZ8G5XSEgI7777LqmpqWRlZZGfn9+M7+LaFOJipKrL9iEUm5Pne/9sBMREQNl5eGVD49bZeQLSkqFnB+frFO/o3r07TzzxBA899BCxsbENLvfggw8CUFJSwu9+9ztef/11Tpw4UWeZmgAfN24cAOvWraNv377YbDaP1e+MFjGcUlxcTHZ2Nl27diU8PJzk5GRmzJhBeXk5jzzyCAEBAbz22mveLlOc8Nlh+3CHs2IiIDbS/tMZf/rc/sUhvi02NpY333yTI0eOMHPmzGsG+JXi4+P5+c9/zvHjx3njjTeIiYkB6gd4RUUFM2fO9JkAhxbQE8/NzWXkyJFYLBaioqLo2bMnJ0+e5NVXX+XEiROUlJQA0LdvX+8WKo122QZbjzbvNs9U2C8c6p/SvNuVxhsxYgTLli2jQ4f/7DKdP3+ed999ly1btrB7926OHz9OZWUl4eHhdO/enfT0dO644w6+973vER4eDsDUqVMZPnw4jz32GNOmTasT4GPHjmXz5s1eeX8N8esQLy4uZuzYsVgsFp5++ml+8YtfEB0dDcDLL7/M7NmzCQ4OJiAggD59+ni5Wmmsg4X2UG1u/ziqEPdVjz/+OIsXLyYw0D64cPbsWV588UWWL19OaWlpveWtVit79uxhz549vPHGG8yYMYOpU6fy3HPPER0dTXJyMuvXr699yIOvBjj4+XDKU089RUFBAU8++SSLFi2qDXCA7Oxs0tLSqKqqIiUlpXb3SXxfztfe2e5X39ovKBLfMnXqVF5//fXaAP/oo4/o1asXixYtchjgjpw+fZoFCxaQmprKxx9/DFAb4BcuXPDZAAc/DvFDhw6xevVq2rZty/z58x0uk56eDkBaWlrttJrQHzRoEGFhYV553JJc2zenvbftfC9uW+rLzMxkyZIlta8XLFjAqFGjKCwsdKm9oqIiysvL60wLDg6mrKysSXV6kt+G+MqVK7HZbEyaNKnBRzxFRNiPbl0Z4sePH+f9998nISGBgQMHNkut0njnKr0zlFIjv8R725a6IiIiePPNN2t74L/+9a955plnXG7v6oOYly7ZLxAICgrizTffJDQ0tOlFe4DfhnjNrk9WVlaDyxQUFAB1Q/z222+nqKiIDz/8kKFDh3q2SHGa5YyXt3/Wu9uX/5g7dy7du3cHYPv27WRnZ7vclqOzUEaPHs3u3bsBSE1N5b//+7+bXrQH+O2BzW+++QaATp06OZxfVVXFtm3bgLohXvOt7k4DBgzAYrG4vd2WKLHHUG576C2H82rOAb+WmPD//HxhQsPLNXQe+Sdb/sncH97XuGJ9yISHZxLVKoYiSxFJSUn1Xvuia53G17p1a6ZPnw5AZWUlDz/8sMun/TkK8JoxcIvFQk5ODqGhoTz11FO89NJL9YZbanTr1q1J+ZGQkEBOjvNXr/ltiNf8RZ8/f97h/NWrV1NcXEx0dDSdO3f2aC0Wi8XlMTqpK7RdcYPzas4Bb4zAwMYve6ULlZVG/lvaLl+u/VlYWFjvtWmmTJlCZKT9H3DZsmUcOXLEpXauFeAA+/fv5+2332bq1KnExMQwadIkli5d6rCtoqIil2poKr8N8YSEBEpLS9mzZw8ZGRl15hUVFTFr1iwA+vTp4/GDl754vwVTtY5uuKtd5vj7uo6YcHuA22z2B0M421ZQwOU65yGbIjAoqPZnhw4d6r32RTabrcFgfPTRR2t/X7x4sUvtXy/Ar2x/6tSptdttKMQTExOb3BN3hd+G+NChQzl06BALFixg2LBhtWNnu3bt4sEHH6S42N6ja46LfFzZRRLHrJXwf953PK8xl9G/MMHeAy+rhBf+7Pz2H7x3GH/6VYHzK3rZvP/5I2XWchITEikoKKj32heVl5c7PCkhLi6O1NRUAHbu3MmhQ4ecbruxAQ6wd+9e9u3bR1paGv379ycqKsrhkMqxY8eIiopyupam8tsDm9nZ2bRp04b8/Hx69epF79696datG4MGDaJLly4MGTIEqDseLr6vVbhrwyDuktzGe9sWu/79+9f+vmPHDqfXdybAr95OYGCgz13d7bchnpSUxNatWxk9ejTh4eHk5eURHx/PkiVLWLduHUeP2q/bVoibp1Nb7227Y7z3ti12/fr1q/295uyRxnIlwK/ezpVfIr7Ab4dTAHr06MHatWvrTbdareTl5REYGFi7WybmGNjZ/uSd5nbTDRDv+JIDaUbx8f/5JnXmlrCuBvjV24mLi3OiWs/z6xBvyJdffkl1dTXdu3evPcJ9pffeew+AgwcP1nmdkpLCgAEDmq9Qcahne4iLhNJmvuhncPfm3Z44tnTpUjZt2kRERARffPFFo9dLS0tj+PDhgPP3QsnJyWHkyJFUVlby1VdfuVS3p7TIEN+/fz/Q8FDKxIkTHb6eMmUKb731lkdrk+sLDITbb/HcE30ciYuEPsnNtz1pWF5eHnl5eU6vl5OTw/jx41mxYgUTJ0506l4oxcXFbNjQyBvQNzOFuAPV1U4+aUCa3e03w+48+9N9msP9t0KQ3x5Bajk2btxISkoK586d83YpbtMiP5bXC3HxfUGB8AMXgrXsvP3eK405p7xGRle4JdG57Yjv8qcAhxbaE/fVW0qKc9rHwb0DYfXOxq/T2Eey1UiOh3G+dTKCSB0tsicu/iOjK0xI90zbSXHweBaEh3imfRF3aJE9cfEvd9wCUWHw7udwoco9baYmwaQMiPDNu4+K1FKIi18Y0Nl+HveqHXCkCTeMjAyFewZAegroeSBiAoW4+I24KJg2BL4stD8P87ATN5VrHQGZ3ex/osM9V6OIuynExa8EBNiHQlKT4NtzsD/f/jSeghIotkLN2aMRofYx76R4ew++R3udQihmUoiL32oXDUN61p122WYP+kANlYifUIhLi6LetvgbfaRFRAymEBcRMZhCXETEYApxERGD6cCmiPikyMhIrFarW9pauGQVZeUVxERFMuvxBxqc1hSOnk3QHBTiIuKTAgIC3Pbg4dCwcEIvXSY0LLy2TUfTTKThFBERgynERUQMphAXETGYQlxExGAKcRERgynERUQMphAXETGYQlxExGAKcRERgynERUQMphAXETGYQlxExGAKcRERgynERUQMphAXETGYQlxExGAKcRERgynERUQMphAXETGYQlxExGAKcRERgynERUQMphD3AQsXLiQjI4O4uDhiY2MZPHgwGzZs8HZZIte0fv16+vbtS1hYGCkpKbzyyiveLqlZbdmyhXHjxtGpUycCAgJ48cUXvVKHQtwHbN68mR/96Ed88sknfP7552RmZjJmzBi2bdvm7dJEHMrJyWHcuHGMHDmS3NxcXnjhBebMmcPrr7/u7dKajdVqpWfPnrz88sskJCR4rY5gr21Zan300Ud1Xr/88sts2LCBNWvWcNttt3mpKpGGvfLKKwwcOJD58+cD0KNHD7788kteeuklpk2b5uXqmseoUaMYNWoUALNnz/ZaHQpxH2Sz2SgrKyMqKsrbpYhhLly8xDeFp+pNr7p8ufbn0a8L6r2+0o1t42gdfe3P3rZt23jkkUfqTBsxYgSLFi2ioKCApKSkpryNJvlX4SkqL16qM83R+23o7yAiLJTk9jc0U7VNpxD3QfPmzePMmTM89thj3i5FDBMSEszWz/dxLK/Q4fyK85X87k/rG3wdG9OKmT+697rbKSoqqjeEUPO6qKjIqyFecvYcq/662eG8q9+vo2k/HD+MZI9W6F4aE/cxixcvZt68ebz33nte/Y8gZgoMCODeUXcSER7m0voTR91JeFiom6tqXn17dqXPLV1cWrd/andSb+7s5oo8SyHuQxYtWsSsWbP48MMPGTp0qLfLEUO1jo5i/DDnj6UMHtibmzq1b9SyiYmJWCyWOtNOnTpVO8/bxt81mJhWkU6tExvTiruHZnqoIs9RiPuI559/nrlz57J+/XoFuDRZWs+upPW4qdHL39g2juG3D2z08rfddhsbN26sM23Dhg106tTJJ/YgIyPCuXfUnY1ePgC4b7SZeyEKcR8wc+ZMFi5cyDvvvMPNN9+MxWLBYrFw9uxZb5cmBht312BiWl3/4HhQYCD3jckiJLjxh8h++tOf8vnnn/Pcc89x+PBhfv/73/Ob3/yGZ555piklu1X3zklk9O/VqGUHD+xDl46N2wupYbVayc3NJTc3l4sXL2KxWMjNzeX48eOulOuygOrq6upm3aLUExAQ4HD6lClTeOutt5q3GPErx74uYPlVB/KuNvz2gWRl9HO67XXr1jFnzhwOHz5MQkICM2bM4Gc/+5mrpXrExUtV/Oat9/m2pOEO0Y1t43hyygSnvsQAPv30U7KysupNv+OOO/j000+dLdVlCnHDfJ1fRFJCO0JCdGKRNM6HH2/jn7u/dDivU4cbefwHYwkM9N+d8vyi/+W37/wFm4OoCwoMZPqUCbS/oY0XKnMP//2X80PnrBUs/9N6Xl66irNlVm+XI4YYccd/0S4+tt700JBg7hud5dcBDpCceANDMvs7nDfsOwOMDnBQiBvls537qKq6TFxMNDHXuRhDpEZoSDD3j8kiMLDusN2Y72bSJi7GS1U1r6yMfiQntqszLSUpgdsH9fFSRe6jEL/C5cuXeeedd7jrrrto164dYWFhdOzYkREjRrBs2TIu//sKL284Z61gR+5BAIYOTm9wHF3EkaTEdnw3M732dY+uHRnY52YvVtS8goJqDt4GARAaGsLE0Xf6xV6I+e/ATcrKyhg2bBiTJ0/mb3/7G6GhoaSlpWGz2di0aROPPvoo586d81p9Nb3wju1vpFtKB6/VIea6M6MvyYk3EBURzj0jbm9xHYF28bGMyroVgLFDMmgT6x97ITqw+W8TJ06svUry7bffrnPU+dSpUyxfvpwZM2a4dD+T3/x+Dees512uzWazYa2wrx8ZHkawk0fRRWrYqm3YbDaCg1ruZ+jipUuEhoR4u4x6oltF8JMp9zi9nkIc2L17NwMGDCA4OJi9e/eSmprq1vbn/c8fKbOWu7VNEfEvMa2imDN9ktPrtdyv4yt88MEHAIwePdrtAQ72b1hXqRcu0jK4mhNKBODgQfsBw4yMDI+078ouUo21f9/OP3L207H9jTzxw7tb3DimiFybQhz7QU2A1q1be6R9V8fEr+yFF5ecYf7iFe4uTUR8hKtj4gpxICbGfpTaU/cqOWc93+Qx8YrKC8AF9xQkIn5DIQ706tWLNWvWsH37do+078pYl8bCRVoWV8fEdXYKsHfvXvr3709ISAi5ubn07NnT2yVpLFxEGkUX+wD9+vXjvvvu49KlS4wcOZLPPvuszvxTp04xf/58ysub5zRBXZ0pIo2lnvi/lZWVMW7cuNpbSHbo0IH27dtTVFREYWEh1dXVlJaWEhsb6/Fa1AsXkcZST/zfYmJi+Pjjj1m+fDl33nknFRUV7Nu3j8DAQIYPH87y5cuJjo5ullpaRUUQHhaqXriIXJd64j6q8sJFwkJDFOIick0KcRERg2k4RUTEYApxERGDKcRFRAymEBcRMZhCXETEYApxERGDKcRFRAymEBcRMZhCXETEYApxERGDKcRFRAymEBcRMZhCXETEYApxERGDKcRFRAymEBcRMZhCXETEYApxERGDKcRFRAymEBcRMZhCXETEYApxERGDKcRFRAymEBcRMZhCXETEYApxERGDKcRFRAymEBcRMZhCXETEYApxERGDKcRFRAymEBcRMZhCXETEYApxERGDKcRFRAymEBcRMZhCXETEYApxERGDKcRFRAz2/wHoKkgHdFVPHgAAAABJRU5ErkJggg==", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "from qiskit import QuantumCircuit\n", + "\n", + "circ = QuantumCircuit(2, 2)\n", + "circ.h(0)\n", + "circ.cx(0, 1)\n", + "circ.measure(0, 0)\n", + "circ.measure(1, 1)\n", + "\n", + "circ.draw('mpl')" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Build your calibrations\n", + "\n", + "Now that we have our circuit, let's define a calibration for the Hadamard gate on qubit 0.\n", + "\n", + "In practice, the pulse shape and its parameters would be optimized through a series of Rabi experiments (see the [Qiskit Textbook](https://learn.qiskit.org/course/quantum-hardware-pulses/calibrating-qubits-using-qiskit-pulse) for a walkthrough). For this demonstration, our Hadamard will be a Gaussian pulse. We will _play_ our pulse on the _drive_ channel of qubit 0.\n", + "\n", + "Don't worry too much about the details of building the calibration itself; you can learn all about this in the [Building pulse schedules](#building-pulse-schedules) section." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "from qiskit import pulse\n", + "from qiskit.pulse.library import Gaussian\n", + "from qiskit.providers.fake_provider import FakeValencia\n", + "\n", + "backend = FakeValencia()\n", + "\n", + "with pulse.build(backend, name='hadamard') as h_q0:\n", + " pulse.play(Gaussian(duration=128, amp=0.1, sigma=16), pulse.drive_channel(0))" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let's draw the new schedule to see what we've built." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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MxERERERUU3GkStEb7nQ0FCMHDmSiRUiIiIiIqJy4sgVIiIiIiIiIiI1cEFbFRQVFeHhw4cwNjausB1ViIiIiIiIiKhiCSGQkZEBW1tbaGhU3WQdJldU8PDhQ9jZ2VV3GERERERERESkgvv376NevXpVdj4mV1Qg3e3k5q1opTufEBEREREREVH1y8jIQDMnxyp/dmdyRQXSqUDGxsYwMTGp5miIiIiIiIiIqCRVvaQHdwsiIiIiIiIiIlIDkytERERERERERGpgcoWIiIiIiIiISA1MrhARERERERERqYHJFSIiIiIiIiIiNTC5QkRERERERESkBiZXiIiIiIiIiIjUwOQKEREREREREZEamFwhIiIiIiIiIlIDkytERERERERERGpgcoWIiIiIiIiISA1MrhARERERERERqYHJFSIiIiIiIiIiNTC5QkRERERERESkBiZXiIiIiIiIiIjUwOQKEREREREREZEamFwhIiIiIiIiIlIDkytERERERERERGpgcoWIiIiIiIiISA1MrhARERERERERqYHJFSIiIiIiIiIiNTC5QkRERERERESkBiZXiIiIiIiIiIjUwOQKEREREREREZEamFwhIiIiIiIiIlIDkytERERERERERGpgcoWIiIiIiIiISA1a1R0AERERkbqux2tW6fnesS+s0vMRERHR643JFSIiInotVHWCRB3qxMrEDBER0ZuHyRUiIiKqMjUpgVJZSroHTLwQERHVTEyuEBERUYViAqX8mHghIiKqmbigLRERERERERGRGjhyhYiIiMqMo1OqHke1EBERvb6YXCEiIiKlmECpOZh4ISIiql6cFkREREREREREpAaOXCEiInqLcXTKm4+jWoiIiCofR64QEREREREREamBI1eIiIjeYByZQiUp7f3BkS1ERESq4cgVIiIiIiIiIiI1cOQKERFRDcfRKVRZuF4LERGRajhyhYiIiIiIiIhIDRy5QkREVANwdAq9bjiqhYiI6F8cuUJEREREREREpAaOXCEiInpNcHQKvSk4qoWIiN42HLlCRERERERERKQGjlwhIiKqQhydQm87jmohIqI3EUeuEBERERERERGpgSNXiIiIKhhHpxCVD0e1EBFRTcWRK0REREREREREamByhYiIiIiIiIhIDZwWREREVA6c+kNUtThliIiIXmccuUJEREREREREpAaOXCEiIlKCI1OIao7SPq8c2UJERJWNI1eIiIiIiIiIiNTAkStERPTW4ugUorcD12shIqLKxpErRERERERERERq4MgVIiJ6o3F0ChGVhKNaiIioInDkChERERERERGRGphcISIiIiIiIiJSA6cFERFRjcepP0RUGThliIiIVMWRK0REREREREREauDIFSIiqhE4OoWIXicc1UJERC/jyBUiIiIiIiIiIjVw5AoREb02ODqFiN4EHNVCRPT24cgVIiIiIiIiIiI1cOQKERFVGY5MIaK3XWn/DnJkCxFRzcSRK0REREREREREauDIFSIiqlAcnUJEVH5cr4WIqGbiyBUiIiIiIiIiIjVw5AoREZUZR6cQEVU9jmohInp9MblCRERKMYFCRFRzMPFCRFS9OC2IiIiIiIiIiEgNHLlCRPQW4+gUIqI3H0e1EBFVPo5cISIiIiIiIiJSA0euEBG94Tg6hYiIisNRLUREFYPJFSKiGo7JEyIiqgyl/f+FyRcion8xuUJEVAMwgUJERK8bjnohIvoX11whIiIiIiIiIlJDjR65IpFI5H7X0tKCqakpbGxs0LZtW/Tp0wd+fn7Q0ir+MnNycrBw4ULs3LkT9+7dg4WFBXx9fbFgwQLUrVu3si+BiEiGo1OIiOhNwVEtRPS2kQghRHUHUV7S5EpAQAAAoKioCGlpabh9+zaio6MhhEDjxo2xbds2tG/fXqH/8+fP4eXlhfDwcNjY2MDd3R1xcXE4f/48rKysEB4ejkaNGiE9PR2mpqZ4kPAQJiYmVXqNRPRmYQKFiIioeEy8EJG60tPTUa+uLdLS0qr0+f2NSK4ou4TY2Fh89dVX2L17NwwMDPDXX3/B2dlZrs3s2bPxn//8B25ubvjtt99gZGQEAFi+fDmmTZsGDw8PnD59mskVIioTJlCIiIgqHhMvRKQKJlfKoaTkitTo0aOxbt06tGnTBpGRkbLyvLw81K5dG2lpaYiMjESbNm3k+rVu3RpXr17FxYsX0aRJEyZXiEgOEyhERESvDyZeiEiqupIrNXrNFVUsW7YMO3fuxN9//40///wTXbp0AQD89ddfSEtLg4ODg0JiBQAGDRqEq1ev4vDhw5g6dWpVh01EVYAJEiIiojeDOv9PZ2KGiCrCG59cMTU1Ra9evbBnzx6EhobKkitXrlwBALi4uCjtJy2/evVq1QRKRJWCCRQiIiIqCRffJaKK8MYnVwDA2dkZe/bswc2bN2Vl9+7dAwDUq1dPaR9peXx8fOUHSESlYpKEiIiIqlp5v38wKUP09nkrkiu1atUCAKSkpMjKMjMzAQAGBgZK+xgaGgIAMjIyKjk6ojcLkyBERET0tqus70NM2hC9vt6K5Ip0wVvpArjlFRUVJUu6ENUU91PNqzsEIiIiIqoA/9yt2vPZmaWU3ojoNZOVlVUt530rkitPnz4FAFhYWMjKpNsuZ2dnK+0jfUGMjY1lZb18e1ZWiERERERERERUQ70VyZW///4bANC8eXNZWf369QEADx48UNpHWm5vby8r++X4rxy5QkRERERERPSaysrKqpaBEW98ciUtLQ2//vorAMDLy0tW3rp1awBAZGSk0n7S8latWsnKWrZsWaX7ZBMRERERERGR6tLT06vlvBrVctYqNG3aNGRlZaFdu3Zwc3OTlXfu3BmmpqaIjY3F5cuXFfrt2bMHANCnT5+qCpWIiIiIiIiIaqA3Nrnyzz//4P3338e6detgaGiIdevWydXr6Ohg4sSJAIAJEybILXqzfPlyXL16FR4eHmjbtm2Vxk1ERERERERENcsbMS1oxIgRAICioiKkp6fj9u3buHXrFoQQaNKkCbZv346WLVsq9Js9ezZ+//13nD17Fk2aNIG7uzvi4+MREREBKysrrF+/voqvhIiIiIiIiIhqGomQ7lNcA726tbKWlhZMTExga2uLtm3bws/PD3379oWmZvH7zOfk5GDhwoXYvn077t+/DwsLC/j6+mLBggWoV68egBdztkxNTfEg4SHXXCEiIiIiIiJ6TaWnp6NeXVukpaVV6fN7jU6uVBUmV4iIiIiIiIhef9WVXHlj11whIiIiIiIiIqoKTK4QEREREREREanhtU2uHD9+HM7OztDT04NEIkFqamp1h0REREQEADh48CCcW7dCQkJCdYdCREREr4HXcreg5ORkDBkyBO+88w5Wr14NXV1dGBoaVndYREREVEESHjzA5s2bce7cOSQmPgEA2NrawrVdOwwaNBhNmzat5giJiIiIVPdaLmh7/Phx9OrVCydOnED37t2rOxwuaEtERFSB/ggLw4wZ06GlpYVevXvDsakjJBoSxN2Nw8mTv+PRo0c4euwX2NraVneoxSosLERBQQF0dHQUdi8kIiKi6lNdC9q+liNX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YWJiUvXBEREREREREVGp0tPTUa+uLdLS0qr0+b1S1lwhIiIiIiIiInpbMLlCRERERERERKQGJleIiIiIiIiIiNRQaQva1jRceoaIiIiIiIiIyoMjV4iIiIiIiIiI1MDkChERERERERGRGphcISIiIiIiIiJSA5MrRERERERERERqYHKFiIiIiIiIiEgNTK4QEREREREREamByRUiIiIiIiIiIjVoVXcANYEQAgCQkZFRzZEQERERERERUXGkz+3S5/iqwuSKCqQvTjMnx2qOhIiIiIiIiIhKk5ycDFNT0yo7n0RUdTqnBioqKsLDhw9hbGwMiURS3eGoLD09HXZ2drh//z5MTEyqOxyiKsX3P73t+Bmgtxnf//Q24/uf3nZpaWmoX78+UlJSYGZmVmXn5cgVFWhoaKBevXrVHUa5mZiY8B9Wemvx/U9vO34G6G3G9z+9zfj+p7edhkbVLjHLBW2JiIiIiIiIiNTA5AoRERERERERkRqYXHmD6erqYt68edDV1a3uUIiqHN//9LbjZ4DeZnz/09uM739621XXZ4AL2hIRERERERERqYEjV4iIiIiIiIiI1MDkChERERERERGRGphcISIiIiIiIiJSA5Mrb6CcnBzMnTsXTZs2hZ6eHmxtbfHxxx8jISGhukMjUlt2djYOHDiAUaNGwdHREXp6ejA0NETr1q3xzTffIDMzU6GPRCIp9cfb27saroao7Dw9PUt8Lx8/frzUY3Tv3l3W/sGDB1UQNVHFuXDhAoYMGQJbW1toa2vDzMwM7u7u2LBhA15dSjA6OhorVqzA0KFD4eDgIHvfx8XFVU/wRCq4dOkSFi1ahAEDBqBevXqy921pNm7ciPbt28PIyAgWFhbo3bs3zp49W2z73NxcLF68GC4uLjAyMoKuri4aNmyITz75BP/8809FXhKRysr6/j906BACAgLQsmVL1KpVC9ra2qhduzZ69+6NI0eOqHzeBQsWyM61devWcsXOBW3fMM+fP4eXlxfCw8NhY2MDd3d3xMXF4fz587CyskJ4eDgaNWpU3WESldvatWvxySefAACaNWuGFi1aID09HWfPnkVGRgacnJwQFhaG2rVry/qMGDGi2OMdPXoUT58+xdy5czF//vzKDp9IbZ6enggLC8PAgQNhZGSkUD9t2jS0bNmy2P4bN27EyJEjIZFIIITA/fv3Ua9e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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "h_q0.draw()" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Link your calibration to your circuit\n", + "\n", + "All that remains is to complete the registration. The circuit method `add_calibration` needs information about the gate and a reference to the schedule to complete the mapping:\n", + "\n", + " QuantumCircuit.add_calibration(gate, qubits, schedule, parameters)\n", + "\n", + "The `gate` can either be a `circuit.Gate` object or the name of the gate. Usually, you'll need a different schedule for each unique set of `qubits` and `parameters`. Since the Hadamard gate doesn't have any parameters, we don't have to supply any." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "circ.add_calibration('h', [0], h_q0)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Lastly, note that the transpiler will respect your calibrations. Use it as you normally would (our example is too simple for the transpiler to optimize, so the output is the same)." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "['id', 'rz', 'sx', 'x', 'cx', 'reset']\n" + ] + }, + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAdoAAADuCAYAAACeeMagAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAAAme0lEQVR4nO3dd3hUdb7H8fekFxLpRQIEAgiBEEJvEsIFCQiLqICKiMqirgrYgJX1UbKuAlKulIuwgmVFgXsVFUHBggKiLDWglIUQAiQmaGgpEEiZ+8eYgZg6kzmZmfB5PQ+PmZlTvrObzGfOrx2T2Ww2IyIiIobwcHYBIiIi1ZmCVkRExEAKWhEREQMpaEVERAykoBURETGQglZERMRACloREREDKWhFREQMpKAVERExkIJWRETEQApaERERAyloRUREDKSgFRERMZCCVkRExEAKWhEREQMpaEVERAykoBURETGQglZERMRACloREREDKWhFREQMpKAVERExkIJWRETEQApaERERAyloRUREDKSgFRERMZCCVkRExEAKWhEREQMpaEVERAykoBURETGQglZERMRACloREREDKWhFREQMpKAVERExkIJWRETEQApaERERAyloRUREDKSgFRERMZCXswsQMZvhar6zq3BNPp5gMjm7CimJ2Wzm0qVLzi7DJgEBAZj0C1XlFLTidFfzYdoaZ1fhmmaPBl/9lbqkS5cuUaNGDWeXYZOsrCwCAwOdXcYNR03HIiIiBlLQioiIGEhBKyIiYiAFrdzQkg99x4L7TezZMLfUbRbcb+LTuUOrsCoRqU4UtCIiIgZS0IqIiBhIQSsiImIgzdATAfKuXuJyZrqzyxCRakhBKwLs+Ogldnz0krPLEJFqSEErArSPeYRW3UeW+NrHswZWcTUiUp0oaEWAmg1b0bT9AGeXITe4hg0bEhAQgNlsJiMjg7Nnz1Z4Xy8vL5577jkWLFjA5cuXDaxSbKXBUG7kyy+/JDY2ljp16hAQEEBERAQzZ87k6tWrzi5NROwQGRnJrFmz+Oabbzh//jypqakcP36cxMRE0tPTSUlJYd26dUyfPp0mTZqUehwvLy/ef/99Zs6cyaeffoq/v38Vvgspj4LWTcybN49BgwaxadMmgoKCuOWWWzhy5AjTp08nJiZG32BF3Mjo0aPZvn078fHxTJs2jf79+1OzZs1i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0v+Rm2vH7VJEHKxnS/jqYNUuh2gCeumetC7h6aefpl69evj5+dl0X9ihQ4favXbxqlWr2LlzJ5cvX+ann36yq26juHzQgqXNff369cWez8rKIikpCQ8PD9q3b++EyqpOv379dJMCcRu1AqFjU9h3surO2S5Ed+5xFfYG3VtvvUWdOnV44oknbF67OCEhwWXXlneLoC3NwYMHMZvNtG7dusTO7w8//BCAQ4cOFXkcGhpKly5dqq5QkRvQHZ3gSCpcvmr8uXy94C79SVcLc+bMYenSpWRmZjq7FIdx66At/NZUWrNx4TyuPz4eN24c77zzjqG1idzobgqAOzvD+z/atl/h/NiKzLktdEdnDYKqTqpTyEI1D1o1tYo4V5fmkPgb/GhDi15F5tper2tz6BFm2z4iVcnlRx2XpbygFRHnMplgZFdLGBohqhnc00MjjcW1ufUVbeE6yCLiujw84N6eltWevj7kmJHIJiCmLQztaDm+iCtz66AVEffgYYLbO1pGBq/6Ec5k2H+sekFwX09oXv50dhGXoKAVkSoTWheeGwK7T8D3RyHlfMX3bVQT+rS2NEP76JNL3Ih+XUWkSnl7Wha06BEGJ89apgAln4PTZy0jjc1YmoaD/C3rFofUhlsaWq5g1Rcr7khBKyJOYTJZrnBD6157zmyGArOlqVmhKtWFglZEXIbJBJ4KWKlmNF5PRETEQApaERERAyloRUREDKSgFRERMZAGQ4mIiM0CAgLIyspy2PHmLFtNRvYlggMDmPLoPcUeO0JJd3mrCgpaERGxmclkIjDQcbdM8vH1wyc3Hx9fPwIDA4s9dmdqOhYRETGQglZERMRACloREREDKWhFREQMpKAVERExkIJWRETEQApaERERAyloRUREDKSgFRERMZCCVkRExEAKWhEREQMpaEVERAykoBURETGQglZERMRACloREREDKWhFREQMpKAVERExkIJWRETEQApaERERAyloRUREDKSgFRERMZCCVkRExEAKWinXnDlz6NmzJ7Vq1aJmzZr06dOHjRs3OrssESnH559/TseOHfH19SU0NJT58+c7u6QqtXXrVoYPH06zZs0wmUz84x//cEodClop1+bNm3n44Yf59ttv2blzJ7169WLo0KFs377d2aWJSCl2797N8OHDGTx4MPHx8cyYMYPp06ezdOlSZ5dWZbKysggPD+e1116jYcOGTqvDy2lnFrfxxRdfFHn82muvsXHjRtauXUvv3r2dVJWIlGX+/Pl07dqVmTNnAtC2bVsOHjzIrFmzeOyxx5xcXdUYMmQIQ4YMAWDatGlOq0NBKzYrKCggIyODwMBAZ5ci4nYuZmZzJv18sefz8vOt/z16IrnY4+s1a9wAXx/vMs+zfft2xo8fX+S52NhY5s6dS3JyMiEhIZV5G3YrMJs5npSC+Q/P2/L+awXXoF6dmlVQrWMoaMVmr776KhcuXOCRRx5xdikibsfXx5uPvtjCxczsEl+/dDmHt/7381IftwoNoeWoweWeJzU1tVhzaeHj1NRUpwWth8nEkcRTbN/9c4mvl/f+vb08mfTQXYbX6UjqoxWbLFmyhFdffZUPP/zQaX+oIu7Mz9eHUbfH2LWvv58vdw+JxsNkcnBVVSu2bzfq23lFOiSmB/Vq27evsyhopcLmzp3LlClTWLduHQMGDHB2OSJuK6zZzfTpEmHzfnfc1oebgirWZdOoUSPS0tKKPHfmzBnra87k7e3F6KH98fCw7QtD6+Yh9IgKN6gq4yhopUJefPFF4uLi+PzzzxWyIg4wKLor9evUqvD2kW3DiGwbVuHte/fuzaZNm4o8t3HjRpo1a+YSrVGNG9ZlQO/OFd7e38+XuwdHY3LDq3kFrZTrqaeeYs6cObz33nvccsstpKWlkZaWxsWLF51dmojb8vbyYvSwGDw9yv8YDq4RyPDb+th0/KeffpqdO3fyt7/9jSNHjvDuu++yaNEi/vrXv9pbssNF9+hI05sbVGjbEbf1IbiCV/OFsrKyiI+PJz4+nqtXr5KWlkZ8fDwJCQn2lGs3k9ls/uPgL5EiSvsGOW7cON55552qLUakmvn2x31s2rqrzG3Gjx5Cq1Dbr0I3bNjA9OnTOXLkCA0bNmTy5Mk888wz9pZqiPTzF1n49kdczc0rdZuO4S25Z1h/m4/93XffERNTvD88Ojqa7777zubj2UtBKw517mIm+fn5bjdYQcRZCgoKWPbBZ5xMOVPi6706t+dPA3pVcVVV69/xh/l407YSX7spKJCnHr4bfz/fKq7KcdR0LA61actO5i//P7bvKXnovogU5eHhwajbY/DxLj7bsl7tmgyO7uaEqqpWt8g2tAlrWuJrI4f0c+uQBQWtONCv6ec5cPg4ZrOZ0BDnLXcm4m7q1ApmaP+eRZ7z8DAxemgM3iUEcHVjMpm4K7YvAf5FA7V35/a0DG3spKocR0HrZvLz83nvvfe47bbbqFevHr6+vjRt2pTY2FiWL19O/u+rqTjDNz/sxQyEtwqlcYO6TqtDxB11/cNV3X/16kxIo3pOrKhqBdUI4M5Bfa2P69epSWw1uZpX0LqRjIwMBg4cyAMPPMBXX32Fj48PkZGRFBQU8OWXXzJhwgQyMzOdUlvh1SzAf/Xu5JQaRNyZyWTirsF9CfT3o0mj+vTr2dHZJVW59rc0p1P71r9fzfevNlfzGgzlRkaOHGldkelf//pXkdF0Z86cYcWKFUyePNnmNYgXvbuWzKzLlartUk4OeXn5eHl6EuDvV6ljidzI8vLz8PDwwMN0Y14HmTGTl5uHt3fZazlXtaAa/kwcd6dd+ypo3cSePXvo0qULXl5e7Nu3j/bt2zvs2K/+z/tkZJW87qqIiFjmMk9/Yoxd+1aP6/IbwCeffALA7bff7tCQBcs3tcrQ1ayIVHeV+ZxU0LqJQ4cOAdCzZ89ytrSdvc0hAL+evcB/L/9fAP4ydrgGQYmI/IGC1k1kZGQAcNNNNzn82JXpo72Uk4MZ8PL05N0PN5W7vYiIO6pMH62C1k0EBwcDGLK+cGbW5Ur30ebl56ufV0SkBApaN9GuXTvWrl3Ljz/+6PBj29v3oL5ZEblRVKaPVqOO3cS+ffvo1KkT3t7exMfHEx7u3HsyFvbNmoGJD96pvlkRkVLcmBO13FBUVBSjRo0iNzeXwYMHs2XLliKvnzlzhpkzZ5KdXTXNt5u1CpSISIXoitaNZGRkMHz4cOvtnRo3bszNN99MamoqKSkpmM1mzp8/T82aNQ2tQ1ezIiIVpytaNxIcHMzXX3/NihUr6NevH5cuXWL//v14eHgwaNAgVqxYQVBQkOF1XM3NpXHDerqaFRGpAF3Ril3MZjNXrubi5+vj7FJERFyaglZERMRAajoWERExkIJWRETEQApaERERAyloRUREDKSgFRERMZCCVkRExEAKWhEREQMpaEVERAykoBURETGQglZERMRACloREREDKWhFREQMpKAVERExkIJWRETEQApaERERAyloRUREDKSgFRERMZCCVkRExEAKWhEREQMpaEVERAykoBURETGQglZERMRACloREREDKWhFREQMpKAVERExkIJWRETEQApaERERAyloRUREDKSgFRERMZCCVkRExEAKWhEREQMpaEVERAykoBURETGQglZERMRACloREREDKWhFREQMpKAVERExkIJWRETEQApaERERA/0/oLOftT/vDJUAAAAASUVORK5CYII=", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "from qiskit import transpile\n", + "from qiskit.providers.fake_provider import FakeHanoi\n", + "\n", + "backend = FakeHanoi()\n", + "\n", + "circ = transpile(circ, backend)\n", + "\n", + "print(backend.configuration().basis_gates)\n", + "circ.draw('mpl', idle_wires=False)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Notice that `h` is not a basis gate for the mock backend `FakeHanoi`. Since we have added a calibration for it, the transpiler will treat our gate as a basis gate; _but only on the qubits for which it was defined_. A Hadamard applied to a different qubit would be unrolled to the basis gates.\n", + "\n", + "That's it!\n", + "\n", + "### Custom gates\n", + "\n", + "We'll briefly show the same process for nonstandard, completely custom gates. This demonstration includes a gate with parameters." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "from qiskit import QuantumCircuit\n", + "from qiskit.circuit import Gate\n", + "\n", + "circ = QuantumCircuit(1, 1)\n", + "custom_gate = Gate('my_custom_gate', 1, [3.14, 1])\n", + "# 3.14 is an arbitrary parameter for demonstration\n", + "circ.append(custom_gate, [0])\n", + "circ.measure(0, 0)\n", + "\n", + "circ.draw('mpl')" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "with pulse.build(backend, name='custom') as my_schedule:\n", + " pulse.play(Gaussian(duration=64, amp=0.2, sigma=8), pulse.drive_channel(0))\n", + "\n", + "circ.add_calibration('my_custom_gate', [0], my_schedule, [3.14, 1])\n", + "# Alternatively: circ.add_calibration(custom_gate, [0], my_schedule)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If we use the `Gate` instance variable `custom_gate` to add the calibration, the parameters are derived from that instance. Remember that the order of parameters is meaningful." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "circ = transpile(circ, backend)\n", + "circ.draw('mpl', idle_wires=False)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Normally, if we tried to transpile our `circ`, we would get an error. There was no functional definition provided for `\"my_custom_gate\"`, so the transpiler can't unroll it to the basis gate set of the target device. We can show this by trying to add `\"my_custom_gate\"` to another qubit which hasn't been calibrated." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "\"Cannot unroll the circuit to the given basis, ['id', 'rz', 'sx', 'x', 'cx', 'reset']. Instruction my_custom_gate not found in equivalence library and no rule found to expand.\"\n" + ] + } + ], + "source": [ + "circ = QuantumCircuit(2, 2)\n", + "circ.append(custom_gate, [1])\n", + "\n", + "\n", + "from qiskit import QiskitError\n", + "try:\n", + " circ = transpile(circ, backend)\n", + "except QiskitError as e:\n", + " print(e)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Building pulse schedules\n", + "\n", + "Pulse gates define a low-level, exact representation for a circuit gate. A single operation can be implemented with a pulse program, which is comprised of multiple low-level instructions. Regardless of how the program is used, the syntax for building the program is the same. Read on to learn how!" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "**Important:** For IBM devices, pulse programs are used as subroutines to describe gates. IBM devices do not accept full programs in this format. " + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Pulse programs, which are called `Schedule`s, describe instruction sequences for the control electronics. We build `Schedule`s using the Pulse Builder. It's easy to initialize a schedule:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "ScheduleBlock(, name=\"my_example\", transform=AlignLeft())" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "from qiskit import pulse\n", + "\n", + "with pulse.build(name='my_example') as my_program:\n", + " # Add instructions here\n", + " pass\n", + "\n", + "my_program" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "You can see that there are no instructions yet. The next section of this page will explain each of the instructions you might add to a schedule, and the last section will describe various _alignment contexts_, which determine how instructions are placed in time relative to one another." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### `Schedule` Instructions\n", + "\n", + " - [delay(duration, channel)](#delay)\n", + " - [play(pulse, channel)](#play)\n", + " - [set_frequency(frequency, channel)](#set_frequency)\n", + " - [shift_phase(phase, channel)](#shift_phase)\n", + " - [acquire(duration, channel, mem_slot, reg_slot)](#acquire)\n", + "\n", + "Each instruction type has its own set of operands. As you can see above, they each include at least one `Channel` to specify where the instruction will be applied.\n", + "\n", + "**Channels** are labels for signal lines from the control hardware to the quantum chip.\n", + "\n", + " - `DriveChannel`s are typically used for _driving_ single qubit rotations,\n", + " - `ControlChannel`s are typically used for multi-qubit gates or additional drive lines for tunable qubits, \n", + " - `MeasureChannel`s are specific to transmitting pulses which stimulate readout, and\n", + " - `AcquireChannel`s are used to trigger digitizers which collect readout signals.\n", + " \n", + "`DriveChannel`s, `ControlChannel`s, and `MeasureChannel`s are all `PulseChannel`s; this means that they support _transmitting_ pulses, whereas the `AcquireChannel` is a receive channel only and cannot play waveforms.\n", + "\n", + "For the following examples, we will create one `DriveChannel` instance for each `Instruction` that accepts a `PulseChannel`. Channels take one integer `index` argument. Except for `ControlChannel`s, the index maps trivially to the qubit label." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "from qiskit.pulse import DriveChannel\n", + "\n", + "channel = DriveChannel(0)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The pulse `Schedule` is independent of the backend it runs on. However, we can build our program in a context that is aware of the target backend by supplying it to `pulse.build`. When possible you should supply a backend. By using the channel accessors `pulse._channel()` we can make sure we are only using available device resources." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "5\n" + ] + } + ], + "source": [ + "from qiskit.providers.fake_provider import FakeValencia\n", + "\n", + "backend = FakeValencia()\n", + "\n", + "with pulse.build(backend=backend, name='backend_aware') as backend_aware_program:\n", + " channel = pulse.drive_channel(0)\n", + " print(pulse.num_qubits())\n", + " # Raises an error as backend only has 5 qubits\n", + " #pulse.drive_channel(100)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### `delay`\n", + "\n", + "One of the simplest instructions we can build is `delay`. This is a blocking instruction that tells the control electronics to output no signal on the given channel for the duration specified. It is useful for controlling the timing of other instructions.\n", + "\n", + "The duration here and elsewhere is in terms of the backend's cycle time (1 / sample rate), `dt`. It must take an integer value.\n", + "\n", + "To add a `delay` instruction, we pass a duration and a channel, where `channel` can be any kind of channel, including `AcquireChannel`. We use `pulse.build` to begin a Pulse Builder context. This automatically schedules our delay into the schedule `delay_5dt`." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "with pulse.build(backend) as delay_5dt:\n", + " pulse.delay(5, channel)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "That's all there is to it. Any instruction added after this delay on the same channel will execute five timesteps later than it would have without this delay.\n", + "\n", + "### `play`\n", + "\n", + "The `play` instruction is responsible for executing _pulses_. It's straightforward to add a play instruction:\n", + "\n", + "```\n", + "with pulse.build() as sched:\n", + " pulse.play(pulse, channel)\n", + "```\n", + "\n", + "Let's clarify what the `pulse` argument is and explore a few different ways to build one.\n", + "\n", + "#### Pulses\n", + "\n", + "A `Pulse` specifies an arbitrary pulse _envelope_. The modulation frequency and phase of the output waveform are controlled by the `set_frequency` and `shift_phase` instructions, which we will cover next.\n", + "\n", + "The image below may provide some intuition for why they are specified separately. Think of the pulses which describe their envelopes as input to an arbitrary waveform generator (AWG), a common lab instrument -- this is depicted in the left image. Notice the limited sample rate discritizes the signal. The signal produced by the AWG may be mixed with a continuous sine wave generator. The frequency of its output is controlled by instructions to the sine wave generator; see the middle image. Finally, the signal sent to the qubit is demonstrated by the right side of the image below.\n", + "\n", + "**Note**: The hardware may be implemented in other ways, but if we keep the instructions separate, we avoid losing explicit information, such as the value of the modulation frequency.\n", + "\n", + "![alt text](pulse_modulation.png \"Pulse modulation image\")\n", + "\n", + "There are many methods available to us for building up pulses. Our `library` within Qiskit Pulse contains helpful methods for building `Pulse`s. Let's take for example a simple Gaussian pulse -- a pulse with its envelope described by a sampled Gaussian function. We arbitrarily choose an amplitude of 1, standard deviation $\\sigma$ of 10, and 128 sample points.\n", + "\n", + "**Note**: The amplitude norm is arbitrarily limited to `1.0`. Each backend system may also impose further constraints -- for instance, a minimum pulse size of 64. These additional constraints, if available, would be provided through the `BackendConfiguration` which is described [here](https://qiskit.org/documentation/tutorials/circuits_advanced/08_gathering_system_information.html#Configuration)." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "from qiskit.pulse import library\n", + "\n", + "amp = 1\n", + "sigma = 10\n", + "num_samples = 128" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "##### Parametric pulses\n", + "Let's build our Gaussian pulse using the `Gaussian` parametric pulse. A parametric pulse sends the name of the function and its parameters to the backend, rather than every individual sample. Using parametric pulses makes the jobs you send to the backend much smaller. IBM Quantum backends limit the maximum job size that they accept, so parametric pulses may allow you to run larger programs.\n", + "\n", + "Other parametric pulses in the `library` include `GaussianSquare`, `Drag`, and `Constant`.\n", + "\n", + "\n", + "**Note**: The backend is responsible for deciding exactly how to sample the parametric pulses. It is possible to draw parametric pulses, but the samples displayed are not guaranteed to be the same as those executed on the backend." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "gaus = pulse.library.Gaussian(num_samples, amp, sigma,\n", + " name=\"Parametric Gaus\")\n", + "gaus.draw()" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "##### Pulse waveforms described by samples\n", + "\n", + "A `Waveform` is a pulse signal specified as an array of time-ordered complex amplitudes, or _samples_. Each sample is played for one cycle, a timestep `dt`, determined by the backend. If we want to know the real-time dynamics of our program, we need to know the value of `dt`. The (zero-indexed) $i^{th}$ sample will play from time `i*dt` up to `(i + 1)*dt`, modulated by the qubit frequency." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAvIAAACgCAYAAABuQoiZAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8o6BhiAAAACXBIWXMAAAsTAAALEwEAmpwYAAAkP0lEQVR4nO3dd7xcVb338c83CSFACpByRVoA6RFJAkICSpVHkN5BSoB7H0ARBREv9SKCSrVQFK6EgEoTgoChSAstFAnxoUkgSAICSkIKIQkt+T1/rDXJzs45c+YcThvyfb9e85qz116zZu09+5zz22v/9hpFBGZmZmZmVl+6dHQHzMzMzMys+RzIm5mZmZnVIQfyZmZmZmZ1yIG8mZmZmVkdciBvZmZmZlaHHMibmZmZmdWhJgN5SWdJCkn3NLDuZklj26RnbUjSDnmbti6VH5vLTy+Vr5vLD87LlX1SftxXw3uvLelKSZMlfShplqRxkk6S1LN1t7T1SBpR2M4Fud/PSvqFpHU6oD/d8+ewaal8YO7jru3dp1I/zpB0n6T3cn8GNlDnaEn3Svp33p+PSdqpgXqrSLpa0puS3pc0QdI3a+zHHpKek/SBpBclHdDC7RmUt2PbvNzg/jczM7P205wR+Z0kbd5mPWlfTwLzgeGl8uHA3EbKAR4rlM0ChpUe36n2pvnE4W/AZsC5wE7AwcDjwJnAD5u3GR1ie9L+2Ae4irQNz0rauZ370R34H2DTUvnbpM/i0XbuT9nRQDfgwSp1TgNey3X3BSYBd0vavVJBUhfgdmAb4GRgD+AJ4PeS9q7WgXy83ZL7sDMwBri+oZOFFmhs/5uZmVk76VZjvenAm6TAY8826007iYj3JT3LkgH7MOBa4ABJikXfljUceDMiphTqfhIRT9T6npKWA24kBWHfiIiPC6vHSLoQqIcTpb9GxPv55/sk/Qb4M3CdpIERMaulDUsSsGxEfNDSNiLiQ9I+7mhrRMSCfGVg90bqDImIaYXleyWtC5xACt4B1iOd+O0eEXfksvslbQEcAIyu0oczgIcj4vi8/KCkjUknjX9p/iaZmZlZZ1LriHyQRpB3l/TFxirlFICRkv4haZ6klyWdI6l7oU4l9eHAnC7wnqR/Sjokrz9Z0luSpko6L49IFt9jkKQxkmbnxx8lfa4F2z6OFLhX2h0ArAP8EugNbFioOzzX/zT2Bz4PnFAK4gGIiLcjohK8IWmYpNslvS1pjqS/ldMpcmrDtHJbef8eV1jeXdL43M4MSU9K2uZTbk+l3x8CxwMrAgfl92swvUXSKElPl/svaWtJfwU+APaTtIKkSyVNlDRX0muSLpPUu9Dc7Px8dSHlZ2BD7y2pa36v15XSmV5QTpMq903S15RShuZIejQHvi3ZLwtqqLPEZwdMIB0nFcvk5/IJ0kxAjbUtaVlgO+Cm0qobgGGS+lTrm6RvSXoj74c7gFVKVRrc/9XaNDMzs9bVnNSaPwKvkEblG9OPNHp/IvB14ALgCOCSBuqeR0qD2Ad4BLhG0kXAl4EjgV+QUgn2r7xA0hdI6S09gEOAEcDGwB15NLdSb7KkUU1szzhgQG4TUlD/ZkS8BCwcrc8Bz0YsnlZTeZ9upUejgRXw1dz+C030q2LN/J5HAbuRUiSulnRQja+v9HEd4GbggdzON0kj6Cs3p51qIuLvwD+BLVvw8uWBa4Dfko6Zp3JZV9KxtjNpZHl70jFYsX1+PodFqU1vN/IeZ+e2riSNjj8G/KGBfbkG6Zg9l3RSMgC4sXRsjZI0uQXbWathwMuF5edJqWBnK92r0VvSCGAr4DdV2lmHdBLwUqn876Tf+/Uae6GkPYDLSMfJ3sBzwMhStebsfzMzM2sDtabWkNMEfgpcJenMiHi5gTrPASdVliU9BswBRkr6TkR8VKj+QEScmus9ScoR3h3YICLmk3KF9wD2Io0iQsrJ/Rewc6UtpRSZl4BdSDnAAJ+QcuCrqQTmw0m5ycNJuerk5+Gk4HJLUuBTHpHvC5RH1r8GNHbD6+eBN8qFkoqfQeRtJyJuKNQR8DCwGvBfwPVVtqtsMDA7In5QKLuzGa+v1T+B/2jB65YDToyI20rlx1Z+yPvoNeBRSWtExOvAX/PqV4spTuVzKUkrA98DzomIc3LxPZJWA85i8X25MrBVRLySX9sFuBVYn0UB8XzS8dXqJB1J+ry+XymLiFC6/+A2FgX4HwNHRMQDVZpbKT/PLJXPKK1vyGnA3RFR+QzukdQf+M9CnQb3v5mZmbWf5k4/+XvgdeCUhlYq+Z7S7BjzSAHHH4BlSaOdRfdXfoiI94CpwEOVQDabBKxaWN6RFFgtqIyCkwK8yaQ84kp7X4iIo6ptSM53f5NFefLFQP6JUvlcUspD0SxSTnvx8WS19ySlKC0kqR9pH1UeTxbWrSTpV5KmFNb/X6qMpDbiOaCPpGsk7SRphWa+vlbVrkZUE8BdSzQmHao0O8v7pG2v3Lza3O0fRBrh/2Op/EZgvRygVkyuBPHZi/l5tYWdjTgqIr5AK5M0lHTl6pcR8WChvAvpvo2+pJz47UhXq66S9PU26Ec3YAjpxKGoWi6+mZmZdYBmBfIR8QlwPnCIpDUbqPI94EJSsL0HKU3m23ldj1LdmaXljxopK76uH2lml49Lj7WB1WvekEUeB4ZLWoZ0IjCuUL6epL6kQP6pvO1Fn0TE06XHbBr3FoWAMJvJopOAP5fWjSIFbheQZobZnJTeUN6PVUXERNJnsTZpJH6apOtKAWxrWBX4dwteN6N0pQZJe5GC18eB/UhXRfbKq5u1/SzK7S73rbJcTDGaWapT6Vdz37NZJK1Nupp0P4XR+GzX/NgzIm6KiLERcTLpd+z8Ks1WRt7LufArldaX9SOlNb1TKi8vm5mZWQerObWmYCRwOg1PlbgfcHNELMyjl7RRC/vWkOmkAOa3Daxr6MbBpjxGygHehjSi/AxARExSuol0K2ALGs7xb66HgSMlbZhzyisnRk8DSHqXHHRK6kEK3r4dEQvzoFW68Zd0c2j3YoGkJVImImIMaWacPsA3SCO6lwAHtsJ2IWlD0klK5YpGZdaZ7qWqDaVzRANl+wFPRsS3Cu/R0ptzK3nbA4B3C+WVNKDpLWy3VSjdZH0PMAU4sHRFCmADYG7pSgGkK0SNzYYD8CrpJHcD4KFSewtYPA+/aBopfWhAqby8bGZmZh2s2d/smmcpuZB0Q2p5JovlgA9LZTV9cU2N7ifd3Dq+gdHwyS1obxxpH5wAPFMaGX6CNL93Lxq40bUFbiKNyl+crwBUs2zu18J9KakXSwZu/wR6SSqmHzU6R3hEzIqI60gnQ61ygpVnR/kVaTS7ktf/DimI3LBQrydLTvfZmFqOo1pHy58npUbtVyrfH3g5IqbW2KdWl/dJ5X6FXSNibgPVpgDLS1q/VD6UlFLWoPx7+iBLbvcBwOONTROaTy4nkK7iFJXnrG+XqxVmZmbWuJaMyANcAZxKCsyKo333Asfnm1dfJQVfrZlPfBZpVpMxkkaSRg9XJd1kOioixgJImkTKt6+aJ08KWOaRZkb5eWnd46TZS4JFI80tFhHzJB1ISqF4Qmn+9YmkQOiLwA6kfUZEzFKajvFMSe+RRlD/m5SXX5yC8e7c/5F5xp+1gGOK7yvpaNKMIneTTiTWJQV31xbqjAK2jYiBNWzK5vn+h+VJ+edHk2bY2a8SHOYbo28DTsg5/jNJKSPzamgf0nF0maTTSPcN7ELaPwtFxEeSXgP2l/Q86SrAs+WGImK6pF8Ap0uqXAHZO7fZrBmAACRdBWzTVJ58voLQnxRwA+wsaSrwYkRUcu9HA5uQZl9aR4VvyC3cQHon6b6UP0k6m3QvyTdIJyKVtDUkHUa6WrZO4fsOfgyMzdv/p7zNu5BmB6rmJ8BoSb8mnfRtU35NY/u/nCZlZmZmbadFgXxEzJX0c1KgW3Q2KXipzA4ymjTH+B20goh4WdKWuf0rSSO3b5JG6icVqnYj5fk21d7HOWD+KksG64+T0m1ejIjG8ombJSIekTSYFJSfTrqiMQ94gTR/fXE6wYNJJ0zXklJCLiUFz8cV2psmaR/SFZI/AePz614stPMsaST/YlI++NvA/5K+FKhieWrPga7MlPI+aUT4PuBXEfFqqd5xpM/oclI+9rmkE79BNbzHFaSc/u+STnTuJW1XeXaUY0jbfh/pKsZajbR3JmmmmWNJKTWTgEOKMwM1Q1dq+735ESkArri8UH5W/vlr+fkPDbxeABExW9IOwE+Bi0gncq+Stv3KQv0uuW8LbzqOiEcl7Uv6fTmWdGP4wRFR9cugIuJWSd8hHaeHA2NJ06DeU6ra0P6fXK1tMzMzaz1a9OWltrTKo+ZnRsQ1Hd0XMzMzM6tNs3Pk7bMl59cvQ/PmpjczMzOzDuYReTMzMzOzOlQ117dvv36x5hrl73EyMzMzM7PmmDBhwrSIaNXv8akayK+5xho89PAjrfl+ZmZmZmZLnd69ek5pulbzOEfezMzMzKwOOZA3MzMzM6tDDuTNzMzMzOqQA3kzMzMzszrkQN7MzMzMrA45kDczMzMzq0MO5M3MzMzM6pADeTMzMzOzOuRA3szMzMysDjmQNzMzMzOrQw7kzczMzMzqkAN5MzMzM7M65EDezMzMzKwOOZA3MzMzM6tDDuTNzMzMzOqQA3kzMzMzszrkQN7MzMzMrA45kDczMzMzq0MO5M3MzMzM6lC3ju6AmZl9Oi9M6bpE2cZrzu+AnpiZWXtyIG9m1kk1FKC39msd8JuZ1S8H8mZmHezTBOxt9d4O8M3MOj/nyJuZmZmZ1SGPyJuZtaOOHH1vDufdm5l1fg7kzczaSL0E7bVycG9m1rk4tcbMzMzMrA55RN7MrBV81kbfa+VRejOzjuMReTMzMzOzOuRA3szMzMysDjm1xsysmZbWNJpaOd3GzKx9eETezMzMzKwOeUTezKwKj763Do/Sm5m1Po/Im5mZmZnVIQfyZmZmZmZ1yKk1ZmaZ02jal9NtzMw+HY/Im5mZmZnVIY/Im9lSxyPvnVdjn41H6s3MluQReTMzMzOzOuRA3szMzMysDjm1xsw+05xG89ngG2PNzJbkEXkzMzMzszrkEXkz+8zw6PvSxaP0Zra084i8mZmZmVkdciBvZmZmZlaHnFpjZnXJaTTWEKfbmNnSxCPyZmZmZmZ1yCPyZtbpefTdPg2P0pvZZ5VH5M3MzMzM6pBH5M2sU/Hou7UHj9Kb2WeBR+TNzMzMzOqQR+TNrEN45N06G4/Sm1m98Yi8mZmZmVkd8oi8mbU5j75bvWrs2PVIvZl1Bh6RNzMzMzOrQx6RN7NW5dF3Wxo4n97MOgMH8mbWYg7azRZxcG9m7c2BvJnVxEG7WfM5uDeztuRA3syW4KDdrO04uDez1uJA3mwp56DdrOM5uDezlnAgb7aUcMBuVl889aWZNcWBvFmdc4ButnSp9XfeAb/ZZ58DebNOwMG4mbW2T/N3xScBZvXBgbxZJ+B/mmZmZtZc/mZXMzMzM7M65EDezMzMzKwOOZA3MzMzM6tDDuTNzMzMzOqQA3kzMzMzszrkQN7MzMzMrA45kDczMzMzq0OeR97MrA1cddVveWb8eC67/NcLy3bbbVfWWH31Jcq+/a1v8/Wdd2bTL21Cjx49kARA127dePTRxxpsf+rUqVx++WU8+sgjvP/++6y88soMGTqUI488irXWWqttN87MzDoFB/JmZm1gyJChXD1yJPPnz6dr165MnTqVTz75hJdeemmxsjdef50hQ4cufN1Nf7yZNdZYo2rbM2fO5PDDDuVLm27KyKtHsdpqqzF79mweeOABnnj8cQfyZmZLCafWmJm1gUGDBvHJJ58wceJEAJ555hk232xzBg4cuFjZ6quvzoABA5rV9u9//zt69uzJuef+hNVXXx1J9O7dmz333JODDj54Yb2TTvo+O2y/HVtvNZwjjxjBpEmTFq476qgjGT36loXLt912GyMOPxyAiOCCC85nu223Yavhw9h3n72Z9MorLd4XZmbWNhzIm5m1gWWWWYZBg77I+PHjAXhm/HiGDBnCpoMHl8qGVmumQU8+8QTbbb89XbpU/xO+9VZbc/sdf+aBB8eywYYbcuqpp9TU/uPjxvHM+PHcdvsdPPrYOM6/4EL6rLhis/tpZmZty4G8mVkbGbrZUJ7JQfuECc8weMgQhgwZsljZ0M0WD+QPOvAAtt56K7beeivO+9nPGmx35syZ9Ovbb+Hy2LEPsvXWWzF82JYcc/TRC8v33GsvVlhhBbp3784xxxzLyxMnMnv27Cb73a1bN+bMmcvkya8REay99tr079+/2dtvZmZtyznyZmZtZOiQodx0443MmjWLGTNmsOaaa9K3b1/OOP10Zs2axaRJkxhaGpG//oYbm8yR79OnD1OnTV24vO222/Hoo48xevQtjBkzBoD58+dz6SWXcO+9f2HGjBkoj97PnDmTXr16VW3/y1tswYEHHshPf/IT3n77bbbfYQdOPPH79OzZsyW7wczM2ohH5M3M2sgmX/oSs2fPZvQtt/ClTTcFoGfPnvTvP4DRt9xC//79WXW11Zrd7pe32IKxDz7IggULGq1z1513Mnbsg1xxxZU8+tg47rzzLiDlvwMst9xyfDDvg4X13502bbHXH/zNb3L9DTcyevStTJkyhWtGjWp2P83MrG05kDczayM9evRgo4035ne/u5Yhg4csLB88eHAqG9r8/HiAQw89jPfee4/TTjuVN954g4hgzpw5THxp4sI6c+bOYZnu3emz4op8MG8el1zyq8XaWH/99bn/gfuZN28er7/+Orf+6daF655//nmee/ZZPv74Y5ZbbjmW7d4ddVGL+mpmZm3HgbyZWRvabOhmTJ8+ncFDBi8sGzxkCNOnT18iraZWK620Etf+7vcs231ZjhhxOMOHbckB++/HnLlzOO200wHYbbfd+fwqq7DT13Zk7733YpNNNlmsjUMOOZRlui3DDttvxxlnnM4uu+yycN2cOe9z9tk/4qtf2Zqdd/46fVZckREjjmhRX83MrO2ocpm1IUOGDImHHn6kHbtjZmZmZvbZ07tXz/ERsVlrtukReTMzMzOzOuRA3szMzMysDjmQNzMzMzOrQw7kzczMzMzqkAN5MzMzM7M65EDezMzMzKwOOZA3MzMzM6tDDuTNzMzMzOpQ1S+EkjQVmNJ+3WlQP2BaB/fB6oOPFauFjxOrlY8Vq4WPE6vV+hHRqzUb7FZtZUT0b803awlJT7f2t2DZZ5OPFauFjxOrlY8Vq4WPE6uVpKdbu02n1piZmZmZ1SEH8mZmZmZmdageAvkrO7oDVjd8rFgtfJxYrXysWC18nFitWv1YqXqzq5mZmZmZdU71MCJvZmZmZmYlnTKQl7SRpPslzZX0lqSzJXXt6H5Zx5G0n6TbJb0p6X1J4yUdVFg/UFI08pjYkX239iVpRCPHwTGN1P95Xn9he/fVOpakAyU9k/+mvCnpWkmfL9X5lqQxkt7Nx8m2HdNbay+SviDpCknPSpovaWwDdSTpVElvSJon6WFJmzZQr8ljzOpTU8eJpO6SbpL0j3yMTJV0l6ShVdpcNR8rIalnLf2oOv1kR5C0EnAf8CKwB7AOcBHppOP0DuyadawTgdeAE0jz9e4CXCepX0RcArwNDCu9ZjngL8Bd7dlR6zS2B+YVlv9RriBpI+Ao4L326pR1DpJ2B64HLgN+AKwCnAOMkTQ0IhbkqocBAdwDHNRQW/aZszHpf8wTwDKN1Plv4AzSsfMS6X/UfZIGRcS/oFnHmNWnpo6TrqS/HT8FXgV6k2KYByQNjogl/icBFwDvAyvU2olOlyMv6RTgZGDNiHgvl50MnAV8rlJmS5ccsE8rlV0HDIuItRp5zX7ATcCWEfFkO3TTOgFJI4CrgV4R8X4Tde8HxgGHAjdHxElt30PrDCTdAKwbEUMLZbsDtwEbRcTfc1mXiFggaRDwHLBdRIztiD5b+6h85vnnm4F+EbFtYX0P4N/ARRFxdi5bAZgMXBERp+eymo4xq09NHSeNvKYn8C5wSkRcXFr3VeBPwE9IAX2T/8Ogc6bW7AzcUwrYbyCNrm7TMV2yjlYO4rMJQLVLlAcB/3AQbw2RtC+wAfCzju6LdYhlgFmlspn5WZUCj5oufWr4zIeTRldvKrxmDnAHKYapqOkYs/rUwr8Nc4APgO7Fwpw+fglwNs38luDOGMhvQLpMtVBEvA7MzevMKoYBLze0QlJv0h/UG9q1R9aZvCrpE0kTJR1dXCFpOVLK3n/nf8C29BkJfEXSYZJ6S1qPlPbwQES82MF9s85tA2A+8Eqp/O8sHqf4GLPK/RTdJH0OOJ907FxfqnYMsCwpDatZOmMgvxKLzliLZuR1ZkjaAdiTFIw1ZE+gBw7kl0Zvk3JXDwV2I+Uv/kbSCYU6p+R6v2//7llnEBFjgBGkeZ1nARNJOa37dGC3rD6sBLwfEfNL5TOA5SV1Bx9jttAPgY9J/3MOB3aJiCmVlZL6Aj8GToyIj5vbeGcM5M2qkjQQuA64LSJGNVLtIOCFiHiuvfplnUNE3BMR50TEXyLirog4nHQJ/HRJXSStBZwEfDc6201C1m4kbQf8BvglsB1wILAycKs8S5q1Ah9jlo0CNgd2B8YDf84TLVScCzwREXe2pPFON2sN6Yy2TwPlK+V1thSTtDJpFpopwDcbqdMX2JF0g7QZwM3A/sBA0gwCdwETJa2Y13cBls3LsxzgLxUuAm6PiB9WCiT9jZTauQcwuoP6ZZ3fDKCnpK6lUfmVgLkR8VFe9jFm5FmMKjMZ3QW8QJr16DBJGwNHAl8t/D9aPj/3kTQ/IuZRRWcckX+JUi68pNVJG/ZSg6+wpYKk5YE/k24S2TUi5jZSdV/SSarTaqwiCs/rA3uT/hlXHqsDx+WfV+2IDlq72wD4W7EgIiaSpixdpyM6ZHXjJVKKzBdK5eV7/HyM2WIi4hPS7Fdr56J1STdFP86i/0eVPPl/km6AraozjsjfBfxAUq+ImJ3LDiAd+A91XLesI0nqBvyRdNAPj4h3qlQ/CHgqIl5tl85ZPdiXNBPAFOA/gfIXbdxA+vvya2Bq+3bNOsgUYEixQNKGpBnSJndEh6xujCN998R+pJtXKwNNu5Hy4St8jNli8tSlQ4DHctGjpLSroq+T8up3oYHvPynrjIH8b4DjgdGSziOdtZwFXOw55Jdql5MO6u8CfXP6TMWEiPgQIH9j3leA77d/F60zkHQL8BTwLGnU7ID8OD5PF/Z0A6/5AHjD84MvVX4D/FzSW6QBpP8AziQFWAtzVSVtRkrJWj0XbSOpHzA5IpY4lqz+5aB8l7y4KtA7T1cLcGdEzJX0M+AMSTNY9IVQXVh8BLWmY8zqU1PHCSl9amfgbuAt0heCfSs/XwwLp9YeW2p3YP7xkVrmke90gXxEzMgzklxKmpN1JvBznO+8tNspP/+ygXVrsWh0Y//8fFMD9WzpMJGUc7g6aa7mF4HDIuJ3Hdor62x+BXwEHEua+m0maXTslNKUpMeRZpqoOCs/X0OakcQ+ewaQrgAXVZYr/29+RgrcTwH6kgYIvhYR/y68ptZjzOpTU8fJS8AhpKB9JdKsNU8Cm0XEC63ViU73za5mZmZmZta0znizq5mZmZmZNcGBvJmZmZlZHXIgb2ZmZmZWhxzIm5mZmZnVIQfyZmZmZmZ1yIG8mZmZmVkdciBvZh1C0ghJ4yXNljRD0gRJF7fye3xZ0lmt2WZnJuksSdNaoZ31clsrlspHSApJ5W/GbXeSbpf0P03U2TX3d2BeHpC3a2Cp3maSpkvq03Y9NjNrfQ7kzazdSToF+C1wD7A3cBhwG7B7K7/Vl4GqwZ41aD3SfluxVD4GGAbMbe8OFUnaAtiexb9FsxYDSNs1sFiYv6F1AnBCa/TPzKy9dLpvdjWzpcJxwBURcWqh7A5JP+qoDlnTImIqMLWj+wEcD9wWEdNbsc2rgQslnRMRn7Riu2ZmbcYj8mbWEVYE/lUujMJXTUt6StKoch1JoyRNyD8vI+lCSa9L+lDSW5JuldRd0gjyiG1OrwhJYwvtDJI0Jqf2zJb0R0mfK6zfNr9mB0m3SZoj6RVJO0nqKukCSdMkvSnpxFo2WtJ/SXpO0geS/i3pZkl9JO0iaYGktUr118rlexTK9sr7Zp6kdyXdKWnNKu+5sqQr8/t9IGlcHtFurP62wB158bW8DybndYul1kgamJcPlHS1pPck/VPSIXn9yfkzmSrpPEldSu9V9TNopH+9gL2Am0vlymkz7+S2rgV6F9YPBJ7Liw9WjolCE7cDKwP/p9r7m5l1Jg7kzawjPAN8R9Lhkvo2UucqYN9iPnb+eV9gZC46BfgmcAbwNeB7wCygKykN5KJcb1h+fCu38wXgMaAHcAgwAtiYdFVApX5cATxKCh6nkALIS4FewMF5+aJqwXF+z9NzWw8BewLH5r72JKUYvQUcXnrZCOCdvC1IOhQYDbwK7A8cAbwM9G/kPZcF7gN2BH6Q33cqcF+VgPkZ4KT8896k/bZXtW0DzgPeBvYBHgGukXQRKbXpSOAXwMm5z5W+NeczKBoOLAeMK5UfD5wJXEk6RuYB5xfWv006VgC+zaJjAoCIeA94gbSvzMzqQ0T44YcffrTrA9gE+AcQwAJSAHU20LtQpzcwBziiUHYk8CHQNy//GbioyvscRx7oL5X/DpgIdC+UrQvMB76Rl7fN/fufQp2NctkDhbIupKsL51Xpx4qkvPKLq9Q5B3gNUF4WMBm4sPA+bwKjq7RxFjCtsHwU8BGwbqGsG+lE4IIq7eyat3NgqXxELu+Zlwfm5atLn9vHwCtA10L5U8CNzfkMGunbqcDUUllX0onQr0vl9xa3AxiUl7dtpO1RwGMd/fvhhx9++FHrwyPyZtbuIuJZYEPSza2Xk4LWM4CnKyPwkUZIbyYFjxUjgNsj4t28/DdgRE7h2KSJkdyiHYFbgQWSuknqRgqiJwOblereX/h5Un5+oLAtC0gnJatWeb9hpFHkq6vUGQmsSTqBANguL1desz7w+SbaKNsRGE9KkalsJ6SrAuXt/DQW7qP8uU0FHoqI+YU6k1h8HzXnMyj6HFCemWd1YBXSDdNFo5uxDeR2q6b2mJl1Jg7kzaxDRMSHEXFHRBwXERsB/0kakT2qUO0q4CuS1pa0DvAVFqXVQBrFvoyUMvP/gDckfbeGt+8H/JA0clx8rE0KCotmFvr8Ubks+4iUItKYSvrQ241ViIh/AGNJ6TLk56ci4oVa22hAP2BLltzOI1hyOz+NmaXljxopK+6j5nwGRT1IV2WKKsH3O6Xy8nJTPqT652hm1ql41hoz6xQi4ipJ5wMbFMoelvQKaSRepPSJvxTWf0DKiz5T0rrAMcAvJE2MiLurvN100mjwbxtY96nnYW9A5QrCKk20/1vgf5Wm59wb+H4jbdRqOvA0KR+/rBwMt7eWfgbTWXJazMqN0wNK5eXlpqyY2zczqwsO5M2s3UkaEBHvlMr6A32Af5eqjyTfpApcW0rXWCgiXpF0EulGxo2Au0mjwEjqkYP+ivtJN1aOj4hYorHW9zjp5svDWXQjaUNGk64w3EC6YnpDYd1EUo784SyaVaYp9wM7Aa+X93cTKlce2nJ0uqWfwUTg85KWjYjKycgbpGB+D9LnXrF36bVNbddA0s3DZmZ1wYG8mXWE5yTdRhpdf4eUC34S6YbQa0p1ryGl0HSjlB8u6VZSDvgEUqC8b673cK7yUn7+rqQHgPciYiLpptCngDGSRpJGgFclzXwzKiLGttaGAkTETEk/Bs6V1B24E1gW+Abwo4h4M9f7QNIfSCcj10fEzEIbCySdDPwh17medOPm9rnu0w289bWkqxRjJV1IyuXvS5pN5l8R8fNGujwxPx8t6QZgbkQ810jdljqLln0GjwHLAF8kXW0gIubnqzkXKn2z7SOkGXQ2LL32dfIJlaRZwMel/bYZaQYeM7O64Bx5M+sIZ5NGP39FCuZ/TJq55ssR8VqxYkT8C3iSNJtIebR0HGlKxetINzoOBfYpBGePABcA381tXJHbfJmUOz6XNF3hXcCPSOkmk2gDEfFTUorLjrmvV5BSOWaXqv4pP48slRMR15EC1A1INwJfm39u8Eua8lWI7Uizt/yItK9/SboX4akqfZ1COrHamxQ413oFoGYt/Qzy654Hdi6t+gXwE9KJyy2kaT1PLr32A+C/SMfJQ8BfK+skDSZN49ncG2TNzDqM2ueqsplZy0hamZRSclxEXNXR/WlreWR5f2DtPCOOlUg6ATgqIga1Yps/BTaPCM8jb2Z1wyPyZtYpSeqVv2TpUtKo9fUd3KU2JWl9SXuRRu0vdRBf1ZVAf0mtEnRLWoE0Un9Oa7RnZtZenCNvZp3VUOBB0repHhYRczu4P23tCmAL4HZSypE1IiLmSDocWKGVmlwDOLu1740wM2trTq0xMzMzM6tDTq0xMzMzM6tDDuTNzMzMzOqQA3kzMzMzszrkQN7MzMzMrA45kDczMzMzq0MO5M3MzMzM6tD/B2OJ17P5lBsdAAAAAElFTkSuQmCC", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "import numpy as np\n", + "\n", + "times = np.arange(num_samples)\n", + "gaussian_samples = np.exp(-1/2 *((times - num_samples / 2) ** 2 / sigma**2))\n", + "\n", + "gaus = library.Waveform(gaussian_samples, name=\"WF Gaus\")\n", + "gaus.draw()" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "##### Pulse library functions\n", + "\n", + "Our own pulse library has sampling methods to build a `Waveform` from common functions." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "gaus = library.gaussian(duration=num_samples, amp=amp, sigma=sigma, name=\"Lib Gaus\")\n", + "gaus.draw()" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Regardless of which method you use to specify your `pulse`, `play` is added to your schedule the same way:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "with pulse.build() as schedule:\n", + " pulse.play(gaus, channel)\n", + "schedule.draw()" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "You may also supply a complex list or array directly to `play`" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "with pulse.build() as schedule:\n", + " pulse.play([0.001*i for i in range(160)], channel)\n", + "schedule.draw()" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The `play` instruction gets its duration from its `Pulse`: the duration of a parametrized pulse is an explicit argument, and the duration of a `Waveform` is the number of input samples.\n", + "\n", + "### `set_frequency`\n", + "\n", + "As explained previously, the output pulse waveform envelope is also modulated by a frequency and phase. Each channel has a [default frequency listed in the backend.defaults()](https://qiskit.org/documentation/tutorials/circuits_advanced/08_gathering_system_information.html#Defaults).\n", + "\n", + "The frequency of a channel can be updated at any time within a `Schedule` by the `set_frequency` instruction. It takes a float `frequency` and a `PulseChannel` `channel` as input. All pulses on a channel following a `set_frequency` instruction will be modulated by the given frequency until another `set_frequency` instruction is encountered or until the program ends.\n", + "\n", + "The instruction has an implicit duration of `0`. \n", + "\n", + "**Note**: The frequencies that can be requested are limited by the total bandwidth and the instantaneous bandwidth of each hardware channel. In the future, these will be reported by the `backend`." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "with pulse.build(backend) as schedule:\n", + " pulse.set_frequency(4.5e9, channel)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### `shift_phase`\n", + "\n", + "The `shift_phase` instruction will increase the phase of the frequency modulation by `phase`. Like `set_frequency`, this phase shift will affect all following instructions on the same channel until the program ends. To undo the affect of a `shift_phase`, the negative `phase` can be passed to a new instruction.\n", + "\n", + "Like `set_frequency`, the instruction has an implicit duration of `0`." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "with pulse.build(backend) as schedule:\n", + " pulse.shift_phase(np.pi, channel)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### `acquire`\n", + "\n", + "The `acquire` instruction triggers data acquisition for readout. It takes a duration, an `AcquireChannel` which maps to the qubit being measured, and a `MemorySlot` or a `RegisterSlot`. The `MemorySlot` is classical memory where the readout result will be stored. The `RegisterSlot` maps to a register in the control electronics which stores the readout result for fast feedback.\n", + "\n", + "The `acquire` instructions can also take custom `Discriminator`s and `Kernel`s as keyword arguments." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "from qiskit.pulse import Acquire, AcquireChannel, MemorySlot\n", + "\n", + "with pulse.build(backend) as schedule:\n", + " pulse.acquire(1200, pulse.acquire_channel(0), MemorySlot(0))" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now that we know how to add `Schedule` instructions, let's learn how to control exactly when they're played.\n", + "\n", + "## Pulse Builder\n", + "Here, we will go over the most important Pulse Builder features for learning how to build schedules. This is not exhaustive; for more details about what you can do using the Pulse Builder, check out the [Pulse API reference](/api/qiskit/pulse).\n", + "\n", + "### Alignment contexts\n", + "The builder has alignment contexts which influence how a schedule is built. Contexts can also be nested. Try them out, and use `.draw()` to see how the pulses are aligned.\n", + "\n", + "Regardless of the alignment context, the duration of the resulting schedule is as short as it can be while including every instruction and following the alignment rules. This still allows some degrees of freedom for scheduling instructions off the \"longest path\". The examples below illuminate this.\n", + "\n", + "### `align_left`\n", + "The builder has alignment contexts that influence how a schedule is built. The default is `align_left`." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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AXRQVRV77rUXXbp04cADD2Lx4sWccMI36dq1KyNGjGT+/Pm88847LbMBzczMrM0qddzF67n37wO13ay2AmbWzoiIdyW9BWwNzC0x79dy7/sDR0s6NJfWFXg6W9fiiHgvN28esE2J6zGrGNVV1dx9110sWbKExYsX079/f/r06cO4c89lyZIlzJkzh+qqaqZMeYZrr7mGefPmsTqCD5Yt45M7fBKAfv36se222zF50iT22XdfJk2cyKl33Q3A/AXzeeKJ3zFpcq6L1ocfsvvuuxctz6JFi9hyyy3XTG+51VYseuONNdO9evVmww03XOczfXr3WfN+w27d6NmrF507d07T2bLLlr1Pjx491mdTmZmZWTuzvgO/55OCBgAkbQz0Af7diDwi9/414JcRcWLhQpL6A70kbZwLQvoVfN6sTdj1s59l6dKl3H/ffXx2t90A6N69O337bs79991H37596bv55hx55BFcdPHFDB++H127duWMM75L5Hb5ESNTN6zVsZrtttuOfv36AbDFFlsw+pBDOP/88SWVp2/fvixYsIAddtgBgAULFtB3883XzG/CWHUzMzOzotb3Llh3AMdL2k3ShsCPgD9ExNwm5vcr4FBJB0vqLKmbpOGSPhER80jdsS6QtIGkvYFD68/OrDJ169aNgTvvzC9/eRtVg6rWpA8aNCilVVfz4YcfsmLFCnr16k2XLl2YMuUZnps2bZ18RowYwXPTpnHP3XczctSoNemjRx/C5EmTmPrss6xatYrly5czffp0Fi58nWJGjBzJ9ddfR01NDYsXL+a6a69l9OjRLfPlzczMrENbrwAkIp4ExgH3AQuA7YEvr0d+rwGHAT8EFpFaRL6fK+dXgT2AGuB84Lb857MHHA5r6vrNymlw9WBqamoYVLX2mZyDqqqoqamhuqqajTfemLN/8J+c/f2xDBu2NxMencC++w5fJ4++ffuy6667Mnv2bA4+eMSa9C222IIrr/yfNXelGnHwQdx66y2sXl28wfDEE09i54E7c8zRR3H0UUey0047ceKJJ7XI9zYzM7OOTRFttweTpPHADhHx9cJ5VVVVMWly8QG3ZmZmZmbWsB6bdJ8REYObM89yP4jQzMzMzMw6MAcgZmZmZmZWNut7F6xWFRHjW7sMZmZmZmZWOreAmJmZmZlZ2TgAMTMzMzOzsnEAYmZmZmZmZeMA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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "with pulse.build(backend, name='Left align example') as program:\n", + " with pulse.align_left():\n", + " gaussian_pulse = library.gaussian(100, 0.5, 20)\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(0))\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(1))\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(1))\n", + "\n", + "program.draw()" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Notice how there is no scheduling freedom for the pulses on `D1`. The second waveform begins immediately after the first. The pulse on `D0` can start at any time between `t=0` and `t=100` without changing the duration of the overall schedule. The `align_left` context sets the start time of this pulse to `t=0`. You can think of this like left-justification of a text document.\n", + "\n", + "\n", + "### `align_right`\n", + "Unsurprisingly, `align_right` does the opposite of `align_left`. It will choose `t=100` in the above example to begin the gaussian pulse on `D0`. Left and right are also sometimes called \"as soon as possible\" and \"as late as possible\" scheduling, respectively." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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GsTgIUOYMWMGAMOGD2fihAksX74cgPHjH6WqahgAjz7yCPvttz/7778/m222GUOGDGG33XZn8uSaH2L86KOPcPI3T6Fnr1707NmTU755Cg8/8vC6+ZI49bTT2HzzzenSJXUUGVhRwb6f+QwdO3bk0EMPY/HixZx44kl06tSJqqphzJ07l3feead5vkCzMlbsuIs3c+/fB6q7WW0HzKieERHvSloIbA/MLnLdr+fe9weOlXRELq0T8MdsW4sj4r3cvDlA3yK3Y2ZmZq1EZUUl99x9N0uXLmXx4sX079+fXr16cf4Pf8jSpUt59dVXqayoZPLkp7n+uuuYM2cOayP4YPlydt5pZwD69evHDjvsyKSJEzngwAOZOGECp959DwBz583liSd+z8RJuS5aq1ax995711ieBQsWsO22266b3na77Vjw1lvrpnv06Ennzp03WKZXz17r3nfu0oXuPXrQoUOHNJ3lXb78fbp167YpX5VZq7OpA7/nkoIGACRtAfQC/tOAdUTu/evALyNidGEmSf2BHpK2yAUh/QqWNzMzszZgz099imXLlvHA/ffzqb32AqBr16707t2HB+6/n969e9O7Tx+OPvoLXHLppQwdehCdOnXizDPPIHKnBlXDUjestbGWHXfckX79+gGwzTbbMGLkSC68cGxR5enduzfz5s1jp512AmDevHn07tNn3fxGjFU3a7c29S5YvwZOkLSXpM7Aj4E/RcTsRq7vV8ARkg6X1EFSF0lDJX00IuaQumNdJGlzSfsBR9S9OjMzM2uNunTpwm67784vf3kHFQMr1qUPHDgwpVVWsmrVKlauXEmPHj3p2LEjkyc/zbNTp26wnqqqKp6dOpV777mHYcOHr0sfMWIkkyZOZMozz7BmzRpWrFjBtGnTmD//TWpSNWwYN954A4sWLWLx4sXccP31jBgxonk+vFkbt0kBSEQ8CZwP3A/MAz4GfGkT1vc6cCTwA2ABqUXknFw5vwLsAywCLgTuyC+fPeBw/8Zu38zMzMrHoMpBLFq0iIEV659dPLCigkWLFlFZUckWW2zBud/7PueeM4b999+P8Y+O58ADh26wjt69e7Pnnnsya9YsDj+8al36Nttsw1VX/WzdXamqDj+M22+/jbVra+5YMXr0yey+2+4cd+wxHHvM0ey6666MHn1ys3xus7ZOEa23B5OkscBOEXF8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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "with pulse.build(backend, name='Right align example') as program:\n", + " with pulse.align_right():\n", + " gaussian_pulse = library.gaussian(100, 0.5, 20)\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(0))\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(1))\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(1))\n", + "\n", + "program.draw()" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### `align_equispaced(duration)`\n", + "\n", + "If the duration of a particular block is known, you can also use `align_equispaced` to insert equal duration delays between each instruction." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "with pulse.build(backend, name='example') as program:\n", + " gaussian_pulse = library.gaussian(100, 0.5, 20)\n", + " with pulse.align_equispaced(2*gaussian_pulse.duration):\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(0))\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(1))\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(1))\n", + "\n", + "program.draw()" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### `align_sequential`\n", + "\n", + "This alignment context does not schedule instructions in parallel. Each instruction will begin at the end of the previously added instruction." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "with pulse.build(backend, name='example') as program:\n", + " with pulse.align_sequential():\n", + " gaussian_pulse = library.gaussian(100, 0.5, 20)\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(0))\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(1))\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(1))\n", + "\n", + "program.draw()" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Phase and frequency offsets\n", + "\n", + "We can use the builder to help us temporarily offset the frequency or phase of our pulses on a channel." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAyYAAACgCAYAAAD5NnhqAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8o6BhiAAAACXBIWXMAAAsTAAALEwEAmpwYAAA4B0lEQVR4nO3dd5hVxeHG8e8LCCi9gw0FVARJFCzBiiVYsWDsDWuKJcaGmvgTu2BNLBFjQRMBIxEbVhRsmCCIikYQC2pABenFVYH5/THnwuVyd/fucnfvlvfzPPfZvXPmzJlT7pwz58zMUQgBMzMzMzOzQqpT6AyYmZmZmZm5YmJmZmZmZgXniomZmZmZmRWcKyZmZmZmZlZwrpiYmZmZmVnBuWJiZmZmZmYFV6MrJpIGSQqSXsgybZSk8QXIVt5I6idpnKTFkpZJmijpVEnKEvf/JM2StErSsCRsN0nvSCqSlLdxoyWdJenwfKVXXUgaL2lUBaU9LDmWg6QVkuZJekPSpZKaVcQyS8nP1snvq3lG+IAkj40rO09pedhP0qOSvpC0XNIHks6RVDdL3MMkTU1+A/+VdEyWOM0kPShpgaRFkh6R1CqHfEjS5ZK+kvS9pNckbV/OdTon/Tda3PY3MzOrzmp0xSRNX0k7FToT+SRpIPAU8D/gWOAwYALwN+DujLg7AlcBdwK7Adckk4YCC4H9gd55zN5ZwOF5TM+iacT9tAdwMjAOuAiYImmLSs7L1sCVQPOM8DHEPC6v5PykOwtoBPwJOAgYCdwCDEmPJGl34F/E7XggMe8jJPXNSO+fQB/gDGAAsBPwRA75uBS4AhgM9AOWAmMltS/7Kq2juO1vZmZWbdUrdAYqwXxgFvBHasjFsqRewPXA4BDCpWmTxkqaDtwt6YUQwhNJeNfk710hhMVp8bsC94YQXq3wTFs+LAsh/Dvt+xhJQ4GJwIPA3uuTuKQNgFUhhJXlTSOEMBeYuz75yIPfhRC+S/s+XtJGwB8kXR5C+CEJvwJ4LYRwXvJ9nKTuwP8BLwJI6g30BfYKIbyWhM0C/iNpvxDC2GwZkNSQWDG5IYRwZxL2FjATOIdYaTIzM7M0teGJSQCuAw6V1KO4SJI6SHpA0mdJs4uPJV0rqX5anC2SZirHJk07Fkv6n6QTk+mXSJotaa6kwZLqZCxjO0ljJC1JPo+V8+7pOcBiYuUk073Ap8B5yTKHAX9Ppi1K8t8naRZSF/hzEjYsiX+opMlJ07AFkv4jaa+0daiTNB/6RNIPyXY6JW36eKAXcEpa06MBxa2IpIaShiTNXX6Q9J6kg9KmX5w0s+mWFrZz0pzpzOR7I0l3SpqeNN35XNJdkppmLCtI+oOkWxSbQn0n6aJk2inJvl+YHAcN0+ZLNU/aSdLracfHEcXuoTXz5mufZxVC+B9wNdBHUteM/K7VnErSTEk3p30fr9ik8SxJnwJFwMaSukoameyT5ZI+lHR+6niW1Ad4Oknm82RZM4tbtqTWkh5KtvnyZLk7Zstbsn/+lxx7I1WOpkoZlZKUKUBDoGWyvAbEitw/M+KNBHprTfO4A4FvU5WSJP2JwOfJtOLsCjRNTz+EsIy43UqaD0kNkuN5oaT5km4DNkib3oditr+ZmVl1VhsqJgCPATOIT02K05r4dOUC4ADgJuBU4I4scQcDXwNHAq8DD0m6BdgZOA24HbgEODo1g6QuwJvEi6MTiU1CugNPS2v6hCQXaMNKWZ89gXEZTz8ASO52Pw3sKqkesdnWtcnkfYjNbN5hTdOtW5L/r5HUGRgFvEJsenIC8AzJxVziDuLd3nuBg4HRwAOSDkmm/47Y5OjZJN3exCYyxRlF3BbXJ8t8G3hKa9ri3wJMIm7jekmF4SHgxRDC35I4GxErWX8kXvRdkazrY1mWdyHQGDgOGA7cJGlIkofzgMuT9T4/y7yPAk8C/YGpwGOSfl7ciuW6z/PgpeTvL8ox727Ab4GBxO2/CNgEmE7clwcRmwdelcSBePxclPzfn7iPS6qkPUFsLngRcAyx3BmXbJ90RwP7EptiDQQOIaPynePvI5vexGaLc5LvnYkX+9My4n2U5G/r5HvXLHFS8bpmCU/pCqwkljtlmQ/gRmKzsWuIx2JH4nGbUtbtb2ZmVj2EEGrsBxgEfJf8P4B4obB18n0UML6EeesBxxPvItdPwrYgPoF5MC1eU+An4gVI3bTwicCjad//TrzYq58WtlWSp4PTwj4B7i9lvYqA20qYfn6Sz3Zp6x6AxhnxAnBO2vdfAfNKSLcLsAo4JSP8YeDttO+TgGE57J99kzzslRH+GvBYxnKXEisctxIrkBuXsu92S9LePGN9x6V9r0OsYC4AmqaF/xP4T9r31Pa7PGPeacDItLDxwKiy7vMcj+VhwKRipjVI8jewlP09E7g5I7/fp46TYtJWsj0vBz5LCz8kWcYWGfHXWjaxkr/WPib2/5gLDM3I26dAvbSw24FvMtIv9feRZR26Jes5KC0sdXxsn+UYD0Df5PtLwBNZ0vwHMKGEZf4RWJgl/Iwk/frFzNcqyevALMdaKG37++OPP/744091/tSWJyYQLyS+BC7LNlHR+Yoj83xPrGw8Qrzo2zwj+supf0J8ajEXeDWs3Tb/E+Kd55T9iE8XViV3/usRm4PMBFY3awkhdAkhnF6+VVxvU4FmSbObvpIaZUzfl1gxGZ1ah2Q9Xga2V5ZRj0qxH/AN8GaW9NK3ySfEO+hXAL8Hzg0hzE5PSNJJkqZIWkrcd28kk7Zmben7bhVxH0wOaz99ytx3KaMz5n2S+JSspPUrdZ/nwfo8fZkcQvh2rcRi87qrJH0C/EDcntcBWybrUBY7A3NCWj+mEJs0PQPsnhF3XAhhRdr3/wJtFfu+pOYt0+9DUgtiB/f3yd70sarpQXzC9mQqIO1YMzMzq9FqTcUkueAZApwoqWOWKOcDNxMvJA8jXlCdnUxrmBF3Ycb3H4sJS5+vNfHi+qeMTydgs5xXJJpFbN5RnI7EC8p5ZUk0hDCduO6diE2xvpM0XFKbJEprYpOpRay9DsOId9U7lGV5SXrtWXebDGLdbfKv5O98MppoJX09HgbeAo4iNmlKNW3Jx75LmZPle0nrnM99XpJUJerbEmNll22ewcSmQvcSm3LtxJrmgNm2S0k6sO52Sy23ZUbYwozvPxIrXQ3KuExgdQf0J5P5Dw0h/Jg2eUHyN3Oo5RYZ0xdkiZOKtyBLeHr6jbNU1lsAyzPyki7V/yjbsWZmZlaj1YZRudI9QOwfMTDLtKOIzXBW90NRWofrPJhPrPTcl2Vats66JXkNOExSkxDCkvQJSQflg4nNTFZknbsEIYQxxNGemiXp3E7sV3IscR1WEJvBrMoye1kvnlIjph2eQ9x7iE+82hIrLpenTTuK2PTqd6kApXXYz6O2rF3Za0tsClacfO7zkqSGt30r+VuU/K2fEa8F68r2/pqjgDtCCKuH15V0cDnz9jVxO2VqR9w+FSKpEAwnNuPaLfOpELHZ2E/E/h7po9J1JR7bHyffpxGHZ87UlZKHDJ5GrMR3ITbnS58vW5+VlG+Sv21Ze/tk24ZmZmY1Sq15YgIQ4jChNxM7qGfe6d6Q+JQh3Ql5XPzLxI7Pk0MIkzI+M8uY1p3Eu7jZmqWdQezH8Of1yWwIYVEIYTjxwjpVQXuFeLHVLMs6TEq7C1zcE4dMLxPvEC/Nll4qkqSTiW3qTyB2Ar5EUnoTqoredymrOxgnFcDDiH2JipPPfZ6VpE2JTdzGJU+8IL7bBmDbtHi7EPtD5WKt7Zlc5B+bESe1r0vbz/8hNsfaMy29jYiV3jeKnWv93U3s33Jo2nZZLSkLxhErYemOAd4KISxKvj8HtFd85wmw+r1AnZJpxZlAHDlvdfrJevcrZb6pxIrlYWnz1Un/nsh1+69DUhtJLyUjnz1Q1vnNzKo7l4NVV62qmCSGAkuIw3mmewk4RtLvJO0v6WHi3c58GURsPz5G0q8Uh+w9QfGN3n1SkRSH4b2/pIRCCJOJnWsvS/qDHChp32RY0buAe0IIZW6TLunXSX6OlbSnpNOJF1avJMudTnxyMVLSwGSZBysOk5z+VGAasEeyHXdU8W/Jfgl4AXhJ8c3Weyu+iftKSTckedqUWMm6KYTwnxBH4hpLHKWrYVo6e0r6o+Jbv28l9ofJtzMkXSTpAGIH+S7EZk/FGURu+zzXkaYaSfqFpN7JPr+GOAxuEXEEuZSJxCdRf5F0kOJw1n8jXijn4iXg7KTfzsHEUd4ym1OlLvZ/LWkXFTMUdwjhBeJF+qOKQzIfQmwmuCFx5LsyyeX3Iely4shetxP79/wi7ZNeObuGOMzy7cm+GUJsunZ1Wv7fIr7T5GFJ/SUdTux79kZIe4eJpPuTPjmp+YqIo2tdLulsSfsSmyDWIftIf6n55hGb0F0l6cLkWHuMOJJcuhK3v+KQzAsUh0XOdBkwI4TQIoRwWnF5KU3ym52kOMz3sIxpLSWNVhx2/AtJx5eSVrHxy5HWTEk/SmqdET5FcWjlLdLi7ZcRZ4Ckiqwwm1klqYxycD3yVmz5mUzPudwrLW61K0ML3fu+Ij+kjcqVEX45sQnL+LSwxsSX1M1PPvexZuSb7ZI4WyTfD8lIbyZpox0lYcPIGEWJ2IxjVJL+98RO1kOBTTPSGpbj+vUjjqy0hPim7YnEC1RlxBtAbqNypYb2nU282P2ceOHdIC2OiP1xPiTeVZ9LbApzclqcTsTKw6JkGQNKWIcGxKFoPyHeBf4GeJ5k1Krk/6msPbLVJsQ2/Lck3+sSn4TNIV58/wvYJXNfZa5vEjaetJG0sh03adtvZ+Lwv0XEUdiOzCGtXPb5HGBIKft6WJKHQBzVa36Sl0uJT7Ay4+9EHHp5ObHyshvZR+UalWXedsQnZYuJfUGGAGdmHkPEp1dfEJv3zSzuWAPaEPsALUi2wavATjn8hrKlNZNSfh/JeoViPn0y4h4OfEA8lqcBx2ZJrzmxbFiYbJPhQOss+2dmRpiINxD+l6z368AOOfyuGxCf+CxKttkdxGHMQ0a8dbZ/Wjk1n1ghPCpL+u8De+dSxpSSz/7J9vtr5j4BRhCH125MHORgEdC9hLSKjV+OtGYSK27npoX1SMJWj2SWxNsvyzH3xvpuG3/88aewn8oqB9cjf8WWn8n0nMu90uJWtzJUSUJmVgzFF0Q+CDQJISzNc9pbEisrW4UQPstn2lY7Sfo/4gAY/yE2ZTskCa9PvJHQFFgGfB5CKPals2VY3rXEivaA5HsjYoVquxDCx0nY34FZIYRLs8xfbHziU62c00qmzyTeWDoshLBTEnZzks61wJYhhJlJvDPC2k++BiRhu0s6Bkh/OrcBsZlfn7JuIzOrXJVdDq5HPtcqP5OwnMvQ0uKWtTxOps+kgGVobWzKZVaV7Ep8T4YrJZYvJxPvkI0C9pHUDiDEPmC9icM3N04/GUt6RvFN89k+z5Rx+VsDK1InwcR7xP5WZY1f1rRS/g00lbSt1vSR+kcZ1oEQwqPJdmoMbAx8RtyuZlb1FbocXB9lKfdKi1vtytDaNiqXWZUSQniE2GfBbL0pdtJvRBwMYaWkl4kvir0tibI98aS0ltTdxDxpzLr9mRYBTcoRv6xppfs78eLkVeAj4hOYTE9ISh+9sD7wTnoExcEHhhOb/g7NYblmVkBVpBxcH2Up90qLW+3K0BrblKtV69ah4+aZ70U0M6u5vvzyS+rUqcOmm24KwPz585kzZw5du3YFYNaseF7ZZJNs7w8tn9mzZ/PTTz/RsWNHAJYvX87HH3/M9ttvvzrOt99+y9KlS+ncufM685cUv0OHDmVKC+DDDz9ks802o2HDhnz88cc0atSIZs2a0aJFC9599126detGgwYNVsdr2nTNeAjz5s1j3rx5bL31mveyzp49m2XLltGlSxek9XmXqZlVhkKUgzNmzGDp0uwtvRs1arRWmZIus/yEspWhpcUta3kM2cvQhQsXLiG+e+wncmzKlRZ2A7F1yH4hhJ+yLjRNja2Y9OzZM7z62uuFzoaZWaX4/vvv2apLZ0Y/8SQ77bQTQLyg7tyJF18aS48ePTj88MM49tjjOPbYtUd/7t//CN6aMCFrur133ZXHHx9d7HKvvvoqZs+azT1Dh65e5uabbcp/Jr5Nly5xYMOzzjqTDu07cNXVV68zf0nxLxk4sExpAWzXvRt33HkXe++9NwcdeADvvfceH8/4hAYNGtCyRXOmfvAhHTt2XCteyiP/+AcPPfQQL770EgCjRj3GoCuvZPz4V2ndpk3W5ZlZ1VGocrC8MsvPVH5zLfdKi1vW8hiyl6FLliyZQhwAqEwVE0nHEkeo3CmEMDeXbeI+JmZmNcAzzzxNixYt6NGjB0VFRRQVFVG3bl369u3LiOHDAfhg6lR69NhunXkff3w0X3/zbdZPcSfjFStWUFRUxKqVq1i5aiVFRUWsWLGCRo0a0e/QQ7nuumtZtmwZ/37rLZ4dM4Zjj8t8FU5UUvyyppXpzrvu5ulnxtCoUaMct+Ia7733HhdfdBHDR4x0pcSsmqjscrC8iis/oeQyMVNpcfNVhpL9pdolkrQDcVTJw3OtlIArJmZmNcLw4cP54osvaNum9Vqf0aNH889/PsqsWbNYuHAhW2+9TV6WN2TIYNq2ac2tt97CoyNH0rZNa4YMia/1ufXW2yj6vojOnbbktNNO5dbbbmfbbbutnrd//yO4+aY1r7EpKX5paZWkU6dO9OzZs1zrN2bMMyxcuJD9+/6SDu3b0aF9O/r3P6L0Gc2sYCq7HCyvkspPKFsZWlrcQpWhxBcDtwDekLQ0+ZT0gmHATbnMzMzMzKwYTZs0nhxC2LEyluUnJmZmZmZmVnCumJiZmZmZWcG5YmJmZmZmZgXnikmOBl15JXfddVehs1GsPn324qOP/lvobJiZmZlZjgp1fVlVrxtrfMXkiCMO59prr1knfMwzz9ClcyceeeSR1SOupH+aNmnMjTfeAMB3c+cyYsRwTjvttDIv/4wzTmerLp3ZZOMO7LD99jw0bFixcYcOvYe99tyD1q1a8ptf/7rYeJ988gltWrfijDNOXx123nnncd2115Y5f2ZmZmZWNhV1fVnbrxtrfMXk+OOP55+PPkrm6GMjR47g6KOP4YQTTlhnvOobbxxM27ZtGTDgVAAeeeQR+vbdnw033LDMy7/wwgv54MP/Mmv21zz66KNcc83VTJkyJWvcDu07cPHFl3DSSSeVkuYF6wzfdtBBB/Pa66/z7bffljmPZmZmZpa7irq+rO3XjTW+YnLIIf2YP38+E958c3XYggULeP755znu+OPXif/ee+9x6aUDeXDYMNq3bw/ASy+9yG67716u5W+7bTcaNGgAgCQk8fnnn2WNe+hhh3FIv360aNmy2PRGjXqM5s2asVefPmuFN2zYkB22356xY8dmn9HMzMzM8qKiri9r+3Vjja+YbLjhhhxxRH9GjBixOmz06MfZeuut6dGjx1pxFy5cyEknncgllwxkjz32XB3+4YcfstVWW5U7D3/4w/m0a9uGXr160r59e/r23b9c6SxevJjrrr2O62+4Mev0rbfZhg+mTi13Ps3MzMysdBV5fVmbrxtrfMUE4uO2J598gqKiIgBGDB/BccefsFacEAK/Pussum3bjfP/8Ie1pi1atIgmjRuXe/m33XY7s7/+hhdeeJF+hx66uiZcVtdeew0nn3wym2yySdbpTRo3ZtGiReXOp5mZmZnlpqKuL2vzdWOtqJj03nVXWrZqxTPPPM1nn33G5MmTOProo9aKc9utt/LRtI+4Z+hQJK01rXnz5ixZunStsIMOPICmTRpn/fT95S/XyUPdunXpveuuzJ41i/vu+1uZ1+H9999n/LhxnH3OOcXGWbJ0Kc2aNStz2mZmZmZWNhVxfZlSW68b6xU6A5XluOOOY8SIEcyYMYN9992Ptm3brZ72+uuvcfPNN/Hc8y/QvHnzdebdbrvt+OSTT+jVq9fqsGefe75c+VixYiWff/55med7/fXX+fLLL+m2bVcAli1bxsqVK9lj2jRefyO2b/x4+nSOPubYcuXLzMzMzMom39eXmWrbdWOteGICcNxxxzN+3DgeGjaM409Y0ynpm2++4dQBA7jxxsH8/Oc/zzpv37778+Ybr5d5mXPnzmHUqMdYunQpK1euZOzYsYwa9Rh99uqTNf6KFSsoKipi1cpVrFy1kqKiIlasWAHAqaeeynvvT+XNCW/x5oS3OO2009l///0ZPfoJAIqKipjy7rvss88+Zc6nmZmZmZVdPq8vfd1YiyomHTt2ZJdddmH58uUcdNDBq8OHDXuQOXPmMHDgJeuMNX3+788DYm34xRdf5Pvvvy/TMoW4/7772LbrNmy+2ab86Y+Xc+ONgzno4Lj8/v2P4Oabblodf8iQwbRt05pbb72FR0eOpG2b1gwZMhiAjTbaiHbt2q3+NGrciAYNG9K6TRsAnnvuWfbYfXc6dOiwXtvJzMzMzHKTz+tLXzeCMsdfLhRJg4Ark68BWAR8ArwI3BFC+CYtroDLgN8CrYG3gfNCCO+m4vTs2TO8+lrZn3IU56pBg2jdpg1nn312mea78847efCB+7OE30XvXXfNV/bYe+8+3HXXXXTr1j1vaZqZVYbKKifNzKqaXK4vK6KM3Hvv3K8bmzZpPDmEsGO5FlRGVa2PySLggOT/ZkBPYuXjLEkHhBAmJ9MuBa4ALgamARcAYyVtl16ByacrBw0q13yP/+tfzJgxY53wpcuWrWeO1jZu3Pi8pmdmVlkqq5w0M6tqcrm+rIgysqpeN1a1plwrQgj/Tj4vhBBuAH4GfA2MlFRXUkNixeSGEMKdIYSxwFHEpyzFDz1Qwd5443U+/fTTEuP88U9/YvGSpSxespRfZhm5y8ysJnM5aWZWPJeRVa9iso4QwkLgEqAL8EtgV6Ap8M+0OMuAp4EDC5BFFixYwEknnsjJJ52YdXq7du3YeedduP6663jttVcrOXdmZoXnctLMrHguI6MqXzFJjAdWAL8AugIrgcxnWh8l0yrd3/52L/PmzePSSy/LOr1Bgwb8/R//YMMNN2TwjdnfvmlmVpO5nDQzK57LyKhaVExCCEXAd0A7oAWwNISwMiPaAmAjSfUrO38vvfgSbdu25ZB+/YqN06FDBw444AAmTJhQ5tG9zMyqO5eTZmbFcxkZVbXO7yVR6VEKY/bsWWyxxZbrvNET4KKLLuL7onjwbLllJ1auXMmcOXPo2LFjZWfTzKxgXE6amRXPZWRULSomSYf3VsC3xCcjjSXVzXhq0gJYHkL4sbLz16hRI+bNm5d1WmrsaYC5c+fG+BttVCn5MjOrKlxOmpkVz2VkVC0qJsDexLy+BfwE1CV2hp+eFqcrcehgAKZMmULTJo0rM485L69Pv3MrOCdmZlXHlx8+s/p/l5NmZuv6clq8hM21jOzUacuKzE7BVPmKiaTmwGDiyxbHAhsAi4lDBF+bxNkI6Afcm5pvhx12IJ8vWCzJ22+/zb777M3Pf/5znnr6GVq0aLHW9BAC555zDg8//BBXXjmICy+6KKd0P/yibkVk18wsL7p3zOzqVzyXk2ZWG+VaTlZUGZkPlXmjv6q9+f181rxgsQnQi/iCxY2A1S9YlHQZ675gcRegewjhW8j/m99LM3DgJfz17rvZeOONuf6GG9h33/2oX78+77/3HjcOvpGXx46lZ69ePP/8CzRs2HC9l+eTsZlVhrJUPkpTmeWky0gzqyz5Kicr+1oyV5X55veqVjG5MvkaiE9FPgFeAO5If6O7Ys+gy4mVllbAJOC8EMKUVJzKrpisWrWKP15+OXfffRfZtulee+3FsIceplWrVhWaD5+Mzaw88lkBKY7LSTOrrmpTGZmpVlZM8q2yKyYpkydP5uGHhvH+1Kn89OOPdOrUiSN/9SsOO+zwSs9LJp+MzWq3yjix5sLlpJlVVVWhnKxqZaQrJnlQqIpJdeGTr1ntUBVOstWVy0mz2sHlZMkqs2JSqZ3fJR0B/IU4tO8e6U2vrHKV9CP0ybjmW7TgO/48+AK++Pwj9u57FCeefkmhs2TrwSfViuFysnZzOVmzuJysHip7VK6bgXNCCE9W8nKtDNJ/vD755t+Tj/2NaR9OYuCgoavDLvj1gbTrsPk6YUedcC699zwo73l45YXHaNK0BfeNnJj1ZU5W9fkkW1guJyuWy0nLB5eT1U9lV0w6Ah9mmyCpXghhRSXnx0rhk2/+de3ei6f/dR+rVq6kTt26LJg/l5UrV/DFZx+tFfbt11/StXvFPDn9bu7XbLJ5p3KdbFeuXEHdulV+pPEaySfZqsnlZP65nLTycBlZ/ZX6q5E0E7gTOJlYsXgeOCWEUJRMPxMYCLQE3gB+E0KYnZFGA2Ae8cWI70n6JoTQOUn7r8AJwDaSGgE7ArcC3YAvgN+HEMYn6WwJDAN6Av8mvmCxeQjhxHJvActZ5g/eJ+Dy6bzVdqxcsYIvPp/Gll26M/2/k+nWY2fmfPO/tcLatd+M96e8yTOPP8D8ed/QpGlL+h15OvsecDQAF/+uH8edeiE9d+oDxBPh2af0YeBV97Jl527MmPYejzwwhFlffUrrNh046czL6NZjZ+65/XImvDoGBM8/9XcuuPwOtunei5HDbuHfb74AwC92259jB1zIBhvU579TJ3L3rZey/yHH89yTD7Pd9rvSrv1m/O/LT9hgg/pMnvgKrdtuwvmX3s7ECS/x/FMPU2+D+px57tX8bIfdCrWZawSfZKsfV1Lyw+Wk5crlZM1SJ8d4RxPfL7Il8DNgAICkfYAbkukdiBWJkZkzhxB+CCGk3s7y8xBC57TJxwEHA82BdsAY4osTWwIXAf+S1CaJOxyYDLQGrgFOyTH/VgG6d1y5+mO5q7dBfTpv04NpH04CYNoHk9imWy+26dZzrbCu3XekabOWXHTFXdw3ciK//v21/OO+wXz+6X8B6L3ngbz12rOr033/nTdp0rQFW3buxvx533LzNb/l8KN/zdBHJnD8qRfz5xvPZ/Gi+fzm/OvZda+DOaT/aTzwz0lst31vnvznUGZMf5/rb/8XN/z5cT6d8QFPPHrP6rQXLfiOpUsW8ef7x3LG2YMAmPL2eHbfux/3Dn+LLTpty+ArzyKEVdzx4CscccxveOCuqyppi9Ys/l3VHOn70vuzbFxOWkn8u6q5cq2Y/CWEMDuEMB94Gtg+CT8BeCCE8E4I4QfgMqC3pC3KkIe/hBC+CiF8D5wIPBtCeDaEsCqE8BLxHSUHSdoc2Am4IqnovJbkxaoAFxJls233nZj24WQApv93Ml27p064aWHb7cgOO+1Fuw6bI4ltt9uJHjvsyvQkzq57Hsw7E8fxww/fAzDhtTH03vNAAN4c/zQ/77Un2++4J3Xq1KHHDruyZZfuvDvptaz5efPVMfQ/9rc0a96Kps1a0v/Y3/LG+DU/L9URRx5/DhtsUJ/6DeJLnbbp1ouf9dydunXrsctufVm8eD6HHnkG9eptQO89DmLunFksW7q4YjZgDePfT+3g/Vw2LictxZX82iPXBpDfpP2/HNg4+X9j4J3UhBDCUknzgE2AmTmm/VXa/x2BoyT1SwvbABiXLGtBCGFZ2rQvgM1yXI5VEjf5Kl3X7r146dkRLF2ykMWLF9B+4440bd6Ke27/I0uXLOSrLz+ha/cdeXfy6zw+4m6+mT2TEAI//PA9m3XcCoD2G3dk40078c7E8fTcuQ/vTBzHdbeNAuC7ObOZ+OYLTHl7/Oplrlyxgm49ds6anwXz59C67carv7duuzEL5s9Z/b1p05bUr99grXmaNV/zgqf69RvSpGkL6tSN+7p+gxi3qGg5jRo3XY8tVTP5xGpu8lU6l5O1m8vJ2ml9e2bNJlYmAEj6iLQCZpUhjfQXqXwF/D2EcGZmJEkdgRaSGqVVTjbPmN+qIJ+A17VV1+1ZvnwJ414cxdZddwBgo40a06JlG8a9OIoWLdvSolVbBp5zGL/5w/X02mUf6tXbgFuvO5eQdsjvuudBvPXas4RVq9hks8603zj+HFu27sBue/fjzHOuzik/LVq25bs5s9l08y5A7PTZomXbNRE8Is1680nWiuObOdm5nKx9XE5ark25ijMCOFXS9kkH9+uB/4QQZpYzvX8A/STtL6mupIaS+kjaNITwBbFZ11WS6kvaHehXcnJW1fhRbFS/QUM6ddmOZ594mG2691odvk23njz7xMN07d6LFT/9xE8rfqRps5bUrVuPdye/ztQpE9ZK5xd7HMTUKRMY+9yj7LrnwavDd+9zCFMmjuf9d95g1cqV/PjjD/x36kTmffcN2fTe80Ce+OdQFi+az5LFCxg98q/s1ueQiln5WsTHu5WHj5vI5WTt4OPd0q3XE5MQwlhJVwD/Ir40cQJw7Hqk95Wkw4AhxErPSmAi8NskyvHAQ8B84C3gYWKneQAkLQUODCH4le/VQG2/S9i1+47MmPYu23TruTpsm+69eHHMcLp235ENN2rEyWdexl8GX8iKFT+yw0596LnL3mul0aJlG7bq+nM++mAS5w28ZXV4qzYduOCPdzJi2C3cefPF1KlTl85b9+DU316RNS+HH/0bvl++jMvOOwKAnXfbn8OP/k0FrHXN55Or5VNtf+LscrLmcRlpJVEI1bcllKRBQJdswwX37NkzvPqa6yfVVW08AVv15JOsFYrLSasuXE5Wb02bNJ4cQqiYFwZlWN+mXGZmZmZmZuvNryW1Kqm2N1+wqs13/6wqcDlpVZnLSSuPal0xCSEMKnQerOL55GtVgU+yVpW5nLRCcxlp+VCtKyZW+9T2DvNWeXySterKlRSrLC4nLd/cx8TMzMzMzArOT0ysWvOdQcsn3/2zmsZPmS3fXE5aRXLFxGoMV1KsPHyStdrE5aSVh8tJqyyumFiN5LuEVhyfYM0iV1KsOC4nrVDcx8TMzMzMzArOT0ysVvCdwdrNd//MSuanzOZy0qoCV0ys1nElpXbwSdas/FxO1g4uJ62qccXEajWffGsWn2TN8s/lZM3hMtKqOvcxMTMzMzOzgvMTE7OE21hXP777Z1a5XE5WPy4nrTpxxcSsGG6+UDX5JGtWdbicrJpcTlp15YqJWQ588i0sn2TNqj6Xk4XjMtJqCldMzMrITRkqnk+yZtWbKykVz+Wk1UTu/G5mZmZmZgXnJyZm68l3BvPDd//MaiY/Zc4fl5NW07liYpZHrqSUjU+yZrWPy8mycTlptYkrJmYVxHcJs/NJ1sxSXElZl8tIq81cMTGrJLX1BOyTrJnlojbfzHE5aRa5YmJWAMWdhKrzidgnVjPLp5pWTrqMNCudKyZmVUh1umPok6yZFUJ1evrsctKsbFwxMavCqsIdQ59YzayqKql8qqxy0mWkWf64YmJWDflEaGZWMpeTZtWPX7BoZmZmZmYF54qJmZmZmZkVnCsmZmZmZmZWcK6YmJmZmZlZwbliYmZmZmZmBeeKiZmZmZmZFZwrJmZmZmZmVnCumJiZmZmZWcG5YmJmZmZmZgXniomZmZmZmRWcKyZmZmZmZlZwrpiYmZmZmVnBuWJiZmZmZmYF54qJmZmZmZkVnCsmZmZmZmZWcK6YmJmZmZlZwbliYmZmZmZmBeeKiZmZmZmZFZwrJmZmZmZmVnCumJiZmZmZWcG5YmJmZmZmZgWnEEKh81AhJM0FvihwNloD3xU4D1b1+TixXPlYsVz4OLFc+VixXGwTQmhSGQuqVxkLKYQQQptC50HSpBDCjoXOh1VtPk4sVz5WLBc+TixXPlYsF5ImVday3JTLzMzMzMwKzhUTMzMzMzMrOFdMKta9hc6AVQs+TixXPlYsFz5OLFc+ViwXlXac1NjO72ZmZmZmVn34iYmZmZmZmRWcKyZ5JqmbpJclLZc0W9LVkuoWOl9WNUjaRNJSSUFS4ySsg6SbJL2XTPtK0kOSNi50fq1ySTpW0jvJcTBL0sMlHQeSbkuOpZsrM59WuSR1kTRU0vuSVkoanzG9TGWIpLMkfSCpSNK3kh6tlBWxClXacZIWr4ekZyQtkrRE0kRJvTLilKkssupD0lGSnkr261JJkyUdlxHnGEmPS/o6OccMKCatTSSNTo6j7yTdKWmj9cmfKyZ5JKkFMBYIwGHA1cCFwFWFzJdVKTcBSzPCegFHACOAfsDFwC7AhFTlxWo+SYcSj4EJxPJjILAnMEbSOmW1pG7A6cDiysynFUR34CBgOvBxluk5lyGSrgWGAMOA/YFz8XssaorSjhMkbU8sYxYCxwBHAU8DG6bFKVNZZNXOBcTrkD8AhwLjgOGSzk2L8ytgC+CZ4hKRtAHwAtAROBb4PfF4Wq/+KO5jkkeSLgMuATqGEBYnYZcAg4D2qTCrnSTtCTwBXE+soDQJISyV1BxYGkJYkRZ3a+LJZUAI4aECZNcqmaSRwFYhhF5pYYcCTwLdQggfZcR/mXjhcBIwKoRwUWXm1yqPpDohhFXJ/6OA1iGEPmnTm5NDGSKpO/A+cEAI4aXKWwOrDKUdJ0n4v4HPQgjHl5BOmcoiq14ktQ4hfJcRNhzoHULYMvleJ4SwKrmxsQQ4NYQwLGOe44B/AF1CCJ8nYUcDI4kvZJxRnvy55ptfBwIvZFRARhLvROxVmCxZVZA057uD+BRtrQIhhLAw/YIiCfsYWA740XntsQGwKCNsYfJX6YGSfgV0BW6s+GxZoaUuNkuYnmsZcgrwiSslNVNpx0nylHUX4rmoJDmXRVb9ZFZKElNIKytKO5YSBwJvpyoliSeAH4EDyps/V0zyqyswLT0ghPAl8eTQtSA5sqriN0AD4K5cIkv6GbARxTyOtxrpAWAPSSdLaprc8b4WeCWE8N9UJEkbArcAl4YQlhUor1bFFVOG7AJ8IGlQ0h78B0ljJW1bmFxaJdsl+dsi6Y+0QtKnkk7PiJdTWWQ1Sm/Kfr2R7Zr3R+BT1uOa1xWT/GrBmrsK6RYk06wWktQKuAa4IITwUw7x6wB/BmYAT1Vw9qyKCCGMAQYQ2+cuIjbDqQscmRH1MuBr4iN0s3WUUIa0B/oCRwNnEtuRtwGel9SwsvNpla598vdh4BHgl8DzwH2SDkpFKkNZZDWApH2Bw4k3vMqiQq55XTExq3jXAf8OITybY/wbiHcvTsqlImM1g6S9gXuIF5R7EzsTtgRGJ00BkbQlcBHw++AOgla84soQAY2AI0MIo0MITxM7zW8CnFD52bRKlmqGdV8IYUgIYVwI4Wxi5+fLVkfKoSyymkHSFsBw4MnMPiSFUq/QGahhFgDNsoS3SKZZLZN0Nj0N2DPpoAqxeQVAM0krQwjfp8X/HXFEneNCCP+p1Mxaod0CPBVCGJgKkPQu8VH5YcDjxD4lzwHT046nOkCD5PsiV1hqt1LKkAXAt+mdl0MIn0maCXSrvFxagaSuQ8ZlhL9CHKEpJZeyyKo5SS2J55MvKN+NiZKued8rb778xCS/ppHRrk7SZsQL0WlZ57CabitiR8K3iD/iBazpZ/I/0johSjoy+X5JCMHvFah9ugLvpgeEEKYD3wOdk6BtgP6sOZYWAJsB5yT/b1JJebUqKIcy5COyd14WkEtnV6veUhXSzGMgc//nUhZZNZa8a+QZoD5wSAhheTmSyXbNWx/oxHpc8/qJSX49B1wsqUkIYUkSdgzxx/xq4bJlBfQG8VF4ugOI48IfBHwGIKkPsc3vHSEEvyyvdvoC6JkekHRK3hCYmQSdAWS+22YksXz5KzC3YrNoVVWOZcgzwCmSuqU6MUvqTHwPQbnvcFq1MYF4A2MfYt+SlH1Ze//nUhZZNSWpHvAY8cbpriGEOeVM6jngeEkdQwhfJGGHEgf6eb742Urmikl+3QOcBzwuaTCx1jgIuNXvMKmdkmH5xqeHJW06AV5P3mOyLXGIvWnAo5J+kRZ9bgjh00rIqhXePcBtkmYTC/x2wP8RLwSeBQghTMqcSVIR8FUIYXyl5dQqVXJ3M9U5eROgaTJkNMRjoyO5lSGjgXeI56g/ASuJQ5h/DPgpbTVX2nESQlgu6WpgiKSFwNvEDu17svYrDUoti6xau5t4nPweaJUM0JMyJYTwQzK0dDcgNSjGjpKWEsuT1I32UcAfieXJFcRmXbcBw8v7DhPwCxbzLtmZdxI7Hi4E7gMGhRBWFjJfVnVIGgA8yJoXLKa+Z/NQCGFAJWXNCkiSiMNK/5bYXGIh8YnbZSGEz0qYbyZ+wWKNltzM+LyYyVsCfcixDJHUDrideGFSBxhLHEzhy/zk1gqltOMkhDAziXcBcC6x8jIduDKEsLrfSHnLIqseknNGx2ImbxlCmClpEHBllumvZrzcdVPiNe9+wA/EJ/gXl7NpWEzTFRMzMzMzMys0d343MzMzM7OCc8XEzMzMzMwKzhUTMzMzMzMrOFdMzMzMzMys4FwxMTMzMzOzgnPFxMzMzMzMCs4VEzOzMpA0QNJkSUskLZA0RdKteV7Gzsk48rWCpEGSvstDOlsnaTXPCB8gKUhqvL7LWF+SnpKU7f0A6XEOSfK7RfK9bbJeW2TE21HSfEnNKi7HZmaVxxUTM7McSbqM+NLUF4D+wMnAk8CheV7UzmR/uZWVbGvidmueET6G+NLbcr/0Kx8k7QLsA9xRxlnbEtdri/TAEMIkYArwh3zkz8ys0OoVOgNmZtXIOcDQEMLlaWFPS7qqUBmy0oUQ5gJzC50P4DzgyRDC/Dym+SBws6RrQwgr8piumVml8xMTM7PcNQe+yQwMIYTU/5ImShqWGUfSMElTkv83kHSzpC8l/SBptqTRkupLGkByRz1pzhMkjU9LZztJY5KmZEskPSapfdr0Psk8+0p6UtIySTMk9ZVUV9JNkr6TNEvSBbmstKQzJU2VVCTpW0mjJDWTdJCkVZK2zIi/ZRJ+WFrYEcm2+V7SPEnPSupYwjJbSro3WV6RpAnJE4fi4vcBnk6+fp5sg5nJtLWacknaIvl+rKQHJS2W9D9JJybTL0n2yVxJgyXVyVhWifugmPw1AY4ARmWEK2mmNSdJ62Ggadr0LYCpyddxqWMiLYmngJbA/iUt38ysOnDFxMwsd+8A50o6RVKrYuLcD/wqvT9D8v+vgAeSoMuAE4ArgF8C5wOLgLrEZke3JPF6J5/fJel0Ad4EGgInAgOA7sSnNsrIx1DgDeLF8BfEC+I7gSbA8cn3W0q62E+W+ackrVeBw4HfJnltTGzSNhs4JWO2AcCcZF2QdBLwOPApcDRwKvAx0KaYZTYAxgL7ARcny50LjC2hAvAOcFHyf3/idjuipHUDBgNfA0cCrwMPSbqF2JTuNOB24JIkz6m8lWUfpNsV2BCYkBF+HvB/wL3EY+R7YEja9K+JxwrA2aw5JgAIISwGPiRuKzOz6i2E4I8//vjjTw4f4GfAZ0AAVhEvCK8GmqbFaQosA05NCzsN+AFolXx/BrilhOWcQ/IgJiP878B0oH5a2FbASuDg5HufJH9XpsXploS9khZWh/j0Z3AJ+WhO7JdxawlxrgU+B5R8FzATuDltObOAx0tIYxDwXdr304Efga3SwuoRKzY3lZDOIcl6bpERPiAJb5x83yL5/mDGfvsJmAHUTQufCDxaln1QTN4uB+ZmhNUlVuz+mhH+Uvp6ANsl3/sUk/Yw4M1C/z788ccff9b34ycmZmY5CiG8D2xL7Ox+N/Ei/ApgUuoJSYh3sEcRL4ZTBgBPhRDmJd/fBQYkTYZ+Vsqd9nT7AaOBVZLqSapHrBTMBHbMiPty2v+fJH9fSVuXVcRK1iYlLK838S7/gyXEeQDoSKwQAeydfE/Nsw2wcSlpZNoPmExskpVaT4hPbTLXc32s3kbJfpsLvBpCWJkW5xPW3kZl2Qfp2gOZI49tBnQgDqCQ7vEyrANJuiU2JTMzqw5cMTEzK4MQwg8hhKdDCOeEELoBZxDvmJ+eFu1+YA9JnSR1BvZgTTMuiE8Z7iI20XoP+ErS73NYfGtgIPHOfvqnE/EiN93CtDz/mBmW+JHYJKk4qeZqXxcXIYTwGTCe2DyL5O/EEMKHuaaRRWvgF6y7nqey7nquj4UZ338sJix9G5VlH6RrSHxqli5VmZiTEZ75vTQ/UPJ+NDOrFjwql5nZeggh3C9pCNA1Lew1STOIT0pEbK7zYtr0ImK/gv+TtBXwG+B2SdNDCM+XsLj5xLv192WZtt7vAcki9YSnQynp3wf8TXE45f7AhcWkkav5wCRif5ZMmRf3la28+2A+6w5jnBpIoW1GeOb30jRP0jczq9ZcMTEzy5GktiGEORlhbYBmwLcZ0R8g6bQOPJzRPGi1EMIMSRcROzZ3A54n3qVHUsOkEpPyMrGj9eQQQlgnsfx7i9gZ+xTWdCzP5nHiE6CRxCfxI9OmTSf2MTmFNaNmleZloC/wZeb2LkXqyVBFPj0o7z6YDmwsqUEIIVW5+opYOTmMuN9T+mfMW9p6bUEcTMDMrFpzxcTMLHdTJT1JfPoxh9iX4iJiB/GHMuI+RGyyVY+M/hWSRhP7UEwhXvj/Kon3WhJlWvL395JeARaHEKYTO4lPBMZIeoB4h34T4shew0II4/O1ogAhhIWSrgGuk1QfeBZoABwMXBVCmJXEK5L0CLFyNSKEsDAtjVWSLgEeSeKMIHbk3ieJOynLoh8mPkUaL+lmYl+YVsTRsr4JIdxWTJanJ39/LWkksDyEMLWYuOU1iPLtgzeBDYAexKdBhBBWJk/bbpb0HXFksCOJ/ZjSfUlSQZS0CPgpY7vtSBxhzMysWnMfEzOz3F1NvDv9F2Ll5BriyFw7hxA+T48YQvgG+A9xtKTMu9kTiEPgDid2fO4FHJl2sfk6cBPw+ySNoUmaHxP7XiwnDi/7HHAVsXnTJ1SAEMINxCZV+yV5HUpsOrQkI+oTyd8HMsIJIQwnXnB3JQ4M8HDyf9aXHiZPifYmjk51FXFb/5nYl2diCXn9glhR7E+sCOT6hCZn5d0HyXwfAAdmTLoduJ5YEfsXcRjmSzLmLQLOJB4nrwJvp6ZJ2oE47HJZO8ybmVU5qpzWAGZmtYuklsQmTOeEEO4vdH4qWnLn/2igUzLil2WQ9Afg9BDCdnlM8wZgpxCC32NiZtWen5iYmeWRpCbJSwvvJD5VGFHgLFUoSdtIOoL4VOVOV0pKdC/QRlJeKhGSGhGfpFybj/TMzArNfUzMzPKrFzCO+Lb1k0MIywucn4o2FNgFeIrYxM2KEUJYJukUoFGektwcuDrffYvMzArFTbnMzMzMzKzg3JTLzMzMzMwKzhUTMzMzMzMrOFdMzMzMzMys4FwxMTMzMzOzgnPFxMzMzMzMCs4VEzMzMzMzK7j/B6rNCtgPGCFMAAAAAElFTkSuQmCC", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "with pulse.build(backend, name='Offset example') as program:\n", + " with pulse.phase_offset(3.14, pulse.drive_channel(0)):\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(0))\n", + " with pulse.frequency_offset(10e6, pulse.drive_channel(0)):\n", + " pulse.play(gaussian_pulse, pulse.drive_channel(0))\n", + "\n", + "program.draw()" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We encourage you to visit the [Pulse API reference](/api/qiskit/pulse) to learn more." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "import qiskit.tools.jupyter\n", + "%qiskit_version_table\n", + "%qiskit_copyright" + ] + } + ], + "metadata": { + "description": "Pulse gates notebook", + "language_info": { + "name": "python" + }, + "orig_nbformat": 4, + "title": "Pulse gates" + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/docs/optimize/index.mdx b/docs/optimize/index.mdx new file mode 100644 index 0000000000..3a0169bb26 --- /dev/null +++ b/docs/optimize/index.mdx @@ -0,0 +1,13 @@ +--- +title: Optimize Qiskit programs +description: Optimize Qiskit programs + +--- + +# Optimize Qiskit programs + +In the optimization phase, you fine-tune your build options to get the most out of the programs you have written. You can optimize your programs in any or all of the following ways: + +- [Set algorithm tuning options](algorithm-tuning-options). +- [Configure error suppression](error-suppression). +- [Configure error mitigation](error-mitigation). diff --git a/docs/run/backends.mdx b/docs/run/backends.mdx new file mode 100644 index 0000000000..f14ced2132 --- /dev/null +++ b/docs/run/backends.mdx @@ -0,0 +1,192 @@ +--- +title: Run on quantum backends +description: Instructions to run on systems and simulators. + +--- +{/* do we need this? */} + +# Run on quantum backends + +A **backend** represents either a simulator or a real quantum computer and are responsible for running quantum circuits, running pulse schedules, and returning results. + +In qiskit-ibm-runtime, a backend is represented by an instance of the `IBMBackend` class. Attributes of this class provides information about this backend. For example: + +* `name`: Name of the backend. +* `instructions`: A list of instructions the backend supports. +* `operation_names`: A list of instruction names the backend supported. +* `num_qubits`: The number of qubits the backend has. +* `coupling_map`: Coupling map of the backend. +* `dt`: System time resolution of input signals. +* `dtm`: System time resolution of output signals. + +Refer to the [API reference](../api/qiskit-ibm-runtime/qiskit_ibm_runtime.IBMBackend#ibmbackend) for a complete list of attributes and methods. + +## Connect to an instance + +You can specify an instance when initializing the service or provider, or when choosing a backend. See [Connect to an instance](instances#connect-instance) in the Instances topic for full details. + +**Examples** + +### qiskit-ibm-runtime + +```python + +# Optional: List all the instances you can access. +service = QiskitRuntimeService(channel='ibm_quantum') +print(service.instances()) + +# Optional: Specify it at service level. This becomes the default unless overwritten. +service = QiskitRuntimeService(instance="hub1/group1/project1") +backend1 = service.backend("ibmq_manila") + +# Optional: Specify it at the backend level, which overwrites the service-level specification when this backend is used. +backend2 = service.backend("ibmq_manila", instance="hub2/group2/project2") + +sampler1 = Sampler(backend=backend1) # this will use hub1/group1/project1 +sampler2 = Sampler(backend=backend2) # this will use hub2/group2/project2 +``` + +### qiskit-ibm-provider + +```python +from qiskit_ibm_provider import IBMProvider + +provider = IBMProvider(instance="hub1/group1/project1") +backend1 = provider.get_backend("ibmq_manila") +backend2 = provider.get_backend("ibmq_manila", instance="hub2/group2/project2") + +job1 = backend1.run(...) # this will use hub1/group1/project1 +job2 = backend2.run(...) # this will use hub2/group2/project2 +``` + + +## Initialize the service + +Before calling `IBMBackend`, initialize the service: + +```python +from qiskit_ibm_runtime import QiskitRuntimeService +# Initialize the account first. +service = QiskitRuntimeService() +``` + + +## List backends + +To view the backends you have access to, you can either view a list on the [Compute resources page](https://quantum-computing.ibm.com/services/resources?tab=yours), or you can use the `backends()` method. This method returns a list of `IBMBackend` instances: + +```python +service.backends() +``` + +``` +[, +, +, +, +] +``` + +The `backend()` (note that this is singular: *backend*) method takes the name of the backend as the input parameter and returns an `IBMBackend` instance representing that particular backend: + +```python +service.backend("ibmq_qasm_simulator") +``` + +``` + +``` + +## Filter backends + +You may also optionally filter the set backends, by passing arguments that query the backend’s configuration, status, or properties. For more general filters, you can make advanced functions using a lambda function. Refer to the API documentation for more details. + +Let’s try getting only backends that fit these criteria: + +* Are real quantum devices (`simulator=False`) +* Are currently operational (`operational=True`) +* Have at least 5 qubits (`min_num_qubits=5`) + +```python +service.backends(simulator=False, operational=True, min_num_qubits=5) +``` + +A similar method is `least_busy()`, which takes the same filters as `backends()` but returns the backend that matches the filters and has the least number of jobs pending in the queue: + +```python +service.least_busy(operational=True, min_num_qubits=5) +``` + +## Determine backend attributes + +As mentioned previously, the `IBMBackend` class attributes provide information about the backend. For example: + +```python +backend = service.backend("ibmq_qasm_simulator") +backend.name #returns the backend's name +backend.backend_version #returns the version number +backend.simulator #returns True or False, depending on whether it is a simulator +backend.num_qubits #returns the number of qubits the backend has +``` + +See the [IBMBackend class documentation](../api/qiskit-ibm-runtime/qiskit_ibm_runtime.IBMBackend#ibmbackend) for the full list of backend attributes. + +## Find backend information from other channels + +To find your available systems and simulators on **IBM Cloud**, view the [IBM Cloud Compute resources page](https://cloud.ibm.com/quantum/resources/your-resources). You must be logged in to see your available compute resources. You are shown a snapshot of each backend. To see full details, click the backend name. You can also search for backends from this page. + +To find your available systems and simulators on **IBM Quantum Platform**, view the [Platform Compute resources page](https://quantum-computing.ibm.com/services/resources). You are shown a snapshot of each backend. To see full details, click the backend name. You can also sort, filter, and search from this page. + +## Specify a backend when running a job + +If you are using a runtime session, add the `backend` option when starting your session. For details about working with sessions, see [Run jobs in a session](run-sessions). + +```python +from qiskit.circuit.random import random_circuit +from qiskit.quantum_info import SparsePauliOp +from qiskit_ibm_runtime import QiskitRuntimeService, Session, Estimator, Options + +circuit = random_circuit(2, 2, seed=1).decompose(reps=1) +observable = SparsePauliOp("IY") + +options = Options() +options.optimization_level = 2 +options.resilience_level = 2 + +service = QiskitRuntimeService() +with Session(service=service, backend="ibmq_qasm_simulator") as session: + estimator = Estimator(session=session, options=options) + job = estimator.run(circuit, observable) + result = job.result() + # Close the session only if all jobs are finished, and you don't need to run more in the session + session.close() # Closes the session + +display(circuit.draw("mpl")) +print(f" > Observable: {observable.paulis}") +print(f" > Expectation value: {result.values[0]}") +print(f" > Metadata: {result.metadata[0]}") +``` +If you are not using a runtime session, you can pass the backend when initializing the primitive class. + +``` python + from qiskit.circuit.random import random_circuit + from qiskit.quantum_info import SparsePauliOp + from qiskit_ibm_runtime import QiskitRuntimeService, Session, Estimator, Options + + circuit = random_circuit(2, 2, seed=1).decompose(reps=1) + observable = SparsePauliOp("IY") + + options = Options() + options.optimization_level = 2 + options.resilience_level = 2 + + service = QiskitRuntimeService() + estimator = Estimator(backend="ibmq_qasm_simulator", options=options) + job = estimator.run(circuit, observable) + result = job.result() + + display(circuit.draw("mpl")) + print(f" > Observable: {observable.paulis}") + print(f" > Expectation value: {result.values[0]}") + print(f" > Metadata: {result.metadata[0]}") + ``` \ No newline at end of file diff --git a/docs/run/circuit-execution.mdx b/docs/run/circuit-execution.mdx new file mode 100644 index 0000000000..ea2abedb54 --- /dev/null +++ b/docs/run/circuit-execution.mdx @@ -0,0 +1,29 @@ +--- +title: System circuit execution +description: Explanatory content on fixed and dynamic repetition rate execution + +--- + +# System circuit execution + +## Fixed repetition rate execution + +Most IBM Quantum systems execute circuits at a fixed rate. Although this *repetition rate* varies by system, the underlying execution model is the same, and is described here. First, consider three circuits sent to a system using separate jobs, one for each circuit. The example below shows what happens for jobs of varying lengths. Because of the fixed repetition rate, there is a variable amount of *idle time* that occurs before the start of a circuit in order to make the entire duration match that given by the system repetition rate. + +![../../../\_images/fixed\_single\_circuit1.png](/images/migration/fixed_single_circuit1.png) + +The situation changes somewhat when the same circuits are batched into a single job. In this case the circuits included in the job are executed by iterating over the circuits for each shot requested; the execution is column-wise over a matrix of circuits and shots (see below). + +![../../../\_images/circuits\_shots\_matrix1.png](/images/migration/circuits_shots_matrix1.png) + +Matrix of four circuits in a job showing the execution pattern over the circuits. + +When submitting batches of circuits to the systems, the circuits are executed differently than they would be if executed separately. Namely, the initialization of the circuit, i.e. prepare the ground state, and measurements (if any) are aligned over all circuits. + +![../../../\_images/fixed\_batch\_circuit1.png](/images/migration/fixed_batch_circuit1.png) + +Therefore, each circuit is equal in duration to the longest circuit in the batch, and there is a common idle time that is placed in front of all circuits to match the repetition rate. + +## Dynamic repetition rate execution + +Some IBM Quantum systems allow for dynamic repetition rate execution. These systems are identified in Qiskit using `backend.configuration().dynamic_reprate_enabled`, and return a value of `True`. On these systems, it is possible to manually set the above idle time by setting the `rep_delay` of the submitted job. One can see from the above figures that by reducing the idle time one can potentially see a greater throughput of circuits on the systems that support dynamic repetition rates. See the the next section on conditional reset for more detailed usage examples. \ No newline at end of file diff --git a/docs/run/estimate-job.mdx b/docs/run/estimate-job.mdx new file mode 100644 index 0000000000..828217f351 --- /dev/null +++ b/docs/run/estimate-job.mdx @@ -0,0 +1,60 @@ +--- +title: Estimate job run time +description: Estimate how long a job that uses a primitive will take to run + +--- + +# Estimate job run time + +After submitting a job to the IBM Quantum channel, you can see an estimation for how long the job will take to run in quantum seconds. You can use `job.usage_estimation`. Alternatively, you can view this information on the IBM Quantum Platform user interface. + + + - This only applies to jobs that use primitives. + - This is not yet available on the IBM Qiskit Runtime on Cloud channel. + + +Example: + +```python +from qiskit import QuantumCircuit +from qiskit_ibm_runtime import QiskitRuntimeService, Sampler + +service = QiskitRuntimeService() + +# Create a new circuit with two qubits (first argument) and two classical +# bits (second argument) +qc = QuantumCircuit(2, 2) + +# Add a Hadamard gate to qubit 0 +qc.h(0) + +# Perform a controlled-X gate on qubit 1, controlled by qubit 0 +qc.cx(0, 1) + +# Measure qubit 0 to cbit 0, and qubit 1 to cbit 1 +qc.measure(0, 0) +qc.measure(1, 1) + +# Run on the least-busy backend you have access to +backend = service.least_busy(simulator=False,operational=True) + +# Create a Sampler object +sampler = Sampler(backend) + +# Submit the circuit to the sampler +job = sampler.run(qc) + +print(job.usage_estimation) +``` + +Output: + +```python +{'quantum_seconds': 4.1058720028432445} +``` +## View the estimated job usage on IBM Quantum Platform + +You can view the estimated usage (in quantum seconds) in two places on IBM Quantum Platform: + +- On the [Jobs table](https://quantum-computing.ibm.com/jobs) in the Usage column. From the Home page, click *View all* on the Recent jobs table. The Usage column shows the estimated usage for pending jobs, or actual usage for completed jobs. +- On the job's details page. From the [home page](https://quantum-computing.ibm.com/) or [Jobs table](https://quantum-computing.ibm.com/jobs), click the job ID to open the job details page. The estimated usage is shown in the Status Timeline. \ No newline at end of file diff --git a/docs/run/hardware.mdx b/docs/run/hardware.mdx new file mode 100644 index 0000000000..013e9be09e --- /dev/null +++ b/docs/run/hardware.mdx @@ -0,0 +1,273 @@ +--- +title: Hardware +description: Information on IBM Quantum hardware, features of different processors, and system calibration, properties, and versioning + +--- + +# Hardware overview + +## About IBM Quantum hardware + +IBM Quantum offers both open and premium access to a wide variety of quantum systems. All quantum systems deployed by IBM Quantum are based on superconducting qubit technology, as the control and scalability of this technology pave a clear path to achieving quantum advantage with these systems. You can see the full details of all IBM Quantum systems on the [Compute resources page](https://quantum-computing.ibm.com/services/resources?tab=systems). + +{/* ## Paths + +programmatic (Python), API, web -- need to fill out!! */} + + +## Processor types + +Processor types are named for the general technology qualities that go into builds, consisting of the family and revision. Family (e.g., Falcon) refers to the size and scale of circuits possible on the chip. This is primarily determined by the number of qubits and the connectivity graph. Revisions (e.g., r1) are design variants within a given family, often leading to performance improvements or tradeoffs. Segments are comprised of chip sub-sections, and are defined within a given family. For instance, segment H of a Falcon consists of seven qubits arranged as seen in the illustration below. Segment H on a Hummingbird, if implemented, could be entirely different. + +![../../../\_images/seg-h.png](/images/migration/seg-h.png) + +Illustration of segment H on a Falcon processor. + +### Osprey + +![Osprey processor icon](/images/migration/osprey.svg) + +Osprey is nearly quadruple the size of Eagle at 433 qubits. The larger chip sizes have required further enhancements to device packaging, as well as custom flex cabling in the cryostat to fit the greater I/O requirements within the same wiring footprint. + +* [View available Osprey systems](https://quantum-computing.ibm.com/services/resources?type=Osprey) + +### Eagle + +![Eagle processor icon](/images/migration/eagle.svg) + +At 127 qubits, the Eagle processor family incorporates more scalable packaging technologies than previous generations. In particular, signals pass through multiple chip layers so as to allow for high-density I/O without sacrificing performance. + +See [this blog post](https://research.ibm.com/blog/127-qubit-quantum-processor-eagle) for more about the Eagle processor family. + +* [View available Eagle systems](https://quantum-computing.ibm.com/services/resources?type=Eagle) + + + `r3` (December 2022) Eagle r3 is a version of the 127-qubit processor with enhanced coherence properties but otherwise similar design parameters to Eagle r1. + + `r1` (December 2021) At the qubit level, Eagle r1 uses similar design elements and parameters to Falcon r5.11, enabling similarly fast readout. Gate speeds and error rates should also be similar. + + +### Hummingbird + +![Hummingbird processor icon](/images/migration/hummingbird.svg) + +Using a heavy-hexagonal qubit layout, the Hummingbird family allows up to 65 qubits. + +* [View available Hummingbird systems](https://quantum-computing.ibm.com/services/resources?type=Hummingbird) + + + `r3` (December 2021) This version of Hummingbird with 65 qubits has enhanced coherence properties. + + `r2` (August 2020) Released in 3Q 2020, this revision contains 65 qubits. Improvements previously demonstrated on Falcons, like readout multiplexing, space-efficient qubit-qubit couplers, and flip-chip technology enhanced the capabilities of the Hummingbird family and led to a scalable 65Q design. + + `r1` (October 2019) This revision is the first attempt at supporting a large (>50) number of qubits on a chip. + + +### Egret + +![Egret processor icon](/images/migration/egret.svg) + +Egret brings the innovations of tunable couplers onto a 33-qubit platform, resulting in faster and higher-fidelity two-qubit gates. + +* [View available Egret systems](https://quantum-computing.ibm.com/services/resources?type=Egret) + + + `r1` (December 2022) The first realization of the Egret processor has demonstrated the highest Quantum Volume among IBM Quantum systems and a substantial improvement in two-qubit gate error rates ([https://research.ibm.com/blog/quantum-volume-256](https://research.ibm.com/blog/quantum-volume-256)). This new quantum processor boasts a substantial speedup and fidelity improvement (many gates approaching 99.9%) in two-qubit gates while reducing spectator errors. + + +### Falcon + +![Falcon processor icon](/images/migration/falcon.svg) + +The Falcon family of devices offers a valuable platform for medium-scale circuits, and also serves as a valuable platform for demonstrating performance and scalability improvements before they’re pushed onto the larger devices. + +* [View available Falcon systems](https://quantum-computing.ibm.com/services/resources?type=Falcon) + + + `r8` (September 2021) In addition to the features of r5.11, Falcon r8 has enhanced coherence properties. + + `r5.11` (January 2021) In addition to the filtering in r5.10, design improvements target speed-ups in qubit state readout. An essential requirement for quantum error correction demonstrations is fast readout. To enable this, the paradoxical requirements of stronger readout coupling yet protection from qubit relaxation is accomplished with advanced filtering techniques and fine tuning of various components’ couplings on-chip. This revision, combined with the latest in control electronics, enables mid-circuit measurements. + + `r5.10` (December 2020) This revision pioneered advanced on-chip filtering techniques that eventually led to the faster qubit state readout in r5.11. The filters reduce qubit relaxation and preserve lifetime. Additionally, space-saving “direct-couplers” are used to couple qubits together, essential for scaling to larger bird families. + + `r4` (April 2020) Adding to the capabilities of r1, the r4 is the first revision in the large birds to deploy multiplexed readout. Previous designs required an independent signal pathway on the chip, as well as in the dilution refrigerator and control electronics for qubit state readout. + + `r1` (February 2020) The first generation of the Falcon family, r1 is a 28Q offering independent readout, contrasting to the multiplexed configurations in the other revisions. The flip-chip technology allowed scaling to a larger number of qubits. The heavy-hex connectivity graph is employed for the first time here, optimal for our two-qubit gate of choice, cross-resonance. + + +### Canary + +![Canary processor icon](/images/migration/canary.svg) + +The Canary family comprises small designs containing anywhere from 5 to 16 qubits. It uses an optimized 2D lattice. That is, all of the qubits and readout resonators are on the same layer. +* [View available Canary systems](https://quantum-computing.ibm.com/services/resources?type=Canary) + + + `r1.3` (December 2019) A stripped-down offering containing only a single qubit. + + `r1.1` (May 2017) Using the similar design processes to r1, r1.1 extends the design to include 16 qubits. + + `r1` (January 2017) Initial 5Q design with resonators and qubits all on a single lithography layer. + + +## System configuration values + +The following is a subset of system configuration values available in IBM Quantum and from [Qiskit](/api/qiskit/qiskit.providers.models.BackendConfiguration). + +These values are shown on both the Systems and Simulators tabs of the [Compute resources page](https://quantum-computing.ibm.com/services/resources?services=systems) and the details page for each system. + +* **Name** - The unique name assigned to a specific quantum system or simulator. Backends hosted on IBM Cloud® have names that begin with `ibmq_*` (older systems) or `ibm_*` (newer systems). All quantum systems are given a city name, e.g., `ibmq_johannesburg`. This name does not indicate where the actual quantum system is hosted. They are named after IBM locations around the world. +* **Qubits** - The number of qubits in a system. For physical quantum systems, this is the number of physical qubits in the device. For simulators, this number need not be uniquely defined, and instead can depend on the simulation method and/or the amount of memory available. +* **QV** - Quantum volume. This value measures the performance of gate-based quantum computers, regardless of their underlying technology. +* **CLOPS** - CLOPS, or circuit layer operations per second, is a measure of how many layers of a QV circuit a QPU (quantum processing unit) can execute per unit of time. Find more information about this metric in the paper called [Quality, Speed, and Scale: three key attributes to measure the performance of near-term quantum computers.](https://arxiv.org/abs/2110.14108) +* **Status** - The system status. +* **Total pending jobs** - The total number of jobs that you have submitted to this system. +* **Processor type** - Reflects the system topology and indicates the approximate qubit count. +* **Features** - Additional information about the system, such as whether it can be reserved and whether it supports pulse inputs. + +**Additional information available on the details page for each system** + +To access the details page, click the name of the system on the **Compute resources** page. + +* **Version** - The version number of a system in the form `major.minor.revision`. See [System versioning](#system-versioning) for details on how this number is assigned. + +* **Calibration data** (Available for systems only) - Download the calibration data as a .csv file or click the arrow to display the Topology diagram, Individual qubit readout graph, or the Calibration data table. You can customize the data that is shown, depending on the view you have open. For example, on the Topology diagram, you can choose the data you want to see for connections and qubits. The colored bars associated with the diagram or graph indicate the range that is shown, with the average value marked. The color maximum and minimum change depending on the system. + + > * **Topology diagram** or **coupling map** - A diagram that indicates the pairs of qubits that support two-qubit gate operations between them. This is also called the coupling map or connectivity. Qubits are represented as circles and the supported two-qubit gate operations are displayed as lines connecting the qubits. + > * **Individual qubit properties** - Shows the selected property for each qubit on the system. You can view the frequency, T1, T2, Anharmonicity, probability measurements, error rates, and so on. + +* **Your access instance** - Instances that you can use. Click the arrow on the right to expand or collapse this section. For each instance, you can see the following information: + + * **Max shots** - The maximum number of times you can execute a single circuit on a system. The number of shots taken determines the precision of the output probability distribution over repeated executions. + * **Max circuits** - The maximum number of quantum circuits that you can submit to this system at one time. + * **Max qubits per pulse gate** - The maximum number of qubit arguments allowed to a gate. + * **Max channels per pulse gate** - The maximum number of channels you can refer to within a pulse schedule. Typically each qubit is associated with a drive channel, a measure channel, an acquisition channel, and then auxiliary control channels for things like cross resonance. + * **Usage** - Click the link to see the jobs that you have run on this system. + +### View system configuration + +View system configuration values by selecting a system on the Systems tab of the [Compute resources page.](https://quantum-computing.ibm.com/services/resources?services=systems) The three tabs in the Calibration data section let you choose how to view the calibration data; the Map view tab is automatically selected. + +![../../../\_images/exp-card.png](/images/migration/exp-card.png) + +An expanded card for a sample system. + +Click the download icon in the upper right of any tab to download a CSV file of calibration data. + +![../../../\_images/graph-view1.png](/images/migration/graph-view1.png) + +The Graph view tab. + +![../../../\_images/table-view.png](/images/migration/table-view.png) + +The Table view tab. + + +## View system properties + +In contrast to the [system configuration](#system-configuration-values) that remains static on the timescale of typical experiments, the **properties** of a system are dynamical quantities that update at system calibration time. Systems are nominally calibrated once over a 24-hour period, and the system properties update once this calibration sequence is complete. The properties play a critical role in quantum circuit execution, as the parameters within the properties are utilized for noise-aware circuit mapping and optimization (transpilation). Additionally, system properties are used for constructing noise models of a system for use in classical simulation methods. + +You can most easily obtain a quantum system’s properties with Qiskit, but you can also obtain them by downloading the “calibrations” CSV file for a given system on IBM Quantum (see [View system configuration](#view-system-configuration) for more information). + +* **system name** - `system.properties().backend_name` gives the name of the system. + +* **system version** - `system.properties().backend_version` specifies the version of the system, as described [in the system versioning section](#system-versioning). + +* **last update date** - `system.properties().last_update_date` gives the local time at which the properties information was last updated. This is the time at which the full properties file was returned from the system. Individual elements in the properties give the times at which they were computed. Depending on the device calibration schedule, these times can be markedly different than the last update date. + +* **qubits** - `system.properties().qubits` contains information on the physical attributes of the qubits. This includes the qubit frequency in GHz, T1 and T2 times in µs, and readout error. As shown below, the readout\_error is further partitioned into `prob_meas0_prep1` and `prob_meas1_prep0`, indicating the probability of preparing a given computational basis state, but measuring the orthogonal state. The readout error is taken to be the average of these two values. Note that `prob_meas0_prep1` is usually the dominant factor in the readout error due to relaxation during the measurement process. The qubits field is a list indexed by the qubit number. + + ```python + [Nduv(datetime.datetime(2020, 12, 7, 9, 5, 37, tzinfo=tzlocal()), T1, us, 134.6122100394965), + Nduv(datetime.datetime(2020, 12, 7, 9, 6, 19, tzinfo=tzlocal()), T2, us, 69.51042482642832), + Nduv(datetime.datetime(2020, 12, 7, 9, 21, 20, tzinfo=tzlocal()), frequency, GHz, 4.743896496595851), + Nduv(datetime.datetime(2020, 12, 7, 9, 21, 20, tzinfo=tzlocal()), anharmonicity, GHz, -0.31386048358781926), + Nduv(datetime.datetime(2020, 12, 7, 9, 4, 47, tzinfo=tzlocal()), readout_error, , 0.06969999999999998), + Nduv(datetime.datetime(2020, 12, 7, 9, 4, 47, tzinfo=tzlocal()), prob_meas0_prep1, , 0.0796), + Nduv(datetime.datetime(2020, 12, 7, 9, 4, 47, tzinfo=tzlocal()), prob_meas1_prep0, , 0.0598), + Nduv(datetime.datetime(2020, 12, 7, 9, 4, 47, tzinfo=tzlocal()), readout_length, ns, 5813.333333333333) + ] + ``` + + We see that each qubit parameter is expressed as an `Nduv` (name, date, unit value) object containing the local time at which the parameter was updated, the parameter name, parameter units, and the actual numerical parameter value. + + * **gates** - `system.properties().gates` gives detailed information on each gate that the system supports executing. For every single-qubit gate listed in the system basis gates, there exists an entry in the properties that gives the details of that gate, for each qubit on which the gate can be applied. Each entry is in the form of a `Gate` object: + + ```python + Gate(gate='u2', name='u2_0', parameters=[Nduv('2020-06-06T09:06:46Z', gate_error, , 0.00022436814887248838), Nduv('2020-06-06T10:03:18Z', gate_length, ns, 35.55555555555556)], qubits=[0]) + ``` + + and lists the kind of gate (`u2` in the example), its name, a list specifying the qubits on which the gate acts, and a `parameters` attribute, `gates.parameters`: + + ```python + [Nduv('2020-06-06T09:06:46Z', gate_error, , 0.00022436814887248838), + Nduv('2020-06-06T10:03:18Z', gate_length, ns, 35.55555555555556)] + ``` + + containing `Nduv` objects specifying the gate error and gate length. + + The same holds for multi-qubit gates, where there is an entry for each directed edge in the system [coupling map](#coupling-map). For symmetric coupling maps, the directionality of the underlying gate is still important. For example, + + ```python + Gate(gate='cx', name='cx3_4', parameters=[Nduv('2020-06-06T10:03:18Z', gate_error, , 0.009793933588297388), Nduv('2020-06-06T10:03:18Z', gate_length, ns, 327.1111111111111)], qubits=[3, 4]) + ``` + + versus + + ```python + Gate(gate='cx', name='cx4_3', parameters=[Nduv('2020-06-06T10:03:18Z', gate_error, , 0.009793933588297388), Nduv('2020-06-06T10:03:18Z', gate_length, ns, 362.66666666666663)], qubits=[4, 3]) + ``` + + +## System versioning + +Each system has a version number in the form X.Y.Z (major.minor.revision). A circuit compiled for a given system version number is guaranteed to run on that system. If the revision number changes, the circuit will continue to run. If the major or minor number changes, the circuit is not guaranteed to run, although it may do so. The conditions under which a version number may change are listed below: + +### Major version + +The major version will increment for system changes such as: + +* Sample changes. +* Major changes to the control electronics. +* Moving the system to a new location, if significant behavior changes result. + +### Minor version + +The minor version will increment for changes such as: + +* Warmup / cool-down cycles. +* Swapping out some electronics, if the replacement appreciably affects operation. +* Changing the direction of a controlled-NOT gate. +* Dropping a gate for some duration of time due to calibration issues, and corrections cannot readily be done in software. + +### Revision version + +The revision version number will increment for fixes that do not break the existing compiled circuit. These changes include: + +* Manual calibrations to improve fidelities. +* Small electronics changes that don’t affect operation. +* System software updates. + +## Cite a system + + +For research papers, we encourage authors to acknowledge IBM Quantum using: + +> We acknowledge the use of IBM Quantum services for this work. The views expressed are those of the authors, and do not reflect the official policy or position of IBM or the IBM Quantum team. + +Paper references should be cited as follows: + +> IBM Quantum. https://quantum-computing.ibm.com/, 2021 + +Systems in the paper should be referenced by their unique name (i.e., `ibmq_vigo`) and optionally +adding the version (i.e., `ibmq_vigo` v1.0.2). We also encourage referencing the processor. +For example: + +> In this paper we used `ibmq_vigo`, which is one of the IBM Quantum Canary processors. + +An example of citing an IBM Quantum program: + +> IBM Quantum (2022). Estimator primitive (Version x.y.z) [computer software]. https://quantum-computing.ibm.com/ + + + diff --git a/docs/run/instances.mdx b/docs/run/instances.mdx new file mode 100644 index 0000000000..b61ee874f1 --- /dev/null +++ b/docs/run/instances.mdx @@ -0,0 +1,87 @@ +--- +title: Instances +description: What instances are and how to use them +--- +# Instances + +Access to IBM Quantum Platform services is controlled by the **instances** (previously called providers) to which you are assigned. An instance is defined by a hierarchical organization of **hub**, **group**, and **project**. A hub is the top level of a given hierarchy (organization) and contains within it one or more groups. These groups are in turn populated with projects. The combination of hub/group/project is called an instance. Users can belong to more than one instance at any given time. + + + IBM Cloud instances are different from IBM Quantum Platform instances. IBM Cloud does not use the hub/group/project structure for user management. This section describes instances in IBM Quantum Platform. To view and create IBM Cloud instances, visit the [IBM Cloud Quantum Instances page](https://cloud.ibm.com/quantum/instances). Click the name of an instance to see details such as your CRN for that instance, what compute resources (programs, systems, and simulators) are available to you by using that instance, and what jobs you have run on that instance. + + +![../../../\_images/providers1.jpg](/images/migration/providers1.jpg) + +The hub/group/project hierarchy that makes up an IBM Quantum instance. + +Users with a public account automatically belong to the ibm-q/open/main [open plan](#open-plan). For organizations outside of IBM, designated hub or group administrators assign users to instances. + +To see the instances to which you have access, look at the bottom of your [Account page](https://quantum-computing.ibm.com/account). + +![../../../\_images/find-providers1.png](/images/migration/find-providers1.png) + +## Find your instances + +You can view a list of your instances on your [account settings page](https://quantum-computing.ibm.com/account), or you can use [the `instances()` method](https://qiskit.org/ecosystem/ibm-runtime/stubs/qiskit_ibm_runtime.QiskitRuntimeService.instances.html#qiskit_ibm_runtime.QiskitRuntimeService.instances). + +## Instances and jobs + +When you execute a task using an IBM Quantum service (for example, sending circuits to a quantum system or simulator), a **job** instance is returned to you. Regardless of which service is being used, a job can track the progress of the submission through IBM Quantum, and retrieve the final result(s) of the computation. Because services are coupled to instances, the jobs created from these services are also tied to the specific instance being used. Therefore, **if a user is removed from an instance, their jobs and the associated results are no longer accessible**. + +## Open plan + +By default, users who sign up for an IBM Quantum account are assigned to the Open plan and the Open plan's instance, `ibm-q/open/main`. To guarantee that everyone can use the IBM Quantum systems allocated to the plan fairly, **an individual can have no more than three jobs running and/or in the queue (across all systems) at the same time.** Submitting more than three jobs at a time will return error [#3458](../errors#3458), and additional jobs will be canceled. + +Those using the Open plan instance have up to 10 minutes total of system execution time per month, which resets at 00:00:00 UTC on the first of each calendar month. Open plan users can track their system execution time on the [Platform dashboard,](https://quantum-computing.ibm.com/) [Jobs,](https://quantum-computing.ibm.com/jobs) and [Account](https://quantum-computing.ibm.com/account) pages. + + +## Connect to an instance + +You can specify an instance when initializing the service or provider, or when choosing a backend. You can copy the service-level code by clicking the three dots by the instance name on the Instances section of the [Account overview page](https://quantum-computing.ibm.com/account). + +### qiskit-ibm-runtime + +```python + +# Optional: List all the instances you can access. +service = QiskitRuntimeService(channel='ibm_quantum') +print(service.instances()) + +# Optional: Specify it at service level. This becomes the default unless overwritten. +service = QiskitRuntimeService(channel='ibm_quantum', instance="hub1/group1/project1") +backend1 = service.backend("ibmq_manila") + +# Optional: Specify it at the backend level, which overwrites the service-level specification when this backend is used. +backend2 = service.backend("ibmq_manila", instance="hub2/group2/project2") + +sampler1 = Sampler(backend=backend1) # this will use hub1/group1/project1 +sampler2 = Sampler(backend=backend2) # this will use hub2/group2/project2 +``` + +### qiskit-ibm-provider + +```python +from qiskit_ibm_provider import IBMProvider + +provider = IBMProvider(instance="hub1/group1/project1") +backend1 = provider.get_backend("ibmq_manila") +backend2 = provider.get_backend("ibmq_manila", instance="hub2/group2/project2") + +job1 = backend1.run(...) # this will use hub1/group1/project1 +job2 = backend2.run(...) # this will use hub2/group2/project2 +``` + + +If you do not specify an instance, the code will select one in the following order: + +1. If your account only has access to one instance, it is selected by default. +2. If your account has access to multiple instances but only one can access the requested backend, the instance with access is selected. +3. In all other cases, the code selects the first instance other than `ibm-q/open/main` that has access to the backend. + + + +## Leaving an instance + +To leave an instance, visit the instance list on your [Account page.](https://quantum-computing.ibm.com/account) Select the instance you wish to leave, then select the overflow menu and choose *Leave instance*. + +![../../../\_images/leaving1.png](/images/migration/leaving1.png) diff --git a/docs/run/queue.mdx b/docs/run/queue.mdx new file mode 100644 index 0000000000..3eb70c978c --- /dev/null +++ b/docs/run/queue.mdx @@ -0,0 +1,63 @@ +--- +title: Fair-share queuing +description: How the IBM Quantum fair-share queue determines order of jobs submitted to quantum systems + +--- + +# Fair-share queuing + +When you submit a job to a quantum system, it enters the scheduler for the specific system, joining the pool of jobs (from all users) that are waiting to be executed on that system. The order in which these jobs are executed is, by default, determined by a fair-share formula. As discussed below, this algorithm attempts to balance the workload between different [instances](instances) according to the allocated system access amount over a given time window. In practice, this means that jobs from various instances are interweaved in a non-trivial manner, and the order in which jobs complete is not necessarily the order in which they were submitted. Because the queue order is calculated dynamically as new jobs arrive, it is generally impossible to guarantee when a fair-share job will be executed. + +## Fair-share terms + +* **Provider:** An entity providing access to quantum computing. IBM Quantum Platform and IBM Cloud® are providers of Qiskit Runtime services. +* **Instance:** A combination of hub/group/project. +* **Hub:** Represents the top level of an organization such as an academic, industry, or research partner. +* **Group:** A mid-level structure to which access shares can be allocated by the hub for one or more collections of users (projects). +* **Project:** The base-level construct to which shares are allocated from the overarching group, and to which users are directly assigned. +* **Access share:** (This documentation uses the simplified term “share”.) A relative amount of access to IBM Quantum computing services assigned to a specific hub, group and project. The portion of access is determined by the specific allotment of shares divided by the total number of shares distributed. IBM Quantum assigns to each hub a share of the overall computational capacity of the IBM Quantum Premium Plan. Hub administrators then assign fractions of their share pool to each of their groups. Finally, group administrators assign fractions (also called shares) of their share pool to each of their projects. +* **Scheduling window:** The fair-share algorithm accounts for usage over a rolling time window. Only execution time accumulated within that window is accounted for the purpose of fairness. The length of that window is currently 28 days. When the fair-share algorithm is invoked, it takes into account usage starting 28 days ago. +* **Time used:** For every group and project, during the scheduling window, we account for all usage on all the systems of the IBM Quantum Premium Plan. These include all successful jobs, as well as jobs returning known select errors. It does not account for canceled jobs, even when partially executed. +* **Fair-share algorithm:** For each group and project, the duration of the scheduling window is used to convert shares into an equivalent amount of time that an instance would receive under ideal conditions. The ratio between the time used and the shares equivalent time is used as the basis for scheduling jobs. + +## Shares and administration + +A hub’s entitlement determines its proportional share of the IBM Quantum Premium Plan computational capacity. IBM Quantum assigns shares to hubs. Hub administrators then decide what portion of these shares to assign to each of their groups. Similarly, group administrators will decide what portion of shares to assign to each of their projects. + +![Administrator user interface.](/images/migration/admin-UI1.png) + +Hub administration user interface. This is used to assign shares to groups. The entire hub share pool is distributed to the underlying groups, and the hub administrator can control the percent distribution by specifying a share value for each group. In this example, Group 5 receives 2 shares of their hub share pool, over a total of 5 shares across all groups. That means that Group 5 receives 40% of the shares pool that the hub was granted. + +The fair-share algorithm takes into consideration how these shares are distributed across groups and projects to determine job prioritization. + +The scheduling algorithm combines a group’s shares with the shares of its hub, to determine the total fraction of computational power allocated to that group. + +![Illustration of how allocation is computed.](/images/migration/allocation.png) + +To compute the 60% for Hub-A, start with the 3 shares of Hub-A and divide between all the shares at the hub level (3 + 2 = 5 shares in total). This results in 3/5 = 0.6 = 60%. When computing the fraction per group, repeat the calculation inside each hub; the fractions for Group-A and Group-B would therefore be 33% and 67%, then apply these percentages to the Hub-A fraction, which results in 20% and 40%. + +## How the fair-share queue works + +The fair-share scheduling algorithm select jobs to execute on a quantum system in a dynamic order so that no instance can monopolize the system. When a quantum system is ready for additional work, it requests the next job from the fair-share scheduler. The scheduler selects the next job by first identifying the group that has used the least amount of their share within the scheduling window. If the group has more than one project, and both have jobs waiting to be executed, then the scheduler identifies the project that has used the least of their share within the scheduling window. Finally, if the project has submitted more than one job, the scheduler will select the oldest job first. Thus, within a project, the scheduler works on a first-in-first-out (FIFO) basis. + +In the following example, we have seven instances arranged between two different hubs. As jobs flow through the system, each group and project consumes some fraction of its effective allotted share. The first image below describes the state at time t1. In between brackets we report the consumption as a fraction of the allotted shares. The fair-share algorithm first identifies the group with the smallest number in between brackets, then the project with the least number in the brackets, and finally it selects the oldest job submitted by that project. + +![Fair-share queue example.](/images/migration/fairshare3.png) + +A snapshot view of consumption (in brackets) relative to the assigned shares. This scenario has seven different H/G/Ps arranged into hubs, groups, and projects. The next selected group and or project is the one with the smallest consumed fraction of the assigned shares. In this example, the Hub-A/Group-1/Project-Y is selected, and the oldest job (first submitted) in the project is executed. + +When the system is ready for an additional job, it repeats the selection. In the following image we represent the state of the queue at time t2. Notice that Group A and Project B consumption were updated to account for the previous consumption accrued between t1 and t2. + +![Fair-share queue example two.](/images/migration/fairshare4.png) + +Recomputed fair-share priorities reflecting the previous job execution. A new H/G/P (Hub-B/Group-2/Project-N) is selected based on these updated values. + +Note that when a user sends jobs to a specific IBM Quantum system, the fair-share algorithm accounts takes into account usage across all systems available to the user in the IBM Quantum Premium Plan when determining fairness. + +## What is my job’s position in the queue? + +As described above, all jobs submitted to the scheduler through the same project will execute in FIFO order. However, global execution order is governed by the fair-share algorithm. Consequently, the time between job submission and job execution can fluctuate depending on usage pattern of the instances which have jobs actively waiting for the system. + +A wait-time estimate is provided through IBM Quantum Platform and via Qiskit. The computed time is the result of a scheduling simulation that predicts one possible execution pattern, given the current fair-share ordering of all the jobs waiting for that system and the approximate runtime of each job. The dynamic nature of the fair-share algorithm means that this estimated time is not fixed and can vary, sometimes dramatically. This wait time is also subject to limitations inherent in estimating the execution time for Qiskit Runtime jobs. For these jobs, where an accurate estimation of time is not feasible, the maximum allowed runtime is used as a proxy. In practice, this means that the duration for a Qiskit Runtime job can be over-estimated by up to eight hours, the maximum allowed Qiskit Runtime job duration for Premium Plan users. + +The job’s position in the queue is listed in the **Queue position** column on the [Jobs page](https://quantum-computing.ibm.com/jobs). diff --git a/docs/run/reserve-system-time.mdx b/docs/run/reserve-system-time.mdx new file mode 100644 index 0000000000..7011ddf607 --- /dev/null +++ b/docs/run/reserve-system-time.mdx @@ -0,0 +1,42 @@ +--- +title: Reserve system time +description: Reserve time on a system as an IBM Quantum Network member + +--- + +# Reserve system time + + + This feature is available only to organizations that belong to the [IBM Quantum Network](https://www.ibm.com/quantum/network). Educators and researchers can also make reservations and access other benefits by signing up for one of the special programs we offer. Go to the [Educators program sign-up form](https://quantum-computing.ibm.com/programs/educators) or the [Researchers program sign-up form](https://quantum-computing.ibm.com/programs/researchers) for more information. + + +Under standard operating conditions, IBM Quantum systems accept jobs according to the dynamic priority assigned by the [fair-share queuing system](queue). + +![Normal device queuing operation.](/images/migration/normal_queue_with_providers1.jpg) + +While this system attempts to balance workloads for the benefit of all users, there are often use cases where you may require limited-time access at a higher priority level. IBM Quantum provides an option to gain elevated access to specific systems over a specified period of time: **Dedicated mode**. Depending on your hub configuration, if you are a hub admin or group admin, you can reserve time in advance on a particular system with the **Systems Reservations** tool. + +Example use cases for dedicated mode include the following: + +- In-class demonstrations +- Iterative and near-time compute algorithms +- Jobs involving detailed noise analysis +- Time-critical projects + + + System time accumulated while using system reservations counts toward an instance’s fair-share allocation amount. + + +If you need sole access to a specific quantum system for a given instance, select dedicated mode when making a reservation (only available to members of the [IBM Quantum Network](https://www.ibm.com/quantum/network)). + +![Dedicated mode with dedicated jobs.](/images/migration/dedicated_queue1.jpg) + +Instance #2 in dedicated mode. + +The standard fair-share queue is always blocked when the device is in dedicated mode. + +![Dedicated mode with no dedicated jobs leaves the device idle.](/images/migration/dedicated_queue_no_jobs1.jpg) + +Dedicated mode with no dedicated jobs from instance #2 leaves the device idle. + +This allows users to implement algorithms where input circuits are conditioned on previous results, such as iterative and near-time compute methods, without having to wait for other users’ results to process. If the dedicated instance has multiple users, then a single user’s jobs may be queued behind those of other users in the instance, as the execution is first-in first-out. diff --git a/docs/run/retired-systems.mdx b/docs/run/retired-systems.mdx new file mode 100644 index 0000000000..686d468b39 --- /dev/null +++ b/docs/run/retired-systems.mdx @@ -0,0 +1,72 @@ +--- +title: Retired systems +description: A list of IBM Quantum systems that are now retired + +--- + +# Retired systems + +The following systems have been retired. For the full list of available systems, see the [Compute resources page.](https://quantum-computing.ibm.com/services/resources?services=systems) By default, the information is shown in the card view, but you can use the view switchers (![view-switcher](/images/migration/view-switcher1.png)) at the top right to change to a sortable table view. + + + To retrieve jobs from a retired system, see [these instructions.](#retrieve) + + + +| System name | Qubit count | Retirement date (Year - month - day) | +| ----------------- | ----------- | --------------- | +| ibmq_lima | **5** | 2023-09-26 | +| ibmq_belem | **5** | 2023-09-26 | +| ibmq_quito | **5** | 2023-09-26 | +| ibmq_manila | **5** | 2023-09-26 | +| ibmq_jakarta | **7** | 2023-09-26 | +| ibm_seattle | **433** | 2023-09-07 | +| ibm_washington | **127** | 2023-06-03 | +| ibmq_oslo | **7** | 2023-05-04 | +| ibmq_geneva | **27** | 2023-05-04 | +| ibmq_montreal | **27** | 2023-04-11 | +| ibmq_toronto | **27** | 2023-04-11 | +| ibmq_armonk | **1** | 2022-07-07 | +| ibmq_brooklyn | **65** | 2022-06-28 | +| ibmq_bogota | **5** | 2022-06-17 | +| ibmq_santiago | **5** | 2022-06-17 | +| ibmq_casablanca | **7** | 2022-03-02 | +| ibmq_sydney | **27** | 2022-01-11 | +| ibmq_dublin | **27** | 2021-11-16 | +| ibmq_manhattan | **65** | 2021-09-22 | +| ibmq_5_yorktown | **5** | 2021-08-09 | +| ibmq_16_melbourne | **15** | 2021-08-09 | +| ibmq_paris | **27** | 2021-06-30 | +| ibmq_rome | **5** | 2021-06-30 | +| ibmq_athens | **5** | 2021-06-30 | +| ibmq_berlin | **27** | 2020-12-31 | +| ibmq_boeblingen | **20** | 2021-01-31 | +| ibmq_ourense | **5** | 2021-01-15 | +| ibmq_vigo | **5** | 2021-01-15 | +| ibmq_valencia | **5** | 2021-01-15 | +| ibmq_rochester | **53** | 2020-10-31 | +| ibmq_cambridge | **28** | 2020-10-31 | +| ibmq_almaden | **20** | 2020-08-31 | +| ibmq_singapore | **20** | 2020-08-31 | +| ibmq_johannesburg | **20** | 2020-08-31 | +| ibmq_essex | **5** | 2020-08-31 | +| ibmq_burlington | **5** | 2020-08-31 | +| ibmq_london | **5** | 2020-08-31 | + + + +## Retrieve a job from a retired system + +To retrieve jobs from a retired system, you can use code similar to this: + +```python +from qiskit_ibm_provider import IBMProvider + +provider = IBMProvider(instance="hub/group/project") + +#If you want to retrieve a list of jobs +jobs = provider.backend.jobs(backend_name=) + +#If you want to retrieve a specific job you have the id for +job = provider.backend.retrieve_job() +``` \ No newline at end of file diff --git a/docs/start/index.mdx b/docs/start/index.mdx new file mode 100644 index 0000000000..4ae86cef98 --- /dev/null +++ b/docs/start/index.mdx @@ -0,0 +1,55 @@ +--- +title: Introduction +description: Introduction to IBM Quantum documentation and API reference + +in_page_toc_max_heading_level: 2 + +--- + +# Introduction + +IBM Quantum maintains the world’s most advanced fleet of quantum systems, which you can access through your chosen [IBM Quantum channel](install#select) using [Qiskit](intro-to-qiskit) and the [Qiskit Runtime service](runtime). + +There are six sections at the core of our documentation, based on the stages of a typical quantum user’s journey. If you’re just getting started with IBM Quantum, you are in the right place. Use the topics in this section to get ready, then proceed to [Build](../build) to create your first quantum circuit. Keep working through the sections in order, following the tabs at the top of this page. + +Already know what you’re looking for? + +- [Install](install): Begin using our tools and platforms with install and setup instructions. + +- [Build](../build): Design and develop quantum circuits with primitives and advanced methods like dynamic circuits and mid-circuit measurements. You can also find our circuit library here. + +- [Test](../test): Verify and evaluate your quantum circuits. + +- [Run](../run): Run on our hardware with job configuration options such as sessions. + +- [Optimize](../optimize): Find options here to tweak your job, from tuning primitive options, to error suppression and mitigation. + +- **API reference**: Find API references for [Qiskit](/api/qiskit), [Qiskit Runtime IBM Client](/api/qiskit-ibm-runtime/runtime_service), [Qiskit IBM Runtime Rest API](/api/runtime/tags/programs), and [Qiskit IBM Provider](/api/qiskit-ibm-provider/ibm_provider) in the API reference drop-down menu above. + + +{/* Add back in when we have guides: +- [Guides](../guides): Go here for walkthroughs of advanced methods drawn from real research and use cases.*/} + +## Community + +Join other users in our quantum community to share ideas and see what others are up to. + +- Join our [Slack](https://ibm.co/joinqiskitslack) +- Follow us on [LinkedIn](https://www.linkedin.com/showcase/ibm-quantum/) and [X](https://x.com/qiskit) +- Start contributing at [GitHub](https://github.com/qiskit) +- Find us on [YouTube](https://www.youtube.com/qiskit) and [Medium](https://medium.com/qiskit) + + +## Next steps + + + - [Install and set up for Qiskit](install). + - Read the [introduction to Qiskit](intro-to-qiskit). + - Read the iIntroduction to the Qiskit Runtime service](runtime). + - Explore hand-on tutorials in IBM Quantum Learning, such as: + - [Variational Quantum Eigensolver using Estimator primitive and sessions](https://learning.quantum-computing.ibm.com/tutorial/variational-quantum-eigensolver-using-estimator-primitive-and-sessions) + - [Quantum Approximate Optimization Algorithm using Qiskit Runtime primitives and sessions](https://learning.quantum-computing.ibm.com/tutorial/quantum-approximate-optimization-algorithm-using-qiskit-runtime-primitives-and-sessions) + - [Grover's algorithm using the Sampler primitive](https://learning.quantum-computing.ibm.com/tutorial/grovers-algorithm-using-the-sampler-primitive) + - Take the [Basics of quantum information](https://learning.quantum-computing.ibm.com/course/basics-of-quantum-information) course. + - View a list of [all tutorials in IBM Quantum Learning](https://learning.quantum-computing.ibm.com/catalog?content=tutorials). + diff --git a/docs/start/install.mdx b/docs/start/install.mdx new file mode 100644 index 0000000000..4ea205228a --- /dev/null +++ b/docs/start/install.mdx @@ -0,0 +1,266 @@ +--- +title: Install and set up +description: Install and set up IBM Quantum Platform or IBM Quantum on IBM Cloud to submit Qiskit and Qiskit Runtime jobs + +--- +# Install and set up + +Whether you will work locally or in a cloud environment, the first step for all users is to [install Qiskit](#local). For those wanting to run on a real backend, your next step will be to choose one of two channels in order to access IBM Quantum systems: IBM Quantum Platform or IBM Cloud. See [Select an IBM Quantum channel](#select) for more information. + + +## Install and set up Qiskit + +1. Install Python. Check the requirements in the [setup.py](https://github.com/Qiskit/qiskit/blob/main/setup.py) file to determine which Python versions are supported. For download instructions, see the [Python Beginners Guide.](https://wiki.python.org/moin/BeginnersGuide/Download) + + We recommend that you use [Python virtual environments](https://docs.python.org/3.10/tutorial/venv.html) to separate Qiskit from other applications. We also recommend that you use the [Jupyter](https://jupyter.org/install) development environment to interact with Qiskit. + + 1. Create a minimal environment with only Python installed in it. + + + + ```shell + python3 -m venv /path/to/virtual/environment + ``` + + + + ```shell + python3 -m venv /path/to/virtual/environment + ``` + + + + ```text + python3 -m venv c:\path\to\virtual\environment + ``` + + + + 1. Activate your new environment. + + + + ```shell + source /path/to/virtual/environment/bin/activate + ``` + + + + ```shell + source /path/to/virtual/environment/bin/activate + ``` + + + + ```text + c:\path\to\virtual\environment\Scripts\Activate.ps1 + ``` + + + +1. [Install pip](https://pip.pypa.io/en/stable/installation/). +1. Install the following packages. + + + Periodically rerun these commands or check the [Qiskit release notes](https://qiskit.org/documentation/release_notes.html) and the [Qiskit Runtime release notes](https://qiskit.org/ecosystem/ibm-runtime/release_notes.html) so that you always have the latest versions. + + + ```shell + pip install qiskit + ``` + + ```shell + pip install qiskit-ibm-runtime + ``` + + Run `pip list` to see the active packages in your virtual environment. + + If you intend to use visualization functionality or Jupyter notebooks, it is recommended to install Qiskit with the extra visualization support. Note that **zsh users** need to put `'qiskit[visualization]'` in single quotes. + + ```shell + pip install qiskit[visualization] + ``` + zsh users: + + ```shell + pip install 'qiskit[visualization]' + ``` + +If you are planning to work locally and use simulators built into Qiskit, then your installation is done. If you would like to run jobs on IBM Quantum systems, continue reading to select an access channel and finish your setup. + + + +## Select an IBM Quantum channel +You can access IBM Quantum systems by using the IBM Quantum Platform or IBM Cloud channel. + +### IBM Quantum Platform + +IBM Quantum Platform has Open (free access) and Premium (contract-based paid access) plans. See [IBM Quantum access plans](https://www.ibm.com/quantum/access-plans) for details. + +You can make requests locally (on your laptop or other device) using the `qiskit-ibm-runtime` SDK or use a cloud-based environment, such as [IBM Quantum Lab](https://lab.quantum-computing.ibm.com) (a Jupyter Notebook environment) or [IBM Quantum Composer](https://quantum-computing.ibm.com/composer/files/new) (a virtual circuit composer). To make requests from a local environment, you need to [install and set up Qiskit](#local) and [set up to use IBM Quantum Platform.](#iqp) + + + [IBM Quantum Lab](https://lab.quantum-computing.ibm.com) and [IBM Quantum Composer](https://quantum-computing.ibm.com/composer/files/new) are self-contained tools and require no setup. + + +Available plans: + +* **Open Plan** - Run your quantum circuits for free on real quantum systems. + +* **Premium Plan** - Access our most powerful systems, as well as exploratory systems, with shorter wait times and hands-on service. Create and execute quantum programs at scale with Qiskit Runtime. + +Visit [IBM Quantum access plans](https://www.ibm.com/quantum/access-plans) for further details. + + +### IBM Cloud + +IBM Cloud offers a cloud-native service that is ideal if users need to integrate quantum capabilities with other cloud services. + +IBM Cloud has Lite (free access) and Standard (pay-as-you-go access) plans. See [Qiskit Runtime plans](https://cloud.ibm.com/docs/quantum-computing?topic=quantum-computing-plans) on IBM Cloud for details. + +This channel does not support a cloud-based development environment. Therefore, you will need to [install and set up Qiskit](#local) and [set up to use IBM Cloud.](#cloud) + +Available plans: + +- **Standard (Pay-as-you-go) Plan** - Access the more advanced systems with Qiskit Runtime on an as-needed basis, paying only for the time you use on real quantum systems (simulators are always free). Visit [IBM Quantum access plans](https://www.ibm.com/quantum/access-plans) for further details. + +- **Lite plan**: Free simulators-only plan to help you get started with Qiskit Runtime. Learn to use Qiskit Runtime by following our examples and tutorials for one of the pre-built programs available for running circuits efficiently. + + +## Set up to use IBM Quantum Platform + +You need access credentials to use cloud-based IBM Quantum systems. + +1. If you do not already have a user account, get one at the [IBM Quantum login page.](https://quantum-computing.ibm.com/login) Your user account is associated with one or more [instances](../run/instances) (in the form hub / group / project) that give access to IBM Quantum services. Additionally, a unique token is assigned to each account, allowing for IBM Quantum access from Qiskit. The instructions in this section use our default instance. For instructions to choose a specific instance, see [Connect to an instance](../run/instances#connect-instance). + + + The Instances section in your [IBM Quantum account page](https://quantum-computing.ibm.com/account) lists the instances that you can access. + + +1. Retrieve your IBM Quantum token from the [IBM Quantum account page,](https://quantum-computing.ibm.com/account) then start Python. For example: + + ```shell + python3 + ``` + +1. Optionally use the `save_account()` method to save your credentials for easy access, as shown in the code block. + + * If you save your credentials to disk, you can use `QiskitRuntimeService()` in the future to initialize your account. The `channel` parameter distinguishes between different account types. If you are saving multiple accounts per channel, consider using the `name` parameter to differentiate them. + * Credentials are saved to `$HOME/.qiskit/qiskit-ibm.json`. Do not manually edit this file. + * If you don't save your credentials, you must specify them every time you start a new session. + * For full details about saving and initializing accounts, see [Manage your account](../run/account-management). + + + + Account credentials are saved in plain text, so only do so if you are using a trusted device. + + +```python +from qiskit_ibm_runtime import QiskitRuntimeService + +# Save an IBM Quantum account. +QiskitRuntimeService.save_account(channel="ibm_quantum", token="") +``` + +1. Authenticate to the service by calling `QiskitRuntimeService` with your saved credentials or with your IBM Cloud API key and CRN: + + ```python + from qiskit_ibm_runtime import QiskitRuntimeService + + # Use this command if you didn't save your credentials: + # service = QiskitRuntimeService(channel="ibm_quantum", token="") + + # Load saved credentials + service = QiskitRuntimeService() + + ``` + + +For more information about managing your account, see the [account management topic](../run/account-management). + +1. Test your setup. Run a simple circuit using Sampler to ensure that your environment is set up properly: + + ```python + from qiskit.test.reference_circuits import ReferenceCircuits + from qiskit_ibm_runtime import QiskitRuntimeService, Sampler + + # You'll need to specify the credentials when initializing QiskitRuntimeService, if they were not previously saved. + service = QiskitRuntimeService() + backend = service.backend("ibmq_qasm_simulator") + job = Sampler(backend).run(ReferenceCircuits.bell()) + print(f"job id: {job.job_id()}") + result = job.result() + print(result) + ``` + + +## Set up to use IBM Cloud + +1. Start Python. For example: + + ```shell + python3 + ``` +1. If you do not already have one, set up an IBM Cloud account from the [IBM Cloud Registration page](https://cloud.ibm.com/registration). +1. Create a service instance, if necessary. Open your [IBM Cloud Instances page](https://cloud.ibm.com/quantum/instances). If you have one or more instances shown, continue to the next step. Otherwise, click **Create instance**, then agree to the license agreements by checking the box in the bottom right corner of the page, and click **Create**. + + + If you are an administrator who needs to set up Qiskit Runtime on Cloud for your organization, refer to [Plan Qiskit Runtime for an organization](https://cloud.ibm.com/docs/quantum-computing?topic=quantum-computing-quickstart-org). + + +1. Find your access credentials. + 1. Find your API key. From the [API keys page](https://cloud.ibm.com/iam/apikeys), view or create your API key, then copy it to a secure location so you can use it for authentication. + 2. Find your Cloud Resource Name (CRN). Open the [Instances page](https://cloud.ibm.com/quantum/instances) and click your instance. In the page that opens, click the icon to copy your CRN. Save it in a secure location so you can use it for authentication. + +1. Optionally use the save_account() method to save your credentials for easy access (see below). + + * If you save your credentials to disk, you can use `QiskitRuntimeService()` in the future to initialize your account. The `channel` parameter distinguishes between different account types. If you are saving multiple accounts per channel, consider using the `name` parameter to differentiate them. + * Credentials are saved to `$HOME/.qiskit/qiskit-ibm.json`. Do not manually edit this file. + * If you don't save your credentials, you must specify them every time you start a new session. + + + Account credentials are saved in plain text, so only do so if you are using a trusted device. + + + ```python + from qiskit_ibm_runtime import QiskitRuntimeService + + # Save account to disk. + QiskitRuntimeService.save_account(channel="ibm_cloud", token="", instance="", name="") + ``` + + For more information about managing your account, see the [account management topic](../run/account-management). + +1. Authenticate to the service by calling `QiskitRuntimeService` with your saved credentials or with your IBM Cloud API key and CRN: + + ```python + from qiskit_ibm_runtime import QiskitRuntimeService + + # Use this command if you didn't save your credentials: + # service = QiskitRuntimeService(channel="ibm_cloud", token="", instance="") + + # Load saved credentials + service = QiskitRuntimeService(name="") + + ``` + + 1. Test your setup. Run a simple circuit using Sampler to ensure that your environment is set up properly: + + ```python + from qiskit.test.reference_circuits import ReferenceCircuits + from qiskit_ibm_runtime import QiskitRuntimeService, Sampler + + # You'll need to specify the credentials when initializing QiskitRuntimeService, if they were not previously saved. + service = QiskitRuntimeService() + backend = service.backend("ibmq_qasm_simulator") + job = Sampler(backend).run(ReferenceCircuits.bell()) + print(f"job id: {job.job_id()}") + result = job.result() + print(result) + ``` + +## Next steps + + + Follow the steps in [Hello world](hello-world) to write and run a quantum program. + diff --git a/docs/start/intro-to-qiskit.ipynb b/docs/start/intro-to-qiskit.ipynb new file mode 100644 index 0000000000..9f1b3ba6e3 --- /dev/null +++ b/docs/start/intro-to-qiskit.ipynb @@ -0,0 +1,630 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Introduction to Qiskit open-source\n", + "\n", + "The Qiskit package provides the basic building blocks necessary to program quantum computers. The fundamental unit in Qiskit is the quantum circuit. A basic workflow using Qiskit consists of two stages: **Build** and **Execute**. That is, you first make different quantum circuits that represent the problem you are solving (build phase), and then you run them as a job on backends (execute phase). After the jobs have been run, the data is collected and post-processed depending on the desired output." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:04:39.026081Z", + "start_time": "2021-07-31T05:04:36.903090Z" + } + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "from qiskit import *\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Circuit basics \n", + "\n", + "\n", + "### Build the circuit\n", + "\n", + "The basic element needed for your first program is the QuantumCircuit. We begin by creating a `QuantumCircuit` comprised of three qubits." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:04:39.030564Z", + "start_time": "2021-07-31T05:04:39.028024Z" + } + }, + "outputs": [], + "source": [ + "# Create a Quantum Circuit acting on a quantum register of three qubits\n", + "circ = QuantumCircuit(3)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "After you create the circuit with its registers, you can add gates (\"operations\") to manipulate the registers. Below is an example of a quantum circuit that makes a three-qubit GHZ state:\n", + "\n", + "$$|\\psi\\rangle = \\left(|000\\rangle+|111\\rangle\\right)/\\sqrt{2}.$$\n", + "\n", + "To create such a state, we start with a three-qubit quantum register. By default, each qubit in the register is initialized to $|0\\rangle$. To make the GHZ state, we apply the following gates:\n", + "- A Hadamard gate $H$ on qubit $q_{0}$, which puts it into the superposition state $\\left(|0\\rangle+|1\\rangle\\right)/\\sqrt{2}$.\n", + "- A controlled-Not operation ($C_{X}$) between qubit $q_{0}$ and qubit $q_{1}$.\n", + "- A controlled-Not operation between qubit $q_{0}$ and qubit $q_{2}$.\n", + "\n", + "On an ideal quantum computer, the state produced by running this circuit would be the GHZ state above.\n", + "\n", + "In Qiskit, operations can be added to the circuit one by one, as shown below." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:04:39.584692Z", + "start_time": "2021-07-31T05:04:39.573755Z" + } + }, + "outputs": [ + { + "data": { + "text/plain": [ + "" + ] + }, + "execution_count": 3, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Add an H gate on qubit $q_{0}$, putting this qubit in superposition.\n", + "circ.h(0)\n", + "# Add a CX (CNOT) gate on control qubit $q_{0}$ and target qubit $q_{1}$, putting\n", + "# the qubits in a Bell state.\n", + "circ.cx(0, 1)\n", + "# Add a CX (CNOT) gate on control qubit $q_{0}$ and target qubit $q_{2}$, putting\n", + "# the qubits in a GHZ state.\n", + "circ.cx(0, 2)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Visualize the circuit \n", + "\n", + "You can visualize your circuit using Qiskit `QuantumCircuit.draw()`, which plots the circuit in the form found in many textbooks." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:04:40.867948Z", + "start_time": "2021-07-31T05:04:40.271129Z" + }, + "scrolled": true, + "tags": [ + "nbsphinx-thumbnail" + ] + }, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAANgAAACoCAYAAACCAiAsAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAAOFklEQVR4nO3df0zUd57H8ecMIuiipRQrCtYVYVyZdtjV2/6gewvUHwXPy5lL1ZpdklKysOJdzvaSuz/ubOrpkSwxF3PXpLbJZU12e/QCoV3TRXf1hGmtbj2WrS72uuMvpNNF6+9KpSjM3B/fFUVhGHA+M9+B1yP5BuYzw+f7FuY1n+/3M1/n4wgGg0FExAhnrAsQGc8UMBGDFDARgxQwEYMUMBGDFDARgxQwEYMUMBGDFDARgxQwEYMUMBGDFDARgxQwEYMUMBGDFDARgxQwEYMUMBGDFDARgxQwEYMUMBGDFDARgxQwEYMUMBGDFDARgxQwEYMUMBGDJsW6ALtrbIXPL8dm35kPwl//WWz2LZGhgI3g88tw8otYVyHxSoeIIgYpYCIGKWAiBilgIgYpYCIGKWAiBilgIgYpYCIG6Y1mGXD5K/jdGej+GlKSYdE3IXVqrKsKrT8A7X7ovAhOB8yfCa4M63s7sPUIFggE2LZtG7m5uSQnJ5Ofn4/X62XBggVUVlbGurwhNWwt4vC7W8Nut4O+fvjvj+Bf3oVdv4Pm/7O+bn4XGg5bT2I7+kMXvPoO/PQD+J9PYO8x2LEfanbF7vK2u9k6YBUVFWzZsoWqqip2797NmjVrWLduHadOnWLx4sWxLm/cqPsNHDoBwT/dHvgahAPHof5wrCob3unz8GazNdre7eJX8NpeuHAt+nXdzbaHiHV1dezcuZOWlhYKCwsBKC4upq2tjcbGRhYtWhTjCscH/yX4bUfox/zmJBQvhJkPRKWksDQdgUDw9ovBnYJB+PqmNaqtfSLqpQ1i2xGspqaGkpKSgXDdkpOTQ2JiIh6PB4COjg4KCwtxuVw89thjfPDBB7EoN259dArCOV356JTxUsJ2qRuOnxs6XLcEgf89DTf7o1XV0GwZML/fT3t7O6tXr77nvs7OTtxuN0lJSQBUVVWxdu1afD4fb7zxBs8//zw3btwYcR8OhyOszettGXX9h3/xr7xemTpo+6PvwKj78Xpbwq5zrNtP33qH/v6+kHUE+vt4/T/rjNcS7vbooqfD+v319cODMzIjvv/RsOUhot/vByAjI2NQe09PD16vl9LSUgAuXLjAgQMH2LVrFwAFBQXMnj2b5uZmnn322egWfYfH/+qfeHzVPw9qa9haFJtiRnDj+tWRH+RwhPe4KLnRE14twWCAm1/H9kTMliNYeno6AD6fb1B7bW0tXV1dAxMcnZ2dzJw5c2A0A5g3bx5nzpwZcR/BYDCsrbCwKHL/sFEqLCwKu86xbttfeQFnQujXWaczgR01PzZeS7jb+c52ZkwLfWjrcEBeppPe619GfP+jYcsRLDs7G4/HQ01NDWlpaWRmZtLQ0EBTUxOAZhAj6FuzYFYqnL0y9DmNA8hKg5yZ0a0rFIcDlj0K/3UoxIOC8Exe1Eoali1HMKfTSX19PW63m/Xr11NeXk56ejobNmwgISFhYILjkUce4dy5c/T29g787OnTp5k7d26sSo87TidUFcPD0we33xodMlLhR0XWk9pOHs+GFdbT4J6RzOGAdU9Brg1eFBzB0Y55MVRWVsaRI0c4evToQNvy5ctZtWoV1dXVHDx4kOeee46Ojg4mT54ckX3+x97YfWTA/Ifhb5dFZ199/XCkE3520Lq9cDZ8dx545sCkhOjUMBZdV+DD43DgT2cTS/KgIBceSolpWQNsOYINp7W19Z7Dwx07dvD222/jcrmorKykrq4uYuGaSCYlwOJ5t29XFVuXStk5XGAd3j733du3//I79gkX2PQcbCjd3d34fD6qq6sHtWdnZ/P+++/HqCqR0OImYCkpKfT3x/hdQ5FRiqtDRJF4o4CJGKSAiRikgIkYpICJGKSAiRgUN9P0sZL54MTct0SGAjYCLR8k90OHiCIGKWAiBilgIgYpYCIGKWAiBilgIgYpYCIGKWAiBilgIgYpYCIGKWAiBilgIgYpYCIGKWAiBilgIgYpYCIGKWAiBilgMuD6HQuDdlyAnpEXCpUR6CMDJrjLX8GhE9B2Bi7csRjk9l9ZX2dMsxaBeCoHUqfGpMS4poBNUH39sOf3sP8TCIRYwOr8NfjV72Fvu7Xo3TK3/VdcsRMFbAK6ch3ebIY/Xgn/ZwJBK2jHPofKIpg+xVR144vOwSaYL3vgtb2jC9ed/JfgtX3Q/XVEyxq3FLAJJBi01jW+0D38Y7b/wNpC+eJLePsjqz8JTQGbQA6fgk+7ItNXu9+aGJHQbB2wQCDAtm3byM3NJTk5mfz8fLxeLwsWLKCysjLW5cWVQBD2Hotsn/vaNYqNxNaTHBUVFTQ2NrJp0yYWL17MwYMHWbduHefPn+fll1+OdXlx5fjZwdPwkdB1FU6dtxZrl6HZNmB1dXXs3LmTlpYWCgsLASguLqatrY3GxkYWLVoU4wrji++suX4VsOHZ9hCxpqaGkpKSgXDdkpOTQ2JiIh6PB4BXXnkFl8uF0+mkoaEhFqXGhc8uGer3opl+xwtbjmB+v5/29nZeeumle+7r7OzE7XaTlJQEQElJCS+88AIvvvjiqPbhcDgiUmu8KPvJJ6RlLhzUFmq2cLj7Nr41+HbLwTaqnll8n9Xdv7/7uXUyGI2/a3AUJ562DRhARkbGoPaenh68Xi+lpaUDbQUFBVGtLW4ZeuI5HLY9CLIFWwYsPT0dAJ/Px4oVKwbaa2tr6erqYvHi+3/FHM2r0Hjw77+2JiTudPdoBLdHrqHuG8rTT3ybt2zwu7xVr93+rrYMWHZ2Nh6Ph5qaGtLS0sjMzKShoYGmpiaAiARsoslKuzdgkTAnLfJ9jie2HN+dTif19fW43W7Wr19PeXk56enpbNiwgYSEhIEJDgmfqZm+bM0ghmTLEQzA5XLR3Nw8qK2srIy8vDymTNGVpqPlzoRpyXAtgtcQPjgVFs6KXH/jkS1HsOG0trbec3i4adMmsrKyOHToEFVVVWRlZXHy5MkYVWhfkxLg+wsi22fhQnDG1TMo+uLm19Pd3Y3P57vnDeYtW7bg9/vp7e3l4sWL+P1+5s+fH6Mq7e2ZvMgtrD73Ifi+KzJ9jWe2PUS8W0pKCv39/bEuI64lOKHsaWtG8fowHwcQzuxhShL8sECjVzj0K5pgMh6A6iVWSMZi+hTYsBRmTI9sXeOVAjYBZaXBP/4FeOaM7ue+Mxf+YQXMSjVS1rgUN4eIElnTpkD5n8OJL+BDHxz9bOjP5khwWkH8nksX9Y6FAjaBORyQO9PabvRZHyNw7irc7IfEBGukmpVqfS9jo4AJAJMnwTfTrU0iR+dgIgYpYCIGKWAiBilgIgYpYCIGKWAiBilgIgYpYCIGKWAiBilgIgYpYCIGKWAiBilgIgYpYCIGKWAiBilgIgYpYCIGKWAiBilgIgYpYCIGKWAiBjmCdluxTCQMgQD4zsHJc9b60592We2PZlkfrOqaCfNmGFvYM2wKmMSVQAA+PA4tn8LF7tCPnZUKy9zWJxLHKmgKmMSNi93w84NwepQrdT6WBWufgJRkM3WFooBJXDh3FV7bN/YFBB+eDn+z1Fq8Ipo0ySG291UvvL7//lbn/OJLeLMF+qK8ApYCJrb3TitcuR76Mdt/YG2h+C/Br9sjV1c4bB2wQCDAtm3byM3NJTk5mfz8fLxeLwsWLKCysjLW5UkUdFyA1o7I9bfv2MhhjSRbB6yiooItW7ZQVVXF7t27WbNmDevWrePUqVP3rNUs49MBX2T7CwTh0InI9hmKbVdXqaurY+fOnbS0tFBYWAhAcXExbW1tNDY23rNWs4w/ff3wcWfk+/1tB5R6It/vUGw7gtXU1FBSUjIQrltycnJITEzE4/Fw+fJlVq5cicvlIj8/n+XLl3PiRBRfnsSos1fNTEpcuDb8GtWRZsuA+f1+2tvbWb169T33dXZ24na7SUpKwuFwsHHjRnw+H0eOHGHlypWUl5fHoGIx4exVg31fMdf3nWx5iOj3+wHIyMgY1N7T04PX66W0tBSA1NRUli5dOnB/QUEBtbW1Ye3DEetraGREjxb/iCUVbw5qG2mmcLj7N741+HbxkmV0tu8bU12jeevYliNYerq1zKLPN/gMt7a2lq6urmEnOLZv386qVatMlydR0nfzPt74GqnvGz3G+r6TLUew7OxsPB4PNTU1pKWlkZmZSUNDA01NTQBDBmzz5s2cOHGC/fv3h7UPXcBif50X4d/2DG67eyS65dbINdz9d/MdPcA3ksZeW7hsOYI5nU7q6+txu92sX7+e8vJy0tPT2bBhAwkJCXg8g6eAtm7dynvvvceePXuYOnVqjKqWSJudCgkGnqEPpRCVcIFNRzAAl8tFc3PzoLaysjLy8vKYMuX2BWWbN2+mqamJvXv3kpqaGuUqxaRJCdaFupGeqv/2I5HtLxTbBmwora2tPPnkkwO3jx07xquvvsr8+fMpKioaaP/444+jX5wY8T1XZAPmAApyI9ffSOImYN3d3fh8Pqqrqwfa3G63zqXGufkPg2cOHP0sMv0VLbQOEaNF/11FbO9aD/zkl9Dde3/9zJwOf18Kk6M4rNhykkPkTtOmwI+fgamTx95H2jesPqIZLtAIJnHk7FX42Yfw+eXR/VzuTPhhATwQgwlmBUziSn8A9n8C3j9A9wjvQz+UAkvy4KkcfSaHyKj09UO7H06eB/9FuNZrzRA+MBXmpFmj1rdmgTPGJ0EKmIhBmuQQMUgBEzFIARMxSAETMUgBEzFIARMxSAETMUgBEzFIARMxSAETMUgBEzFIARMxSAETMUgBEzFIARMxSAETMUgBEzFIARMxSAETMUgBEzFIARMxSAETMej/AS1oyq5Amy4ZAAAAAElFTkSuQmCC", + "text/plain": [ + "
" + ] + }, + "execution_count": 4, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "circ.draw('mpl')" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In this circuit, the qubits are put in order, with qubit $q_{0}$ at the top and qubit $q_{2}$ at the bottom. The circuit is read left to right (meaning that gates that are applied earlier in the circuit show up further to the left)." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "
\n", + "\n", + "\n", + "When representing the state of a multi-qubit system, the tensor order used in Qiskit is different than that used in most physics textbooks. Suppose there are $n$ qubits, and qubit $j$ is labeled $q_{j}$. Qiskit uses an ordering in which the $n^{\\mathrm{th}}$ qubit is on the left side of the tensor product, so that the basis vectors are labeled as $Q_{n-1}\\otimes \\cdots \\otimes Q_1\\otimes Q_0$.\n", + "\n", + "For example, if qubit $q_{0}$ is in state 0, qubit $q_{1}$ is in state 0, and qubit $q_{2}$ is in state 1, Qiskit would represent this state as $|100\\rangle$, whereas many physics textbooks would represent it as $|001\\rangle$.\n", + "\n", + "This difference in labeling affects the way multi-qubit operations are represented as matrices. For example, Qiskit represents a controlled-X ($C_{X}$) operation with qubit $q_{0}$ being the control and qubit $q_{1}$ being the target as\n", + "\n", + "$$C_X = \\begin{pmatrix} 1 & 0 & 0 & 0 \\\\ 0 & 0 & 0 & 1 \\\\ 0 & 0 & 1 & 0 \\\\ 0 & 1 & 0 & 0 \\\\\\end{pmatrix}.$$\n", + "\n", + "
" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Simulate circuits with Qiskit Aer
\n", + "\n", + "Qiskit Aer is our package for simulating quantum circuits. It provides many different backends for doing a simulation. There is also a basic, Python only, implementation called `BasicAer` in Qiskit that can be used as a drop-in replacement for `Aer` in the examples below.\n", + "\n", + "### Statevector backend\n", + "\n", + "The most common backend in Qiskit Aer is the `statevector_simulator`. This simulator returns the quantum \n", + "state, which is a complex vector of dimensions $2^n$, where $n$ is the number of qubits \n", + "(so be careful using this as it will quickly get too large to run on your machine)." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "To run the above circuit using the statevector simulator, first you need to import Aer and then set the backend to `statevector_simulator`." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:04:43.436320Z", + "start_time": "2021-07-31T05:04:43.290274Z" + } + }, + "outputs": [], + "source": [ + "# Import Aer\n", + "from qiskit import Aer\n", + "\n", + "# Run the quantum circuit on a statevector simulator backend\n", + "backend = Aer.get_backend('statevector_simulator')" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now that we have chosen the backend, it's time to compile and run the quantum circuit. In Qiskit we provide the `run` method for this. `run` returns a `job` object that encapsulates information about the job submitted to the backend.\n", + "\n", + "\n", + "
\n", + "Tip: You can obtain the above parameters in Jupyter. Simply place the text cursor on a function and press Shift+Tab.\n", + "
" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:04:44.311305Z", + "start_time": "2021-07-31T05:04:44.306416Z" + } + }, + "outputs": [], + "source": [ + "# Create a Quantum Program for execution \n", + "job = backend.run(circ)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "When you run a program, a job object is made that has the following two useful methods: \n", + "`job.status()` and `job.result()`, which return the status of the job and a result object, respectively.\n", + "\n", + "
\n", + "Note: Jobs run asynchronously, but when the result method is called, the system waits for the job to finish before moving on to another task.\n", + "
" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:04:45.848031Z", + "start_time": "2021-07-31T05:04:45.844758Z" + } + }, + "outputs": [], + "source": [ + "result = job.result()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The results object contains the data and Qiskit provides the method \n", + "`result.get_statevector(circ)` to return the statevector for the quantum circuit." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:04:46.702758Z", + "start_time": "2021-07-31T05:04:46.697846Z" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "[0.707+0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j\n", + " 0.707+0.j]\n" + ] + } + ], + "source": [ + "outputstate = result.get_statevector(circ, decimals=3)\n", + "print(outputstate)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Qiskit also provides a visualization toolbox to allow you to view these results.\n", + "\n", + "Below, we use the visualization function to plot the real and imaginary components of the state density matrix $\\rho$.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:04:48.212557Z", + "start_time": "2021-07-31T05:04:47.532387Z" + } + }, + "outputs": [ + { + "data": { + "image/png": "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N+soQF3jscHizdGLMpTl9vN2ypdt4qApw725eVQZ7z/kR/IIiWCvasYnahna08zhw4c5ffo0paWliGLLYjelpaVcf/31vP3225fVUdiyZQvffvstL730Et988w2PPvoob731Fl988QXnzp0D6volzpw5Y3eej48Pn3zyCStXrrTVVc6fP58VK1ZgNl9iibIudhkZGaxevZqHH34YwKl30IlOdKL96LSPlxeCIBAbG8usWbMwmUx8/vnn9OrVi3vuuYerr76a999/n+zsbJwMlDYJo9HIyZMniY6OtjkKgE312UogYs36+/r6kpeXx6FDh7hw4QLl5eW8/HXLjgKAws2PSqk7e047p+DsDBJ6+DB1gIZ/T1fx7+lqegZk4iFm8cC0SooKszh8+DCZmZlUV1c79a6+++471q9fz/Llyy+ro9BpI/8cXLaehXfffZe33nqLzz//nFmzZgHYZLHff/99vvrqK7Zu3UpoqHMsAZcx/fO3hNls5ueff+aWW26xvT+z2WwncDNw4EBmz57N+PHjW2RGaoj2qE7W1tay/WA+Kw97I5M7l4aURAMP3+BL/5720Yxl+1zYd7b5zIJoNpCy/fVG4688PIqhgwc6bEqSJInq6mqbwFp9WryGNZZqtZprr72Wl19+2U7k5XKgo5Qni4uLef755xEEgYULFxIVFWWr77RYLLz11lu89NJL1NTUXNbn+R1/+ahJJzrRTrTKRnbax8uPY8eO4ebmZqO8lCSJ0tJSVq1axcqVK6msrGT69OkkJyfTs2fPVkWN9Xo9KSkpxMXFtVqEy2KxoFareefXGvSuCU6f50MWL93dMc3S1n4PFxcX4uLiHF7TbDbbMiNarbZZStYffviBn376ifXr19voSi8XOm3kn4MOqVkpKioiKyuLsrIyJk2ahIeHB9dffz0HDhzgtddew8XFhalTp9rq1/z9/TGZTHh6erb4xS8vLycwMBCZTHY5m0v+dlAoFNx6662NxiZMmMCECRMQRZH9+/ezfPlyFi5cSL9+/UhOTmbixInN/pjri9W0xVEA8PLyIioqnO6hFeQoRZA3zyDQHKuSxQkT3JTDO2TQgCbZCwRBwNfXF19fXztavJMnTyKXywkJCcFiseDr68ucOXNYuHDhZXcU0tPTOXDgABs3brQrQTh16hTdunWjoKCAgQMHMnHiROLj41m6dClv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", + "text/plain": [ + "
" + ] + }, + "execution_count": 9, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "from qiskit.visualization import plot_state_city\n", + "plot_state_city(outputstate)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Unitary backend" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Qiskit Aer also includes a `unitary_simulator` that works _as long as all the elements in the circuit are unitary operations_. This backend calculates the $2^n \\times 2^n$ matrix representing the gates in the quantum circuit. " + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:04:49.855040Z", + "start_time": "2021-07-31T05:04:49.843822Z" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "[[ 0.707+0.j 0.707-0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j\n", + " 0. +0.j 0. +0.j]\n", + " [ 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j\n", + " 0.707+0.j -0.707+0.j]\n", + " [ 0. +0.j 0. +0.j 0.707+0.j 0.707-0.j 0. +0.j 0. +0.j\n", + " 0. +0.j 0. +0.j]\n", + " [ 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0.707+0.j -0.707+0.j\n", + " 0. +0.j 0. +0.j]\n", + " [ 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0.707+0.j 0.707-0.j\n", + " 0. +0.j 0. +0.j]\n", + " [ 0. +0.j 0. +0.j 0.707+0.j -0.707+0.j 0. +0.j 0. +0.j\n", + " 0. +0.j 0. +0.j]\n", + " [ 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j\n", + " 0.707+0.j 0.707-0.j]\n", + " [ 0.707+0.j -0.707+0.j 0. +0.j 0. +0.j 0. +0.j 0. +0.j\n", + " 0. +0.j 0. +0.j]]\n" + ] + } + ], + "source": [ + "# Run the quantum circuit on a unitary simulator backend\n", + "backend = Aer.get_backend('unitary_simulator')\n", + "job = backend.run(circ)\n", + "result = job.result()\n", + "\n", + "# Show the results\n", + "print(result.get_unitary(circ, decimals=3))" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### OpenQASM backend" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The simulators above are useful because they provide information about the state output by the ideal circuit and the matrix representation of the circuit. However, a real experiment terminates by _measuring_ each qubit (usually in the computational $|0\\rangle, |1\\rangle$ basis). Without measurement, we cannot gain information about the state. Measurements cause the quantum system to collapse into classical bits. \n", + "\n", + "For example, suppose we make independent measurements on each qubit of the three-qubit GHZ state\n", + "\n", + "$$|\\psi\\rangle = (|000\\rangle +|111\\rangle)/\\sqrt{2},$$\n", + "\n", + "and let $xyz$ denote the bitstring that results. Recall that, under the qubit labeling used by Qiskit, $x$ would correspond to the outcome on qubit $q_{2}$, $y$ to the outcome on qubit $q_{1}$, and $z$ to the outcome on qubit $q_{0}$. \n", + "\n", + "
\n", + "Note: This representation of the bitstring puts the most significant bit (MSB) on the left, and the least significant bit (LSB) on the right. This is the standard ordering of binary bitstrings. We order the qubits in the same way (qubit representing the MSB has index 0), which is why Qiskit uses a non-standard tensor product order.\n", + "
\n", + "\n", + "Recall the probability of obtaining outcome $xyz$ is given by\n", + "\n", + "$$\\mathrm{Pr}(xyz) = |\\langle xyz | \\psi \\rangle |^{2},$$\n", + "\n", + "and as such, the probability of obtaining 000 or 111 for the GHZ state are both 1/2.\n", + "\n", + "To simulate a circuit that includes measurement, we need to add measurements to the original circuit above, and use a different Aer backend." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:05:39.326486Z", + "start_time": "2021-07-31T05:05:39.315781Z" + } + }, + "outputs": [], + "source": [ + "# Create a Quantum Circuit\n", + "meas = QuantumCircuit(3, 3)\n", + "meas.barrier(range(3))\n", + "# map the quantum measurement to the classical bits\n", + "meas.measure(range(3), range(3))\n", + "\n", + "# The Qiskit circuit object supports composition using\n", + "# the compose method.\n", + "circ.add_register(meas.cregs[0])\n", + "qc = circ.compose(meas)\n", + "\n", + "#drawing the circuit\n", + "qc.draw()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This circuit adds a classical register and three measurements that are used to map the outcome of qubits to the classical bits. \n", + "\n", + "To simulate this circuit, we use the `qasm_simulator` in Qiskit Aer. Each run of this circuit will yield either the bitstring 000 or 111. To build up statistics about the distribution of the bitstrings (to estimate $\\mathrm{Pr}(000)$, for example), we need to repeat the circuit many times. The number of times the circuit is repeated can be specified in the `run` method, via the `shots` keyword." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:06:23.358780Z", + "start_time": "2021-07-31T05:06:23.338865Z" + } + }, + "outputs": [], + "source": [ + "# Use Aer's qasm_simulator\n", + "backend_sim = Aer.get_backend('qasm_simulator')\n", + "\n", + "# Execute the circuit on the qasm simulator.\n", + "# We've set the number of repeats of the circuit\n", + "# to be 1024, which is the default.\n", + "job_sim = backend_sim.run(transpile(qc, backend_sim), shots=1024)\n", + "\n", + "# Grab the results from the job.\n", + "result_sim = job_sim.result()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Once you have a result object, you can access the counts via the function `get_counts(circuit)`. This gives you the _aggregated_ binary outcomes of the circuit you submitted." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:06:24.587309Z", + "start_time": "2021-07-31T05:06:24.583432Z" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "{'111': 514, '000': 510}\n" + ] + } + ], + "source": [ + "counts = result_sim.get_counts(qc)\n", + "print(counts)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Approximately 50 percent of the time, the output bitstring is 000. Qiskit also provides a function `plot_histogram`, which allows you to view the outcomes. " + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:06:26.146850Z", + "start_time": "2021-07-31T05:06:26.028680Z" + } + }, + "outputs": [ + { + "data": { + "image/png": "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6q7Wrl3LsGHD9nweOnQoa9eufU2/n/70p0yYMIH3v//9rF69uvC8zz//PD//+c9529vedpDWoHswNA9jRTakRYsWsXr1at75zne+qr2qqop7772XhoYGVq5cycKFC1m9ejVHHnkkN998M6eeeiqDBw+mrq6Oj33sYx2yPtLh7l3veherVq3iiSeeYNq0aXz0ox8tNF9DQwMf+tCHuOKKKxg5cuRBrvLQZmiqVa+88gpXXnkl3/zmN18z7aKLLmLo0KHU1NQwY8YMzjrrLHr06MHLL7/MzTffzB/+8AeeffZZJkyYwHXXXdcJ1Uvdy5AhQ/bsOQKsWbOGIUOGvKpP//79qaysBODiiy9m4cKFhea99NJLGTVqFDNmzDiIa9A9GJqHsX1tSNu3b2fJkiWcc845DB8+nN/97necd9551NbWUlFRwbe//W0ef/xxfvazn/H8888zevRoHn/8cQBOPvlkIoIPfOADPProox29alK3c+aZZ7J8+XJWrlzJrl27uOuuuzjvvPNe1WfdunV73t9777288Y1vBGD69OnMmTOHrVu3snXrVubMmcP06dMBuOqqq/jLX/7CDTfc0GHrciir6OwC1HmaboRDhgzhrrvu4s4779wz/fWvfz2bNm3a8/mcc87h+uuvp6amhhdffJHM5HWvex0PPPAAFRUVjB07lmeffZa6ujqee+45jj/+eB544IE9G66k/VdRUcGNN97I9OnTaWxs5KKLLmLcuHFcc8011NTUcN555/Gd73yHe++9l4qKCvr168fs2bMB6NevH1dffTVnnnkmANdccw39+vVjzZo1XHvttbzhDW+guroagE996lNcfPHFnbWaXV6URtcenmpqarK2trazy+hU9913HzNmzNizEX7xi1981UbYVNPQXLVqFdOnT+eII45gyJAh/PCHP+Skk04C4JZbbmHmzJkceeSRnHTSScyePZv+/ft3xupJUptFxMLMrGlxmqF5eIemJOnV9haantOUJKkgQ1OSpIIMTUmSCjI0JUkqyNCUJKkgQ1OSpIIMTUmSCjI0JUkqyNCUJKkgQ1OSpIK8Ybukw84lN3R2BToYZs04+N/hnqYkSQW5p9kO/Ku1e+qIv1olHVrc05QkqSBDU5KkggxNSZIKMjQlSSrI0JQkqSBDU5KkggxNSZIKMjQlSSrI0JQkqSBDU5KkggxNSZIK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", + "text/plain": [ + "
" + ] + }, + "execution_count": 19, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "from qiskit.visualization import plot_histogram\n", + "plot_histogram(counts)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The estimated outcome probabilities $\\mathrm{Pr}(000)$ and $\\mathrm{Pr}(111)$ are computed by taking the aggregate counts and dividing by the number of shots (times the circuit was repeated). Try changing the `shots` keyword in the `run` method and see how the estimated probabilities change." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Next steps\n", + "\n", + "\n", + " - Learn how to [build circuits](../build/) in more detail.\n", + " - Try out some [tutorials.](https://learning.quantum-computing.ibm.com/catalog?content=tutorials)\n", + "" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2021-07-31T05:06:28.643646Z", + "start_time": "2021-07-31T05:06:27.732825Z" + } + }, + "outputs": [], + "source": [ + "import qiskit.tools.jupyter\n", + "%qiskit_version_table\n", + "%qiskit_copyright" + ] + } + ], + "metadata": { + "anaconda-cloud": {}, + "celltoolbar": "Tags", + "description": "Introduction to Qiskit open-source notebook", + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.7.7" + }, + "title": "Introduction to Qiskit open-source", + "varInspector": { + "cols": { + "lenName": 16, + "lenType": 16, + "lenVar": 40 + }, + "kernels_config": { + "python": { + "delete_cmd_postfix": "", + "delete_cmd_prefix": "del ", + "library": "var_list.py", + "varRefreshCmd": "print(var_dic_list())" + }, + "r": { + "delete_cmd_postfix": ") ", + "delete_cmd_prefix": "rm(", + "library": "var_list.r", + "varRefreshCmd": "cat(var_dic_list()) " + } + }, + "types_to_exclude": [ + "module", + "function", + "builtin_function_or_method", + "instance", + "_Feature" + ], + "window_display": false + } + }, + "nbformat": 4, + "nbformat_minor": 1 +} diff --git a/docs/start/runtime.mdx b/docs/start/runtime.mdx new file mode 100644 index 0000000000..76e8a15fcf --- /dev/null +++ b/docs/start/runtime.mdx @@ -0,0 +1,137 @@ +--- +title: Introduction to Qiskit Runtime +description: Introduction to Qiskit Runtime, sessions, and primitives +in_page_toc_max_heading_level: 2 +--- + +# Introduction to Qiskit Runtime + +{/* Comes from https://qiskit.org/documentation/partners/qiskit_ibm_runtime/getting_started.html */} + + + + This documentation is based on Qiskit Runtime version 0.12.1. + + +Qiskit Runtime is a cloud-based quantum computing service developed by IBM. It offers computational *primitives* to perform foundational quantum computing tasks that use built-in error suppression and mitigation techniques. Primitives can be executed inside of *sessions*, so that collections of circuits can jointly run on a quantum computer without being interrupted by other users’ jobs. The combination of primitives, error suppression / mitigation, and sessions paves the way to efficiently build and execute scalable quantum applications, as shown in the [code examples](../build/primitives-examples). + +The following figure illustrates how one can use Qiskit Runtime sessions and primitives. The first session request (job) waits through the regular [fair-share queue](../run/queue). When it starts to run, the session is started. After the first session job is finished processing, the next job in the session is run. This process continues until the session is paused (due to a lack of queued session jobs) or closed. + +![Qiskit Runtime architecture diagram.](/images/start/runtime-architecture.png 'Figure 1: Qiskit Runtime architecture') + +**Benefits of using Qiskit Runtime**: + +- Simplify algorithm design and optimization. +- Run circuits faster by using sessions - a context manager designed to efficiently manage iterative workloads and minimize artificial latency between quantum and classical sub-components. +- Access our most powerful quantum systems with our latest performance and hardware optimization, including capabilities like error suppression and mitigation. +- Easily integrate Qiskit Runtime with your cloud or on-premise classical compute resources by using the [Quantum serverless](https://github.com/Qiskit-Extensions/quantum-serverless) toolkit. + +**Simplified interface**: + +Use primitive programs to write code more efficiently. For details, see the [Migration examples](migrate-examples) topic. + +```python title="Without using primitives" +def get_evaluate_energy_vqe( + self, + ansatz: QuantumCircuit, + operator: OperatorBase, + return_expectation: bool = False, +) -> Callable[[np.ndarray], np.ndarray | float]: + + num_parameters = ansatz.num_parameters + ansatz_params = ansatz.parameters + + expect_op, expectation = self.construct_expectation( + ansatz_params, operator, return_expectation=True + ) + + def evaluate_energy(parameters: np.ndarray): + + parameter_sets = np.reshape(parameters, (-1, num_parameters)) + # Create dict associating each parameter with the lists of parameterization values for it + param_bindings = dict(zip(ansatz_params, parameter_sets.transpose().tolist())) + + sampled_expect_op = self._circuit_sampler.convert(expect_op, params=param_bindings) + means = np.real(sampled_expect_op.eval()) + + return means if len(means) > 1 else means[0] + + if return_expectation: + return evaluate_energy, expectation + + return evaluate_energy +``` + +```python title="Using primitives" +def _get_evaluate_energy_vqe_primitives( + self, + ansatz: QuantumCircuit, + operator: BaseOperator | PauliSumOp, +) -> Callable[[np.ndarray], np.ndarray | float]: + + num_parameters = ansatz.num_parameters + + def evaluate_energy(parameters: np.ndarray): + + parameters = np.reshape(parameters, (-1, num_parameters)).tolist() + batch_size = len(parameters) + + job = self.estimator.run(batch_size * [ansatz], batch_size * [operator], parameters) + estimator_result = job.result() + values = estimator_result.values + + return values[0] if len(values) == 1 else values + + return evaluate_energy +``` + +## Primitives + +Primitives are base level operations that serve as building blocks for many quantum algorithms and applications. Through these primitives, users can obtain high-fidelity results without needing detailed hardware knowledge. This abstraction allows you to write code, using Qiskit algorithms or otherwise, that can run on various quantum hardware or simulators without having to explicitly manage aspects such as compilation, optimization, and error suppression / mitigation. The primitives offered by [qiskit_ibm_runtime](../api/qiskit-ibm-runtime/runtime_service) add additional options specific to IBM services. See [Introduction to primitives](../build/primitives) for further details. +There are currently two primitives defined in Qiskit: Estimator and Sampler. + +### Estimator + +The Estimator primitive allows you to efficiently calculate and interpret expectation values of quantum operators, which are the values of interest for many near-term quantum algorithms. You specify circuits that prepare quantum states and then Pauli-basis observables to measure on those states. Estimator can use advanced error suppression and mitigation capabilities to improve the accuracy of the returned expectation values. [Get started with the Estimator primitive here.](../build/primitives-get-started#get-started-with-estimator) + + +### Sampler + +This primitive takes circuits as input and returns a quasi-probability distribution over the measurement outcomes. This generalizes histograms from quantum circuits, allowing for mitigation of readout errors. [Get started with the Sampler primitive tutorial here.](../build/primitives-get-started#get-started-with-sampler) + +## Sessions + +Runtime sessions can be used in conjunction with Qiskit Runtime primitives. A session allows a collection of jobs to be grouped and jointly scheduled by the Qiskit Runtime service, facilitating iterative use of quantum computers without incurring queuing delays on each iteration. This eliminates artificial delays caused by other users’ jobs running on the same quantum device during the session. See the [sessions topic](../run/sessions) for more information. + +## Error suppression / mitigation + +While building a fault-tolerant quantum computation is the ultimate goal, at present, calculations performed on near-term quantum computers are susceptible to noise. Qiskit Runtime offers a number of methods for preventing errors before they occur (error suppression techniques) and dealing with those that do occur (error mitigation techniques). See [Configure error suppression](../optimize/error-suppression) and [Configure error mitigation](../optimize/error-mitigation) for details. + +## Runtime FAQs + +
+What is the difference between the open source primitives and primitives available through Qiskit Runtime? + +The open-source primitive contains the base classes (to define interfaces) and a reference implementation. The Qiskit Runtime primitives provide more sophisticated implementation (such as with error mitigation) as a cloud-based service. +
+ +
+What is the maximum execution time for a Qiskit Runtime job or session? + + +To ensure fairness and to help control cost, there is a maximum amount of time each Qiskit Runtime job can run. If a job exceeds this time limit, it is forcibly canceled and a `RuntimeJobMaxTimeoutError` exception is raised. This maximum time is the smallest of these values: + +- The max_execution_time defined by the job +- The max_time defined by the session (does not apply to simulator jobs) +- The system-calculated timeout + +See [Maximum execution time](../run/max-execution-time) for full details. +
+ + +## Next steps + + + - Learn how to [build circuits](../build/) in more detail. + - Try out some [tutorials.](https://learning.quantum-computing.ibm.com/catalog?content=tutorials) + diff --git a/docs/test/index.mdx b/docs/test/index.mdx new file mode 100644 index 0000000000..9058584865 --- /dev/null +++ b/docs/test/index.mdx @@ -0,0 +1,12 @@ +--- +title: Overview +description: Overview of test phase +--- +# Overview + +In the test phase, you test your quantum programs by running them on simulated devices and exploring their performance under realistic device [noise models](https://qiskit.org/ecosystem/aer/apidocs/aer_noise.html). This allows you to verify their validity before sending them to a physical system. This phase consists of the following steps: + +1. Run your program on a [quantum simulator](simulators). +1. [Add noise to your simulation](noise). +2. Optionally [create your own noise model](building_noise_models). + diff --git a/docs/test/simulators.mdx b/docs/test/simulators.mdx new file mode 100644 index 0000000000..4d74006ff9 --- /dev/null +++ b/docs/test/simulators.mdx @@ -0,0 +1,122 @@ +--- +title: Simulators overview +description: Overview of simulators +--- +# Simulators overview + +IBM Quantum features a collection of high-performance simulators for prototyping quantum circuits and algorithms. + +To view available simulators, on the upper right corner of the screen, click the Application switcher ( ![switcher](/images/migration/switcher-small2.png) ), select **Compute resources** to view the [Compute resources page,](https://quantum-computing.ibm.com/services/resources?services=simulators) then click the Simulators tab. + +The default choice of simulator should be the `simulator_statevector` as it is a general-purpose solution method. The following simulation methods are currently available, and support a maximum of 300 circuits and 8192 shots per job. + + + To prevent the simulators from processing jobs that would otherwise not finish processing in a reasonable amount of time, jobs sent to the simulators are limited to run times under 10,000 seconds (\~2.75 hours). + + +## Statevector + +**Type:** Schrödinger wavefunction + +**Name:** simulator\_statevector + +Simulates a quantum circuit by computing the wavefunction of the qubit’s statevector as gates and instructions are applied. Supports general noise modeling. + +**Qubits:** 32 + +**Noise modeling:** Yes + +**Supported gates / instructions** + +```python +['u1', 'u2', 'u3', 'u', 'p', 'r', 'rx', 'ry', 'rz', 'id', +'x', 'y', 'z', 'h', 's', 'sdg', 'sx', 't', 'tdg', 'swap', +'cx', 'cy', 'cz', 'csx', 'cp', 'cu1', 'cu2', 'cu3', 'rxx', +'ryy', 'rzz', 'rzx', 'ccx', 'cswap', 'mcx', 'mcy', 'mcz', +'mcsx', 'mcp', 'mcu1', 'mcu2', 'mcu3', 'mcrx', 'mcry', +'mcrz', 'mcr', 'mcswap', 'unitary', 'diagonal', +'multiplexer', 'initialize', 'kraus', 'roerror', 'delay'] +``` + +## Stabilizer + +**Type:** Clifford + +**Name:** simulator\_stabilizer + +An efficient simulator of Clifford circuits. Can simulate noisy evolution if the noise operators are also Clifford gates. + +**Qubits:** 5000 + +**Noise modeling:** Yes (Clifford only) + +**Supported gates / instructions** + +```python +['cx', 'cy', 'cz', 'id', 'x', 'y', 'z', 'h', +'s', 'sdg', 'sx', 'swap', 'delay', 'roerror'] +``` + +## Extended stabilizer + +**Type:** Extended Clifford (e.g., Clifford+T) + +**Name:** simulator\_extended\_stabilizer + +Approximates the action of a quantum circuit using a ranked-stabilizer decomposition. The number of non-Clifford gates determines the number of stabilizer terms. + +**Qubits:** 63 + +**Noise modeling:** No + +**Supported gates / instructions** + +```python +['u0', 'u1', 'cx', 'cz', 'id', 'x', 'y', 'z', 'h', +'t', 'tdg', 's', 'sdg', 'sx', 'swap', 'p', 'ccx', 'ccz', +'delay', 'roerror'] +``` + +## MPS + +**Type:** Matrix Product State + +**Name:** simulator\_mps + +A tensor-network simulator that uses a Matrix Product State (MPS) representation for states. This representation is often more efficient for states with weak entanglement. + +**Qubits:** 100 + +**Noise modeling:** No + +**Supported gates / instructions** + +```python +['unitary', 't', 'tdg', 'id', 'cp', 'u1', 'u2', 'u3', 'u', +'cx', 'cz', 'x', 'y', 'z', 'h', 's', 'sdg', 'sx', 'swap', +'p', 'ccx', 'delay', 'roerror'] +``` + +## QASM + +**Type:** General, context-aware + +**Name:** ibmq\_qasm\_simulator + +A general-purpose simulator for simulating quantum circuits both ideally and subject to noise modeling. The simulation method is automatically selected based on the input circuits and parameters. + +**Qubits:** 32 + +**Noise modeling:** Yes + +**Supported gates / instructions** + +```python +['u1', 'u2', 'u3', 'u', 'p', 'r', 'rx', 'ry', 'rz', 'id', +'x', 'y', 'z', 'h', 's', 'sdg', 'sx', 't', 'tdg', 'swap', +'cx', 'cy', 'cz', 'csx', 'cp', 'cu1', 'cu2', 'cu3', 'rxx', +'ryy', 'rzz', 'rzx', 'ccx', 'cswap', 'mcx', 'mcy', 'mcz', +'mcsx', 'mcp', 'mcu1', 'mcu2', 'mcu3', 'mcrx', 'mcry', +'mcrz', 'mcr', 'mcswap', 'unitary', 'diagonal', +'multiplexer', 'initialize', 'kraus', 'roerror', 'delay'] +``` \ No newline at end of file From 32a7b18067459531c90b7b6d2a915b48ea34b6e1 Mon Sep 17 00:00:00 2001 From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com> Date: Wed, 4 Oct 2023 12:33:32 -0400 Subject: [PATCH 5/9] Migrate Hello World guide from closed source Co-authored-by: Frank Harkins Co-authored-by: Rebecca Dimock <66339736+beckykd@users.noreply.github.com> Co-authored-by: Abby Cross --- docs/start/hello-world.ipynb | 326 +++++++++++++++++++++++++++++++++++ 1 file changed, 326 insertions(+) create mode 100644 docs/start/hello-world.ipynb diff --git a/docs/start/hello-world.ipynb b/docs/start/hello-world.ipynb new file mode 100644 index 0000000000..5ce5b135ec --- /dev/null +++ b/docs/start/hello-world.ipynb @@ -0,0 +1,326 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "id": "552b1077", + "metadata": {}, + "source": [ + "# Hello world\n", + "\n", + "This Hello world example creates a simple quantum program and runs it on a quantum system. Begin with following the [Install and set up](install) instructions if you haven't already, including the steps to [Set up to use IBM Quantum Platform](install#set-up-to-use-ibm-quantum-platform).\n", + "\n", + "We recommend that you use the [Jupyter](https://jupyter.org/install) development environment to interact with quantum computers. Be sure to install the recommended extra visualization support (`pip install qiskit[visualization]`), and note that zsh users need to put `'qiskit[visualization]'` in single quotes.\n", + "\n", + "To learn about quantum computing in general, check out the [Basics of quantum information course](https://learning.quantum-computing.ibm.com/course/basics-of-quantum-information) in IBM Quantum Learning.\n", + "\n", + "\n", + "The four steps to writing a quantum program are \n", + "\n", + "1. Map the problem to a quantum-native format\n", + "2. Optimize the circuits and operators\n", + "3. Execute using a quantum primitive function\n", + "4. Analyze the results\n", + "\n", + "## Step 1. Map the problem to a quantum-native format\n" + ] + }, + { + "cell_type": "markdown", + "id": "85fe979e", + "metadata": { + "raw_mimetype": "text/restructuredtext" + }, + "source": [ + "In a quantum program, *quantum circuits* are the native format in which to represent quantum instructions, and *operators* represent the observables to be measured. When creating a circuit, you'll usually create a new [`QuantumCircuit`](/api/qiskit/qiskit.circuit.QuantumCircuit#quantumcircuit) object, then add instructions to it in sequence.\n" + ] + }, + { + "cell_type": "markdown", + "id": "21f7a26c", + "metadata": {}, + "source": [ + "The following code cell creates a circuit that produces a *Bell state,* which is a specific two-qubit entangled state.\n", + "\n", + "\n", + " Qiskit uses little-endian bit ordering; that is, the bit (or qubit) with index 0 is the least significant qubit. This differs across authors and software packages, so be aware!\n", + "\n" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "id": "930ca3b6", + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAPEAAACuCAYAAADnE+srAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy81sbWrAAAACXBIWXMAAA9hAAAPYQGoP6dpAAANdElEQVR4nO3df0yUeWLH8fcMroICyoDpuIIiCpbfbGTZxXqmGLxbolg3rak9626ybvaPxmhSz9k/mtQ1aWrZmiY1Jlf9o9mkf1DatZu60Ow1V67RZV2KR7nzhF2UE48BxtsRlB+COjL9Y6ory6AMzq/vw+eVGMPM8zzfr5E3zzPP88xg8/v9fkTEWPZYT0BEXowiFjGcIhYxnCIWMZwiFjGcIhYxnCIWMZwiFjGcIhYxnCIWMZwiFjGcIhYxnCIWMZwiFjGcIhYxnCIWMZwiFjGcIhYxnCIWMZwiFjGcIhYxnCIWMZwiFjGcIhYxnCIWMZwiFjGcIhYxnCIWMZwiFjGcIhYxnCIWMZwiFjGcIhYxnCIWMZwiFjGcIhYxnCIWMdyiWE9AZvL74cGjWM8iNIsTwGaL9SwWJkUchx48gvcbYj2L0NT9MSzRd1NM6HBaxHCKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCWj9jr9eJyudiwYQOJiYlkZWVx+PBhxsfHOXDgADabjdOnT8d6mhJhvkfQ81v4ZR90DcDweKxnFD6WfvNYR0cHNTU1eDweli1bRkFBAQMDA5w6dYqenh6GhoYAKCsri+1EI8Td+d+c++sqtvzJ37Jpx4+CLvP3f2oju2wHf/CjxijPLjruTkBLN1y6DqOT3z5uAwpWw/c2wu+uitn0wsKyEXu9Xmpra/F4PBw5coRjx46RkpICwIcffsj777/PokWLsNlslJSUxHi2EgnuITj7MxiZnPmcH7jaH/izLR9qXzH3Qw0sezh96NAh3G43Bw8e5OTJk08CBnC5XJSWluLz+cjOziY1NTWGM5VI+GYUftwcPODvau6Cz65Efk6RYsmIu7q6aGhoICMjgxMnTgRdZtOmTQCUlpZOe/zGjRvs2rWLlJQU0tLSeOutt7h9+3bE5yzh1dgB4/fnvvx/XoHbYxGbTkRZ8nC6vr6eqakp9u3bR3JyctBlkpKSgOkRj46OUlVVhcPhoL6+nomJCVwuFzt37qSlpQW73cyfeb4H95gY9cZ6GlFz9x5c6QttHT/wxbXAYbVpLBlxc3MzAFVVVbMu43a7gekRnz17lv7+fi5cuMCaNWsAyMzMZPPmzZw/f57du3dHbtIR9OW5Y3x57lispxE1P++FKX/o67X9WhHHjZs3bwKwdu3aoM/7fD5aWlqA6RE3NjayZcuWJwEDVFZWkpOTw6effjrviMvLy/F4PHNePuGlJN78q2vzGiuYoqr3yH1tT9DnPvmb7WEZIy83l0cPJ8KyrRdVWnuc3C0HQl5vZBKy1mTjn/JFYFbP5nQ6uXz58rzWtWTE4+OBi4ATE8G/qRoaGvB6vaSkpLBu3bonj3d2drJnz8xv9sLCQjo7O+c9H4/HQ39//5yXX7Rk6bzHCmaFM5c1RdVh3eZ3DQwO4Lt/L6JjzNX6sdF5r9vf78Y/ZdbnBVsyYqfTyfDwMO3t7VRWVk57bnBwkKNHjwJQUlKC7anrCsPDw6xYsWLG9hwOB19//fULzScUCS8lzXusWHl51ctxsye2+0bmtd7EiIeXV4X2fxUuoX6PPM2SEVdXV9PV1UVdXR3bt28nLy8PgLa2Nvbv34/XGzjJE62bPEI9TLrvM+9zp7uvXYubz52+OwHHPwn9dfGuSidn/v9ciUnMPN36HC6Xi/T0dPr6+igsLKS4uJjc3FwqKirIyclh27ZtwMzLS2lpady5c2fG9oaGhnA4HNGYuoTB8iQoyQptHZsNKjdEZj6RZsmIMzMzuXjxIjt27CAxMZHe3l4cDgdnzpyhqamJ7u5uYGbE+fn5QV/7dnZ2kp+fH5W5S3jUvgLJiXNf/o1icAS/Ghn3LBkxBIJsbGxkdHSU0dFRWltbee+99xgfH6e3txe73U5RUdG0dXbu3Mnnn3/+5PITQGtrKz09PdTW1kb7nyAvID0Z/mxbYK/8PNsL4ftFz18uXtn8fv88rqiZq7W1lddff52NGzfy1VdfTXtuZGSE4uJiMjIyOH78OJOTk7hcLlauXMmlS5eidrOHia+J4/V3MY1OBm7i+OJa4LXy00qy4Ht5kBubc1lhY9k98WyuXAncJPvdQ2mA1NRUmpubWbVqFXv37uXdd99l8+bNNDY2Gnu31kKXkgg/KIa/3A2Hvw9LF3/7+DtbzQ8YLHp2+lmeFTHA+vXraWy05tvyFrIEO6xbCS8lBL62G/qOpWAW3O7leRGLmGbB7Ykf31ctYhULbk8sYjWKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCKWMRwC+7eaRMsTgi8P9ckixNiPYOFSxHHIZstPt9gL/FJh9MihlPEIoZTxCKGU8QihlPEIoZTxCKGU8QihlPEIoZTxCKGU8QihlPEIoZTxCKGU8QihlPEIoZTxCKGU8QihlPEIoZTxCKGU8QihlPEIoZTxCKGU8QihlPEIoZTxCKG00eUi6WNTEDfUODP7TG49yDw+MQD+LIHshzgXA4JBu/ObH6/3x/rSYiE08NH8IvfwOfd0Ot9/vJLF8Nr6+H3ciEjJfLzCzdFLJbh98PlG/Dv7TB2f37beGUt/GE5JCeGd26RpIjFEu5OwL+0wtX+F99W8hL4owooW/Pi24oGRSzG89yFH/9XIORw+kExvFEc+AV38UwntsRovx2B0z+Fscnwb/snVwJ/15SEf9vhZPA5OVno7j+Esz+LTMCP/eRK4HV2PNOeWIz1aQd4x0Jb58/fgNSkwKWnv/tsbuv822XIdcLypJCnGBULYk/s9XpxuVxs2LCBxMREsrKyOHz4MOPj4xw4cACbzcbp06djPU0JwfVbgUtIoUpNghVLA3/P1b0H8K//E/pY0WL5PXFHRwc1NTV4PB6WLVtGQUEBAwMDnDp1ip6eHoaGhgAoKyuL7UQlJI9fr0bLr9zgHoJMR3THnQtL74m9Xi+1tbV4PB6OHDnC4OAg7e3teDwe6urqaGpqoq2tDZvNRklJnJ+9kCdu3YVrt6I/bsu16I85F5aO+NChQ7jdbg4ePMjJkydJSfn2dhyXy0VpaSk+n4/s7GxSU1NjOFMJxRfXYzPuz2/A5MPYjP0slo24q6uLhoYGMjIyOHHiRNBlNm3aBEBpaemTxx5HX1FRwZIlS7DF+0XCBeh6DPbCAA8ewW9ux2bsZ7FsxPX19UxNTbFv3z6Sk5ODLpOUFDi78XTE169f59y5czidTl599dWozFXm7uEjGLwTu/HdQ7EbezaWjbi5uRmAqqqqWZdxu93A9Ii3bt3K4OAg58+fp7q6OrKTlJAN3oGpGN5j2BeHEVv27PTNmzcBWLt2bdDnfT4fLS0twPSI7fbw/1wrLy/H4/GEfbsLkXNjFVve+aegzz2+BvwsqYnf/v3Bm7MvN9t15M9+eoG/2PvDOc527pxOJ5cvX57XupaNeHx8HICJieA31DY0NOD1eklJSWHdunURnYvH46G/Pwx35guLf+furM89vgY8F3b73Jd92kOfP+7+Ly0bsdPpZHh4mPb2diorK6c9Nzg4yNGjRwEoKSmJ+Mkrp9MZ0e0vJGnLZ3/D78gc3gCRmhgIeGoKRp5xu+Zs21qU4Gf16tXPHyhEL/I9YtmIq6ur6erqoq6uju3bt5OXlwdAW1sb+/fvx+sNvFs8Gjd5zPcwSWa6dRdONAZ/bi63UX7wZmAPPDIJH3wS+vi7a36ffz7uDn3FCLLsiS2Xy0V6ejp9fX0UFhZSXFxMbm4uFRUV5OTksG3bNmD662GJfytTYUkMdz1ZumMrejIzM7l48SI7duwgMTGR3t5eHA4HZ86coampie7uwI23itgsdhusTovd+FnpsRt7NpY9nAbIz8+nsXHmsdfY2Bi9vb3Y7XaKiopiMDN5EUWZ8Otvoj/u8qTY/gCZjaUjns3Vq1fx+/3k5eWxdOnMU5Qff/wxAJ2dndO+zs7Opry8PHoTlaAqcuA/fgG+qeiOW5kbn5+KuSAjvnIl8BaY2Q6l9+zZE/Trt99+m48++iiic5PnS06EsrXRfbO+3QaV66M3XigUcRD62LH4V1MCv+yDB77ojLetAJbP47pyNMThwUHkPS9iiX/pybDrleiM5Vwe+MC8eLUg98SP76sWs23Ohc5+6ByY+zqPb+KYy40hAC8lwA8rYVFC6POLFn1krRjtvg/+oRluROBsdYIdDmyFgvDfoBVWiliMd/8h/ONF+HowfNtcsgje2QobV4Vvm5GiiMUSpqbgQjc0dQTec/wi8pyw9zVwBH8betxRxGIp34zA+f+FX/UHfjdTKNKToboQXl8f/7/14WmKWCxpeBwuXQ9chro1MnvQy5ZAzsrASbKNqwLXg02jiMXy7vugfyjwQfO+R4ETVkmLITMN0paZtdcNRhGLGG5B3uwhYiWKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCKWMRwiljEcIpYxHCKWMRwiljEcIpYxHD/B4nXoRy3dQ/QAAAAAElFTkSuQmCC", + "text/plain": [ + "
" + ] + }, + "execution_count": 1, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "from qiskit import QuantumCircuit\n", + "\n", + "# Create a new circuit with two qubits (first argument) and two classical\n", + "# bits (second argument)\n", + "qc = QuantumCircuit(2)\n", + "\n", + "# Add a Hadamard gate to qubit 0\n", + "qc.h(0)\n", + "\n", + "# Perform a controlled-X gate on qubit 1, controlled by qubit 0\n", + "qc.cx(0, 1)\n", + "\n", + "# Return a drawing of the circuit using MatPlotLib (\"mpl\"). This is the\n", + "# last line of the cell, so the drawing appears in the cell output.\n", + "# Remove the \"mpl\" argument to get a text drawing.\n", + "qc.draw(\"mpl\")" + ] + }, + { + "cell_type": "markdown", + "id": "0c957de9", + "metadata": { + "raw_mimetype": "text/restructuredtext" + }, + "source": [ + "See [`QuantumCircuit`](/api/qiskit/qiskit.circuit.QuantumCircuit#quantumcircuit) in the documentation for all available operations.\n" + ] + }, + { + "cell_type": "markdown", + "id": "f3ef4248-7938-44c1-85f1-edc997f0edcd", + "metadata": {}, + "source": [ + "The following code cell uses the `quantum_info` package to create the two-qubit Pauli operator Z on qubit 1 and Z on qubit 2. If the state is entangled, then the correlation between qubit 1 and qubit 2 is one.\n" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "id": "c57b261c-b757-4432-beab-61b526c98a41", + "metadata": {}, + "outputs": [], + "source": [ + "from qiskit.quantum_info import Pauli\n", + "\n", + "ZZ = Pauli('ZZ')\n", + "ZI = Pauli('ZI')\n", + "IZ = Pauli('IZ')\n", + "XX = Pauli('XX')\n", + "XI = Pauli('XI')\n", + "IX = Pauli('IX')" + ] + }, + { + "cell_type": "markdown", + "id": "83bf9151-3bc9-40d2-8615-31570238b08e", + "metadata": {}, + "source": [ + "## Step 2. Optimize the circuits and operators\n", + "\n", + "For this example, the circuit the operators are simple, so no optimizations are needed. " + ] + }, + { + "cell_type": "markdown", + "id": "9acac1d4", + "metadata": {}, + "source": [ + "## Step 3. Execute using a quantum primitive function\n", + "\n", + "\n", + "Quantum computers can produce random results, so you'll often want to collect a sample of the outputs by running the circuit many times. You can estimate the value of the observable using the `Estimator` class. `Estimator` is one of our two [primitives](../build/primitives); the other is `Sampler`, which can be used to get data from a quantum computer. " + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "id": "69a8d872", + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "EstimatorResult(values=array([0.01795728, 0.03257367, 0.02751255, 0.01213789, 0.98291386,\n", + " 0.97229465]), metadata=[{'variance': 1.0931623420576193, 'shots': 5008, 'readout_mitigation_num_twirled_circuits': 16, 'readout_mitigation_shots_calibration': 8192}, {'variance': 1.092423762099776, 'shots': 5008, 'readout_mitigation_num_twirled_circuits': 16, 'readout_mitigation_shots_calibration': 8192}, {'variance': 1.0256330625131442, 'shots': 5008, 'readout_mitigation_num_twirled_circuits': 16, 'readout_mitigation_shots_calibration': 8192}, {'variance': 1.0262426744136923, 'shots': 5008, 'readout_mitigation_num_twirled_circuits': 16, 'readout_mitigation_shots_calibration': 8192}, {'variance': 0.16516750416031306, 'shots': 5008, 'readout_mitigation_num_twirled_circuits': 16, 'readout_mitigation_shots_calibration': 8192}, {'variance': 0.18593026938419716, 'shots': 5008, 'readout_mitigation_num_twirled_circuits': 16, 'readout_mitigation_shots_calibration': 8192}])" + ] + }, + "execution_count": 3, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "from qiskit_ibm_runtime import QiskitRuntimeService, Estimator, Options\n", + "\n", + "service = QiskitRuntimeService()\n", + "\n", + "# Run on the least-busy backend you have access to\n", + "backend = service.least_busy(simulator=False, operational=True)\n", + "\n", + "options = Options()\n", + "options.resilience_level = 1\n", + "options.optimization_level = 3\n", + "\n", + "# Create a Sampler object\n", + "estimator = Estimator(backend, options=options)\n", + "\n", + "# Submit the circuit to the sampler\n", + "job = estimator.run(circuits=[qc]*6, observables=[IZ, IX, ZI, XI, ZZ, XX], shots = 5000)\n", + "\n", + "# Once the job is complete, get the result\n", + "job.result()" + ] + }, + { + "cell_type": "markdown", + "id": "e3ac728c", + "metadata": {}, + "source": [ + "\n", + " Queue times on real devices may vary. If you would like to get a faster result, replace the `backend =` line with the following instead:\n", + "\n", + " ```python\n", + "\n", + " # Run on a simulator\n", + "\n", + " backend = service.get_backend(\"ibmq_qasm_simulator\")\n", + "\n", + " ```\n", + "\n" + ] + }, + { + "cell_type": "markdown", + "id": "dc5ce1eb", + "metadata": {}, + "source": [ + "The `values` property is a list of expectation values for each of the observables we provided." + ] + }, + { + "cell_type": "markdown", + "id": "0d5ea9a0", + "metadata": {}, + "source": [ + "## Step 4. Analyze the results\n", + "\n" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "id": "57a82991-3ae9-400f-b8be-f8eb1fea79c5", + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAjcAAAGwCAYAAABVdURTAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguMCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy81sbWrAAAACXBIWXMAAA9hAAAPYQGoP6dpAAA+z0lEQVR4nO3deXyU5b3///fs2UMgELZIWBIFRaggCIooRnE5KJ6qHKTCoS6nrVqU028FUbH1KFoL4qlYXKq0v1rBavVQsVikQlCwFBBXZIcgkEACZCPrzPX7I5khMQGSMJl7ZvJ6Ph7zIPc998x8ZrjJvLmW+7IZY4wAAACihN3qAgAAAIKJcAMAAKIK4QYAAEQVwg0AAIgqhBsAABBVCDcAACCqEG4AAEBUcVpdQKj5fD4dOHBAiYmJstlsVpcDAACawRijkpISde/eXXb7qdtm2l24OXDggNLT060uAwAAtMK+ffvUs2fPUx7T7sJNYmKipNoPJykpyeJqAABAcxQXFys9PT3wPX4q7S7c+LuikpKSCDcAAESY5gwpYUAxAACIKoQbAAAQVQg3AAAgqhBuAABAVCHcAACAqEK4AQAAUYVwAwAAogrhBgAARBVLw01OTo7GjRun7t27y2az6Z133jntY1atWqULLrhAHo9H/fr106JFi9q8TgAAEDksDTdlZWUaNGiQFixY0Kzjd+/ereuuu06XX365Nm/erPvuu0933HGH3n///TauFAAARApLl1+45pprdM011zT7+IULF6p3796aO3euJKl///766KOP9Mwzz2js2LFtVSYAAIggETXmZt26dcrOzm6wb+zYsVq3bt1JH1NZWani4uIGNwAAEL0iKtzk5eUpLS2twb60tDQVFxervLy8ycfMmTNHycnJgVt6enooSgUAABaJqHDTGjNnzlRRUVHgtm/fPqtLAgCEms8r7V4jffFm7Z8+r9UVoQ1ZOuampbp27ar8/PwG+/Lz85WUlKTY2NgmH+PxeOTxeEJRHgAgHH29VPrbz6WSgyf2JXWXrn5KGnC9dXWhzURUy82IESO0cuXKBvtWrFihESNGWFQRACCsfb1UemNyw2AjScUHa/d/vdSautCmLA03paWl2rx5szZv3iypdqr35s2blZubK6m2S2ny5MmB43/0ox9p165d+vnPf65vvvlGzz//vN544w3df//9VpQP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TEFBQUhqa3cLZ7Yln8+nW2+9VU6nU6+99lrQVx1HLZvNpt/+9rfq37+/Bg4cqBkzZlhdUlThPG57nMNtrznncU5Oju677z49//zzGjlypAVVRrbmnMdjxozRTTfdpMWLF2vJkiXq1KlTSGpjQHEQPfjgg1q3bp3+7//+T4mJiVaXE9VeeeUVxcXFaffu3fr222+tLieqcB6HBudw2zrdeZybm6ubbrpJd911l+644w4LKowOpzuP9+/fr+XLlysuLk5r1qwJWV2EmyBZvHixfv3rX2vx4sXKzMy0upyotnbtWj3zzDN69913NWzYMN1+++0yrCISFJzHocE53LZOdx6Xl5frxhtv1Lnnnqv58+eHvsAo0Zzz+M4779SQIUP07rvv6re//W3oZqOFpPMrCtUfB/Lpp5+auLg48/TTT1tbVJSq/1mXlZWZzMxMc++99xpjascnJCQkmOeff97CCqPD6c5jxoIEx+nOYT7nM9Oc38e33nqrycjIMIcPHw5hZdGlOb+LX3rpJZOYmGj27NljjDHmnnvuMX369DGlpaVtXh/hppX8X7iHDx82vXr1Mtdee22TUxAPHTpkdakRr364+elPf2r69etnysrKAvcvXLjQJCQkmN27d1tTYBRoznnMl25wnO4c5nNuveacx7/61a+My+Uyy5cvb/KY48ePW/02IsLpzuM9e/aYxMRE88ILLwTuLysrM3379jX33HNPm9dHuGkl/xfuokWLjKST3nr16mV1qRHP/1mvWrXKOBwOs2bNmkbHXHXVVWbMmDHMUGul5pzHfOmeueacw7t27eJzbqXmnMcZGRmnPObVV1+1+m2Eveacx2PGjDFXXXVVo/vXrFljHA6HWbVqVZvWaDOGjl4AABA9GFAMAACiCuEGAABEFcINAACIKoQbAAAQVQg3AAAgqhBuAABAVCHcAACAqEK4AQAAUYVwAyDoMjIyInZBwssuu0z33XffKY+J5PcHtAeEGwAtsm/fPv3whz9U9+7d5Xa71atXL02bNk2FhYVWlwYAkgg3AFpg165dGjp0qLZv367XX39dO3bs0MKFC7Vy5UqNGDFCR44csaQur9crn89nyWsDCD+EGwDNdvfdd8vtduvvf/+7Ro8erbPOOkvXXHONPvjgA+3fv1+zZs0KHFtSUqKJEycqPj5ePXr00IIFCwL3GWP06KOP6qyzzpLH41H37t3105/+NHB/ZWWlfvazn6lHjx6Kj4/X8OHDtWrVqsD9ixYtUocOHbR06VINGDBAHo9HL7/8smJiYnTs2LEGNU+bNk1jxoyRJBUWFmrixInq0aOH4uLiNHDgQL3++uuN3mdNTY3uueceJScnKzU1VQ8//LBOtQzfsWPHdMcdd6hz585KSkrSmDFj9NlnnwXu/+yzz3T55ZcrMTFRSUlJGjJkiDZs2NDszx1AyxBuADTLkSNH9P777+snP/mJYmNjG9zXtWtXTZo0SUuWLAmEgKefflqDBg3Sp59+qhkzZmjatGlasWKFJOmtt97SM888oxdeeEHbt2/XO++8o4EDBwae75577tG6deu0ePFiff7557r55pt19dVXa/v27YFjjh8/rqeeekovv/yyvvrqK02aNEkdOnTQW2+9FTjG6/VqyZIlmjRpkiSpoqJCQ4YM0bJly/Tll1/qrrvu0m233ab169c3eD+///3v5XQ6tX79ej377LOaN2+eXn755ZN+NjfffLMOHTqkv/3tb9q4caMuuOACXXHFFYGWrEmTJqlnz57617/+pY0bN2rGjBlyuVyt+WsA0BxtuuY4gKjxySefGEnm7bffbvL+efPmGUkmPz/f9OrVy1x99dUN7p8wYYK55pprjDHGzJ0712RlZZmqqqpGz7N3717jcDjM/v37G+y/4oorzMyZM40xxrz66qtGktm8eXODY6ZNm2bGjBkT2H7//feNx+MxR48ePen7uu6668x///d/B7ZHjx5t+vfvb3w+X2DfAw88YPr37x/Y7tWrl3nmmWeMMcasWbPGJCUlmYqKigbP27dvX/PCCy8YY4xJTEw0ixYtOmkNAIKLlhsALWJO0T1T34gRIxptb9myRVJtS0d5ebn69OmjO++8U2+//bZqamokSV988YW8Xq+ysrKUkJAQuK1evVo7d+4MPJ/b7db555/f4DUmTZqkVatW6cCBA5Kk1157Tdddd506dOggqbYl57HHHtPAgQPVsWNHJSQk6P3331dubm6D57noootks9ka1L59+3Z5vd5G7/Ozzz5TaWmpOnXq1KDe3bt3B+qdPn267rjjDmVnZ+vJJ59s8D4ABJ/T6gIARIZ+/frJZrNpy5YtuvHGGxvdv2XLFqWkpKhz586nfa709HRt3bpVH3zwgVasWKGf/OQnevrpp7V69WqVlpbK4XBo48aNcjgcDR6XkJAQ+Dk2NrZBAJGkCy+8UH379tXixYv14x//WG+//bYWLVoUuP/pp5/Ws88+q/nz52vgwIGKj4/Xfffdp6qqqhZ+GieUlpaqW7duDcYE+flD1aOPPqpbb71Vy5Yt09/+9jfNnj1bixcvbvJzBHDmCDcAmqVTp0668sor9fzzz+v+++9vMO4mLy9Pr732miZPnhwIHJ988kmDx3/yySfq379/YDs2Nlbjxo3TuHHjdPfdd+ucc87RF198oe9973vyer06dOiQRo0a1eI6J02apNdee009e/aU3W7XddddF7jv448/1g033KAf/OAHkiSfz6dt27ZpwIABDZ7jn//8Z6PaMzMzG4UtSbrggguUl5cnp9OpjIyMk9aVlZWlrKws3X///Zo4caJeffVVwg3QRuiWAtBszz33nCorKzV27Fjl5ORo3759Wr58ua688kr16NFDjz/+eODYjz/+WL/61a+0bds2LViwQH/+8581bdo0SbWznX73u9/pyy+/1K5du/THP/5RsbGx6tWrl7KysjRp0iRNnjxZf/nLX7R7926tX79ec+bM0bJly05b46RJk7Rp0yY9/vjjuummm+TxeAL3ZWZmasWKFVq7dq22bNmi//qv/1J+fn6j58jNzdX06dO1detWvf766/rNb34TqP27srOzNWLECI0fP15///vftWfPHq1du1azZs3Shg0bVF5ernvuuUerVq3S3r179fHHH+tf//pXg6AHIMisHvQDILLs2bPHTJkyxaSlpRmXy2XS09PNvffeawoKCgLH9OrVy/ziF78wN998s4mLizNdu3Y1zz77bOD+t99+2wwfPtwkJSWZ+Ph4c9FFF5kPPvggcH9VVZV55JFHTEZGhnG5XKZbt27mxhtvNJ9//rkxpnZAcXJy8klrHDZsmJFk/vGPfzTYX1hYaG644QaTkJBgunTpYh566CEzefJkc8MNNwSOGT16tPnJT35ifvSjH5mkpCSTkpJiHnzwwQYDjOsPKDbGmOLiYnPvvfea7t27Bz6TSZMmmdzcXFNZWWn+4z/+w6Snpxu32226d+9u7rnnHlNeXt7Sjx5AM9mMaeboQAAAgAhAtxQAAIgqhBsAABBVCDcAACCqEG4AAEBUIdwAAICoQrgBAABRhXADAACiCuEGAABEFcINAACIKoQbAAAQVQg3AAAgqvz/AUTBK1hc4kUAAAAASUVORK5CYII=", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "import matplotlib.pyplot as plt\n", + "import numpy as np\n", + " \n", + "# data\n", + "data = ['IZ', 'IX', 'ZI', 'XI', 'ZZ', 'XX']\n", + "values = job.result().values\n", + " \n", + "# creating error bars\n", + "error = []\n", + "for case in job.result().metadata:\n", + " error.append(2*np.sqrt(case['variance']/case['shots']))\n", + " \n", + "# plotting graph\n", + "plt.plot(data, values)\n", + "plt.errorbar(data, values, yerr = error, fmt ='o')\n", + "plt.xlabel('Observables')\n", + "plt.ylabel('Values')\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "id": "b9a76788-3c34-4382-88f1-fc7ce9dc7234", + "metadata": {}, + "source": [ + "Here we see that for qubits 0 and 1, the independent values of both X and Z are zero, while the correlations are one. This is a hallmark of quantum entanglement." + ] + }, + { + "cell_type": "markdown", + "id": "e7c24c81", + "metadata": {}, + "source": [ + "## Next steps\n", + "\n", + "\n", + " - Learn how to [build circuits](../build/) in more detail.\n", + " - Try out some [tutorials.](https://learning.quantum-computing.ibm.com/catalog?content=tutorials)\n", + " - Learn more about [Qiskit](intro-to-qiskit) or [Qiskit Runtime](runtime).\n", + "\n" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "id": "3273c661", + "metadata": {}, + "outputs": [ + { + "data": { + "text/html": [ + "

Version Information

SoftwareVersion
qiskit0.44.1
qiskit-terra0.25.1
qiskit_ibm_runtime0.12.2
qiskit_aer0.12.2
qiskit_ibm_provider0.7.0
System information
Python version3.11.5
Python compilerClang 14.0.3 (clang-1403.0.22.14.1)
Python buildmain, Aug 24 2023 15:09:45
OSDarwin
CPUs10
Memory (Gb)32.0
Sun Oct 01 16:13:50 2023 EDT
" + ], + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "import qiskit.tools.jupyter\n", + "%qiskit_version_table" + ] + } + ], + "metadata": { + "celltoolbar": "Raw Cell Format", + "description": "Hello world notebook", + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.11.1" + }, + "title": "Hello world" + }, + "nbformat": 4, + "nbformat_minor": 5 +} From 6aa4f5c4c1fa150220d8050a7a540056305bc675 Mon Sep 17 00:00:00 2001 From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com> Date: Wed, 4 Oct 2023 12:33:32 -0400 Subject: [PATCH 6/9] Migrate Runtime migration guides from closed source MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Jessie Yu Co-authored-by: Kevin Tian Co-authored-by: Rebecca Dimock <66339736+beckykd@users.noreply.github.com> Co-authored-by: Frank Harkins Co-authored-by: Elena Peña Tapia <57907331+ElePT@users.noreply.github.com> --- docs/start/compare.mdx | 12 + docs/start/migrate-examples.mdx | 677 ++++++++++++++++++++++++++++++++ docs/start/migrate.mdx | 468 ++++++++++++++++++++++ 3 files changed, 1157 insertions(+) create mode 100644 docs/start/compare.mdx create mode 100644 docs/start/migrate-examples.mdx create mode 100644 docs/start/migrate.mdx diff --git a/docs/start/compare.mdx b/docs/start/compare.mdx new file mode 100644 index 0000000000..d946da5e77 --- /dev/null +++ b/docs/start/compare.mdx @@ -0,0 +1,12 @@ +--- +title: backend.run compared to Qiskit Runtime +description: Describes how backend.run is different from Qiskit Runtime +--- + +# backend.run compared to Qiskit Runtime + +There are two methods for accessing IBM Quantum systems. First, the `qiskit-ibm-provider` package provides the `backend.run()` interface, allowing direct access to IBM Quantum systems with no pre- or post-processing involved. This level of access is suitable for those users who want **precise control** over circuit execution and result processing. This level of access is needed for those at the level of kernel developer who are looking to develop, for example, circuit optimization routines or error mitigation techniques, or who want to characterize quantum systems. + +In contrast, Qiskit Runtime is designed to **streamline algorithm and application construction** by removing the need for users to understand technical hardware and low-level software details. Advanced processing techniques for error suppression and mitigation are automatically applied, giving users high-fidelity results without the burden of having to code these routines themselves. Sessions within Qiskit Runtime allow users to run iterative algorithm circuits back to back, or batch collections of circuits without having to re-queue each job. This results in more efficient quantum processor use and reduces the time users spend running complex computations. + +backend.run is required for running dynamic circuits. \ No newline at end of file diff --git a/docs/start/migrate-examples.mdx b/docs/start/migrate-examples.mdx new file mode 100644 index 0000000000..1f9f1145d7 --- /dev/null +++ b/docs/start/migrate-examples.mdx @@ -0,0 +1,677 @@ +--- +title: Migration examples +description: Examples of migrating from using backend.run to using Qiskit Runtime primitives + +--- + +# Migration examples + +Follow these examples to design a Qiskit Runtime algorithm. + + +## Use Estimator to design an algorithm + +The Estimator primitive is used to design an algorithm that calculates +expectation values. + +### Background + +The role of the `Estimator` primitive is two-fold: it acts as an **entry point** to quantum devices or simulators, replacing the `Backend` +interface (commonly referred to as `backend.run()`). Additionally, it is +an **algorithmic abstraction** for expectation value calculations, so +you don't have to manually construct the final expectation circuit. +This results in a considerable reduction of the code complexity and a +more compact algorithm design. + + + **Backend.run() model:** In this model, you accessed real backends and remote simulators using the `qiskit-ibmq-provider` module (now migrated to `qiskit-ibm-provider`). To run **local** simulations, you could import a specific backend from `qiskit-aer`. All of them followed the `backend.run()` interface. + +
+ Code example for `qiskit-ibmq-provider` & `backend.run()` + + ``` python + from qiskit import IBMQ + + # Select provider + provider = IBMQ.get_provider(hub="ibm-q", group="open", project="main") + + # Get backend + backend = provider.get_backend("ibmq_qasm_simulator") # cloud simulator + + # Run + result = backend.run(expectation_circuits) + ``` +
+ +
+ Code example for `qiskit-aer` & `backend.run()` + + ``` python + from qiskit_aer import AerSimulator # former import: from qiskit import Aer + + # Get local simulator backend + backend = AerSimulator() + + # Run + result = backend.run(expectation_circuits) + ``` +
+ + **Primitives model:** Access real backends and remote simulators through the `qiskit-ibm-runtime` **primitives** (`Sampler` and `Estimator`). To run **local** simulations, you can import specific local primitives from `qiskit_aer.primitives` and `qiskit.primitives`. All of them follow the `BaseSampler` and `BaseEstimator` interfaces, but **only the Runtime primitives offer access to the Runtime service, sessions, and built-in error mitigation**. + +
+ Code example for Runtime Estimator + + ``` python + from qiskit_ibm_runtime import QiskitRuntimeService, Estimator + + # Define service + service = QiskitRuntimeService() + + # Get backend + backend = service.backend("ibmq_qasm_simulator") # cloud simulator + + # Define Estimator + # (see tutorials for more information about sessions) + estimator = Estimator(session=backend) + + # Run Expectation value calculation + result = estimator.run(circuits, observables).result() + ``` +
+ +
+ Code example for Aer Estimator + + ``` python + from qiskit_aer import Estimator + + # Get local simulator Estimator + estimator = Estimator() + + # Run expectation value calculation + result = estimator.run(circuits, observables).result() + ``` + +
+ +
+ + +If your code previously calculated expectation values using +`backend.run()`, you most likely used the `qiskit.opflow` module to +handle operators and state functions. To support this scenario, the +following migration example shows how to replace the (`qiskit.opflow` & `backend.run()`) workflow with an Estimator-based workflow. + +### End-to-end example + +#### 1. Problem definition + +We want to compute the expectation value of a quantum state (circuit) +with respect to a certain operator. In this example, we are using the H2 +molecule and an arbitrary circuit as the quantum state: + +``` python +from qiskit import QuantumCircuit +from qiskit.quantum_info import SparsePauliOp + +# Step 1: Define operator +op = SparsePauliOp.from_list( + [ + ("II", -1.052373245772859), + ("IZ", 0.39793742484318045), + ("ZI", -0.39793742484318045), + ("ZZ", -0.01128010425623538), + ("XX", 0.18093119978423156), + ] +) + +# Step 2: Define quantum state +state = QuantumCircuit(2) +state.x(0) +state.x(1) +``` + + +##### 1.a. Legacy: Convert problem to opflow + +`qiskit.opflow` provided its own classes to represent both operators +and quantum states, so the problem defined above would be wrapped as: + +``` python +from qiskit.opflow import CircuitStateFn, PauliSumOp + +opflow_op = PauliSumOp(op) +opflow_state = CircuitStateFn(state) +``` + +This step is no longer necessary when using the primitives. + + + For instructions to migrate from `qiskit.opflow`, see the [opflow migration guide](https://qiskit.org/documentation/migration_guides/opflow_migration.html). + + +#### 2. Calculate expectation values on real device or cloud simulator + +##### 2.a. Legacy: Use opflow & backend.run() + +The legacy workflow required many steps to compute an expectation value: + + + Replace `ibmq_qasm_simulator` with your device name to see the complete workflow for a real device. + + +``` python +from qiskit.opflow import StateFn, PauliExpectation, CircuitSampler +from qiskit import IBMQ + +# Define the state to sample +measurable_expression = StateFn(opflow_op, is_measurement=True).compose(opflow_state) + +# Convert to expectation value calculation object +expectation = PauliExpectation().convert(measurable_expression) + +# Define provider and backend +provider = IBMQ.get_provider(hub="ibm-q", group="open", project="main") +backend = provider.get_backend("ibmq_qasm_simulator") + +# Inject backend into circuit sampler +sampler = CircuitSampler(backend).convert(expectation) + +# Evaluate +expectation_value = sampler.eval().real +``` + +``` python +>>> print("expectation: ", expectation_value) +expectation: -1.065734058826613 +``` + +##### 2.b. Updated: Use the Estimator Runtime primitive + +The `Estimator` simplifies the user-side syntax, making it a more +convenient tool for algorithm design. + + + Replace `ibmq_qasm_simulator` with your device name to see the complete workflow for a real device. + + +``` python +from qiskit_ibm_runtime import QiskitRuntimeService, Estimator + +service = QiskitRuntimeService() +backend = service.backend("ibmq_qasm_simulator") + +estimator = Estimator(session=backend) + +expectation_value = estimator.run(state, op).result().values +``` + +Note that the Estimator returns a list of values, as it can perform batched evaluations. + +``` python +>>> print("expectation: ", expectation_value) +expectation: [-1.06329149] +``` + +The `Estimator` Runtime primitive offers a series of features and tuning +options that do not have a legacy alternative to migrate from, but can +help improve your performance and results. For more information, refer +to the following: + +- [Error mitigation + tutorial](https://learning.quantum-computing.ibm.com/tutorial/error-suppression-and-error-mitigation-with-qiskit-runtime) +- [Setting execution options + topic](../build/primitive-options) +- [Primitive execution options API + reference](../api/qiskit-ibm-runtime/qiskit_ibm_runtime.options.Options) +- [How to run a session + topic](../run/run-sessions) + +#### 3. Other execution alternatives (non-Runtime) + +This section describes how to use non-Runtime primitives to test an +algorithm using local simulation. Let's assume that we want to solve +the problem defined above with a local state vector simulation. + + +##### 3.a. Legacy: Using the Qiskit Aer simulator + +``` python +from qiskit.opflow import StateFn, PauliExpectation, CircuitSampler +from qiskit_aer import AerSimulator + +# Define the state to sample +measurable_expression = StateFn(opflow_op, is_measurement=True).compose(opflow_state) + +# Convert to expectation value calculation object +expectation = PauliExpectation().convert(measurable_expression) + +# Define statevector simulator +simulator = AerSimulator(method="statevector", shots=100) + +# Inject backend into circuit sampler +circuit_sampler = CircuitSampler(simulator).convert(expectation) + +# Evaluate +expectation_value = circuit_sampler.eval().real +``` + +``` python +>>> print("expectation: ", expectation_value) +expectation: -1.0636533500290943 +``` + +##### 3.b. Updated: Use the Reference Estimator or Aer Estimator primitive + +The reference `Estimator` lets you perform either an exact or a +shot-based noisy simulation based on the `Statevector` class in the +`qiskit.quantum_info` module. + +``` python +from qiskit.primitives import Estimator + +estimator = Estimator() + +expectation_value = estimator.run(state, op).result().values + +# for shot-based simulation: +expectation_value = estimator.run(state, op, shots=100).result().values +``` + +``` python +>>> print("expectation: ", expectation_value) +expectation: [-1.03134297] +``` + +You can still access the Aer Simulator through its dedicated +`Estimator`. This can be handy for performing simulations with noise +models. In this example, the simulation method has been updated to match +the result from [3.a](#3a). + +``` python +from qiskit_aer.primitives import Estimator # import change + +estimator = Estimator(run_options= {"method": "statevector"}) + +expectation_value = estimator.run(state, op, shots=100).result().values +``` + +``` python +>>> print("expectation: ", expectation_value) +expectation: [-1.06365335] +``` + +For more information on using the Aer primitives, see the [VQE tutorial](https://qiskit.org/documentation/tutorials/algorithms/03_vqe_simulation_with_noise.html). + +For more information about running noisy simulations with the **Runtime primitives**, see the [Noisy simulators in Qiskit Runtime](../test/noise) topic. + + +## Use Sampler to design an algorithm + +The Sampler primitive is used to design an algorithm that samples +circuits and extracts probability distributions. + +### Background + +The role of the `Sampler` primitive is two-fold: it acts as an **entry +point** to quantum devices or simulators, replacing `backend.run()`. +Additionally, it is an **algorithmic abstraction** to extract +probability distributions from measurement counts. + +Both `Sampler` and `backend.run()` take in circuits as inputs. The main +difference is the format of the output: `backend.run()` outputs +**counts**, while `Sampler` processes those counts and outputs the +**quasi-probability distribution** associated with them. + + + **Backend.run() model:** In this model, you used the `qiskit-ibmq-provider` (now migrated to `qiskit-ibm-provider`) module to access real backends and remote simulators. To run **local** simulations, you could import a specific backend from `qiskit-aer`. All of them followed the `backend.run()` interface. + +
+ Code example with `qiskit-ibmq-provider` and `backend.run()` + + ``` python + from qiskit import IBMQ + + # Select provider + provider = IBMQ.load_account() + + # Get backend + backend = provider.get_backend("ibmq_qasm_simulator") # Use the cloud simulator + + # Run + result = backend.run(circuits) + ``` +
+ +
+ Code example for `qiskit-aer` & `backend.run()` + + ``` python + from qiskit_aer import AerSimulator # former import: from qiskit import Aer + + # Get local simulator backend + backend = AerSimulator() + + # Run + result = backend.run(circuits) + ``` +
+ + **Primitives model:** Access real backends and remote simulators through the `qiskit-ibm-runtime` Sampler and Estimator *primitives*. To run **local** simulations, import specific local primitives from `qiskit_aer.primitives` and `qiskit.primitives`. All of them follow the `BaseSampler` and `BaseEstimator` interfaces, but **only the Runtime primitives offer access to the Runtime service, sessions, and built-in error mitigation**. + +
+ Code example for Runtime Sampler + + ``` python + from qiskit_ibm_runtime import QiskitRuntimeService, Sampler + + # Define service + service = QiskitRuntimeService() + + # Get backend + backend = service.backend("ibmq_qasm_simulator") # Use a cloud simulator + + # Define Sampler + # (see tutorials more more info on sessions) + sampler = Sampler(session=backend) + + # Run Quasi-Probability calculation + result = sampler.run(circuits).result() + ``` +
+ +
+ Code example for Aer Sampler + + ``` python + from qiskit_aer import Sampler + + # Get local simulator Sampler + sampler = Sampler() + + # Run Quasi-Probability calculation + result = sampler.run(circuits).result() + ``` +
+ +
+ + +Next, we will show an end-to-end example of sampling a circuit: first, +with `backend.run()`, then by using the `Sampler`. + +## End-to-end example + +### 1. Problem definition + +We want to find the probability (or quasi-probability) distribution +associated with a quantum state: + + + Important: If you want to use the `Sampler` primitive, the circuit **must contain measurements**. + + +``` python +from qiskit import QuantumCircuit + +circuit = QuantumCircuit(4) +circuit.h(range(2)) +circuit.cx(0,1) +circuit.measure_all() # measurement! +``` + +### 2. Calculate probability distribution on a real device or cloud simulator + +#### 2.a. Legacy: Use backend.run() + +The required steps to reach our goal with `backend.run()` are: + +1. Run circuits +2. Get counts from the result object +3. Use the counts and shots to calculate the probability distribution + +First, we run the circuit in a cloud simulator and output the result +object: + + + Replace `ibmq_qasm_simulator` with your device name to see the complete workflow for a real device. + + + +``` python +from qiskit import IBMQ + +# Define provider and backend +provider = IBMQ.load_account() +backend = provider.get_backend("ibmq_qasm_simulator") + +# Run +result = backend.run(circuit, shots=1024).result() +``` + +``` python +>>> print("result: ", result) +result: Result(backend_name='ibmq_qasm_simulator', backend_version='0.11.0', +qobj_id='65bb8a73-cced-40c1-995a-8961cc2badc4', job_id='63fc95612751d57b6639f777', +success=True, results=[ExperimentResult(shots=1024, success=True, meas_level=2, +data=ExperimentResultData(counts={'0x0': 255, '0x1': 258, '0x2': 243, '0x3': 268}), +header=QobjExperimentHeader(clbit_labels=[['meas', 0], ['meas', 1], ['meas', 2], ['meas', 3]], +creg_sizes=[['meas', 4]], global_phase=0.0, memory_slots=4, metadata={}, n_qubits=4, +name='circuit-930', qreg_sizes=[['q', 4]], qubit_labels=[['q', 0], ['q', 1], ['q', 2], ['q', 3]]), +status=DONE, metadata={'active_input_qubits': [0, 1, 2, 3], 'batched_shots_optimization': False, +'device': 'CPU', 'fusion': {'enabled': False}, 'input_qubit_map': [[3, 3], [2, 2], [1, 1], [0, 0]], +'measure_sampling': True, 'method': 'stabilizer', 'noise': 'ideal', 'num_clbits': 4, 'num_qubits': 4, +'parallel_shots': 1, 'parallel_state_update': 16, 'remapped_qubits': False, +'sample_measure_time': 0.001001096}, seed_simulator=2191402198, time_taken=0.002996865)], +date=2023-02-27 12:35:00.203255+01:00, status=COMPLETED, header=QobjHeader(backend_name='ibmq_qasm_simulator', +backend_version='0.1.547'), metadata={'max_gpu_memory_mb': 0, 'max_memory_mb': 386782, 'mpi_rank': 0, +'num_mpi_processes': 1, 'num_processes_per_experiments': 1, 'omp_enabled': True, 'parallel_experiments': 1, +'time_taken': 0.003215252, 'time_taken_execute': 0.00303248, 'time_taken_load_qobj': 0.000169435}, +time_taken=0.003215252, client_version={'qiskit': '0.39.5'}) +``` + +Now we get the probability distribution from the output: + +``` python +counts = result.get_counts(circuit) +quasi_dists = {} +for key,count in counts.items(): + quasi_dists[key] = count/1024 +``` + +``` python +>>> print("counts: ", counts) +>>> print("quasi_dists: ", quasi_dists) +counts: {'0000': 255, '0001': 258, '0010': 243, '0011': 268} +quasi_dists: {'0000': 0.2490234375, '0001': 0.251953125, '0010': 0.2373046875, '0011': 0.26171875} +``` + +#### 2.b. Updated: Use the Sampler runtime primitive + +While the user-side syntax of the `Sampler` is very similar to +`backend.run()`, notice that the workflow is now simplified, as the +quasi-probability distribution is returned **directly** (no need to +perform post-processing), together with some key metadata. + + + Replace `ibmq_qasm_simulator` with your device name to see the complete workflow for a real device. + + +``` python +from qiskit_ibm_runtime import QiskitRuntimeService, Sampler + +service = QiskitRuntimeService(channel="ibm_quantum") +backend = service.backend("ibmq_qasm_simulator") + +sampler = Sampler(session=backend) + +result = sampler.run(circuit, shots=1024).result() +quasi_dists = result.quasi_dists +``` + +``` python +>>> print("result: ", result) +>>> print("quasi_dists: ", quasi_dists) +result: SamplerResult(quasi_dists=[{0: 0.2802734375, 1: 0.2509765625, 2: 0.232421875, 3: 0.236328125}], +metadata=[{'header_metadata': {}, 'shots': 1024, 'readout_mitigation_overhead': 1.0, +'readout_mitigation_time': 0.03801989182829857}]) +quasi_dists: [{0: 0.2802734375, 1: 0.2509765625, 2: 0.232421875, 3: 0.236328125}] +``` + + + Be careful with the output format. With `Sampler`, the states are no longer represented by bit strings, for example, `"11"`, but by integers, for example, `3`. To convert the `Sampler` output to bit strings, you can use the `QuasiDistribution.binary_probabilities()` method, as shown below. + + + +``` python +>>> # convert the output to bit strings +>>> binary_quasi_dist = quasi_dists[0].binary_probabilities() +>>> print("binary_quasi_dist: ", binary_quasi_dist) +binary_quasi_dist: {'0000': 0.2802734375, '0001': 0.2509765625, '0010': 0.232421875, '0011': 0.236328125} +``` + +The `Sampler` Runtime primitive offers several features and tuning +options that do not have a legacy alternative to migrate from, but can +help improve your performance and results. For more information, refer +to the following: + +- [Error mitigation tutorial](https://learning.quantum-computing.ibm.com/tutorial/error-suppression-and-error-mitigation-with-qiskit-runtime) +- [Setting execution options topic](../build/primitive-options) +- [How to run a session topic](../run/run-sessions) + +### 3. Other execution alternatives (non-Runtime) + +The following migration paths use non-Runtime primitives to use local +simulation to test an algorithm. Let's assume that we want to use a +local state vector simulation to solve the problem defined above. + +#### 3.a. Legacy: Use the Qiskit Aer simulator + +``` python +from qiskit_aer import AerSimulator + +# Define the statevector simulator +simulator = AerSimulator(method="statevector") + +# Run and get counts +result = simulator.run(circuit, shots=1024).result() +``` + +``` python +>>> print("result: ", result) +result: Result(backend_name='aer_simulator_statevector', backend_version='0.11.2', +qobj_id='e51e51bc-96d8-4e10-aa4e-15ee6264f4a0', job_id='c603daa7-2c03-488c-8c75-8c6ea0381bbc', +success=True, results=[ExperimentResult(shots=1024, success=True, meas_level=2, +data=ExperimentResultData(counts={'0x2': 236, '0x0': 276, '0x3': 262, '0x1': 250}), +header=QobjExperimentHeader(clbit_labels=[['meas', 0], ['meas', 1], ['meas', 2], ['meas', 3]], +creg_sizes=[['meas', 4]], global_phase=0.0, memory_slots=4, metadata={}, n_qubits=4, name='circuit-930', +qreg_sizes=[['q', 4]], qubit_labels=[['q', 0], ['q', 1], ['q', 2], ['q', 3]]), status=DONE, +seed_simulator=3531074553, metadata={'parallel_state_update': 16, 'parallel_shots': 1, +'sample_measure_time': 0.000405246, 'noise': 'ideal', 'batched_shots_optimization': False, +'remapped_qubits': False, 'device': 'CPU', 'active_input_qubits': [0, 1, 2, 3], 'measure_sampling': True, +'num_clbits': 4, 'input_qubit_map': [[3, 3], [2, 2], [1, 1], [0, 0]], 'num_qubits': 4, 'method': 'statevector', +'fusion': {'applied': False, 'max_fused_qubits': 5, 'threshold': 14, 'enabled': True}}, time_taken=0.001981756)], +date=2023-02-27T12:38:18.580995, status=COMPLETED, header=QobjHeader(backend_name='aer_simulator_statevector', +backend_version='0.11.2'), metadata={'mpi_rank': 0, 'num_mpi_processes': 1, 'num_processes_per_experiments': 1, +'time_taken': 0.002216379, 'max_gpu_memory_mb': 0, 'time_taken_execute': 0.002005713, 'max_memory_mb': 65536, +'time_taken_load_qobj': 0.000200642, 'parallel_experiments': 1, 'omp_enabled': True}, +time_taken=0.0025920867919921875) +``` + +Now let's get the probability distribution from the output: + +``` python +counts = result.get_counts(circuit) +quasi_dists = {} +for key,count in counts.items(): + quasi_dists[key] = count/1024 +``` + +``` python +>>> print("counts: ", counts) +>>> print("quasi_dists: ", quasi_dists) +counts: {'0010': 236, '0000': 276, '0011': 262, '0001': 250} +quasi_dists: {'0010': 0.23046875, '0000': 0.26953125, '0011': 0.255859375, '0001': 0.244140625} +``` + +#### 3.b. Updated: Use the Reference Sampler or Aer Sampler primitive + +The reference `Sampler` lets you perform an exact or a shot-based noisy +simulation based on the `Statevector` class in the `qiskit.quantum_info` +module. + +``` python +from qiskit.primitives import Sampler + +sampler = Sampler() + +result = sampler.run(circuit).result() +quasi_dists = result.quasi_dists +``` + +``` python +>>> print("result: ", result) +>>> print("quasi_dists: ", quasi_dists) +result: SamplerResult(quasi_dists=[{0: 0.249999999999, 1: 0.249999999999, +2: 0.249999999999, 3: 0.249999999999}], metadata=[{}]) +quasi_dists: [{0: 0.249999999999, 1: 0.249999999999, 2: 0.249999999999, +3: 0.249999999999}] +``` + +If shots are specified, this primitive outputs a shot-based simulation +(no longer exact): + +``` python +from qiskit.primitives import Sampler + +sampler = Sampler() + +result = sampler.run(circuit, shots=1024).result() +quasi_dists = result.quasi_dists +``` + +``` python +>>> print("result: ", result) +>>> print("quasi_dists: ", quasi_dists) +result: SamplerResult(quasi_dists=[{0: 0.2490234375, 1: 0.2578125, +2: 0.2431640625, 3: 0.25}], metadata=[{'shots': 1024}]) +quasi_dists: [{0: 0.2490234375, 1: 0.2578125, 2: 0.2431640625, 3: 0.25}] +``` + +You can still access the Aer simulator through its dedicated `Sampler`. +This can be handy for performing simulations with noise models. In this +example, the simulation method has been updated to match the result from +3.a. + +``` python +from qiskit_aer.primitives import Sampler as AerSampler # import change! + +sampler = AerSampler(run_options= {"method": "statevector"}) + +result = sampler.run(circuit, shots=1024).result() +quasi_dists = result.quasi_dists +``` + +``` python +>>> print("result: ", result) +>>> print("quasi_dists: ", quasi_dists) +result: SamplerResult(quasi_dists=[{1: 0.2802734375, 2: 0.2412109375, 0: 0.2392578125, +3: 0.2392578125}], metadata=[{'shots': 1024, 'simulator_metadata': +{'parallel_state_update': 16, 'parallel_shots': 1, 'sample_measure_time': 0.000409608, +'noise': 'ideal', 'batched_shots_optimization': False, 'remapped_qubits': False, +'device': 'CPU', 'active_input_qubits': [0, 1, 2, 3], 'measure_sampling': True, +'num_clbits': 4, 'input_qubit_map': [[3, 3], [2, 2], [1, 1], [0, 0]], 'num_qubits': 4, +'method': 'statevector', 'fusion': {'applied': False, 'max_fused_qubits': 5, +'threshold': 14, 'enabled': True}}}]) +quasi_dists: [{1: 0.2802734375, 2: 0.2412109375, 0: 0.2392578125, 3: 0.2392578125}] +``` + +``` python +>>> # Convert the output to bit strings +>>> binary_quasi_dist = quasi_dists[0].binary_probabilities() +>>> print("binary_quasi_dist: ", binary_quasi_dist) +binary_quasi_dist: {'0001': 0.2802734375, '0010': 0.2412109375, '0000': 0.2392578125, '0011': 0.2392578125} +``` + +For more information, see [Noisy simulators in Qiskit Runtime](../test/noise). diff --git a/docs/start/migrate.mdx b/docs/start/migrate.mdx new file mode 100644 index 0000000000..6a32dda24e --- /dev/null +++ b/docs/start/migrate.mdx @@ -0,0 +1,468 @@ +--- +title: Migrate to using Qiskit Runtime primitives +description: Migrate from using backend.run to using Qiskit Runtime primitives + + +in_page_toc_max_heading_level: 2 +--- + + +# Migrate to using Qiskit Runtime primitives + +This guide describes key patterns of behavior and use cases with code +examples to help you migrate code from the legacy `qiskit-ibmq-provider` +package to use the Qiskit Runtime primitives. + +Primitives are the recommended tool to write quantum algorithms, as they +encapsulate common device queries seen in application packages and allow +for managed performance through the Qiskit Runtime service. However, if +your algorithm requires more granular information, such as pre-shot +measurements, the primitives might not provide the desired abstraction +level. + +The Qiskit Runtime primitives implement the reference `Sampler` and +`Estimator` interfaces found in +[qiskit.primitives](https://qiskit.org/documentation/apidoc/primitives.html). +These interfaces let you switch between primitive implementations with +minimal code changes. Different primitive implementations can be found +in the `qiskit`, `qiskit_aer`, and `qiskit_ibm_runtime` libraries. Each +implementation serves a specific purpose: + +- The primitives in `qiskit` can perform local state vector + simulations - useful for quickly prototyping algorithms. +- The primitives in `qiskit_aer` give access to the local Aer + simulators for tasks such as noisy simulation. +- The primitives in `qiskit_ibm_runtime` provide access to cloud + simulators and real hardware through the Qiskit Runtime service. + They include exclusive features such as built-in circuit + optimization and error mitigation support. + + + The **only primitives that provide access to the Qiskit Runtime service** are those imported from `qiskit_ibm_runtime` (Qiskit Runtime Primitives). + + +When migrating, the key to writing an equivalent algorithm using +primitives is to first identify what is the minimal unit of information +your algorithm is based on: + +- If it uses an **expectation value**, you will need an `Estimator`. +- If it uses a **probability distribution** (from sampling the device), you will need a `Sampler`. + +After determining which primitive to use, identify where the algorithm +accesses the backend. Look for the call to `backend.run()`. Next, you +will replace this call with the respective primitive call, as shown in +the following examples. + +This guide is for algorithm developers who need to refactor algorithms to use primitives instead of `backend.run()`. See examples here: + + - [Update code that performs circuit sampling](migrate-examples#sampler-algorithm) + - [Update code that calculates expectation values](migrate-examples#estimator-algorithm) + +The following topics are use cases with code migration examples: + +- [Update parameter values while running](#parm-circ) +- [Algorithm tuning options (shots, transpilation, error mitigation)](../optimize#tuning-opt) + +## FAQs + +Users might have the following questions when planning to migrate their +code to Qiskit Runtime: + +
+How do the Qiskit Runtime primitives differ from backend.run? + +There are two methods for accessing IBM Quantum systems. First, the qiskit-ibm-provider package provides the backend.run() interface, allowing direct access to IBM Quantum systems with no pre- or post-processing involved. This level of access is suitable for those users who want precise control over circuit execution and result processing. This level of access is needed for those looking to work at the level Kernel developer developing, for example, circuit optimization routines, error mitigation techniques, or characterizing quantum systems. + +In contrast, Qiskit Runtime is designed to streamline algorithm and application construction by removing the need for users to understand technical hardware and low-level software details. Advanced processing techniques for error suppression and mitigation are automatically applied, giving users high-fidelity results without the burden of having to code these routines themselves. The inclusion of sessions within Qiskit Runtime allows users to run iterative algorithm circuits back to back, or batch collections of circuits without having to re-queue each job. This results in more efficient quantum processor utilization and reduces the total amount of time users spend running complex computations. + +
+ +
+Which channel should I use? + +After deciding to use Qiskit Runtime primitives, the user must determine +whether to access Qiskit Runtime through IBM Cloud or IBM Quantum +Platform. Some information that might help you decide includes: + +- The available plans: + - Qiskit Runtime is available in both the Open (free access) or Premium (contract-based paid access) plan on IBM Quantum Platform. See [IBM Quantum access plans](https://www.ibm.com/quantum/access-plans) for details. + - Qiskit Runtime is accessible through the Lite (free access) or Standard (pay-as-you-go access) plan in IBM Cloud. See [Qiskit Runtime plans](https://cloud.ibm.com/docs/quantum-computing?topic=quantum-computing-plans) on IBM Cloud for details. +- The use case requirements: + - IBM Quantum Platform offers a visual circuit composer (Quantum Composer) and a Jupyter Notebook environment (Quantum Lab). + - IBM Cloud offers a cloud native service that is ideal if users need to integrate quantum capabilities with other cloud services. + +
+ +
+How do I set up my channel? + +After deciding which channel to use to interact with Qiskit Runtime, you +can get set up on either platform by following the steps in [Install and set up.](../start/install) + +
+ +
+Should I modify the Qiskit Terra algorithms? + +As of v0.22, [Qiskit Terra algorithms](https://github.com/Qiskit/qiskit-terra/tree/main/qiskit/algorithms) use Qiskit Runtime primitives. Thus, there is no need for users to +modify amplitude estimators or any other Qiskit Terra algorithms. + +
+ +
+Which primitive should I use? + +When choosing which primitive to use, you first need to understand +whether the algorithm uses a **quasi-probability distribution** sampled +from a quantum state (a list of quasi-probabilities), or an +**expectation value** of a certain observable with respect to a +quantum state (a real number). + +A probability distribution is often of interest in optimization problems +that return a classical bit string, encoding a certain solution to a +problem at hand. In these cases, you might be interested in finding a +bit string that corresponds to a ket value with the largest probability +of being measured from a quantum state, for example. + +An expectation value of an observable could be the target quantity in +scenarios where knowing a quantum state is not relevant. This often +occurs in optimization problems or chemistry applications. For example, +when trying to discover the extremal energy of a system. + +
+ +## Migrate setup from qiskit-ibmq-provider + +This guide describes how to migrate code from the legacy IBMQ provider +`qiskit-ibmq-provider` package to use Qiskit Runtime +`qiskit-ibm-runtime`. This guide includes instructions to +migrate legacy runtime programs to the new syntax. However, the ability +to use custom uploaded programs is pending deprecation, so these should +be migrated to use primitives instead. + +### Changes in Class name and location + +The classes related to Qiskit Runtime that used to be included in +`qiskit-ibmq-provider` are now part of `qiskit-ibm-runtime`. Before, the +provider used to populate the `qiskit.providers.ibmq.runtime` namespace +with objects for Qiskit Runtime. These now live in the +`qiskit_ibm_runtime` module. + +The module from which the classes are imported has changed. The +following table contains example access patterns in +`qiskit.providers.ibmq.runtime` and their new form in +`qiskit_ibm_runtime`: + +| class in qiskit-ibmq-provider | class in qiskit-ibm-runtime | Notes | +|--------------------------------------------------|-------------------------------------------|----------------------------------------------------------------------------------------------------------------------| +| qiskit.providers.ibmq.runtime.IBMRuntimeService | qiskit_ibm_runtime.QiskitRuntimeService` | IBMRuntimeService class was removed from qiskit-ibm-runtime 0.6 and replaced by the new class in qiskit-ibm-runtime. | +| qiskit.providers.ibmq.runtime.RuntimeJob | qiskit_ibm_runtime.RuntimeJob | +| qiskit.providers.ibmq.runtime.RuntimeProgram | qiskit_ibm_runtime.RuntimeProgram | +| qiskit.providers.ibmq.runtime.UserMessenger | qiskit_ibm_runtime.program.UserMessenger | New location: qiskit_ibm_runtime.program | +| qiskit.providers.ibmq.runtime.ProgramBackend | qiskit_ibm_runtime.program.ProgramBackend | New location: qiskit_ibm_runtime.program | +| qiskit.providers.ibmq.runtime.ResultDecoder | qiskit_ibm_runtime.program.ResultDecoder | New location: qiskit_ibm_runtime.program | +| qiskit.providers.ibmq.runtime.RuntimeEncoder | qiskit_ibm_runtime.RuntimeEncoder | +| qiskit.providers.ibmq.runtime.RuntimeDecoder | qiskit_ibm_runtime.RuntimeDecoder | +| qiskit.providers.ibmq.runtime.ParameterNamespace | qiskit_ibm_runtime.ParameterNamespace | +| qiskit.providers.ibmq.runtime.RuntimeOptions | qiskit_ibm_runtime.RuntimeOptions | + + +### Import path + +The import path has changed as follows: + +**Legacy** + +``` python +from qiskit import IBMQ +``` + +**Updated** + +``` python +from qiskit_ibm_runtime import QiskitRuntimeService +``` + +### Save and load accounts + +Use the updated code to work with accounts. + +**Legacy: Save accounts** + +``` python +IBMQ.save_account("", overwrite=True) +``` + +**Updated: Save accounts** The new syntax accepts credentials for +Qiskit Runtime on IBM Cloud or IBM Quantum Platform. For more +information on retrieving account credentials, see [Install and set up](../start/install). + +``` python +# IBM Cloud channel + +QiskitRuntimeService.save_account(channel="ibm_cloud", token="", instance="", overwrite=True) + +# IBM Quantum channel; set to default + +QiskitRuntimeService.save_account(channel="ibm_quantum", token="", overwrite=True, default=true) +``` + +**Updated: Name saved credentials** You can now name your saved +credentials and load the credentials by name. + +**Example:** + +``` python +# Save different accounts for open and premium access + +QiskitRuntimeService.save_account(channel="ibm_quantum", token="", instance="h1/g1/p1", name="premium") +QiskitRuntimeService.save_account(channel="ibm_quantum", token="", instance="h2/g2/p2", name="open") + +# Load the "open" credentials + +service = QiskitRuntimeService(name="open") +``` + +**Legacy: Load accounts** + +``` python +IBMQ.load_account() +``` + +**Updated: Load accounts** + +The new syntax combines the functionality from `load_account()` and +`get_provider()` in one statement. The `channel` input parameter is +optional. If multiple accounts have been saved in one device and no +`channel` is provided, the default is `"ibm_cloud"`. + +``` python +# To access saved credentials for the IBM cloud channel +service = QiskitRuntimeService(channel="ibm_cloud") + +# To access saved credentials for the IBM quantum channel +service = QiskitRuntimeService(channel="ibm_quantum") +``` + +### Channel selection (get a provider) + +Use the updated code to select a channel. + +**Legacy** + +``` python +provider = IBMQ.get_provider(project="my_project", group="my_group", hub="my_hub") +``` + +**Updated** + +The new syntax combines the functionality from `load_account()` and +`get_provider()` in one statement. When using the `ibm_quantum` channel, +the `hub`, `group`, and `project` are specified through the new +`instance` keyword. + +``` python +# To access saved credentials for the IBM quantum channel and select an instance +service = QiskitRuntimeService(channel="ibm_quantum", instance="my_hub/my_group/my_project") +``` + +### Get the backend + +Use the updated code to view backends. + +**Legacy** + +``` python +provider = IBMQ.get_provider(hub="h1", group="g1", project="p1") +backend = provider.get_backend("ibm_backend") +``` + +**Updated** + +``` python +# You can specify the instance in service.backend() instead of initializing a new service +backend = service.backend("ibm_backend", instance="h1/g1/p1") +``` + +### Upload, view, or delete custom prototype programs + +To work with custom programs, replace `provider.runtime` with `service`. + + + This function is pending deprecation. + + +**Legacy** + +``` python +# Printing existing programs +provider.runtime.pprint_programs() + +# Deleting custom program +provider.runtime.delete_program("my_program") # Substitute "my_program" with your program ID + +# Uploading custom program +program_id = provider.runtime.upload_program( + data=program_data, + metadata=program_json + ) +``` + +**Updated** + +``` python +# Printing existing programs +service.pprint_programs() + +# Deleting custom program +service.delete_program("my_program") # Substitute "my_program" with your program ID + +# Uploading custom program +program_id = service.upload_program( + data=program_data, + metadata=program_json + ) +``` + +### Run prototype programs + +To run prototype programs, replace `provider.runtime` with `service`. + + + This function is pending deprecation. + + +**Legacy** + +``` python +program_inputs = {"iterations": 3} +options = {"backend_name": backend.name()} +job = provider.runtime.run(program_id="hello-world", + options=options, + inputs=program_inputs + ) +print(f"job id: {job.job_id()}") +result = job.result() +print(result) +``` + +**Updated** + +``` python +program_inputs = {"iterations": 3} +options = {"backend": ""} +job = service.run(program_id="hello-world", + options=options, + inputs=program_inputs + ) +print(f"job id: {job.job_id()}") +result = job.result() +print(result) +``` + + +## Parametrized circuits with primitives + +Parametrized circuits are a commonly used tool for quantum algorithm +design. Because `backend.run()` did not accept parametrized +circuits, the parameter binding step had to be integrated in the +algorithm workflow. The primitives can perform the parameter binding +step internally, which results in a simplification of the algorithm-side +logic. + +The following example summarizes the new workflow for managing +parametrized circuits. + +### Example + +Let's define a parametrized circuit: + +``` python +from qiskit.circuit import QuantumCircuit, ParameterVector + +n = 3 +thetas = ParameterVector('θ',n) + +qc = QuantumCircuit(n, 1) +qc.h(0) + +for i in range(n-1): + qc.cx(i, i+1) + +for i,t in enumerate(thetas): + qc.rz(t, i) + +for i in reversed(range(n-1)): + qc.cx(i, i+1) + +qc.h(0) +qc.measure(0, 0) + +qc.draw() +``` + +We want to assign the following parameter values to the circuit: + +``` python +import numpy as np +theta_values = [np.pi/2, np.pi/2, np.pi/2] +``` + +### Legacy + +Previously, the parameter values had to be bound to their respective +circuit parameters prior to calling `backend.run()`. + +``` python +from qiskit import Aer + +bound_circuit = qc.bind_parameters(theta_values) +bound_circuit.draw() + +backend = Aer.get_backend('aer_simulator') +job = backend.run(bound_circuit) +counts = job.result().get_counts() +print(counts) +``` + +### Primitives + +Now, the primitives take in parametrized circuits directly, together +with the parameter values, and the parameter assignment operation can be +performed more efficiently on the server side of the primitive. + +This feature is particularly interesting when working with iterative +algorithms because the parametrized circuit remains unchanged between +calls while the parameter values change. The primitives can transpile +once and then cache the unbound circuit, using classical resources more +efficiently. Moreover, only the updated parameters are transferred to +the cloud, saving additional bandwidth. + +``` python +from qiskit.primitives import Sampler + +sampler = Sampler() +job = sampler.run(qc, theta_values) +result = job.result().quasi_dists +print(result) +``` + +## Algorithm tuning + +One of the advantages of the primitives is that they abstract away the +circuit execution setup so that algorithm developers can focus on the +pure algorithmic components. However, sometimes, to get the most out of +an algorithm, you might want to tune certain primitive options. For details, see the [Algorithm tuning options](../optimize#tuning-opt). + +## Next steps + + + - Review some [migration examples](migrate-examples). + - [Get started with Estimator.](../build/primitives-get-started#start-estimator) + - [Get started with Sampler.](../build/primitives-get-started#start-sampler) + - Explore [sessions.](../run/sessions) + - [Run a primitive in a session.](../run/run-sessions) + - Experiment with the [migration tutorial.](https://qiskit.org/documentation/partners/qiskit_ibm_provider/tutorials/Migration_Guide_from_qiskit-ibmq-provider.html) + - Experiment with the [Run custom transpiled circuits with primitives tutorial.](https://learning.quantum-computing.ibm.com/tutorial/submitting-user-transpiled-circuits-using-primitives) + + \ No newline at end of file From c6b99f0bcaac26fc699a251321b86c8a3a975064 Mon Sep 17 00:00:00 2001 From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com> Date: Wed, 4 Oct 2023 12:33:32 -0400 Subject: [PATCH 7/9] Migrate Dynamic Circuits content from closed source Co-authored-by: Soolu Thomas Co-authored-by: Thomas Alexander Co-authored-by: Jake Lishman Co-authored-by: Marius Hillenbrand Co-authored-by: Michael Healy Co-authored-by: Reza Jokar Co-authored-by: Rebecca Dimock <66339736+beckykd@users.noreply.github.com> Co-authored-by: Abby Cross --- ...namic-circuits-basics-with-openqasm3.ipynb | 1097 +++++++++++++++++ .../dynamic-circuits-basics-with-qiskit.ipynb | 1021 +++++++++++++++ ...etting-started-with-dynamic-circuits.ipynb | 972 +++++++++++++++ docs/build/midcircuit_measurement.ipynb | 1056 ++++++++++++++++ 4 files changed, 4146 insertions(+) create mode 100644 docs/build/dynamic-circuits-basics-with-openqasm3.ipynb create mode 100644 docs/build/dynamic-circuits-basics-with-qiskit.ipynb create mode 100644 docs/build/getting-started-with-dynamic-circuits.ipynb create mode 100644 docs/build/midcircuit_measurement.ipynb diff --git a/docs/build/dynamic-circuits-basics-with-openqasm3.ipynb b/docs/build/dynamic-circuits-basics-with-openqasm3.ipynb new file mode 100644 index 0000000000..c0afcbaffd --- /dev/null +++ b/docs/build/dynamic-circuits-basics-with-openqasm3.ipynb @@ -0,0 +1,1097 @@ +{ + "cells": [ + { + "attachments": {}, + "cell_type": "markdown", + "id": "92133504", + "metadata": {}, + "source": [ + "# Dynamic circuits basics with OpenQASM 3" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "b48e55f7", + "metadata": {}, + "source": [ + "[OpenQASM 3](https://openqasm.com/intro.html) is an imperative programming language designed for near-term quantum computing algorithms and applications. Quantum programs are described using the measurement-based quantum circuit model, with support for classical feed-forward flow control based on measurement outcomes.\n", + "\n", + "In other words, it is an assembly language to represent quantum instructions. A file with the `.qasm` extension can be written as a source string to run programs.\n", + "\n", + "An OpenQASM 3 file consists of a header and the needed code.\n", + "\n", + "```\n", + "OPENQASM 3.0;\n", + "\n", + "// Some code\n", + "```" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "108ca28a", + "metadata": {}, + "source": [ + "## Know before you begin" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "0b49ebe6", + "metadata": {}, + "source": [ + "Add imports and load backend information that will be used in this section:" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "id": "e838cd71", + "metadata": {}, + "outputs": [], + "source": [ + "# Do the necessary imports\n", + "from qiskit_ibm_provider import IBMProvider\n", + "from qiskit.tools.monitor import job_monitor\n", + "from qiskit.visualization import plot_histogram\n", + "\n", + "# Ignoring warnings\n", + "import sys\n", + "import warnings\n", + "\n", + "if not sys.warnoptions:\n", + " warnings.simplefilter(\"ignore\")" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "id": "785da5fa", + "metadata": {}, + "outputs": [], + "source": [ + "# Note: This can be any hub/group/project that has access to the required device and Qiskit Runtime.\n", + "hub = \"\"\n", + "group = \"\"\n", + "project = \"\"\n", + "backend_name = \"\"\n", + "hgp = f\"{hub}/{group}/{project}\"" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "id": "6c8278b4", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Using backend ibm_wellington\n" + ] + } + ], + "source": [ + "# load provider and backend\n", + "provider = IBMProvider()\n", + "backend = provider.get_backend(backend_name, instance=hgp)\n", + "print(f\"Using backend {backend.name}\")" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "id": "fcfcc723", + "metadata": {}, + "outputs": [], + "source": [ + "# helper function to submit our program string to the backend's qasm3-runner runtime program\n", + "def run_qasm3_program(program_str, runtime_backend=backend):\n", + " shots = 1000\n", + " job = backend.run(program_str, shots=shots, dynamic=True)\n", + " print(f\"Runtime job id: {job.job_id()}\")\n", + " job_monitor(job)\n", + " return job" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "1b26690b", + "metadata": {}, + "source": [ + "We can dump circuits from Qiskit to OpenQASM 3. The exporter has several configuration settings; however, the ones below are typically valid for IBM Quantum backends.\n", + "\n", + "When debugging your program, it is very useful to be able to dump a circuit to a QASM source string." + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "id": "5334dbec", + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "execution_count": 5, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "from qiskit import qasm3, QuantumCircuit, transpile\n", + "\n", + "# Creating a bell circuit\n", + "qc_bell = QuantumCircuit(2, 2)\n", + "qc_bell.h(0)\n", + "qc_bell.cx(0, 1)\n", + "qc_bell.measure(0, 0)\n", + "qc_bell.measure(0, 1)\n", + "\n", + "qc_bell = transpile(qc_bell, backend)\n", + "qc_bell.draw(output=\"mpl\", idle_wires=False)" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "id": "74e1444b", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "OPENQASM 3;\n", + "bit[2] c;\n", + "rz(1.5707963267949) $0;\n", + "sx $0;\n", + "rz(1.5707963267949) $0;\n", + "cx $0, $1;\n", + "c[0] = measure $0;\n", + "c[1] = measure $0;\n", + "\n" + ] + } + ], + "source": [ + "exporter = qasm3.Exporter(\n", + " includes=[], disable_constants=True, basis_gates=backend.configuration().basis_gates\n", + ")\n", + "\n", + "print(qasm3_bell := exporter.dumps(qc_bell))" + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "id": "cbd11624", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: ceqq6cv5otekiij6rdjg\n", + "Job Status: job has successfully run\n" + ] + } + ], + "source": [ + "qasm3_bell_job = run_qasm3_program(qasm3_bell)" + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "id": "e19d6053", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Preparation results: {'0': 479, '1': 7, '11': 514}\n" + ] + } + ], + "source": [ + "qasm3_bell_result = qasm3_bell_job.result()\n", + "print(f\"Preparation results: {qasm3_bell_result.get_counts(0)}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "00c94ab1", + "metadata": {}, + "source": [ + "QASM 3 programs may be submitted as strings to the backend using Qiskit Runtime's ``qasm3-runner`` program." + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "id": "b20173af", + "metadata": {}, + "outputs": [], + "source": [ + "my_first_qasm3_program = \"\"\"\n", + "OPENQASM 3.0;\n", + "\n", + "qubit $0;\n", + "bit a0;\n", + "\n", + "x $0;\n", + "a0 = measure $0;\n", + "\n", + "\"\"\"" + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "id": "d475c8ce", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: ceqq6f3hsot3802d2210\n", + "Job Status: job has successfully run\n" + ] + } + ], + "source": [ + "job = run_qasm3_program(my_first_qasm3_program)" + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "id": "4b3aa491", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Preparation results: {'0': 25, '1': 975}\n" + ] + } + ], + "source": [ + "result = job.result()\n", + "print(f\"Preparation results: {result.get_counts(0)}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "90f3fc18", + "metadata": {}, + "source": [ + "## OpenQASM 3 in-depth\n", + "\n", + "Let's understand the language statements supported by OpenQASM 3 and execute them on the hardware if supported. To see what features of OpenQASM 3 are currently supported in hardware, please see the [feature table](./feature-table)." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "8ac74bb1", + "metadata": {}, + "source": [ + "### Variables\n", + "\n", + "Let's learn more about the variable support in OpenQASM 3. Variables are used to assign values within a program. Variables representing any classical type can be initialized on declaration.\n", + "\n", + "To declare a qubit:\n", + "\n", + "```\n", + "qubit $0;\n", + "qubit $1;\n", + "```\n", + "\n", + "Other declaration of classical variables:\n", + "\n", + "```\n", + "int[32] a;\n", + "bit[3] c = \"001\";\n", + "bool my_bool = false;\n", + "```\n", + "\n", + "for an integer variable `a`, a register of three bits width `c`, and a Boolean variable `my_bool`." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "7eeb6ba5", + "metadata": {}, + "source": [ + "### Control flow\n", + "\n", + "OpenQASM 3 also supports looping and branching.\n", + "\n", + "#### If-else statements\n", + "\n", + "The statement `if (bool) ` branches the program if the Boolean evaluates to true, and may optionally be followed by `else `. Both `true-body` and `false-body` can be a single statement terminated by a semicolon, or a program block of several statements `{ stmt1; stmt2; }`.\n", + "\n", + "```\n", + "bool target = false;\n", + "qubit $0;\n", + "h $0;\n", + "bit output = measure $0;\n", + "\n", + "// example of branching\n", + "if (target == output) {\n", + " // do something\n", + "} else {\n", + " // do something else\n", + "}\n", + "```" + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "id": "437b9f02", + "metadata": {}, + "outputs": [], + "source": [ + "if_example = \"\"\"\n", + "OPENQASM 3.0;\n", + "\n", + "bit target = 1;\n", + "qubit $0;\n", + "x $0;\n", + "bit check = measure $0;\n", + "if (check) {\n", + " x $0;\n", + "}\n", + "\n", + "bit[1] result;\n", + "result[0] = measure $0;\n", + "\n", + "\"\"\"" + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "id": "4ef58667", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: ceqq6jne2dgblp3mf2c0\n", + "Job Status: job has successfully run\n", + "Measurement results: {'0': 10, '10': 978, '100': 1, '110': 11}\n" + ] + } + ], + "source": [ + "job = run_qasm3_program(if_example)\n", + "counts = job.result().get_counts()\n", + "print(f\"Measurement results: {counts}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "0071e936", + "metadata": {}, + "source": [ + "#### For loops\n", + "\n", + "The statement `for   in  ` loops over the items in values, assigning each value to the variable name in subsequent iterations of the loop `body.values`.\n", + "\n", + "The value can be a range expression in square brackets of the form `[start : (step :)? stop]`. Note that the range is inclusive, so `stop` is the last value iterated over.\n", + "\n", + "```\n", + "int a = 1;\n", + "\n", + "// here step=1\n", + "for i in [0 : 4] {\n", + " a = i;\n", + "}\n", + "\n", + "// here step=2\n", + "for i in [0 : 2 : 4] {\n", + " a = i\n", + "}\n", + "```" + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "id": "044e07f1", + "metadata": {}, + "outputs": [], + "source": [ + "for_loop = \"\"\"\n", + "OPENQASM 3.0;\n", + "\n", + "qubit $0;\n", + "for i in [0 : 4] {\n", + " U(1.57079632679, 0.0, 3.14159265359) $0;\n", + "}\n", + "\n", + "bit[1] result;\n", + "result[0] = measure $0;\n", + "\n", + "\"\"\"\n", + "\n", + "# U(1.57079632679, 0.0, 3.14159265359) applies a Hadamard gate" + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "id": "a50411c7", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: ceqq6lve2dgblp3mf2f0\n", + "Job Status: job has successfully run\n", + "Measurement results: {'0': 519, '1': 481}\n" + ] + } + ], + "source": [ + "job = run_qasm3_program(for_loop)\n", + "counts = job.result().get_counts()\n", + "print(f\"Measurement results: {counts}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "f523fdfb", + "metadata": {}, + "source": [ + "### Classical compute" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "d681c482", + "metadata": {}, + "source": [ + "OpenQASM 3 supports classical computation on individual bits. These bits may be assigned by the program, or as a result of qubit measurement.\n", + "\n", + "Individual bits are declared with the `bit` keyword, or registers of multiple bits may be declared using `bit[size]` where `size` indicates the number of bits in the register. For example,\n", + "\n", + "```\n", + "bit a;\n", + "bit b;\n", + "bit c;\n", + "```\n", + "\n", + "declares three individual bits with variable names `a`, `b`, and `c`, while\n", + "\n", + "```\n", + "bit[3] result;\n", + "```\n", + "\n", + "declares a three-bit register with the name `result;`." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "e8c51b04", + "metadata": {}, + "source": [ + "Bits and bit registers may be assigned by the program\n", + "```\n", + "bit a = 0;\n", + "a = 1;\n", + "\n", + "bit[3] result = \"101\";\n", + "result = \"010\";\n", + "```\n", + "\n", + "or they may store individual qubit measurement results." + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "id": "90a56c31", + "metadata": {}, + "outputs": [], + "source": [ + "measure_register_bits = \"\"\"\\\n", + "OPENQASM 3.0;\n", + "qubit $0;\n", + "qubit $1;\n", + "qubit $2;\n", + "bit a;\n", + "a = measure $0;\n", + "\n", + "bit[3] result;\n", + "result[0] = measure $0;\n", + "result[1] = measure $1;\n", + "result[2] = measure $2;\n", + "\"\"\"" + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "id": "22ba93d0", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: ceqq6nrhsot3802d22bg\n", + "Job Status: job has successfully run\n", + "Measurement results: {'0': 967, '1': 1, '10': 1, '11': 12, '100': 8, '1000': 11}\n" + ] + } + ], + "source": [ + "job = run_qasm3_program(measure_register_bits)\n", + "counts = job.result().get_counts()\n", + "print(f\"Measurement results: {counts}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "fcff8bea", + "metadata": {}, + "source": [ + "The current dynamic circuits implementation does not support quantum registers; therefore, storing the result of the measurement of a quantum register \n", + "```\n", + "qubit[3] qubits;\n", + "bits[3] result;\n", + "result = measure qubits;\n", + "```\n", + "is not yet supported." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "9eb86acd", + "metadata": {}, + "source": [ + "Classical computation may be applied to bits and bit registers. The current implementation supports computing bitwise operators applied to bits or bit registers. These include:\n", + "\n", + "\n", + "```\n", + "bit a;\n", + "bit b;\n", + "bit c;\n", + "```\n", + "\n", + "Or:\n", + "```\n", + "c = a | b;\n", + "```\n", + "And:\n", + "```\n", + "c = a & b;\n", + "```\n", + "Xor:\n", + "```\n", + "c = a ^ b;\n", + "```" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "0671f7a9", + "metadata": {}, + "source": [ + "These may be included as part of ``if`` statements, and grouped using parentheses:" + ] + }, + { + "cell_type": "code", + "execution_count": 18, + "id": "aff99d8b", + "metadata": {}, + "outputs": [], + "source": [ + "grouped_bitwise = \"\"\"\\\n", + "OPENQASM 3.0;\n", + "\n", + "qubit $0;\n", + "\n", + "bit a = 0;\n", + "bit b = 1;\n", + "bit c;\n", + "\n", + "if ((a | b)) {\n", + " c = 0;\n", + "}\n", + "\n", + "if ((a | b) ^ c) {\n", + " c = 1;\n", + "}\n", + "\n", + "bit d;\n", + "x $0;\n", + "d = measure $0;\n", + "\n", + "\"\"\"" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "id": "aad90bee", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: ceqq6prhsot3802d22eg\n", + "Job Status: job has successfully run\n", + "Measurement results: {'0': 30, '1000': 970}\n" + ] + } + ], + "source": [ + "job = run_qasm3_program(grouped_bitwise)\n", + "counts = job.result().get_counts()\n", + "print(f\"Measurement results: {counts}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "19402871", + "metadata": {}, + "source": [ + "Taking the logical ``not`` of a bit is currently supported with the form:" + ] + }, + { + "cell_type": "code", + "execution_count": 20, + "id": "455a6c59", + "metadata": {}, + "outputs": [], + "source": [ + "logical_not = \"\"\"\\\n", + "OPENQASM 3.0;\n", + "\n", + "qubit $0;\n", + "\n", + "bit a;\n", + "bit b;\n", + "bit c;\n", + "\n", + "a = !a;\n", + "\n", + "if (a | b) {\n", + " c = 1;\n", + "}\n", + "\n", + "bit d;\n", + "x $0;\n", + "d = measure $0;\n", + "\n", + "\"\"\"" + ] + }, + { + "cell_type": "code", + "execution_count": 21, + "id": "d52f112d", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: ceqq6s76fpt7053qr8sg\n", + "Job Status: job has successfully run\n", + "Measurement results: {'0': 21, '1000': 979}\n" + ] + } + ], + "source": [ + "job = run_qasm3_program(logical_not)\n", + "counts = job.result().get_counts()\n", + "print(f\"Measurement results: {counts}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "28ed561a", + "metadata": {}, + "source": [ + "At present time, taking the bit negation `~` is not supported." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "e74ab9fc", + "metadata": {}, + "source": [ + "Bit registers support conditions on individual bits:" + ] + }, + { + "cell_type": "code", + "execution_count": 22, + "id": "9444947c", + "metadata": {}, + "outputs": [], + "source": [ + "bit_comparison = \"\"\"\\\n", + "OPENQASM 3.0;\n", + "\n", + "qubit $0;\n", + "\n", + "bit[3] result;\n", + "bit c;\n", + "\n", + "if (result[0]) {\n", + " c = 0;\n", + "}\n", + "\n", + "bit d;\n", + "x $0;\n", + "d = measure $0;\n", + "\"\"\"" + ] + }, + { + "cell_type": "code", + "execution_count": 23, + "id": "3c09670e", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: ceqq6u3hsot3802d22kg\n", + "Job Status: job has successfully run\n", + "Measurement results: {'0': 35, '10000': 965}\n" + ] + } + ], + "source": [ + "job = run_qasm3_program(bit_comparison)\n", + "counts = job.result().get_counts()\n", + "print(f\"Measurement results: {counts}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "cead25f4", + "metadata": {}, + "source": [ + "bitwise Boolean expressions:" + ] + }, + { + "cell_type": "code", + "execution_count": 24, + "id": "19593d6a", + "metadata": {}, + "outputs": [], + "source": [ + "bitwise_boolean = \"\"\"\\\n", + "OPENQASM 3.0;\n", + "\n", + "qubit $0;\n", + "\n", + "bit[3] result1;\n", + "bit[3] result2;\n", + "bit c;\n", + "\n", + "if ((result1 | result2)) {\n", + " c = 0;\n", + "}\n", + "\n", + "if ((result1 & result2)) {\n", + " c = 1;\n", + "}\n", + "\n", + "bit d;\n", + "x $0;\n", + "d = measure $0;\n", + "\"\"\"" + ] + }, + { + "cell_type": "code", + "execution_count": 25, + "id": "1653bb20", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: ceqq71oc7aa76lano0n0\n", + "Job Status: job has successfully run\n", + "Measurement results: {'0': 27, '10000000': 973}\n" + ] + } + ], + "source": [ + "job = run_qasm3_program(bitwise_boolean)\n", + "counts = job.result().get_counts()\n", + "print(f\"Measurement results: {counts}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "4c89295e", + "metadata": {}, + "source": [ + "and comparison:" + ] + }, + { + "cell_type": "code", + "execution_count": 26, + "id": "d87cf7ff", + "metadata": {}, + "outputs": [], + "source": [ + "bitwise_comparison = \"\"\"\\\n", + "OPENQASM 3.0;\n", + "\n", + "qubit $0;\n", + "\n", + "bit[3] result1 = \"010\";\n", + "bit[3] result2 = \"101\";\n", + "bit c;\n", + "\n", + "if (result1 == result2) {\n", + " c = 1;\n", + "}\n", + "\n", + "if (result1 > result2) {\n", + " c = 1;\n", + "}\n", + "\n", + "bit d;\n", + "x $0;\n", + "d = measure $0;\n", + "\"\"\"" + ] + }, + { + "cell_type": "code", + "execution_count": 27, + "id": "421d5fdb", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: ceqq73oc7aa76lano0p0\n", + "Job Status: job has successfully run\n", + "Measurement results: {'0': 12, '10000000': 988}\n" + ] + } + ], + "source": [ + "job = run_qasm3_program(bitwise_comparison)\n", + "counts = job.result().get_counts()\n", + "print(f\"Measurement results: {counts}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "94406e4b", + "metadata": {}, + "source": [ + "The usage of bit-string literals is currently only supported when initializing bit registers. Therefore, expressions such as\n", + "\n", + "```\n", + "if ((result1 | result2) == \"000\") {\n", + " c = 0;\n", + "}\n", + "\n", + "```\n", + "are not yet supported." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "9455e53c", + "metadata": {}, + "source": [ + "### Conditional measurement" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "cd42fbd7", + "metadata": {}, + "source": [ + "Classical computation, Boolean expressions, and conditionals may be combined with qubit measurement to implement conditional measurement. Here the result of qubit measurements may be used to conditionally select additional qubit measurements. \n", + "```\n", + "qubit $0\n", + "qubit $1\n", + "bit r1;\n", + "bit r2;\n", + "\n", + "r1 = measure $0;\n", + "if (r1 == \"1\") {\n", + " r2 = measure $1;\n", + "}\n", + "```" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "634fe8db", + "metadata": {}, + "source": [ + "``else`` branches may be used to dynamically select individual qubits at runtime:" + ] + }, + { + "cell_type": "code", + "execution_count": 28, + "id": "0e6d640f", + "metadata": {}, + "outputs": [], + "source": [ + "conditional_measurement_program = \"\"\"\\\n", + "OPENQASM 3.0;\n", + "\n", + "qubit $0;\n", + "qubit $1;\n", + "qubit $2;\n", + "\n", + "bit r0;\n", + "bit r1;\n", + "bit r2;\n", + "\n", + "x $0;\n", + "\n", + "r0 = measure $0;\n", + "if (r0) {\n", + " r1 = measure $1;\n", + "} else {\n", + " r2 = measure $2;\n", + "}\n", + "\"\"\"" + ] + }, + { + "cell_type": "code", + "execution_count": 29, + "id": "1ebb1f3d", + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: ceqq77rhsot3802d22v0\n", + "Job Status: job has successfully run\n", + "Measurement results: {'0': 27, '1': 973}\n" + ] + } + ], + "source": [ + "job = run_qasm3_program(conditional_measurement_program)\n", + "counts = job.result().get_counts()\n", + "print(f\"Measurement results: {counts}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "925a7711", + "metadata": {}, + "source": [ + "Current system limitations prevent accurate reporting of the conditional measurement results once the program terminates. The result of the measurement is stored and used during the program; however, the measurement results will not be reported to the user unless there are subsequent measurements. If there are subsequent measurements, then the conditional measurement will always be reported as `0` to the user. We expect to add support for reporting conditional measurement results in 2023. " + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "id": "1a5e2808", + "metadata": {}, + "source": [ + "---" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "id": "1ffada21", + "metadata": {}, + "outputs": [], + "source": [ + "import qiskit.tools.jupyter\n", + "%qiskit_version_table" + ] + } + ], + "metadata": { + "title": "Dynamic circuits basics with OpenQASM 3", + "description": "Dynamic circuits basics with OpenQASM 3", + "kernelspec": { + "display_name": "qss-compiler", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.11.1" + }, + "vscode": { + "interpreter": { + "hash": "86a2ed08605ee75a0ec8503ed2a4583ad82ebc8a8e91cda2d47d6ac6ca361db1" + } + } + }, + "nbformat": 4, + "nbformat_minor": 5 +} diff --git a/docs/build/dynamic-circuits-basics-with-qiskit.ipynb b/docs/build/dynamic-circuits-basics-with-qiskit.ipynb new file mode 100644 index 0000000000..ea21a3981c --- /dev/null +++ b/docs/build/dynamic-circuits-basics-with-qiskit.ipynb @@ -0,0 +1,1021 @@ +{ + "cells": [ + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Dynamic circuits basics with Qiskit" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This guide introduces how to use dynamic circuits with Qiskit.\n", + "\n", + "We recommend using dynamic circuits with Qiskit, since it combines the power of Python with quantum computing in a scalable way that makes it easy to build and execute programs on IBM hardware." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Know before you begin\n", + "\n", + "Below we instantiate the Qiskit backend that we will use to submit programs to the target system. Backends provide a handle to the quantum hardware instance. Backends are obtained from the ``IBMProvider`` imported from ``qiskit_ibm_provider``, and are specified by a system name along with a ``hub/group/project`` string that will enable you to access a specific system under an access provider.\n", + "\n", + "Visit [this page](https://quantum-computing.ibm.com/services/resources?tab=yours&openqasm3=true) to view the systems with dynamic circuit support." + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": {}, + "outputs": [], + "source": [ + "# Note: This can be any hub/group/project that has access to the required device and Qiskit Runtime.\n", + "hub = \"\"\n", + "group = \"\"\n", + "project = \"\"\n", + "backend_name = \"\"\n", + "hgp = f\"{hub}/{group}/{project}\"\n", + "\n", + "# Note: If you do not have your IBM Token saved, run the following\n", + "# More info: https://quantum-computing.ibm.com/lab/docs/iql/manage/account/ibmq\n", + "# IBMProvider.save_account(\"TOKEN\")\n", + "# IBMProvider.load_account()\n", + "# IBMProvider.providers()" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": {}, + "outputs": [], + "source": [ + "from qiskit_ibm_provider import IBMProvider\n", + "\n", + "# load provider and backend\n", + "provider = IBMProvider()\n", + "backend = provider.get_backend(backend_name, instance=hgp)\n", + "print(f\"Using backend {backend.name}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Below is a simple transpiled Bell circuit." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Bell states are the four states that can be created when maximally entangled. The four states are represented as:\n", + "\n", + "$$|\\Phi^+\\rangle = \\frac{|00\\rangle + |11\\rangle}{\\sqrt{2}}$$\n", + "\n", + "$$|\\Phi^-\\rangle = \\frac{|00\\rangle - |11\\rangle}{\\sqrt{2}}$$\n", + "\n", + "$$|\\Psi^+\\rangle = \\frac{|01\\rangle + |10\\rangle}{\\sqrt{2}}$$\n", + "\n", + "$$|\\Psi^-\\rangle = \\frac{|01\\rangle - |10\\rangle}{\\sqrt{2}}$$\n", + "\n", + "In our example, we will implement the first Bell state. The circuit will consist of a Hadamard gate and a CNOT gate." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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+4YOHcqBAwd4//33qxxEAP369WPFihUcOHCAIUOG2N+/NIjWr1/Pxx9/XOPtro4r5jLdjh07AIiNjTW4JbXjSjvfumhHmnUGXW1KTIHeUboHyV01aNCABQsWMH78+FLv//TTT3z00Uds376dH3/8kVOnTgHQtGlTYmNjiYuL44477iAmJgaA1q1b8/nnn/POO++wevVqPvroo1JBdPvtt1NYWFi7J1eJet8zWr16NSaTiWnTpgGwePFiTCaT/Wv27NkAHD58mHnz5nHTTTdx9dVXExgYSEBAAF27dmXu3LkVfuMiIyMxmUykpKSQmJjIrbfeSrNmzTCZTCxdurTUvpmZmUyZMoU2bdrg5+dHVFQUzz//PGazmXHjxmEymXj77bfL1FFYWMhbb73FoEGDCAkJwdfXl3bt2vHkk0+Sk5Pj1PmKsSwW602tte1kNuzLrP16pXLNmjVj06ZNpYJo48aN9OvXj86dO/O3v/2NDRs2kJGRQWFhIYWFhRw/fpzPPvuMmTNn0qlTJ2644Qb+/e9/24+fMGECn376qdsHEVwBPaPc3Fx69+5NUlIS+fn5xMbGEhBw4U7A3/zmNwA888wzLFmyhMDAQFq2bElMTAwnTpxg165d7Nq1i23btrF69epSZf/666+kpaXh7+/PypUrmTlzJiEhIURGRuLh4UGXLl3s+27dupX4+HhOnz5NUFAQMTExpKen88QTT3Do0CH27t0LQLdu3UrVkZqaym233cbu3bvx8vKibdu2NG/enNTUVJ577jk2btzIN998Yz+nqp6vGCvrHKSfNqbubYesKzWI+wgODmbjxo107doVsI75PvrooyxZssShcjZv3szgwYOZOHEiL7/8MoGBgfbL9J9//rnbBhFcAWF07733MnbsWBo0aADAV199RXBwcJn9brzxRiZPnkxsbGypR+5u376dm2++mTVr1vDf//6Xzp0727clJycDUFBQwJw5c1i0aBETJkzA09MTs9ls3y8zM5Nhw4Zx+vRpnnzySZ5++mn8/f2xWCzMmjWLp59+Gm9vbzw9PenUqZP9uNOnTzN06FBSU1OZOHEis2bNonnz5gDs37+fYcOGsWPHDubPn8/06dMdOl8xVtovxtV95JRxdUv53nvvPXsQpaenM2jQIH7++Weny9u/f3+ZR4eXlJS4bRDBFXCZDmDfvn3k5eURERFR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", + "text/plain": [ + "
" + ] + }, + "execution_count": 3, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "from qiskit import QuantumCircuit, QuantumRegister, ClassicalRegister, transpile\n", + "\n", + "control = QuantumRegister(1, name=\"control\")\n", + "target = QuantumRegister(1, name=\"target\")\n", + "final_measure = ClassicalRegister(1, name=\"final\")\n", + "\n", + "# Creating a Bell circuit\n", + "qc_bell = QuantumCircuit(control, target, final_measure)\n", + "qc_bell.h(control)\n", + "qc_bell.cx(control, target)\n", + "qc_bell.measure(control, final_measure)\n", + "qc_bell.measure(target, final_measure)\n", + "qc_bell.draw(output=\"mpl\", idle_wires=False)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now we can transpile our circuit `qc_bell` using `transpile(qc_bell, backend)`. The transpiler rewrites an abstract quantum circuit into a functionally equivalent one that matches the constraints and characteristics of a specific target quantum device.[$^2$](https://medium.com/qiskit/how-does-the-qiskit-transpiler-work-6710863beaac) In other words, transpiling a circuit transforms a circuit to match the basis gates and coupling graph of the target backend." + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "execution_count": 4, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qc_bell = transpile(qc_bell, backend)\n", + "qc_bell.draw(output=\"mpl\", idle_wires=False)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now we run the program on our backend using `backend.run(, shots=shots, dynamic=True)`, which returns the job, `bell_job`. \n", + "\n", + "Be sure to use the `dynamic=True` flag in your `backend.run()`. We can run both on the legacy/dynamic circuit paths to compare performance as we develop these capabilities.\n", + "\n", + "In order to fetch the results of this job, we run `bell_job.result()`. This returns the number of times 0s or 1s were the output. " + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: cg7r11l7vlu95bb2ib20\n", + "Job Status: job has successfully run\n", + "Preparation results: {'0': 517, '1': 483}\n" + ] + } + ], + "source": [ + "from qiskit.tools.monitor import job_monitor\n", + "\n", + "bell_job = backend.run(qc_bell, shots=1000, dynamic=True)\n", + "print(f\"Runtime job id: {bell_job.job_id()}\")\n", + "job_monitor(bell_job)\n", + "\n", + "bell_result = bell_job.result()\n", + "print(f\"Preparation results: {bell_result.get_counts(0)}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Plot the same preparation results as a histogram." + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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09LS9N///d967bXX1K5dO23cuFEBAQH69NNPNWLECL3++uv6wx/+UOy5r7/+uubOnau///3vGjp0qNLS0nTfffepR48e+uqrr4qN37Jli2JiYjRlyhQtWrSoxH5KWskLDw9XRkaGc/5V8RfthA9YyUPN8R8TWcljTjVrTs8vYiUPNceSKVV7PGVlZSk4OLjqrq6NjY2VxWKRw+HQypUrtXLlymLn5zkcDlkslgqFPKvVqrCwML344osKCQnR8OHDNWfOHM2fP9+5IlfaylvRR6lF48o7viQ+Pj7y8fEpVvf29i52/z6bzVbix8KlXYVcWv2n+wU8rbTfyZLqVqvVecujstRLO26q+nhiTrV7TkBN4qnjqdi4Mo0qQXx8vLtPdVtMTIykWxdPSHc+h+6n5+z5+fmpcePGOnXqlAoKCor94O50jh8AAEBtUau+1iwtLU3Sv/6Sa9WqlZo0aaKdO3cqLy/P5QrbvLw87dy5U82bN1d4eLiz3rt3b61evVo7d+5Ur169XPZfdH+8n9YBAABqG7dvoVJV/vd//1dXr14tVr969aqmTZsm6daJttKtz7LHjRunK1eu6K233nIZ/9Zbb+nKlSsaP368S/3555+XdOs+ejdv3nTWN23apOTkZMXExCgiIqJS5wQAAFDd3F7J+/HVHndSnhsLJyQk6I9//KN69uypZs2aKSAgQN9//702bdqkzMxMPfbYY3r55Zed41955RWtX79e8+fP19dff63IyEgdOHDA+bVmU6dOddl/dHS0xo0bp+XLlysyMlKDBw/WhQsXtGbNGjVo0EDvv/9+mXsFAACoqdwOec2aNSvTjZAtFkuZ7+ciST//+c+VlpamXbt2affu3bpy5YoCAwPVsWNHPfXUU3ruuedcTjj08/PTjh07NGvWLK1du1ZJSUlq3LixfvOb3yguLk6+vr7FXmPJkiXq0KGDli5dqkWLFqlevXoaOnSo5syZo5YtW5a5VwAAgJrK7VuoFF1d+1PZ2dk6dOiQTp06pd69e6tZs2YeuUijupT1S4Irii/fRk1S1V++DZQX75GoSar6PbKs2cPtlbyVK1eWus3hcGjhwoV655139OGHH7r7EgAAAHBTlVx4UfTtFO3atdPvfve7qngJAAAA3EaVXl378MMPa/v27VX5EgAAAChBlYa8kydPluuiCwAAAFQOt8/JK01hYaG+//57rVy5UuvXr1ffvn0r+yUAAABwB26HPKvVettbqDgcDtWvX18LFy509yUAAADgJrdDXq9evUoMeVarVfXr11eXLl00ZswYNWzYsEINAgAAoPzcDnnJycmV2AYAAAAqU4377loAAABUXKVceLFz504dPHhQOTk5CggIUKdOndSjR4/K2DUAAADcUKGQt2vXLo0ZM0YnTpyQdOtii6Lz9Fq1aqX4+Hh169at4l0CAACgXNwOed98841iYmJ09epV9e/fX9HR0WrcuLHS09OVlJSkxMREDRgwQHv27NGDDz5YmT0DAADgDtwOeb///e918+ZNbdy4UQMHDnTZNn36dH3xxRcaMmSIfv/732v16tUVbhQAAABl5/aFF8nJyRo2bFixgFdk4MCBGjZsmJKSktxuDgAAAO5xO+RlZ2erefPmtx3TvHlzZWdnu/sSAAAAcJPbIa9Jkybas2fPbcf84x//UJMmTdx9CQAAALjJ7ZA3ZMgQJScna+bMmbp+/brLtuvXrysuLk5JSUn65S9/WeEmAQAAUD5uX3gxc+ZMbdiwQXPnztWSJUv0yCOP6N5779UPP/ygffv26eLFi2rRooVmzpxZmf0CAACgDNwOecHBwdqzZ49eeeUVrV69Whs3bnRuq1u3rsaMGaP58+erQYMGldIoAAAAyq5CN0MOCQnRihUrtGTJEn377bfOb7xo27atvL29K6tHAAAAlFO5Q96cOXOUl5en2bNnO4Oct7e3OnTo4Bxz8+ZNvf766/L399err75aed0CAACgTMp14cXWrVv15ptvKjg4+LYrdXXq1FFwcLBef/117pMHAADgAeUKeR999JHq16+vSZMm3XHsxIkT1aBBA8XHx7vdHAAAANxTrpC3a9cu9evXTz4+Pncc6+Pjo379+mnnzp1uNwcAAAD3lCvkpaWlqUWLFmUe37x5c124cKHcTQEAAKBiyhXyrFar7HZ7mcfb7XZZrW7fbxkAAABuKlcCa9KkiY4ePVrm8UePHtV9991X7qYAAABQMeUKeY899pi2b9+u06dP33Hs6dOntX37dvXq1cvd3gAAAOCmcoW8iRMnym63a9iwYcrIyCh1XGZmpn79618rPz9fL774YoWbBAAAQPmU62bIkZGRmjp1qt577z09+OCD+vd//3dFR0crLCxMkvT9999r27ZtWrp0qS5evKhp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zAIDA0vcHhAQ4BzzU/PmzdPs2bOL1Zs3b155DQI13EczPN0BANRc1fUemZubW2qWke7SkFcRM2bM0LRp05yPCwsLlZWVpeDgYFks/CVZk+Xk5Cg8PFznzp1TQECAp9sBgBqF98jaw+FwKDc3V02aNLntuLsy5BWl3tJW63JyclS/fv0St/n4+MjHx8elFhQUVKn9oWoFBATwBgYApeA9sna43Qpekbvywouic/FKOu8uPT1dV65cKfF8PQAAgNrirgx5vXv3liQlJiYW27Z582aXMQAAALXRXRny+vbtqxYtWujTTz/VwYMHnfXs7GzNnTtXderU0ahRozzXIKqEj4+P4uLiin3cDgDgPdJEFsedrr81VGlfa3bmzBm9++67fK0ZAACo1e7akCdJe/fuVVxcnHbt2iW73a4OHTpo2rRpevLJJz3dGgAAQIXc1SEPAADAVHflOXkAAACmI+QBAAAYiJAHAABgIEIeAACAgQh5MFLR9URcVwQAuFsR8mAki8Uih8Mhi8Wi9PR0FRYWerolAACqlZenGwAqW35+vnbu3KkVK1bo+PHjslqt8vX1VadOnfTEE0+oe/funm4RAIAqx33yYJx3331Xb731lnJzc9WyZUt5eXnp2LFjzu1t27bV888/r6eeekqNGjXyYKcA4FlFn3jATIQ8GOXUqVPq0KGDIiMjtWrVKtWpU0f33nuv0tPT9fnnn+tvf/ubkpOTJUl9+vTRO++8o8jISM82DQDV5Nq1azp79qyaNm0qX19fT7eDKkbIg1HefPNNLVmyRJ9++qn69u0rqfhfqkeOHNG7776rhIQERURE6JNPPtFDDz3kqZYBoNq8/fbbWrt2rZ544gl17dpVbdq00b333iubzVbqczIyMhQUFCQvL87wqm0IeTDKr371Kx08eFBJSUlq2rSp8vPz5eXlJYfDocLCQpc3skWLFunll1/W6NGjFR8f78GuAaB6hIWFKS0tTTabTYGBgerevbtiYmL06KOPqkWLFgoODnYZn5eXp1mzZikzM1PLly+X1cr1mrUJsRxG6dy5sz777DNduXJFkpx/eVosFmfAK1rZe+mll/Tll19q+/bt+u6779SiRQuP9Q0AVe348ePKzs5Wt27d9Mwzz2jLli3avXu3NmzYoKZNmyoqKkr9+vVT586ddd999ykoKEhHjx7VsmXLFBUVRcCrhQh5MEp0dLQkacSIEVq4cKF69uypOnXqFBtXUFAgm82mNm3aaNOmTc5QCACmOn78uK5fv66YmBhNnDhRP//5z3Xs2DHt3r1b27dv19q1a/XJJ5/owQcfVJ8+fTRw4EBt27ZNOTk5Gj9+vKfbhxv4uBZGKSgo0PTp0/XHP/5Rbdu21cSJEzVs2DDde++9xcZeunRJU6dO1aZNm/TPf/7TA90CQPX529/+puHDh2v16tUaPny4s26323XmzBkdOnRIX375pZKTk/V///d/8vb2lsPhkI+Pj7KysjzYOdxFyIORlixZogULFui7775TkyZNNHToUD3++OMKDw+XzWZTUFCQ3n//fb333nuaMGGCFi5c6OmWAaBKORwOffvtt6pbt66aN29e4u1T8vLydPz4cR07dkzx8fHasmWLJk2apD//+c8e6hoVQciDkRwOh06cOKFly5Zp9erVOn/+vCSpYcOG8vb21oULF1RYWKinn35a8+fPV1hYmIc7BgDPKSnwTZkyRYsXL9b+/fvVuXNnD3WGiiDkwXh5eXnau3evPv/8c6Wlpemf//ynAgICNHz4cP3qV79S3bp1Pd0iANQIhYWFslqtOn36tH75y1/q0qVLOnv2rKfbgpu48ALG8/PzU3R0tKKjo2W32+Xt7e3plgCgRiq6gvb777+X3W7XhAkTPNwRKoKVPAAA4MLhcOj8+fNq0KCB/Pz8PN0O3ETIAwAAMBB3NgQAADAQIQ8AAMBAhDwAAAADEfIAAAAMRMgDAAAwECEPAADAQIQ8AAAAAxHyAAAADETIAwAAMND/A+JXEdm624EJAAAAAElFTkSuQmCC", + "text/plain": [ + "
" + ] + }, + "execution_count": 6, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "from qiskit.visualization import plot_histogram\n", + "\n", + "plot_histogram(bell_result.get_counts(0))" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Mid-circuit measurements with dynamic circuits\n", + "\n", + "Measurements are done to gather information about the final state of a quantum system in the form of a discrete probability distribution in the computational basis. However, there are distinct computational advantages to measuring a qubit in the middle of a computation. Mid-circuit measurements can be used to validate the state of a quantum computer in the presence of noise, allowing for post-selection of the final measurement outcomes based on the success of one or more sanity checks. Visit [this page](./midcircuit_measurement) for more information about mid-circuit measurement." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "First, let's try a simple circuit with only an X-gate, and do a mid-circuit measurement." + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "execution_count": 7, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qc_midcirc = QuantumCircuit(1, 2)\n", + "\n", + "qc_midcirc.x(0)\n", + "qc_midcirc.measure(0, 0)\n", + "qc_midcirc.x(0)\n", + "qc_midcirc.measure(0, 1)\n", + "\n", + "qc_midcirc.draw(output=\"mpl\", idle_wires=False)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Here, the result of the first measurement should be $1$. Apply an X-gate to the qubit again, and the result should be $0$." + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": {}, + "outputs": [], + "source": [ + "qc_midcirc_transpiled = transpile(qc_midcirc, backend)" + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: cg7r15i14ejq4casn94g\n", + "Job Status: job has successfully run\n", + "Measurement 1 results: {'0': 13, '1': 987}\n", + "Measurement 2 results: {'0': 924, '1': 76}\n" + ] + } + ], + "source": [ + "from qiskit.result import marginal_counts\n", + "\n", + "\n", + "midcirc_job = backend.run(qc_midcirc_transpiled, shots=1000, dynamic=True)\n", + "print(f\"Runtime job id: {midcirc_job.job_id()}\")\n", + "job_monitor(midcirc_job)\n", + "\n", + "midcirc_count1 = marginal_counts(midcirc_job.result(), indices=[0]).get_counts()\n", + "midcirc_count2 = marginal_counts(midcirc_job.result(), indices=[1]).get_counts()\n", + "\n", + "print(f\"Measurement 1 results: {midcirc_count1}\")\n", + "print(f\"Measurement 2 results: {midcirc_count2}\")" + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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pJtvI4iLi1ODBg1strFmzRqdO3dOPXv2tCnv1auXrl69qp9//tmmvGHDhrp69ardUOqjR49q3759d4157dq1MplMmj9/voYOHarAwEB5e3urVatWio+PV2Jiovr166eAgADlzJlTnTp1SnU0zezZs1W5cmV5enoqT548atOmjY4dO2ZTx/JwyCJFisjd3V2FCxfWG2+8YXOspJtvcujUqZMKFSokd3d3FShQQM2bN9fhw4etdRYvXiw3NzfVrl3bZt2FCxfK2dlZ3bt3t5Z5eHioS5cu2rx5s11M6fHDDz8oKSnJ5pyYTCa99tprOn78uDZv3mxTv2HDhjpy5Ii2b9+e4X0BjkDiDQDALQICAhQaGqrY2FgdO3ZMERERunbtmiTJycn216aTk5NSGzg2d+5cBQYGqnTp0g8kZgD/x9PTUzNnztS///5r87CvXr16KT4+XtHR0dae0U2bNslkMqlixYo229i2bZsk6amnnrIpr1y5spycnKzLLcqUKSNPT09t3LjRprx9+/YZug+MHj1ay5YtU//+/dW5c2d99913evXVV9W5c2cdOHBAQ4YMUYsWLRQdHa2xY8farDty5Ei1b99eJUqU0EcffaR+/fpp1apVql27ti5evGitt2DBAl27dk2vvfaaJk+erEaNGmny5Mlq3769zfZatmyp77//Xp06ddKnn36qvn376vLlyzp69Ki1zqZNm1SuXDm5urraHb+SJUvaje6sWrWqJGUqGd62bZu8vLzsjqdlm7efk8qVK0uS3TkBsopLVgcAAEB2MHLkSBmGodq1a2vTpk0aOnSovLy89PnnnytHjhzy9fXVqFGj5OPjo0qVKunrr7/Wvn37bOYVStKqVasUHx9vHV4J4MELCwvTu+++q7Fjx+qFF17QmTNnNHfuXE2aNEklS5a01tu3b5/y5MljlyCeOnVKzs7OCggIsCl3c3OTn5+fTp48aVPu4uKiwoULa8+ePfcUd3JystatW2dNZM+ePau5c+eqcePG+uWXXyTdfAL7v//+q+nTp2vQoEGSpCNHjmjw4MEaMWKEzUPiWrRooYoVK+rTTz+1lo8dO1aenp7WOt27d9cTTzyh9957T0ePHlWRIkV08eJFbdq0yWaouHRzjvWt9u3bp7CwMLt2nDp1SgUKFLArt5TdfvzS49SpU8qXL5/dsPG0thkYGCg3N7d7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nJzk7OyslJQUmc1ma11LeXJysm5965uzs7OcnJzSLLds18LF5eZpTk5OTle5q6urzGazUlJSrGUmk0kuLi5plqcVO23Knm1KSEjQokWL9N1336l27dpKSUnR+++/rx9//FFTpkzRiBEjtGLFCpvYJ02apBo1aujo0aMqWLCgtfzXX3/V8uXLtWjRIi1dutTm2uY80SbaRJtoU/ZoEwAgaz3UiffDYPTo0Ro6dKhd+fLly5UjRw5JUpEiRVSxYkX9888/NvPLS5UqpZCQEG3ZskVnz561loeGhqpo0aJav369zYPdqlevroCAAC1fvtzml2zdunXl6empX375xSaGZ555RgkJCVqzZo21zMXFRU2bNlVcXJw2b95sLff29la9evV07Ngxm6HE/v7+qlGjhmJiYrR//35rOW3K3m1KSEhQSkqKdei4pU3Xr1/XTz/9pA4dOti1aceOHTKZTMqVK5e1TRcvXtRbb72lb775xno9//bbb9btcp5oE22iTbQp69v0999/CwCQtUzGrV/fZkNjxozRgAEDNGPGDHXs2NFm2c8//6xnn31WvXv31uTJk+3W7dOnj6ZMmaJVq1apXr16unr1qnLmzKly5cpp586ddvUXLVqkVq1aaeDAgRo2bJgkqUqVKvrrr78UFxcnPz8/m/rnzp1T3rx59fTTT2v9+vWpxp9aj3fhwoUVFxdn7TF/XL99p01Z26batWvLzc1N3377rfLmzatvvvlGXbp0UXBwsPbu3WvTpuvXrys8PFwhISH65ptvlJycLLPZrGbNmql69eoaOHCgjh49qqCgIG3ZskWhoaFZ0qZbz8ejcp5oE22iTbTpXtt0/vx5+fn5KT4+3vq3x/Xr1xUbG6ugoCB5eHgIAJA56b2fPtQ93nebY337/GwvLy8VKFBAsbGxSklJsZvnndp87hIlSuivv/5STEyMXeJ9tznmkuTu7i53d3e7cldXV7m6utqUOTs7pzr33PLLOr3lt283M+VOTk5ycrJ/BEBa5WnFTpuyb5tmz56tzp07KzAwUM7OzqpUqZLatm2rv//+21rHxcVFSUlJeumllyRJn332mbX8f//7n65cuaIPPvjAZl+pXducJ9pEm2hTWjFmtJw23b824f/07NlTMTExWrFiRYbXbdOmjcxms+bPn++AyLI/s9msChUqqG3btnr//fezOhxJUrVq1VS7dm2NGzfuge1z3Lhxmj59uvbs2ZPqz+2d9O/fX2vWrNEff/zhoOiyv2eeeUaBgYHWN1BlNUeck4f64WolSpRQwYIFtXHjRl29etVm2dWrV7Vx40YFBQWpcOHC1vLw8HDrststW7ZM0s2ewFvrSzeHhqdV31IHeJgEBwdr3bp1unLlio4dO6YtW7YoKSlJxYsXt9ZJSkpSZGSkjhw5ohUrVlh7SiRp9erV2rx5s9zd3eXi4qInnnhCkvTUU0+pQ4cOD7w9AABkRmxsrL788ku99957dsu++uorlS5dWh4eHipRokSqIyyjoqK0aNEi7dix40GEm+18++23OnbsmHr37m1TnpiYqKioKBUsWFCenp4KCwvL1BcbtzKbzRo3bpy1Z7FChQr69ttv7epFRUXpk08+0enTp+9pf+l16dIljR07VlFRUXZJ948//qhKlSrJw8NDRYoU0eDBg+1GvvTr1087duzQjz/++EDizW42btyo5cuXKyoqyqY8vec7I6ZOnarWrVurSJEiMplMdiOqLRxxTh7qr0BNJpO6du2qYcOGafjw4RozZox12fDhw3XlyhW7m2j37t01d+5cDRw4UCtWrLC+y3vp0qVau3atIiIibN4hHhkZqaioKE2ePFmdO3e2vsv7+PHjmjJlivLmzasXXnjhAbQWcAwvLy95eXnpwoULWrZsmfXbYUvSHRMTozVr1tiN+Pjf//6nESNGWD+fPHlSjRo10rx58xQWFvZA24CHS7dJWR0BLL7ol9URILs6WGpIVoeg4P0PJoaPP/5YQUFBqlu3rk35tGnT9Oqrr6ply5Z68803tWHDBvXt21fXrl2zSRAqVqyop556ShMmTNDXX3/9QGLOTsaPH682bdrYPYi4Y8eOWrhwofr166cSJUooOjpazzzzjNasWaNatWplal/vv/++xowZo27duqlKlSr64Ycf1K5dO5lMJrVp08Zar3nz5vLx8dGnn35qnT7qSNOnT1dycrLatm1rU7506VI9//zzqlOnjiZPnqydO3dqxIgR+u+//zR16lRrvfz586t58+b68MMP03yDzKNs/Pjxql+/vrUTxyK95zsjxo4dq8uXL6tq1ao6depUmvUccU6y5RzvL7/8Ur/99pskaefOndq6datq1qxpPRm1atVS165dJd3s2a5Zs6Z27NihiIgIVapUSVu3btXy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D33ifeLECU2aNEkREREqUqSI3NzclD9/frVs2VJ//PGHXf0hQ4bIZDKl+e/w4cOp7mfZsmUKDw+Xt7e3fHx8VLduXa1atcrBrQMAAAAAPOxcsjqAezV58mSNHTtWwcHBioiIkL+/v2JiYrR48WItXrxY33zzjV588UW79Tp06KBixYrZlefKlcuubPbs2XrllVfk7++vjh07SpLmzZunhg0bav78+WrVqtV9bhUAAAAA4FHx0CfeVatW1dq1axUeHm5TvmHDBtWvX1+vvfaann/+ebm7u9ss79ixo+rUqXPX7V+4cEF9+vRR3rx5tXXrVhUqVEiSFBUVpYoVK+q1115To0aN5O3tfd/aBAAAAAB4dDz0Q81btGhhl3RL0tNPP626devqwoUL2rlzZ6a3v2DBAl28eFF9+vSxJt2SVKhQIfXu3VtxcXH6/vvvM719AAAAAMCj7aFPvO/E1dVVkuTiYt+xv379eo0dO1bjx4/X4sWLdeXKlVS3sXbtWklSRESE3bJGjRpJktatW3efIgYAAAAAPGoe+qHmaTl69KhWrlypAgUKqHz58nbLBw8ebPM5V65c+vjjj9W+fXub8piYGElSiRIl7LZhKbPUSU1iYqISExOtny9duiRJSkpKUlJSkiTJyclJzs7OSklJkdlstta1lCcnJ8swDGu5s7OznJyc0iy3bNfC8sVDcnJyuspdXV1lNpuVkpJiLTOZTHJxcUmzPK3YadMj/d3WQyUlJeWxu/ayb5tchezBci08Ptfe49smAEDWeiQT76SkJL3yyitKTEzU2LFj5ezsbF325JNPavr06apTp44KFCig06dPa8mSJRo0aJA6duyoXLlyqVmzZtb68fHxkiRfX1+7/fj4+NjUSc3o0aM1dOhQu/Lly5crR44ckqQiRYqoYsWK+ueff3T06FFrnVKlSikkJERbtmzR2bNnreWhoaEqWrSo1q9fr8uXL1vLq1evroCAAC1fvtzml2zdunXl6empX375xSaGZ555RgkJCVqzZo21zMXFRU2bNlVcXJw2b95sLff29la9evV07Ngxbd++3Vru7++vGjVqKCYmRvv377eW06b/axOyh5iYmMfu2su+bWouZA+Wc/74XHuPZ5v+/vtvAQCylsm49evbR4DZbNYrr7yib775Rt26ddPnn3+ervVWrVqlhg0bqly5cvrnn3+s5SVLllRMTIySkpLshqwnJSXJzc1NFSpU0I4dO1Ldbmo93oULF1ZcXJw1cX9cv31/XNp0sNQQIesV2zPwsbv2smuben5Cj3d28WkverwfhzadP39efn5+io+Pt/7tAQB4sB6pHm+z2azOnTvrm2++0csvv6zPPvss3evWr19fwcHB2rlzpy5dumT9xWTp6Y6Pj5efn5/NOpZh46n1hlu4u7vbPVFduvmL1jIH3cLZ2dmmd94itTnqdyq/fbuZKXdyckp1mHRa5WnFTpuQXVjO2eN07T0MbULWSu/voUfx2qNNAIAH6ZGZgGo2m9WpUyfNnDlTbdu2VXR0dIbn1+bNm1eSdO3aNWvZneZx32n+NwAAAAAA0iOSeFuS7q+//lovvviiZs2aleGelatXr2r37t3y8vKyJuCSrK8qW758ud06y5Yts6kDAAAAAMDtHvrE2zK8/Ouvv1br1q01e/bsNJPuy5cv68CBA3blCQkJ6tatmy5fvqzIyEibIVmRkZHy9fXV5MmTdfz4cWv58ePHNWXKFOXNm1cvvPDC/W8YAAAAAOCR8NBP+hk2bJhmzpypnDlzqmTJkhoxYoRdneeff16hoaE6d+6cQkJCVKVKFZUuXVr58+fXmTNntHLlSh0/flzly5fX+PHjbdbNnTu3pkyZoldeeUWVKlXSiy++KEmaN2+ezp07p3nz5snb2/uBtBUAAAAA8PB56BPvw4cPS5KuXLmikSNHplqnWLFiCg0NVZ48edSzZ09t2bJFv/zyiy5cuCBPT0+VLl1affv2Ve/eveXp6Wm3/ssvv6y8efNq1KhRmjFjhkwmkypXrqwPPvhADRo0cGTzAAAAAAAPuUfudWLZ3aVLl+Tr68srPR4jvE4sewjePySrQ8D/121SVkcAiy/6ZXUEeBD42wMAst5DP8cbAAAAAIDsjMQbAAAAAAAHIvEGAAAAAMCBSLwBAAAAAHAgEm8AAAAAAByIxBsAAAAAAAci8QYAAAAAwIFIvAEAAAAAcCASbwAAAAAAHIjEGwAAAAAAByLxBgAAAADAgUi8AQAAAABwIBJvAAAAAAAciMQbAAAAAAAHIvEGAAAAAMCBSLwBAAAAAHAgEm8AAAAAAByIxBsAAAAAAAci8QYAAAAAwIFIvAEAAAAAcCASbwAAAAAAHIjEGwAAAAAAByLxBgAAAADAgUi8AQAAAABwIBJvAAAAAAAciMQbAAAAAAAHIvEGAAAAAMCBSLwBAAAAAHAgEm8AAAAAAByIxBsAAAAAAAci8QYAAAAAwIFIvAEAAAAAcCASbwAAAAAAHIjEGwAAAAAAByLxBgAAAADAgUi8AQAAAABwIBJvAAAAAAAciMQbAAAAAAAHIvEGAAAAAMCBSLwBAEC2VaxYMZlMJrt/vXr1stbZvHmz6tWrJy8vL/n4+Kh27dpKSEjIwqgBALDlktUBAAAApOXPP/9USkqK9fOuXbvUsGFDtW7dWtLNpLtx48YaMGCAJk+eLBcXF+3YsUNOTvQtAACyDxJvAACQbfn7+9t8HjNmjIKDgxUeHi5JeuONN9S3b1/179/fWqdUqVIPNEYAAO6Gr4MBAMBD4caNG5o9e7Y6d+4sk8mk//77T3/88YcCAgJUo0YN5cuXT+Hh4frtt9+yOlQAAGyQeAMAgIfC4sWLdfHiRXXs2FGSdOjQIUnSkCFD1K1bN/3666+qVKmS6tevr5iYmCyMFAAAWyTeAADgofDVV1+pSZMmKliwoCTJbDZLknr06KFOnTqpYsWKmjhxokqVKqXp06dnZagAANhgjjcAAMj2jhw5opUrV+q7776zlhUoUECSVKZMGZu6pUuX1tGjRx9ofAAA3Ak93gAAINubMWOGAgIC1LRpU2tZsWLFVLBgQe3fv9+m7oEDB1S0aNEHHSIAAGmixxsAAGRrZrNZM2bMUIcOHeTi8n9/uphMJr3zzjsaPHiwnnzySYWGhmrmzJnat2+fFi5cmIURAwBgi8QbAABkaytXrtTRo0fVuXNnu2X9+vXT9evX9cYbb+j8+fN68skntWLFCgUHB2dBpAAApI7EGwAAZGsREREyDCPN5f3797d5jzcAANkNc7wBAAAAAHAgEm8AAAAAAByIxBsAAAAAAAdijjcAAI+pg6WGZHUIkBS8f0hWhwAAcDB6vAEAAAAAcCASbwAAAAAAHIjEGwAAAAAAByLxBgAAAADAgUi8AQAAAABwIBJvAAAAAAAciMQbAAAAAAAHIvEGAAAAAMCBSLyRpSZPnqx8+fLJ2dlZJpNJAwYMsFlep04dubu7y2QyycnJSXny5NFXX32VRdECAAAAQMaReCNLXbhwQSVKlNDbb7+d6vKyZctq+PDhWrNmjb7//nv5+/ura9eu2rt37wOOFAAAAAAyxyWrA8DjbdCgQRo0aJAkady4cXbLP/nkE5vPlStXVuHChbVkyRKVLl36gcQIAAAAAPeCHm88NK5cuaJXX31VktSsWbMsjgYAAAAA0ofEG9neoEGDZDKZ5O3traVLlyo6OlqlSpXK6rAAAAAAIF1IvJHt9e7dWytXrtQXX3yh4OBgde3aVbt3787qsAAAAAAgXUi8ke0FBASofv366tq1qw4cOCCTyaQ333wzq8MCAAAAgHQh8cZDxzAMJSYmZnUYAAAAAJAuPNUcWer06dNat26d9fPevXs1b948FSlSRMHBwXr++efVuXNnlS5dWrGxsRo2bJiSk5P1xhtvZGHUAAAAAJB+JN7IUnPnzrVJon/44Qf98MMPCg4O1l9//aXDhw+rR48eMpvNcnJyUkBAgKKjo9W8efMsjBoAAAAA0o/EG1mqX79+6tevX5rLT548+eCCAQAAAAAHYI43AAAAAAAOROKdAX/++aeeeeYZ5cqVS15eXqpWrZrmz5+f1WEBAAAAALIxhpqn05o1a9SoUSN5eHioTZs28vb21qJFi/Tiiy/q2LFjeuutt7I6RAAAAABANkTinQ7Jycnq1q2bnJyctH79eoWGhkqSBg0apKpVq+q9995Tq1atVLRo0awN9BbdJmV1BLDon9UBAAAAAMhSDDVPh9WrV+vgwYNq166dNemWJF9fX7333nu6ceOGZs6cmXUBAgAAAACyLRLvdFi7dq0kKSIiwm5Zo0aNJMnmXdQAAAAAAFgw1DwdYmJiJEklSpSwW5Y/f37lzJnTWud2iYmJSkxMtH6Oj4+XJJ0/f15JSUmSJCcnJzk7OyslJUVms9la11KenJwswzCs5c7OznJyckqzPCkpSTeuu95Di3E/XU5JvHslONyFCxcy/fN0KxeXm7fN5OTkdJW7urrKbDYrJSXFWmYymeTi4pJmeVr3gvt5j8jKNnF/yj64P2UPFy9edOg94vz585Jkcz8AADxYJN7pYEmWfX19U13u4+NjrXO70aNHa+jQoXblQUFB9y9AZGtfZ3UAuCnPmKyOAMh2uD9lE7kfzP3p8uXLaf4tAwBwLBJvBxswYIDefPNN62ez2azz58/Lz89PJpMpCyPDg3Dp0iUVLlxYx44dk4+PT1aHAwBW3J8eH4Zh6PLlyypYsGBWhwIAjy0S73SwfDucVq/2pUuXlDt37lSXubu7y93d3aYsV65c9zU+ZH8+Pj78YQsgW+L+9HigpxsAshYPV0sHy9zu1OZxnz59WleuXEl1/jcAAAAAACTe6RAeHi5JWr58ud2yZcuW2dQBAAAAAOBWJN7pUL9+fRUvXlzffPONtm/fbi2Pj4/XqFGj5Obmpvbt22ddgMi23N3dNXjwYLvpBgCQ1bg/AQDw4JgM3i2RLmvWrFGjRo3k4eGhNm3ayNvbW4sWLdKRI0f04Ycf6q233srqEAEAAAAA2RCJdwZs2bJFgwcP1qZNm5SUlKTy5cvrzTff1IsvvpjVoQEAAAAAsikSbwAAAAAAHIg53gAAAAAAOBCJNwAAAAAADkTiDQAAAACAA5F4AwAAAADgQCTewH1geUYhzyoEAAAAcDsSb+A+MJlMMgxDJpNJp0+fltlszuqQAAAAAGQTLlkdAPCwS05O1saNGzV9+nQdOHBATk5O8vT0VGhoqFq0aKEaNWpkdYgAAAAAshDv8Qbu0Ycffqjhw4fr8uXLCg4OlouLi/bv329dHhISou7du6tNmzbKnz9/FkYK4HFnGZkDAAAeLBJv4B7ExsaqfPnyqlSpkmbOnCk3Nzfly5dPp0+f1o8//qiFCxdq7dq1kqR69epp3LhxqlSpUtYGDeCxkZCQoKNHj6pIkSLy9PTM6nAAAHhskXgD92DQoEGaNm2avvnmG9WvX1+SfY/Szp079eGHH2r+/PkqWrSo5syZo8qVK2dVyAAeI2PGjNGiRYvUokULVatWTaVKlVK+fPnk7Oyc5jpxcXHKlSuXXFyYjQYAwP1C4g3cg5YtW2r79u1as2aNihQpouTkZLm4uMgwDJnNZps/bj/++GO98cYb6tChg2bMmJGFUQN4XBQqVEgnT56Us7OzfH19VaNGDUVERCgsLEzFixeXn5+fTf2rV69qyJAhOnfunL788ks5OfEMVgAA7ge+zgbuQcWKFfX999/rypUrkmTtITKZTNak29ID/vrrr2vDhg1avXq1Dh06pOLFi2dZ3AAefQcOHFB8fLyqV6+udu3aacWKFdq8ebOWLFmiIkWKqE6dOmrQoIEqVqyowMBA5cqVS7t27dIXX3yhOnXqkHQDAHAfkXgD96Bu3bqSpJdeekkTJkxQrVq15ObmZlcvJSVFzs7OKlWqlJYuXWpN1AHAUQ4cOKDr168rIiJCvXr10rPPPqv9+/dr8+bNWr16tRYtWqQ5c+aoTJkyqlevnho3bqxVq1bp0qVL6tatW1aHDwDAI4Wh5sA9SElJUVRUlD766COFhISoV69eatWqlfLly2dX98KFC+rXr5+WLl2q//77LwuiBfA4WbhwoSIjIzV37lxFRkZay5OSknTkyBHt2LFDGzZs0Nq1a7V37165urrKMAy5u7vr/PnzWRg5AACPHhJv4D6YNm2axo8fr0OHDqlgwYJ64YUX1KRJExUuXFjOzs7KlSuXJk+erEmTJqlnz56aMGFCVocM4BFnGIb27dsnDw8PBQUFpfoqsatXr+rAgQPav3+/ZsyYoRUrVqh379763//+l0VRAwDwaCLxBu4DwzD077//6osvvtDcuXN1/PhxSVJAQIBcXV116tQpmc1mtW3bVmPHjlWhQoWyOGIAj7PUkvC+fftqypQp+vvvv1WxYsUsigwAgEcTiTdwn129elVbtmzRjz/+qJMnT+q///6Tj4+PIiMj1bJlS3l4eGR1iAAgSTKbzXJyctLhw4fVvHlzXbhwQUePHs3qsAAAeOTwcDXgPvPy8lLdunVVt25dJSUlydXVNatDAoBUWZ5cfuLECSUlJalnz55ZHBEAAI8merwBAHjMGYah48ePK0+ePPLy8srqcAAAeOSQeAMAAAAA4EBOWR0AAAAAAACPMhJvAAAAAAAciMQbAAAAAAAHIvEGAAAAAMCBSLwBAAAAAHAgEm8AAAAAAByIxBsAAAAAAAci8QYAAAAAwIFIvAEAAAAAcKD/B4drJvH0iFRQAAAAAElFTkSuQmCC", + "text/plain": [ + "
" + ] + }, + "execution_count": 10, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram(\n", + " [midcirc_count1, midcirc_count2],\n", + " legend=[\"x(0); meas(0, 0)\", \"x(0); meas(0, 0); x(0); meas(0, 1)\"],\n", + " title=\"Mid-circuit measurement (single qubit operation)\",\n", + ")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now that we understand what mid-circuit measurement does, let's try mid-circuit measurement using an H-gate." + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAWMAAACuCAYAAADjw2w/AAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8o6BhiAAAACXBIWXMAAA9hAAAPYQGoP6dpAAAWH0lEQVR4nO3de1hUdf4H8PcZhgG5KSKKiICsaAKK97sZrheUSitv/ShtddPsZ7nSD/Vxn83VXC112dJ0pU3DLDfdMmUVMXvQTF0wcEnzhq15ARkN17iKMDPn90cP84jMIDMc5nxner+ex6e5nPM9n+l8ec8533MZSZZlGUREpCqN2gUQERHDmIhICAxjIiIBMIyJiATAMCYiEgDDmIhIAAxjIiIBMIyJiATAMCYiEgDDmIhIAAxjIiIBMIyJiATAMCYiEgDDmIhIAAxjIiIBMIyJiATAMCYiEgDDmIhIAAxjIiIBMIyJiATAMCYiEgDDmIhIAAxjIiIBMIyJiATAMCYiEgDDmIhIAAxjIiIBMIyJiATAMCYiEgDDmIhIAAxjIiIBMIyJiATAMCYiEgDDmIhIAAxjIiIBMIyJiATAMCYiEoBW7QJcmSwDNUa1q7CNzg2QJOXak2UZVVVVyjXoAF5eXpAU+p8gyzKqTM7VCbw0bop9fsD5+oCS698WDOMWVGMEFu9UuwrbvDUN8FCwV1RVVcHHx0e5Bh2goqIC3t7eirRVZTLCP+uQIm05yp1RY+DtplwncLY+oOT6twWHKYiIBMAwJiISAMOYiEgADGMiIgEwjImIBMAwJiISAMOYiEgADGMiIgEwjImIBMAwJiISAMOYfnFCQ0PVLoFU5OHhgfbt26tdRgO8NwUJT6PRoE+fPujXrx/69euHLl26wNPTEwaDAbdv38apU6eQl5eHnJwclJaWNtrW8uXLsXDhQsTHx+PEiRMO+gTUXF5eXhgwYIC5DwQFBUGn0+HevXsoLCxEXl4e8vLykJubi5qaGqvteHh4YM+ePQgPD0dcXBz0er0DP0XjGMYkrPbt22P27NmYO3cuwsLCrE43efJkAEB1dTV27dqFTZs2IScnp8F0y5cvx+uvvw4AOHDgACIjI3Hr1q2WKZ4UERUVhXnz5mHGjBnw8/OzOt3MmTMBAD/++CO2bNmC1NRUXLlypd40dUEcHx8PAEhPT8fAgQNbrHZbudwwRUlJCRYtWoSuXbvC09MTnTt3xoIFC1BZWYnZs2dDkiS8++67apdJjdBqtfjDH/6Aa9euYdWqVY0G8f08PT0xY8YMZGdn49ChQ/Xmuz+IAWDp0qUMYoEFBARgx44dOHv2LObPn99oEN8vMDAQS5YswX/+8x9s3LjRfPe1B4O4vLwcCxcubLH67eFSYZyfn4+ePXti7dq10Ov1iIqKQm1tLdavX49p06bh/PnzAIDevXurW6iNCs8dwTvPScjbv87qNO88J2HvuscdWFXLiImJQU5ODlasWAEPDw8AgMlkwv79+7FgwQIMHz4c/v7+0Ol08PLywiOPPILExES8++67uH37trmd0aNH47vvvsPcuXMbBPH8+fOxceNGh3+25jBuTUPt2AkwZX7R4D1ZlmH4v8WoTXgS8g9XHF+cwp588kmcPXsWzz77rPm1yspKfPDBB5g9ezZiY2Ph4+MDd3d3+Pn5YcCAAXjppZfwySefmIcoNBoNXn75ZZw+fRqjR49uEMTjx4/H8ePHVfl81rjMMEVJSQmeeOIJ6PV6vPbaa1i2bBl8fX0BAGvWrMHixYuh1WohSRJ69eqlcrVkyciRI/HPf/7TvN4MBgM2bNiA9evXN9jlBIDa2lpcvHgRFy9exI4dO5CcnIzp06dj+fLlCA0NhY+PDzZv3lxvHmcMYgDQPJ8IU3YOjKl/g9SvL6TAdub3TLv3QD59BppZL0DqEq5ekQpYsGAB3n77bfPz//73v1ixYgXS0tIsHg8oLy9Hbm4ucnNzkZqaivbt22POnDlYsmQJvL29ERERgYMHD0Kj0ZinFzGIARfaMn711VdRWFiI+fPnY926deY/aABYtGgRYmNjYTAYEB4e3uRdHnKcYcOGISMjw7zezpw5g8GDByMpKcliEFtSXV2NtLQ0xMTE4L333mvwvrMGMQBI7u7QJr8GVFfDmPK2+XX5eiFMaR9CeqQ7NFOeUa9ABbzyyiv1gnjv3r2Ijo7GO++889ADs3Vu3bqFlStXolevXjh69CgAmIP47t27wgYx4CJhfP78eezcuRPt2rXD6tWrLU7Tr18/AEBsbKwjS6Mm6NChA/bu3QsvLy8AwL59+zBw4EDk5eXZ1V55ebnFo+TV1dXNqlNtUmRXaKZPhZx3Cqb9ByAbjTCuWQfIMtySX4Pk5qZ2iXYbNWoU1q9fb36+bNkyTJo0ye6zHYqKinD37t16r2m1WpSVlTWrzpbkEmH897//HSaTCYmJiVZ/3qVVq1YAnDuMDTVVuFteYvGfM9u8eTMCAgIAAAcPHsQzzzzTrOB8cIy4TkpKCjp37mx3uyLQJD4LRETA+Lf3Ydq4GfLFAmhemAGpc4japdnNx8cHW7ZsMT9/4403sGLFCrvbqztYN27cOAAwjyO7u7sjLS0NWq2Yo7MuEcZZWVkAgLi4OKvTFBYWAnDuMM7+bBnemxdo8Z+zmjp1KiZNmgQAuHnzJhITExs9T/RhLB2s27p1KwDAz88PqampzapXbZJWC21yElBTC9O+/ZBioqF5epLaZTXL6tWrER4eDgA4fPgwli1bZndbls6aGDduHL777jsAQN++fZGcnNzsmluCmF8RNrp69SoAWD0FymAwmMeJmhPG/fv3t2m3yc29FZ5aecnu5T0oJm4OIgdNsfje52+OUWQZ3SIjYay9+/AJm8hkMjX6/tKlS82P582bV++MCFtZO2uidevWGDt2LEJCQjB+/Hj07t0b+fn5VtuJjIw0jzM2l6zTAakKj1N7ewPu7oDBAGlAf0gK1VqnW2Q3SM34QnxQY30gMDAQL774IoCffwh01qxZkGXZruVYCuK6MeIXXngB2dnZ0Gq1SEpKQkpKCu7du2exneau/6CgIOTm5to8n0uEcWVlJQA0GCOqs3PnTpSUlMDX1xddunSxezl6vR5FRUVNnl7r4WX3sixpExSJ0JjRirb5oBvFN2C455ifVR86dKj5yzE7Oxuff/653W01dvpaaWkpVq5caT6zYt68eZg7d67VtoqLi+2uowFPD7gr1xpkWYbxz38BDLVAaGeYdnwCzchHIQV3VGwZN4pvANWWg0pps2bNMp/C+Ne//rXJB2sf1FgQA0BeXh527tyJxMREtGvXDlOmTMFHH31ksS1F178NXCKMg4KCcOfOHZw6dQpDhgyp915xcbF5t6RXr16QJKlZy7GFm3sru5elluCOwYpvGVvr3HPmzDE/bs5ZDk05j/jjjz/GmjVr4Ofnh8TERCQlJZm/xB/UsWNHRbeMf1SkpZ+Z9qRD/vY0NL+ZCc2QwTD87ysw/vkvcFv3VrP69v2COwYrvmX8sD5gMpkanIbYVA8L4jqbNm1CYmKiebnWwri569/WnKjjEmE8evRonD9/Hm+99RbGjBmDbt26AQC++eYbPP/88ygp+fkAV3Mv9rB11+OeAVi8s1mLdLiCS5fgoWCvqKystHpQdcSIEeZp/vGPf9jVflMv6KioqMCnn36KWbNmwdvbG3369MGxY8cstnnp0iXzlVvNVWk0wD/rkCJtyUVFMG1Ng9S9GzRTJ0Nyc4PmuUSYPtgG0550uD01UZHlFFwqgLebcp3AWh8IDg5GREQEAODo0aO4fPmyzW03NYgB4MSJEygoKEC3bt0waNAg6HQ6i8cnlFz/tnCJA3iLFi1CQEAArl+/jujoaPTs2RORkZEYOHAgIiIiMGrUKADOffDO1fj7+5v/EPPz862O3zXG1ivrsrOzzY/rTnV0FrLJBOPaFMBkgltykvk0Ns3UyZC6RcK0NQ3yDXV2r+11/zq4f900lS1BXKfuniU6nQ4xMTE2L7MluUQYh4SE4Ouvv0ZCQgI8PT1x5coVtG3bFqmpqdi/fz8KCgoAMIxFcv+6sOd8Ynsucb5/z6Zv3742L1NNpk93Qz53HpqZz0G67xagkpsb3P4vCTAZYfzzX+w++KWGPn36mB/b2gfsCWJA7D7gEsMUANCjRw/s27evwesVFRW4cuUKNBqNcN+Ev2R15xUDwLVr12ya1957TVy/ft382N/f36Zlqkm+dg2mbdsh9XgEmmeebvC+FB7WIsMVLa1t27bmx7b0AXuDGBC7D0iyM32V2iEnJweDBw9G9+7dceHCBYcu2xnHjN+aBoeMGbdr1w7R0dHw9PREQUEBfvjhhya1FxAQgNOnTyM4OBiAbZc4a7VajB07FtXV1dDr9Th37pzF6SoqKoQcM3aUO6PGOGTMOCIiAmFhYfD09MSJEyeafMnz8OHDkZWVBXd3d5vvNdGhQwf06dMH1dXV+P77783XH9xPyfVvC5fZMrbmzJkzADhEIZqSkhJ89dVXNs93+/ZtxMXFISsrC6tXr7bpLAyDwYCMjAybl0kt4/Lly3YdtDt27BgmT56MrVu3YuLEiTbda+LmzZvIzMy0eZmOwDAmp1NQUIAePXqgvLxc7VJIJenp6ejSpYtL9QGXOIDXGIaxa3KlP0Kyj6v1AZffMq67bwURkchcfsuYiMgZMIyJiATAMCYiEgDDmIhIAAxjIiIBMIyJiATAMCYiEgDDmIhIAAxjIiIBMIyJiATAMCYiEoDL389YTbIM1BjVrsI2OjdAod+1BPDzrxlXVSn3a9NrUz9BWWUV/Ly9kDx3eoPnSvDy8lLsxz1lWUaVybk6gZfGTbHPDyjbByytb6X7gJLr3xYuf6MgNUmSsjdqd0aSJCl6o26dhyd0tUboPDzh7e3d4LloJElS9EbtzkjJPmBpfYveB5qKwxRERAJgGBMRCYBhTEQkAIYxEZEAGMZERAJgGBMRCYBhTEQkAIYxEZEAGMZERAJgGBMRCYBhTEQkAIYxEZEAGMZERAJgGBMRCYBhTEQkAIYxEZEAGMZERAJgGBMRCYBhTEQkAIYxEZEAGMZERAJgGCto7dq1GDJkCPz9/dGmTRsMHz4cmZmZapdFD5GRkYHevXvDw8MD4eHhSElJUbskcqCjR49i4sSJCAsLgyRJWLlypSp1MIwVlJWVhVmzZuHw4cM4efIkhg4discffxzHjx9XuzSyIjc3FxMnTsT48eORn5+PP/7xj1i6dCk2b96sdmnkIBUVFYiKisKaNWsQFBSkWh1a1Zbsgg4cOFDv+Zo1a5CZmYndu3dj2LBhKlVFjUlJScGAAQOwevVqAECPHj1w9uxZvPnmm3jppZdUro4cYcKECZgwYQIAYPHixarVwS3jFmQymVBWVgZvb2+1SyErjh8/jvj4+HqvxcfH4+rVqygsLFSpKvol4pZxC1q1ahV++uknzJkzR+1SnM7NkjsoLa9s8LrBaDT/t+CHwgbP62gkCb8KC4YkSY0up7i4uMGuad3z4uJihISENOtzkP2uFupxr9ZQ7zVL69taH/Bq5YGQoEAHVdt8DOMWsmnTJqxatQrp6en8g7aDLMvY9lkmjEaTxfer7lZj664Mq8/jhvRG1/BOLV4ntZxbt3/CZ5lHLb734Pq29NpvJsc/OJvQOEzRAtatW4fk5GSkp6dj9OjRapfjlIIC22LciAF2zRvcIQC/HtavSdN27NgRer2+3ms3b940v0fq6d+rO3p0DbVr3kG9e6D7r+ybVy0MY4W9/vrrWL58OTIyMhjEzTR8QE906WxbIGrd3DAtIQ5aN7cmTT9s2DAcPHiw3muZmZkICwvjHo3KJEnC0/GPwtvL06b5Avz9kBA3uIWqajkMYwX97ne/w9q1a7F9+3Z0794der0eer0epaWlapfmlDQaDaYkPAYPnXuT5xk3cgA6BLZt8vQLFy7EyZMn8fvf/x4XLlzAtm3bsGHDBixZssSekklhvt5eeDr+0SZPL0kSpiXEQWdDn6moqEB+fj7y8/NRU1MDvV6P/Px8fP/99/aUbDdJlmXZoUt0YdYOFs2cORNpaWmOLcaF5J65iE8zvnrodBGhwfjt9ARoHnLQ7kH79+/H0qVLceHCBQQFBWHBggVISkqyt1xqAZ9mfIXcMxcfOt2ooX0xdkR/m9o+cuQI4uLiGrw+cuRIHDlyxKa2moNhTMKTZRkf7TmEswVXrE7joXPHwtlT0MbPx3GFkcNU36vBOx98hjul5Van6RTUDi8/Nwlubs65w++cVbuAy9duwGAwql2GU5AkCU+NGwEf71ZWp5k0djiD2IV5eugwNeExWNvn0Wp/PlbgrEEMMIxVcae0HFt2ZmDte5+gouqu2uU4BR+vVnjGythhz+5d0Duqq4MrIkfr0rkjHh0Ua/G98SMHoX07fwdXpCyXDGOj0Yjt27dj7NixCAwMhIeHB0JDQxEfH4/3338fRqO6W6RHsvNhNJkQ2LYNfLysb+1RfT26hmFg7CP1XvP18cKkcSMeenEHuYYxw/sj6IEDtF3DOmFIv2iVKlKOy4VxWVkZxowZgxkzZuDQoUPQ6XSIjY2FyWTCF198gRdffBHl5dbHnVrandJy5J7++UDEr4f1Va0OZ5UwagjatvE1P58c/yi8W9l26hM5L63WDdOfGGUejvD00GHKhJE2H7QVkcuF8ezZs3H48GGEhIQgKysLRUVFOHnyJAoLC1FcXIw//elPcHdv+mkvSqvbKu4a1snmc2jp5wN10xLiIEkSBveJcroT+6n57r8gaNLY4WjtIscKXOpsiry8PPTv3x9arRb//ve/ERMTo2j7G7btRnmF/WO8JpPJPEbs1cqzyRcmUEM1tbXQuWsBq4d0yLXJqKk1QKfihpU1vj6t8MrMp22ez6XuTbFnzx4AQEJCguJBDADlFXdRVtHw5jX2qLpbrUg7v2TV92rULoFU5kp9wKXC+Ny5cwCAIUOGtEj7vj72H2zjVjHRL4O9OeFSYVxWVgYAaN26dYu0b8+uR53PD36NnPzz6BrWCb+dnqBgVUTkClwqjP38/ACgxe4FYe+Y8f1bxTdu3caqjR8rXRoRCYJjxgCio6Oxe/du/Otf/2qR9pUYM+ZYMRFZ4lJh/NRTT+GNN95ARkYGzp07h6ioKEXbt2csiGPFRL8s9o4Zu9SpbQAwbdo07Nq1C6Ghofjwww8xcuRI83s3b97E1q1b8eqrrzrsd+k4VkxETeFyYVxWVoaJEyeab33XqVMnBAcHo7i4GEVFRZBlGXfu3EGbNm1avJY7peVY995OGE0mzP2fJ3iRBxFZ5XJX4Pn5+eHLL7/Eli1b8Nhjj6GqqgrffvstNBoNxo0bhy1btsDX1/fhDSmAV9sRUVO53JaxSL48loevvzmNFybHM4yJqFEM4xZWfa8Gnh46tcsgIsExjImIBOByY8ZERM6IYUxEJACGMRGRABjGREQCYBgTEQmAYUxEJACGMRGRABjGREQCYBgTEQmAYUxEJACGMRGRABjGREQCYBgTEQmAYUxEJACGMRGRABjGREQCYBgTEQmAYUxEJACGMRGRABjGREQCYBgTEQmAYUxEJACGMRGRABjGREQCYBgTEQmAYUxEJACGMRGRABjGREQCYBgTEQmAYUxEJACGMRGRABjGREQCYBgTEQmAYUxEJACGMRGRABjGREQCYBgTEQmAYUxEJACGMRGRAP4fR3iO5nmh7WoAAAAASUVORK5CYII=", + "text/plain": [ + "
" + ] + }, + "execution_count": 11, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qc_midcirc = QuantumCircuit(1, 2)\n", + "\n", + "qc_midcirc.h(0)\n", + "qc_midcirc.measure(0, 0)\n", + "qc_midcirc.x(0)\n", + "qc_midcirc.measure(0, 1)\n", + "\n", + "qc_midcirc.draw(output=\"mpl\", idle_wires=False)" + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "metadata": {}, + "outputs": [], + "source": [ + "qc_midcirc_transpiled = transpile(qc_midcirc, backend)" + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: cg7r18n91ascc92533gg\n", + "Job Status: job has successfully run\n", + "Measurement 1 results: {'1': 4, '0': 6}\n", + "Measurement 2 results: {'0': 4, '1': 6}\n" + ] + } + ], + "source": [ + "midcirc_job = backend.run(qc_midcirc_transpiled, shots=10, dynamic=True)\n", + "print(f\"Runtime job id: {midcirc_job.job_id()}\")\n", + "job_monitor(midcirc_job)\n", + "\n", + "midcirc_count1 = marginal_counts(midcirc_job.result(), indices=[0]).get_counts()\n", + "midcirc_count2 = marginal_counts(midcirc_job.result(), indices=[1]).get_counts()\n", + "\n", + "print(f\"Measurement 1 results: {midcirc_count1}\")\n", + "print(f\"Measurement 2 results: {midcirc_count2}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We ran `qc_midcirc_transpiled` 10 times (i.e., `shots=10`). Ideally, the first measurement would have $1$ as its outcome for $5/10$ of the shots and $0$ for the remaining 5 shots.\n", + "\n", + "On average we can't tell from the histogram results that the mid-circuit measurements were correlated or not. This is why we need to look at `get_memory` to verify that $0$ is always followed by $1$ and vice-versa (up to gate/measurement errors). The `get_memory(experiment)` function returns a list containing each individual shot's measurement outcomes." + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "['01', '10', '01', '01', '10', '10', '10', '01', '10', '10']" + ] + }, + "execution_count": 14, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "midcirc_job.result().get_memory(qc_midcirc)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "For each shot, the first bit shows the result of the first measurement and the second bit shows the result of the second measurement outcome.\n", + "\n", + "Now, run the circuit with `shots=1000`." + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: cg7r1d214ejq4casnf90\n", + "Job Status: job has successfully run\n", + "Measurement 1 results: {'0': 506, '1': 494}\n", + "Measurement 2 results: {'0': 454, '1': 546}\n" + ] + } + ], + "source": [ + "midcirc_job = backend.run(qc_midcirc_transpiled, shots=1000, dynamic=True)\n", + "print(f\"Runtime job id: {midcirc_job.job_id()}\")\n", + "job_monitor(midcirc_job)\n", + "\n", + "midcirc_count1 = marginal_counts(midcirc_job.result(), indices=[0]).get_counts()\n", + "midcirc_count2 = marginal_counts(midcirc_job.result(), indices=[1]).get_counts()\n", + "\n", + "print(f\"Measurement 1 results: {midcirc_count1}\")\n", + "print(f\"Measurement 2 results: {midcirc_count2}\")" + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAA9MAAAHHCAYAAAC81QvhAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8o6BhiAAAACXBIWXMAAA9hAAAPYQGoP6dpAAB0hElEQVR4nO3dd3xO5+P/8fedIYnIQGJHQopY/ZhVlIhNjA6N0WHUaFG0tVuz9qxRrVYb3WarrdorWqNUKWrF3iVBSKyM8/vDL/fX7U7ICZHg9Xw88ni4r3Odc67rnPs+7vd9nWExDMMQAAAAAABIM4fMbgAAAAAAAI8awjQAAAAAACYRpgEAAAAAMIkwDQAAAACASYRpAAAAAABMIkwDAAAAAGASYRoAAAAAAJMI0wAAAAAAmESYBgAAAADAJMI0shyLxaKhQ4fes97QoUNlsVge2HoDAgLUrl27B7a8tDp69KgsFotmz5790NeNR8+4ceMUFBSkpKSkNM+zbt06WSwWrVu3LuMaJqldu3YKCAjI0HXcr3bt2ilHjhxpqpvWY9GT5mG8n6Kjo+Xu7q4lS5Zk2DoAALhfhGlkiNmzZ8tischiseiPP/6wm24Yhvz8/GSxWNSkSZNMaGHWtmTJEr7EP+ZOnz6toUOHaseOHWme5/Llyxo7dqz69esnBwcO3w/bxo0bNXToUF26dCmzm/JQzJgxI9N+5MudO7c6duyoQYMGZcr6AQBIC6fMbgAeb66urvr+++/13HPP2ZRHRETo5MmTcnFxsZvn2rVrcnJ6+G/N/fv3Z0pA8ff317Vr1+Ts7GwtW7JkiT7++GMC9WPs9OnTGjZsmAICAlSuXLk0zfPll18qISFBrVu3NrWumjVr6tq1a8qWLVs6WvrkuvNYtHHjRg0bNkzt2rWTt7d35jXsIZkxY4Z8fHzszth5WO+nN998U1OnTtWaNWtUu3btDF0XAADpwdAGMlTjxo01f/58JSQk2JR///33qlixovLly2c3j6ura6aEaRcXF5tAm5K4uLgHvl6LxSJXV1c5Ojo+8GU/rpKSknT9+vXMbsZDFx4ermbNmsnV1dXUfA4ODnJ1dWU026TMOhZlBMMwdO3atQeyrIf1fipZsqTKlCnDJTAAgCyLb1bIUK1bt1Z0dLRWrlxpLbt586YWLFigNm3apDhPStcp/vHHH6pcubJcXV0VGBiomTNnmmpHUlKSpkyZorJly8rV1VW+vr5q2LCh/vrrL2udO6+ZTj5VPSIiQl27dlWePHlUqFAh6/SlS5cqODhYHh4e8vT0VOXKlfX999+nurxktWrVUq1atayv77xmul27dvr444+t2yL5724CAgLUpEkTrVu3TpUqVZKbm5vKli1rvabxxx9/tPa9YsWK2r59u90y9u3bpxYtWihXrlxydXVVpUqV9Msvv9jUuXDhgnr37q2yZcsqR44c8vT0VKNGjfTPP//YLW/atGkqXbq0smfPrpw5c6pSpUo22ye162tTuhbeYrGoe/fu+u6771S6dGm5uLho2bJlkqRTp06pQ4cOyps3r1xcXFS6dGl9+eWXNvMnX+M5b948DRs2TAULFpSHh4datGihmJgY3bhxQ7169VKePHmUI0cOtW/fXjdu3LBr27fffquKFSvKzc1NuXLlUqtWrXTixAmbOrVq1VKZMmW0Z88ehYSEKHv27CpYsKDGjRtn057KlStLktq3b2/dx3cLDUeOHNHOnTtVt25du2lz5sxRxYoVre/FsmXLasqUKXb9v/0a17S0M9mxY8fUrFkzubu7K0+ePHrnnXe0fPnyNF03m5SUpI8++kilS5eWq6ur8ubNqy5duujixYt3nS/ZokWLVKZMGbm6uqpMmTL66aef7N47qV3De7f7ERw+fFgNGjSQu7u7ChQooOHDh8swDJs6tx+Lhg4dqj59+kiSihQpYt1nR48evWv758+fb33P+Pj46NVXX9WpU6ds6iRfx52WNqV1eyYfE5YvX249JiQfN8PDw1W7dm3lyZNHLi4uKlWqlD755BO7+f/9919FRERY+5p83Epte5vp66lTp/T8888rR44c8vX1Ve/evZWYmGi3/erVq6dff/3VbjsAAJAVPB4/uSPLCggIUNWqVfXDDz+oUaNGkm6F0JiYGLVq1UpTp0695zJ27dql+vXry9fXV0OHDlVCQoKGDBmivHnzprkdb7zxhmbPnq1GjRqpY8eOSkhI0O+//67NmzerUqVKd523a9eu8vX11eDBg60j07Nnz1aHDh1UunRpDRgwQN7e3tq+fbuWLVuW6o8EadWlSxedPn1aK1eu1DfffJPm+Q4ePKg2bdqoS5cuevXVVzVhwgQ1bdpUn376qQYOHKiuXbtKkkaPHq2wsDCb09r//fdfVa9eXQULFlT//v3l7u6uefPm6fnnn9fChQv1wgsvSLoVQBYtWqSXX35ZRYoU0X///aeZM2cqODhYe/bsUYECBSRJn3/+uXr06KEWLVqoZ8+eun79unbu3Kk///wz3dtnzZo1mjdvnrp37y4fHx8FBATov//+07PPPmsN276+vlq6dKneeOMNXb58Wb169bJZxujRo+Xm5qb+/fvr4MGDmjZtmpydneXg4KCLFy9q6NCh2rx5s2bPnq0iRYpo8ODB1nlHjhypQYMGKSwsTB07dtT58+c1bdo01axZU9u3b7c57ffixYtq2LChXnzxRYWFhWnBggXq16+fypYtq0aNGqlkyZIaPny4Bg8erM6dO6tGjRqSpGrVqqXa/40bN0qSKlSoYFO+cuVKtW7dWnXq1NHYsWMlSXv37tWGDRvUs2fPu27Te7VTunU2Ru3atXXmzBn17NlT+fLl0/fff6+1a9fefYf9f126dNHs2bPVvn179ejRQ0eOHNH06dO1fft2bdiw4a5ng6xYsUIvvfSSSpUqpdGjRys6Olrt27e3+VErPRITE9WwYUM9++yzGjdunJYtW6YhQ4YoISFBw4cPT3GeF198UQcOHNAPP/ygyZMny8fHR5Lk6+ub6nqS+125cmWNHj1a//33n6ZMmaINGzbYvWfS2iYz23P//v1q3bq1unTpok6dOqlEiRKSpE8++USlS5dWs2bN5OTkpF9//VVdu3ZVUlKSunXrJkn66KOP9PbbbytHjhx6//33Jemux1yzfW3QoIGqVKmiCRMmaNWqVZo4caICAwP11ltv2Sy3YsWKmjx5sv7991+VKVMm1fUDAJApDCADhIeHG5KMrVu3GtOnTzc8PDyMq1evGoZhGC+//LIREhJiGIZh+Pv7G6GhoTbzSjKGDBliff38888brq6uxrFjx6xle/bsMRwdHY20vIXXrFljSDJ69OhhNy0pKcn6b39/f6Nt27Z2fXjuueeMhIQEa/mlS5cMDw8Po0qVKsa1a9fSvLxkwcHBRnBwsPX1kSNHDElGeHi4taxbt25p6tvt65JkbNy40Vq2fPlyQ5Lh5uZms+1mzpxpSDLWrl1rLatTp45RtmxZ4/r16zZ9qVatmlGsWDFr2fXr143ExESbdR85csRwcXExhg8fbi1r3ry5Ubp06bu2uW3btoa/v79d+ZAhQ+z6LslwcHAw/v33X5vyN954w8ifP78RFRVlU96qVSvDy8vL+p5bu3atIckoU6aMcfPmTWu91q1bGxaLxWjUqJHN/FWrVrVp29GjRw1HR0dj5MiRNvV27dplODk52ZQHBwcbkoyvv/7aWnbjxg0jX758xksvvWQt27p1q91+v5sPPvjAkGRcuXLFprxnz56Gp6enzXv0Tsn9v32fp7WdEydONCQZixYtspZdu3bNCAoKslvmnfv0999/NyQZ3333nU17li1blmL5ncqVK2fkz5/fuHTpkrVsxYoVhiSb9aTUP8NI+bPVtm1bQ5Lx9ttvW8uSkpKM0NBQI1u2bMb58+et5Xcei8aPH29IMo4cOXLXdhuGYdy8edPIkyePUaZMGZvjxOLFiw1JxuDBg023ycz2TD4mLFu2zK5tyZ+L2zVo0MAoWrSoTVnp0qVtjlXJ7tze6enr7ccLwzCM8uXLGxUrVrRb18aNGw1Jxty5c+2mAQCQ2TjNGxkuLCxM165d0+LFi3XlyhUtXrw4zaOTiYmJWr58uZ5//nkVLlzYWl6yZEk1aNAgTctYuHChLBaLhgwZYjctLY/W6tSpk831zCtXrtSVK1fUv39/u2tXH+SjuswqVaqUqlatan1dpUoVSVLt2rVttl1y+eHDhyXdOnV7zZo1CgsL05UrVxQVFaWoqChFR0erQYMGioyMtJ6q6eLiYh3NTkxMVHR0tHLkyKESJUro77//tq7D29tbJ0+e1NatWx9Y/4KDg1WqVCnra8MwtHDhQjVt2lSGYVjbHRUVpQYNGigmJsamTZL0+uuv24zcValSRYZhqEOHDjb1qlSpohMnTliv9f/xxx+VlJSksLAwm/Xky5dPxYoVsxulzZEjh1599VXr62zZsumZZ56xbvP0iI6OlpOTk91jnby9vRUXF2dzKUVapaWdy5YtU8GCBdWsWTNrmaurqzp16nTP5c+fP19eXl6qV6+ezXarWLGicuTIcdfR7TNnzmjHjh1q27atvLy8rOX16tWzeR+kV/fu3a3/Tj6z4ebNm1q1atV9L1uS/vrrL507d05du3a1OU6EhoYqKChIv/32m+k2md2eRYoUSfE46ebmZv13TEyMoqKiFBwcrMOHDysmJuah9PXNN9+0eV2jRo0UPx85c+aUJEVFRZluFwAAGY3TvJHhfH19VbduXX3//fe6evWqEhMT1aJFizTNe/78eV27dk3FihWzm1aiRAmbZ5BeuHBBN2/etL52c3OTl5eXDh06pAIFCihXrlzpan+RIkVsXh86dEiSstwph7cHZknWAOLn55diefI1lgcPHpRhGBo0aFCqj6E5d+6cChYsaL32fMaMGTpy5IjNNY65c+e2/rtfv35atWqVnnnmGT311FOqX7++2rRpo+rVq6e7f3fuh/Pnz+vSpUv67LPP9Nlnn6Xa7tuZ2UZJSUmKiYlR7ty5FRkZKcMwUnwfSrI7VblQoUJ2P6zkzJlTO3fuTKV36de1a1fNmzdPjRo1UsGCBVW/fn2FhYWpYcOG95w3Le08duyYAgMD7eo99dRT91x+ZGSkYmJilCdPnhSn37l/bnfs2DFJSvWzf+cPJWY4ODioaNGiNmXFixeXpHteA51Wye1PPrX6dkFBQXaPDExLm8xuzzs/M8k2bNigIUOGaNOmTbp69arNtJiYGJsfL9LCbF+T71txu5w5c6Z4Hb3x/6+VzswfKgEASA1hGg9FmzZt1KlTJ509e1aNGjXKkMfKvPjii4qIiLC+btu27QO5C+ztozhmpPblLzExMUPu3J3aMlMrT/6SmpSUJEnq3bt3qqP9ycFp1KhRGjRokDp06KAPP/xQuXLlkoODg3r16mVdjnTrzIH9+/dr8eLFWrZsmRYuXKgZM2Zo8ODBGjZsmKS7b5+U3Lkfktf36quvqm3btinO8/TTT9u8vp9tZLFYtHTp0hTr3jlafK/lpUfu3LmVkJCgK1euyMPDw1qeJ08e7dixQ8uXL9fSpUu1dOlShYeH6/XXX9dXX31112VmRDtvl5SUpDx58ui7775Lcfrdrjc2w+x76VFldnumdOw6dOiQ6tSpo6CgIE2aNEl+fn7Kli2blixZosmTJ9t8jjOKmeNfcsBOvkYdAICshDCNh+KFF15Qly5dtHnzZs2dOzfN8/n6+srNzU2RkZF20/bv32/zeuLEiTYjG8k3wwoMDNTy5ct14cKFdI9O3y4wMFCStHv37ruOzuXMmVOXLl2yKz927JjdCNSdHuYoTHJbnJ2dU7xT9O0WLFigkJAQffHFFzblly5dsvuy6+7urpYtW6ply5a6efOmXnzxRY0cOVIDBgyQq6vrXbdPWvj6+srDw0OJiYn3bPf9CgwMlGEYKlKkiHW08H6Z3cdBQUGSbt3V+84fCbJly6amTZuqadOmSkpKUteuXTVz5kwNGjQoTSPId+Pv7689e/bIMAybNh88ePCe8wYGBmrVqlWqXr266R+l/P39JSlNn/3kU4HvfD+l9l5KSkrS4cOHbfblgQMHJCnFO8wnM7PPktu/f/9+u2ck79+/3zrdTJvuZ3sm+/XXX3Xjxg398ssvNmdqpHTKfVr7a7avZhw5ckTSrR/oAADIarhmGg9Fjhw59Mknn2jo0KFq2rRpmudzdHRUgwYNtGjRIh0/ftxavnfvXi1fvtymbsWKFVW3bl3rX/J1lS+99JIMw7COiN4uPSNw9evXl4eHh0aPHm33rOPblxcYGKjNmzfbnHq+ePFiu0cppcTd3V2SfTjICHny5FGtWrU0c+ZMnTlzxm76+fPnrf92dHS022bz58+3e/xNdHS0zets2bKpVKlSMgxD8fHxkm5tn5iYGJtTis+cOaOffvopTe12dHTUSy+9pIULF2r37t13bff9evHFF+Xo6Khhw4bZ9d8wDLv+poXZfZx8Pfztj3OT7Le1g4ODNWyn9Hgvsxo0aKBTp07ZPCbt+vXr+vzzz+85b1hYmBITE/Xhhx/aTUtISLhr3/Pnz69y5crpq6++srmOd+XKldqzZ49NXX9/fzk6Omr9+vU25TNmzEh1+dOnT7f+2zAMTZ8+Xc7OzqpTp06q85jZZ5UqVVKePHn06aef2uyHpUuXau/evQoNDTXdpvvZnsmSR4Vvfx/HxMQoPDzcrq67u3uG9TWttm3bJi8vL5UuXTrdywAAIKMwMo2HJrVTce9l2LBhWrZsmWrUqKGuXbsqISHB+gzjtFyDGhISotdee01Tp05VZGSkGjZsqKSkJP3+++8KCQmxuelPWnh6emry5Mnq2LGjKleurDZt2ihnzpz6559/dPXqVeuptR07dtSCBQvUsGFDhYWF6dChQ/r222+tI9t3U7FiRUlSjx491KBBAzk6OqpVq1am2mnGxx9/rOeee05ly5ZVp06dVLRoUf3333/atGmTTp48aX2OdJMmTTR8+HC1b99e1apV065du/Tdd9/ZjbTXr19f+fLlU/Xq1ZU3b17t3btX06dPV2hoqPUU5VatWqlfv3564YUX1KNHD129elWffPKJihcvnubrYceMGaO1a9eqSpUq6tSpk0qVKqULFy7o77//1qpVq3ThwoUHsn0CAwM1YsQIDRgwQEePHtXzzz8vDw8PHTlyRD/99JM6d+6s3r17m16mt7e3Pv30U3l4eMjd3V1VqlRJ9TrXokWLqkyZMlq1apXNDdM6duyoCxcuqHbt2ipUqJCOHTumadOmqVy5cg9kNK9Lly6aPn26WrdurZ49eyp//vz67rvvrDeautvoZXBwsLp06aLRo0drx44dql+/vpydnRUZGan58+drypQpd71/wujRoxUaGqrnnntOHTp00IULF6yf/djYWGs9Ly8vvfzyy5o2bZosFosCAwO1ePHiVK/JdnV11bJly9S2bVtVqVJFS5cu1W+//aaBAwfe9dTz5M/l+++/r1atWsnZ2VlNmza1huzbOTs7a+zYsWrfvr2Cg4PVunVr6+OiAgIC9M4775hu0/1uT+nWZzP5TIYuXbooNjZWn3/+ufLkyWP3Y1rFihX1ySefaMSIEXrqqaeUJ08eu5Hn9PTVjJUrV6pp06ZcMw0AyJoe5q3D8eS4/dFYd5OWR2MZhmFEREQYFStWNLJly2YULVrU+PTTT1N8hFJqEhISjPHjxxtBQUFGtmzZDF9fX6NRo0bGtm3bbNqS0qOxUuvDL7/8YlSrVs1wc3MzPD09jWeeecb44YcfbOpMnDjRKFiwoOHi4mJUr17d+Ouvv9L0aKyEhATj7bffNnx9fQ2LxXLPfqa0HQ3j1rbs1q2bTVny+saPH29TfujQIeP111838uXLZzg7OxsFCxY0mjRpYixYsMBa5/r168Z7771n5M+f33BzczOqV69ubNq0ya5PM2fONGrWrGnkzp3bcHFxMQIDA40+ffoYMTExNutcsWKFUaZMGSNbtmxGiRIljG+//TbVR2Pd2Y9k//33n9GtWzfDz8/PcHZ2NvLly2fUqVPH+Oyzz6x1kh/lM3/+fJt5U9vHyW24/TFJhmEYCxcuNJ577jnD3d3dcHd3N4KCgoxu3boZ+/fvt9YJDg5O8bFgKT0K7OeffzZKlSplODk5pekxWZMmTTJy5Mhh82ijBQsWGPXr1zfy5MljZMuWzShcuLDRpUsX48yZM3b9v/PRWGlt5+HDh43Q0FDDzc3N8PX1Nd577z1j4cKFhiRj8+bNd53XMAzjs88+MypWrGi4ubkZHh4eRtmyZY2+ffsap0+fvmt/DePWNi9ZsqTh4uJilCpVyvjxxx9TXM/58+eNl156yciePbuRM2dOo0uXLsbu3btTfDSWu7u7cejQIaN+/fpG9uzZjbx58xpDhgyxe+xbSseiDz/80ChYsKDh4OCQpsdkzZ071yhfvrzh4uJi5MqVy3jllVeMkydP2tQx06a0bs/UjgmGcevY9fTTTxuurq5GQECAMXbsWOPLL7+068/Zs2eN0NBQw8PDw5Bk/Yyn9igyM329U0qf+7179xqSjFWrVqXYDwAAMpvFMB7QnWYAABkqJiZGRYsW1bhx4/TGG29kals++ugjvfPOOzp58qQKFiz4UNfdrl07rVu37oHdeTuztWvXTgsWLLAZbYfUq1cvrV+/Xtu2bWNkGgCQJXHNNAA8Iry8vNS3b1+NHz/+odx1Odm1a9dsXl+/fl0zZ85UsWLFHnqQxpMhOjpas2bN0ogRIwjSAIAsK0uH6Z9++kn16tVT7ty55erqqiJFiqh169Z2N3C6fPmy3n33Xfn7+8vFxUUBAQHq06dPqr/yJyUladq0aSpbtqzc3Nzk6+ur1q1b6/Dhww+jWwCQbv369dO+ffvk4PDwDt8vvviiunTpok8++URjxoxRpUqVtG/fPg0dOvShtQFPlty5cys2NlaNGzfO7KYAAJCqLHkDMsMw9Oabb+qzzz5TYGCgWrVqJQ8PD50+fVoRERE6duyY/Pz8JElxcXEKDg623oyldevW2r59uyZMmKCIiAitX7/eeqOcZF26dNGsWbNUunRp9ejRQ6dPn9a8efO0YsUKbd68WcWKFcuMbgNAltSgQQPNmjVL3333nRITE1WqVCnNmTNHLVu2zOymAQAAZJosec30lClT1KtXL3Xt2lVTp061PsojWUJCgpycbv0OMGTIEA0fPlz9+vXTmDFjrHX69++vsWPHatSoURowYIC1fO3atapdu7Zq1qyplStXKlu2bJJuPcKjcePGql+/vt0jlwAAAAAAuF2WC9PXrl1TwYIFlTNnTu3fv98amlNiGIYKFSqky5cv6+zZszaPJ4mLi1O+fPmUJ08eHTp0yFrepk0b/fDDD4qIiFDNmjVtlhcSEqJ169bp2LFjKly48IPvHAAAAADgsZDlrplesWKFLl68qOeff16JiYn68ccfNWbMGH366ac6ePCgTd3IyEidPn1a1atXt3vOp7u7u6pXr67Dhw/bXGO9bt0667Q7NWjQQJIUERGRAT0DAAAAADwustw109u2bZMkOTo66umnn9aBAwes0xwcHPTOO+9owoQJkm6FaUmpXuNcrFgxLV++XJGRkfLz81NcXJzOnDmjMmXK2J06fvtykpebFklJSTp9+rQ8PDy44ygAAMhwhmHoypUrKlCgQIo3IzQMQ4mJiUpISMiE1gHAo8vZ2TnFnJiaLBemz507J0maNGmSKlSooC1btqhkyZLavn27OnfurIkTJyowMFBvvfWWYmJiJN16XExKPD09Jclaz2z9lNy4cUM3btywvj516pRKlSplposAAAD37cSJEypUqJD1tWEYunTpks6fP6/ExMRMbBkAPLq8vb2VL1++NA2UZrkwnfzs1GzZsmnRokUqUKCAJKlGjRqaP3++/ve//2nixIl66623MqV9o0eP1rBhw+zKZ82apezZs0uSChUqpP/973/6559/dPLkSWudYsWKqXjx4vrzzz8VFRVlLS9btqwKFy6siIgIm8d5PfPMM/L19dXy5cttfl2uUaOG3NzctGLFCps21K9fX9euXdPvv/9uLXNyclKDBg10/vx5bdmyxVqeI0cOBQcH6/jx49q1a5e13MfHR1WqVNGBAwdsRujpE32iT/SJPtEn+pQ1+rRmzRq98MIL8vDwsGnT2bNndenSJXl6esrT01NOTk6cNQcAaWQYhq5evWod3M2fP/8958lyNyDr06ePJkyYoBo1amj9+vV204sVK6aDBw/q4sWL2rBhg5o0aaLu3btr2rRpdnXffvttTZ8+XatXr1bt2rUVFxenHDlyqEyZMjb/mSVbuHChWrRooUGDBmn48OEptu/OkenLly/Lz89PUVFR1pFtBwcHOTo6KjEx0frjwO3lCQkJun2zOzo6ysHBIdXy+Ph4mzYk35TtztO3Uit3dnZWUlKSza/UFotFTk5OqZan1nb6RJ/oE32iT/SJPmVuny5cuKDcuXMrJibG+t0jMTFRkZGR8vHxkY+PjwAA6RMdHa1z586pePHi9zzlO8uNTJcoUULSreH1lCSXX7t27Z7XON95TbW7u7vy58+vI0eOKDEx0W7j3OsabElycXGRi4uLXbmzs7OcnZ1tyhwdHVPcAandoTy18juXm55yBweHFK+rSq08tbbTJ/pktpw+0SeJPqXWRrPl9Ik+SSm3PT4+XoZh2N2QFQBgTvLZxvHx8fcM01nubt4hISGSpL1799pNi4+P18GDB+Xu7i5fX18VK1ZMBQoU0IYNGxQXF2dT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NnVy586tjh07atCgQQ+zyVnK+++/r9atW8vf39+mfO/evWrYsKFy5MihXLly6bXXXtP58+fva12nTp1SWFiYvL295enpqebNm+vw4cM2dUqVKqXQ0FANHjz4vtZlxg8//KATJ06oe/fuNuU3btxQv379VKBAAbm5ualKlSpauXKlTR1nZ2e9++67GjlypK5fv/7Q2pyVDB8+XFWqVFH16tVtytOyv804c+aM+vfvr5CQEHl4eMhisWjdunV29TJqnzg9sCXhiXT9+nU5OjrKwcFBBQsW1A8//KCqVatq/vz5kqQePXpY6zZu3FiOjo5avHixOnbsqKlTp0qSIiMj5eLiooSEBBUoUEALFixQlSpVMqU/APAoO1RiaGY3AZIC9w/N7CbYyQrvjYe1XeLj4zVlyhS98847cnR0tJYnJSUpNDRU//zzj/r06SMfHx/NmDFDtWrV0rZt21SsWDFr3TfffFNTp07VmjVrVLt27YfS7qxix44dWrVqlTZu3GhTfvLkSdWsWVNeXl4aNWqUYmNjNWHCBO3atcs6km1WbGysQkJCFBMTo4EDB8rZ2VmTJ09WcHCwduzYody5c1vrvvnmm2rcuLEOHTqkwMDA++7nvYwfP16tWrWSl5eXTXm7du20YMEC9erVS8WKFdPs2bPVuHFjrV27Vs8995y1Xvv27dW/f399//336tChQ4a3Nys5f/68vvrqK3311Vc25Wb2d1rt379fY8eOVbFixVS2bFlt2rQp1boZsU8YmUa61a5dW++8847mzp2roUOHKjo6WjVq1NDp06etvzDd+Yumq6urzpw5I+nWr5uS9NVXX2nw4MGaOXOm4uLiVLNmTcXGxj7czgAAgMfC4sWLdf78eYWFhdmUL1iwQBs3btTs2bM1ZMgQdevWTevWrZOjo6OGDBliU7dkyZIqU6aMZs+e/RBbnjWEh4ercOHCevbZZ23KR40apbi4OK1Zs0Y9evTQwIEDNW/ePP3zzz/p3k4zZsxQZGSkFi9erL59++qdd97RihUrdObMGU2cONGmbt26dZUzZ067gJYRtm/frn/++cfuPbRlyxbNmTNHo0eP1vjx49W5c2etWbNG/v7+6tu3r01db29v1a9f/4l8D3377bdycnJS06ZNbcrN7O+0qlixoqKjo3XgwAG9++67d62bEfuEMI10Gzx4sCZNmqQWLVro/fff1+7du5WYmKiBAwemaf6kpCRJt66Dev/999WxY0dt2LBBN2/e1JQpUzKy6QAA4BF06dIltWvXTt7e3vLy8lL79u119epVmzqLFi1SQECA3ejlggULlDdvXr344ovWMl9fX4WFhennn3/WjRs3bOrXq1dPv/76qwzDsJbFx8dr37591oGBu2nXrp1y5Mih48ePq0mTJsqRI4cKFiyojz/+WJK0a9cu1a5dW+7u7vL399f333+fYn979eolPz8/ubi46KmnntLYsWOt36GSTZgwQdWqVVPu3Lnl5uamihUrasGCBXbLW7lypZ577jl5e3srR44cKlGihN33tkWLFql27dqyWCw25QsXLlSTJk1UuHBha1ndunVVvHhxzZs3757bIyULFixQ5cqVVblyZWtZUFCQ6tSpY7dMZ2dn1apVSz///LNN+dWrV7Vv3757Xk+/d+9eubm56fXXX7cp/+OPP+To6Kh+/fpZyxYtWqRs2bKpZs2adu11dHRU586drWWurq564403tGnTJp04ccKmfr169fTHH3/owoULNuX79u3T8ePH79pe6f/uFXDgwAG9+uqr8vLykq+vrwYNGiTDMHTixAk1b95cnp6eypcvX4qB9MaNGxoyZIieeuopubi4yM/PT3379rV7v4eHh6t27drKkyePXFxcVKpUKX3yySd2y/vrr7/UoEED+fj4yM3NTUWKFLEb5V20aJGqVKmiHDly2G2/tO7vtPLw8FCuXLnSXD+1fZJehGk8MP7+/sqePbv279+vokWLSpLdjSuuX7+u/PnzS5IKFSok6daBOFnJkiVlsVi0f//+h9RqAADwqAgLC9OVK1c0evRohYWFafbs2Ro2bJhNnY0bN6pChQp2827fvl0VKlSQg4Pt199nnnlGV69e1YEDB2zKK1asqEuXLunff/+1lp06dUolS5bUgAED0tTexMRENWrUSH5+fho3bpwCAgLUvXt3zZ49Ww0bNlSlSpU0duxYeXh46PXXX9eRI0es8169elXBwcH69ttv9frrr2vq1KmqXr26BgwYYDcCN2XKFJUvX17Dhw/XqFGj5OTkpJdfflm//fabtc6///6rJk2a6MaNGxo+fLgmTpyoZs2a2dwg6tSpUzp+/Ljd9jt16pTOnTunSpUq2fXxmWee0fbt29O0PW6XlJSknTt3prrMQ4cO6cqVKzbl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SYRpAAAAAABMIkwDAAAAAGASYRoAAAAAAJMI0wAAAAAAmESYBgAAAADAJMI0AAAAAAAmEaYBAAAAADCJMA0AAAAAgEmPRJgeO3asLBaLLBaLNm/ebDNt6NCh1mkp/R09ejTFZS5fvlzBwcHy8PCQp6enQkJCtHr16ofQGwAAAADAo84psxtwL7t379aQIUPk7u6uuLi4VOu1bdtWAQEBduXe3t52Zd9++61ee+01+fr6ql27dpKkuXPnql69epo3b55atGjxgFoPAAAAAHgcZekwHR8fr7Zt26pcuXIqVqyYvv3221TrtmvXTrVq1brnMi9evKi3335bPj4++vvvv1WoUCFJUr9+/VS+fHm99dZbatCggTw8PB5UNwAAAAAAj5ksfZr3yJEj9e+//+rLL7+Uo6PjA1nm/PnzdenSJb399tvWIC1JhQoVUvfu3RUVFaWffvrpgawLAAAAAPB4yrIj03///bdGjhyp4cOHq1SpUvesv379ev35559ycHBQsWLFVLduXeXIkcOu3rp16yRJ9evXt5vWoEEDDR06VBEREXr99dfvuw94PB0qMTSzmwBJgfuHZnYTAAAA8ATLkmH6xo0bev3111WuXDn17ds3TfMMGTLE5rW3t7emTJliF4ojIyMlScWKFbNbRnJZch0AAAAAAFKSJcP04MGDFRkZqW3btt3z9O7//e9/+vLLL1WrVi3lz59fZ8+e1eLFizV48GC1a9dO3t7eatasmbV+TEyMJMnLy8tuWZ6enjZ1UnLjxg3duHHD+vry5cuSbl3fHR8fL0lycHCQo6OjEhMTlZSUZK2bXJ6QkCDDMKzljo6OcnBwSLX81nKd77odgCdNYmLifXye/o+T063DYEJCQprKnZ2dlZSUpMTERGuZxWKRk5NTquWpHQse7DEiM/vE8Qm43cM4RgAAMl+WC9ObNm3ShAkTNHToUJUpU+ae9V944QWb1wEBAerevbtKliypevXq6YMPPrAJ0/dr9OjRGjZsmF35ihUrlD17dklS4cKFVb58ee3cuVPHjx+31ilRooSCgoK0ZcsWnT9/3lperlw5+fv7a/369bpy5Yq1vGrVqsqTJ49WrFghKfSB9QF4HERGRqb783T7F9GQkBC5ublpyZIlNstv3Lixrl27prVr11rLnJycFBoaqqioKG3atMla7uHhodq1a+vEiRPasWOH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", + "text/plain": [ + "
" + ] + }, + "execution_count": 16, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram(\n", + " [midcirc_count1, midcirc_count2],\n", + " legend=[\"h(0); meas(0, 0)\", \"h(0); meas(0, 0); x(0); meas(0, 1)\"],\n", + " title=\"Mid-circuit measurement (single qubit operation)\",\n", + ")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "During the mid-circuit measurement (*measurement one*), $1$ and $0$ appear approximately 50\\% of the time. After we apply the X-gate (*measurement two*), the results are ideally the reverse of measurement one." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Resets with dynamic circuits\n", + "\n", + "Let's learn about `reset`s using mid-circuit measurement." + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "execution_count": 17, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qc_reset = QuantumCircuit(1, 2)\n", + "\n", + "qc_reset.x(0)\n", + "qc_reset.measure(0, 0)\n", + "qc_reset.reset(0) # Applying reset here to reset the qubit back to its initial state\n", + "qc_reset.measure(0, 1)\n", + "\n", + "qc_reset.draw(output=\"mpl\", idle_wires=False)" + ] + }, + { + "cell_type": "code", + "execution_count": 18, + "metadata": {}, + "outputs": [], + "source": [ + "qc_reset_transpiled = transpile(qc_reset, backend)" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: cg7r1iakefmul9thm9s0\n", + "Job Status: job has successfully run\n", + "Measurement 1 results: {'0': 14, '1': 986}\n", + "Measurement 2 results: {'0': 943, '1': 57}\n" + ] + } + ], + "source": [ + "reset_job = backend.run(qc_reset_transpiled, shots=1000, dynamic=True)\n", + "print(f\"Runtime job id: {reset_job.job_id()}\")\n", + "job_monitor(reset_job)\n", + "\n", + "reset_count1 = marginal_counts(reset_job.result(), indices=[0]).get_counts()\n", + "reset_count2 = marginal_counts(reset_job.result(), indices=[1]).get_counts()\n", + "\n", + "print(f\"Measurement 1 results: {reset_count1}\")\n", + "print(f\"Measurement 2 results: {reset_count2}\")" + ] + }, + { + "cell_type": "code", + "execution_count": 20, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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okGDBlmUR0dHq2XLlqpRo4Y++OADnTx5Uu+//75iYmL03Xff5eq1Nm7cqEWLFqlOnTqqWrWqjh49mmXd+3FOCuSCf4sWLTIvyLd//37t3btXjz/+uB555BFJUrNmzTRgwABJt67wP/7449q3b5/atGmjevXqae/evdq0aZMaNmyo7du3y9XV1aL9gQMHatGiRXr00UfVoUMHnT59WitWrFDRokW1e/duVatWzaL+smXL1KdPH5UsWVLPPfecJGnFihVKSEjQihUr1K1bt2yPLTk5WZ6enhaL7gBAYUL4LzgI/4VDZn973G2BqMIS/lNTU1WuXDkNHjxYkyZNMpdfv35dPj4+aty4sb799ltz+fPPP69169YpPj5exYoVM5fPnDlT48aN05kzZ6yuHNqy33//XfXq1dOWLVvUsmVLc/mePXsUGBioGTNmaOTIkZJuvedq1aqlUqVKadeuXTl+rVOnTqlKlSoaNGiQ5s6dK0kymUwKCgpSbGysjh8/brHmxcsvv6xvvvlGsbGxWV5dzamrV6/Kzc0tT9rKqWHDhmnevHnKLLrNmjVLo0eP1rlz5yzef++9955GjRqlPXv2qGHDhpKkw4cPq1atWnrzzTc1depUc93U1FSVLl1aw4YNs5kvTLKrY8eOSkxM1M6dOy3K27dvr+joaB0+fNj82blo0SINHDhQkZGRatOmTY5f6+zZs/Lw8JCrq+sdz6mU/XOSkwX/CuS0/x9++MH87dXevXslST/++KO57PaV+t3c3LR9+3aNGDFChw4d0syZM3X48GG9/vrr2rp1q1Xwl259k5uxmv/s2bO1ceNGderUSXv27LEK/tKtD/rvvvtO/v7+Wrx4sSIiIlSzZk1t2rQpR8EfAAAA99f169fl7+8vf39/Xb9+3VyemJiosmXLqmnTpua1n3744QclJCSoVatWFm1ERUXpwoULGjJkiEX50KFDdfXqVf33v/+1KG/durWuXr1qNa09Li5Ohw8fvmuft23bJoPBoJUrV2rChAkqX7683N3d1bVrVyUlJSklJUUjRoxQqVKlVLRoUfXr18/iaVIZli1bpvr168vV1VXFixdXjx49FB8fb1Fn586d6tatmypWrChnZ2f5+Pjo1VdftThWknTmzBn169dPFSpUkLOzs8qWLauOHTvq+PHj5jrr1q2Tk5OTxS2zkrR69WrZ29tb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", + "text/plain": [ + "
" + ] + }, + "execution_count": 20, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram(\n", + " [reset_count1, reset_count2],\n", + " legend=[\"x(0); meas(0, 0)\", \"x(0); meas(0, 0); reset(0); meas(0, 1)\"],\n", + " title=\"Reset example - 1\",\n", + ")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Apply the X-gate first to flip the initial state to $|1\\rangle$, and then apply the `reset` to bring the qubits back to ground state ($|0\\rangle$)." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now, let's try `reset` after an H-gate." + ] + }, + { + "cell_type": "code", + "execution_count": 21, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "execution_count": 21, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qc_reset = QuantumCircuit(1, 2)\n", + "\n", + "qc_reset.h(0)\n", + "qc_reset.measure(0, 0)\n", + "qc_reset.reset(0)\n", + "qc_reset.measure(0, 1)\n", + "\n", + "qc_reset.draw(output=\"mpl\", idle_wires=False)" + ] + }, + { + "cell_type": "code", + "execution_count": 22, + "metadata": {}, + "outputs": [], + "source": [ + "qc_reset_transpiled = transpile(qc_reset, backend)" + ] + }, + { + "cell_type": "code", + "execution_count": 23, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: cg7r1m2kefmul9thmc40\n", + "Job Status: job has successfully run\n", + "Measurement 1 results: {'0': 502, '1': 498}\n", + "Measurement 2 results: {'0': 959, '1': 41}\n" + ] + } + ], + "source": [ + "reset_job = backend.run(qc_reset_transpiled, shots=1000, dynamic=True)\n", + "print(f\"Runtime job id: {reset_job.job_id()}\")\n", + "job_monitor(reset_job)\n", + "\n", + "reset_count1 = marginal_counts(reset_job.result(), indices=[0]).get_counts()\n", + "reset_count2 = marginal_counts(reset_job.result(), indices=[1]).get_counts()\n", + "\n", + "print(f\"Measurement 1 results: {reset_count1}\")\n", + "print(f\"Measurement 2 results: {reset_count2}\")" + ] + }, + { + "cell_type": "code", + "execution_count": 24, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAA/8AAAHHCAYAAADptOi/AAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8o6BhiAAAACXBIWXMAAA9hAAAPYQGoP6dpAABolElEQVR4nO3deXxM1+P/8fdkEZEViT1CbFG09taeSKxRfFrS0iJ8UFRVtbTVqqWa1t6W6qYVVa216Ee11qBFae27VKm9JAixJpn5/eE38zUmIYmQuHk9H488Hubcc8+ccycm85577rkmi8ViEQAAAAAAMCynnO4AAAAAAAC4vwj/AAAAAAAYHOEfAAAAAACDI/wDAAAAAGBwhH8AAAAAAAyO8A8AAAAAgMER/gEAAAAAMDjCPwAAAAAABkf4BwAAAADA4Aj/AIBMCwkJUUhISE53AwAAABlE+AeQ42JiYmQymWw/Li4uKlmypKKionTixImc7p727t2rESNG6MiRIzndFUg6deqU3njjDYWGhsrLy0smk0lr1qzJ6W4BAADkaoR/ALnGqFGjNHPmTH322Wdq1aqVvv32WzVp0kTXrl3L0X7t3btXI0eOJPznEgcOHNCYMWN04sQJVatWLae7AwAA8FBwyekOAIBVq1atVLt2bUlSz5495efnpzFjxujHH39UZGRkDvcOuUWtWrWUkJCgQoUKaf78+erYsWNOdwkAACDX48w/gFyrUaNGkqRDhw7Zle/fv18dOnRQoUKFlD9/ftWuXVs//vijXZ3k5GSNHDlSFSpUUP78+VW4cGE1bNhQK1asyFRbMTExtnAZGhpquzThbtPM79bumTNn5O/vr5CQEFksFlv5X3/9JQ8PDz3zzDO2sl9//VUdO3ZU6dKl5ebmpoCAAL3yyiu6evWq3XNGRUXJ09NTR48eVZs2beTp6amSJUvqk08+kSTt2rVLTZs2lYeHhwIDA/Xdd9/Z7W+9/GLdunV64YUXVLhwYXl7e6tr1646f/78HccrSdevX9fw4cNVvnx5Wz+HDBmi69ev33XfzPDy8lKhQoWytU0AAACjI/wDyLWs0+wLFixoK9uzZ4+eeOIJ7du3T2+88YYmTJggDw8PtW/fXgsXLrTVGzFihEaOHKnQ0FBNmTJFb731lkqXLq2tW7dmqq3GjRtrwIABkqShQ4dq5syZmjlzpipXrpxuvzPSbpEiRfTpp59q7dq1mjx5siTJbDYrKipKXl5emjp1qq29efPm6cqVK+rbt68mT56sFi1aaPLkyeratavDc6empqpVq1YKCAjQ2LFjVaZMGfXv318xMTFq2bKlateurTFjxsjLy0tdu3bV4cOHHdro37+/9u3bpxEjRqhr166aNWuW2rdvb/clxe3MZrPatm2r8ePH68knn9TkyZPVvn17TZo0ye6LDAAAAOQQCwDksOnTp1skWVauXGk5e/as5dixY5b58+db/P39LW5ubpZjx47Z6oaFhVmqVatmuXbtmq3MbDZb6tevb6lQoYKt7LHHHrNERETc8Xkz2ta8efMskiyxsbEZGk9G27VYLJZOnTpZChQoYDl48KBl3LhxFkmWRYsW2dW5cuWKw3O8//77FpPJZPnnn39sZd26dbNIskRHR9vKzp8/b3F3d7eYTCbL7NmzbeX79++3SLIMHz7cVmZ9HWrVqmW5ceOGrXzs2LEWSZbFixfbypo0aWJp0qSJ7fHMmTMtTk5Oll9//dWun5999plFkmX9+vXpHa57ktnXBgAAIK/izD+AXCM8PFz+/v4KCAhQhw4d5OHhoR9//FGlSpWSJJ07d06rV69WZGSkLl26pPj4eMXHxyshIUEtWrRQXFyc7e4Avr6+2rNnj+Li4tJ8rsy0lRmZbXfKlCny8fFRhw4dNGzYMHXp0kXt2rWza9Pd3d3278uXLys+Pl7169eXxWLRtm3bHPrQs2dP2799fX1VqVIleXh42K2bUKlSJfn6+urvv/922L93795ydXW1Pe7bt69cXFy0dOnSdMc9b948Va5cWcHBwbYxx8fHq2nTppKk2NjYOx02AAAA3Gcs+Acg1/jkk09UsWJFJSYm6uuvv9a6devk5uZm2/7XX3/JYrFo2LBhGjZsWJptnDlzRiVLltSoUaPUrl07VaxYUVWrVlXLli3VpUsXPfroo5luKzMy226hQoX08ccfq2PHjipatKg+/vhjh/pHjx7VO++8ox9//NHh2vvExES7x/nz55e/v79dmY+Pj0qVKiWTyeRQnta1/BUqVLB77OnpqeLFi9/xbgdxcXHat2+fw3NbnTlzJt19k5KSlJSUZHvs7OycbjsAAADIGsI/gFyjbt26ttX+27dvr4YNG6pz5846cOCAPD09ZTabJUmvvfaaWrRokWYb5cuXl3TzWv1Dhw5p8eLFWr58uaZNm6ZJkybps88+U8+ePTPVVmZkpd1ly5ZJks6fP6/jx4/L19fXti01NVXNmjXTuXPn9Prrrys4OFgeHh46ceKEoqKibM9n5ezsnOZzplduucN1/JlhNptVrVo1TZw4Mc3tAQEB6e47fvx4jRw50vY4MDCQ2yoCAABkM8I/gFzJ2dlZ77//vm3BvjfeeENBQUGSJFdXV4WHh9+1jUKFCql79+7q3r27kpKS1LhxY40YMUI9e/bMVFu3nzG/k8z28ZdfftG0adM0ZMgQzZo1S926ddOmTZvk4nLz7XnXrl06ePCgZsyYYbfA3+13LchOcXFxCg0NtT1OSkrSqVOn1Lp163T3KVeunHbs2KGwsLBMHS9J6tq1qxo2bGh7fOtlDgAAAMgeXPMPINcKCQlR3bp19eGHH+ratWsqUqSIQkJC9Pnnn+vUqVMO9c+ePWv7d0JCgt02T09PlS9f3nbbucy05eHhIUm6cOHCXfucmXYvXLignj17qm7duoqOjta0adO0detWRUdH2+pYz9jfeobeYrHoo48+umtfsuqLL75QcnKy7fGnn36qlJQUtWrVKt19IiMjdeLECX355ZcO265evarLly+nu29QUJDCw8NtPw0aNLi3AQAAAMABZ/4B5GqDBw9Wx44dFRMToz59+uiTTz5Rw4YNVa1aNfXq1UtBQUH6999/tXHjRh0/flw7duyQJD3yyCMKCQlRrVq1VKhQIf3555+aP3+++vfvb2s7o21Vr15dzs7OGjNmjBITE+Xm5qamTZuqSJEiafY5o+2+/PLLSkhI0MqVK+Xs7KyWLVuqZ8+eGj16tNq1a6fHHntMwcHBKleunF577TWdOHFC3t7eWrBgQZrX6meXGzduKCwsTJGRkTpw4ICmTp2qhg0bqm3btunu06VLF82dO1d9+vRRbGysGjRooNTUVO3fv19z587VsmXLbJd0ZIfRo0dLunlbRUmaOXOmfvvtN0nS22+/nW3PAwAAYBg5eKcBALBYLP93i7k//vjDYVtqaqqlXLlylnLlyllSUlIsFovFcujQIUvXrl0txYoVs7i6ulpKlixpadOmjWX+/Pm2/UaPHm2pW7euxdfX1+Lu7m4JDg62vPfee3a3sMtoWxaLxfLll19agoKCLM7Ozhm6tdzd2l28eLFFkmXChAl2+128eNESGBhoeeyxx2x93bt3ryU8PNzi6elp8fPzs/Tq1cuyY8cOiyTL9OnTbft269bN4uHh4dCXJk2aWKpUqeJQHhgYaHc7ROvrsHbtWkvv3r0tBQsWtHh6elqee+45S0JCgkObt97qz2KxWG7cuGEZM2aMpUqVKhY3NzdLwYIFLbVq1bKMHDnSkpiYeMfjlVmS0v0BAACAI5PFkk2rPQEAHmoxMTHq3r27/vjjj2w9Sw8AAICcxzX/AAAAAAAYHOEfAAAAAACDI/wDAAAAAGBwXPMPAAAAAIDBceYfAAAAAACDI/wDAAAAAGBwLjndgbzGbDbr5MmT8vLykslkyunuAAAAg7NYLLp06ZJKlCghJyfH8z4Wi0WpqalKSUnJgd4BALLKxcVFzs7OGc6VhP8H7OTJkwoICMjpbgAAgDzm2LFjKlWqlO2xxWLRhQsXdPbsWaWmpuZgzwAAWeXs7KwiRYrIx8fnrl8CEP4fMC8vL0k3/wB7e3vncG8AAIDRXbx4UQEBAbbPIFanT5/WhQsX5O3tLW9vb7m4uDArEQAeEhaLRSkpKbp48aJOnTqlq1evqnjx4nfch/D/gFn/qFr/0AIAADwItwb71NRUJSYmyt/fX35+fjnYKwDAvfDy8pKbm5vi4+NVpEgROTs7p1uXBf8AAADymOTkZFksFnl4eOR0VwAA98jDw0MWi0XJycl3rEf4BwAAyKOY5g8AD7+MvpcT/oE86tKlSxo4cKACAwPl7u6u+vXr648//rBtj4qKkslksvtp2bKlXRtbt25Vs2bN5Ovrq8KFC6t3795KSkp60EMBAAAAcBeEfyCP6tmzp1asWKGZM2dq165dat68ucLDw3XixAlbnZYtW+rUqVO2n++//9627eTJkwoPD1f58uW1adMm/fLLL9qzZ4+ioqJyYDQAAAAA7oTwD+RBV69e1YIFCzR27Fg1btxY5cuX14gRI1S+fHl9+umntnpubm4qVqyY7adgwYK2bUuWLJGrq6s++eQTVapUSXXq1NFnn32mBQsW6K+//sqJYQEAIEkaMWKETCaT4uPjM1Q/KSlJRYoU0axZszL9XAkJCfLw8NDSpUszva9RbN68Wfny5dM///yT012RJO3du1cuLi7avXt3TncFyFUI/0AelJKSotTUVOXPn9+u3N3dXb/99pvt8Zo1a1SkSBFVqlRJffv2VUJCgm3b9evXlS9fPjk5OdntL8muDQAAcruPPvpIXl5eevbZZ+3KL1y4oN69e8vf318eHh4KDQ3V1q1b7eoULlxYPXv21LBhwx5kl3OVt956S506dVJgYKBd+b59+9SyZUt5enqqUKFC6tKli86ePXtPz3XixAlFRkbK19dX3t7eateunf7++2+7Oo888ogiIiL0zjvv3NNzAUbDrf6APMjLy0v16tXTu+++q8qVK6to0aL6/vvvtXHjRpUvX17SzSn/Tz31lMqWLatDhw5p6NChatWqlTZu3ChnZ2c1bdpUgwYN0rhx4/Tyyy/r8uXLeuONNyRJp06dysnhAQDuUa8Pc7oH0pcDH8zzJCcn66OPPtIrr7xid4sss9msiIgI7dixQ4MHD5afn5+mTp2qkJAQbdmyRRUqVLDV7dOnjz7++GOtXr1aTZs2fTAdzyW2b9+ulStXasOGDXblx48fV+PGjeXj46Po6GglJSVp/Pjx2rVrl22mQGYlJSUpNDRUiYmJGjp0qFxdXTVp0iQ1adJE27dvV+HChW11+/Tpo9atW+vQoUMqV67cPY8TMALO/AN51MyZM2WxWFSyZEm5ubnp448/VqdOnWxn8p999lm1bdtW1apVU/v27bVkyRL98ccfWrNmjSSpSpUqmjFjhiZMmKACBQqoWLFiKlu2rIoWLWo3GwAAgNxsyZIlOnv2rCIjI+3K58+frw0bNigmJkbDhw/Xiy++qDVr1sjZ2VnDhw+3q1u5cmVVrVpVMTExD7DnucP06dNVunRpPfHEE3bl0dHRunz5slavXq0BAwZo6NChmjt3rnbs2JHl4zR16lTFxcVpyZIlGjJkiF555RUtX75cp06d0oQJE+zqhoeHq2DBgpoxY0ZWhwYYDp/QgTyqXLlyWrt2rZKSknTs2DFt3rxZycnJCgoKSrN+UFCQ/Pz87K7n79y5s06fPq0TJ04oISFBI0aM0NmzZ9NtAwCAB+nChQuKioqSr6+vfHx81L17d125csWuzqJFi1SmTBmHs8Pz589X0aJF9dRTT9nK/P39FRkZqcWLF+v69et29Zs1a6b//e9/slgstrLk5GTt378/QzPioqKi5OnpqaNHj6pNmzby9PRUyZIl9cknn0iSdu3apaZNm8rDw0OBgYH67rvv0hzvwIEDFRAQIDc3N5UvX15jxoyR2Wy2qzd+/HjVr19fhQsXlru7u2rVqqX58+c7tLdixQo1bNhQvr6+8vT0VKVKlTR06FCH49e0aVOHW40tWLBAbdq0UenSpW1l4eHhqlixoubOnXvX45GW+fPnq06dOqpTp46tLDg4WGFhYQ5turq6KiQkRIsXL87ScwFGRPgH8jgPDw8VL15c58+f17Jly9SuXbs06x0/flwJCQkqXry4w7aiRYvK09NTc+bMUf78+dWsWbP73W0AAO4qMjJSly5d0vvvv6/IyEjFxMRo5MiRdnU2bNigmjVrOuy7bds21axZ02E2W926dXXlyhUdPHjQrrxWrVq6cOGC9uzZYys7ceKEKleurDfffDND/U1NTVWrVq0UEBCgsWPHqkyZMurfv79iYmLUsmVL1a5dW2PGjJGXl5e6du2qw4cP2/a9cuWKmjRpom+//VZdu3bVxx9/rAYNGujNN9/UoEGD7J7no48+Uo0aNTRq1ChFR0fLxcVFHTt21E8//WSrs2fPHrVp00bXr1/XqFGjNGHCBLVt21br16+3G9/Ro0cdjt+JEyd05swZ1a5d22GMdevW1bZt2zJ0PG5lNpu1c+fOdNs8dOiQLl26ZFdeq1Yt7d69WxcvXsz08wFGxDX/QB61bNkyWSwWVapUSX/99ZcGDx6s4OBgde/eXUlJSRo5cqSefvppFStWTIcOHdKQIUNUvnx5tWjRwtbGlClTVL9+fXl6emrFihUaPHiwPvjgA/n6+ubcwAAA+P9q1Kihr776yvY4ISFBX331lcaMGSPp5gK4hw4dSvOL71OnTqlx48YO5dYvwU+ePKlq1arZyq2z3vbu3auqVatmqb/Xrl3T888/b/uyoHPnzipRooR69Oih77//Xs8884ykm7MMgoODNWPGDI0YMUKSNHHiRB06dEjbtm2zrUfwwgsvqESJEho3bpxeffVVBQQESJIOHjxoW6RXkvr376+aNWtq4sSJioiIkHTzrP+NGzf0888/y8/PL83+7t+/X5JUtmxZu3LrTIe0ThgUL15c586d0/Xr1+Xm5pbhY2PdJ702pZuvSaVKlWzlQUFBMpvN2r9/v+rWrZvh5wKMKlee+f/222/1wgsvqHbt2nJzc5PJZLrjtUEXL17UoEGDFBgYKDc3N5UpU0aDBw9WUlJSmvXNZrMmT56satWqyd3dXf7+/urUqZPDSqG3WrZsmZo0aSIvLy95e3srNDRUq1atutehAjkmMTFRL774ooKDg9W1a1c1bNhQy5Ytk6urq5ydnbVz5061bdtWFStW1H//+1/VqlVLv/76q90f6s2bN6tZs2aqVq2avvjiC33++ecaMGBADo4KAID/06dPH7vHjRo1UkJCgu1M8Llz52SxWOxuZWt19erVNMOp9U45V69etSu3tnHr7QXLlCkji8WSqWvce/bsafu3r6+vKlWqJA8PD7s1CSpVqiRfX1+7z67z5s1To0aNVLBgQcXHx9t+wsPDlZqaqnXr1tnq3hr8z58/r8TERDVq1MjuTgbWL/IXL17scNmAlfUuQLcfP+uxyczxu5ustJnWawLkZbnyzP/bb7+tf/75R35+fipevPgd7xl6+fJl2wqfzZs3V6dOnbRt2zaNHz9ea9eu1bp16xxuZ/bCCy9o2rRpqlKligYMGKCTJ09q7ty5Wr58uX7//Xe71Vulm19GdOnSRf7+/oqKipIkzZkzR82aNdPcuXPVoUOHbD8GwP0WGRnpsLiRlbu7u5YtW3bXNr755pvs7hYAANnm1uvNpf8Lg+fPn5e3t7et/Nbr9K3c3d0druuXbp6dt26/lbWN2699z4z8+fPL39/frszHx0elSpVyaNfHx0fnz5+3PY6Li9POnTsd9rc6c+aM7d9LlizR6NGjtX37drsx3voczzzzjKZNm6aePXvqjTfeUFhYmJ566il16NDB4VKI24+f9dhk5vjdTVbazI7XBDCSXBn+p02bpgoVKigwMFAffPDBHa+TGjt2rLZv367XX39dH3zwga38jTfe0JgxYzRp0iS7/WNjYzVt2jQ1btxYK1assN1mpHPnzmrdurX69+9vF3rOnz+vl156SX5+ftq6datKlSolSXr99ddVo0YN9e3bVy1atJCXl1d2HwYAAADcg1tv3XcraygsVKiQTCaTXYi2Kl68eJoL9VnLSpQoYVdubSO9KfL30t+7jUO6ObO1WbNmGjJkSJp1K1asKEn69ddf1bZtWzVu3FhTp05V8eLF5erqqunTp9stIuju7q5169YpNjZWP/30k3755RfNmTNHTZs21fLly+Xs7Gy7td7tx886DT+941eoUKFMTfmXZNvnQb8mgJHkymn/4eHhCgwMvGs9i8WiadOmydPTU8OGDbPbNmzYMHl6emratGl25V9++aUk6d1337W7v2irVq0UEhKi5cuX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AJD7eXp66syZM1nat3Dhwrbp/bebN2/evXTrofH444/rxo0bWdr3xRdf1Isvvpit/alcuTJrXQBpeKhX+69QoYJKlCih9evX6/Lly3bbLl++rPXr16ts2bIKCAiwlTdp0sS27XbW1VEbN25sV1+6eY1+evWtdQAAAAAAyI0e6vBvMpnUs2dPJSUl6d1337Xb9u677yopKUm9evWyK+/du7ckadiwYXbfUP78889as2aNmjdvbjddKTIyUj4+Ppo8ebKOHz9uKz9+/LimTJkiPz8//ec//7kfwwMAAAAAIFvkygX/pk2bZluQb9euXdq6dasaNGhgWwW0YcOG6tmzp6SbZ/gbNGigHTt2qHnz5qpZs6a2bt2q5cuXq06dOlq7dq3c3d3t2u/Vq5emTZumKlWqKCIiQqdOndKcOXPk6empjRs32t3mRZK+/fZbdenSRf7+/nrmmWckSXPmzFF8fLzmzJmTqXuVXrx4UT4+PnaL7gAAANwvaX32YME/ADCOjL6n58rwHxUVpRkzZqS7/fZ7pSYmJmrEiBFasGCBTp8+reLFi6tjx44aPny4vLy8HPY3m82aMmWKvvjiC/3111/y9PRUeHi43nvvPZUrVy7N5/zll18UHR2trVu3ymQyqVatWnr77bcVHh6eqbER/gEAwINE+AcAY3uow7+REf4BAMCDRPgHAGPL6Hv6Q33NPwAAAAAAuDvCPwAAAAAABkf4BwAAAADA4Aj/AAAAAAAYHOEfAAAAhjJixAiZTCbFx8dnqH5SUpKKFCmiWbNmZfq5EhIS5OHhoaVLl2Z6X6PYvHmz8uXLp3/++SenuyJJ2rt3r1xcXLR79+6c7soDNXbsWAUHB8tsNmd63zfeeEOPP/74fejVw6N169bq1atXTnfD5n68JoR/AAAA5GkfffSRvLy89Oyzz9qVX7hwQb1795a/v788PDwUGhqqrVu32tUpXLiwevbsqWHDhj3ILucqb731ljp16qTAwEC78n379qlly5by9PRUoUKF1KVLF509e/aenuvEiROKjIyUr6+vvL291a5dO/399992dR555BFFRETonXfeuafnym2io6O1aNGiNLddvHhRY8aM0euvvy4nJ/uI9+OPP6pmzZrKnz+/SpcureHDhyslJcWuzsCBA7Vjxw79+OOP96v7udr69eu1fPlyvf7663blZrNZY8eO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xw4dPnxYTZo0sU2HBO42W8TX11e7du1Kd/uaNWuyuUcAkHF79+7VjBkzZDab5erqqieffFILFy60ba9UqZJiYmI0aNAgPfvss7JYLPL09NTIkSMJ/gAAIMdl+cz/nVgsFk2YMEFjx47V77//rqCgoOx+iocW377nPZz5zx048w8gr+KzBwBAuk8L/plMJr322muqUqWKBg8efD+eAgAAAAAAZNB9Xe2/du3aWr169f18CgAAAAAAcBf3NfwfOnQoVy/EBgAAAABAXpDlBf/SYzabdeLECcXExGjx4sUKCwvL7qcAAAAAAACZkOUz/05OTnJ2dnb4cXV1VZkyZTR8+HD5+vpqwoQJ2dnfNJUpU0YmkynNn5CQEIf6169f16hRo1ShQgXlz59fJUqUUO/evXXmzJl0n2PWrFmqW7euPDw8VLBgQbVp00Zbt269j6MCAAAAACB7ZPnMf+PGjdO81Z+Tk5MKFiyoOnXqqHv37ipSpMg9dTCjfHx8NHDgQIfy2281aDab1a5dOy1btkxPPPGEnn76acXFxWnatGlatWqVfv/9d/n7+9vt89577+ntt99WYGCg+vTpo0uXLmn27NmqX7++Vq1apQYNGtzHkQEAAAAAcG/uy63+HjRrwD9y5Mhd606fPl09evRQp06dNGvWLNsXGJ999pn69u2r3r176/PPP7fVj4uL0yOPPKKgoCBt3rxZPj4+kqTt27friSeeUFBQkHbv3i0np4xNouB2O3kPt/rLHbjVH4C8is8eAADpPi/4lxt9+eWXkqT333/fbubCCy+8oKCgIM2aNUtXr161lU+fPl0pKSl66623bMFfkqpXr65OnTpp3759+u233x7cAAAAAAAAyKRsWfBv/fr12r59uy5evChvb29Vr179gU+Fv379umJiYnTy5El5e3urTp06evzxx+3qXLt2TZs2bVKlSpUUGBhot81kMqlZs2b6/PPP9eeff6pRo0aSpDVr1kiSmjdv7vCcLVq0UExMjNauXavGjRvfn4EBAAAAAHCP7in8b9iwQd27d9dff/0lSbJYLLaz6RUqVND06dNVr169e+9lBpw+fVrdu3e3K6tTp46+//57lStXTtLNWw+azWZVqFAhzTas5XFxcbbwHxcXJ09PTxUrVuyO9QEAAAAAyK2yHP737Nmj5s2b68qVK2rWrJlCQ0NVvHhxnT59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", + "text/plain": [ + "
" + ] + }, + "execution_count": 24, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram(\n", + " [reset_count1, reset_count2],\n", + " legend=[\"h(0); meas(0, 0)\", \"h(0); meas(0, 0); reset(0); meas(0, 1)\"],\n", + " title=\"Reset example - 1\",\n", + ")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "During the mid-circuit measurement (*measurement one*), $1$ and $0$ appear approximately 50\\% of the time. After we apply the `reset` gate (*measurement two*), ideally we get $0$ 100\\% of the time, which demonstrates how `reset` works. " + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Control flow\n", + "\n", + "Qiskit supports various control flow operations. Visit the Qiskit [control flow operations](/api/qiskit/circuit#control-flow-operations) API documentation for more details.\n", + "\n", + "### If-else condition\n", + "\n", + "To program an `if/else` condition, you may use `with circuit.if_test()`. Visit the [Qiskit API documentation](/api/qiskit/qiskit.circuit.QuantumCircuit#if_else) for more details. \n", + "\n", + "Dynamic circuit capabilities such as `if_test` come with an associated latency introduced into the control system. This is due to the need to communicate measurement outcomes and the resulting decisions (the `if_test` condition) to all of the system's qubit controllers (waveform generators/digitizers). This latency is currently on the order of 400-700 ns. We are working to minimize the latency as we develop our systems further. For more information please see the [FAQ](./getting-started-with-dynamic-circuits#faqs)." + ] + }, + { + "cell_type": "code", + "execution_count": 25, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAc4AAAEvCAYAAADM/iGXAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8o6BhiAAAACXBIWXMAAA9hAAAPYQGoP6dpAAArfElEQVR4nO3deVhUdd8/8PewDDuxqYCiCIIpCi64EwiPuJAK+oTZXWllaO6VgbfL8wOfxCXzNpcutzTtzq1LvRXR0swdMxdcEkQURQVBI0jZZICZ3x88TCLD8h0GZhjfr+vi8jrb93wGOfOec77fc0aiUCgUICIionox0HYBREREzQmDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISACDk4iISICRtgsg3aBQALJybVdRf1JDQCLRXHsKhQJFRUWaa7AJmJubQ6LJX0IDKBSAvFTbVTQ/Bsaa/TtuCB4D9cfgJAAVoTl7l7arqL+lbwImGvzrLSoqgqWlpeYabAIFBQWwsLDQdhkAKkLz+CptV9H8BM4ADKXarqICj4H646VaIiIiAQxOIiIiAQxOIiIiAQxOIiIiAQxOIiIiAQxOIiIiAQxOIiIiAQxOIiIiAQxOIiIiAQxOIiIiAQxOIh1lYMDDk15uunoM8Fm1L0hPT8cvv/yCCxcu4MKFC/j9999RWlqK8ePHY8uWLUJtbdy4ERMnTgQABAQE4MSJE5ovmHRO69at4evri86dO8Pc3BwKhQIFBQW4fv06Ll26hEePHtXZhqurKw4ePIgpU6bg5MmTTVA1keY4ODigZ8+e8Pb2hpWVFSQSCYqLi3Hjxg1cunQJ9+/fr7MNGxsb/PTTT1i9ejW2bdvWBFXXH4PzBV999RVWrlzZ4Hays7MRFRWlgYqoOXBzc8OkSZPwzjvvwNnZudZ17927hy1btmDDhg14+PBhteWurq44ceIE2rVr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dXYo9svEwsJC2R+t6lscaqNOaAIVb06VD3Z3cnJSo2rdNHnkV5g4/Evce5SENf+ZihNXdiJswHQs/CBeZ/pqSbXKLy/IyMgQGhSkTmhWunnzJgBAKpXC3t5ejaobj172cbZp0wanT59GZGQkTp48ifT0dHTu3Bnr169HRESE8un9qoKztLRU5T2UJSUlKCkpqbKeJnTq1EllX2ZycjL8/Ztfv0+bzgMx8/va+z/qWq5LysrKMG/ePJiamuLu3btC23733XdqP7D9m2++gYODg7K/Xh8YGhgiPGAWwgNmabsUErR06VLY2NgoBzvW1/Lly9V+YPvu3buRlJSE4uJinTsOJAp1x9U3UwUFBbC2toZEIkF+fj7MzbU7BP7LL7/E3LlzcefOHbRp0wYA8Ntvv6Fv377Yu3cvRo0a1SR1NLfBQUvfRJMNDlKXm5sbjh8/joKCgkZ59mxBQUGzGRxEqgXOQLMYHKQuW1tbHD16FM7Ozo3y7FltHQN6ecZZm6SkJCgUCnh6emo9NIGKG+tXr16N0NBQLFiwAM+ePUNUVBR69+6N0NBQbZdHDXDnzh0MHDgQRUVFevfsWaL6yMvLw6BBg9CiRQvhrg5d9tJ1LFR+IaquPAvU2toax44dg5OTE8aOHYsPP/wQ/fv3R3w8+330wd27dxma9FLLy8vTq9AEXsIzTl0LTqDi5uKX6cuuiYias5fulEYXg5OIiJqPl+6Ms/I5tkREROp46c44iYiIGoLBSUREJIDBSUREJIDBSUREJIDBSUREJIDBSUREJIDBSUREJIDBSUREJIDBSUREJOCle3IQqSY1rPiqruZCaqjZ9szNzYW/a7A2y9bvxNPCIlhbmCNy0thq05qgC9/uQ/qDx0D9MTgJACCRaPb7LZsbiUSi0e/1k5qYQlpaDqmJKSwsLKpNE+kaHgP1x0u1REREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicREREAhicL0hPT8emTZvw0UcfoWfP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BQUICAhAYmIiAMDR0REuLi7Izc3FnTt3IJFI8PTpU1hYWFTZ7osvvsDs2bMBVDwMwdbWFtevX0dZWRn69OmDY8eOwdy85m/FiImJwYIFCxp8OwoRETUePnJPBUtLS5w+fRoLFy6Ej48Pnjx5guvXr0MulyMsLAxbt26tFpoAEBUVhZ9++gnBwcF48uQJUlJS4OnpidjYWJw8ebLW0CQiouaBZ5w6hGecRES6j32cOmD37t0AgOTk5CrTrq6uNT40noiItINnnDqgpgcfjx8/Hlu2bGnaYoiIqFY849QB/OxCRNR8cHAQERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRAAYnERGRgP8PzDjotKvgt28AAAAASUVORK5CYII=", + "text/plain": [ + "
" + ] + }, + "execution_count": 25, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qr = QuantumRegister(2)\n", + "cr = ClassicalRegister(2)\n", + "\n", + "qc_if_else = QuantumCircuit(qr, cr)\n", + "\n", + "qc_if_else.h(0)\n", + "qc_if_else.measure(qr[0], cr[1])\n", + "\n", + "with qc_if_else.if_test((cr[0], True)) as else_:\n", + " qc_if_else.x(qr[0])\n", + "with else_:\n", + " qc_if_else.x(qr[1])\n", + "\n", + "qc_if_else.measure(qr[0], cr[1])\n", + "\n", + "qc_if_else.draw(output=\"mpl\", idle_wires=False)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Be sure to transpile the circuit." + ] + }, + { + "cell_type": "code", + "execution_count": 26, + "metadata": {}, + "outputs": [], + "source": [ + "qc_if_else_transpiled = transpile(qc_if_else, backend)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Run the transpiled circuit on the backend because we have an H-gate in the circuit." + ] + }, + { + "cell_type": "code", + "execution_count": 27, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: cg7r1qi14ejq4casnnng\n", + "Job Status: job has successfully run\n", + "Preparation results: {'00': 569, '10': 431}\n" + ] + } + ], + "source": [ + "if_else_job = backend.run(qc_if_else_transpiled, shots=1000, dynamic=True)\n", + "print(f\"Runtime job id: {if_else_job.job_id()}\")\n", + "job_monitor(if_else_job)\n", + "\n", + "if_else_result = if_else_job.result()\n", + "print(f\"Preparation results: {if_else_result.get_counts(0)}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Plot the preparation results." + ] + }, + { + "cell_type": "code", + "execution_count": 28, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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e6SJrsmVvErp6emaOXOmtm7dqtLSUnXv3l1Tp07V/fff7+rWAAAArsg1HfIAAABMdU1eeAEAAGA6Qh4AAICBCHkAAAAGIuQBAAAYiJAHAABgIEIejFZ58bjdbhcXkgMAriWEPBjNYrE4/rfy7wCA/6n8AFxeXu7iTnC1cZ88GOvkyZPau3evMjMzVVBQoFtvvVWdO3dWcHCwPDwuftlLRUWFrFY+6wAAzHNNfq0ZzLd27VrNnTtXW7dudaoHBwdr8ODBuv/++3X33XfL09PTRR0CgOutW7dO33zzjXbv3q2QkBDdcsstuv7669WhQwcFBwfLZrPJbrdzJKSJYiUPxsnKytLAgQNVVFSkMWPGKC4uTocOHdKuXbu0e/du7dmzRyUlJerSpYtefPFF/eIXv5C3tzdvZACuGefOndO8efO0YMEC2Ww2p0O1LVu2VN++fTVixAjde++9CgoKcl2juCKs5ME4S5cuVW5urhITE/Xzn//cadvx48e1detWffrpp/rb3/6mhx56SMePH9dzzz1HwANwzVi2bJmWLFmie++9V5MmTVJoaKh27dql/fv3a/v27UpLS9Nnn32mxYsXa/r06br33ntd3TLqgZU8GOe2226Tj4+PPvjgA7Vq1UplZWWyWCyy2WxO4zZt2qRf//rX+ve//6133nlHjz32mIs6BoDGFRERoW7dumnFihUKDg522padna1du3bp008/1fLly1VeXq53331X48aNc1G3qC/OOIdRCgsL5e/vr5ycHDVv3lySZLVaHQHPbreroqJCkhQXF6c//elPat68uT755BPHdgAw2b59+3TmzBnddNNNjoBXUVHheG8MDQ1VQkKCFi9erE8++USRkZGaNm2a0tLSXNk26oGQB6P4+fmpV69e2r9/v1auXClJVa6erfy5oqJCMTEx6t+/v/bt26ejR49yyBaA8ex2u4KCgvTdd99JksrKyiT9772x8r6iXl5eGj58uF577TXl5ubqyy+/dFnPqB9CHozzzDPPqFu3bho3bpwmTZqknTt36vz585L+d9+8srIyWa1W5efny8vLS+fPn1d4eLgr2waARtGlSxddd911WrNmjdauXSsPD48qH4YtFotjZa9fv36KiIjQ9u3bXdEurgAhD8a57rrr9NJLLykiIkJLlizRk08+qYULFyolJUVHjx7V+fPnHffJ++yzz5SSkqK77rrLxV0DQMOrPCXlrbfeUkBAgBISEjRlyhSlp6dX+TBcWloqSdq/f79KSkoUGhrqmqZRb1x4AWP89BYoZ8+e1bx587R69WplZWUpJCRE3bp1U2hoqJo3b67i4mKtXr1akZGR+vjjj9W5c2cXdg8Ajae8vFzvv/++XnjhBeXk5Khr166Kj49Xnz591LVrV0VHR8tqter777/Xs88+qw8++EBff/21YmNjXd066oCQB6NUBr3jx48rNDRUVqtV33zzjT7//HOlpKToP//5j7KysiRJLVq0UM+ePfXWW2/pxhtvdHHnAND4Tp06pSVLlmj16tU6cOCAmjdvruuuu05+fn5q2bKl9u3bp1OnTmns2LF65513XN0u6oiQByOUlZVpy5YtWr58uQ4cOCCLxaLmzZurd+/eGjVqlGJiYmS325WVlaXi4mIdOnRI0dHRCgsLk4eHBzdCBnBNqbzTgM1mU3FxsTIzM7V9+3Zt2bJFX3/9tfbt26eQkBCFhYVp3Lhxeuihh+Tr6+vqtlFHhDwYYeHChZozZ44KCgp0/fXXy2azaf/+/Y7tXbt21YQJEzRy5Ei1bt3ahZ0CgHuqqKjQ+fPn5eXlpby8POXk5HCUo4kj5KHJO3z4sLp3767Y2FitWLFCXl5eatOmjXJycvTZZ5/pgw8+UEpKiqSL98abP3++br75Ztc2DQCNqLi4WMeOHVOHDh3k4+PjtK2iokIWi8VxNOOnRzYqKiqqXH2LpoGQhyZvxowZWrp0qf72t79p8ODBkqq+Se3du1cLFy7U6tWrFR4err/+9a/q1auXq1oGgEb16quv6sMPP9TPf/5z3XbbbercubPatGnj9E1AlXGg8r3z1KlTatGiheNuBGh6CHlo8n7xi18oIyNDmzZtUocOHVRWVuY4z67ynJNKb775pqZMmaJHH31USUlJLuwaABpP+/btlZ2dLZvNpsDAQPXp00fx8fG69dZb1bFjxypfbVZUVKRZs2bpzJkzSkxMZCWviSKeo8mLiYnRRx99pMLCQklyfOr88ffVVq7s/epXv9KXX36pjRs36tChQ+rYsaPL+gaAxnDgwAHl5eXp9ttv1wMPPKAvvvhCaWlp+vzzz9WhQwcNHDhQQ4YMUUxMjK677joFBQXpm2++0bJlyzRw4EACXhNGyEOTFxcXJ0l68MEHtWjRIt1xxx3y8vKqMq68vFw2m02dO3fW2rVrHaEQAEx24MABnT9/XvHx8Xr66ad19913a//+/UpLS9PGjRv14Ycf6q9//au6du2qQYMG6c4779SGDRuUn5+v8ePHu7p9XAEO16LJKy8v17Rp0/Taa68pOjpaTz/9tEaOHKk2bdpUGZubm6vJkydr7dq1OnnypAu6BYDG9Y9//EOjRo3SypUrNWrUKEe9tLRUR48e1e7du/Xll1867iXq6ekpu90ub29vnT171oWd40oR8mCMpUuXasGCBTp06JBCQ0M1YsQI3XXXXQoLC5PNZlNQUJAWL16sN954QxMmTNCiRYtc3TIANDi73a59+/apWbNmioyMrPa+oEVFRTpw4ID279+vpKQkffHFF5o4caLeeustF3WNq4GQB2PY7XYdPHhQy5Yt08qVK3X8+HFJUuvWreXp6akTJ06ooqJCo0eP1vz589W+fXsXdwwArlVd4Js0aZKWLFmiHTt2KCYmxkWd4Wog5MFIRUVFSk9P16effqrs7GydPHlSAQEBGjVqlH7xi1+oWbNmrm4RANxG5b3wjhw5op/97GfKzc3VsWPHXN0WrhAXXsBIvr6+iouLU1xcnEpLS+Xp6enqlgDAbVVeQfv999+rtLRUEyZMcHFHuBpYyQMAAJIuHr49fvy4WrZsyXfVGoCQBwAAYCDucAgAAGAgQh4AAICBCHkAAAAGIuQBAAAYiJAHAABgIEIeAACAgQh5AAAABiLkAQAAGIiQBwAAYKD/D6/68KyLzBD3AAAAAElFTkSuQmCC", + "text/plain": [ + "
" + ] + }, + "execution_count": 28, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram(if_else_result.get_counts(0))" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "[For loops](/api/qiskit/qiskit.circuit.QuantumCircuit#for_loop) and [while loops](/api/qiskit/qiskit.circuit.QuantumCircuit#while_loop) can be done in Qiskit. An efficient multi-case branch switch operation will be included in a future release.\n", + "\n", + "These features are only supported on dynamic circuit backends. For more information, visit the [Dynamic Circuits basics with OpenQASM3](./dynamic-circuits-basics-with-openqasm3#for-loops) tutorial. To see what features of OpenQASM 3 are currently supported in hardware, please see the [feature table](./feature-table)." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Conditional measurements\n", + "\n", + "Below is an example of a conditional measurement. Classical computation, Boolean expressions, and conditionals may be combined with qubit measurement to implement conditional measurement. Here the result of qubit measurements may be used to conditionally select additional qubit measurements. \n", + "\n", + "Conditional measurement can be done in Qiskit either with the older `circuit.x(0).c_if()` form, or the newer `with circuit.if_test()` form. Note that, for single operations like the above example, either will work for now, but it is beneficial to start adopting the new form, since the old form will eventually be deprecated, and the new one offers the ability to condition multiple operations together and nest control-flow in a general fashion." + ] + }, + { + "cell_type": "code", + "execution_count": 29, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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woULMWPGDJVtfvvtNwBA8+bNYWLy7CpffHw8CgoK4O3tDXPzin/gcMwWERFVtbLGbFlbOiIlMx4FRfkqXQnvPU5DfYlNnWvVAurGmC2qnjhmi3SqrPFapXUhDAxUf1+YnJwcXL16FcbGxvDzK7lxXXFxMSIjIwEAEyZMUNlGKpVi8+bNaverq5sZc8wWERFVtbLGbDV1bo2YKwdxOeUM/N07KZYXFObh+u0L8HfvXAVVVj8cs0U1EcMWqdAUqsozE6GmsHXx4kVIpVL4+fkpJrrIyclBcXHJFaq8PNXO60uWLFG0hr24X13dzJhjtoiIqKqVNWara4vh2Hp0Pnb9vVQpbP0etQ55hbkICxxdBVVWPxyzRfrCMVukMwUFBYiPj4dIJFIZC1WemQg1hS11ocnS0hJOTk5IS0vDvHnz8N1338HQ0BAFBQVYtmwZPvnkExgZGaGoqEiwli2O2SIioqpW1pitJg7+GNBhKvaeWok5m8LRplkfpNxJwJ6TyxHg3qXO3tCYY7aoJuKdYElJfHw8CgsL4eHhAQsLC6XHKtOypW68FgDMnj0bALB27Vo4OTmhdevWsLOzw+zZs7FixQrIZDKIRCKNrWyVbdkiIiKqjqYMWIrJ/b7Czcw4rNw9FccvbMOgkLfxxcQDMDDg1zeimoItW6REUxfC1NRU3L9/HzY2NnByclJ57MGDB7C2toazs7Pa/WoKW1OmTIGRkREWL16M5ORkGBoaol+/fpgxYwakUimKi4vh4eEBS0vLctVCRERUGxgaGGJolw8wtMsH+i6FiCpBJJPJZPougoiIiKiuKKsbIakX+g7YjZBqHLZDExERERERCYBhi4iIiIiISAAMW0RERERERAJg2CIiIiIiIhIAwxYREREREZEAGLaIiIiIiIgEwLBFREREREQkAIYtIiIiIiIiATBsERERERERCYBhi4iIiIiISAAMW0RERERERAJg2CIiIiIiIhIAwxYREREREZEAGLaIiIiIiIgEIJLJZDJ9F0FERERUV8hkgLRQ31XUPAbGgEik7yqItMOwRUREREREJAB2IyQiIiIiIhIAwxYREREREZEAGLaIiIiIiIgEwLBFREREREQkAIYtIiIiIiIiATBsERERERERCYBhi4iIiIiISAAMW0RERERERAJg2CIiIiIiIhIAwxYREREREZEAGLaIiIiIiIgEwLBFREREREQkAIYtIiIiIiIiATBsERERERERCYBhi4iIiIiISAAMW0RERERERAJg2CIiIiIiIhIAwxYREREREZEAGLaIiIiIiIgEwLBFREREREQkAIYtIiIiIiIiATBsERERERERCYBhi4iIiIiISAAMW0RERERERAJg2CIiIiIiIhLA/wG1fJjl1JqMkgAAAABJRU5ErkJggg==", + "text/plain": [ + "
" + ] + }, + "execution_count": 29, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qc_cond_meas = qc_bell.copy()\n", + "\n", + "with qc_cond_meas.if_test((final_measure[0], True)) as else_:\n", + " qc_cond_meas.x(qr[0])\n", + "with else_:\n", + " qc_cond_meas.x(qr[1])\n", + "\n", + "qc_cond_meas.measure(qr[0], final_measure)\n", + "qc_cond_meas.measure(qr[1], final_measure)\n", + "\n", + "qc_cond_meas.draw(\"mpl\", idle_wires=False)" + ] + }, + { + "cell_type": "code", + "execution_count": 30, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Runtime job id: cg7r24ikefmul9thmi9g\n", + "Job Status: job has successfully run\n", + "Preparation results: {'0': 30, '1': 970}\n" + ] + } + ], + "source": [ + "cond_meas_job = backend.run(qc_cond_meas, shots=1000, dynamic=True)\n", + "print(f\"Runtime job id: {cond_meas_job.job_id()}\")\n", + "job_monitor(cond_meas_job)\n", + "\n", + "cond_meas_result = cond_meas_job.result()\n", + "print(f\"Preparation results: {cond_meas_result.get_counts(0)}\")" + ] + }, + { + "cell_type": "code", + "execution_count": 31, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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ymq1qry83F4zGAzy8PCotF7Z3OmJnuiJnuiJnujJ/T1VRaMPhZLUoUMHl9s7dOig1NRUZWdnq02bNiopKdHx48d16623ymQyuRx/6X6vdgxX4y83d+5czZ4926melpamm266SZIUHh6url27au/evQ6rlJ06dVJUVJQyMzN18uRJez06OloRERHavn27iouL7fWYmBg1b95caWlpDt8AcXFx8vHxUUpKisMcBg8erHPnzmnLli32moeHh4YMGaKCggJlZGTY6/7+/urbt69yc3OVlZVlr4eGhqpnz57Kzs7WgQMH7HV6oid6oid6oid6ahg9Xfoc6itp8E80efXVVzV16lQlJydr7NixDtvWrl2rUaNGadq0aXrllVecXjtt2jQlJSXp448/1oMPPqhjx47p5ptvVq9evfTVV185jd+0aZMSEhI0adIkLViwQJLUsWNHZWdny2Kx2FN+BYvFIi8vL912223as2ePy/m7Wils06aNCgoK7HcVv1F/a6EneqIneqIneqKnuu+psLBQwcHBV32iSaNeKWwMvL295e3t7VT39PR0eI6kdPEbzNUK5uVh9Gr1y/dbk7rRaJTR6HzKaWX1yuZOT/RU3To90ZNET5XNsbp1eqInqfK5Ox2vSqMaqMDAQEkXH97tSsX5exXjqjv+aq9xNR4AAKAxatSh8Grn9F1+PqCvr69atWqlX375xWE5trLxVzvG1c5pBAAAaCwafShs3bq1du7cqZKSEodtJSUl2rlzp9q1a2e/8liSYmNj7dsul5qaKknq3bu3w3jp4oUhlY2vGAMAANBYNepQaDAY9MQTT+js2bN6+eWXHba9/PLLOnv2rMaPH+9QnzBhgqSL9zG8cOGCvf75559r69atSkhIcLhH4vDhwxUYGKiFCxcqLy/PXs/Ly9OiRYsUEhKiBx98sC7aAwAAqDcN8urjZcuW2a8O3rdvn7777jv16tVLv/vd7yRJd999t5544glJF1cEe/XqpT179ighIUHdunXTd999p7S0NPXo0UPbtm2Tj4+Pw/7Hjx+vZcuW6fe//72GDBmi48ePa/369fLz81NGRoY6duzoMH716tUaPXq0QkNDNWLECEnS+vXrVVBQoPXr1+vhhx+ucm9FRUUKDAy86hVAAAAAtaGq2aNBhsKxY8dq5cqVlW5PTEzUihUr7F+bzWbNmjVLH330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", + "text/plain": [ + "
" + ] + }, + "execution_count": 31, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram(cond_meas_result.get_counts(0))" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "A current limitation of conditional measurement is that you cannot extract the results from hardware, but you may still use the results.\n", + "\n", + "Above, we read out the result of the conditional measurement by conditionally applying a gate (here, conditional bit-flip) based on the conditional measurement result, and then applying an unconditional measurement.\n", + "\n", + "This constraint will be relaxed in the future." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "---" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "import qiskit.tools.jupyter\n", + "\n", + "%qiskit_version_table" + ] + } + ], + "metadata": { + "description": "Dynamic circuits basics with Qiskit", + "kernelspec": { + "display_name": "qss-compiler", + "language": "python", + "name": "qss-compiler" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.9.6" + }, + "orig_nbformat": 4, + "title": "Dynamic circuits basics with Qiskit", + "vscode": { + "interpreter": { + "hash": "86a2ed08605ee75a0ec8503ed2a4583ad82ebc8a8e91cda2d47d6ac6ca361db1" + } + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/docs/build/getting-started-with-dynamic-circuits.ipynb b/docs/build/getting-started-with-dynamic-circuits.ipynb new file mode 100644 index 0000000000..793d56f3e8 --- /dev/null +++ b/docs/build/getting-started-with-dynamic-circuits.ipynb @@ -0,0 +1,972 @@ +{ + "cells": [ + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Get started with dynamic circuits\n", + "\n", + "Welcome to the documentation and tutorials for dynamic circuits! Dynamic circuits are quantum circuits (or programs!) with not just the ability to apply gates and measurements to your qubits, but also to apply operations that are conditional on classical computations and measurement results within the coherence time of your qubits. [Dynamic circuits](https://medium.com/qiskit/a-new-openqasm-for-a-new-era-of-dynamic-circuits-87f031cac49) are a critical component of the [IBM Quantum hardware roadmap](https://research.ibm.com/blog/ibm-quantum-roadmap-2025).\n", + "\n", + "We aim to provide access to real-time classical control and compute integrated in a seamless way with your quantum algorithms. IBM Quantum computers support programming dynamic circuits with both [Qiskit](./dynamic-circuits-basics-with-qiskit) and [OpenQASM 3](./dynamic-circuits-basics-with-openqasm3). To see what features of OpenQASM 3 are currently supported in hardware, please see the [feature table here.](./feature-table)\n", + "\n", + "Adding support for these new quantum hardware and software capabilities is a large effort that spans through Qiskit, the cloud, Qiskit Runtime, kernel-level compiler (more details coming soon!), hardware runtimes, and control systems. Development is still ongoing and feedback/discussion is encouraged in our Slack channel [#dynamic-circuits](https://qiskit.slack.com/archives/C03KWBJ7E68) in the [Qiskit workspace](http://ibm.co/joinqiskitslack). Development is happening at a rapid pace and we expect to incorporate feedback quickly.\n", + "\n", + "\n", + " As we integrate new features and address feedback, changes may be rapid and possibly breaking.\n", + "\n", + "\n", + "If you have a question, first visit the [FAQs](#faqs) and see if it has already been answered. If you can’t find the answer there, please ask in our Slack channel [#dynamic-circuits](https://qiskit.slack.com/archives/C03KWBJ7E68) in the [Qiskit workspace](http://ibm.co/joinqiskitslack).\n" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Set up\n", + "\n", + "We will be using [Qiskit](https://qiskit.org/) throughout the tutorial.\n", + "This notebook will guide you through getting set up.\n", + "\n", + "The tutorial notebooks live in [IBM Quantum Lab](https://quantum-computing.ibm.com/lab/files/qiskit-tutorials/dynamic-circuits/). You will need to have an IBM Quantum account to use the Quantum Lab. If you do not already have one, [sign up for an IBM Quantum account](https://quantum-computing.ibm.com/).\n", + "\n", + "You can run these tutorials either in the cloud, or download them to run on your local machine." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Option 1 - Local Machine\n", + "\n", + "Log on to IBM Quantum Lab with your IBM Quantum account credentials.\n", + "\n", + "Download the [Dynamic circuits notebooks](https://quantum-computing.ibm.com/lab/files/qiskit-tutorials/dynamic-circuits/), including the ``figs/`` directory.\n", + "\n", + "Next, install Qiskit by following these [instructions](https://qiskit.org/documentation/getting_started.html).\n", + "\n", + "- Set up a Python virtual environment for the tutorial (good practice but not necessary).\n", + "- Make sure you have have the latest Qiskit installed. _(`qiskit-terra>=0.22` and `qiskit-ibm-provider>=0.1.0`)_\n", + " - `pip install jupyter matplotlib scipy`\n", + " - `pip install qiskit --upgrade`\n", + " - To update qiskit-terra, run `pip install qiskit-terra -U`\n", + " - `pip install qiskit-ibm-provider`\n", + "- Open up this notebook `\"Getting-started-with-Dynamic-Circuits.ipynb\"`, run to check your installation, and run your first OpenQASM 3 program on hardware." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Option 2 - Quantum Lab\n", + "\n", + "Open the tutorial in [Quantum Lab](https://quantum-computing.ibm.com/lab/files/qiskit-tutorials/dynamic-circuits/).\n", + "\n", + "Please make sure to verify that your `qiskit-terra` version `>=0.22.0` and that you are using the latest `qiskit-ibm-provider` version." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "import qiskit.tools.jupyter\n", + "%qiskit_version_table" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": {}, + "outputs": [], + "source": [ + "# Running checks for the correct dependencies\n", + "import qiskit\n", + "from packaging import version\n", + "\n", + "if not(version.parse(qiskit.__qiskit_version__[\"qiskit-terra\"]) >= version.parse(\"0.22\")):\n", + " print(\n", + " \"Incorrect dependencies. Found qiskit-terra: \"\n", + " + qiskit.__qiskit_version__[\"qiskit-terra\"]\n", + " + \"\\nNeed qiskit-terra >= 0.22\"\n", + " )\n", + "\n", + "try:\n", + " import qiskit_ibm_provider\n", + "except ModuleNotFoundError:\n", + " print(\n", + " \"You must install the qiskit_ibm_provider with 'pip install qiskit_ibm_provider'\"\n", + " )\n", + " raise" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": {}, + "outputs": [], + "source": [ + "# Ignoring warnings\n", + "import sys\n", + "import warnings\n", + "\n", + "if not sys.warnoptions:\n", + " warnings.simplefilter(\"ignore\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The notebook is ready to run!" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Testing OpenQASM 3 support\n", + "\n", + "Let's test out our installation by verifying we have access to the code and hardware necessary.\n", + "\n", + "First, load our backend.\n", + "\n", + "To view the simulators and systems supporting dynamic circuits that you can access, [click here (requires the user to be logged in to IBM Quantum)](https://quantum-computing.ibm.com/services/resources?tab=yours&openqasm3=true).\n", + "\n", + "**Note**: This can be *any* hub/group/project that has access to the required device and the Qiskit runtime and has OpenQASM 3 support" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": {}, + "outputs": [], + "source": [ + "# Note: This can be any hub/group/project that has access to the required device and the Qiskit runtime.\n", + "hub = \"\"\n", + "group = \"\"\n", + "project = \"\"\n", + "backend_name = \"\"\n", + "hgp = f\"{hub}/{group}/{project}\"" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Next, we load our IBM Quantum account credentials." + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": {}, + "outputs": [], + "source": [ + "import qiskit\n", + "from qiskit_ibm_provider import IBMProvider\n", + "\n", + "# Save token if necessary\n", + "# IBMProvider.save_account(token='MY_API_TOKEN')\n", + "\n", + "# Get our backend\n", + "provider = IBMProvider()\n", + "backend = provider.get_backend(backend_name, instance=hgp)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Make sure to use any OpenQASM 3-enabled backend." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "qasm3_backends = set(\n", + " backend.name for backend in provider.backends(dynamic_circuits=True)\n", + ")\n", + "\n", + "print(f\"The following backends support dynamic circuits: {qasm3_backends}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now we prepare our circuit." + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": {}, + "outputs": [], + "source": [ + "qubit = 0\n", + "shots = 1000" + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "execution_count": 8, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "from qiskit import QuantumCircuit\n", + "\n", + "h_qc = QuantumCircuit(1, 1, name=\"|+> Prep\")\n", + "h_qc.h(0)\n", + "h_qc.measure(0, 0)\n", + "h_qc.draw(idle_wires=False, output=\"mpl\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Next, transpile our quantum circuit for the hardware basis gates." + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "execution_count": 9, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "from qiskit import transpile\n", + "\n", + "h_qc_transpiled = transpile(h_qc, backend, initial_layout=[1])\n", + "h_qc_transpiled.draw(idle_wires=False, output=\"mpl\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now we submit our circuit to the backend to verify it is working." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that we have to set `dynamic=True` to communicate to the backend that we want to run a dynamic circuit." + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Your job's id: cdi1j0557v9vkk45o5cg\n", + "|+> preparation results: {'0': 506, '1': 494}\n" + ] + } + ], + "source": [ + "job = backend.run(h_qc_transpiled, shots=shots, dynamic=True)\n", + "print(f\"Your job's id: {job.job_id()}\")\n", + "result = job.result()\n", + "print(f\"|+> preparation results: {result.get_counts(0)}\")" + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "metadata": {}, + "outputs": [], + "source": [ + "job.error_message()" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "import qiskit.tools.jupyter\n", + "%qiskit_version_table" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Run a dynamic circuit\n", + "\n", + "This tutorial introduces the current dynamic circuit support through Qiskit on IBM Quantum hardware.\n", + "\n", + "Dynamic circuits are quantum circuits that contain mid-circuit measurements that affect the control flow of gate execution later in the circuit, otherwise known as feed-forward operations. The canonical and most simple example is conditional reset, where we perform a projective measurement of the qubit, and if the result is a 1, we flip the state using an X-gate from the $|1\\rangle$ to the $|0\\rangle$ state. If the result is a 0 we do nothing, as we are already in $|0\\rangle$.\n", + "\n", + "Dynamic circuit support requires significant changes to the hardware and software backends that execute quantum circuits, compared to traditional 'static' circuits. Many of IBM Quantum's hardware backends have been upgraded to support dynamic circuits. To view the simulators and systems supporting dynamic circuits that you can access, [click here (requires the user to be logged in to IBM Quantum)](https://quantum-computing.ibm.com/services/resources?tab=yours&openqasm3=true). Support for dynamic circuits will continue to grow and improve in ease of use and efficiency." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "import warnings\n", + "warnings.filterwarnings(\"ignore\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + " Before running this notebook, make sure to the follow the [steps to get started](#get-started-with-dynamic-circuits), to verify you are set up to run dynamic circuit programs on IBM hardware.\n", + "\n" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Step 1: Load backend\n", + "\n", + "Backends provide a handle to the quantum hardware instance. The main approach for running circuits will be to call `backend.run(, dynamic=True)`. Backends are obtained from the ``IBMProvider`` imported from ``qiskit_ibm_provider``, and are specified by a system name along with the ``hub/group/project`` string that gives you access to that system." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "# Note: This can be any hub/group/project that has access to the required device and Qiskit Runtime.\n", + "hub = \"\"\n", + "group = \"\"\n", + "project = \"\"\n", + "backend_name = \"\"\n", + "hgp = f\"{hub}/{group}/{project}\"" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "from qiskit_ibm_provider import IBMProvider\n", + "\n", + "provider = IBMProvider()\n", + "backend = provider.get_backend(backend_name, instance=hgp)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "**Load a simulator backend**\n", + "\n", + "We can also use a simulator to simulate the behavior of dynamic circuits. We obtain a simulator backend similarly to a hardware backend." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "from qiskit import Aer\n", + "backend_sim = Aer.get_backend('aer_simulator')" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Step 2: Write a dynamic circuit with Qiskit\n", + "\n", + "We start with a conditional reset circuit on a single qubit. We first try to excite the qubit with an X-gate followed by a measurement, and another X-gate if the measurement returns a 1.\n", + "\n", + "In older versions of Qiskit, limited conditional execution was supported using the `c_if()` construct. This was a function that all gate objects exposed, which allowed gate execution to be conditioned on the value of a classical register. A significant limitation was that only a single gate could be conditioned on the classical register value.\n", + "\n", + "In contrast, the new style of classical control flow with the `if_test()` allows significantly more flexibility in the values that can be conditioned on and the sub-circuits that can be defined within the body of the `if_test()`. It also enables ``else`` conditions. More documentation on the `if_test()` is [available here](/api/qiskit/qiskit.circuit.QuantumCircuit#if_test)." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "from qiskit import QuantumCircuit, QuantumRegister, ClassicalRegister\n", + "from qiskit import transpile\n", + "\n", + "qr = QuantumRegister(1)\n", + "crx = ClassicalRegister(1, name=\"xresult\")\n", + "crm = ClassicalRegister(1, name=\"measureresult\")\n", + "qc_reset = QuantumCircuit(qr, crx, crm, name=\"Reset\")\n", + "qc_reset.x(0)\n", + "qc_reset.measure(0, crx)\n", + "# qc_reset.x(0).c_if(crx, 1) # old style conditional gate\n", + "with qc_reset.if_test((crx, 1)): # new style conditional block (more flexible)\n", + " qc_reset.x(0)\n", + "qc_reset.measure(0, crm)\n", + "\n", + "qc_reset = transpile(qc_reset, backend, initial_layout=[0])\n", + "qc_reset.draw(output=\"mpl\", idle_wires=False)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Step 3: Run conditional reset in a simulator\n", + "\n", + "Running on the simulator is very similar to running on the hardware." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "fda596f0-0c54-4db0-9cf7-104f1f1bcd5c\n" + ] + } + ], + "source": [ + "reset_sim_job = backend_sim.run(qc_reset)\n", + "print(reset_sim_job.job_id())" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Full counts including reset: {'0 1': 1024}\n" + ] + } + ], + "source": [ + "reset_sim_result = reset_sim_job.result()\n", + "reset_sim_counts = reset_sim_result.get_counts(0)\n", + "print(f\"Full counts including reset: {reset_sim_counts}\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Step 4: Run conditional reset on hardware\n", + "\n", + "Now we run our conditional reset program on the backend. We turn off the automatic qubit initialization provided by the backend so that we can examine the results of our reset program directly." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "cdl97lvtlcfkm5f2pnb0\n" + ] + } + ], + "source": [ + "reset_job = backend.run(qc_reset, dynamic=True, init_qubits=False) # Turn off automatic init\n", + "print(reset_job.job_id())" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Let's understand the results:" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Full counts including reset: {'0 0': 87, '0 1': 3290, '1 0': 20, '1 1': 603}\n", + "Results from our reset - |0>s prepared 3377, |1>s prepared 623\n" + ] + } + ], + "source": [ + "from qiskit.result import marginal_counts\n", + "\n", + "reset_result = reset_job.result()\n", + "reset_counts = reset_result.get_counts(0)\n", + "mitigated_reset_results = marginal_counts(reset_counts, indices=[1])\n", + "print(f\"Full counts including reset: {reset_counts}\")\n", + "print(\n", + " f\"Results from our reset - |0>s prepared {mitigated_reset_results.get('0')}, |1>s prepared {mitigated_reset_results['1']}\"\n", + ")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Step 5: Conditional Reset with OpenQASM 3\n", + "\n", + "Another way to write the same circuit above is to use [OpenQASM 3](https://arxiv.org/abs/2104.14722), a quantum assembly language well-suited to describing dynamic circuits. The [live specification](https://openqasm.com/) provides full details. Qiskit provides support to directly convert `QuantumCircuit` objects into OpenQASM 3.0 strings." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "OPENQASM 3;\n", + "bit[1] xresult;\n", + "bit[1] measureresult;\n", + "x $0;\n", + "xresult[0] = measure $0;\n", + "if (xresult == 1) {\n", + " x $0;\n", + "}\n", + "measureresult[0] = measure $0;\n", + "\n" + ] + } + ], + "source": [ + "try:\n", + " from qiskit import qasm3\n", + "except ImportError:\n", + " print(\n", + " \"You likely do not have the latest version of Qiskit installed. Please install it to run this code\"\n", + " )\n", + " raise\n", + "\n", + "\n", + "def dump_qasm3(circuit, backend=backend):\n", + " return qasm3.Exporter(\n", + " includes=[],\n", + " basis_gates=backend.configuration().basis_gates,\n", + " disable_constants=True,\n", + " ).dumps(circuit)\n", + "\n", + "\n", + "qc_reset_qasm3 = dump_qasm3(qc_reset)\n", + "print(qc_reset_qasm3)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "**Note:** The names of the classical registers (`xresult` and `measureresult`) in the ``qasm3`` string above are the same as those provided when the circuit was first constructed. These make the OpenQASM 3 string much more human-readable." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Step 6: Submit an OpenQASM 3 string directly\n", + "\n", + "It is also possible to submit an OpenQASM 3 string directly instead of a `QuantumCircuit` object.\n", + "\n", + "This is useful when the `QuantumCircuit` does not yet support all of the semantics of OpenQASM 3. To see what features of OpenQASM 3 are currently supported in hardware, please see the [feature table here](./feature-table).\n", + "\n", + "See [Dynamic circuits basics with OpenQASM 3](./dynamic-circuits-basics-with-openqasm3) for more information.\n", + "\n", + "**Note**: We cannot use circuit merging when OpenQASM 3 source strings are submitted. In this case each OpenQASM 3 source will run individually." + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "cdl97rtf14jb6brio7q0\n" + ] + } + ], + "source": [ + "qasm3_job = backend.run(qc_reset_qasm3, dynamic=True)\n", + "print(qasm3_job.job_id())" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "{'0': 110, '1': 2783, '10': 35, '11': 1072}\n" + ] + } + ], + "source": [ + "print(qasm3_job.result().get_counts())" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## FAQs\n", + "\n", + "### General\n", + "\n", + "#### Where should I ask further questions?\n", + "\n", + "Ask your questions in the Slack channel [#dynamic-circuits](https://qiskit.slack.com/archives/C03KWBJ7E68) in the [Qiskit workspace](http://ibm.co/joinqiskitslack).\n", + "\n", + "#### Whom is dynamic circuit support available to?\n", + "\n", + "All users with access to backends that support this capability. Primarily, this is limited to **some** exploratory system clients. You can verify if backend support is available by filtering `provider.backends(dynamic_circuits=True)`. To view the simulators and systems supporting dynamic circuits that you can access, [click here (requires the user to be logged in to IBM Quantum)](https://quantum-computing.ibm.com/services/resources?tab=yours\\&openqasm3=true).\n", + "\n", + "#### What are the primary use cases for dynamic circuits?\n", + "\n", + "Dynamic circuits are critical for algorithms such as quantum error correction (QEC). In general, there are broad classes of quantum algorithms that exchange quantum resources for classical resources to construct exotic quantum channels.\n", + "\n", + "### Hardware platforms\n", + "\n", + "#### What systems have support for dynamic circuits?\n", + "\n", + "Any backend reporting support in the provider `provider.backends(dynamic_circuits=True)`.\n", + "\n", + "#### Which systems will be supported?\n", + "\n", + "Gradually support will be rolled out to most but not all deployed systems depending on control-system capabilities.\n", + "\n", + "### Capabilities\n", + "\n", + "#### Which gate types are supported?\n", + "\n", + "Currently only direct drive single-qubit, and cross-resonance two-qubit gates are supported.\n", + "\n", + "#### What circuit scheduling protocol is used on the backend?\n", + "\n", + "The quantum circuit model only specifies the dependency graph for circuit operations that are applied to qubits. This means that the timing of circuit operations *is not fully constrained* unless the duration of all operations is known *a priori* and operations are applied within a program such that no qubits remain idle (including delays). To fully resolve this timing degree of freedom within a circuit, the compiler applies a *scheduling policy*. You may be familiar with [scheduling policies in Qiskit](https://qiskit.org/documentation/tutorials/circuits_advanced/07_pulse_scheduler.html).\n", + "\n", + "Currently backends apply a default policy of ALAP (as-late-as-possible) scheduling.\n", + "\n", + "```qasm\n", + "x $0;\n", + "delay[1s] $1;\n", + "bit result = measure $0;\n", + "```\n", + "\n", + "Currently there are limitations on what portions of your program may be scheduled. See [below](#can-i-do-dynamical-decoupling) to learn more about these.\n", + "\n", + "In the future we will support both scheduling procedures with the advent of the pulse dialect.\n", + "\n", + "#### Can I do dynamical decoupling?\n", + "\n", + "The full scheduling capabilities that are supported in Qiskit are not one-for-one available due to the implementation details of making measurement results available in real-time. You *can* schedule blocks of gates, and they will behave as expected up until a reset or control-flow (if/else/for/while) transition occurs, which will trigger a non-deterministic delay, followed by the next deterministic gating section.\n", + "\n", + "For more information on how to use dynamical decoupling with dynamic circuits, see the [Dynamic Circuit scheduling support](https://qiskit.org/documentation/partners/qiskit_ibm_provider/stubs/qiskit_ibm_provider.transpiler.passes.scheduling.html#module-qiskit_ibm_provider.transpiler.passes.scheduling) in the Qiskit IBM Provider.\n", + "\n", + "#### Are parametric programs supported?\n", + "\n", + "These are not yet supported (although defined within the OpenQASM 3 language). Support will be coming in 2023.\n", + "\n", + "#### Can I submit multiple circuits at once?\n", + "\n", + "You can submit multiple circuits at once to the `qasm3-runner`. These will be merged into a single circuit for execution with reset sequences separating each circuit and result post-processing to separate out the individual circuit’s results.\n", + "\n", + "#### Are single/two-qubit gates performed in parallel across qubits?\n", + "\n", + "Yes.\n", + "\n", + "#### Are measurements performed in parallel across qubits?\n", + "\n", + "Yes, measurements that occur are independent when [topologically ordered](https://en.wikipedia.org/wiki/Topological_sorting) within a code-block are applied in parallel. For example:\n", + "\n", + "```qasm\n", + "// In parallel\n", + "measure $0;\n", + "measure $1;\n", + "\n", + "// In Parallel\n", + "measure $0;\n", + "x $2;\n", + "measure $1;\n", + "```\n", + "\n", + "#### How are resets implemented?\n", + "\n", + "All resets use a conditional reset implementation with a single round of measurement/gating. As these require a conditional operation, there is currently a synchronization of the hardware required at the end of the reset which has an indeterministic duration.\n", + "\n", + "#### Do resets take the same time as other conditional logic in the hardware?\n", + "\n", + "No, resets use a fast path in the hardware. In general, *any* `if` statement with a test condition depending directly on a qubit measurement result, with block contents containing only operations applied to the qubit generating the measurement result, will not require synchronization in between (after a short delay between the measurement end and the start of gating).\n", + "\n", + "```qasm\n", + "// uses fast-path\n", + "bit result = measure $0;\n", + "if (result == 1){\n", + " x $0;\n", + "}\n", + "\n", + "// uses fastpath as decomposed to the above\n", + "// in the compiler\n", + "reset $0;\n", + "\n", + "// does not use fast path\n", + "// however the result is already available\n", + "// from the previous synchronization above\n", + "// and no hardware synchronization is required\n", + "if (result == 1){\n", + " x $0;\n", + "}\n", + "\n", + "// does not use hardware fast-path\n", + "// as different qubits are used between\n", + "// measurement and gates. A global\n", + "// decision (slower) is instead required.\n", + "result = measure $0;\n", + "if (result == 1){\n", + " x $1;\n", + "}\n", + "```\n", + "\n", + "#### Do resets occur in parallel?\n", + "\n", + "If the reset test conditions follow a parallel measurement, they will occur in parallel along the fast-path.\n", + "\n", + "```qasm\n", + "// In parallel along fastpath\n", + "bit res0 = measure $0;\n", + "bit res1 = measure $1;\n", + "\n", + "if (res0 == 1) {\n", + " x $0;\n", + "}\n", + "if (res1 == 1) {\n", + " rz(3.15) $1;\n", + "}\n", + "\n", + "// Not in parallel along fastpath\n", + "// As the control-flow operations\n", + "// do not directly follow\n", + "// their measurement\n", + "bit res1 = measure $1;\n", + "barrier $1;\n", + "bit res0 = measure $0;\n", + "\n", + "if (res1 == 1) {\n", + " x $1;\n", + "}\n", + "if (res0 == 1) {\n", + " rz(3.15) $0;\n", + "}\n", + "```\n", + "\n", + "#### Are my qubits initialized for me?\n", + "\n", + "Yes, see the Qiskit IBM Provider documentation for [available run options](https://qiskit.org/documentation/partners/qiskit_ibm_provider/stubs/qiskit_ibm_provider.IBMBackend.run.html#qiskit_ibm_provider.IBMBackend.run).\n", + "\n", + "#### Are nested measurements in control-flow possible?\n", + "\n", + "Yes, you are able to use measurements within control-flow to conditionally measure gates and apply conditional operations based on the measurement outcome. Currently you cannot retrieve the measurement result of conditional measurements; this will be resolved in 2023.\n", + "\n", + "#### The circuit quality of my dynamic circuits are worse than through the standard Qiskit path.\n", + "\n", + "This could be a bug! Please report it to the [#dynamic-circuits Slack channel](https://qiskit.slack.com/archives/C03KWBJ7E68) in the [Qiskit workspace](http://ibm.co/joinqiskitslack).\n", + "\n", + "#### Will hardware support OpenQASM 3 floating point types?\n", + "\n", + "Initially, real-time floating point types will not be supported. When support is added, it will begin will constant floating types, which may be handled at compile time. If real-time support is added, classical calculations involving floats will be slow, as it will be necessary to use soft math. Initially, real-time floats will likely be used as inputs to gate arguments, such as in the case of measurement-dependent rotation angles.\n", + "\n", + "### OpenQASM 3\n", + "\n", + "#### Where can I learn more about OpenQASM 3?\n", + "\n", + "See the [specification](https://openqasm.com/) and [the white paper](https://arxiv.org/abs/2104.14722).\n", + "\n", + "#### What OpenQASM 3 capabilities are currently supported?\n", + "\n", + "See the [feature table](./feature-table) page for more information.\n", + "\n", + "#### Why does the backend not support OpenQASM 3 with non-physical qubits, gate definitions, scheduling, etc.?\n", + "\n", + "OpenQASM 3 was designed conceptually as a [multi-level IR](https://arxiv.org/abs/2104.14722). The backend compiler is designed to accept input that is specified at the last layer of this IR (the physical layer) and is designed to work on physical quantum circuits. It is more akin to a quantum assembler (e.g., to execute as faithfully as possible the program you specify) for a quantum computer and its control systems - not a full-fledged language compiler. To that end, it is designed to work with Qiskit/other intermediate quantum optimization toolchains that may target it as output and know that what they emit is what will be executed. For now we would recommend optimizing your circuits first in Qiskit with its transpiler to lay out the circuit for the target basis gates and coupling map.\n", + "\n", + "#### Can I use pulse with OpenQASM 3?\n", + "\n", + "No, the pulse support development is in progress. This will support gate calibrations in the presence of control-flow in a scalable and expressible way. The user interface from OpenQASM will be based on the [OpenPulse Grammar](https://openqasm.com/language/openpulse.html).\n", + "\n", + "#### Can I submit textual OpenQASM 3 programs instead of Qiskit circuits?\n", + "\n", + "Yes, see [Dynamic Circuits basics with OpenQASM 3](./dynamic-circuits-basics-with-openqasm3).\n", + "\n", + "#### How must OpenQASM 3 source programs be structured?\n", + "\n", + "Input OpenQASM 3 source programs have these limitations:\n", + "\n", + "* All operations must use physical qubits, eg., `cx $0, $1;`.\n", + "* No symbolic algebra is supported, e.g., `pi/2`.\n", + "* Must only use the backend’s basis gates (use the Qiskit transpiler to perform this conversion).\n", + "* Limited capabilities are [supported](#what-openqasm-3-capabilities-are-currently-supported).\n", + "\n", + "#### Are barriers being parsed properly from Qiskit down to the hardware?\n", + "\n", + "Yes.\n", + "\n", + "#### Are delays being parsed properly from Qiskit down to the hardware?\n", + "\n", + "Yes, delays on qubits are currently supported with units of `dt`, `us`, `ms` and `s`.\n", + "\n", + "#### Will every identical classical operation take the same amount of time in a circuit?\n", + "\n", + "It is reasonable to assume that the same classical condition will take the same amount of time to evaluate, on average, when it occurs multiple times in the circuit. While the control system is deliberately designed to reduce them, there are still sources of (small) nondeterminism, so that the actual execution time may differ slightly between each occurrence.\n", + "\n", + "#### Is there a way to find out after the fact how long each fast-forward operation took?\n", + "\n", + "There is currently no mechanism to gather that information from Qiskit. We can collect timing information for a limited scope, ie., there is not the capability to record an entire execution, but only a small section of one. This capability is limited to internal users.\n", + "\n", + "### Qiskit\n", + "\n", + "#### Why are classical capabilities limited in Qiskit?\n", + "\n", + "Qiskit was not originally designed to support dynamic circuits. These features were initially tacked on, and an extensive re-design is currently in progress. Consequently, the user-facing APIs and transpiler support are limited. At times we may require the usage of specific Qiskit releases and/or Git branches to enable rapid development of new dynamic circuit capabilities.\n", + "\n", + "#### How are results returned?\n", + "\n", + "Results are currently returned through the standard Qiskit [result object](/api/qiskit/qiskit.result.Result). This does not necessarily align with the OpenQASM 3 [input/output model](https://openqasm.com/language/directives.html?#input-output), and work is underway to fix this.\n" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Dynamic circuits tutorials\n", + "\n", + "Work through these interactive tutorials in IBM Quantum Learning:\n", + "\n", + "* [Quantum teleportation](https://learning.quantum-computing.ibm.com/tutorial/quantum-teleportation)\n", + "* [Iterative phase estimation](https://learning.quantum-computing.ibm.com/tutorial/iterative-phase-estimation)\n", + "* [Bit-flip repetition code](https://learning.quantum-computing.ibm.com/tutorial/bit-flip-repetition-code)\n", + "* [Repeat until success](https://learning.quantum-computing.ibm.com/tutorial/repeat-until-success)" + ] + } + ], + "metadata": { + "description": "Get started with dynamic circuits", + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.8.9 (default, Apr 13 2022, 08:48:06) \n[Clang 13.1.6 (clang-1316.0.21.2.5)]" + }, + "title": "Get started with dynamic circuits", + "vscode": { + "interpreter": { + "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6" + } + } + }, + "nbformat": 4, + "nbformat_minor": 4 +} diff --git a/docs/build/midcircuit_measurement.ipynb b/docs/build/midcircuit_measurement.ipynb new file mode 100644 index 0000000000..55c437aecc --- /dev/null +++ b/docs/build/midcircuit_measurement.ipynb @@ -0,0 +1,1056 @@ +{ + "cells": [ + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Mid-circuit measurement" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "IBM Quantum users can perform multiple measurements in a circuit and at any point throughout the circuit. This enables immediate use cases such as heralding and monitoring qubit evolution. Together with [conditional reset](./backend_reset), this provides a powerful initial framework for real-time compute.\n", + "\n", + "This notebook provides several examples demonstrating how to perform mid-circuit measurements on IBM Quantum backends. We show a simple circuit, mixing of `reset` and mid-circuit measurements, and a GHZ to Bell state example." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "
\n", + "\n", + "Support for real-time conditionals (i.e., if statements) are enabled on **some** exploratory backends as outlined in the [OpenQASM 3](https://openqasm.com/) specification. Please see the [Dynamic circuits](./getting-started-with-dynamic-circuits) documentation for how to access these new capabilities in hardware.\n", + " \n", + "If your backends do not support this, the equivalent behavior can be produced by inserting a mid-circuit measurement and post selecting results of interest.\n", + " \n", + "
" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": {}, + "outputs": [], + "source": [ + "import sys\n", + "import warnings\n", + "\n", + "import matplotlib.pyplot as plt\n", + "\n", + "import qiskit\n", + "from qiskit_ibm_provider import IBMProvider\n", + "from qiskit import QuantumCircuit, execute, Aer\n", + "from qiskit.result import marginal_counts\n", + "from qiskit.providers.ibmq.job import job_monitor\n", + "from qiskit.tools.visualization import plot_histogram" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": {}, + "outputs": [], + "source": [ + "IBMProvider()\n", + "\n", + "# Fill in your hub/group/provider\n", + "provider = IBMProvider(instance=\"your_hub/your_group/your_provider\") \n", + "# ibmq_manhattan supports mid-circuit measurements\n", + "backend = provider.get_backend('ibmq_manhattan')\n", + "\n", + "config = backend.configuration()\n", + "n_qubits = config.n_qubits" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Here `config` is the `backend.configuration()` that will be referenced throughout this tutorial." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "
\n", + "\n", + " \n", + "**Info:** These features require `qiskit>0.22.0` as they rely on `qiskit-terra>0.16.0`. If required, you can install the latest version of qiskit by uncommenting and running the line below.\n", + "
" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": {}, + "outputs": [], + "source": [ + "#!pip install qiskit -U" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "import qiskit.tools.jupyter\n", + "%qiskit_version_table" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Checking the backend" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We begin by checking if this backend supports mid-circuit measurements. A boolean flag is provided in `config`, `multi_meas_enabled`, which defines whether this feature is supported. If the flag is `False`, the old restrictions of a single, final measurement apply." + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 5, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "config.multi_meas_enabled" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Simple circuit" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The first circuit is a simple sequence of single-qubit operations: `x(0) -> measure(0,1) -> barrier(0,1) -> x(1) -> measure(0,1)`. It is given below." + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "" + ] + }, + "execution_count": 6, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qc_simp = QuantumCircuit(2,4)\n", + "qc_simp.x(0)\n", + "qc_simp.measure([0,1], [0,1])\n", + "qc_simp.barrier([0, 1])\n", + "qc_simp.x(1)\n", + "qc_simp.measure([0,1], [2,3])" + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": { + "scrolled": true + }, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "execution_count": 7, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qc_simp.draw(output=\"mpl\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "**NOTE**: In order to store the different measurement results, we must allocate additional memory slots. The Qiskit `measure` command has the syntax `measure(qubits, mem_slots`). In the above circuit, the first measurement is on qubits `[0,1]` and results are stored in memory slots `[0,1]`. The second measurement is on qubits `[0,1]` as well, but the results are stored in memory slots `[2,3]`. \n", + "\n", + "**If new memory slots are not provided, the old result will be overwritten.**" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We expect that state $|01\\rangle$ after the first measurement since `x(0)` flips qubit `0` to the $|1\\rangle$ state (recall, Qiskit uses little endian bit ordering). We then expect $|11\\rangle$ after the second measuremement as `x(1)` flips qubit `1` to the $|1\\rangle$ state." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "
\n", + "**Info:** \n", + "The backend will attempt to merge `measure`s on separate qubits following standard commutation rules. This provides significant speedups as the number of measurements scale.\n", + "
" + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "5ff73f48db39ac7bfc928a32\n", + "Job Status: job has successfully run \n" + ] + } + ], + "source": [ + "simp_job = execute(qc_simp, backend=backend)\n", + "print(simp_job.job_id())\n", + "job_monitor(simp_job)" + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Meas 1 result: {'00': 51, '01': 970, '11': 3}\n", + "Meas 2 result: {'00': 2, '01': 28, '10': 148, '11': 846}\n" + ] + } + ], + "source": [ + "simp_counts1 = marginal_counts(simp_job.result(), indices=[0,1]).get_counts()\n", + "simp_counts2 = marginal_counts(simp_job.result(), indices=[2,3]).get_counts()\n", + "print(\"Meas 1 result: \", simp_counts1)\n", + "print(\"Meas 2 result: \", simp_counts2)" + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": { + "scrolled": true + }, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAr4AAAFKCAYAAAD7bFznAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8vihELAAAACXBIWXMAAAsTAAALEwEAmpwYAABJeklEQVR4nO3deXxU1d3H8c8vCQmBhABhDUECBAkJGJZQxCIglWJRsQXFDS1FENzQB/tUtG6tS7UuJRWUSuuKiLW2j9aiaEU2pcGwyS5KQBJWIZAEQiDJef6YSRpCgEQmmSTzfb9e83Luveec+7s5hvzmzLnnmnMOEREREZH6LsjfAYiIiIiI1AQlviIiIiISEJT4ioiIiEhAUOIrIiIiIgFBia+IiIiIBAQlviIiIiISEJT4ipwFM1tvZoPN7GEzm+3veGqKmb1iZo/6Ow4REZGqUOIrchacc0nOuYX+jqMuqehDgpktNLPx/opJREQCgxJfEREREQkISnxFzoKZbTOzi72bDc3sLTPLNbOVZpZcrtz/mtmXZnbYzP5iZq3N7ANv+X+bWbMy5W8ws+1mtt/Mfl3uPKeK5WEze9vMZnvbXGtm55rZvWa218x2mNmPy5T/hZlt9JbdamYTyxwbbGaZZna3t+4uM/tFuVM2M7N/eeunmVnnMvVTvefLMbMVZnahd/8lwH3A1WaWZ2ZrzOwx4EJgunff9NO1UeZa/2pmr3nPv97MUirfcyIiEoiU+Ir4zhXA20BzYA7wf2bWoMzxUcBQ4FzgcuADPElgCzy/i5MBzCwReAG4AYgBooHYSsZwOfA60AxYBcz3tt0O+C3wpzJl9wKXAU2AXwB/MLPeZY63AaK8dW8CZpRNzoFrgd94z/U18FiZY18APcv8LN42s4bOuQ+Bx4G3nHMRzrlk59yvgSXA7d59t5+ujTLnGAHMBZoC7wHTK/kzEhGRAKXEV8R3Vjjn/uacOw48CzQEzi9z/Dnn3B7nXBaeRC/NObfKOVcA/APo5S13JfC+c26x99gDQHElY1jinJvvnCvEk4S3BJ7wxjQXiDOzpgDOuX85575xHouAj/CMvJY4DvzWOXfcOTcPyAO6ljn+d+fccu+53sCTpOJte7Zzbr9zrtA59wwQVq7uGVWijaXOuXnOuSI8yX5yhQ2JiIh4KfEV8Z0dJW+cc8VAJp4R2xJ7yrzPr2A7wvs+plxbh4H9lYyhfJvfeRPDkm1KzmNmPzGz/5jZATM7CAzHM/pcYr83qS1xpEyMALtPdcw7RWKjmR3yth1Vru0zqkQb5c/f0MxCqnIOEREJLEp8RXynfckbMwvCMz1h5/doZ1e5thrhme7gM2YWBrwDPA20ds41BeYB5oO2LwTuAUYDzbxtHyrTtqug2gn7KtGGiIhIlSnxFfGdPmY20jvqeBdQAPzne7TzN+AyMxtgZqF45ub6+nc1FM/UgX1AoZn9BPjx6atUWiRQ6G07xMwexDOPuMQePFMugsrt61SFNkRERKpMia+I77wLXA1k47kxbaR3bm2VOOfWA7fhuaFrl7e9TB/GiXMuF8/NdH/1tn8dnhvEfGE+nhv3vgK2A0cpM3UDz9xjgP1mttL7PhW40syyzeyPlWhDRESkysy5ir51FJHaxMy2AeOdc//2dywiIiJ1lUZ8RURERCQgKPEVqUO8D7zIq+B1n79jExERqe001UFEREREAoJGfEVEREQkICjxFREREZGAENBPOWrRooWLi4vzdxgiIlKLrFix4jvnXMsy261CQkL+DHRHA0YitVkxsK6wsHB8nz599lZUIKAT37i4ONLT0/0dhoiI1CJmtr3sdkhIyJ/btGnTrWXLltlBQUG6MUakliouLrZ9+/Yl7t69+8/AiIrK6JOriIjI6XVv2bJljpJekdotKCjItWzZ8hCeb2cqLlOD8YiIiNRFQUp6ReoG7+/qKfNbJb4iIiIiEhCU+IqIiNRTTz31VItx48a1r0zZRx99tNWtt97arrpjqg6XX355x9dff72pr9t94403oi677LJOvm5X/Cegb24TERH5PiZMo091tj/rLlacbRtHjx61Z555JmbZsmUbS/Z9/vnn4RMmTIjbunVrw06dOh2dNWvWtgsuuCAfYMqUKfs6duzY49e//vWedu3aFZ7t+WtKWlpa+IYNGxpdf/31GSX7Zs6c2fy3v/1tu+zs7JAf/vCHOW+88ca21q1bF1VU/84774z54IMPmm7dujV88uTJu5599tmdJceuv/76Qw8//HBsWlpaeL9+/fJr4nqkemnEV0REpB6aM2dO006dOuV37NjxOHgS4SuvvDJ+9OjR+w8cOLD62muv3X/llVfGHz161AAaNWrkLrrookN/+tOfov0bedVMnz695ZVXXrk/KMiT0qSnpze8++67O/zlL3/J2L1795rw8PDim266qcOp6sfHxxc8+uijmYMGDTpY0fGRI0funzFjRsuKjkndo8RXRESkDlq/fn1YVFRUz6VLlzYC2LZtW4NmzZolv//++5EAH3zwQdSAAQPySsrPmzcvsrCw0B544IG94eHh7v7779/rnKOkPMCgQYNy58+fH1WyPWbMmHPGjBlzzqliMLM+TzzxRMsOHTp0b9y4ca8777wzZv369WE9e/ZMiIiI6DV8+PBOJYk1wJtvvhmVkJCQGBkZ2bNXr14JaWlp4SXH7rvvvjbt27fv3rhx416dO3dOeu2115qWHFu3bl1Y3759u0ZGRvZs1qxZ8qWXXlo6/eDTTz+NGjJkSOl1vvLKK9FDhgw5+JOf/CQvKiqq+Iknntg5f/78ptnZ2RXmPHfcccf+0aNH50RERBRXdPxHP/pR7ieffBJV0TGpe5T4ioiI1EFJSUkFDz74YOaNN97YMTc3N2jMmDFxV1111f7LLrssF2Djxo3hCQkJR0vKr127tmFCQkJ+ycgoQEJCQv7atWtLk88ePXoc3bRpU6OS7dmzZ387e/bsb08Xx0cffRS1atWqDYsWLdr4wgsvtBk/fnyHOXPmbN2+ffuXmzdvDp81a1ZzgKVLlza67bbb4p5//vnt2dnZq8eNG7dv5MiR8fn5+QaekdclS5ZszsnJWTV16tSdEydO7Lh9+/YGAPfee2/MkCFDDh08eHB1VlbWl5MnT94LkJOTE5SVlRXao0eP0uvcuHFjw/POO690WkJSUlJBgwYN3Lp16xp+n59zcnLy0Z07d4YeOHBAOVM9oE4UERGpo+6+++7v4uLiCvr06ZOwd+/eBqmpqVklx3Jzc4ObNGlSOq81Ly/vhG2AyMjIotzc3OCS7aioqKK8vLxgqmDq1Km7mjdvXpySknK0S5cu+UOGDMlJTEw8Fh0dXTRkyJBDq1atagTwwgsvtLjhhhv2DRky5HBISAh33HHH/gYNGrgFCxY0Bhg3blx2XFzc8eDgYCZMmJDdoUOHgiVLljQGCAkJcd9++23Ytm3bGjRq1MgNGzYsD2D//v3BAE2bNi29riNHjgRHRUWdcJ0RERFFhw4dqtJ1lWjatGmx91y6L6oeUOIrIiJSh40fP37fli1bwidOnLg3PDy8dL3hJk2aFOXk5JQmexEREUW5ubkn/N3Py8sLjoyMLE0SDx06FBwREVHhTWCnEhMTU3ojXMOGDYtbt259vGQ7PDy8+PDhw0EAmZmZoS+++GLryMjIniWvPXv2NMjMzAwFmD59enTJNIjIyMieX3/9dfi+fftCAFJTUzOdc/Tv379bfHx80rRp06IBoqOjiwAOHjxYep2NGjUqysnJOeE6Dx8+fFIyXFkHDx4M8p6rztzwJ6emxFdERKSOOnToUNA999zTfvTo0d89+eSTMXv27ClNABMTE49s3rw5rGS7ZBpDcfF/p7Ju2rQpvEePHqXTArzTIY5UR6zt2rU7Pnny5F25ubmrS175+fmrJk6ceOCrr74KnTJlSofU1NRvs7OzV+fm5q6Oj4/Pd86Tx59zzjmFc+fO3b53794vZ8yYsf2ee+7psG7durAmTZoUt2/fvmDdunWl19mtW7ejX375Zel0jQ0bNoQeO3bMunfvfrSCsM5ozZo1DWNiYo41b968wjnAUrco8RUREamjJkyY0L5Hjx5H3nrrre0/+tGPDv3iF78oXb1g+PDhh5YuXRpZZjs3ODjYPfbYY63y8/Pt8ccfbwlQMicYYPHixZFDhw49VLI9atSouFGjRsX5ItZJkybte/XVV1stWLCgcXFxMTk5OUFz586Nys7ODsrNzQ0yM9q0aXMcIDU1Nfrrr78unXv80ksvNfvmm28agGfk1cwICQlxAEOGDDm0YMGC0uscO3bs/gULFjT98MMPI3JycoLuvffedsOGDTvYrFmzYoApU6bE/OAHP+haUr6goMCOHDlixcXFFBYWcuTIESss/O/g7oIFCyIvuuii0p+J1G2aryIiIlJFvlhn92zNnj276cKFC6PWrl27HmDmzJk7evTokfjCCy80v+WWWw5cc801h6ZOndp+27ZtDeLi4o43bNjQvf3221/ffPPNcY899lhsp06d8t9+++2vGzZs6ACOHDliCxYsiPr9739fOk94586doVdeeeUBX8Q7cODAI9OnT982efLkc7Zv3x7WsGHD4pSUlLxhw4bl9unT5+jNN9+8Z+DAgd2CgoLcqFGj9vfq1at0pYbly5c3njp1avu8vLzg6Ojo448++ui3CQkJxwBuu+22fddee23nxx9/fHdQUBApKSlHn3766e2/+MUvOh48eDDkggsuyJkzZ862krYyMzMb9OvXr7Tt6667rsPf//730iXcnnvuubapqanbJk+evB/g73//e/NXX321dI1gqdus5GuEQJSSkuLS09P9HYaIiNQiZrbCOZdSsr1mzZptycnJ3/kzpu/r6aefbrFhw4bwl156aceZyj722GOtduzYETpz5sxM8Kz7m5iYmLhx48YNYWFhtTpZuPzyyzuOHj06+4Ybbjh4prIJCQmJCxcu3NymTZszzvmdM2dO1OzZs6PnzZu31SeBSo1Ys2ZNi+Tk5LiKjinxVeIrIiJl1KfEVyQQnS7x1RxfEREREQkISnxFREREJCAo8RURERGRgKDEV0REREQCghJfEREREQkISnxFREREJCAo8RURERGRgKDEV+qdRx99lNDQUBo0aMAll1xy0vGMjAxiYmIIDw8nIiKCf/zjHyccP3bsGI0aNaJ169al+8455xzCw8MJDw8nJCSE8PDw8s2KiNQ6Tz31VItx48a1r0zZRx99tNWtt97arrpjqg6XX355x9dff72pr9t94403oi677LJOvmxTfXJ2zrZP9AALPcCiXjl27BiNGzfm448/JiUlhZYtW/LWW28xYsSI0jJ9+/YlIiKCTz/9lHnz5jFmzBgOHPjvEzmvuOIK1qxZQ35+Pnv27DnpHCkpKTRp0oQFCxbUyDWJSM2qzAMsvun6cJ/qjKHz5ofP+pHIR48etbi4uB7Lli3b2LFjx+MAn3/+efiECRPitm7d2rBTp05HZ82ate2CCy7IB88jizt27Nhj5cqVG9q1a1d4tuevKWlpaeHXXXddpy1btqwPCvKM582cObP5b3/723bZ2dkhP/zhD3PeeOONba1bt67wSW133nlnzAcffNB069at4ZMnT9717LPP7ix7vEuXLkmzZ8/e2q9fv/yzjbWiPrn22ms7LFu2LPLbb78NmzZtWumjkkF98n37RA+wkIDxyiuvEBUVxeDBg4mIiGDgwIHMmDHjhDLbt2/nqquuAmD48OHk5uaybt06AL744guWLFnCHXfcUWH7xcXFrF69mnvvvbd6L0RE5CzNmTOnaadOnfJLEqyjR4/alVdeGT969Oj9Bw4cWH3ttdfuv/LKK+OPHj1qAI0aNXIXXXTRoT/96U/R/o28aqZPn97yyiuv3F+SYKWnpze8++67O/zlL3/J2L1795rw8PDim266qcOp6sfHxxc8+uijmYMGDTpY0fGRI0funzFjRktfxFq+TwDOO++8I6mpqdsT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q1/VyLWISP2hRxaLiIhPFRUVcdttt/Hxxx8TGxtL3759GTFiBImJiaVlZsyYQWJiIv/85z/Zt28fXbt25frrryckJIRnnnmG3r17k5ubS58+fRg6dCiJiYl8+umnvPvuu3z55ZeEhYWxd+9eP16liNRFGvEVERGfWr58OfHx8XTq1InQ0FCuueYa3n333RPKmBm5ubk458jLy6N58+aEhITQtm1bevfuDUBkZCTdunUjKysLgBdeeIGpU6cSFhYGQKtWrWr2wkSkzlPiKyIiPpWVlUX79u1Lt2NjY0uT1xK33347GzduJCYmhh49epCamkpQ0Il/krZt28aqVavo168fAF999RVLliyhX79+DBo0iC+++KL6L0ZE6hUlviIi4lPOuZP2mdkJ2/Pnz6dnz57s3LmT1atXc/vtt5OTk1N6PC8vj1GjRjFt2jSaNGkCQGFhIdnZ2fznP//hqaeeYvTo0RWeS0TkVJT4ioiIT8XGxrJjx47S7czMTGJiYk4o8/LLLzNy5EjMjPj4eDp27MimTZsAOH78OKNGjeL6669n5MiRJ7RbUucHP/gBQUFBfPfddzVzUSJSLyjxFRERn+rbty9btmwhIyODY8eOMXfuXEaMGHFCmXPOOYdPPvkEgD179rB582Y6deqEc46bbrqJbt26MWXKlBPq/PSnP2XBggWAZ9rDsWPHaNGiRc1clIjUC1rVQUREfCokJITp06czbNgwioqKGDduHElJScycOROASZMm8cADDzB27Fh69OiBc44nn3ySFi1asHTpUl5//XV69OhBz549AXj88ccZPnw448aNY9y4cXTv3p3Q0FBeffXVk6ZQiIicjgXy/KiUlBSXnp7u7zDEByZM8+/5Z93l3/OLiO+Y2QrnXIq/4xAR39NUBxEREREJCEp8RURERCQgKPEVERERkYCgxFdEREREAoISXxEREREJCEp8RURERCQgKPEVERERkYCgxFdEREREAoISXxEREREJCEp8RURERCQghPg7ABERqR++6fqwX8/febN/zy8itZ9GfEVEREQkICjxFREREZGAoMRXRERERAKCEl8RERERCQhKfEVEREQkICjxFREREZGAoMRXRERERAKCEl8RERERCQhKfEVEREQkICjxFREREZGAoMRXRERERAKCEl8RERERCQhKfEVEREQkINR44mtmt5pZhpkd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5GnqxuB54MVA59ySMvsfAq51ziVUMobngQHOufO8218BrzvnHilTZhCem+/anmaKBCkpKa7kD4/UbROm+ff8s+7y7/lFaoNvuj7s1/N33uyb85vZCudcik8aE5FaparDZMOACc65z5xzhd7XZ3gS4WFnqPsdnrV/25Tb34qTR4FPJw1P8l1i9ynaLARONwItIiIiIgGkqonvPuBwBfuPcIYk0zl3DFgBDC13aCieFRkqqycnTl9YxslTJYYC6c6541VoV0RERETqsaomvr8FpplZu5Id3vfPeI+dybPAWDMbb2bdzCwVz4MvZnrb+p2ZfVKm7Z+b2XXesl3N7JfAbXiWUCsxE4g1s2necuOBscDTVbw2EREREanHznhzm5mtBcpOBO4IbDOzLO92O+AonukFfz5dW865t7w3yN2PZz3edcBw59x2b5G2QOdy1e7H84S4IuArPDfRldzYhnMuw8yGA3/AsyzaTmCyc05LmYmIiIhIqcqs6vA3X57QOfc88Pwpjo0tt/0q8Gol2lwE9PZFfCIiIiJSP50x8XXO/aYmAhERERERqU5VWse3hJkNARLxTIFY75xb6MugRERERER8raoPsGgH/APPE9h2enfHmFk68DPn3M5TVhYRERER8aOqrurwRzw3mcU759o759rjWVO3yHtMRERERKRWqupUh6HAYOdcRskO59xWM5sMfHLqaiIiIiIi/lXVEd9TKfZROyIiIiIi1aKqie8nwB/NrH3JDjM7B0hFI74iIiIiUotVNfGdDDQCtprZdjPbBnzj3TfZx7GJiIiIiPhMVef47gd+AFwEJAAGbHDO/dvXgYmIiIiI+FKlE18zCwYOAcnOuY+Bj6stKhERERERH6v0VAfnXBGwHQitvnBERERERKpHVef4PgI8YWYtqiMYEREREZHqUtU5vr8EOgJZZpYJHC570Dl3nq8CExERERHxpaomvn8DHJ6b2kRERERE6oxKJb5m1gh4Cvgp0ADPmr13OOe+q77QRERERER8p7JzfH8DjAX+BbwJXAy8UE0xiYiIiIj4XGWnOowEbnLOzQUwszeAz8ws2Lvag4iIiIhIrVbZEd/2wJKSDefccqAQiKmOoEREREREfK2yiW8wcKzcvkKqfnOciIiIiIhfVDZxNWC2mRWU2dcQmGVmR0p2OOdG+DI4ERERERFfqWzi+2oF+2b7MhARERERkepUqcTXOfeL6g5ERERERKQ6VfWRxSIiIiIidZISXxEREREJCEp8RURERCQgKPEVERERkYCgxFdEREREAoISXxEREREJCEp8RURERCQgKPEVERERkYCgxFdEREREAoISXxEREREJCEp8RURERCQgKPEVERERkYCgxFdEREREAoISXxEREREJCEp8RURERCQgKPEVERERkYCgxFdEREREAoISXxEREREJCEp8RURERCQgKPEVERERkYCgxFdEREREAoISXxEREREJCEp8RURERCQgKPEVERERkYCgxFdEREREAoISXxEREREJCEp8RURERCQg1Hjia2a3mlmGmR01sxVmduFpyg42s3fNbJeZHTGzL81sXAVlXAWvhOq/GhERERGpK2o08TWzq4FU4HGgF/A58IGZnXOKKhcAa4Erge7AC8CLZnZdBWWTgLZlXlt8G72IiIiI1GUhNXy+KcArzrlZ3u07zOwS4Bbg3vKFnXOPl9v1gpldBIwC5pQ7ttc5952vAxYRERGR+qHGRnzNLBToA3xU7tBHeEZ2K6sJkF3B/nTvlIhPvMmxiIiIiEipmhzxbQEEA3vK7d8DXFyZBszsMuBHwA/L7N6FZ8T4CyAUuAH4xMwGO+cWV9DGzcDNADExMSxcuBCATp06ERkZyZo1awCIjo4mKSmJxYs9TYSEhDBgwABWrlxJTk4OACkpKezZs4cdO3YA0KVLF8LCwli3bh0ArVq14txzz2Xp0qUAhIWF0b9/f9LT08nLywOgX79+ZGZmkpWVBUDXrl0JDg5mw4YNALRp04aOHTuybNkyAMLDw+nXrx9paWnk5+cD0L9/fzIyMti9ezcAiYmJFBUVsXnzZgDatWtHbGwsaWlpAERERJCSksKyZcsoKCgAYMCAAXz11Vfs3bsXgO7du1NQUMCWLZ4ZI+3bt6d169akp6cD0KRJE3r37s3SpUspLCwEYODAgaxfv579+/cDkJycTG5uLlu3bgUgLi6O5s2bs3LlSgCaNWtGcnIyixYtwjmHmTFo0CDWrFlDdrbns03v3r05cOAA27ZtO20/+fs+zU2bNqmfKtFP+n2q3/3UHv/atWuXT/pJROovc87VzInMYoAsYKBzbkmZ/Q8B1zrnTnszmpn9EPgAuMc598IZys4DCp1zI05XLiUlxZX84ZG6bcI0/55/1l3+Pb9I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", + "text/plain": [ + "
" + ] + }, + "execution_count": 10, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram([simp_counts1, simp_counts2], \n", + " legend=['x(0); meas(0,1)', 'x(0); meas(0,1); x(1); meas(0,1)'],\n", + " title='ibmq_manhattan')" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Single-qubit circuit with reset" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Next we combine the ability to `reset` qubits with mid-circuit measurements. This enables qubit reuse and is a first step in providing control flow in the future.\n", + "\n", + "Before reading this section, make sure you are familiar with [conditional reset](https://quantum-computing.ibm.com/docs/manage/backends/reset/backend_reset) on IBM Quantum systems." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In order to use `reset`, we must verify that the backend supports it by checking `supported_instructions`." + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "metadata": {}, + "outputs": [], + "source": [ + "assert hasattr(config, 'supported_instructions'), 'Reset is not supported by this backend.'\n", + "assert 'reset' in config.supported_instructions, 'Reset is not supported by this backend.'" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We perform the sequence `h(0) -> measure(0) -> reset(0) [n times] -> x(0) -> measure(0)`. Without `reset`, we expect 50/50 `0`s and `1`s after both the first measurement and the second measurement. \n", + "\n", + "However, when the `reset` is included, the superposition prepared by the Hadamard gate is reset to $|0\\rangle$. The X gate then flips the state, so after the second measurement we expect all `1`s rather than an even distribution.\n", + "\n", + "In this example, note that we \"reuse\" the qubit after the first measurement via the `reset` instruction. This provides flexibility in more advanced algorithms." + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "metadata": {}, + "outputs": [], + "source": [ + "def h_reset_x_circ(n_resets, qubit=0):\n", + " \"\"\"Do h, then n_resets reset instructions, then x. \n", + " \n", + " Two measurements are done--one after the hadamard \n", + " and one at the end of the circuit.\n", + " Measurement 0 is in memory slot 0. Measurement1 is in\n", + " memory slot 1.\n", + " \"\"\"\n", + " qc = QuantumCircuit(n_qubits, 2)\n", + " qc.h(qubit)\n", + " qc.measure(qubit, [0])\n", + " qc.reset([qubit]*n_resets)\n", + " qc.x(qubit)\n", + " qc.measure(qubit, [1])\n", + " return qc" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We run this experiment on qubits 0, with 0, 1, and 3 `reset`s. We see clear improvement after a single reset and further improvement with 3 resets." + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": {}, + "outputs": [], + "source": [ + "circs_1q = [h_reset_x_circ(0), h_reset_x_circ(1), h_reset_x_circ(3)]" + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "5ff7480c266645f47af5d64f\n", + "Job Status: job has successfully run \n" + ] + } + ], + "source": [ + "job_1q = execute(circs_1q, backend=backend, optimization_level=0)\n", + "print(job_1q.job_id())\n", + "job_monitor(job_1q)" + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Meas 1 result: [{'0': 497, '1': 527}, {'0': 504, '1': 520}, {'0': 573, '1': 451}]\n", + "Meas 2 result: [{'0': 504, '1': 520}, {'0': 101, '1': 923}, {'0': 38, '1': 986}]\n" + ] + } + ], + "source": [ + "counts_1q_1 = marginal_counts(job_1q.result(), indices=[0]).get_counts()\n", + "counts_1q_2 = marginal_counts(job_1q.result(), indices=[1]).get_counts()\n", + "print(\"Meas 1 result: \", counts_1q_1)\n", + "print(\"Meas 2 result: \", counts_1q_2)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "After the first measurement, all counts are an equal distribution, as expected. " + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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D77ooot6lZSUGMDmzZuDtm3b1uacc87Z76378ssvd5oyZcquhISEivj4+IopU6bkLliwoKP3fEJCQkVERETVkiVLQr1thIeHD968eXNQffe+++67Y8aOHdvrsssuiw8NDR3St2/fgenp6W3uu+++Lh06dEju0qXLoL///e8R3vp79uzxv/rqq3tGRUUN6ty586CpU6fGVFZWApCRkdFmxIgRfdu3bz84MjIy+dJLL43Py8vz9147c+bMLp07dx4UGho6JC4uLmnhwoXhAP/4xz8iEhMTS0JCQhxAYWGh3wcffBA5a9asnHbt2lWPGTOmeNSoUQUvvPBCbT8vuOCCohUrVkQcT4KoxElEROQ77K233uqwaNGizZmZmes3btwYPHfu3E4Aqampwd26dSsLDAysrZuZmdl26NChpd7jYcOGlWRmZgbXbS8hIeHA2rVrQwD69OlTXlRUtK5Pnz7lR7r/kiVL2t9444179u3btzYxMbFk7Nixfaurq9m5c2f69OnTd9x+++09vXWvueaauICAALZs2fL52rVrN3z88cft5syZ0wnAOcc999yza+fOnWkZGRkZO3bsCJoxY0YMQFpaWpvnn3++86pVqzbu379/7Ycffvhl7969ywHWr18fnJCQcMB7j/Xr17fx9/dn0KBBZd6yQYMGlXzxxRe1/YyPj68ICAhw6enptaNQvlLiJCIi8h1266235sbFxVVER0dXnX/++QXr1q0LBti7d69/aGhoVd26JSUl/pGRkbVlkZGRVSUlJX7V1dW1dcLCwqr27dvnj4+GDRtWdOWVVxYGBgZy1VVX7d27d2/Aww8/vKtNmzbulltuyd+xY0dQXl6e/7Zt2wKWLVvW7o9//OPXERER1bGxsZVTpkzJffPNNzsAJCUllf3gBz8oDA4OdjExMZV33HFH7ooVK8IB/P39KS8vt3Xr1rUtKyuzfv36lScmJpYBFBQU+IeHh9f2qaioyD8sLOygfrdr166quLj4oD6FhIRU5efn+9xPL00OFxER+Q6LiYmp8H4OCQmp3rlzZyBAhw4dqvbv339YsrBv377aQZN9+/b5h4SEVPv5/W8cpbi42L99+/YHJR5HExUVVVn3/pGRkZUBAZ70IiwsrBqgoKDA7+uvvw6srKy0rl27JnvrO+esS5cu5QA5OTkBP/nJT3qsWrUqrKSkxL+6upqIiIgq8CRVjzzyyLbf/OY3MTfeeGPwWWedVTh37txtcXFxFe3bt68qKiqq7Wd4eHjV/v37DxoYKiwsPCyZKikp8e/QoYPP/fTSiJOIiMgJKCUlpWT79u1tKipq8yp69+59YM2aNSHe49TU1ODevXuX1r1uy5YtbYcMGVLS2PH06tWrIigoyOXn568rKipaV1RUtK64uHhtZmZmBsBdd90Va2YuPT09o7i4eO0f/vCHLOf+t+7o5MmT81NTUzdlZ2enm5m78847u4HnMdyWLVvaeOudcsopZZWVlbZ+/frasvT09OD+/fvX9jM7OzuwoqLCBg0aVPuIz1dKnERERE5ACQkJFT169DiwdOnSUG/Ztddeu+eZZ56JzsrKCszOzg6cO3dul+uvv772rbusrKzAgoKCgHPPPXc/wKZNm4LMbNimTZvqnRzeED179qw4/fTTCyZNmtQ9Pz/fr6qqioyMjDbvvvtuGHhGukJDQ6s7depUlZWVFThnzpwu3mvT0tLavPPOO+GlpaUWEhLi2rZt6/z9/R3AJZdcUrhhw4ZQ76T4iIiI6jFjxuy7//77YwoLC/0WLVoU+q9//av9LbfcUtvPDz74IHzEiBGFwcHBDV4RXomTiIjICermm2/ePX/+/Nq3yaZNm7b7/PPPLxg8eHBicnJy4nnnnVcwbdq03d7zL7zwQodx48bleROKrKysoJiYmPK4uLiK+tpvqNdffz27vLzcBgwYkNS+ffvB48aNS8jJyQkEePDBB3esX78+JCIiYsjYsWP7XHLJJXu91x04cMBv5syZ3Tp16jQ4Ojo6OS8vL2D27Nk5AN27d6887bTTChcsWNDeW//555/fWlpa6hcdHZ08YcKEXo8//vjXKSkptaNLr776aodJkybt5jhY3WGwk01KSopbvXp1S4chIiKtiJmlOudSvMdpaWnZycnJeS0Z0/EqLS21pKSkgUuWLPmyZ8+eR01+SktLbeDAgQOXL1++KTY2thJgxowZXaOioiqmT5/eqvufmpradsKECfHp6ekb687Xqs+qVauCJ02a1HPdunVfHKlOWlpap+Tk5Lj6zilxUuIkIiJ1nEiJkxyfoyVOelQnIiIi4iMlTiIiIiI+UuIkIiIi4iMlTiIiIiI+UuIkIiIi4iMlTiIiIiI+UuIkIiIi4iMlTiI1PvjgA/r160fv3r159NFHDzu/dOlS2rVrx+DBgxk8eDAPPvhg7bl9+/Yxbtw4+vfvz4ABA1ixYgUA+fn5jB49mj59+jB69Gj27t17WLsiIscrNjb2lLfffjv8SOdLS0stISEh8euvvw44VlulpaUWHx+fmJOTc8y6rU1qamrbpKSkAb7UXblyZfCQIUP6H++9mv03x8x+CkwHugIZwJ3OuU+PUt+AO4DJQDyQD7zonLu3Tp2zgSeBRGAH8Jhz7rkm64SccKqqqrjttttYvHgx3bp149RTT+XSSy9l4MCBB9U788wz+ec//3nY9XfccQcXXHABb775JuXl5ZSUePbHfPTRRxk1ahT33nsvjz76KI8++ii//e1vm6VPItJ0tvR7YFhTtp+w6YHUxmjnySefjBo+fHhRjx49KgGqq6u57bbbYl955ZUogPHjx+c9++yz2/38/AgODnbXX3993gMPPNBl3rx52xvj/s3l/vvvj506deou73Fubq7/DTfcELd8+fKIyMjIyl/+8pc5kydPzgcYPnx4aUREROXLL7/c7rrrrito6L2adcTJzK4BngIeAYYA/wHeN7MeR7lsNvBT4B5gAHAhsKxOm/HAezVtDQFmAU+b2ZVN0Qc5Ma1atYrevXvTq1cvgoKCGD9+PAsXLvTp2sLCQpYtW8aPfvQjAIKCgmjfvj0ACxcuZMKECQBMmDCBt99+uynCFxGp1/z586Nuuumm2s1tZ8+e3en999+PTE1NzVi7dm3G4sWL2z3xxBNR3vM333xz/ptvvtmxtLTUWibihtu6dWvgZ599Fn7DDTfs85ZNnDixR1BQkNu1a1fan//856zp06f3WL16dVvv+fHjx+fPmzcvqt4Gj6G5H9XdDcx3zs1zzm10zt0O7ARura+ymfUDbgcuc84tdM595Zxb65x7r061ycAO59ztNW3OA14EpjVxX+QEkpOTQ/fu3WuPu3XrRk5OzmH1VqxYQXJyMmPHjiUjIwOAr776iqioKG6++WaGDBnCxIkT2b9/PwC5ubl07doVgK5du/LNN980Q29E5GSyZs2akL59+w4MDw8ffNFFF/UqKSkxgM2bNwdt27atzTnnnLPfW/fll1/uNGXKlF0JCQkV8fHxFVOmTMldsGBB7SbACQkJFREREVVLliwJ9bYRHh4+ePPmzUH13fvuu++OGTt2bK/LLrssPjQ0dEjfvn0Hpqent7nvvvu6dOjQIblLly6D/v73v0d46+/Zs8f/6quv7hkVFTWoc+fOg6ZOnRpTWVkJQEZGRpsRI0b0bd++/eDIyMjkSy+9ND4vL8/fe+3MmTO7dO7ceVBoaOiQuLi4pIULF4YD/OMf/4hITEwsCQkJcQCFhYV+H3zwQeSsWbNy2rVrVz1mzJjiUaNGFbzwwgu1/bzggguKVqxYEXE8CWKzJU5mFgQMAxYdcmoR8P0jXHYZ8BVwgZl9ZWbZZvaimXWuU+e0etr8EEgxs8BGCF1OAvXt2eh5Svw/Q4cOZevWraSlpXH77bdz+eWXA1BZWcmaNWu49dZbWbt2LaGhofXOkRIRaQpvvfVWh0WLFm3OzMxcv3HjxuC5c+d2AkhNTQ3u1q1bWWDg//4qzMzMbDt06NBS7/GwYcNKMjMzg+u2l5CQcGDt2rUhAH369CkvKipa16dPn/Ij3X/JkiXtb7zxxj379u1bm5iYWDJ27Ni+1dXV7Ny5M3369Ok7br/99p7eutdcc01cQEAAW7Zs+Xzt2rUbPv7443Zz5szpBJ6fw/fcc8+unTt3pmVkZGTs2LEjaMaMGTEAaWlpbZ5//vnOq1at2rh///61H3744Ze9e/cuB1i/fn1wQkLCAe891q9f38bf359BgwaVecsGDRpU8sUXX9T2Mz4+viIgIMClp6fXjkL5qjnnOHUC/IHcQ8pzgfOOcE0voCcwHrgJcMATwD/M7DTnXDXQBfhXPW0G1NxzZ90TZjYJmAQQExPD0qVLPTfq1Yvw8HDS0tIA6NixI4mJiSxb5nkqGBAQwBlnnMGaNWsoLCwEICUlhdzcXLZt2wZAnz59aNOmDZ9//jkAnTt3pm/fvixfvhyANm3acNppp7F69WqKi4sBGD58ONu3b68d3ejXrx/+/v5s2LABgC5duhAfH1872Tg4OJjhw4ezcuVKSks9/++fdtppZGVlsWuX5/HuwIEDqaqqYtOmTQDExsbSrVs3Vq5cCUBYWBgpKSmsWLGCsjLP/1dnnHEGX375Ze2ISFJSEmVlZWzevBmA7t27Ex0djXdT5IiICIYOHcry5cvx/mvhrLPOIiMjgz17PKPCycnJFBUV8dVXXwEQFxdHhw4dWLNmDQCRkZEkJyfzySef4JzDzDj77LNJS0urnUQ9dOhQ8vPzyc7ObtI/py5dupCWlsbSpUtp06YN27dvp7q6uvb/j+HDh5Obm1v75zRkyBDKyspYuHAhVVVVREdHM3jwYJYuXUpCQgKvvfYav/nNb2jXrh1/+9vf6NixI3FxcbRv3762Tf056fukP6fW+ef0XXPrrbfmxsXFVQCcf/75BevWrQsG2Lt3r39oaGhV3bolJSX+kZGRtWWRkZFVJSUlftXV1fj5ecZSwsLCqvbt2+ePj4YNG1Z05ZVXFgJcddVVez/88MPIhx9+eFdAQAC33HJL/rRp03rm5eX5l5aW2rJly9rl5+evDQsLcxEREdVTpkzJfeGFFzpNnz49LykpqSwpKakMIDg4uPKOO+7IfeSRR2IA/P39KS8vt3Xr1rXt2rVrZb9+/WoTuYKCAv8OHTpUeo+Lior8w8LCDup3u3btqoqLiw/qU0hISFV+fr7P/fSy+v6l3RTMLAbIAc6qOxnczH4FXOucO2yGu5n9Efgx0M8592VNWV9gEzDCObfSzL4E/uqc+02d684GlgJdnXO7Dm3XKyUlxXl/cMnJrbKykr59+/LRRx8RGxvLqaeeyssvv0xiYmJtnV27dhEdHY2ZsWrVKsaNG8fWrVsxM84880z+9Kc/0a9fPx544AH279/P448/zvTp0+nYsWPt5PD8/Hwee+yxFuypiByLmaU651K8x2lpadnJycl5deu0lsnhsbGxpzzzzDPZl19+eRF4Hp1t2bKlzcKFC7Nee+21djNnzuyWmZmZ4a0fHh4++J133vnynHPOKQH49NNPQy644IJ++/fvX+utc+655/Y+99xzC3/+858fc25B3fsBvP322+G33XZbXE5OznqAiooKgoKChmVmZqZ//fXXgaNGjRpQN5lzzlmXLl3KMzMzM3JycgJ+8pOf9Fi1alVYSUmJf3V1NREREVW7du1KB3juuec6zJs3L2rz5s3BZ511VuHcuXO3xcXFVUyePLnb/v37/f76179+DfDvf/87+LzzzutfWlpa26df/epX0Z9++mn4kiVLMr1lYWFhQz766KMvhg8fXjsC55WWltYpOTk5rr4+N+ccpzygCs8IUV2dOXwUymsnUOlNmmpsBioB74TyXUdosxLYg4gPAgICmDt3LmPGjGHAgAFcffXVJCYm8txzz/Hcc54XNN98802SkpJITk5m6tSpvPrqq7WP855++mmuv/56Bg0axLp167j//vsBuPfee1m8eDF9+vRh8eLF3HvvvUeMQUSkMaWkpJRs3769TUVFRW1Z7969D6xZsybEe5yamhrcu3fvgxKHLVu2tB0yZEhJY8fTq1eviqCgIJefn7+uqKhoXVFR0bri4uK13sTurrvuijUzl56enlFcXLz2D3/4Q1bdwZ3Jkyfnp6ambsrOzk43M3fnnXd2A89juC1btrTx1jvllFPKKisrbf369bVl6enpwf3796/tZ3Z2dmBFRYUNGjSo9hGfr5rtUZ1zrtzMUoHRwBt1To0G/naEy/4NBJhZgnNuS01ZLzxxb605XgFcfsh1o4HVzrkKRHx04YUXcuGFFx5UNnny5NrPU6ZMYcqUKfVeO3jwYOobvezYsSMfffRR4wYqIuKDhISEih49ehxYunRp6OjRo/cDXHvttXueeeaZ6CuuuKLAzJg7d26XSZMm1Y4sZWVlBRYUFASce+65+wE2bdoU1L9//1O++OKL9XUfjx2Pnj17Vpx++ukFkyZN6j579uycdu3aVX/xxRdtsrOzAy+66KLi4uJi/4iIiKpOnTpVZWVlBc6ZM6d2UCQtLa3N1q1bg0aPHl0cEhLi2rZt66qrqwG45JJLCu+///4eJSUlFhIS4iIiIqrHjBmz7/77749ZsGDB1s8++yz4X//6V/uPP/74C297H3zwQfiIESMKg4ODG/zYrbnfqnsSuMnMJprZADN7CogBngMws1lmVvdvmX8Ba4AXzGyImQ0BXgBWAt6/pZ4DupnZ72ranIhnPtQTzdMlERGR1unmm2/ePX/+/Nq3yaZNm7b7/PPPLxg8eHBicnJy4nnnnVcwbdq03d7zL7zwQodx48bleROKrKysoJiYmHLvHKpv6/XXX88uLy+3AQMGJLVv337wuHHjEnJycgIBHnzwwR3r168PiYiIGDJ27Ng+l1xySe2KwQcOHPCbOXNmt06dOg2Ojo5OzsvLC5g9e3YOQPfu3StPO+20wgULFrT31n/++ee3lpaW+kVHRydPmDCh1+OPP/51SkpK7ejSq6++2mHSpEm7OQ7NNsep9oaeBTBn4FkA83PgLufcsppz84GRzrm4OvW7Ar8HLgBKgcXA3c653Dp1zgbm8L8FMH/rywKYmuMkIiKH8mWO03dFaWmpJSUlDVyyZMmXPXv2PGryU1paagMHDhy4fPnyTbGxsZUAM2bM6BoVFVUxffr0Vt3/1NTUthMmTIhPT0/f6J3kfiSrVq0KnjRpUs9169Z9caQ6R5vj1OyJU2uixElERA51IiVOcnxay+RwERERke80JU4iIiIiPlLiJCIiIuIjJU4iIiIiPlLiJCIiIuIjJU4iIiIiPlLiJCIiIuIjJU4i0qpNmDABM8PM6Nu372Hnp0yZgpnh5+eHn58f8fHxtefatWtXe66uuLi4g665/vrrm7wfIk0hNjb2lLfffjv8SOdLS0stISEh8euvvz7mFmulpaUWHx+fmJOT02zbsTWW1NTUtklJSQN8qbty5crgIUOG9D/ee33nfnNE5ORRWlrKX/7yFxYsWMAFF1xAp06dmDt37mF7BgYFBVFWVnbY9TfddBNRUVH88pe/POxc//792bhxY5PFLie2+yYUDGvK9me92C61Mdp58skno4YPH17Uo0ePSoDq6mpuu+222FdeeSUKYPz48XnPPvvsdj8/P4KDg93111+f98ADD3SZN2/e9sa4f3O5//77Y6dOnbrLe5ybm+t/ww03xC1fvjwiMjKy8pe//GXO5MmT8wGGDx9eGhERUfnyyy+3u+666woaei8lTnLCum9Cg78PrdKsF9u1dAgt5oEHHiAwMJDrrrsOgISEBJ566qkjbrZ8qKeeeoo33njj2BVFTlDz58+PeuaZZ7K9x7Nnz+70/vvvR6ampmb4+flx3nnn9X3iiSfKZsyYsRvg5ptvzk9JSRn4+9//Pud4NsBtCVu3bg387LPPwt96662vvGUTJ07sERQU5Hbt2pX22WefhYwbN653SkpKiXe/uvHjx+fPmzcv6ngSJz2qE5FWa8OGDQQHB9ced+/enfz8/MPqlZeX4+fnR1BQEE8//bRPbX/xxRf4+fnRrl071q1b11ghH9FDDz1EUFAQgYGBXHDBBYed/93vfoeZERwcTHBwMOeee+4xr33ttdcICwsjODiY0NBQ/vznPzd5P6T1WbNmTUjfvn0HhoeHD77ooot6lZSUGMDmzZuDtm3b1uacc87Z76378ssvd5oyZcquhISEivj4+IopU6bkLliwoHYT4ISEhIqIiIiqJUuWhHrbCA8PH7x58+ag+u599913x4wdO7bXZZddFh8aGjqkb9++A9PT09vcd999XTp06JDcpUuXQX//+98jvPX37Nnjf/XVV/eMiooa1Llz50FTp06NqaysBCAjI6PNiBEj+rZv335wZGRk8qWXXhqfl5fn77125syZXTp37jwoNDR0SFxcXNLChQvDAf7xj39EJCYmloSEhDiAwsJCvw8++CBy1qxZOe3ataseM2ZM8ahRowpeeOGF2n5ecMEFRStWrIgoLS21hv5+K3ESkVarvr00zQ7+OXfbbbeRmZlJdXU1V111FVOnTj1mu/Pnz6ekpIQDBw4QHh7O2Wef3Wgx16e8vJxf//rXLFq0iL179/LJJ5/wzjvvHFavc+fOlJaWUlpaypIlS4557U9/+lNmzJhBaWkpM2bM4K677mrSfkjr9NZbb3VYtGjR5szMzPUbN24Mnjt3bieA1NTU4G7dupUFBgbW1s3MzGw7dOjQUu/xsGHDSjIzM4PrtpeQkHBg7dq1IQB9+vQpLyoqWtenT5/yI91/yZIl7W+88cY9+/btW5uYmFgyduzYvtXV1ezcuTN9+vTpO26//fae3rrXXHNNXEBAAFu2bPl87dq1Gz7++ON2c+bM6QSe7/s999yza+fOnWkZGRkZO3bsCJoxY0YMQFpaWpvnn3++86pVqzbu379/7Ycffvhl7969ywHWr18fnJCQcMB7j/Xr17fx9/dn0KBBtc/vBw0aVPLFF1/U9jM+Pr4iICDApaent23o77cSJxFptRITEyktrf0Zz7Zt24iMjDyozoABA0hISABgwYIFAHz22WdHbXfkyJEEBwcTFBTEnDlzKCoqauTIDzZ//nzatWvHyJEjCQsL46yzzuKZZ5751teaGXv27AEgLy+P9u3bN1UXpBW79dZbc+Pi4iqio6Orzj///IJ169YFA+zdu9c/NDS0qm7dkpIS/8jIyNqyyMjIqpKSEr/q6uraOmFhYVX79u3zx0fDhg0ruvLKKwsDAwO56qqr9u7duzfg4Ycf3tWmTRt3yy235O/YsSMoLy/Pf9u2bQHLli1r98c//vHriIiI6tjY2MopU6bkvvnmmx0AkpKSyn7wgx8UBgcHu5iYmMo77rgjd8WKFeEA/v7+lJeX27p169qWlZVZv379yhMTE8sACgoK/MPDw2v7VFRU5B8WFnZQv9u1a1dVXFx8UJ9CQkKq8vPzfe6nlxInEWm1fvGLX1BRUcFrr71Gfn4+W7ZsOWxEacmSJVRVVdXWBzj11FOP2u7ixYtrPz/44IO0bdvgf3Q2yKZNm+jYsfYpAfHx8ezcufOwert37yY4OJioqCgWLlx4zGvnz5/PM888Q0BAAM8++2xt4ignl5iYmArv55CQkOr9+/f7A3To0KHK+7nO+ap9+/bV/t2/b98+/5CQkOq6b54WFxf7t2/f/qDE42iioqIq694/MjKyMiDAM4U6LCysGqCgoMAvMzMzqLKy0rp27ZocHh4+ODw8fPDPfvaznnv27AkEyMnJCbj44ot7de7ceVBYWNiQn/zkJ/F79+4NAE9S9cgjj2z7zW9+ExMVFZV88cUX98rOzg4EaN++fVVRUVFtP8PDw6v2799/UH5TWFh4WDJVUlLi36FDB5/76aXESURarbCwMK677jrGjx9Px44d6dWrF7fffjunnnpqbXL0s5/9jMDAQPz8/HjkkUeYPn06/v6en6GhoaFcffXVOOcwM04//XQAfvCDH9QuRfDll1/WJilNpb5HjocaN24cO3bsoLS0lClTpnDVVVcd89qZM2dy1113UVlZydSpU7nkkksaLWb57ktJSSnZvn17m4qK2ryK3r17H1izZk2I9zg1NTW4d+/epXWv27JlS9shQ4aUNHY8vXr1qggKCnL5+fnrioqK1hUVFa0rLi5em5mZmQFw1113xZqZS09PzyguLl77hz/8Iavu//+TJ0/OT01N3ZSdnZ1uZu7OO+/sBp7HcFu2bGnjrXfKKaeUVVZW2vr162vL0tPTg/v371/bz+zs7MCKigobNGhQ7SM+XylxEpFWbcGCBTjncM6RmZkJwH//+1/++9//ArB27Vqqq6uprq6mqqqKxx57rPba/fv3117rnOPf//43AMXFxbXXlJWVMXr06CbtQ//+/WsfqQFkZWXRtWvXg+p069aNLl26APCrX/2K6upqNm3adNRr09PT+e1vfwvA7Nmz2bt3b5P2Q75bEhISKnr06HFg6dKlod6ya6+9ds8zzzwTnZWVFZidnR04d+7cLtdff33t/2BZWVmBBQUFAeeee+5+gE2bNgWZ2bBNmzbVOzm8IXr27Flx+umnF0yaNKl7fn6+X1VVFRkZGW3efffdMPCMdIWGhlZ36tSpKisrK3DOnDldvNempaW1eeedd8JLS0stJCTEtW3b1vn7+zuASy65pHDDhg2h3knxERER1WPGjNl3//33xxQWFvotWrQo9F//+lf7W265pbafH3zwQfiIESMKj+fNQSVOIiJN7MYbb6SgoIBly5ZRXFzMsmXL+OlPf3pQnfT0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YvPmzYwaNYpHH320yfog8m0ocRIREZ+tWrWK3r1706tXL4KCghg/fjwLFy48rN7TTz/NlVdeSefOnQ8q3759O++++y4TJ048qHzhwoVMmDABgAkTJvD22283WR9Evg0lTiIi4rOcnBy6d+9ee9ytWzdycnIOq/PWW28xefLkw66/8847eeyxx/DzO/ivn9zcXLp27QpA165d+eabb5ogepFvT4mTiIj4zDl3WJmZHXR855138tvf/hZ/f/+Dyv/5z3/SuXNnhg0b1qQxijQlTQ4XERGfdevWjW3bttUeb9++nZiYmIPqrF69mvHjxwOQl5fHe++9R0BAACtXruSdd97hvffe48CBAxQWFnLDDTfw0ksvER0dzc6dO+natSs7d+487BGfSGuhEScREfHZqaeeyubNm8nKyqK8vJxXX32VSy+99KA6WVlZZGdnk52dzbhx43j22We5/PLLmTVrFtu3byc7O5tXX32Vc889l5deegmASy+9lBdffBGAF198kcsuu6zZ+ybiC404iYiIzwICApg7dy5jxoyhqqqKW265hcTERJ577jmAeuc1+eLee+/l6quv5vnnn6dHjx688cYbjRm2SKNR4iQiIg1y4YUXcuGFFx5UdqSEaf78+fWWjxw5kpEjR9Yed+zYkY8++qixQhRpMnpUJyIiIuKjZk+czOynZpZlZgfMLNXMzvTxuj5mVmRmxYeUjzQzV8+v/k3TAxERETlZNWviZGbXAE8BjwBDgP8A75tZj2NcFwS8Ciw7SrVEoGudX5sbI2YRERERr+YecbobmO+cm+ec2+icux3YCdx6jOt+C6QDR5st+I1zbledX1WNFLOIiIgI0IyJU82o0TBg0SGnFgHfP8p1FwEXA1OPcYvVZrbTzD4ys3O+VbAiIiIi9WjOEadOgD+Qe0h5LtClvgvMrCswD/ihc67oCO16R6yuBK4ANgEfmdlZjRG0iIiIiFdLLEdw6Hr9Vk+Z10vA/znnPjtiY85twpMsea0wszhgGvXMiTKzScAkgJiYGJYuXQpAr169CA8PJy0tDfC8GpuYmMiyZZ4mAgICOOOMM1izZg2FhYUApKSkkJubCyQcrb8i38qKFSsoKysD4IwzzuDLL7+s3ccrKSmJsrIyNm/2TOnr3r070dHRrF69GoCIiAiGDh3K8uXLqaysBOCss84iIyODPXv2AJCc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zu044sUiIiIi33ENXQDz93hW/+7tnOvunOuOZ6mAqppzIiIiIieshj6qGw2MdM5leQucc1+Z2VTgo0aNTERERKSVaaytyquPXUVERETku62hidNHwO/NrLu3wMx6AE+hEScRERE5wTU0cZoKhABfmdlWM8sGttSUTW3k2ERERERalYbOcdoDfA84B+iPZ/+4Dc45Xzb4FREREflO8zlxMjN/oABIds4tBhY3WVQiIiIirZDPj+qcc1XAViCo6cIRERERab0aOsfpN8CjZtapKYIRERERac0aOsdpGhAP5JjZdmB/3ZPOuUGNFZiIiIhIa9PQxOlNPPvTWRPEIiIiItKq+ZQ4mVkI8DhwORCIZ82m251zeU0XmoiIiEjr4uscp18DNwHvAq8A5wH/10QxiYiIiLRKvj6quwL4kXPuVQAzWwD828z8a962ExERETnh+Tri1B341HvgnFsFVAIxTRGUiIiISGvka+LkD5QfUlZJwyeXi4iIiHxn+Zr4GPCSmZXVKWsLzDOzEm+Bc+7SxgxOREREpDXxNXF6sZ6ylxozEBEREZHWzqfEyTl3c1MHIiIiItLaNXTLFREREZGTlhInERERER8pcRIRERHxkRInERERER8pcRIRERHxkRInERERER8pcRIRERHxkRInERERER8pcRIRERHxkRInERERER8pcRIRERHxkRInERERER8pcRIRERHxkRInERERER8pcRIRERHxkRInERERER8pcRIRERHxkRInERERER8pcRIRERHxkRInERERER8pcRIRERHxkRInERERER8pcRIRERHxkRInERERER8pcRIRERHxkRInERERER81e+JkZj81sywzO2BmqWZ25lHqtjWz+WaWbmYVZra0njojzczV86t/k3ZERERETjrNmjiZ2TXAU8AjwBDgP8D7ZtbjCJf4AweAucC7x2g+Eeha59fmxohZRERExCugme93NzDfOTev5vh2M7sAuBW479DKzrn9wGQAMxsEtD9K29845/IaN1wRERGR/2m2ESczCwKGAYsOObUI+H4j3GK1me00s4/M7JxGaE9ERETkIM054tQJz6O33EPKc4HzvkW7O/GMWP0XCAJ+CHxkZiOdc8sOrWxmk4BJADExMSxduhSAXr16ER4eTlpaGgAdO3YkMTGRZcs8TQQEBHDGGWewZs0aCgsLAUhJ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", + "text/plain": [ + "
" + ] + }, + "execution_count": 16, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram(counts_1q_1, legend=['h(0); meas(0)', 'h(0); meas(0)', 'h(0); meas(0)'], \n", + " title=\"ibmq_manhattan\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "After the second measurement, however, we observe that the `reset` pushes the counts to all `1`s." + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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W0q5o3WHQkTUNOvXr4ednR3uuece2Nraom/fvli9evU1eS5duoRHHnkEgO6GS2VlZTh79uwNyw4dOhRDhgxp8/EQEdGtoU0DeSnlQSmlaOAxse78RCml73Vlzkgp+0opLaWUHlLK1+V1V+hKKQ9JKaOklBZSSj8p5Zq2GxUR0Y0lJyfDyclwPxX4+fkhJ+eaDbUQGBiIdevWAQA+++wz1NTUIC4urklliYjo7+lWXyNPRGT0mrI72LZt21BaWgorKyu8+eabsLa2hrm5eZPK0t+Xl5dXt6+//lrZ2HmNRiMCAgJCfv/995tuN63RaISfn19IVlbWrb419R/ExsZahoaGdm1K3uPHj1tFRkZ2ae0+3Yra+3XauXOnasCAAQE3zwls2rTJbujQof4t2X5bmTFjhtcbb7zhevOcwJNPPun973//2+XPtmV0f6xERMamS5cu11yMmpaWBg8Pj2vyeHt7G/aZ12q1MDc3x5133oni4uKblqW29/KEku6tWf+Sz+1iW6Ked9991yUmJqasQ4cONYDuszVjxgyvLVu2uADA6NGj8z/44INMExMTWFlZybFjx+a/9tpr7mvXrr3+Hi63tHnz5nnNnj3bsN10Xl6eYty4cb5HjhxROTg41CxcuDBr2rRphQAQExOjUalUNZs3b7YbM2ZMSVPqnzZtmvfXX3/tWF5erlCpVDWPP/74lX/961+Nbm/d3r777jvlE0884ZeXl5dQP721X6ebWbhwodeKFSt+1x8nJyebjx8/3jchIcHG3d29avny5b8/+OCDZQAwduzYktdee837+PHjVjExMTe9o+2tIjs72/Q///mP08WLF8/o07755hvlM8880yE3N9c8LCzs6saNG9ODgoKqAGDBggV5MTExXWfPnp1vaWnZ7JkbBvJERK1s/PjxmDFjBg4fPoyoqCgcPnwYW7duvSbPpUuX4OTkBFtbW0ycOBEdO3aEt7d3k8r+FS9PaJH/P98SlnzOi36vt379epfVq1en64/feecd5927dzvExsYmmpiYYMCAAUFvv/125YsvvngFACZNmlQYHR0d/P7772dZWVkZxc9Bly5dMjt27Jjyq6++uqhPe/LJJzuYm5vL3Nzc+GPHjlmPHDkyMDo6Wh0dHV0BAKNHjy5cu3atS1MD1OnTp1/597//na1SqbRpaWlm9913X1BwcHDFhAkT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5sy5pccfGxtrOWHCBL+EhIRz9df7N+TEiRNWU6ZM6RgXF/ebPq13796dVq5cmREVFfWnltoYi/Z+nXbu3Kn64IMPXPbt23fhZnk3b95s98UXXzj98MMPhqC3S5cuwQcPHkyuv/b+VjRz5kwvV1fX6oULF16+Wd6nnnrKOyAgoPKll1660lie+Ph45/DwcN+GzjGQZyBPRH9jDOT/6HYK5InI+N0okOfSGiIiIiIiI8RAnoiIiIjICDGQJyIiIiIyQgzkiYiIbkyr1WpFe3eCiP5+6v7taXQffQbyREREN3b2ypUrdgzmiagtabVaceXKFTsAZxvL0+itfImIqHEXOr/W3l1oGT2fbe8e3PJqamqezM3N/SQ3NzcUnAAjorajBXC2pqbmycYyMJAnIiK6ge7du18GMLy9+0FEdD3OLBARERERGSEG8kRERERERoiBPBERERGREWIgT0RERERkhBjIExEREREZIQbyRERERERGiIE8EREREZERYiBPRERERGSEGMgTERERERkhBvJEREREREaIgTwRERERkRFiIE9EREREZIQYyBMRERERGSEG8kRERERERoiBPBERERGREWIgT0RERERkhBjIExEREREZIQbyRERERERGiIE8EREREZERYiBPRERERGSEGMgTERERERkhBvJEREREREaIgTwRERERkRFiIE9EREREZIQYyBMRERERGSEG8kRERERERoiBPBERERGREWIgT0RERERkhBjIExEREREZoTYP5IUQ/xRCpAkhKoQQsUKIu26Q9zUhhGzk4VqX555Gzndpu1EREREREbUt07ZsTAgxCsAKAP8EcKTuv7uFEMFSyt8bKPI2gDXXpW0FIKWUl69LDwFQWO/4Ssv0moiIiIjo1tPWM/LPAVgvpVwrpTwnpZwFIAfA9IYySynLpZS5+gcAMwB3AVjbQPbL9fNKKWtbbRRERERERO2szQJ5IYQ5gO4A9l53ai+AO5tYzRMAigHsaODcSSFEjhBivxCi35/uKBERERGREWjLpTXOABQA8q5LzwMw4GaFhRAmACYD2CClrKx3Sj+j/38AzAE8DmC/EOIeKeXhBuqZAmAKAHh6euLgwYMAAH9/fyiVSsTHxwMAnJycEBISgsOHdVWYmpqiT58+OHXqFEpLSwEA0dHRyMvLQ0ZGBgCgU6dOsLCwwNmzZwEArq6u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k08+gbm5OSIiIgAAiYmJAICjR48iNjYWS5YsuSa9pqYG//znP/HII4+03aCIiIiIjIRpe3eAjJelpSVeeeUVDBgwAFJK3HPPPfjHP/6BMWPGAAA2b96MhQsXYseOHbCwsIBCocDHH39sKH/nnXeioqICJiYmWLRoEfz8/AAACxYswHfffQcAiIqKwrp169p+cERERES3OAby9Je8+uqrePXVV69J27x5s+G5iYkJzpw502DZkpKSBtN37tzZch0kIiIiuk1xaQ0RERERkRHijDxd40Ln19q7Cy0mIPm19u4CERERUavhjDwRERERkRFiIE9EREREZIQYyBMRERERGSEG8kRERERERoiBPFGdPXv2oHPnzggMDMTSpUv/cF5KidmzZyMwMBBhYWE4deoUAKCiogJ33HEHwsPDERIScs12nKNGjUJERAQiIiLg6+truBkWERER0V/FXWuIANTW1mLGjBn46aef4O3tjR49emD48OEIDg425Nm9ezdSUlKQkpKC48ePY/r06Th+/DgsLCxw4MAB2Nraorq6Gn369MGQIUPQs2dPfPnll4byzz//POzs7NpjeERERHQb4ow8EYATJ04gMDAQ/v7+MDc3x+jRo/HNN99ck+ebb77B+PHjIYRAz549UVxcjJycHAghYGtrCwCorq5GdXU1hBDXlJVSYtu2bXjsscfabExERER0e2MgTwQgKysLPj4+hmNvb29kZWU1OU9tbS0iIiLg6uqK++67DzExMdeU/eWXX+Dm5oZOnTq14iiIiIjo74SBPBF0M+bXa2hWvbE8CoUCcXFxyMzMxIkTJ3D27Nlr8m3ZsoWz8URERNSiGMgTQTe7npGRYTjOzMyEp6dns/PY29vjnnvuwZ49ewxpNTU12LlzJ0aNGtVKvSciIqK/IwbyRAB69OiBlJQUpKWloaqqClu3bsXw4cOvyTN8+HBs2LABUkocO3YMdnZ28PDwwJUrV1BcXAwA0Gg02LdvH7p06WIopz/29vZuyyERERHRbY671hABMDU1xapVqzBo0CDU1tZi8uTJCAkJwZo1awAA06ZNw/33348ffvgBgYGBsLa2xmeffQYAyMnJwYQJE1BbWwutVotHH30UQ4cONdS9detWLqshIiKiFsdAnqjO/fffj/vvv/+atGnTphmeCyGwevXqP5QLCwvD6dOnG613/fr1LdZHIiIiIj0urSEiIiIiMkKckafb1ssTStq7Cy1iyee8iRQRERH9EWfkiYiIiIiMEAN5IiIiIiIjxECeiIiIiMgItXkgL4T4pxAiTQhRIYSIFULcdZP83YQQh4QQGiFElhBiobjulptCiLvr6qoQQlwUQkxrrD4iIiIiottBmwbyQohRAFYAWAwgEsB/AewWQnRoJL8KwE8A8gD0ADAbwBwAz9XL4wfgh7q6IgEsAbBSCPFw642EiIiIiKh9tfWM/HMA1ksp10opz0kpZwHIATC9kfxjAVgDmCClPCul3AHgXwCeqzcrPw1AtpRyVl2dawF8DuCF1h0KEREREVH7abNAXghhDqA7gL3XndoL4M5GivUC8IuUUlMv7UcAngB86+W5vs4fAUQLIcz+Sp+JiIiIiG5VbTkj7wxAAd0ymfryALg3Usa9kfz6czfKY1rXJhERERHRbac9bgglrzsWDaTdLP/16U3JozshxBQAU+oOy4UQyTdo+2/nk7ZpxhlAfqu3cv71Vm+iLSzd0N49oIbcNn8rt8nfCdCifysdW6wmIqJW1JaBfD6AWvxx9t0Vf5xR18ttJD/qlWksTw2AgusrlFJ+DODjpnWZWoMQ4qSUMrq9+0F0q+PfChER3UibLa2RUlYBiAVw33Wn7oNux5mGHAVwlxDC8rr82QDS6+UZ0ECdJ6WU1X+lz0REREREt6q23rXmXQAThRBPCiG6CiFWQHfh6hoAEEIsEULsr5d/MwA1gPVCiFAhxEMAXgLwrpRSv2xmDQBvIcR7dXU+CWAigLfbaExERERERG2uTdfISym/FEI4AXgFgAeAswDul1JeqsviASCgXv4SIcR9AFYDOAmgCMA70H0h0OdJE0LcD2A5dNtYZgOYXbdVJd2auLSJqGn4t0JERI0S/5vYJiIiIiIiY9HWS2uIiIiIiKgFMJAnIiIiIjJCDOSJiIiIiIwQA3lqE0KITkIIt/buBxEREdHtghe7UqsRQrgCeBzAswCuQHeTrhwA2wHskFJebcfuERERERk1BvLUaoQQ6wEEA/gOurvsOgGIANAVQCaAf0spf2qv/hHdSoQQKgBlkv8oExFREzGQp1YhhBAAyqC7T8Dhemk+AGIAPAWgI4BRUsq49uon0a1CCPERgBN1j0tSytIG8jhJKQvavHNERHRL4hp5ai3BANIAVOkTpM7vUsr/ABgKXaA/qp36R3TLEEI8Bt2X23cAfANgmRBihBAiQAhhVZfHCsA6IUS3duwqERHdQjgjT62iLuj4DoA1gPEALkgptdflmQXgCSllRNv3kOjWIYRYC6AWwL8BPARgAnR3uU4G8AOA/QA6A1ghpTRvr34SEdGthTPy1CqklBoA8wFYAdgAYLwQwkcIYQMAQghrAHcDONt+vSRqf0IIU+h+vSqWUl6UUr4tpewGoAeAQ9AF9dsArASwsf16SkREtxrOyFOrEkKEAlgAYDiAqwCOQreDzQDodrB5Ukp5pv16SNT+hBAOANyklL8JIcwBVNe/6FUIMQrAFgBRvKaEiIj0GMhTm6jbivIBAA8CqIBuJv4/Usrf2rNfRLcqIYQJdP9G1wohnoJuWY11e/eLiIhuHQzkqc0JIUyuXy9PRI0TQjwHQCGlXNbefSEiolsHA3kiolucEMIMQC2/ABMRUX0M5ImIiIiIjBB3rSEiIiIiMkIM5ImIiIiIjBADeSIiIiIiI8RAnoiIiIjICDGQJyIiIiIyQgzkiYiIiIiM0P8DDva32EPvzrsAAAAASUVORK5CYII=", + "text/plain": [ + "
" + ] + }, + "execution_count": 17, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram(counts_1q_2, \n", + " legend=['h(0); meas(0); x(0); meas(0);', \n", + " 'h(0); meas(0); reset(0); x(0); meas(0)', \n", + " 'h(0); meas(0); 3x reset(0); x(0); meas(0)'], \n", + " title=\"ibmq_manhattan\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Multi-qubit circuit with reset" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This next experiment combines multi-qubit operations with `reset` and mid-circuit measurements. A complex circuit is considered with the possiblity of multiple `reset`s in the middle. The expected result is given by the Aer qasm simulator (it can also be verified analytically). \n", + "\n", + "Without any `reset`s, we expect the result of the first measurement to be all 50/50 `0`s and `1`s. We expect the result of the second measurement to give nearly equal counts in all 8 possible states. \n", + "\n", + "With `reset` added, we expect all `1`s after the first measurement and 50/50 counts for the states `010` and `110` after the second measurement.\n", + "\n", + "We run the circuit with 0, 1 and 3 `reset`s. We see an improvement for 1 reset and further improvement for 3 resets." + ] + }, + { + "cell_type": "code", + "execution_count": 18, + "metadata": {}, + "outputs": [], + "source": [ + "def multiq_custom_circ(n_resets):\n", + " \"\"\"Custom multiq circuit w/ many resets.\"\"\"\n", + " qc = QuantumCircuit(n_qubits, 4)\n", + " qc.h(0)\n", + " qc.h(1)\n", + " qc.h(2)\n", + " qc.reset([0]*n_resets)\n", + " qc.measure(0, 0)\n", + " qc.cx(0, 2)\n", + " qc.reset([1]*n_resets)\n", + " qc.x(1)\n", + " qc.measure([0, 1, 2], [1,2,3])\n", + " return qc" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "metadata": {}, + "outputs": [], + "source": [ + "circs_multiq = [multiq_custom_circ(0), multiq_custom_circ(1), multiq_custom_circ(3)]" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "First we run on the simulator to verify our expected output." + ] + }, + { + "cell_type": "code", + "execution_count": 20, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Meas 1 sim result: [{'0': 536, '1': 488}, {'0': 1024}, {'0': 1024}]\n", + "Meas 2 sim result: [{'000': 141, '001': 119, '010': 116, '011': 104, '100': 137, '101': 141, '110': 142, '111': 124}, {'010': 518, '110': 506}, {'010': 493, '110': 531}]\n" + ] + } + ], + "source": [ + "# verify expected output via Aer qasm simulator\n", + "sim_job_multiq = execute(circs_multiq, backend=Aer.get_backend('qasm_simulator'), optimization_level=0)\n", + "sim_counts_multiq_1 = marginal_counts(sim_job_multiq.result(), indices=[0]).get_counts()\n", + "sim_counts_multiq_2 = marginal_counts(sim_job_multiq.result(), indices=[1,2,3]).get_counts()\n", + "print(\"Meas 1 sim result: \", sim_counts_multiq_1)\n", + "print(\"Meas 2 sim result: \", sim_counts_multiq_2)" + ] + }, + { + "cell_type": "code", + "execution_count": 21, + "metadata": {}, + "outputs": [], + "source": [ + "legend_multiq_1 = ['h(0,1,2); meas(0);', \n", + " 'h(0,1,2); reset(0); meas(0);',\n", + " 'h(0,1,2); 3x reset(0); meas(0);']\n", + "legend_multiq_2 = ['h(0,1,2); meas(0); cx(0,2); x(1); meas(0,1,2);', \n", + " 'h(0,1,2); reset(0); meas(0); cx(0,2); reset(1); x(1); meas(0,1,2);', \n", + " 'h(0,1,2); 3x reset(0); meas(0); cx(0,2); 3x reset(1); x(1); meas(0,1,2);']" + ] + }, + { + "cell_type": "code", + "execution_count": 22, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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pm8AIyIiuhmP/R09m/P4q/6IxKY4zpIlS7zj4uIKg4KCKgFAr9dj1qxZARs2bPAGgHHjxl1ZsWJFpo3NjWNbpaWlMnr06JCjR486Xbhwwe7rr79OGjlyZGFN5ykpKZEpU6YE7d692zU/P982KCiobMGCBZljxowpAIC4uLgSV1fXyvXr17tNmDAhvyn61hJKS0tl8eLF/nv37j1pKtuzZ4/jY489Fnz27FmH0NDQ0lWrVqX169evBACefvrp7JCQkG7z58+/FBAQUNl6kf+2cGSWiIjoNrV69WrvqVOn5pi2Fy9e7LVlyxb3xMTE4wcPHjy+bds2t7feesu7tvb9+vUr+uCDD1K9vLwq6jpPRUWFBAYGVvz444+nCwoKDr744ovnH3744bDTp0/bmeqMGzcud9WqVbWe61a0fv36NqGhoSUhISEVgCG5feCBB8LHjBmTk5ube2j8+PE5DzzwQHhpaakAgE6nU4MHD87/5z//6dm6kf+2MJklIiKyYgcOHNBFREREuri49Pj9738fWlxcLACQnJxsl5GRYT948OBrprrr16/3mj17dlZYWFhFSEhIxezZsy+tW7euxsTLwcFBvfjii5eHDx9eVNPIrSVXV1f9kiVLLnTs2LFco9Fg/Pjx+QEBAWV79+7VmercfffdhXv37nUtKSkRAHjnnXc8IiIiIms7Zu/evTvOnTvXPzo6upNOp4u+6667wrOysjSjRo0KcXZ2ju7atWtny2T54MGDDv369evg5ubWIzg4uOt7773nbtq3ceNGt86dO0c6OztH+/r6dn/66af9TfuKi4vl3nvvDWnTpk0PFxeXHl27du2ckZFhCwBbtmxx69+/f5Gp7rfffutSWVkpf/7zny87OjqqF1544bJSCt988415qsfAgQMLv//+ezfT9qRJk4ImTZoUVOcFpF+FySwREZEV++KLLzy2bt2afObMmaMnT550XLZsmRcAJCYmOgYGBpZptVpz3TNnzjjExMSUmLZ79uxZfObMGcemjikjI8M2PT3dISoqqtRUFhISUmFra6uOHDniAAAzZszITUpKOlHXcTZv3uyxdu3a1IyMjCPp6en2ffr06Txt2rQreXl5Bzt06FAyf/58fwAoKCiwueeeeyLGjh2be+XKlUNr1649+8wzzwQlJCQ4AICzs7N+zZo1qfn5+Qe//PLL5DVr1nh/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Hdt+zJgxefHx8QV1tW0Khw8f9oqKigquaR+TWSazRERk4XZKZoluF3Uls5xmQERERERWi8ksEREREVktJrNEREREZLWYzBIRERGR1WIyS0RERERWq0WTWREZICJfich5EVEiMrUBbbqJyE4RKTG2e1EsHwliqDNQRBJFpFREzorIjGbrBBERERHdMlp6ZNYZwDEATwKod902EXEFsA3AJQC9AMwF8AyApy3qhAD4FsAeANEAXgewVETimzp4IiIiIrq1tGgyq5T6Vin1vFLqMwD6BjSZCEAHYIpS6phS6nMAfwXwtMXo7AwAF5RSc5RSJ5VSqwCsATCvOfpARER0qwgICOi2efPmWh+ZWlJSImFhYV3OnTtn25JxVbdv3z7H6OjoTq0ZQ2tJTEx06Nq1a+eG1LXm6/Tmm296TZs2rV1D6r766qttn3jiiYCmOner/s/dAH0B/KSUshzF/R7AXwAEA0g11tlard33AKaIiFYpVecTT4iIiBrrf6fkN+vz6F9f45bYFMdZsmSJd1xcXGFQUFAlAOj1esyaNStgw4YN3gAwbty4KytWrMi0sblxbKu0tFRGjx4dcvToUacLFy7Yff3110kjR44srOk8JSUlMmXKlKDdu3e75ufn2wYFBZUtWLAgc8yYMQUAEBcXV+Lq6lq5fv16twkTJuTXdIzqZsyYEbh582aPoqIijaura+VDDz2U/de//jXrpi9GM/vmm29cHnnkkZBLly4dsSx//vnnA+bOnWuO+9KlS5pJkyYF796929Xd3b3yxRdfPD9jxoxc4Oau062gtLRUFi9e7L93796TprI9e/Y4PvbYY8Fnz551CA0NLV21alVav379SgDg6aefzg4JCek2f/78SwEBAZW/9vy3ejLrCyCzWtkli32pxv/+p4Y6tgC8AFy03CEi0wFMBwB/f3/s2LEDABAaGgoXFxccPnwYAODp6YkuXbpg165dAABbW1v0798fBw4cQEGB4altsbGxuHTpEjIyMgAAHTp0gL29PY4dOwYAaNu2LSIiIrB7924AgL29Pfr27YuEhAQUFRkeRx0XF4fMzEycP2944l3Hjh2h0Whw4sQJQyd9fRESEoK9e/cCABwdHREXF4d9+/ahpMSQ4/ft2xepqanIyjL8rERGRqKqqgqnT58GAAQEBCAwMBD79u0DADg7OyM2NhZ79+5FWVkZ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aDK7poaytU0ZCBERERFRYzUomVVKPdzcgRARERERNVZjH2dLRERERHTLYDJLRERERFaLySwRERERWS0ms0RERERktZjMEhEREZHVYjJLRERERFaLySwRERERWS0ms0RERERktZjMEhEREZHVYjJLRERERFaLySwRERERWS0ms0RERERktZjMEhEREZHVYjJLRERERFaLySwRERERWS0ms0RERERktZjMEhEREZHVYjJLRERERFaLySwRERERWS0ms0RERERktZjMEhEREZHVYjJLRERERFaLySwRERERWS0ms0RERERktZjMEhEREZHVYjJLRERERFaLySwRERERWS0ms0RERERktZjMEhEREZHVYjJLRERERFarxZNZEXlCRFJFpFREEkXkzjrqDhKRL0XkoogUi8gREZlWQx1Vw6tT8/eGiIiIiFpTiyazIjIWwD8ALAQQDWAPgC0iElRLk34AjgJ4AEBXACsBvCsiE2qo2wWAn8UruWmjJyIiIqJbjW0Ln+9pAKuVUquM23NE5G4AMwH8b/XKSqmF1YpWishgAPEA1lfbd1kpdaWpAyYiIiKiW1eLjcyKiB2AngC2Vtu1FYYR2IZyBZBXQ3mCcTrCD8aEl4iIiIhucy05MusFQAPgUrXySwCGNOQAIjISwO8A3GFRfBGGkd1fANgBeAjADyIySCm1q4ZjTAcwHQD8/f2xY8cOAEBoaChcXFxw+PBhAICnpye6dOmCXbsMh7C1tUX//v1x4MABFBQUAABiY2Nx6dIlAGENCZ/opuzduxdlZWUAgP79+yMpKQmXL18GAHTt2hVlZWVITjbMqmnXrh18fHyQkJAAAHB1dUVMTAx2796NyspKAMCAAQNw/Phx5OTkAACioqJQWFiIs2fPAgCCg4Ph4eGBAwcOAADc3d0RFRWFnTt3QikFEcHAgQNx+PBh5OUZ/q6MiYlBbm4u0tLSANT+83Q73XNq+t3h7OyM2NjY2+pzasjvvYyMDABAhw4dYG9vj2PHjgEA2rZti4iICOzevRsAYG9vj759+yIhIQFFRUUAgLi4OGRmZuL8+fMAgI4dO0Kj0eDEiRMAAF9fX4SEhGDv3r0AAEdHR8TFxWHfvn0oKSkBAPTt2xepqanIysoCAERGRqKqqgqnT58GAAQEBCAwMBD79u1r9OdERNZFlFItcyIRfwDnAQxQSv1k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", + "text/plain": [ + "
" + ] + }, + "execution_count": 22, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram(sim_counts_multiq_1, \n", + " legend=legend_multiq_1, \n", + " title=\"QASM simulator\")" + ] + }, + { + "cell_type": "code", + "execution_count": 23, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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LDs7O/W2bdviN23aZO/s7Ny0QYMGoZMmTXIrKioSADBv3rxrc+bMcbG2tg6fNWuWS8+ePbO1eW/evGnWr18/H6VSGR4YGBjcqlWrvDFjxmQCwIABA3KuXr1qmZycbAZoZgDetGlTwvr16x3s7OzCV69e7bhp06YES0tLCdAED3v27LF94403MvXKN2/dunW1x2lnZ6f+448/4rdt21avQYMGoY0bNw7ZtWuXMisry2TEiBFen3766TUvL6/Sbt265Q8YMODOkCFDPNVqNSwtLaV+/fplLl++XHdt582bd9PT07PYy8uraefOnf3Hjh17S/tKj6KiInH37l3Ttm3bFgDAp59+6pydnW361ltveWqvla+vb5C2rP3798utrKzUHTp0UFWXv6qhQ4d6dOnS5W7//v1znJ2dyxctWpQ8fvx4j/T0dBkAjBo1KmPt2rW6ul65csXc2to6IjIyMggArK2tI3x9fYO129etW1cvKioqTzuWOTEx0Uwul6sjIyMf+rUvALB48eLr3t7exVFRUU0UCkV4p06d/C5evGgJAJMnT75VVFRk4ujoGBYVFdWka9euugBOrVaLL7/80tnV1bVpvXr1wg4dOqRcunRpCoCHviba82BraxsOAGFhYcHW1ta6MQ/Xr183i4qKygeAXbt2We/du9f20KFDNra2tuHaa7h9+3bdbMA//vij/dixYzOqy0/0OAltN4J/osjISEk74QcREREACCFOSZKkG6QaExOTHBoaeud+ef6uCgsLRXBwcOCePXviH/S+xMTERLPo6Gifs2fPXqpN2c8880zjhQsXpkZERDywG+Hx48etRo0a5aFfdl3yP06ff/65Y1xcnNV3332X+qC0n3zySf3U1FTzZcuWXQc0AUZgYGDgxYsX46p2Q35YN2/eNH3mmWf8z58/H1ddS7O+HTt2KBYtWuT022+/JdWm7G7duvkMHz78Tv/+/XP+Sv7qNGvWzH/BggXXtBMR3U/Tpk0DVqxYkdy8efMiAFiyZIl9bGys1eLFi2/81f0/Csa8JgEBAYH79u277Ozs/MAxo2vXrrVdvXq1wx9//HH1r+QnelgxMTGOoaGhntVtY/DJ4JOIiPQ8TcEnERHRo3a/4PNRj/kkIiIiIiKifyAGn0RERERERGR0DD6JiIiIiIjI6Bh8EhERERERkdEx+CQiIiIiIiKjY/BJ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XQoLC8WoUaPcGjZsGOLg4BA6aNCgRvn5+QIAMjIyZB06dPC1s7MLtbGxCevQoYNvYmKimf6+3NzcQqytrcNdXV1Dli5dag8A+/bts1YqleU+Pj66YHnTpk0O06ZNS3NyciqPiIgoGjx4cMbKlSt1x9mhQ4eC69evm8fHx5sDwI4dOxRKpTKspmuYn58vRo4c6ebi4hKiVCrDmjVr5p+fny++/fZbOzc3t5CsrCwTANi4caONo6Nj6M2bN00BYO/evbYdO3bM1z//HTt2vPvcc8/l29raqufOnXtzx44d9bKzs++5MQMDA0s++uijWx4eHqWmpqaYOHHindLSUpNz587pukV36tQpb/fu3bpW+KlTpzp36NDBt6bjcHV1DZk2bZqzn59foLW1dURpaSl2795tHR4eHqBUKsP8/f0D9XsG1HTOAeDLL7908Pb2DrKxsQlr06ZNY+25jIyM9AeA5s2bB8rl8vBvv/3WrrrPcIcOHVRjx47N8vX1La6urj4+PqU2Njbl2tbeK1eumCuVyrArV66YV5e+ffv2viNHjnTTLj///PPeffv29QSqv0deeumlvBEjRmS7uLhU+yVLXe+R6OhozyFDhjRq165dY7lcHh4RERFw7do10+HDh7vb2NiEeXl5Bel3f09OTjbr1q2bj52dXairq2vIxx9/XF+7be/evfKwsLAApVIZ5uTk1PTVV19tpG1BVKvVeP31193t7e1DlUplmJ+fX+CJEycsAeC3336zbdmype7zfu7cOYu4uDj5f/7zn5sKhUIaNmzYXT8/v8LVq1fboRoPuib6+vXrlzt8+PBse3t7tVKpVL/11lu3T58+XenvRNu2bfO2bt2quz87dOjgO3XqVIO1Zj9uDD6JiJ4CknTvF9xCVO61ExERgZSUFMTExGD8+PF46aWXHljud999h8WLF6NZs2bIy8uDuXm1zy/0GP3000/2O3fuvJKQkHD+4sWLVosWLXIEgFOnTlm5ubkV67fSJCQkWEZEROi6kjZr1kyVkJBg8O6HqamppikpKZahoaFF2nVeXl6lpqamkjYIGD16dFZ8fPy9fcP1bN682f6bb75JzsvLO92wYcOy5557zq9///5Zd+7cObt69eqr7733XiPtWMtx48Z5LF68OKWgoOBMbGxsrDZ4PHjwoHzs2LGeS5YsScnOzj47fPjwjN69e/sW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ZLJK67Ozs/HLL78gKSkJ9erVQ9++fbF69WoMGTLEqHUmMoQpQ3NqnXbOqifqufexmDI0554HHEOas8r2lCHKWblypdPixYuTtcvz5s1z3LZtm92pU6diTUxM0LlzZ7/PP/+8+P3338+oLn/r1q3z33nnndtDhgy577fepaWlws3NrXTv3r2XfX19SzZu3Gj72muv+YSGhsb6+/uXAMCAAQOyvv32W6dBgwbV6mYcM2ZMxmeffXbTxsZGnZSUZNalSxe/wMDAoqFDh96t/Rmotq4wMzN7mCJqLSUlxezo0aPKn3766ap23YgRIxqZm5tL6enpMUePHpX36dPHNzIyUhUZGVkE1P08/R2sXbu2nre3d6GXl1cpoAlG+/Tp4/vGG2/cev/99zPmzZvn1KdPH9+rV69esLS0lORyudShQ4ecr7/+2mHWrFm3jFWvwsJCsXnzZoeTJ0/qxtdMnDjR5erVqxZJSUnnUlNTzbp27eofHBxc2KdPn9yq+e/evSubMmVKWrdu3fKLiopEdHS099ixY93Wrl17DQA6dOigys/Plx04cEDerl071YPq4+HhUbply5bExo0bl6jVasydO7f+wIEDvePj4x96CvKysjKYmj6ax/pFixY59enTJ1P7/nMTExOpa9euOVOnTk3r0qXLPS33dT1PD/LNN984DRo0SDcjn7m5uRQdHZ09evTojFdeecWnavpBgwbdfffddz1SUlLMPDw8Sh92/4/Cw967D7om+nJyckyaNWumWrRo0XVXV9fSL7/80jE6Oto3OTn5vK2trRoAevfunbl48WKnqKioaw97bGz5pH8UNzc3pKam6pavX7+u6zqrdfLkSQwYMACenp7YvHkz/vWvf+Hnn3/Grl274OXlBScnJ5iZmaF37973vHeRiOhRO336tNzPzy9QqVSGPf/8897aLlpXrlwxT01NtejQoUOBNu3atWsdx40bl+7j41Pq5eVVOm7cuFtr1qxxqK5cS0tL6cMPP7zdrVu3fO1DZk1sbGzU8+fPv+nv718ik8kwcODAHFdX1+IjR47ItWm6d++ed+TIEZvCwkIBAMuWLbP38/MLrKnM0NDQYhsbG12zrImJiXTlyhULAPj222/t3NzcQrKyskwAYOPGjTaOjo6hN2/evOfp+/Lly+ZCiGZffPGFY8OGDUNatWrlDwBffvmlg7e3d5CN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rN80w1ayioeZXbi2ef/44w+0adPm4StLRERERPSIMfgkMpCHmSipNnl9fX0hhGDLJ/3t1GViKk5KRURE9M/FMZ9EBvIwEyU9KG/79u2RlJSE+Ph4g46vJSIiIiJ6VNjy+Q/G1grDmj59Oj777DNs2LABXbp0QWJiIr766quHzjt06FAcOHAABw8eRKNGjYx5CERERERERsOWTyIDeZjZhWvKCwD//e9/AQBt27aFiYmJwV87Q0RERET0KLDlk544dWmxnWy0WlTvYSZKqi4vUP14UCIiIiKiJw1bPomIiIiIiMjoGHwSERERERGR0TH4JCIiIiIiIqNj8ElERERERERGxwmHiB4RvtqGiIiIiP7J2PJJRERERERERsfgk4iIiIiIiIyOwScREREREREZHYNPIiIiIiIiMjoGn0RERERERGR0DD6JiIiIiIjI6Bh8EhERERERkdEx+CQiIiIiIiKjY/BJRERERERERsfgk4iIiIiIiIyOwScREREREREZHYNPIiIiIiIiMjoGn0RERERERGR0DD6JiIiIiIjI6Bh8EhERERERkdEx+CQiIiIiIiKjY/BJRERERERERsfgk4iIiIiIiIyOwScREREREREZHYNPIiIiIiIiMjoGn0RERERERGR0DD6JiIiIiIjI6Bh8EhERERERkdEx+CQiIiIiIiKjY/BJRERERERERsfgk4iIiIiIiIyOwScREREREREZHYNPIiIiIiIiMjoGn0RERERERGR0DD6JiIiIiIjI6Bh8EhERERERkdEx+CQiIiIiIiKjY/BJRERERERERsfg82/g448/hrm5OczMzNC9e/f7pt2+fTv8/f3h6+uLuXPnPqIaVu9JrfeTqC7nGvj7nO8n9R55Uuv9JHpS720iIiKqOwafj1lJSQlmzpyJnTt3Ijs7G/v378evv/5abdry8nKMHTsW27ZtQ1xcHNatW4e4uLhHXGON/2vv3oOsLu87jr8/sCIiCkqIwnAZwFZUqGKgahORpjheqBrNEEmd4hXHmNEkxDTakqbTTOMkGqKjNKhRiaZqNOpojRlN4+gag0UwNpoo0bgqrKgJUQLeQPz2j+e3O4fD2YVddn+X5fP6R8/vPOfs5zzz0znf89yqmruKutLXUJ7+ruo9UtXcVVTVe9vMzMy6x8VnwZYsWcKQIUOYMWMGgwcPZvr06SxatKhh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", + "text/plain": [ + "
" + ] + }, + "execution_count": 23, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram(sim_counts_multiq_2, \n", + " legend=legend_multiq_2, \n", + " title=\"QASM simulator\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now we run on a real backend." + ] + }, + { + "cell_type": "code", + "execution_count": 24, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "5ff748720a2d1ce5be694331\n", + "Job Status: job has successfully run \n" + ] + } + ], + "source": [ + "job_multiq = execute(circs_multiq, backend=backend, optimization_level=0)\n", + "print(job_multiq.job_id())\n", + "job_monitor(job_multiq)" + ] + }, + { + "cell_type": "code", + "execution_count": 25, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Meas 1 result: [{'0': 470, '1': 554}, {'0': 939, '1': 85}, {'0': 991, '1': 33}]\n", + "Meas 2 result: [{'000': 146, '001': 118, '010': 143, '011': 138, '100': 113, '101': 119, '110': 128, '111': 119}, {'000': 54, '001': 2, '010': 440, '011': 43, '100': 36, '101': 6, '110': 411, '111': 32}, {'000': 45, '010': 444, '011': 24, '100': 24, '101': 1, '110': 472, '111': 14}]\n" + ] + } + ], + "source": [ + "counts_multiq_1 = marginal_counts(job_multiq.result(), indices=[0]).get_counts()\n", + "counts_multiq_2 = marginal_counts(job_multiq.result(), indices=[1,2,3]).get_counts()\n", + "print(\"Meas 1 result: \", counts_multiq_1)\n", + "print(\"Meas 2 result: \", counts_multiq_2)" + ] + }, + { + "cell_type": "code", + "execution_count": 26, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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zOeqevwf5erqati8eXPyxo0b3by8vLq3a9cu4oUXXvA1LZm1YMGC3+fPn+/t4OAQ9frrr3uPHDkyz3Ts2bNnbcaMGRPk5OQUFRoaGt6nT5/CadOm5QDAuHHj8k+dOmWfnp5uAxhXeNi4cWPqhg0b3F1dXaPWrFnjsXHjxlR7e3sFGFdG2L59u8sTTzyRU6V92759+zZJP6l2Yhpm/zOKiYlR8fHxrR0GERHdQEQkQSkVY9o+cOBAekRExMXWjOl66fV6CQ8PD92+fXtyx44d610r9uTJkzZxcXFBSUlJxxvS9i233NJp0aJFmdHR0decNrBv3z7tlClTOlZtuzHHt6Z33nnH4+jRo9oPP/ww81p133zzzbaZmZm2y5cvPw0Y16UNDQ0NPXbs2NGa0y6ocQ4cOOARERHhX9s+JrNMZomIqIqbKZklulnUl8xymgERERERWSwms0RERERksZjMEhEREZHFYjJLRERERBaLySwRERERWSwms0RERERksZjMEhEREZHFYjJLVGnLli3o3LkzgoOD8dZbb121Py8vD/feey+6d++OXr164fDhw+Z9ly5dwujRo9GlSxd07doVe/bsAQAkJSWhd+/eiIyMRExMDPbt29di/SGim5+Pj0+3TZs2OdW1X6/XS1BQUNjvv/9u3ZJx1bR3715tVFRUl9aMobGio6O7/Pzzz9qG1O3WrVvX+Ph4++aOqamdPXvW2t/fP9z0yOL6ZGZmWgcGBobp9fpr1m1prfo/N9GNoqKiAtOnT8f3338PX19f9OzZE3fffTdCQ0PNdebNm4fIyEh8+eWXOH78OKZPn44ffvgBAPD000/jjjvuwOeff44rV66guLgYAPD888/j1VdfxfDhw/Hdd9/h+eefx44dO1qji0TUhE52ntujOdsPOjE3oSnaWbhwoWdsbGyhn59fOQAYDAZMnz7dZ/369Z4AMG7cuItLly49bWV19dhWSUmJjBo1KuDQoUMOZ8+etf3666+TR44cWVjbefR6vUyaNMlv9+7dzvn5+dZ+fn6lr7322ukxY8YUAEBsbKze2dm5fN26dS4TJkzIb4q+NRUfH59uS5YsSR81apS5b+vWrXNxcHCouOWWW/Smstdee63tokWL2peWlsodd9xx6eOPP87QarUKAJ5++ums2bNn+2zduvVka/Ther366qteEyZMuKjT6RRg/Bwfeuihjps3b3a1t7c3zJgxI2vu3LnnAaBDhw7lffv2LVy4cKHn7NmzL7Ru5NVxZJYIwL59+xAcHIzAwEDY2tpi3Lhx+Oqrr6rVOXr0KG6//XYAQJcuXZCeno7z58+joKAAu3btwqOPPgoAsLW1RZs2bQAAIoKCggIAQH5+Pry9vVuuU0T0p7dq1SrPhx9+OMe0vWDBAo/Nmze7JiQkHNm/f/+R77//3uWdd97xrOv4vn37Fn344YdpHh4e9T4Kt6ysTHx9fct+/PHHEwUFBfvnzJlzZvLkyUEnTpywNdUZN25c7ooVK+o8V30MBgMqKiqu59Dr8sEHH3hOmDDBfN2++OIL5/fff7/9li1bTpw6depQRkaG3f/8z/+Yf6FPmDDh0q+//uqUkZFh02JB/kF6vV4+//xz90cffdTcz1mzZnmfOnXKLi0t7eC2bdtOLF682Ovzzz93Nu1/6KGHclatWnVdn2FzYjJLBODMmTPo0KGDedvX1xdnzpypViciIgL//ve/ARiT34yMDJw+fRqnTp2Cp6cnJk+ejKioKDz22GO4fPkyAODdd9/Fc889hw4dOmDWrFmYP39+y3WKiP4UEhMTdSEhIaFOTk6Rd955Z6DpK+OUlBTbzMxMu0GDBl021V23bp3HjBkzsoKCgsoCAgLKZsyYcX7t2rXutbVrb2+v5syZc2HYsGFFtY3cVuXs7GxYuHDh2c6dO1/RaDQYP358vo+PT+mePXt0pjp33HFH4Z49e5xNX1MvX77cLSQkJLSuNnv16tX5qaee8omOju6i0+mijx07Zrd//377vn37dnJxcYn09/cPX7lypaup/qeffuoSFBQU5uDgENW2bdvuc+bMaWfat379epcuXbqEOjk5RUZFRXXZu3evFgBGjRoVcO7cOdtx48Z10ul0US+//HK7kpIS+fXXX52HDh1qHqldtWqV+/jx4y/GxMSUeHp6VsyePfvsZ5995mHar9PpVFhY2OX//Oc/5sTPyckpcuvWrY619e399993j46O7vLoo492cHJyivT19e32/fffO7z//vvuXl5e3d3c3CIWLVpk/lz0er1MmTLFt3379t3c3d0jJkyY4FdUVCQAkJ2drRk0aFCwq6trhLOzc+SgQYOCT548aVP1XL6+vt0cHByifHx8ui1btswNAHbs2OHg5ORUERQUZP5DZePGje6zZ88+5+npWREdHV3ywAMPZK9atcrcz0GDBl0+ffq0bXJysi0AbN261dHJySmyrs+wpTCZJQKglLqqTKT6tKAXX3wReXl5iIyMxKJFixAVFQVra2uUl5cjMTER06ZNw/79++Hg4GCec7ts2TL84x//QGZmJv7xj3+YR2+JiJrKl19+6bZt27aU1NTUQ8eOHdMuXrzYAwASEhK0vr6+pTY2/z9YmJqaah8dHW3+6rxHjx7FqampDZoX2hiZmZnWGRkZ9hERESWmsoCAgDJra2t18OBBewCYOnVqbnJy8tH62vn888/dPvjgg/TCwsLE9u3blw8fPjxk7NixuRcvXkxas2bNqeeee87PNFd1xowZHZcsWZJx+fLl/UeOHDliSkZ3796tmz59uv/SpUsz8vLykh555JHs++67L1iv18umTZvS2rdvf2XDhg0pxcXF+994443zhw8fthMRVTXJS05O1kZERBSbtnv16qXPycmxzsrK0pjKQkJCSg4cOGC+loWFhUnDhg0rqqtvBw8edOjevXtxXl5e0n333Zfz0EMPBf72228OaWlph1auXJn24osv+uXn51sBwPTp031TU1Ptk5KSjqamph7KysqyfeGFF7wB4zS5SZMmXfz9998PZWRkHLS3tzc88cQTfgBQUFBg9dJLL/l9++23yZcvX97/yy+/HO/Zs2cxACQlJWkDAwPNn092drYmOzvbxrQfACIjI/XJycnmucA2Njbo0KFD6W+//aYFgGHDhhUVFhYm1fcZtgQms0QwjsRmZmaat0+fPn3VlABnZ2d89NFHSEpKwscff4zs7GwEBATA19cXvr6+iI2NBQCMHj0aiYmJAIDVq1fjvvvuAwDcf//9vAGMiJrctGnTzvv7+5e1a9euYujQoflJSUlaAMjLy9M4ODhU+26+uLhY4+rqai5zdXWtKC4utjIYDE0WT2lpqYwdOzYwLi4uJyoqqqTqPp1OV5Gbm6up69iaxo4dmxMTE1NiY2ODf//7384+Pj6lTz/9dI6NjQ369etXPHz48Evr1693BQBra2t16NAh+9zcXCtPT8+Kfv36FQPAsmXLPB588MHs22677bK1tTWeeuqpHBsbG7V9+3aH2s6Zm5urcXBwqHZBiouLrapeNzc3twoAyM/PN/fFycnJkJ+f3+B7kUx9sba2xsSJE/OysrJs582bd1ar1ar7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RyxZsuR0YGBgaWxsbFdHR8eo22+/PeTYsWP2APDiiy+eLykpsfLw8IiMjY3tOnToUPM6vgaDQd59910vHx+f7m3atIn8+eefnZYtW5YBGFerGDNmTM7KlSvN/VywYMFZf3//0oCAgO6DBw/uPH369POjR482J+gff/yx++TJk82fYUZGhk1kZKR5tYzWIrXdxd1sJxMZAaAfgEQAHwN4Uim1qp76zgCSAewC8DqAzgBWAZirlFpQWScAwGEAHwJYWtn+UgDjlFJf1BdPTEyMio+P/2OdIiKim4qIJCilYkzbBw4cSI+IiLhY3zE3Kr1eL+Hh4aHbt29P7tixY71rxZ48edImLi4uKCkp6XhD2r7llls6LVq0KDM6Ovqa0wb27dunnTJlSseqbTfm+NbQo0ePzu+///7vVR+cUJfu3bt3+de//pXes2fPEgBYunSp25EjR7RLliw5c61jW9PZs2etb7nlls6HDh06WttoelVnzpyx7t+/f+fDhw8fNT1kYezYsR3HjBmTFxcXV1DfsU3hwIEDHhEREf617WvRZLbaiUWKAMy4RjI7DcDfALRTSukry14GMA2Ar1JKicjfANynlOpU5biVAMKUUn3qi4HJLBER1XQzJbNEN4v6ktkbfc5sHwA/mRLZSlsBeAPwr1JnW43jtgKIERGLeRIHERERETXejZ7MegE4X6PsfJV99dWxBuABalZvvPEGbG1tYWNjgzvuuOOq/WlpafD29oZWq4WjoyO+/PJL876QkBBYWVnB3t6+2jF+fn7QarXQarWwtraGVtvk63kTERHRTcISluaqOQ9CailvSB3jDpEpAKYAxjVAd+zYAQAIDAyEk5MTDhw4AABwd3dHWFgYdu3aBcC4dFO/fv2QmJiIggLj1JCYmBicP3/evNh+p06dYGdnh8OHDwMA2rZti5CQEOzevRsAYGdnhz59+iA+Ph5FRcY577GxsTh9+rT50amdO3eGRqPB0aPGh6J4eXkhICAAe/bsAQBotVrExsZi79690OuNA9Z9+vRBWloasrKMq46EhoaioqLCvO6pj48PfH19sXfvXgCAo6MjYmJisGfPHpSWlgIw3nWfnJyMCxcuAADCw8NRWlqKlBTjCigdOnRAu3btYJqW4ezsjPDwcMydOxfvvPMOQkJCEBcXh0WLFqFbN+PNqRERERg1ahTatWuHdevW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v5rr3XLLLbC2tsbOnTvx+eefN39niIhuMExmiYiamVLquupYWVkhLS0NP/74I44ePYqioiKUlpZi2rRp5jo///wzysvLMXDgQEydOrVJ4yYisgRMZomImlmXLl2Qk5Nj3k5LS0P79u2r1XF3d8exY8fM20VFRQgPD8eiRYvg6emJrl27QqfT4a677sJPP/101TnmzJmDvXv3Nl8niIhuUExmiYia2UMPPYT8/Hzs2rULRUVF2LVrF5588slqdcaOHYsNGzbAYDBg5cqVsLW1RWRkJMLCwvD777/j4sWLMBgM+OGHH9ClSxcAwPfff28+/h//+Ac8PDxatF9ERDcC69YOgIjoZmdvb4+XX34ZgwcPhlIKt956K+655x5MmDABALBu3TrMmTMHX3zxBezs7KDRaPDBBx8AAB599FF8/PHH8PHxgYjA29sbH374IQDg4YcfRk5ODkQEzs7O+Pbbb1utj0RErYXJLBFRC3j11Vfx6quvVitbt26d+b2VlRUOHTpU67E7d+6stfzMmTNNFyARkYXiNAMiIiIislgcmSUiug4nO89t7RCaRNCJua0dAhHRH8KRWSIiIiKyWExmiYioUbZs2YLOnTsjODgYb7311lX7lVKYOXMmgoOD0b17dyQmJgIASkpK0KtXL0RERCAsLKzaHOLnnnsOXbp0Qffu3XHvvffi0qVLLdUdIrJwTGaJiKjBKioqMH36dGzevBlHjx7F+vXrcfTo0Wp1Nm/ejJSUFKSkpOCDDz4wP+TBzs4O27dvx4EDB5CUlIQtW7bg119/BQAMGTIEhw8fxsGDBxESEoL58+e3eN+IyDIxmSUiogbbt28fgoODERgYCFtbW4wbNw5fffVVtTpfffUVHnroIYgIevfujUuXLuHcuXMQETg6OgIAysrKUFZWBhEBAAwdOhTW1sbbOHr37o3Tp0+3bMeIyGIxmSUiogY7c+YMOnToYN729fW9aomw+upUVFQgMjISbdu2xZAhQxAbG3vVOT788EMMHz68mXpARDcbJrNERNRgSqmrykyjqw2po9FokJSUhNOnT2Pfvn04fPhwtXpvvvkmrK2t8cADDzRh1ER0M2MyS0REDebr64vMzEzz9unTp+Ht7d3oOm3atMGtt96KLVu2mMtWr16Nb775BmvXrr0qQSYiqguTWSIiarCePXsiJSUFaWlpuHLlCjZs2IC77767Wp27774bH3/8MZRS+PXXX+Hi4oL27dsjOzvbvEqBXq/Hf//7X3Tp0gWAcYWEv/3tb/jPf/4DnU7X0t0iIgvGhyYQEVGDWVtbY/HixRg2bBgqKirwyCOPICwsDMuXLwcATJ06FSNGjMB3332H4OBg6HQ6fPTRRwCAc+fOYdKkSaioqIDBYMCYMWMwcuRIAMCMGTNQWlqKIUOGADDeBGZqk4ioPkxmiYioUUaMGIERI0ZUK5s6dar5vYhgyZIlVx3XvXt37N+/v9Y2U1NTmzZIIvrT4DQDIiIiIrJYHJklIvoT++uk/NYOocnMX+3S2iEQUSvgyCwRERERWSwms0RERERksVo8mRWRJ0UkTURKRCRBRPpfo343EdkpInoROSMic6TGAoQiMrCyrRIROSUiU+tqj4iIiIhuHi2azIrIWADvAZgHIArALwA2i4hfHfWdAXwP4DyAngBmAngOwLNV6gQA+K6yrSgA8wEsEpG45usJEREREd0IWnpk9lkAq5RSK5RSx5RSTwE4B2BaHfUfAKADMEkpdVgp9QWAvwF4tsro7FQAZ5VST1W2uQLAagCzmrcrRERERNTaWiyZFRFbAD0AbKuxaxuAvnUc1gfAT0opfZWyrQC8AfhXqVOzza0AYkTE5o/ETEREREQ3tpYcmfUAoIFxykBV5wF41XGMVx31Tfvqq2NdeU4iIiIiukm1xjqzqsa21FJ2rfo1yxtSx7hDZAqAKZWbRSJyop5z/+msbJnTeAC42OxnSX6t2U/REt76uLUjoNrcND8rN8nPCdCkPysdm6wlImp2LZnMXgRQgatHYdvi6pFVk6w66qPKMXXVKQeQU7NBpdQHAD5oWMjUHEQkXikV09pxEN3o+LNCRHRtLTbNQCl1BUACgCE1dg2BcSWC2uwB0F9E7GvUPwsgvUqdwbW0Ga+UKvsjMRMRERHRja2lVzNYCOBhEXlMRLqKyHsw3sy1HABEZL6I/FCl/joAxQBWiUi4iNwH4EUAC5VSpikEywH4isi7lW0+BuBhAO+0UJ+IiIiIqJW06JxZpdSnIuIO4GUA7QEcBjBCKZVRWaU9gKAq9fNFZAiAJQDiAeQBWABjUmyqkyYiIwD8A8Ylvs4CmFm5jBfdmDjNg6hh+LNCRHQN8v8DnERERERElqXFH2dLRERERNRUmMwSERERkcViMktEREREFovJLLUIEekkIu1aOw4iIiK6ufAGMGo2ItIWwIMAngGQDeODLM4B+BzAF0qpy60YHhEREd0EmMxSsxGRVQBCAXwD49PY3AFEAugK4DSAvyulvm+t+IhuJCLiDKBQ8ZcyEVGjMJmlZiEiAqAQxnWEd1Up6wAgFsDjMD7/fKxSKqm14iS6UYjIPwHsq3xlKKUKaqnjrpS66jHdRER/ZpwzS80lFEAagCumAmX0u1JqI4CRMCa7Y1spPqIbhoiMh/EPvAUAvgLwtojcKyJBIqKtrKMF8C8R6daKoRIR3XA4MkvNovIf3m8A6AA8BOCkUspQo85TAB5VSkW2fIRENw4RWQGgAsDfAdwHYBKMT0M8AeA7AD8A6AzgPaWUbWvFSUR0I+LILDULpZQewGwAWgAfA3hIRDqIiAMAiIgOwEAYH2lM9KclItYwfotxSSl1Sin1jlKqG4CeAHbCmNh+BmARgE9aL1IiohsTR2apWYlIOIBXANwN4DKAPTCubDAYxpUNHlNKHWq9CIlan4i4AminlDouIrYAyqreCCYiYwGsBxDNOeZERNUxmaUWUblM150ARgEogXFEdqNS6nhrxkV0oxIRKxh/R1eIyOMwTjHQtXZcREQ3Giaz1OJExKrm/FkiqpuIPAtAo5R6u7VjISK60TCZJSK6wYmIDYAK/hFIRHQ1JrNEREREZLG4mgERERERWSwms0RERERksZjMEhEREZHFYjJLRERERBaLySwRERERWSwms0RERERksf4P7t5hn4czKWQAAAAASUVORK5CYII=", + "text/plain": [ + "
" + ] + }, + "execution_count": 26, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram(counts_multiq_1, \n", + " legend=legend_multiq_1,\n", + " title=\"ibmq_manhattan\")" + ] + }, + { + "cell_type": "code", + "execution_count": 27, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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6+95t7YRERERERER3abWbrdCiNMAJINVHgCShBDXbi07AygC0AwVY0KJiIiIiIiIKqnLmM9NjV4LIiIiIiIiatJqDT4lSfrgXlSEiIiIiIiImq76znYLABBC9ATgh4ruuGclSdrXkJUiIiIiIiKipqVeweetyYW2AGgHIPXWaichRBSAZyRJSq0xMxEREREREf1r1Xe22wUAygF4SZLkKkmSK4DWt9YtaOjKERERERERUdNQ3263fQB0lyQpUbdCkqTLQoiXAexu0JoRERERERFRk1Hfls+aaBuoHCIiIiIiImqC6ht87gawQAjhqlshhGgJ4Guw5ZOIiIiIiIhqUN/g82UACgCXhRDJQogkAAm31r3cwHUjIiIiIiKiJqK+Yz4zAXQA0AOALwAB4JwkSX82dMWIiIiIiIio6ahz8CmEkAHIBRAkSdIuALsarVZERERERETUpNS5260kSeUAkgGYNl51iIiIiIiIqCmq75jP/wD4RAhh3xiVISIiIiIioqapvmM+3wDgAeCaEOIqgELDjZIktW2oihEREREREVHTUd/gcxMACRUTDRERERERERHVSZ2CTyGEAsDnAJ4GYIKKZ3q+JEnSzcarGhERERERETUVdR3z+QGAMQB+B7AeQG8ASxupTkRERERERNTE1LXb7SAAL0iStAEAhBBrAfwthJDdmgWXiIiIiIiIqEZ1bfl0BfCXbkGSpGMAygA4NUaliIiIiIiIqGmpa/ApA1BSZV0Z6j9hEREREREREf0L1TV4FADWCCGKDdaZA/hWCKHWrZAk6cmGrBwRERERERE1DXUNPr+vZt2ahqwIERERERERNV11Cj4lSXq+sStCRERERERETVddx3wSERERERER/WMMPomIiIiIiKjRMfgkIiIiIiKiRsfgk4iIiIiIiBodg08iIiIiIiJqdAw+iYiIiIiIqNEx+CQiIiIiIqJGx+CzjkaPHg0hBIQQ8Pb2vm37N998A5lMBiEE2rRpc9t2jUYDIyMjmJmZ6de1bNkSRkZGMDIygomJCXbs2NGo+0BERERERHS/MPisA41Ggx9++AFr165FZmYm4uPjsWjRokpp2rRpg3feeQfOzs7VltG+fXvI5fJK63bs2AGtVgutVgs/Pz8MGzas0faBiIiIiIjofmLwWQfvv/8+TExMMGLECNja2sLT0xNff/11pTRdu3bF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SRaWOTXsfGsP6/EmIiKiB8u9HvNJ91B1N4y65y7erQsXLsDIyAgqlQr79+9HcHBwg5TblNWnG/C9Ghds2Dque/THokWLKs2+qmsdX7ly5W35da1W7733XqX1AwYMgIeHB+Li4uDt7Y3HH38cqampDVbvhhg7WZPCwkKUlJTg/fffx4cffoj33nsPMpmsQcoG/vmMyPPnz8f8+fP1y4aPETrVemaD1a86D/PxJiIiogcHWz6bsMa6YVy1ahXUajWKioqgUqnQrVu3uy6T7o/Gah1PT0/H4sWLAQCLFy9u8Elk7nbsZE2MjY0xbNgwyGQyfZfzI0eO3HW5DzsebyIiImoIDD6bsMa6YezevTvkcjlMTU3x5ZdfIj8//67LpPujsbpTAtA/k1L3b0O6m7GTdxIUFIRffvkFAPQtvR07drzrch92PN5ERETUEBh8NmGNdcO4a9cu/d8ffvghzM3N77pMuj8asztlY7qbsZMAYGFhgaFDh0KSJAgh0LlzZwDAjh07kJWVBSMjI4wfPx4TJ05kF1DweBMREVHD4JjPJszwhhEAPD099TeMQMU4sz179qBXL/1jVSGEwLlz59CmTRtYWFhArVbr1z/yyCP4+++/8cwzz+jXm5iY4LfffrvHe0YNxd/fHzt37tQvN1TrOFDxI0WfPn0q/VjRkP7p2EmgYpxhdWxtbVFQUNBwlWxCeLyJiIjobjH4bOIa44aRN4tNx7vvvovPPvsMP/74I/r06YOEhITbxnz+E82bN8eUKVMQFxeHKVOmwNHRsQFq2/TVZ1KqGY1WCyIiIqLGweCT6F+ssVrHf/nlF3Tu3BlCCBgbG3MSGSIiIiJi8En0b9cYreMdOnRAaWlpw1WSiIiIiB56nHCIiIiIiIiIGh1bPv/F6jO+7NtXG6sWRA2vPtc2wOv7bvG7hIiIiOqCLZ9ERERERETU6Bh8EhERERERUaNjt1siqhG7rxIRERFRQ2HLJxERERERETU6Bp9ERERERETU6Bh8EhERERERUaNj8ElERERERESNjsEnERERERERNToGn0RERERERNToGHwSERERERFRo2PwSURERERERI2OwScRERERERE1OgafRERERERE1OgYfBIREREREVGjY/BJREREREREjY7BJxERERERETU6Bp9ERERERETU6Bh8EhERERERUaNj8ElERERERESN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", + "text/plain": [ + "
" + ] + }, + "execution_count": 27, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram(counts_multiq_2, \n", + " legend=legend_multiq_2,\n", + " title=\"ibmq_manhattan\")" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## GHZ to Bell State" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This example uses mid-circuit measurement to demonstrate how to convert GHZ states to Bell states. It also demonstrates how mid-circuit measurements alter the behavior of the quantum state.\n", + "\n", + "\n", + "Consider the canonical three-qubit GHZ gate: $\\frac{1}{\\sqrt{2}}\\left(|000\\rangle + |111\\rangle\\right)$. If one attempts to blindly measure one of the three qubits in the computational (z) basis, then the remaining two qubits are left in an unentangled state. However, by noting that a GHZ state can be written as (ignoring normalization constants):\n", + "$$\n", + "|000\\rangle + |111\\rangle = \\left[|00\\rangle + |11\\rangle\\right] \\otimes \\left(|0\\rangle+|1\\rangle\\right) + \\left[|00\\rangle - |11\\rangle\\right] \\otimes \\left(|0\\rangle-|1\\rangle\\right) = \\left[|00\\rangle + |11\\rangle\\right] \\otimes |+x\\rangle + \\left[|00\\rangle - |11\\rangle\\right] \\otimes |-x\\rangle,\n", + "$$\n", + "\n", + "we can see that if we make a measurement of any one of the three qubits in the x-basis, then the state of the two remaining qubits is in one of two possible Bell states; that is, the two remaining qubits are still maximally entangled. Given this, it is possible to use interference to transform these Bell states back into the computational basis. The circuit below does this, mapping $\\left[|00\\rangle + |11\\rangle\\right] \\rightarrow |00\\rangle$ and $\\left[|00\\rangle - |11\\rangle\\right] \\rightarrow |10\\rangle$. To explicitly show that measurement is done in the middle, we will flip the flag qubit used to record the result of the x-basis measurement and re-measure. We write the results to different classical bits so both can be displayed." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We use qubit `0` as the flag qubit in our example. For the first measurement, we expect a 50/50 distribution of `0` and `1` (on qubit `0`). For the second measurement, we expect a 50/50 distribution of `001` and `100` states (with little endian ordering)." + ] + }, + { + "cell_type": "code", + "execution_count": 28, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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", + "text/plain": [ + "
" + ] + }, + "execution_count": 28, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qc_ghz_bell = QuantumCircuit(3, 4)\n", + "qc_ghz_bell.h(2)\n", + "qc_ghz_bell.cx([2,1], [1,0])\n", + "qc_ghz_bell.barrier()\n", + "qc_ghz_bell.h(0)\n", + "qc_ghz_bell.measure(0, 0) # w/ h(0) gives meas in x basis\n", + "qc_ghz_bell.barrier()\n", + "qc_ghz_bell.cx(2, 1)\n", + "qc_ghz_bell.h(2)\n", + "qc_ghz_bell.x(0)\n", + "qc_ghz_bell.barrier()\n", + "qc_ghz_bell.measure([0, 1, 2], [1, 2, 3])\n", + "qc_ghz_bell.draw('mpl')" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "First, simulate to verify that we built the circuit correctly." + ] + }, + { + "cell_type": "code", + "execution_count": 29, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Sim meas 1 result: {'0': 508, '1': 516}\n", + "Sim meas 2 result: {'001': 508, '100': 516}\n" + ] + } + ], + "source": [ + "sim = Aer.get_backend('qasm_simulator')\n", + "sim_job_ghz_bell = execute(qc_ghz_bell, sim)\n", + "sim_counts_ghz_bell_1 = marginal_counts(sim_job_ghz_bell.result(), indices=[0]).get_counts()\n", + "sim_counts_ghz_bell_2 = marginal_counts(sim_job_ghz_bell.result(), indices=[1,2,3]).get_counts()\n", + "print(\"Sim meas 1 result: \", sim_counts_ghz_bell_1)\n", + "print(\"Sim meas 2 result: \", sim_counts_ghz_bell_2)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now we try on real hardware:" + ] + }, + { + "cell_type": "code", + "execution_count": 30, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "5ff748df743f6c44934b9c28\n", + "Job Status: job has successfully run \n" + ] + } + ], + "source": [ + "job_ghz_bell = execute(qc_ghz_bell, backend, initial_layout=[1,2,3])\n", + "print(job_ghz_bell.job_id())\n", + "job_monitor(job_ghz_bell)" + ] + }, + { + "cell_type": "code", + "execution_count": 31, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Meas 1 result: {'0': 561, '1': 463}\n", + "Meas 2 result: {'000': 155, '001': 201, '010': 23, '011': 41, '100': 156, '101': 379, '110': 30, '111': 39}\n" + ] + } + ], + "source": [ + "counts_ghz_bell_1 = marginal_counts(job_ghz_bell.result(), indices=[0]).get_counts()\n", + "counts_ghz_bell_2 = marginal_counts(job_ghz_bell.result(), indices=[1,2,3]).get_counts()\n", + "print(\"Meas 1 result: \", counts_ghz_bell_1)\n", + "print(\"Meas 2 result: \", counts_ghz_bell_2)" + ] + }, + { + "cell_type": "code", + "execution_count": 32, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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Ano7JBEREQk9Gzdu/A5Aw5RVQz1jIiIiIkGkZExEREQkiJSMiYiIiASRkjERERGRIFIyJiIiIhJESsZEpFJ99tlntG3bllatWvH4448fsX3mzJnUrl2bTp060alTJx566KFyt33qqacwM7ZvP6nX3xQJaZ999llcs2bNOlTFvu+8886UgQMHNq+KfVclJWMiUmny8/P5zW9+w6effsqKFSt45513WLFixRH1zjrrLJYsWcKSJUu4//77y9V2/fr1TJ8+nSZNmgTseERCwfPPP5/Ypk2b9rGxsZ3r1auXfu211zbJyso64j6Kzz//fKKZdf3rX/+aUHzbyJEjkxs1anRqjRo1OiclJXW88MILWxRuO+2009qaWde5c+fG+rfp169fSzPrOnXq1PiKxHv++efvW7t27bKKtKkKgwYNanbHHXekBDsO0DpjIlKJ5s+fT6tWrWjRwvs5PmTIEP75z3/Svn374277u9/9jieeeIKBAwdW3QGIlNOPbR/oWpX7b7nygUXlqTd69Oik8ePHJ7/88suZF1988d61a9dG3nLLLU3OPvvs1gsWLFjpf2/Kt99+O7F27dr5b731VuJNN920s7B83Lhxie+9917itGnTVqWlpeX89NNPEe+9914d//dp2rRpzmuvvZbYs2fPDQBbtmwJX7JkSVxCQkJeJR1yyMnLyyMionLSKPWMiUil2bhxI6mpqUWvGzduzMaNG4+oN3fuXNLT07ngggtYvnz5UdtOmTKFRo0akZ6eXsVHIBI6duzYEfbkk0+mjB079qfBgwfviY6Odm3bts2dMmXKmg0bNkT/5S9/qVtYd9WqVVELFiyIf/bZZ9fOmTOn9vr164uyiAULFtTs27fvnrS0tByAJk2a5N11112HzQUYPHhw1pQpU+rm5Xm512uvvVa3f//+OyMjI0u9wfW7775bu2XLlmk1a9bs3KBBg473339/EsDUqVPjk5KSOhbWa9So0an33XdfUmHv3hVXXNF0/fr1Eb17925ds2bNzmeccUabn3/+ObyktoXt//GPf5TYO3fBBRe0qFevXnp8fHynbt26tV24cGEMwFNPPVXvn//8Z90XX3wxuUaNGp3POeecVgCLFy+OOe2009rGx8d3atWqVdrbb79du3BfgwYNanbNNdc06dOnT6vY2NjOFe0RLIuSMSmXo83lKbRgwQLCw8N5//33i8qee+45OnToQFpaGs8+++xh9ceNG0fbtm1JS0vjj3/8Y1WFLwHi3JE/l83ssNddunRh3bp1ZGRkMHz4cC655JIy22ZnZ/PII48cNrdMRODLL7+My83NDbvuuut2+pfXrl27oG/fvrunT59eq7DslVdeSUxLS8u+/vrrd7Vo0eLAq6++mli47fTTT9/3wQcfJN53331Js2fPrlGYcPlLSUk51KpVqwMffvhhLYB33nmn3g033JBVVny333570wkTJqzbv3//t8uXL19+3nnnlbp6/5QpUxJmzJixasWKFcu++OKLOv3792/92GOPbdi+ffuSgoICHn/88QYVODVF+vfvv3v16tXfbdu2LaNjx47Z1157bQuAu+66a/vAgQN33HbbbVuys7O//fLLL3/IycmxSy65pNU555yz++eff8545plnfrrllltaZGRkRPvFWfdPf/rT5n379n173nnn7TuWmEqiZEyOqrzzgPLz87n77rvp379/UdmyZct45ZVXmD9/PhkZGUydOpXVq1cD8NVXX/HPf/6TpUuXsnz5cu66666AHZNUjcaNG7N+/fqi1xs2bCAl5fApGbVq1SIuLg6AAQMGcOjQIbZv315q2x9//JHMzEzS09Np1qwZGzZsoEuXLmzZsiUwByVSTW3bti2iTp06eZGRkUdsS05OPpSVlVXU+/Xee+8lXn755VkAgwYN2vHOO+8UJWPDhg3b8fjjj/80Y8aM2v37929br169Tvfee+8R95q85pprsv72t78lZmRkRO/duze8X79++8uKLyIiwn333XcxO3bsCKtfv35+r169skure+utt25LTU3Na968+aHu3bvv69y58/4zzzzzQGxsrLv44ot3ZWRk1CjnaTnMiBEjshISEgpiY2PdE088sWnlypWxJc2nA/jqq69qZmdnhz/yyCNbYmJi3C9/+cu955xzzq433nij6Fz169dv13nnnbc/PDycGjVqlNorWFFKxuSo/OfyREVFFc3lKW7cuHEMGjSIBg3+9wfM999/z+mnn06NGjWIiIigT58+fPTRRwC8+OKLjBw5kuho748O/3YSmrp3787q1avJzMwkNzeXyZMn88tf/vKwOlu2bCnqBZs/fz4FBQUkJiaW2vbUU09l27ZtrF27lrVr19K4cWMWL15McrLuSywntwYNGuTt2rUr4tChQ0ds27JlS2RiYmIewLRp02pu3Lgx+vrrr98BcMMNN+xYvXp17DfffFM0If+2227b8c0336zatWvXkmeeeWbdk08+mfLBBx/U8t/nr371q13ffPNNraeffjqpMLEry+TJk3/87LPPajdr1qxj9+7d237xxRc1S6vbsGHDooOIiYkpSEpKKuqei42NLcjOzi4xgSpLXl4ew4YNa5SamtohLi6uc/PmzU8F2LJlS4kTvdavXx+ZnJycGx7+v7dKTU3N3bRpU1G227hx4yNPdiVQMiZHVZ55QBs3buSjjz7i1ltvPay8Q4cOzJ49m6ysLLKzs/nkk0+Kej9WrVrF119/TY8ePejTpw8LFiyo+oORKhUREcH48ePp378/p5xyCldccQVpaWm89NJLvPTSSwC8//77dOjQgfT0dO644w4mT56MmZXaVkRKdvbZZ++PjIwseOONNw67OnLPnj1hM2fOrN27d++9AK+//no95xxdunRJq1evXvoZZ5xxCsBrr72WWHyf0dHR7sYbb9zZtm3bA0uXLj3s6sn4+PiCvn377n777bfr33TTTUdNxvr06ZM9Y8aMH3/++eeMiy66aOe1117b8viOGOLj4/MPHjxYlLvk5eWxY8eOEpOrl19+ue5nn31WZ/r06av27NnzbWZm5nfwvykRxadQpKamHtqyZUtUfn5+Udn69eujUlJSihIwM6u03jB/uppSjqo884BGjBjB2LFj8f+LAuCUU07h7rvv5txzzyUuLo709PSiq0/y8vLYuXMn//nPf1iwYAFXXHEFa9asOWLfEloGDBjAgAEDDivzT9Jvv/12br/99nK3LW7t2rXHHaPIiSAxMTH/97///aa77767SZ06dfL9r6ZMSEjIu+WWW3ZkZ2fb1KlTE5566ql1gwYN2lXY9u2330546qmnUl588cUNL774YmKDBg3y+vfvv7dWrVoFH3zwQa0ffvgh9owzzjhiGPLpp5/eeMstt2xv27ZtblmxHTx40F5//fWEK664YndiYmJ+rVq1CsLDw487kenQoUNObm6uTZ48ufall1665957700+dOhQiR1Le/fuDY+KinINGjTI27dvX9iIESMa+W9v0KDBoczMzKL5YH379t0fGxubf9999yWPHj166/Tp0+O+/PLLOg899ND3xxv30ahnTI6qPPOAFi5cyJAhQ2jWrBnvv/8+w4YN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", + "text/plain": [ + "
" + ] + }, + "execution_count": 32, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram([counts_ghz_bell_2, sim_counts_ghz_bell_2], \n", + " legend=['ibmq_manhattan', 'QASM simulator'],\n", + " title='X-basis measurement of GHZ state')" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Now let's see what happens if we do the first measurement in the computational basis rather than the x basis, destroying the entanglement. Given that the state after the measurement is no longer a Bell pair, we would expect our transformation back to the computational basis to yield a different result." + ] + }, + { + "cell_type": "code", + "execution_count": 33, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAnEAAADWCAYAAAC+C9RHAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8vihELAAAACXBIWXMAAAsTAAALEwEAmpwYAAAsaElEQVR4nO3deVxU9f4/8NcMqIiYiqQii4SgArIoSJoFmFpmWd7ErfR309yQFpdKb14zu7nkde+q5W6WXgXKum7ptwQtvSoq5gKCueAuuCHKIjPz+2MuKApzBpyZzzlzXs/Hw4fMmXM+583n8TnDa86qMRgMBhARERGRomhFF0BEREREVccQR0RERKRADHFERERECsQQR0RERKRADHFERERECsQQR0RERKRADHFERERECsQQR0RERKRADHFERERECsQQR0RERKRADHFERERECsQQR0RERKRADHFERERECsQQR0RERKRADHFERERECsQQR0RERKRADHFERERECsQQR0RERKRADHFERERECuQougAie5aRkWHy/X/961945513TM7TqlUrS5Zkl6T6GWBfqx3HCNkj7okjEmjBggWiS1AN9jVJ4RghpWGIIyIiIlIghjgiIiIiBWKIIxIoMTFRdAmqwb4mKRwjpDQMcUREREQKxBBHJFBsbKzoElSDfU1SOEZIaXiLESIVGjVqFNLS0oSsOywsDHPnzhWybhHGnjiOw7dvC1l3aN26mNUyUMi6yTzcFulxMMQRqVBaWhpSUlJEl6EKh2/fxs4b10WXQTLFbZEeBw+nEgkUHx8vugTVYF+TFI4RUhqGOCKBpO4OT5bDviYpHCOkNAxxpHh3i4ArecDVPKDwnuhqqiYqKkp0CarBviYpHCOkNDwnjhTHYADO5AK7s4A/rwLX79x/TwPArS7QognQ0R9o2kBYmWbJyckRXYJqsK9JCscIKQ1DHCnKlVvAv/8LnM6t+H0DgJzbxn+/ZwFBHkDvSKC+s03LJCIisjqGOFKM/54EEvcDJXrzlzl2ATi1ERjYEQj0sF5t1RUYyNs/2Ar7mqRwjJDS8Jw4UoTfM4F/761agCtVcA9YmgIcPW/5uh5XUlKS6BKsqkaNGqJLKGPvfU2Pz57HiJy2RbIchjiSvTO5xj1wpsx90/ivMnoDsPp34Fq+ZWt7XJ988onoEszSoUMHfPDBB1izZg22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RIN6dQVWRKROjZ90xYvR988ha9u6BVq3fEpgRdI0Gg1e7/Zc2TlkNUu/BGrlHUN8vdzxXOT9oBn9dKjkOX62JO/ek3DgwAG0b98e6enpmDlzJjZv3ozx48fj8uXLVlnf7oPHcLewCF06hlulfSI5M34IR6GOsxOCWvigbWt/0SURqVbHiGD4ejdF/Sdc8GqXZ0SXYxYX59p4/aUoAECPzh3gWl8ZFwu+8Fw7NHnSFe6NGqLLs/L6+6/oc+JiYmKQkZGBzMzMKl85Ov6LxVaqioiIiKh6po8bZva8it0Td/fuXezatQv9+vXjrT+IiIhIdRxFF1BdN27cgF6vh4eHR7WWr0rSLSoqxhdfrYVX00YY1Pulaq2PiIiIyJIUG+IaNGgArVaLCxcuVGv56hxOPXHqHA/DEhERkdWo4nCqs7MzoqKi8O9//5uPwyIiIiLVUfSFDQcOHEBUVBSaNWuGjz76CM2aNUN2djZ27dqFpUuXWmQdO/Ycws879yN+YE94NW1kkTaJiIiIHpdiD6cCQHh4OPbs2YOJEydi9OjRKCwshJeXF/r162eR9ouKirFr3x9o6evFAEdERESyoug9cdZ26eo1fLthO/q98jxDHBEREckKQ5wEvV4v+ztKExERkfowxBEREREpEHcxERERESkQQxwRERGRAjHEERERESkQQxwRERGRAjHEERERESkQQxwRERGRAjHEERERESkQQxwRERGRAjHEERERESkQQxwRERGRAjHEERERESkQQxwRERGRAjHEERERESkQQxwRERGRAjHEERERESkQQxwRERGRAjHEERERESkQQxwRERGRAjHEERERESkQQxwRERGRAjHEERERESkQQxwRERGRAjHEERERESkQQxwRERGRAjHEERERESkQQxwRERGRAjHEERERESnQ/wcpK4N9FrOOFwAAAABJRU5ErkJggg==", + "text/plain": [ + "
" + ] + }, + "execution_count": 33, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "qc_ghz2 = QuantumCircuit(3, 4)\n", + "qc_ghz2.h(2)\n", + "qc_ghz2.cx([2,1], [1,0])\n", + "qc_ghz2.barrier()\n", + "qc_ghz2.measure(0, 0) # measure in z, not x basis\n", + "qc_ghz2.barrier()\n", + "qc_ghz2.cx(2, 1)\n", + "qc_ghz2.h(2)\n", + "qc_ghz2.x(0)\n", + "qc_ghz2.barrier()\n", + "qc_ghz2.measure([0, 1, 2], [1, 2, 3])\n", + "qc_ghz2.draw('mpl')" + ] + }, + { + "cell_type": "code", + "execution_count": 34, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Sim meas result: {'000': 262, '001': 260, '100': 254, '101': 248}\n" + ] + } + ], + "source": [ + "sim_job_ghz2 = execute(qc_ghz2, sim)\n", + "sim_counts_ghz2 = marginal_counts(sim_job_ghz2.result(), indices=[1,2,3]).get_counts()\n", + "print(\"Sim meas result: \", sim_counts_ghz2)" + ] + }, + { + "cell_type": "code", + "execution_count": 35, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "5ff749435870e1502ea292cc\n", + "Job Status: job has successfully run \n" + ] + } + ], + "source": [ + "job_ghz2 = execute(qc_ghz2, backend, initial_layout=[1,2,3])\n", + "print(job_ghz2.job_id())\n", + "job_monitor(job_ghz2)" + ] + }, + { + "cell_type": "code", + "execution_count": 36, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Meas result: {'000': 190, '001': 277, '010': 48, '011': 17, '100': 175, '101': 256, '110': 45, '111': 16}\n" + ] + } + ], + "source": [ + "counts_ghz2 = marginal_counts(job_ghz2.result(), indices=[1,2,3]).get_counts()\n", + "print(\"Meas result: \", counts_ghz2)" + ] + }, + { + "cell_type": "code", + "execution_count": 37, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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Vq2KGTBgwOG1atXqcfTRR3f4+eef88dQGzduXP2mTZseUa9eve433XRT4/DXKc7111/f9JRTTmk7ZMiQNrVq1erRoUOHLgsXLoy75ZZbGtevXz+1cePG3f71r3/VySv/6KOPJrdt2zalVq1aPZo3b37EAw88kF8zNXny5NqNGjXqNmbMmEb169dPPeyww7o9+uijyeGvt2XLlpiBAwe2r1WrVo9u3bp1WrRoUVzesssvv7xF48aNuyUmJvZISUnp/MEHHyQCvPnmm3Uef/zxxu+++25SzZo1e3Ts2LHLyJEjm82dOzfxlltuaVmzZs0ew4YNa1nSNvL29dRTT2171llnta5Vq1aP9u3bp8ycObPm/ryHUMnJmLu/DowiGBNsPsEAeqe6e96YLk2AdmGrZBMMefEVsBAYQzAI7OVhZa4hqCl7BPgp7PGvitkLERGRquejjz6qd+65527ZvHnz/HPPPXfzueee2z4zMzP/yoNJkyYlffzxx98vXrz4248++qje4MGDD7/nnntWb9y4cX5ubi733ntvQ4C5c+fG//GPf2z13HPPpf30008LNm3aFLN+/foapYlh2rRp9YYNG7Zp69atX6ekpOw65ZRTOuTm5vLTTz8t/OMf/7h25MiRrfLKNmrUKPs///nPDzt27Pj6H//4R9ptt93W4rPPPstPaDZt2hS7bdu26J9++mnhE088seLmm29uGZ4wTpo0qf6YMWPWbt269evWrVtn3nTTTc3ylvXp02fn/PnzF23ZsuXrc889d/Mll1zSbteuXXbuueduHzly5LrTTjtty65du75esmTJ4scff3xNr1690u+5556Vu3bt+vqll15aWdI28l7j448/rnfhhRdu2bZt29eDBw/eOnLkyJb7+95V+u2Q3P3v7t7a3ePcvZe7zwxbNtzdW4dNv+buPd29trsnunuKu9/t7hlhZQa6uxXxGFi5eyYiIhI5KSkpuy6//PItcXFxPmbMmPVZWVn2ySef1Mpbfs0112xo0aJFdps2bfb06dMnvUePHjuPOeaYjISEBD/jjDO2LliwoCbAa6+9lnTCCSdsO+WUU9ITEhJ87Nixa82sVFf79erVa8c555yzPTY2lvPOO2/Lli1bYu666651cXFxfsUVV2xeu3ZtjY0bN0YDXHjhhdtSUlIyo6KiOO2009KPOeaY7Z988kl+7VNMTIw/8MADa+Pi4vyCCy7YlpCQkLtw4cL4vOUnn3zyluOPP35XbGwsF1988eZFixbl1wSOGDFic+PGjXNiY2O544471mdlZdmCBQviKYN9baNXr17pF1xwwbaYmBiuuOKKTUuWLKkeNWMiIiJSMZo2bZp/q53o6GgaNWq0Z9WqVbF585o0aZI/Vlp8fHxuo0aNsvOmExIScnft2hUNsHbt2thmzZrlb6tOnTq59erVyy9bksMOOyy/XM2aNXOTkpKyY2KC7umJiYm5ANu2bYsCeOONN+qkpqZ2qlu3bvfatWt3nzFjRt2NGzfm92WvW7dudmxsfvgkJCTk7tixIz9vadSoUf7+1KpVKz9+gDFjxjRq27ZtSu3atbvXrl27e3p6evSGDRvK1E9+X9s47LDD8l8/MTExNzMz0/bs2b/h6JSMiYiIHATWrl2b35SYk5PD+vXrY1u0aFHm7KBJkyZ71qxZk7+tHTt2RG3durVcL/jLyMiwyy67rN2oUaPWb9iwYcGOHTvmH3fccdvKY7itDz74IPHxxx9vPHHixGVbt26dv2PHjvmJiYk5edsuqpav8Lx9baO8KRkTERE5CCxatKjmiy++WG/Pnj387W9/a1SjRg0//vjjd5Z1OxdddNGWadOm1f3www8Td+/ebTfccENTdy/XUW93795tWVlZUQ0bNtwTGxvrb7zxRp3PP/+8zr7X3Ldt27ZFx8TEeOPGjffs2bPHbrzxxiY7d+7MrzVr1KhR9urVq2vk5OTkr3PYYYdlL1u2LK602yhvSsZEREQOAoMGDdr6xhtv1K9Xr16P119/Pfn111//MS4ursxVOb1799593333rRw+fHibxo0bpyYlJWU3atQoa99rll5SUlLunXfeuXLYsGHt6tat233ChAnJv/rVr7aVx7bPOeecbQMHDtzWpUuXI1q0aHFEfHx8buPGjfPjHzZs2OZQDN27dOnSGWDUqFHrJ0+enFSnTp3uw4cPb7GvbZS3ShuBvyrSCPwiIlJYdRqBv7I0a9bsiHHjxi3/9a9/rQFm91NVGYFfRERERApRMiYiIiKlMmDAgMNr1qzZo/Dj5ptvLnyrQymDSrsdkoiIiFRPa9as+QZAzZQVQzVjIiIiIhGkZExEREQkgpSMiYiIiESQkjERERGRCFIyJiIiIhJBSsYOEXfeeSc1atQgNjaWk08+ea/lI0aMICEhgYSEBGrXrs0bb7wBwPvvv58/PyEhATPjrLPOAuD6668nPj4eM+Oll16q1P0REZHq6YMPPkhs3bp114rY9vXXX990yJAhbSpi2xVJydghICsrizvuuIMpU6awZcsWZsyYwaRJkwqUSU1NZfHixWRkZPDHP/6RK664AoBTTjmFjIwMMjIy2LZtG1FRUdx4440AnHDCCbz99tvUrVu30vdJREQCjz32WHKHDh26JCQk9GjQoEHqJZdc0nLTpk173UfxscceSzazXs8++2xS4WU333xz42bNmh1Rs2bNHo0aNep22mmntc1bduSRR3Y0s16zZs1KCF9n0KBB7cys1+TJk2uXJd6TTz45ffny5d+WZZ2KcM4557T+/e9/3zTScYDGGTskjB8/nrp16zJw4EAABgwYwLhx4zjzzDPzy1x99dX5zy+99FLuuOOOvbbz0EMPUatWLY455hgATj/99IoNXESkivqx4+29KnL77ZbcPrc05caMGdPoiSeeaPyPf/wj7YwzztixfPny2Kuuuqrl8ccff/hXX321JPzelK+++mpy3bp1c1555ZXkK6+8ckve/Mcffzz5jTfeSJ4yZcr3KSkpmStXrox544036oW/TqtWrTKff/755H79+q0GWLduXfT8+fMTk5KSsstpl6ud7OxsYmLKJ41SzdghYMmSJSQnJ+dPt2nThp9++qnY8iNHjqR9+/Z7zX/hhRcYPHhwhcQoIiJls3nz5qgHHnig6X333bfy3HPP3R4XF+cdO3bMmjRp0rLVq1fHPf300/Xzyn7//fc1vvrqq9qPPPLI8s8++6zuqlWr8rOIr776qtbAgQO3p6SkZAK0bNky+8YbbyxwL85zzz1306RJk+pnZwe51/PPP19/8ODBW2JjY4u9wfXrr79et127dim1atXq0bBhw2633XZbI4DJkyfXbtSoUbe8cs2aNTvi1ltvbZRXu3f++ee3WrVqVcyAAQMOr1WrVo+jjz66w88//xxd1Lp56//73/8usnbulFNOadugQYPU2rVrd+/du3fHOXPmxAM8+OCDDd555536Tz75ZOOaNWv2OOGEE9oDzJs3L/7II4/sWLt27e7t27dPefXVV/Obfs4555zWF198ccvjjjuufUJCQo+y1giWRMnYIaAsN4MfO3YsU6dOZfLkyQXmp6en88MPPzBmzJjyDk9ERPbDtGnTErOysqIuu+yyLeHz69atmztw4MBtU6dOrZM375lnnklOSUnZNXz48K1t27bNeO655/J/oR911FHpb731VvKtt97aaObMmTXzEq5wTZs23dO+ffuMf/3rX3UAXnvttQaXX375ppLiu+6661qNGzduxc6dO79etGjRopNOOqnY0fsnTZqU9PHHH3+/ePHibz/66KN6gwcPPvyee+5ZvXHjxvm5ubnce++9DctwaPINHjx429KlS7/ZsGHDgm7duu265JJL2gLceOONG4cMGbL52muvXbdr166vp02b9kNmZqb9+te/bn/CCSds+/nnnxeMHTt25VVXXdV2wYIFcWFx1v/LX/7yU3p6+tcnnXRS+v7EVBQlY4eATp06sWnTL5+ZtLQ0mjRpsle5N998k5tuuolJkyZx+OGHF1h29913k5SURNeuFdLnUkREymjDhg0x9erVy46Njd1rWePGjfds2rQpv/brjTfeSD7vvPM2AZxzzjmbX3vttfxkbMSIEZvvvffelR9//HHdwYMHd2zQoEH3P//5z3vda/Liiy/e9PLLLycvWLAgbseOHdGDBg3aWVJ8MTEx/s0338Rv3rw56rDDDsvp37//ruLKXnPNNRtatGiR3aZNmz19+vRJ79Gjx85jjjkmIyEhwc8444ytCxYsqFnKw1LAqFGjNiUlJeUmJCT4/fffv3bJkiUJRfWnA/jkk09q7dq1K/quu+5aFx8f72eeeeaOE044YeuLL76Yf6wGDRq09aSTTtoZHR1NzZo1S1/TsQ9Kxg4Bw4YNY9u2bcycOZP09HRmzpzJiBEjCpSZNWsWF110EU888USRTZGvvPIKQ4YMqayQRURkHxo2bJi9devWmD179uy1bN26dbHJycnZAFOmTKm1Zs2auOHDh28GuPzyyzcvXbo04YsvvsjvkH/ttddu/uKLL77funXr/LFjx6544IEHmr711lt1wrd56aWXbv3iiy/qPPTQQ43yEruSTJw48ccPPvigbuvWrbv16dOn40cffVSruLJNmjTJ34n4+PjcRo0a5VfPJSQk5O7atavIBKok2dnZjBgxolmLFi26JiYm9mjTps0RAOvWrSuyo9eqVatiGzdunBUd/ctLtWjRImvt2rX52W7z5s33PtjlQMnYISA+Pp7Ro0czaNAgkpKS6N+/P0OGDGHo0KEMHToUgOHDh5OTk8OoUaNISEigVq1fPjMbN25k9erV3H777QW2e9NNNxEdHc22bdsYPnw4DRo0qMzdEhE5pB1//PE7Y2Njc1988cUCV0du3749avr06XUHDBiwA+CFF15o4O707NkzpUGDBqlHH310Z4Dnn38+ufA24+Li/IorrtjSsWPHjIULFxa4erJ27dq5AwcO3Pbqq68eduWVV+4zGTvuuON2ffzxxz/+/PPPC04//fQtl1xySbsD22OoXbt2zu7du/Nzl+zsbDZv3lxkcvWPf/yj/gcffFBv6tSp32/fvv3rtLS0b+CXrjtmVqB8ixYt9qxbt65GTk5O/rxVq1bVaNq0aX4CZmblVhsWTsnYIWLMmDFkZWWxZ88epk6dCsCECROYMGECEHTyz83NzR/GYufOX2qfGzRoQG5uLi1btiywzfvuu4+cnBzcndzcXDZuLNDfU0REKlBycnLODTfcsPamm25q+eabb9bJzMy0JUuW1DjjjDPaJiUlZV911VWbd+3aZZMnT0568MEHV8ybN29R3uOuu+5a+fbbbyfv2bOHxx57LHnixIl1t2zZEpWTk8Mbb7xR54cffkg4+uij92qGfOihh9a89957Szp27JhVUmy7d++2J598sv6mTZui4+LivE6dOrnR0dEHnMh07do1MysryyZOnFg3MzPTbrrppiZ79uwpMpfZsWNHdI0aNbxhw4bZ6enpUaNGjWoWvrxhw4Z70tLS8vuDDRw4cGdCQkLOrbfe2jgzM9MmT55ce9q0afUuvfTSzQca974oGRMREamm7rzzzvWjR49ec8stt7SoU6dOj06dOh2RkZER/fHHH39fp06d3FdeeaVefHx87ogRIza1bNkyO+/xhz/8YWNubi5vvvlm3bp16+bcf//9TVq1atWtbt26PUaPHt38/vvvXzF48OC9Oqi3bt16T1HzizJhwoTkNm3aHJGYmNjjueeeO+z5559PO9D9TU5OzrnvvvtWjhw5slWTJk261apVK7dRo0ZFJobXXnvtpmbNmmW2aNEitVOnTilHHXXUzkLLNy5dujShdu3a3QcNGtQuPj7e33777R+mTp1at0GDBql/+MMfWj755JNpPXr02H2gce+LleVKu4NN7969fc6cOZEOQ0REqhAzm+vuvfOmFyxYsDw1NbVaVP0/8sgjyffee2+zTz/99H+HH354ibVXUrkWLFjQIDU1tXVRyzToq4iIyEFi1KhRm2JjY/2TTz6ppWSs+lAyJiIichD53e9+V+F9nKR8qc9YJfrggw/o2LEj7du35957791r+auvvkq3bt3o1q0bRx99NAsWLMhf1rp1a4444gi6d+9O7969C6z3+OOP07FjR1JSUvjTn/5U4fshIiIi5Uc1Y5UkJyeH3/3ud0ydOpXmzZvTp08fzjzzTLp06ZJfpk2bNsyYMYOkpCTef/99rrrqKmbPnp2//JNPPtlr+IhPPvmEd955h4ULFxIXF8eGDRsqbZ9ERETkwKlmrJJ8+eWXtG/fnrZt21KjRg0uvPBC3nnnnQJljj76aJKSguFijjrqKFavXr3P7T755JPcfPPNxMUFV+c2bLhfd4zYp4qq1QN48MEHMTMNjSEiVZUfyhe7yYELnT+5xS1XMlZJ1qxZQ4sWLfKnmzdvzpo1a4ot/9xzz3HKKafkT5sZJ510Er169eLpp5/On//999/z6aef0rdvX4477ji++uqrco89r1bv/fffZ/Hixbz22mssXry4QJm8Wr2FCxdy6623ctVVVxVY/sknnzB//nwKX726atUqpk6dutcYZiIiVYWZbcvKytr7nkMipZSVlRVrZtuKW65krJIU9auq8Oi/eT755BOee+457rvvvvx5n3/+OfPmzeP9999n3LhxzJw5EwhGH96yZQv//e9/eeCBBzj//PPLdGPw0qioWj2A//u//+P+++8v9liIiERaTk7OC2vXrq2Vm5urLyops9zcXFu7dm1iTk7O+OLKqM9YJWnevDmrVq3Kn169ejVNmzbdq9zChQu58soref/990lO/uVOFXllGzZsyFlnncWXX37JgAEDaN68OWeffTZmxpFHHklUVBQbN27ksMMOK7fYi6rVC+/LVlhxtXpmxtVXX51fazZp0iSaNWtGampqucUqh7Y777yTv/71r7g7v/rVr/jggw8KLB8xYgQvvPACADExMTz33HOcf/75+dMxMTGYGVFRUfl3ofjxxx858sgj2bFjB7Vr12bOnDm0adOmcndMIio3N/fJ7du39/zmm2/6A2W+R6Ic8nKAz3Jzc58stoS7H7KPXr16eWXZs2ePt2nTxpctW+aZmZnerVs3//bbbwuUWbFihbdr184///zzAvPT09N9+/bt+c/79evn77//vru7P/nkk37rrbe6u/uSJUu8efPmnpubW66xv/HGG/6b3/wmf/qll17y6667rsiy06ZN806dOvnGjRvz561Zs8bd3devX+/dunXzGTNm+M6dO/3II4/0rVu3urt7q1at/Oeffy7XuOXQkpmZ6TExMf7JJ5/4jh07PD4+3t95550CZZ566ilftmyZu7vfcccdXqtWrfxl0dHR/r///W+v7fbp08cHDx7s7u6DBw/2I488sgL3QqoCYI5Xgf9Rehw6DzVTVpKYmBieeOIJBg8eTOfOnTn//PNJSUnhqaee4qmnngLgr3/9K5s2bWLEiBEFOruvX7+e/v37k5qaypFHHslpp53GySefDMAVV1zBsmXL6Nq1KxdeeCEvvvhiuTf5lbVW75133tlnrd6PP/5IWloaqamptG7dmtWrV9OzZ0/WrVtXrrFL5TuQiz0g6KPYo0cPTj/99Px58+fP56ijjsr/XHz55Zd7bXf8+PHUrVuXgQMHkpiYyIABAxg3blyBMldffXV+rdall15KRkbGPvdn/vz5+ftx77338vXXX+/7IIiIlIFuh3QI3w7pt4+UrlxuTjb/vLsDp474mJp1m/HOw304/pIJvHlfSn6ZlStXcsIJJ/DSSy9x9NFH58/fuXMnubm51K5dm507d3LiiSdy22235SeTeVq3bs2cOXP2GrpDqpecnBw6dOhQYAiX1157rcAQLl988QWdO3fOH8Ll9ttvL9DsPXbsWObMmcP27duZPHkyACeddBL/93//xymnnMJ7773H/fffz/Tp0wu89g033MDkyZNZsmQJANdccw1ffPEFCxcuLDLW008/naVLl+aXj42NJTY26KN99tln88orrwBBM3v492RUVBS5ucVeFCUHgcK3QxKpaKoZk32Kio7h6HOe4P1/DObNezvTpvv5JDU58Fo9Ofgc6MUeq1ev5t133+XKK68ssI6ZsX37dgC2bdtWZM1sWX5Yjh07lqlTp+YnewCzZ89m165dfPXVV7z11ls8/vjjpd6eiMiBUAd+KZUWXU6lRZdTC8y75ppr8p8/++yzPPvss3ut17Zt272aoYqyfPnyA45RIu9AL/YYNWoU999/Pzt27ChQ7pFHHmHw4MHceOON5Obm8sUXX+y1rU6dOvHSSy/lT6elpdGkSZO9yr355pvcdNNNTJ48mcMPPzx/fs+ePQFISUmhb9++fPjhh4wcOZLY2Fjm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", + "text/plain": [ + "
" + ] + }, + "execution_count": 37, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "plot_histogram([counts_ghz2, sim_counts_ghz2], \n", + " legend=['ibmq_manhattan', 'QASM simulator'],\n", + " title='Computational (z) basis measurement of GHZ state')" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "%qiskit_copyright" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.11.1" + }, + "title": "Mid-circuit measurement", + "description": "Mid-circuit measurement" + }, + "nbformat": 4, + "nbformat_minor": 2 +} From 2ad33dbe58e301fc3a85e51d69befb51c1c38d51 Mon Sep 17 00:00:00 2001 From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com> Date: Wed, 4 Oct 2023 12:33:32 -0400 Subject: [PATCH 8/9] Migrate Runtime content from closed source Co-authored-by: Jessie Yu Co-authored-by: Kevin Tian Co-authored-by: Rebecca Dimock <66339736+beckykd@users.noreply.github.com> Co-authored-by: Abby Cross --- docs/build/primitive-options.mdx | 63 ++++ docs/optimize/algorithm-tuning-options.mdx | 133 +++++++++ docs/optimize/error-mitigation.mdx | 306 ++++++++++++++++++++ docs/optimize/error-suppression.mdx | 123 ++++++++ docs/run/account-management.mdx | 93 ++++++ docs/run/cost.mdx | 81 ++++++ docs/run/max-execution-time.mdx | 85 ++++++ docs/run/monitor.mdx | 46 +++ docs/run/run-sessions.mdx | 213 ++++++++++++++ docs/run/sessions.mdx | 165 +++++++++++ docs/test/noise.mdx | 318 +++++++++++++++++++++ 11 files changed, 1626 insertions(+) create mode 100644 docs/build/primitive-options.mdx create mode 100644 docs/optimize/algorithm-tuning-options.mdx create mode 100644 docs/optimize/error-mitigation.mdx create mode 100644 docs/optimize/error-suppression.mdx create mode 100644 docs/run/account-management.mdx create mode 100644 docs/run/cost.mdx create mode 100644 docs/run/max-execution-time.mdx create mode 100644 docs/run/monitor.mdx create mode 100644 docs/run/run-sessions.mdx create mode 100644 docs/run/sessions.mdx create mode 100644 docs/test/noise.mdx diff --git a/docs/build/primitive-options.mdx b/docs/build/primitive-options.mdx new file mode 100644 index 0000000000..1ebecf2088 --- /dev/null +++ b/docs/build/primitive-options.mdx @@ -0,0 +1,63 @@ +--- +title: Specifying advanced runtime options +description: Specify options when building with primitives + +--- + +# Specify advanced runtime options + +When calling the primitives, you can pass in options by using the `Options` class or when using the `run` method. In the `Options` class, commonly used options, such as `resilience_level`, are at the first level. Other options are grouped into different categories: + +![options](/images/build/options.png) + +You can use the [Options](../api/qiskit-ibm-runtime/qiskit_ibm_runtime.options.Options) class to specify different options. + +In the example below, we create an instance of the `Options` class. `optimization_level` is a first level option and can be passed as an input parameter. Options related to the execution environment are passed using the `environment` parameter. + +```python +from qiskit_ibm_runtime import Options + +options = Options(optimization_level=3, environment={"log_level": "INFO"}) +``` + +The `Options` class supports auto-complete. Once you create an instance of the `Options` class, you can use auto-complete to see what options are available. If you choose one of the categories, you can use auto-complete again to see what options are available under that category. + +```python +from qiskit_ibm_runtime import Options + +options = Options() +options.resilience_level = 1 +options.execution.shots = 2048 +``` +## Pass options to a primitive + +### Options class + +When creating an instance of the `Estimator` or `Sampler` class, you can pass in the `options` you just created. Those options will then be applied when you use `run()` to perform the calculation. Example: + + +```python +estimator = Estimator(session=backend, options=options) +result = estimator.run(circuit, observable).result() +print(f">>> Metadata: {result.metadata[0]}") +``` +### Run() method + +You can pass in options by using the `run()` method. This overwrites the options you specified when creating the `Estimator` or `Sampler` instance for that particular execution. + +Because most users will only overwrite a few options at the job level, it is not necessary to specify the category the options are in. The code below, for example, specifies `shots=1024` instead of `execution={"shots": 1024}` (which is also valid). + +```python +estimator = Estimator(session=backend, options=options) +result = estimator.run(circuit, observable, shots=1024).result() +print(f">>> Metadata: {result.metadata[0]}") +``` + +## Next steps + + + - Find more details about the ``Estimator`` methods in the [Estimator API reference](../api/qiskit-ibm-runtime/qiskit_ibm_runtime.Estimator#estimator). + - Find more details about the ``Sampler`` methods in the [Sampler API reference](../api/qiskit-ibm-runtime/qiskit_ibm_runtime.Sampler#sampler). + - Find all available options in the [Options API reference](../api/qiskit-ibm-runtime/qiskit_ibm_runtime.options.Options). + - Find details about specifying error suppression and mitigation options in the [Optimize](../optimize/) section. + \ No newline at end of file diff --git a/docs/optimize/algorithm-tuning-options.mdx b/docs/optimize/algorithm-tuning-options.mdx new file mode 100644 index 0000000000..47a130dc42 --- /dev/null +++ b/docs/optimize/algorithm-tuning-options.mdx @@ -0,0 +1,133 @@ +--- +title: Algorithm tuning options +description: Common settings to use when tuning primitive options + +--- + + +# Algorithm tuning options + + +One of the advantages of the primitives is that they abstract away the circuit execution setup so that algorithm developers +can focus on the pure algorithmic components. However, sometimes, to get the most out of an algorithm, you might want +to tune certain primitive options. This section describes some of the common settings you might need. + + + + This section focuses on Qiskit Runtime primitive `Options` (imported from ``qiskit_ibm_runtime``). While + most of the `primitives` interface is common across implementations, most `Options` are not. Consult the + corresponding API references for information about the ``qiskit.primitives`` and ``qiskit_aer.primitives`` options. + + +## 1. Shots + + +For some algorithms, setting a specific number of shots is a core part of their routines. Previously, shots could be set during the call to `backend.run()`. For example, ``backend.run(shots=1024)``. Now, that setting is part of the execution +options ("second level option"). This can be done during the primitive setup: + +```python +from qiskit_ibm_runtime import Estimator, Options + +options = Options() +options.execution.shots = 1024 + +estimator = Estimator(session=session, options=options) +``` + +If you need to modify the number of shots set between iterations (primitive calls), you can set the +shots directly in the ``run()`` method. This overwrites the initial ``shots`` setting. + +```python +from qiskit_ibm_runtime import Estimator + +estimator = Estimator(session=session) + +estimator.run(circuits=circuits, observables=observables, shots=50) + +# other logic + +estimator.run(circuits=circuits, observables=observables, shots=100) +``` + +For more information about the primitive options, refer to the +[Options class API reference](../api/qiskit-ibm-runtime/qiskit_ibm_runtime.options.Options). + + +## 2. Transpilation + + +By default, the Qiskit Runtime primitives perform circuit transpilation. There are several optimization +levels you can choose from. These levels affect the transpilation strategy and might include additional error +suppression mechanisms. Level 0 only involves basic transpilation. +See the Optimization level table in the +[Error suppression topic](error-suppression#setting-the-optimization-level) for further details. + +The optimization level option is a "first level option", and can be set as follows: + +```python +from qiskit_ibm_runtime import Estimator, Options + +options = Options(optimization_level=2) + +# or.. +options = Options() +options.optimization_level = 2 + +estimator = Estimator(session=session, options=options) +``` + + +You might want to configure your transpilation strategy further, and for this, there are advanced transpilation +options you can set up. These are "second level options", and can be set as follows: + +```python +from qiskit_ibm_runtime import Estimator, Options + +options = Options() +options.transpilation.initial_layout = ... +options.transpilation.routing_method = ... + +estimator = Estimator(session=session, options=options) +``` + +For more information, and a complete list of advanced transpilation options, see the Advanced transpilation options table in the +[Error suppression topic](../optimize/error-suppression#transpilation-table). + +Finally, you might want to specify settings that are not available through the primitives interface, +or use custom transpiler passes. In these cases, you can set ``skip_transpilation=True`` to submit +user-transpiled circuits. To learn how this is done, refer to the +[Submitting user-transpiled circuits using primitives tutorial](https://learning.quantum-computing.ibm.com/tutorial/submitting-user-transpiled-circuits-using-primitives). + +The ``skip_transpilation`` option is an advanced transpilation option, set as follows: + +```python +from qiskit_ibm_runtime import Estimator, Options + +options = Options() +options.transpilation.skip_transpilation = True + +estimator = Estimator(session=session, options=options) +``` + +## 3. Error mitigation + + +You might want to leverage different error mitigation methods and see how these affect the performance of your +algorithm. These can also be set through the ``resilience_level`` option. The method selected for each level is +different for ``Sampler`` and ``Estimator``. You can find more information in the +[Configure error mitigation topic](error-mitigation). + +The configuration is similar to the other options: + +```python +from qiskit_ibm_runtime import Estimator, Options + +options = Options(resilience_level = 2) + +# or... + +options = Options() +options.resilience_level = 2 + +estimator = Estimator(session=session, options=options) +``` diff --git a/docs/optimize/error-mitigation.mdx b/docs/optimize/error-mitigation.mdx new file mode 100644 index 0000000000..8723920210 --- /dev/null +++ b/docs/optimize/error-mitigation.mdx @@ -0,0 +1,306 @@ +--- +title: Configure error mitigation +description: Configure error mitigation +--- + +{/*Content comes from https://qiskit.org/ecosystem/ibm-runtime/how_to/error-mitigation.html and should be removed from qiskit.org.*/} + +# Configure error mitigation + +Error mitigation techniques allow users to mitigate circuit errors by +modeling the device noise at the time of execution. This typically +results in quantum pre-processing overhead related to model training and +classical post-processing overhead to mitigate errors in the raw results +by using the generated model. + +The error mitigation techniques built in to primitives are advanced +resilience options. To specify these options, use the `resilience_level` +option when submitting your job. + +The resilience level specifies how much resilience to build against +errors. Higher levels generate more accurate results, at the expense of +longer processing times. Resilience levels can be used to configure the +cost/accuracy trade-off when applying error mitigation to your primitive +query. Error mitigation reduces errors (bias) in results by processing +the outputs from a collection, or ensemble, of related circuits. The +degree of error reduction depends on the method applied. The resilience +level abstracts the detailed choice of error mitigation method to allow +users to reason about the cost/accuracy trade that is appropriate to +their application. + +Given this, each level corresponds to a method or methods with +increasing level of quantum sampling overhead to enable you experiment +with different time-accuracy tradeoffs. The following table shows you +which levels and corresponding methods are available for each of the +primitives. + + +Error mitigation is task specific so the techniques you are able to +apply vary based whether you are sampling a distribution or generating +expectation values. + + + +| Resilience Level | Definition | Estimator | Sampler | +|------------------|-------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|---------| +| 0 | No mitigation | None | None | +| 1 [Default] | Minimal mitigation costs: Mitigate error associated with readout errors | Twirled Readout Error eXtinction (TREX interpreted-text readout errors ) | M3 | +| 2 | Medium mitigation costs. Typically reduces bias in estimators, but is not guaranteed to be zero bias. | Zero Noise Extrapolation (ZNE interpreted-text) | - |- +| 3 | Heavy mitigation with layer sampling. Theoretically expected to deliver zero bias estimators. ) | Probabilistic Error cancelation (PEC interpreted-text) | - |-| + + + + +Resilience levels are currently in beta so sampling overhead and +solution quality will vary from circuit to circuit. New features, +advanced options, and management tools will be released on a rolling +basis. Specific error mitigation methods are not guaranteed to be +applied at each resilience level. + + +## Configure the Estimator with resilience levels + + +
+Resilience Level 0 + +No error mitigation is applied to the user program. + + +
+ + +
+Resilience Level 1 + +Level 1 applies error mitigation methods that particularly address +readout errors. In the Estimator, we apply a model-free technique known +as Twirled Readout Error eXtinction (TREX). It reduces measurement error +by diagonalizing the noise channel associated with measurement by +randomly flipping qubits through X gates immediately before measurement, +and flipping the corresponding measured bit if an X gate was applied. A +rescaling term from the diagonal noise channel is learned by +benchmarking random circuits initialized in the zero state. This allows +the service to remove bias from expectation values that result from +readout noise. This approach is described further in [Model-free +readout-error mitigation for quantum expectation +values](https://arxiv.org/abs/2012.09738). + +
+ + +
+Resilience Level 2 + +Level 2 uses the Zero Noise Extrapolation method (ZNE) which computes an +expectation value of the observable for different noise factors +(amplification stage) and then uses the measured expectation values to +infer the ideal expectation value at the zero-noise limit (extrapolation +stage). This approach tends to reduce errors in expectation values, but +is not guaranteed to produce an unbiased result. + + +![Illustration of the ZNE method](/images/optimize/resiliance-2.png "Illustration of the ZNE method") + +The overhead of this method scales with the number of noise factors. The +default settings sample the expectation value at three noise factors, +leading to a roughly 3x overhead when employing this resilience level. + + +
+ + +
+Resilience Level 3 + +Level 3 enables the Probabilistic Error Cancelation (PEC) method. This +approach mitigates error by learning and inverting a sparse noise model +that is able to capture correlated noise. PEC returns an unbiased +estimate of an expectation value so long as learned noise model +faithfully represents the actual noise model at the time of mitigation. +In practice, the experimental procedure for learning the noise model has +ambiguities due to certain error terms that cannot be independently +distinguished. These are resolved by a symmetry assumption, which +depending on the true underlying noise may lead a biased estimate of the +mitigated expectation values due to using an imperfect noise model. + + +The Qiskit Runtime primitive implementation of PEC specifically +addresses noise in self-inverse two-qubit gates, so it first +*stratifies* each input circuit into an alternating sequence of +simultaneous 1-qubit gates followed by a layer of simultaneous 2-qubit +gates. Then it learns the noise model associated with each unique +2-qubit gate layer. + +
+/images/optimize/stratified.png +
This is an example of a stratified circuit, where the layers of +two-qubit gates are labeled layer 1 through n. Note that each Ul is composed +of two-qubit gates on the native connectivity graph of the quantum +processor. The open boxes represent arbitrary single-qubit +gates.
+
+ +The overhead of this method scales with the number of noise factors. The +default settings sample the expectation value at three noise factors, +leading to a roughly 3x overhead when employing this resilience level. + +PEC uses a quasi-probability method to mimic the effect of inverting the +learned noise. This requires sampling from a randomized circuit family +associated with the user's original circuit. Applying PEC will increase +the variability of the returned expectation value estimates unless the +number of samples per circuit is also increased for both input and +characterization circuits. The amount of samples required to counter +this variability scales exponentially with the noise strength of the +mitigated circuit. + +How this works: + +When estimating an unmitigated Pauli observable $\langle P\rangle$ the +standard error in the estimated expectation value is given by + +$\frac{1}{\sqrt{N_{\text{shots}}}}\left(1- \langle P\rangle^2\right)$ + +where $N_{\text{shots}}$ is the number of shots used to estimate +$\langle P\rangle$. When applying PEC mitigation, the standard error +becomes +$\sqrt{\frac{S}{N_{\text{samples}}}}\left(1- \langle P\rangle^2\right)$ +where $N_{\text{samples}}$ is the number of PEC samples. + +The sampling overhead scales exponentially with a parameter that +characterizes the collective noise of the input circuit. As the Qiskit +Runtime primitive learns the noise of your circuit, it will return +metadata about the sampling overhead associated with that particular +layer. Let's label the overhead of layer $l$ as $\gamma_l$. Then the +total sampling overhead for mitigating your circuit is the product of +all the layer overheads, that is: + +$S = \prod_l \gamma_l$ + +When the Estimator completes the model-learning phase of the primitive +query, it will return metadata about the total sampling overhead for +circuit. + +Depending on the precision required by your application, you will need +to scale the number of samples accordingly. The following plot +illustrates the relationship between estimator error and number of +circuit samples for different total sampling overheads. + +![](/images/optimize/sampling-overhead.png) + +Note that the number of samples required to deliver a desired accuracy +is not known before the primitive query because the mitigation scaling +factor is discovered during the learning phase of PEC. + +We suggest starting with short depth circuits to get a feel for the +scaling of the sampling overhead of PEC before attempting larger +problems. + + +
+ +## Example + +The Estimator interface lets users seamlessly work with the variety of +error mitigation methods to reduce error in expectation values of +observables. The following code uses Zero Noise Extrapolation by simply +setting `resilience_level 2`. + +```python +from qiskit_ibm_runtime import QiskitRuntimeService, Estimator, Options + +service = QiskitRuntimeService() +options = Options() +options.resilience_level = 2 +options.optimization_level = 3 +backend = service.backend("ibmq_qasm_simulator") + +estimator = Estimator(options=options, backend=backend) +job = estimator.run(circuits=[psi1], observables=[H1], parameter_values=[theta1]) +psi1_H1 = job.result() +``` + + + +As you increase the resilience level, you will be able to use additional methods to improve the accuracy of your result. However, because the methods become more advanced with each level, they require additional sampling overhead (time) to generate more accurate expectation values. Note that higher resilience levels do not guarantee better quality. Higher levels only mean greater overhead. Each method has its strengths and weaknesses. For example, TREX (Twirled Readout Error eXtinction) is good for shallow circuits because of its readout error mitigation, whereas ZNE (Zero Noise Extrapolation) is good for deeper circuits. PEC can mitigate arbitrary errors but may not work in practice because of its large overhead. + + +## Configure Sampler with resilience levels + +The Sampler default resilience setting (level 1) enables readout error +mitigation to allow users to generate mitigated quasi-probability +distributions. + + +
+Resilience Level 1 + +Level 1 uses matrix-free measurement mitigation (M3) routine to mitigate +readout error. M3 works in a reduced subspace defined by the noisy input +bit strings that are to be corrected. Because the number of unique bit +strings can be much smaller than the dimensionality of the full +multi-qubit Hilbert space, the resulting linear system of equations is +nominally much easier to solve. + +![Illustration of the M3 method](/images/optimize/m3.png) + +
+ +```python +from qiskit_ibm_runtime import QiskitRuntimeService, Sampler, Options + +service = QiskitRuntimeService() +options = Options() +options.resilience_level = 1 +options.optimization_level = 3 +backend = service.backend("ibmq_qasm_simulator") + +sampler = Sampler(backend, options=options) +``` + +## Advanced resilience options + +You can tune advanced options to configure your resilience strategy +further. These methods can be used alongside resilience levels where you +change the specific options of interest and let your previously set +resilience level manage the rest. + +As a part of the beta release of the resilience options, users will be +able configure ZNE by using the following advanced options. We will soon +add options to tune other resilience levels that include PEC. + + + +| Options | Inputs | Description | +|-----------------------------------------------------------------------------------------|---------------------------------|----------------------------------------------------------------------------------------------------------------------------------| +| `options.resilience.noise_amplifier(Optional\[str\])`
select your amplification strategy | `TwoQubitAmplifier` [Default] | Amplifies noise of all performing local gate folding. | +| | `CxAmplifier` | Amplifies noise of all CNOT gates by performing local gate folding. | +| | `LocalFoldingAmplifier` | Amplifies noise of all gates by performing local gate folding. | +| | `GlobalFoldingAmplifier` | Amplifies noise of the input circuit by performing global folding of the entire input circuit. | +| `options.resilience.noise_factors(Optional[Sequence[float]])` | (1, 3, 5)[Default] | Noise amplification factors, where [1] represents the baseline noise. They all need to be greater than or equal to the baseline. | +| `options.resilience.extrapolator(Optional\[str\])` | `LinearExtrapolator`\[Default\] | Polynomial extrapolation of degree one. | +| | `Quadratic Extrapolator` | Polynomial extrapolation of degree two and lower. | +| | `Cubic Extrapolator` | Polynomial extrapolation of degree three and lower. | +| | `Quartic Extrapolator` | Polynomial extrapolation of degree four and lower. | + +### Example of adding `resilience_options` with the Estimator primitive + +```python +from qiskit_ibm_runtime import QiskitRuntimeService, Estimator, Options + +service = QiskitRuntimeService() +options = Options() +options.optimization_level = 3 +options.resilience_level = 2 +options.resilience.noise_factors = (1, 2, 3, 4) +options.resilience.noise_amplifier = 'CxAmplifier' +options.resilience.extrapolator = 'QuadraticExtrapolator' +backend = service.backend("ibmq_qasm_simulator") + +estimator = Estimator(options=options, backend=backend) +job = estimator.run(circuits=[psi1], observables=[H1], parameter_values=[theta1]) +psi1_H1 = job.result() +``` + diff --git a/docs/optimize/error-suppression.mdx b/docs/optimize/error-suppression.mdx new file mode 100644 index 0000000000..00fd0c95fc --- /dev/null +++ b/docs/optimize/error-suppression.mdx @@ -0,0 +1,123 @@ +--- +title: Configure error suppression +description: How to use error suppression techniques + +--- + +# Configure error suppression + +Error suppression techniques optimize and transform your circuit at the point of compilation to minimize errors. This is the most basic error handling technique. + +Error suppression typically results in some classical pre-processing overhead added to your overall runtime. Therefore, it is important to achieve a balance between perfecting your results and ensuring that your job completes in a reasonable amount of time. + +Primitives let you employ error suppression techniques by setting the optimization level (`optimization_level` option) and by choosing advanced transpilation options. + +## Setting the optimization level + +The `optimization_level` setting specifies how much optimization to perform on the circuits. Higher levels generate more optimized circuits, at the expense of longer transpilation times. + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Optimization LevelEstimator & Sampler
0 + No optimization: typically used for hardware characterization + + - Basic translation + - Layout (as specified) + - Routing (stochastic swaps) +
1 + Light optimization: + + - Layout (trivial → vf2 → SabreLayout if routing is required) + - Routing (SabreSWAPs if needed) + - 1Q gate optimization + - Error suppression: dynamical decoupling +
2 + Medium optimization: + - Layout/Routing: Optimization level 1 (without trivial) + heuristic optimized with greater + search depth and trials of optimization function + - Commutative cancelation + - Error suppression: dynamical decoupling +
3 (default) + High Optimization: + + - Optimization level 2 + heuristic optimized on layout/routing further with greater effort/trials + - Two qubit KAK optimization + - Error suppression: dynamical decoupling +
+ +### Example: configure Estimator with optimization levels + +```python +from qiskit_ibm_runtime import QiskitRuntimeService, Estimator, Options +from qiskit.circuit.library import RealAmplitudes +from qiskit.quantum_info import SparsePauliOp + +service = QiskitRuntimeService() +backend = service.backend("ibmq_qasm_simulator") +options = Options(optimization_level=2) + +psi = RealAmplitudes(num_qubits=2, reps=2) +H = SparsePauliOp.from_list([("II", 1), ("IZ", 2), ("XI", 3)]) +theta = [0, 1, 1, 2, 3, 5] + +estimator = Estimator (options=options, backend=backend) + +job = estimator.run(circuits=[psi], observables=[H], parameter_values=[theta]) +psi1_H1 = job.result() +``` + + + If the optimization level is not specified, the service uses `optimization_level = 3`. + + +### Example: configure Sampler with optimization levels + +```python +from qiskit_ibm_runtime import QiskitRuntimeService, Sampler, Options + +service = QiskitRuntimeService() +backend = service.backend("ibmq_qasm_simulator") +options = Options(optimization_level=3) + +sampler = Sampler(options=options, backend=backend) +``` + + + +## Advanced transpilation options + +You also have the ability to tune a variety of advanced options to configure your transpilation strategy further. These methods can be used alongside optimization levels. They allow you to change the options of interest and let your optimization level manage the rest. + +Most of the transpilation options are inherited from [qiskit.compiler.transpile](/api/qiskit/compiler#compilation-routines). + +| Options | Description | +| --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| options.transpilation.initial\_layout(Union\[dict, List, None]) | Initial position of virtual qubits on physical qubits. | +| options.transpilation.layout\_method (Optional\[str]) | Name of layout selection pass. One of `trivial`, `dense`, `noise_adaptive`, `sabre`. | +| options.transpilation.routing\_method (Optional\[str]) | Name of routing pass: `basic`, `lookahead`, `stochastic`, `sabre`, `none`. | +| options.transpilation.skip\_transpilation (bool) | This option is specific to Qiskit Runtime primitives. Allows for skipping transpilation entirely. If you use this method, make sure to verify that your circuit is written using the basis gates on the backend you are running on. | +| options.transpilation.approximation\_degree (Optional\[float]) | Heuristic dial used for circuit approximation (1.0=no approximation, 0.0=maximal approximation). Defaults to no approximation for all optimization levels | diff --git a/docs/run/account-management.mdx b/docs/run/account-management.mdx new file mode 100644 index 0000000000..4ebf3f0d43 --- /dev/null +++ b/docs/run/account-management.mdx @@ -0,0 +1,93 @@ +--- +title: Manage your account +description: Manage your account +--- +# Manage your account + +Qiskit Runtime is available on both IBM Quantum Platform and IBM Cloud. The former requires an IBM Quantum account and the latter requires an IBM Cloud account. If you don’t have an account, get one at the appropriate link: + +* [IBM Quantum account](https://quantum-computing.ibm.com/account) +* [IBM Cloud account](https://cloud.ibm.com/docs/account?topic=account-account-getting-started) + + +The user account performs two essential functions. First, an account is associated with one or more [instances](instances) that give access to IBM Quantum services. Second, a unique token is assigned to each account, allowing for IBM Quantum access from Qiskit. + +## View your account + +Follow the instructions in the appropriate section to access your account. + +### View an IBM Quantum Platform account + +You can view your IBM Quantum account information after you log in to [IBM Quantum](https://quantum-computing.ibm.com/) by clicking Manage account in the account menu ( ![account](/images/migration/account-231.png) ). From this page you can view and edit general account information, copy or regenerate your API token, change your notification settings, and find your instances. You will also come here if you ever need to delete your account. + + + * Your unique API token provides access to your data, so treat it as you would any password and keep it secure. + * Account deletion is permanent, and cannot be undone. All data are permanently removed. + * IBM Quantum is required to send you email notifications about your account and privacy. + + +### View an IBM Quantum on IBM Cloud account + +You can view your IBM Quantum account information after you log in to [IBM Cloud](https://cloud.ibm.com/quantum/) by clicking Profile in the account menu ( ![account](/images/migration/account-231.png) ). The Account settings page lets you view and edit your contact information, view your active sessions, and change your notification preferences. + +## Account management methods + +There are several methods for account management. Your account credentials can be saved to disk or used in a session and never saved. + +* save_account(): Save your account to disk for future use and optionally set it as the default. +* delete_account(): Delete the saved account from disk. +* active_account(): List the account currently in the session. +* saved_account(): List the account stored on disk. + +## Store credentials + +The `save_account()` method can be used to store your account credentials on disk, in the `$HOME/.qiskit/qiskit-ibm.json` file. After the credentials are saved, you will only need to use `QiskitRuntimeService()` to initialize your account in the future. + + + Account credentials are saved in plain text, so only do so if you are using a trusted device. + + +Following are examples of saving an IBM Quantum and an IBM Cloud account. The `channel` parameter allows you to distinguish between different account types. If you are saving multiple accounts per channel, consider using the `name` parameter to differentiate them. + +If you do not set a default account, IBM Cloud is the default. Your default account can be overridden by passing in the account name or by having an account saved in an environment variable. + +```python +from qiskit_ibm_runtime import QiskitRuntimeService + +# Save an IBM Quantum account on disk and set it as the default. +QiskitRuntimeService.save_account(channel="ibm_quantum", token=, set_as_default=True) + +# Save an IBM Cloud account on disk. +QiskitRuntimeService.save_account(channel="ibm_cloud", token=, instance= or ) + +``` + +## Initialize your account + +You need to initialize your account in a Python session before you can start using Qiskit Runtime. If you have the credentials saved, you can initialize an `QiskitRuntimeService` instance without additional parameters. + +```python +# Read default credentials from disk. +service = QiskitRuntimeService() +``` + +If you want to use your credentials for just the session rather than saving them, you can pass the credentials in when initializing the `QiskitRuntimeService` instance: + +```python +# Initialize an IBM Cloud account without saving it. +service = QiskitRuntimeService(channel="ibm_cloud", token=, instance=) +``` + +## Which account is used? + +When you initialize your account, the account used depends on what (if any) credentials you previously saved. The account is chosen in this order: + +1. The account specified in the `QiskitRuntimeService()` call +1. The account saved in an environment variable +1. The account set as the default by using `save_account()` +1. Your IBM Cloud account +1. Your IBM Quantum Platform account + + + If you send a job to a backend that the selected account cannot access, an account that can access the backend is used instead. See the [backends page](backends) for details. + diff --git a/docs/run/cost.mdx b/docs/run/cost.mdx new file mode 100644 index 0000000000..cc97e50d3b --- /dev/null +++ b/docs/run/cost.mdx @@ -0,0 +1,81 @@ +--- +title: Manage cost +description: How to manage costs of running jobs on systems when using the Standard plan for IBM Quantum on IBM Cloud. + +--- + +# Manage cost + +The IBM Cloud Quantum Standard plan is not free, except when running jobs on simulators. Use the information in this topic to help you understand how much you’re paying and how to limit your costs. + + + The information in this topic only applies to those who are using the Standard plan for IBM Quantum on IBM Cloud. There are no costs associated with IBM Quantum Platform open plan. + + +## How to limit your cost + +There are several factors that can help you limit your cost: + +- Run only as many iterations and shots as you need: The time your job takes (and therefore, its cost) depends on how many iterations you make in a session and how many shots are run in each iteration. Therefore, you can manage your cost by running only as many iterations and shots as you need. +- Set limits on execution time: You can limit how long each job or session runs. For details, see [Maximum execution time for a Qiskit Runtime job or session](max-execution-time). +- An instance administrator can limit how much is spent. To set cost limits, navigate to the [IBM Cloud Instances page](https://cloud.ibm.com/quantum/instances), then click the instance and set the **Cost limit**. The cost limit refers to the total cost of all jobs run with this instance since it was created, and it will always be greater than or equal to the Total cost. After the instance reaches the specified number of total seconds, no further jobs can be run and no more cost is incurred. + + + The cost limit is always specified in US dollars (USD), then converted to runtime seconds. However, for monthly billing purposes, you are charged in your local currency, specified on your IBM Cloud account. Because currency exchange rates can fluctuate, the cost for X runtime seconds might be different when initially calculated in USD than when you’re actually charged in your local currency. As a result, if your local currency is not USD, the total amount charged for the number of seconds specified in this field could vary from the dollar amount you specify. + + +## How to remove a cost limit + +An instance administrator can remove the cost limit. To do so, navigate to the [IBM Cloud Instances page](https://cloud.ibm.com/quantum/instances), then open the instance and click the edit button by the **Cost limit**. Delete the value and click **Save**. + +### What happens when the cost limit is reached + +When the instance’s cost limit is reached, the currently running job is stopped. Its status is set to Canceled with a reason of Ran too long. Any available partial results are kept. + +No further jobs can be submitted by using this instance until the cost limit is increased. + +## How to see what you’re being charged + +You are sent a monthly invoice that provides details about your resource charges. You can check how much has been spent at any time on the [IBM Cloud Billing and usage page](https://cloud.ibm.com/billing). + +Additionally, you can determine cost per instance or per job at any time. + +### View instance cost + +To determine how much has been billed to an instance during the current billing cycle, from the [Instances page](https://cloud.ibm.com/quantum/instances), click the instance to open its details page. + +These are the fields relevant to cost: + +- **Billing cycle usage**: Qiskit Runtime usage by this instance during the current billing cycle. This usage is the time counted by Qiskit Runtime to process a job, and is determined by the use of internal resources. +- **Billing cycle cost**: The total cost of running jobs during the current billing cycle. +- **Total usage**: Qiskit Runtime usage by this instance since it was created. +- **Total cost**: The total cost of running jobs on this instance since it was created. Only administrators can set this value. + +You can view your billing cycle on the [Billing and usage page](https://cloud.ibm.com/billing). + +### View job cost + +To determine how much has been billed to each job associated with an instance, from the [Instances page](https://cloud.ibm.com/quantum/instances), click the instance to open its details page. Next, on the left side, click Jobs. + +These are the columns relevant to cost: + +- **Usage**: Qiskit Runtime used by this job. This usage is the time counted by Qiskit Runtime to process a job, and is determined by the use of internal resources. +- **Cost**: The total cost of running this job. + +## Estimate the cost + +You can estimate how long a job will run, and therefore its cost, by estimating the job run time. For details, see the [Estimate job run time](estimate-job) topic. + +## Set up spending notifications + +You can set up spending notifications to get notified when your account or a particular service reaches a specific spending threshold that you set. For information, see the [IBM Cloud account Type description](https://cloud.ibm.com/docs/account?topic=account-accounts). IBM Cloud spending notifications must be used with other methods of cost management for several reasons: + +* The notifications trigger only *after* cost surpasses the specified limit. +* Cost is submitted to the billing system hourly. Therefore, a long delay might occur between the job submission and the spending notification being sent. +* The billing system can take multiple days to get information to the invoicing system, which might cause further delay in notifications. For more information about how the IBM Cloud billing system works, see [Setting spending notifications](https://cloud.ibm.com/docs/billing-usage?topic=billing-usage-spending). + +## Next steps + + + Review the [Qiskit Runtime plans](https://cloud.ibm.com/docs/quantum-computing?topic=quantum-computing-plans) available on IBM Cloud. + diff --git a/docs/run/max-execution-time.mdx b/docs/run/max-execution-time.mdx new file mode 100644 index 0000000000..987c7a5007 --- /dev/null +++ b/docs/run/max-execution-time.mdx @@ -0,0 +1,85 @@ +--- +title: Maximum execution time for a Qiskit Runtime job or session +description: Describes how long a Qiskit Runtime job or session can run. + +--- + +# Maximum execution time + +To ensure fairness and help control costs, there is a maximum amount of time each Qiskit Runtime job and session can run. If a job exceeds this time limit, it is forcibly canceled and a `RuntimeJobMaxTimeoutError` exception is raised. If a session exceeds its limits, any queued jobs are cancelled but any jobs that are already running are not. + + +## Job maximum execution time + +The maximum execution time for a job is the smaller of these values: + +- The value set for max_execution_time +- The system-determined job timeout value + + + As of August 7, 2023, the `max_execution_time` value is based on _quantum time_ instead of wall clock time. Quantum time is the time that the QPU complex (including control software, control electronics, QPU, and so on) is engaged in processing the job. + + Simulator jobs continue to use wall clock time because they do not have quantum time. + + +Set the maximum execution time (in seconds) on the job options by using one of the following methods: + +```python +# Initiate the Options class with parameters +options = Options(max_execution_time=360) +``` + +```python +# Create the options object with attributes and values +options = {"max_execution_time": 360} +``` + +You can also find how much quantum time completed jobs have used by returning the job metrics as follows: + +```python +# Find quantum time used by the job +print(f"Quantum time used by job {job.job_id()} was {job.metrics()['usage']['quantum_seconds']} seconds") +``` + + +### System maximum execution time + +The system calculates an appropriate job timeout value based on the input circuits and options. This system-calculated timeout is capped at 3 hours to ensure fair device usage. If a `max_execution_time` is also specified for the job, the lesser of the two values is used. + +For example, if you specify `max_execution_time=5000` (approximately 83 minutes), but the system determines it should not take more than 5 minutes (300 seconds) to execute the job, then the job is cancelled after 5 minutes. + + +## Session maximum execution time + +When a session is started, it is assigned a maximum session timeout value. After this timeout is reached, the session is terminated, any jobs that are already running continue running, and any queued jobs that remain in the session are put into a failed state. You can set the maximum session timeout value using the `max_time` parameter: + +```python +# Set the session max time +with Session(max_time="1h"): + ... +``` + +Additionally, there is a 5-minute *interactive* timeout value. If there are no session jobs queued within that window, the session is temporarily deactivated and normal job selection resumes. During job selection, if the job scheduler gets a new job from the session and its maximum timeout value has not been reached, the session is reactivated until its maximum timeout value is reached. + + + The timer for the session’s `max_time` timer is not paused during any temporary deactivation periods. + + +### Defaults + +If you don't specify a session `max_time`, the system defaults are used: + + +| User account type | Primitive programs | Private programs | +| ----------------- | ------------------ | ---------------- | +| Premium | 8h | 8h | +| Open | 15 min | N/A | + + + A *premium user* here means a user who has access to backends in providers other than ibm-q/open/main. + + +## Other limitations + +* Programs cannot exceed 750KB in size. +* Inputs to jobs cannot exceed 64MB in size. \ No newline at end of file diff --git a/docs/run/monitor.mdx b/docs/run/monitor.mdx new file mode 100644 index 0000000000..85e4078638 --- /dev/null +++ b/docs/run/monitor.mdx @@ -0,0 +1,46 @@ +--- +title: Monitor a job +description: How to monitor a job submitted to IBM Quantum Platform or IBM Quantum on IBM Cloud + +--- + +# Monitor a job + +Jobs are listed on the Jobs page for your quantum service channel: + +* IBM Cloud channel: From the IBM Cloud console quantum [Instances page](https://cloud.ibm.com/quantum/instances), click the name of your instance, then click the Jobs tab. +* IBM Quantum channel: In IBM Quantum Platform, open the [Jobs page](https://quantum-computing.ibm.com/jobs). + +Use the job instance to check the job status or retrieve the results by calling the appropriate command: + +| | | +| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| job.result() | Review job results immediately after the job completes. Job results are available after the job completes. Therefore, job.result() is a blocking call until the job completes. | +| job.job\_id() | Return the ID that uniquely identifies that job. Retrieving the job results at a later time requires the job ID. Therefore, it is recommended that you save the IDs of jobs you might want to retrieve later. | +| job.status() | Check the job status. | +| job = service.job(\) | Retrieve a job you previously submitted. This call requires the job ID. | + +## Retrieve job results at a later time + +Call `service.job(\)` to retrieve a job you previously submitted. If you don’t have the job ID, or if you want to retrieve multiple jobs at once; including jobs from retired systems, call `service.jobs()` with optional filters instead. See [QiskitRuntimeService.jobs](../api/qiskit-ibm-runtime/qiskit_ibm_runtime.QiskitRuntimeService#jobs). + + + service.jobs() returns only Qiskit Runtime jobs. To retrieve other jobs, use [qiskit-ibm-provider](../api/qiskit-ibm-provider/qiskit_ibm_provider.IBMBackend#ibmbackend) instead. + + +## Example + +This example returns the 10 most recent runtime jobs that were run on `my_backend`: + +```python +from qiskit_ibm_runtime import QiskitRuntimeService + +# Initialize the account first. +service = QiskitRuntimeService() + +service.jobs(backend_name=my_backend) +``` + +## Qiskit tools (`qiskit.tools`) + +For more information, see the [Qiskit tools documentation](/api/qiskit/tools) in the Qiskit Terra API reference. diff --git a/docs/run/run-sessions.mdx b/docs/run/run-sessions.mdx new file mode 100644 index 0000000000..20d7e34b54 --- /dev/null +++ b/docs/run/run-sessions.mdx @@ -0,0 +1,213 @@ +--- +title: Run jobs in a session +description: Run a job in a session + +--- + +# Run jobs in a session + +There are several ways to set up and use [sessions](sessions). The following +information should not be considered mandatory steps to follow. Instead, +choose the configuration that best suits your needs. This +information assumes that you are using Qiskit Runtime +[primitives](../build/primitives). + +## Prerequisites + +Before starting a session, you must [set up Qiskit Runtime](../start/install) and initialize it as a service: + +``` python +from qiskit_ibm_runtime import QiskitRuntimeService + +service = QiskitRuntimeService() +``` + +## Open a session + +You can open a runtime session by using the context manager `with Session(...)` or by initializing the `Session` +class. When you start a session, you can specify options, such as the +backend to run on. This topic describes the most commonly used options. +For the full list, see the [Sessions API documentation](../api/qiskit-ibm-runtime/qiskit_ibm_runtime.Session#session). + + + Data from the first session job is cached and used by subsequent jobs. Therefore, if the first job is canceled, subsequent session jobs will all fail. + + + +**Session class** + +A session can be created by initializing the `Session` class, which can then be passed to the desired primitives. Example: + +``` python +session = Session(service=service, backend="ibmq_qasm_simulator") +estimator = Estimator(session=session) +sampler = Sampler(session=session) +``` + +**Context manager** + +The context manager automatically opens a session for you. A session is +started when the first primitive job in this context manager starts (not when it is queued). Primitives created in the context automatically use +that session. Example: + +``` python +with Session(service=service, backend="ibmq_qasm_simulator"): + estimator = Estimator() + sampler = Sampler() +``` + +## Specify a backend + +When you start a session, you can specify session options, such as the +backend to run on. A backend is required if you are using the IBM +Quantum channel, but optional if you are using the IBM Cloud channel. +Once specified, you cannot change the backend used for a session and you +cannot specify multiple backends within a session. To use a different +backend, open a new session. + +There are two ways to specify a backend in a session: + +**Directly specify a string with the backend name.** Example: + +``` python +backend = "ibmq_qasm_simulator" +with Session(backend=backend): + ... +``` + +**Pass the backend object.** Example: + +``` python +backend = service.get_backend("ibmq_qasm_simulator") +with Session(backend=backend): + ... +``` + +## Specify the session length + +When a session is started, it is assigned a maximum session timeout +value. After the session has been open the specified amount of time, the +session expires and is forcefully closed. You can no longer submit jobs +to that session. See [What happens when a session ends?](sessions#ends) for further details. + +You can configure the maximum session timeout value through the +`max_time` parameter, which can be specified as seconds +(int) or a string, like "2h 30m 40s". This value has to be greater +than the `max_execution_time` of the job and less than the +system's `max_time`. The default value is the system's +`max_time`. See [What is the maximum execution time for a Qiskit Runtime job?](max-execution-time) to determine the +system limit. + +When setting the session length, consider how long each job within the +session might take. For example, if you run five jobs within a session +and each job is estimated to be five minutes long, the maximum time for +the session should at least 25 min. + +``` python +with Session(service=service, backend=backend, max_time="25m"): + ... +``` + +There is also an interactive timeout value (ITTL, or interactive time to live) that cannot be configured. For premium accounts, the ITTL is 5 min, and for open plan accounts, the ITTL is 2 sec. If no session jobs are queued within that window, the session is temporarily deactivated. For more details about session length and timeout, see [How long a session stays active](sessions#active). + + +## Close a session + +When jobs are all done, it is recommended that you use +`session.close()` to close the session. This allows the +scheduler to run the next job without waiting for the session timeout, +therefore making it easier for everyone. You cannot submit jobs to a +closed session. + + + Close a session only after all session jobs **complete**, rather than immediately after they have all been submitted. Session jobs that are not completed will fail. + + + +``` python +with Session(service=service, backend=backend) as session: + estimator = Estimator() + job = estimator.run(...) + # Do not close here, the job might not be completed! + result = job.result() + # Reaching this line means that the job is finished. + session.close() +``` + +## Invoke multiple primitives in a session + +You are not restricted to a single primitive function within a session. In this section we will show you an example of using multiple primitives. + +First we prepare a circuit for the Sampler primitive. + +```python +from qiskit.circuit.random import random_circuit + +sampler_circuit = random_circuit(2, 2, seed=0).decompose(reps=1) +sampler_circuit.measure_all() +display(circuit.draw("mpl")) +``` + +The example below shows how you can create both an instance of the `Sampler` class and one of the `Estimator` class and invoke their `run()` methods within a session. + +```python +from qiskit_ibm_runtime import Session, Sampler, Estimator + +with Session(backend=backend): + sampler = Sampler() + estimator = Estimator() + + result = sampler.run(sampler_circuit).result() + print(f">>> Quasi-probability distribution from the sampler job: {result.quasi_dists[0]}") + + result = estimator.run(circuit, observable).result() + print(f">>> Expectation value from the estimator job: {result.values[0]}") + ``` +The calls can also be synchronous. You don’t need to wait for the result of a previous job before submitting another one, as shown below: + +```python +from qiskit_ibm_runtime import Session, Sampler, Estimator + +with Session(backend=backend): + sampler = Sampler() + estimator = Estimator() + + sampler_job = sampler.run(sampler_circuit) + estimator_job = estimator.run(circuit, observable) + + print( + f">>> Quasi-probability distribution from the sampler job: {sampler_job.result().quasi_dists[0]}" + ) + print(f">>> Expectation value from the estimator job: {estimator_job.result().values[0]}") +``` + +## Full example + +In this example, we start a session, run an Estimator job, and output +the result: + +``` python +from qiskit.circuit.random import random_circuit +from qiskit.quantum_info import SparsePauliOp +from qiskit_ibm_runtime import QiskitRuntimeService, Session, Estimator, Options + +circuit = random_circuit(2, 2, seed=1).decompose(reps=1) +observable = SparsePauliOp("IY") + +options = Options() +options.optimization_level = 2 +options.resilience_level = 2 + +service = QiskitRuntimeService() +with Session(service=service, backend="ibmq_qasm_simulator") as session: + estimator = Estimator(options=options) + job = estimator.run(circuit, observable) + result = job.result() + # Close the session only if all jobs are finished, and you don't need to run more in the session + session.close() + +display(circuit.draw("mpl")) +print(f" > Observable: {observable.paulis}") +print(f" > Expectation value: {result.values[0]}") +print(f" > Metadata: {result.metadata[0]}") +``` \ No newline at end of file diff --git a/docs/run/sessions.mdx b/docs/run/sessions.mdx new file mode 100644 index 0000000000..6c89f94e0b --- /dev/null +++ b/docs/run/sessions.mdx @@ -0,0 +1,165 @@ +--- +title: Sessions +description: Describes what sessions are. + +--- + +# About sessions + +A session allows a collection of jobs to be grouped and jointly scheduled by the Qiskit Runtime service, facilitating iterative use of quantum computers without incurring queuing delays on each iteration. This eliminates artificial delays caused by other users’ jobs running on the same quantum device during the session. + +
+ Jobs are shown moving through the queue.  Only the first session job waits in the fair-share queue. +
Figure 1: Qiskit Runtime session flow diagram
+
+ +Compared with jobs that use the [fair-share scheduler](../run/queue), +sessions become particularly beneficial when running programs that +require iterative calls between classical and quantum resources, where a +large number of jobs are submitted sequentially. This is the case, for +example, when training a variational algorithm such as VQE or QAOA, or +in device characterization experiments. + +Runtime sessions can be used with Qiskit Runtime +primitives. Primitive program interfaces vary based on the type of task +that you want to run on the quantum computer and the corresponding data +that you want returned as a result. After identifying the appropriate +primitive for your program, you can use Qiskit to prepare inputs, such +as circuits, observables (for Estimator), and customizable options to +optimize your job. For more information, see the +[Primitives](../build/primitives) topic. + +## Benefits of using sessions + +There are several benefits to using sessions: + +- Jobs that belong to a single algorithm run are run together without interruption, increasing efficiency if your program submits multiple sequential jobs. + + + - The queuing time does not decrease for the first job submitted within a session. Therefore, a session does not provide any benefits if you only need to run a single job. + - Since data from the first session job is cached and used by subsequent jobs, if the first job is canceled, subsequent session jobs will all fail. + + + +- When using sessions, the uncertainty around queuing time is significantly reduced. This allows better estimation of a workload's total runtime and better resource management. +- In a device characterization context, the ability to to run experiments closely together helps prevent device drifts and provide more accurate results. +- While the session is active, you can submit different jobs, inspect job results, and re-submit new jobs without opening a new session. +- You maintain the flexibility to deploy your programs either remotely (cloud / on-premises) or locally (your laptop). + +## The mechanics of sessions (queuing) + +For each backend, the first job in the session waits its turn in the +queue normally, but while the session is active, subsequent jobs within +the same session take priority over any other queued jobs. If no jobs +that are part of the active session are ready, the session is +deactivated (paused), and the next job from the regular fair-share queue +is run. See [Interactive timeout value](#ttl) for more information. + +A quantum processor still executes one job at a time. Therefore, jobs +that belong to a session still need to wait for their turn if one is +already running. + + + Internal systems jobs such as calibration have priority over session jobs. + + +## Iterations and batching + +Sessions can be used for iterative or batch execution. + +### Iterative + +Any session job submitted within the interactive timeout, also known as interactive time to live (ITTL), is processed immediately. This allows some time for variational algorithms, such as VQE, to perform classical post-processing. + +- The quantum device is locked to the session user unless the ITTL is reached. +- Post-processing could be done anywhere, such as a personal computer, cloud service, or an HPC environment. + +![Iterative session execution diagram.](/images/run/iterative.png 'Figure 2: Iterative session execution') + +### Batch + +Ideal for running experiments closely together to avoid device drifts, +that is, to maintain device characterization. + +- Suitable for batching many jobs together. +- Jobs that fit within the maximum session time run back-to-back on + hardware. + + + When batching, jobs are not guaranteed to run in the order they are submitted. + + +![Batch session execution diagram.](/images/run/batch.png 'Figure 3: Batch session execution') + + +## How long a session stays active + +The length of time a session is active is controlled by the *maximum session timeout* (`max_time`) value and the *interactive timeout value* (ITTL, or interactive time to live). The `max_time` timer starts when the +session becomes active - that is, when the first job runs, not when it is +queued. It does not stop if a session becomes inactive. The ITTL timer +starts each time a session job finishes. + +## Maximum session timeout + +When a session is started, it is assigned a *maximum session timeout* +value. You can set this value by using the `max_time` parameter, which +can be greater than the program's `max_execution_time`. For +instructions, see [Run a primitive in a session](run-sessions). + +If you do not specify a timeout value, it is the smaller of these +values: + +- The system limit +- The `max_execution_time` defined by the program + +See [What is the maximum execution time for a Qiskit Runtime job?](max-execution-time) to determine the system limit and +the `max_execution_time` for primitive programs. + + +## Interactive timeout value + +Every session has an *interactive timeout value* (ITTL, or interactive time to live) of five minutes for premium accounts and two seconds for open plan accounts. The ITTL cannot be configured. If there are no session jobs queued within the +ITTL window, the session is temporarily deactivated and normal job +selection resumes. A deactivated session can be resumed if it has not +reached its maximum timeout value. The session is resumed when a +subsequent session job starts. Once a session is deactivated, its next +job waits in the queue like other jobs. + +After a session is deactivated, the next job in the queue is selected to +run. This newly selected job (which can belong to a different user) can +run as a singleton, but it can also start a different session. In other +words, a deactivated session does not block the creation of other +sessions. Jobs from this new session would then take priority until it +is deactivated or closed, at which point normal job selection resumes. + + +## What happens when a session ends + +A session ends by reaching its maximum timeout value or when it is +manually closed by the user. Do not close a session until all jobs +**complete**. See [Close a session](run-sessions#close) for details. After a session is closed, the following occurs: + +- Any jobs that are already running continue to run. +- Any queued jobs remaining in the session are put into a failed state. +- No further jobs can be submitted to the session. +- The session cannot be reopened. + + +## Sessions and reservations + +IBM Quantum Premium users can access both reservations and sessions on +specific backends. Such users should plan ahead and decide whether to +use a session or a reservation. You *can* use a session within a +reservation. However, if you use a session within a reservation and some +session jobs don't finish during the reservation window, the remaining +pending jobs might fail. If you use session inside a reservation we +recommend that you set a realistic `max_time` value. + +![Diagram showing which job runs next in the queue.](/images/run/jobs-failing.png 'Figure 4: Job selection diagram') + +## Next steps + + + - [Run a primitive in a session.](../build/primitives-examples#leverage-sessions-and-advanced-options) + - See sessions at work in the [VQE tutorial.](https://learning.quantum-computing.ibm.com/tutorial/variational-quantum-eigensolver-using-estimator-primitive-and-sessions). + diff --git a/docs/test/noise.mdx b/docs/test/noise.mdx new file mode 100644 index 0000000000..71b3bb667b --- /dev/null +++ b/docs/test/noise.mdx @@ -0,0 +1,318 @@ +--- +title: Noisy simulators +description: Set up ibmq_qasm_simulator and map a basic noise model for an IBM Quantum hardware device in Qiskit Runtime. + +--- + +{/*Content comes from https://qiskit.org/ecosystem/ibm-runtime/how_to/noisy_simulators.html and needs to be removed from qiskit.org*/} + +# Noisy simulators + +Set up ``ibmq_qasm_simulator`` and map a basic noise model for an IBM Quantum hardware device in Qiskit Runtime, then use this noise model to perform noisy simulations of ``QuantumCircuits`` by using ``Sampler`` and ``Estimator`` to study the effects of errors that occur on real devices. + +## Set up your local development environment + +If you haven’t already set up a Qiskit Runtime service instance, follow the steps in [Install and set up](../start/install) to do so. + +``` python +# load necessary Runtime libraries +from qiskit_ibm_runtime import QiskitRuntimeService, Sampler, Estimator, Session, Options + +service = QiskitRuntimeService() +``` + +## Prepare the environment + +First, we run an example routine. One of the major benefits of using primitives is simplification of binding multiple parameters in parameterized circuits. To illustrate this, we start with is an example circuit with a controlled [P-gate](/api/qiskit/qiskit.circuit.library.PhaseGate) as implemented in the following code. Here, we parameterize the ``P-gate`` with a rotation parameter ``theta``. For instructions to create circuits and bind parameters to them by using Qiskit, see the [Circuit Basics](https://qiskit.org/documentation/tutorials/circuits/01_circuit_basics.html) and [Advanced Circuits](https://qiskit.org/documentation/tutorials/circuits_advanced/01_advanced_circuits.html#Parameterized-circuits) tutorials in Qiskit documentation. {/*Will these tutorials still live at those URLs?*/} + +``` python +from qiskit.circuit import Parameter +from qiskit import QuantumCircuit + +theta = Parameter('theta') + +qc = QuantumCircuit(2,1) +qc.x(1) +qc.h(0) +qc.cp(theta,0,1) +qc.h(0) +qc.measure(0,0) + +qc.draw('mpl') +``` + +![](../images/qiskit-ibm-runtime/noisy-sim-circuit.png) + +The circuit shown previously is parameterized and the eigenvalue is put back into qubit 0 to be measured. The eigenvalue's rotation is determined by the parameter theta. Next, we define the circuit's parameters as a list. The parameters in this example range from $0$ to $2\pi$, divided over 50 evenly spaced points. + +``` python +import numpy as np + +phases = np.linspace(0, 2*np.pi, 50) + +# phases need to be expressed as a list of lists +individual_phases = [[phase] for phase in phases] +``` +## Running on the ideal simulator + +### Set the backend and options to use + + +Our first run assumes an ideal case, without any ``noise_model``, ``optimization_level`` or ``resilience_level`` for both Sampler and Estimator. We will define the options in the following code: + +``` python +backend = "ibmq_qasm_simulator" # use the simulator +``` + +``` python +options = Options() +options.simulator.seed_simulator = 42 +options.execution.shots = 1000 +options.optimization_level = 0 # no optimization +options.resilience_level = 0 # no error mitigation +``` +### Run the circuits on Sampler + +Next, we use the Sampler primitive to sample the circuit and get the resultant quasi-probability distribution. Visit the [Get started with Sampler](../build/primitives-get-started#get-started-with-sampler) section for more information about the Sampler primitive. + +``` python +sampler = Sampler(options=options, backend=backend) +job = sampler.run( + circuits=[qc]*len(phases), + parameter_values=individual_phases +) +result = job.result() +``` + +``` python +import matplotlib.pyplot as plt + +# the probablity of being in the 1 state for each of these values +prob_values = [dist.get(1, 0) for dist in result.quasi_dists] + +plt.plot(phases, prob_values, 'o', label='Simulator') +plt.plot(phases, np.sin(phases/2,)**2, label='Theory') +plt.xlabel('Phase') +plt.ylabel('Probability') +plt.legend() +``` + +``` + +``` + +![](../images/qiskit-ibm-runtime/noisy-sim-sampler-ideal.png) + +### Run the circuits on Estimator + +Visit the [Get started with Estimator](../build/primitives-get-started#get-started-with-estimator) section for more information on the Estimator primitive. + +The Estimator binds single-qubit rotations to get Hamiltonians before it returns expectation values of quantum operators. Therefore, the circuit doesn’t require any measurements. Currently the circuit ``qc`` has measurements, so we will remove these with ``remove_final_measurements``. + +``` python +qc_no_meas = qc.remove_final_measurements(inplace=False) +qc_no_meas.draw('mpl') +``` + +![](../images/qiskit-ibm-runtime/noisy-sim-estimator-circuit.png) + +``` python + +from qiskit.quantum_info import SparsePauliOp + +ZZ = SparsePauliOp.from_list([("ZZ", 1)]) +print(f" > Observable: {ZZ.paulis}") +``` + +``` +> Observable: ['ZZ'] +``` + +With this observable, the expectation value is calculated by the +following equation. + +$$ \langle ZZ\rangle =\langle \psi | ZZ | \psi\rangle=\langle \psi|(|0\rangle\langle 0| -|1\rangle\langle 1|)\otimes(|0\rangle\langle 0| - |1\rangle\langle 1|) |\psi\rangle =|\langle 00|\psi\rangle|^2 - |\langle 01 | \psi\rangle|^2 - |\langle 10 | \psi\rangle|^2 + |\langle 11|\psi\rangle|^2$$ + +The following code implements the expectation value equation. + +``` python +with Session(service=service, backend=backend): + estimator = Estimator(options=options) + job = estimator.run( + circuits=[qc_no_meas]*len(phases), + parameter_values=individual_phases, + observables=[ZZ]*len(phases) + ) + result = job.result() +``` +``` python +exp_values = result.values + +plt.plot(phases, exp_values, 'o', label='Simulator') +plt.plot(phases, 2*np.sin(phases/2)**2-1, label='Theory') +plt.xlabel('Phase') +plt.ylabel('Expectation') +plt.legend() +``` + + + +``` + +``` + +![](../images/qiskit-ibm-runtime/noisy-sim-estimator-ideal.png) + +## Running a noisy simulation + +Now we’ll set up our simulator to run a noisy simulation rather than the ideal one. We can pass a custom ``noise_model`` to the Qiskit Runtime simulator by specifying it in the ``Options`` parameter. Here we will try to mimic a real backend by using the ``noise_model`` from a ``FakeBackend`` class. The noise model can be extracted from the ``FakeBackend`` and passed as a ``simulator`` parameter in options. For more details, visit the [Fake Provider](/api/qiskit/providers_fake_provider) documentation in the Qiskit Terra API reference. + +Since we are trying to mimic a real backend, we can also pass in the backend topology's ``coupling_map`` and its supported ``basis_gates`` to have a more realistic noisy simulation. + +``` python +from qiskit.providers.fake_provider import FakeManila +from qiskit_aer.noise import NoiseModel + +# Make a noise model +fake_backend = FakeManila() +noise_model = NoiseModel.from_backend(fake_backend) + +# Set options to include the noise model +options = Options() +options.simulator = { + "noise_model": noise_model, + "basis_gates": fake_backend.configuration().basis_gates, + "coupling_map": fake_backend.configuration().coupling_map, + "seed_simulator": 42 +} + +# Set number of shots, optimization_level and resilience_level +options.execution.shots = 1000 +options.optimization_level = 0 +options.resilience_level = 0 +``` + +The ``ibmq_qasm_simulator`` allows for the activation of the ``resilience_levels`` offered by the Qiskit Runtime service, and use of these levels on simulators is best demonstrated using the noisy simulation as we have described previously. + +To illustrate the comparison, we will define two set of ``Options``. Here, ``options`` is set to ``resilience level = 0`` to represent a normal run without error mitigation, and ``options with em`` is set to ``resilience level = 1`` to represent a run with error mitigation enabled. + +``` python +# Set options to include the noise model with error mitigation +options_with_em = Options() +options_with_em.simulator = { + "noise_model": noise_model, + "basis_gates": fake_backend.configuration().basis_gates, + "coupling_map": fake_backend.configuration().coupling_map, + "seed_simulator": 42 +} + +# Set number of shots, optimization_level and resilience_level +options_with_em.execution.shots = 1000 +options_with_em.optimization_level = 0 # no optimization +options_with_em.resilience_level = 1 # M3 for Sampler and T-REx for Estimator +``` + +When you set the ``resilience_level`` to 1, M3 is activated in Sampler. +All available resilience level configurations are described on the [Configure error mitigation](../optimize/error-mitigation) page. + +``` python +with Session(service=service, backend=backend): + # include the noise model without M3 + sampler = Sampler(options=options) + job = sampler.run( + circuits=[qc]*len(phases), + parameter_values=individual_phases + ) + result = job.result() + prob_values = [1-dist[0] for dist in result.quasi_dists] + + # include the noise model with M3 + sampler = Sampler(options=options_with_em) + job = sampler.run( + circuits=[qc]*len(phases), + parameter_values=individual_phases + ) + result = job.result() + prob_values_with_em = [1-dist[0] for dist in result.quasi_dists] +``` +``` python +plt.plot(phases, prob_values, 'o', label='Noisy') +plt.plot(phases, prob_values_with_em, 'o', label='Mitigated') +plt.plot(phases, np.sin(phases/2,)**2, label='Theory') +plt.xlabel('Phase') +plt.ylabel('Probability') +plt.legend() +``` + +``` + +``` + +![](../images/qiskit-ibm-runtime/noisy-sim-sampler-noisy.png) + +``T-REx`` is triggered in Estimator when the resilience level is set to +1. + +``` python +with Session(service=service, backend=backend): + # include the noise model without T-REx + estimator = Estimator(options=options) + job = estimator.run( + circuits=[qc_no_meas]*len(phases), + parameter_values=individual_phases, + observables=[ZZ]*len(phases) + ) + result = job.result() + exp_values = result.values + + # include the noise model with T-REx + estimator = Estimator(options=options_with_em) + job = estimator.run( + circuits=[qc_no_meas]*len(phases), + parameter_values=individual_phases, + observables=[ZZ]*len(phases)) + result = job.result() + exp_values_with_em = result.values +``` +``` python +plt.plot(phases, exp_values, 'o', label='Noisy') +plt.plot(phases, exp_values_with_em, 'o', label='Mitigated') +plt.plot(phases, 2*np.sin(phases/2)**2-1, label='Theory') +plt.xlabel('Phase') +plt.ylabel('Expectation') +plt.legend() +``` + + + +``` + +``` + + + +![](../images/qiskit-ibm-runtime/noisy-sim-estimator-noisy.png) + +Resilience levels are currently in beta so sampling overhead and +solution quality will vary from circuit to circuit. New features, +advanced options, and management tools will be released on a rolling +basis. You can also test out higher levels of resilience and +explore the additional options they offer. For more information +about activating features like `Digital-ZNE` and `PEC`, in addition to `M3` and `T-REx` as shown in the previous examples, see the [Error suppression and error mitigation with Qiskit Runtime](https://learning.quantum-computing.ibm.com/tutorial/error-suppression-and-error-mitigation-with-qiskit-runtime) tutorial. + +``` python +import qiskit_ibm_runtime +qiskit_ibm_runtime.version.get_version_info() +``` + + + +``` +'0.8.0' +``` + + +``` python +from qiskit.tools.jupyter import * +%qiskit_version_table +``` From c970355d400997c866581d003b963f423c168dee Mon Sep 17 00:00:00 2001 From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com> Date: Wed, 4 Oct 2023 12:33:32 -0400 Subject: [PATCH 9/9] Migrate Aer noise model from closed source Co-authored-by: Paul Nation --- docs/test/building_noise_models.ipynb | 898 ++++++++++++++++++++++++++ 1 file changed, 898 insertions(+) create mode 100644 docs/test/building_noise_models.ipynb diff --git a/docs/test/building_noise_models.ipynb b/docs/test/building_noise_models.ipynb new file mode 100644 index 0000000000..76de71bdb0 --- /dev/null +++ b/docs/test/building_noise_models.ipynb @@ -0,0 +1,898 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "source": ["# Building Noise Models"] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Introduction\n", + "\n", + "This notebook introduces how to use the Qiskit Aer `noise` module to build custom noise models for noisy simulations." + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:43.403378Z", + "start_time": "2019-08-19T17:00:41.139269Z" + } + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "from qiskit import QuantumCircuit, transpile\n", + "from qiskit.quantum_info import Kraus, SuperOp\n", + "from qiskit_aer import AerSimulator\n", + "from qiskit.tools.visualization import plot_histogram\n", + "\n", + "# Import from Qiskit Aer noise module\n", + "from qiskit_aer.noise import (NoiseModel, QuantumError, ReadoutError,\n", + " pauli_error, depolarizing_error, thermal_relaxation_error)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "slide" + } + }, + "source": [ + "## Qiskit Aer Noise Module\n", + "\n", + "The Qiskit Aer `noise` module contains Python classes to build customized noise models for simulation. There are three key classes:\n", + "\n", + "1. The `NoiseModel` class which stores a noise model used for noisy simulation.\n", + "2. The `QuantumError` class which describes CPTP gate errors. These can be applied:\n", + " * After *gate* or *reset* instructions\n", + " * Before *measure* instructions.\n", + "\n", + "3. The `ReadoutError` class which describes classical readout errors." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Quantum Errors\n", + "\n", + "Rather than deal with the `QuantumError` object directly, many helper functions exist to automatically generate a specific type of parameterized quantum error. These are contained in the `noise` module and include functions for many common errors types used in quantum computing research. The function names and the type of error they return are:\n", + "\n", + "| Standard error function | Details |\n", + "| --- | --- |\n", + "| `kraus_error` | a general n-qubit CPTP error channel given as a list of Kraus matrices $[K_0, ...]$. |\n", + "| `mixed_unitary_error` | an n-qubit mixed unitary error given as a list of unitary matrices and probabilities $[(U_0, p_0),...]$. |\n", + "| `coherent_unitary_error` | an n-qubit coherent unitary error given as a single unitary matrix $U$. |\n", + "| `pauli_error` | an n-qubit Pauli error channel (mixed unitary) given as a list of Pauli's and probabilities $[(P_0, p_0),...]$ |\n", + "| `depolarizing_error` | an n-qubit depolarizing error channel parameterized by a depolarization probability $p$. |\n", + "| `reset_error` | a single-qubit reset error parameterized by a probabilities $p_0, p_1$ of resetting to the $|0\\rangle$, $|1\\rangle$ state.|\n", + "| `thermal_relaxation_error` | a single qubit thermal relaxation channel parameterized by relaxation time constants $T_1$, $T_2$, gate time $t$, and excited state thermal population $p_1$. |\n", + "| `phase_amplitude_damping_error` | A single-qubit generalized combined phase and amplitude damping error channel given by an amplitude damping parameter $\\lambda$, a phase damping parameter $\\gamma$, and an excited state thermal population $p_1$. |\n", + "| `amplitude_damping_error` | A single-qubit generalized amplitude damping error channel given by an amplitude damping parameter $\\lambda$, and an excited state thermal population $p_1$. |\n", + "| `phase_damping_error` | A single-qubit phase damping error channel given by a phase damping parameter $\\gamma$ |\n", + "\n", + "### Combining quantum errors\n", + "\n", + "`QuantumError` instances can be combined by using composition, tensor product, and tensor expansion (reversed order tensor product) to produce new `QuantumErrors` as:\n", + "\n", + " * Composition: $\\cal{E}(\\rho)=\\cal{E_2}(\\cal{E_1}(\\rho))$ as `error = error1.compose(error2)`\n", + " * Tensor product: $\\cal{E}(\\rho) =(\\cal{E_1}\\otimes\\cal{E_2})(\\rho)$ as `error error1.tensor(error2)`\n", + " * Expand product: $\\cal{E}(\\rho) =(\\cal{E_2}\\otimes\\cal{E_1})(\\rho)$ as `error error1.expand(error2)`" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Example\n", + "\n", + "For example to construct a 5% single-qubit Bit-flip error:" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:43.420358Z", + "start_time": "2019-08-19T17:00:43.416062Z" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "QuantumError on 1 qubits. Noise circuits:\n", + " P(0) = 0.05, Circuit = \n", + " ┌───┐\n", + "q: ┤ X ├\n", + " └───┘\n", + " P(1) = 0.95, Circuit = \n", + " ┌───┐\n", + "q: ┤ I ├\n", + " └───┘\n", + "QuantumError on 1 qubits. Noise circuits:\n", + " P(0) = 0.05, Circuit = \n", + " ┌───┐\n", + "q: ┤ Z ├\n", + " └───┘\n", + " P(1) = 0.95, Circuit = \n", + " ┌───┐\n", + "q: ┤ I ├\n", + " └───┘\n" + ] + } + ], + "source": [ + "# Construct a 1-qubit bit-flip and phase-flip errors\n", + "p_error = 0.05\n", + "bit_flip = pauli_error([('X', p_error), ('I', 1 - p_error)])\n", + "phase_flip = pauli_error([('Z', p_error), ('I', 1 - p_error)])\n", + "print(bit_flip)\n", + "print(phase_flip)" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:43.435843Z", + "start_time": "2019-08-19T17:00:43.432211Z" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "QuantumError on 1 qubits. Noise circuits:\n", + " P(0) = 0.0025000000000000005, Circuit = \n", + " ┌───┐┌───┐\n", + "q: ┤ X ├┤ Z ├\n", + " └───┘└───┘\n", + " P(1) = 0.0475, Circuit = \n", + " ┌───┐┌───┐\n", + "q: ┤ X ├┤ I ├\n", + " └───┘└───┘\n", + " P(2) = 0.0475, Circuit = \n", + " ┌───┐┌───┐\n", + "q: ┤ I ├┤ Z ├\n", + " └───┘└───┘\n", + " P(3) = 0.9025, Circuit = \n", + " ┌───┐┌───┐\n", + "q: ┤ I ├┤ I ├\n", + " └───┘└───┘\n" + ] + } + ], + "source": [ + "# Compose two bit-flip and phase-flip errors\n", + "bitphase_flip = bit_flip.compose(phase_flip)\n", + "print(bitphase_flip)" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:43.460191Z", + "start_time": "2019-08-19T17:00:43.456782Z" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "QuantumError on 2 qubits. Noise circuits:\n", + " P(0) = 0.0025000000000000005, Circuit = \n", + " ┌───┐\n", + "q_0: ┤ X ├\n", + " ├───┤\n", + "q_1: ┤ Z ├\n", + " └───┘\n", + " P(1) = 0.0475, Circuit = \n", + " ┌───┐\n", + "q_0: ┤ I ├\n", + " ├───┤\n", + "q_1: ┤ Z ├\n", + " └───┘\n", + " P(2) = 0.0475, Circuit = \n", + " ┌───┐\n", + "q_0: ┤ X ├\n", + " ├───┤\n", + "q_1: ┤ I ├\n", + " └───┘\n", + " P(3) = 0.9025, Circuit = \n", + " ┌───┐\n", + "q_0: ┤ I ├\n", + " ├───┤\n", + "q_1: ┤ I ├\n", + " └───┘\n" + ] + } + ], + "source": [ + "# Tensor product two bit-flip and phase-flip errors with\n", + "# bit-flip on qubit-0, phase-flip on qubit-1\n", + "error2 = phase_flip.tensor(bit_flip)\n", + "print(error2)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Converting to and from QuantumChannel operators\n", + "\n", + "We can also convert back and forth between `QuantumError` objects in Qiskit Aer and `QuantumChannel` objects in Qiskit Terra." + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:43.482424Z", + "start_time": "2019-08-19T17:00:43.473779Z" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Kraus([[[ 9.74679434e-01+0.j, 0.00000000e+00+0.j],\n", + " [-1.20234617e-16+0.j, 9.74679434e-01+0.j]],\n", + "\n", + " [[ 2.62045272e-16+0.j, 2.23606798e-01+0.j],\n", + " [ 2.23606798e-01+0.j, -2.84112242e-16+0.j]]],\n", + " input_dims=(2,), output_dims=(2,))\n" + ] + } + ], + "source": [ + "# Convert to Kraus operator\n", + "bit_flip_kraus = Kraus(bit_flip)\n", + "print(bit_flip_kraus)" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:43.509521Z", + "start_time": "2019-08-19T17:00:43.503976Z" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "SuperOp([[1. +0.j, 0. +0.j, 0. +0.j, 0. +0.j],\n", + " [0. +0.j, 0.9+0.j, 0. +0.j, 0. +0.j],\n", + " [0. +0.j, 0. +0.j, 0.9+0.j, 0. +0.j],\n", + " [0. +0.j, 0. +0.j, 0. +0.j, 1. +0.j]],\n", + " input_dims=(2,), output_dims=(2,))\n" + ] + } + ], + "source": [ + "# Convert to Superoperator\n", + "phase_flip_sop = SuperOp(phase_flip)\n", + "print(phase_flip_sop)" + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:43.794037Z", + "start_time": "2019-08-19T17:00:43.778223Z" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "QuantumError on 1 qubits. Noise circuits:\n", + " P(0) = 1.0, Circuit = \n", + " ┌───────┐\n", + "q: ┤ kraus ├\n", + " └───────┘\n" + ] + }, + { + "data": { + "text/plain": ["True"] + }, + "execution_count": 7, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Convert back to a quantum error\n", + "print(QuantumError(bit_flip_kraus))\n", + "\n", + "# Check conversion is equivalent to original error\n", + "QuantumError(bit_flip_kraus) == bit_flip" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Readout Error\n", + "\n", + "Classical readout errors are specified by a list of assignment probabilities vectors $P(A|B)$:\n", + "\n", + " * $A$ is the *recorded* classical bit value\n", + " * $B$ is the *true* bit value returned from the measurement\n", + "\n", + "E.g. for 1 qubits: $ P(A|B) = [P(A|0), P(A|1)]$." + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:44.659598Z", + "start_time": "2019-08-19T17:00:44.654818Z" + } + }, + "outputs": [ + { + "data": { + "text/plain": ["ReadoutError([[0.95 0.05]\n", " [0.1 0.9 ]])"] + }, + "execution_count": 8, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Measurement miss-assignement probabilities\n", + "p0given1 = 0.1\n", + "p1given0 = 0.05\n", + "\n", + "ReadoutError([[1 - p1given0, p1given0], [p0given1, 1 - p0given1]])" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Readout errors may also be combined using `compose`, `tensor` and `expand` like with quantum errors." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Adding errors to a Noise Model\n", + "\n", + "When adding a quantum error to a noise model we must specify the type of *instruction* that it acts on, and what qubits to apply it to. There are two cases for Quantum Errors:\n", + "\n", + " 1. All-qubit quantum error\n", + " 2. Specific qubit quantum error\n", + "\n", + "### 1. All-qubit quantum error\n", + "\n", + "This applies the same error to any occurrence of an instruction, regardless of which qubits it acts on.\n", + "\n", + "It is added as `noise_model.add_all_qubit_quantum_error(error, instructions)`:" + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:45.882254Z", + "start_time": "2019-08-19T17:00:45.877630Z" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "NoiseModel:\n", + " Basis gates: ['cx', 'id', 'rz', 'sx', 'u1', 'u2', 'u3']\n", + " Instructions with noise: ['u3', 'u2', 'u1']\n", + " All-qubits errors: ['u1', 'u2', 'u3']\n" + ] + } + ], + "source": [ + "# Create an empty noise model\n", + "noise_model = NoiseModel()\n", + "\n", + "# Add depolarizing error to all single qubit u1, u2, u3 gates\n", + "error = depolarizing_error(0.05, 1)\n", + "noise_model.add_all_qubit_quantum_error(error, ['u1', 'u2', 'u3'])\n", + "\n", + "# Print noise model info\n", + "print(noise_model)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### 2. Specific qubit quantum error\n", + "\n", + "This applies the error to any occurrence of an instruction acting on a specified list of qubits. Note that the order of the qubit matters: For a 2-qubit gate an error applied to qubits [0, 1] is different to one applied to qubits [1, 0] for example.\n", + "\n", + "It is added as `noise_model.add_quantum_error(error, instructions, qubits)`:" + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:46.615959Z", + "start_time": "2019-08-19T17:00:46.612055Z" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "NoiseModel:\n", + " Basis gates: ['cx', 'id', 'rz', 'sx', 'u1', 'u2', 'u3']\n", + " Instructions with noise: ['u3', 'u2', 'u1']\n", + " Qubits with noise: [0]\n", + " Specific qubit errors: [('u1', (0,)), ('u2', (0,)), ('u3', (0,))]\n" + ] + } + ], + "source": [ + "# Create an empty noise model\n", + "noise_model = NoiseModel()\n", + "\n", + "# Add depolarizing error to all single qubit u1, u2, u3 gates on qubit 0 only\n", + "error = depolarizing_error(0.05, 1)\n", + "noise_model.add_quantum_error(error, ['u1', 'u2', 'u3'], [0])\n", + "\n", + "# Print noise model info\n", + "print(noise_model)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Note on non-local qubit quantum error\n", + "\n", + "`NoiseModel` does not support addition of non-local qubit quantum errors. They should be handled outside of `NoiseModel`. That suggests you should write your own transpiler pass (`TransformationPass`) and run the pass just before running the simulator if you need to insert your quantum errors into your circuit under your own conditions. See `noise.passes.LocalNoisePass` for example of how to implement such a transpiler pass." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Executing a noisy simulation with a noise model\n", + "\n", + "The command `AerSimulator(noise_model=noise_model)` returns a simulator configured to the given noise model. In addition to setting the simulator's noise model, it also overrides the simulator's basis gates, according to the gates of the noise model." + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "subslide" + } + }, + "source": [ + "## Noise Model Examples\n", + "\n", + "We will now give some examples of noise models. For our demonstrations we will use a simple test circuit generating a n-qubit GHZ state:" + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:48.817405Z", + "start_time": "2019-08-19T17:00:48.806966Z" + }, + "slideshow": { + "slide_type": "fragment" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + " ┌───┐ ░ ┌─┐ \n", + " q_0: ┤ H ├──■─────────────░─┤M├─────────\n", + " └───┘┌─┴─┐ ░ └╥┘┌─┐ \n", + " q_1: ─────┤ X ├──■────────░──╫─┤M├──────\n", + " └───┘┌─┴─┐ ░ ║ └╥┘┌─┐ \n", + " q_2: ──────────┤ X ├──■───░──╫──╫─┤M├───\n", + " └───┘┌─┴─┐ ░ ║ ║ └╥┘┌─┐\n", + " q_3: ───────────────┤ X ├─░──╫──╫──╫─┤M├\n", + " └───┘ ░ ║ ║ ║ └╥┘\n", + "meas: 4/════════════════════════╩══╩══╩══╩═\n", + " 0 1 2 3 \n" + ] + } + ], + "source": [ + "# System Specification\n", + "n_qubits = 4\n", + "circ = QuantumCircuit(n_qubits)\n", + "\n", + "# Test Circuit\n", + "circ.h(0)\n", + "for qubit in range(n_qubits - 1):\n", + " circ.cx(qubit, qubit + 1)\n", + "circ.measure_all()\n", + "print(circ)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": ["### Ideal Simulation"] + }, + { + "cell_type": "code", + "execution_count": 12, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:50.560988Z", + "start_time": "2019-08-19T17:00:50.415545Z" + }, + "scrolled": true + }, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAcgAAAFLCAYAAABShRycAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/P9b71AAAACXBIWXMAAAsTAAALEwEAmpwYAAAdIElEQVR4nO3de5xdZX3v8c/PDA7BJJoEk5ALDkguhkA0jI1Dx6BiKGqrzbFHLV7QVrBW8ND22L7aamu1FERrqfS0CoWC1rZalcvBFhEl5IymwUlKIAGT0CQ0wVzMBZPQOJj4O3+sPek4PLlMMjN7Lp/367Vf7FnPWnv/5kVWvlnPep5nRWYiSZJ+1nPqXYAkSQORASlJUoEBKUlSgQEpSVKBASlJUoEBKUlSQUO9C+hPp556ajY1NdW7DEnSALF8+fIdmfnCUtuwCsimpiba29vrXYYkaYCIiCcO12YXqyRJBQakJA0iTU1NnHPOObz0pS+lubkZgA996EPMmjWLc889l0WLFvHUU08BsHPnTl796lczatQorrjiijpWPTgZkJI0yNx///089NBDh24ZLVy4kFWrVvHwww8zY8YMrrnmGgBOPvlkPv7xj/OpT32qnuUOWgakJA1yF110EQ0N1ZCSV7ziFWzevBmA5z3vebS2tnLyySfXs7xBy4CUpEEkIrjooos477zzuPHGG5/Vfsstt/C6172uDpUNPcNqFKskDXZtbW1MmTKF7du3s3DhQmbNmsWCBQsAuPrqq2loaODtb397nascGryClKRBZMqUKQBMmDCBRYsW8eCDDwJw6623cvfdd/PFL36RiKhniUOGASlJg8TTTz/N3r17D72/9957mTNnDvfccw/XXXcdd911F6ecckqdqxw67GKVpEFi27ZtLFq0CIADBw5wySWXcPHFF3PWWWfR0dHBwoULgWqgzmc/+1mgmhayZ88ennnmGe644w7uvfdeZs+eXbffYTCJzKx3Df2mubk5XUlHktQpIpZnZnOpzS7WYa406XjXrl0sXLiQ6dOns3DhQnbv3g3AnXfeybnnnnto37a2tnqWLkl9yoDUsyYdX3vttVx44YWsW7eOCy+8kGuvvRaACy+8kJUrV/LQQw9xyy238N73vreeZUtSnzIg9Sx33nknl156KQCXXnopd9xxBwCjRo06NDru6aefdqScpCHNgBzmSpOO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", + "text/plain": ["
"] + }, + "execution_count": 12, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Ideal simulator and execution\n", + "sim_ideal = AerSimulator()\n", + "result_ideal = sim_ideal.run(circ).result()\n", + "plot_histogram(result_ideal.get_counts(0))" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": { + "slideshow": { + "slide_type": "subslide" + } + }, + "source": [ + "## Noise Example 1: Basic bit-flip error noise model\n", + "\n", + "Lets consider a simple toy noise model example common in quantum information theory research:\n", + "\n", + "* When applying a single qubit gate, flip the state of the qubit with probability `p_gate1`.\n", + "* When applying a 2-qubit gate apply single-qubit errors to each qubit.\n", + "* When resetting a qubit reset to 1 instead of 0 with probability `p_reset`.\n", + "* When measuring a qubit, flip the state of the qubit with probability `p_meas`." + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:51.543615Z", + "start_time": "2019-08-19T17:00:51.536564Z" + }, + "scrolled": true + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "NoiseModel:\n", + " Basis gates: ['cx', 'id', 'rz', 'sx', 'u1', 'u2', 'u3']\n", + " Instructions with noise: ['reset', 'measure', 'u3', 'u1', 'cx', 'u2']\n", + " All-qubits errors: ['reset', 'measure', 'u1', 'u2', 'u3', 'cx']\n" + ] + } + ], + "source": [ + "# Example error probabilities\n", + "p_reset = 0.03\n", + "p_meas = 0.1\n", + "p_gate1 = 0.05\n", + "\n", + "# QuantumError objects\n", + "error_reset = pauli_error([('X', p_reset), ('I', 1 - p_reset)])\n", + "error_meas = pauli_error([('X',p_meas), ('I', 1 - p_meas)])\n", + "error_gate1 = pauli_error([('X',p_gate1), ('I', 1 - p_gate1)])\n", + "error_gate2 = error_gate1.tensor(error_gate1)\n", + "\n", + "# Add errors to noise model\n", + "noise_bit_flip = NoiseModel()\n", + "noise_bit_flip.add_all_qubit_quantum_error(error_reset, \"reset\")\n", + "noise_bit_flip.add_all_qubit_quantum_error(error_meas, \"measure\")\n", + "noise_bit_flip.add_all_qubit_quantum_error(error_gate1, [\"u1\", \"u2\", \"u3\"])\n", + "noise_bit_flip.add_all_qubit_quantum_error(error_gate2, [\"cx\"])\n", + "\n", + "print(noise_bit_flip)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": ["### Executing the noisy simulation"] + }, + { + "cell_type": "code", + "execution_count": 14, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:52.951874Z", + "start_time": "2019-08-19T17:00:52.687440Z" + }, + "slideshow": { + "slide_type": "-" + } + }, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAcgAAAFLCAYAAABShRycAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/P9b71AAAACXBIWXMAAAsTAAALEwEAmpwYAAA7N0lEQVR4nO3deXxU5dn/8c9FggENKIuEvZHKHkkMqRGLAbdqXVpB69oWhcetrRatVZ/SRf09lboiorWKtVpt1dq6tEjdyq4IBARF2RSwgOxQtmIk4f79cZ/EYThgZstMku/79ZoX5JyZ61wzZ+Zc59znPvcx5xwiIiKyrybpTkBERCQTqUCKiIiEUIEUEREJoQIpIiISQgVSREQkhAqkiIhIiOx0J1CX2rZt6/Lz89OdhoiIZIi5c+ducs4dGTavURXI/Px8ysvL052GiIhkCDP75EDz1MQqIiISQgWyFlatWsVJJ51Enz596Nu3L2PHjgXg1ltvpVOnThQVFVFUVMTEiRMB2LNnD8OGDeOYY46hd+/ejB49Op3pi4hIHBpVE2u8srOzuffeeykuLmbHjh3079+f0047DYDrr7+eG2+8cZ/nP//881RUVPD+++/z3//+lz59+nDxxRej858iIvWHCmQtdOjQgQ4dOgDQokULevfuzZo1aw74fDNj165dVFZWsnv3bg455BBatmxZV+mKiEgSqIk1RitXruTdd9+ltLQUgAcffJB+/foxfPhwtm7dCsD555/PYYcdRocOHejatSs33ngjrVu3TmfaIiISIxXIGOzcuZPzzjuP+++/n5YtW3LNNdfw8ccfM3/+fDp06MBPfvITAGbPnk1WVhaffvopK1as4N5772X58uVpzl5ERGKhAllLe/bs4bzzzuPSSy9l6NChAOTl5ZGVlUWTJk244oormD17NgB//vOfOeOMM2jatCnt2rXj61//ui4vERGpZ1Qga8E5x4gRI+jduzc33HBDzfS1a9fW/P/FF1+koKAAgK5duzJp0iQAdu3axTvvvEOvXr3qNmkREUmIOunUwltvvcVTTz3FMcccQ1FREQB33HEHzzzzDPPnz8fMyM/P55FHHgHghz/8IZdffjl9+/bFOcfll19Ov3790vgOREQkVuacS3cOdaakpMSpqVNERKqZ2VznXEnYPDWxioiIhFCBFBERCaECKSIiEkIFUkRE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YmbMmFGzMSgrK+ODDz5g8+bNABQWFrJjxw6WL18O+GaY1q1bM2/ePABatWpFYWEhU6dOxTmHmTFo0CAWLFhQc+6zuLiYLVu2sHLlyn3W07x587j66qvp2LEjkydPZsyYMTzyyCM458jLy+OnP/0phx9+eM16Wr9+PatWrQKge/fu5OTksHDhQsAfQffo0YMZM2YAkJOTw4ABAzJiPZWUlDBz5kwqKioAGDhwIEuXLq3pjl9QUEBFRQXLli0DyLj1FOvvqb6spxdeeIHWrVuzefNmZs+ezbBhw7jnnnvIy8vj8ccf5/HHH2fgwIEZtZ7Gjh27z3qaMmUK3bp1Y9y4cfusp71798a8npxznHCCPya55JJL+PnPf16znqpfF896At+7trbWrl2b8O/pYCyTTtCa2edAuXPuhIhpdwBDnHO9zewE/DnKrzjn/h3xnMeBTs650w8Wv6SkxCXaNn7F/bE9f/zI2JdRVVVFSUkJnTp1YsKECZx44ok1R38bNmzguOOO46WXXoo9cD123333UV5ezvbt25kwYQI9evTg5Zdfpnfv3vz2t79l9uzZPPHEE+lOUxqg1atXM2zYMEaNGsV9993HH/7wB44//ng+/vhjAKZPn87o0aOZOHFimjOtO2vWrKFTp05s2LCB0047jXHjxtU0rQ4ePJh77rlnn8EJaqsutq/RzGyucy402UxrYl0LfBg1bRHQNfj/uuDfvKjn5EXMq/fGjh1L7969a/6ePn068+fPZ/78+QwYMIChQ4emMbu6t3r1al555RX+53/+p2aamdXsqW7bto2OHTumK720iW72c84xatQoevToQe/evXnggQfSnGHDMHLkSO666y6aNPGby7Zt21JZWVlzNPjXv/615uiqsQjrz9AQZVqBfAuIbsTuAXwS/H8FvhCeVj3TzJoBJwJv10WCqRZWDKpt376dSZMmce6559Z9YmkUvYECeOyxxzjzzDPp3LkzTz31FLfccksaM0yP6B2pJ554glWrVrF48WIWLVrERRddlMbsGoYJEybQrl07+vfvXzPNzHj22We5/vrrOe6442pGp2osDtSfoSHKtHOQY4C3zWwU8BxwLHAd8DMA55wzs/uBn5nZYmAp8HNgJ/DntGScZNXFoPoLGOmll17ilFNOoWXLlmnILD0iN1DV548BxowZw8SJEyktLeXuu+/mhhtu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", + "text/plain": ["
"] + }, + "execution_count": 14, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Create noisy simulator backend\n", + "sim_noise = AerSimulator(noise_model=noise_bit_flip)\n", + "\n", + "# Transpile circuit for noisy basis gates\n", + "circ_tnoise = transpile(circ, sim_noise)\n", + "\n", + "# Run and get counts\n", + "result_bit_flip = sim_noise.run(circ_tnoise).result()\n", + "counts_bit_flip = result_bit_flip.get_counts(0)\n", + "\n", + "# Plot noisy output\n", + "plot_histogram(counts_bit_flip)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Example 2: T1/T2 thermal relaxation\n", + "\n", + "Now consider a more realistic error model based on thermal relaxation with the qubit environment:\n", + "* Each qubit is parameterized by a thermal relaxation time constant $T_1$ and a dephasing time constant $T_2$.\n", + "* Note that we must have $T_2 \\le 2 T_1$.\n", + "* Error rates on instructions are determined by gate times and qubit $T_1$, $T_2$ values." + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:54.577456Z", + "start_time": "2019-08-19T17:00:54.491018Z" + } + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "NoiseModel:\n", + " Basis gates: ['cx', 'id', 'rz', 'sx', 'u2', 'u3']\n", + " Instructions with noise: ['reset', 'measure', 'u3', 'cx', 'u2']\n", + " Qubits with noise: [0, 1, 2, 3]\n", + " Specific qubit errors: [('reset', (0,)), ('reset', (1,)), ('reset', (2,)), ('reset', (3,)), ('measure', (0,)), ('measure', (1,)), ('measure', (2,)), ('measure', (3,)), ('u2', (0,)), ('u2', (1,)), ('u2', (2,)), ('u2', (3,)), ('u3', (0,)), ('u3', (1,)), ('u3', (2,)), ('u3', (3,)), ('cx', (0, 0)), ('cx', (0, 1)), ('cx', (0, 2)), ('cx', (0, 3)), ('cx', (1, 0)), ('cx', (1, 1)), ('cx', (1, 2)), ('cx', (1, 3)), ('cx', (2, 0)), ('cx', (2, 1)), ('cx', (2, 2)), ('cx', (2, 3)), ('cx', (3, 0)), ('cx', (3, 1)), ('cx', (3, 2)), ('cx', (3, 3))]\n" + ] + } + ], + "source": [ + "# T1 and T2 values for qubits 0-3\n", + "T1s = np.random.normal(50e3, 10e3, 4) # Sampled from normal distribution mean 50 microsec\n", + "T2s = np.random.normal(70e3, 10e3, 4) # Sampled from normal distribution mean 50 microsec\n", + "\n", + "# Truncate random T2s <= T1s\n", + "T2s = np.array([min(T2s[j], 2 * T1s[j]) for j in range(4)])\n", + "\n", + "# Instruction times (in nanoseconds)\n", + "time_u1 = 0 # virtual gate\n", + "time_u2 = 50 # (single X90 pulse)\n", + "time_u3 = 100 # (two X90 pulses)\n", + "time_cx = 300\n", + "time_reset = 1000 # 1 microsecond\n", + "time_measure = 1000 # 1 microsecond\n", + "\n", + "# QuantumError objects\n", + "errors_reset = [thermal_relaxation_error(t1, t2, time_reset)\n", + " for t1, t2 in zip(T1s, T2s)]\n", + "errors_measure = [thermal_relaxation_error(t1, t2, time_measure)\n", + " for t1, t2 in zip(T1s, T2s)]\n", + "errors_u1 = [thermal_relaxation_error(t1, t2, time_u1)\n", + " for t1, t2 in zip(T1s, T2s)]\n", + "errors_u2 = [thermal_relaxation_error(t1, t2, time_u2)\n", + " for t1, t2 in zip(T1s, T2s)]\n", + "errors_u3 = [thermal_relaxation_error(t1, t2, time_u3)\n", + " for t1, t2 in zip(T1s, T2s)]\n", + "errors_cx = [[thermal_relaxation_error(t1a, t2a, time_cx).expand(\n", + " thermal_relaxation_error(t1b, t2b, time_cx))\n", + " for t1a, t2a in zip(T1s, T2s)]\n", + " for t1b, t2b in zip(T1s, T2s)]\n", + "\n", + "# Add errors to noise model\n", + "noise_thermal = NoiseModel()\n", + "for j in range(4):\n", + " noise_thermal.add_quantum_error(errors_reset[j], \"reset\", [j])\n", + " noise_thermal.add_quantum_error(errors_measure[j], \"measure\", [j])\n", + " noise_thermal.add_quantum_error(errors_u1[j], \"u1\", [j])\n", + " noise_thermal.add_quantum_error(errors_u2[j], \"u2\", [j])\n", + " noise_thermal.add_quantum_error(errors_u3[j], \"u3\", [j])\n", + " for k in range(4):\n", + " noise_thermal.add_quantum_error(errors_cx[j][k], \"cx\", [j, k])\n", + "\n", + "print(noise_thermal)" + ] + }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": ["### Executing the noisy simulation"] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:00:55.689241Z", + "start_time": "2019-08-19T17:00:55.515394Z" + } + }, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAcgAAAFLCAYAAABShRycAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjYuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/P9b71AAAACXBIWXMAAAsTAAALEwEAmpwYAAAqxklEQVR4nO3de5xVdb3/8deHGR1RQEHljg2UIBdhHKZoPCNwLNSUTiGdTC3zkphpeenX6frrR53Uk6dSMysjPRaeI6V5O3hJRQGxERsRDJCLcYkhYOImg+Eo+Pn98V1Dm813YAY2e+0N7+fjsR/MrLX2nvfsNezP+n7Xd32XuTsiIiKyq3ZpBxARESlEKpAiIiIRKpAiIiIRKpAiIiIRKpAiIiIRKpAiIiIRpWkHyKfjjjvOy8vL044hIiIF4uWXX17v7sfH1h1SBbK8vJy6urq0Y4iISIEws5UtrVMXq4iISIQKpIiI5NWOHTs45ZRTGDt2LADTpk2jsrKSiooKampqeP311wG47rrrqKiooKKigv79+3PMMcfkNech1cUqIiLpu+222xg4cCBbtmwB4Morr+SRRx5h4MCB/PSnP+V73/se99xzD7fccsvO59x+++288sorec2pFqSIiORNfX09jz32GJ/73Od2LjOzncXyjTfeoGfPnrs977777uP888/PW05QC1JERPLo2muv5eabb6axsXHnsl/+8pecffbZtG/fnk6dOvHiiy/u8pyVK1eyfPlyTj/99LxmVQtyP2X3pZ922mk7+8x79uzJxz/+cQA2bdrEuHHjGDp0KB/4wAeYP39+iqlFRPJv6tSpdO3aleHDh++y/JZbbuHxxx+nvr6eSy65hOuvv36X9VOmTOETn/gEJSUl+YyrFuT+yu5Lf/7553euGz9+PB/72McAuPHGG6moqOChhx5i0aJFXHXVVUybNi2VzCIiaXjhhRd49NFHefzxx3nrrbfYsmUL55xzDosWLWLEiBEAnHfeeZx11lm7PG/KlCnccccdec+rFuR+iPWlN9uyZQvPPvvszhbkwoULd3YPnHTSSaxYsYJ169blM66ISKpuuukm6uvrWbFiBVOmTOH000/nkUce4Y033mDJkiUAPP300wwcOHDncxYtWsSmTZuorq7Oe161IPdDrC+92cMPP8yHPvQhOnXqBMCwYcN48MEHOe2003jppZdY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EZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUgREZEIFUiRfXTppZfStWtXhgwZsnPZxIkT6dWrFxUVFVRUVPD444+nmFBE9ocKpMg+uvjii3nyySd3W37dddcxd+5c5s6dy9lnn51CMhHJBRVIkX00cuRIunTpknaMg0asRf6Vr3yFk046iaFDhzJu3Dg2b96cXkDiGe+//34GDx5Mu3btqKurSzHdPxTDe1kMVCBFcuwnP/kJQ4cO5dJLL2XTpk1pxykasRb5mDFjmD9/Pq+++ir9+/fnpptuSildEMs4ZMgQHnzwQUaOHJlSqt0Vw3tZDFQgRXLoyiuv5M9//jNz586lR48efPnLX047UtGItcjPOOMMSktLAfjgBz9IfX19GtF2imUcOHAgAwYMSClRXDG8l8WgNO0AIntTXl5Ox44dKSkpobS0tGC6sWK6deu28+vLL7+csWPHppjm4HL33Xdz3nnnpR3joKD3snVUIKUoPPfccxx33HFpx9irNWvW0KNHDwAeeuihXc4Byb674YYbKC0t5cILL0w7StHTe9l6KpCHqFWrVnHRRRexbt06zIwJEyZwzTXXpB2rqJx//vlMnz6d9evX07t3b77zne8wffp05s6di5lRXl7OnXfemXbMXVx66aVMnTqVrl27Mn/+/LTjtMo999zD1KlTmTZtGmaWdpyipveybVQgD1GlpaX88Ic/pLKyksbGRoYPH86YMWMYNGhQ2tF2Y2acccYZmBlXXHEFEyZMSDsSAPfdd99uyy677LIUkrTexRdfzNVXX81FF12UdpRWefLJJ7n55puZMWMGRx55ZNpxiprey7bTIJ1DVI8ePaisrASgY8eODBw4kNWrV6ecKm7WrFnMmTOHJ554gjvuuIOZM2emHaloFfKlKeef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", + "text/plain": ["
"] + }, + "execution_count": 16, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Run the noisy simulation\n", + "sim_thermal = AerSimulator(noise_model=noise_thermal)\n", + "\n", + "# Transpile circuit for noisy basis gates\n", + "circ_tthermal = transpile(circ, sim_thermal)\n", + "\n", + "# Run and get counts\n", + "result_thermal = sim_thermal.run(circ_tthermal).result()\n", + "counts_thermal = result_thermal.get_counts(0)\n", + "\n", + "# Plot noisy output\n", + "plot_histogram(counts_thermal)" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": { + "ExecuteTime": { + "end_time": "2019-08-19T17:01:16.716582Z", + "start_time": "2019-08-19T17:01:16.709462Z" + } + }, + "outputs": [], + "source": ["import qiskit.tools.jupyter\n", "%qiskit_version_table\n", "%qiskit_copyright\n"] + } + ], + "metadata": { + "title": "Building noise models", + "description": "Building noise models", + "kernelspec": { + "display_name": "Python 3", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.8.11" + }, + "varInspector": { + "cols": { + "lenName": 16, + "lenType": 16, + "lenVar": 40 + }, + "kernels_config": { + "python": { + "delete_cmd_postfix": "", + "delete_cmd_prefix": "del ", + "library": "var_list.py", + "varRefreshCmd": "print(var_dic_list())" + }, + "r": { + "delete_cmd_postfix": ") ", + "delete_cmd_prefix": "rm(", + "library": "var_list.r", + "varRefreshCmd": "cat(var_dic_list()) " + } + }, + "types_to_exclude": [ + "module", + "function", + "builtin_function_or_method", + "instance", + "_Feature" + ], + "window_display": false + }, + "vscode": { + "interpreter": { + "hash": "f8729fd834348017bca17aea688b306f536a675180840f7307eb909fff39c285" + } + } + }, + "nbformat": 4, + "nbformat_minor": 4 +}

vwDdjyi-uguO;6j4yfA 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 q83u)Mpc&A_M_T%h%^Ht9Ro^84vlm( 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 MmRT5Q8@e+8A7+R)4gdfE literal 0 HcmV?d00001 diff --git a/public/images/optimize/stratified.png b/public/images/optimize/stratified.png new file mode 100644 index 0000000000000000000000000000000000000000..f61db7207bbafb6b4a74d0288f6cb95398a8eda9 GIT binary patch literal 12969 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 literal 0 HcmV?d00001 diff --git a/public/images/qiskit-ibm-runtime/noisy-sim-circuit.png b/public/images/qiskit-ibm-runtime/noisy-sim-circuit.png new file mode 100644 index 0000000000000000000000000000000000000000..28d6fad02f134136b64cd11f659bfd429a4822f0 GIT binary patch literal 4868 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 YEqg`(`ZFnDM+#)1Yob$j^TE@<0k>j!4gdfE literal 0 HcmV?d00001 diff --git a/public/images/qiskit-ibm-runtime/noisy-sim-estimator-circuit.png b/public/images/qiskit-ibm-runtime/noisy-sim-estimator-circuit.png new file mode 100644 index 0000000000000000000000000000000000000000..71797512c4b9d0254eca58193b2654ebbf486135 GIT binary patch literal 3135 zcmcImc{CL48XrY!ER#&xCRtl3iiELi>|x518AK#xU%p{zC`>3ByJRGnNOsjQXnZlY zWQjgxjGYq~^Ho+* zQBb}t;Sn6{9|ToY^!fV*1;0Rd#V&bbAN!LN{>F$P0DwpEFN*{48ZXQiN=;yT)}eR? zHPRnEbGB`Dn~{7{hF3)}f){-Gsf_+>&UnM~i9{GYUm2Sa#ZM5plqvy-nle6}Ud27H zGCMOS=&|4W=I3LOlDXH9#cm-Y9h(Vr&)G=&SoG=(Dt1eWNvOwMpiaCJKId+q=d3^>htHoqRxdon<-L+hB}$q zEwdb-<_YRbH_yo(Y41?c8`?Zwhfn<5=jQPfTS4SMq_Mv~x?5RUHBYv@=;-WpU7zjx z{_0w^Yg=NK|Ac-~XR7bejYSNPwl`F=Gnjk4D`4o?b0Qki<<9cY)($dk3i{7H5qWFt<>sE3Z!qPG25Z{=@ zp2<6jo4jb z8M);$$!sflBU}+oCBA>-hr2R=d*A+EI6lNHQ^Y6FGCE;zXd9ajwSL zbg^el9E7TOl;K3XViuv5lKeJ~5Q`jXEiE1I`WF*OAqO!a;ASkp$}nYk_&Dd05fsG- z0MUuSzZ6rg_N77rKp;@~hPUwM=H^J)LfPsS7BACEDA|b>_rvx}L3@@9#04=rRI^DY zG2S(G(cFJpnj-32wk~g2hjQ9ZghA$_hLE3Zzh(d5h zJ|_K%C&XE6di`{ZLlGro{80P6r}K6jy=pusCo-gA)UR6Yx5SN&y|{FFBcP|J=k)Y6 z9Dy(~H3c@uf{N5Lg(l@UC(+g2hMk7Yl}aH~QwkZe$2 zX@n?zeAp$WqLR*Br%i2!A_&R;}3$pFA>|<*GI>;diECvtc-v4RlMFh4_e3x z|2aVaS~>pEokfB-Nvc(fAW`}|>y{##XLyOCeLNb`c{M@v5TYF|mJJoHnw{C_E$|+n zwAQ~XkA#e2O6{tm$Yj`u4<8ilB-&MJ=5z>O!D-$7WhliL&lA6oFEi^d8;sGvDqK)p z9FJa~6=ASp@gC|8*Xgcv2o)slA)b!=emM_LNliTw+ia038Q2jtgEbTgNYvMZ@dCL7 zu3ZGf$Zz2%1)~3^*m%7Q#w+c8>-^{!pJNqiDOBcUFJm#F^NSe#jzk(2R}U;;tTPuc zSrrcX`1rK4uGkZXIx`h(d?@Ze zZ!5d|U@#c&=;%`#K3`l^yFD7tVMh#f!#UO0V+wC&>D$=Y;GDMa6u?gois(c<-k7uR zW$NPD;Z03RX$tDmYFnb#Uy_q^*M=u}i$nG_XuWPX0$ zuEy6fICpblaGfk@Ilj)UJzy>Ts&eH97#J8dthS0JLMj&2w5*dmjY9fk4PKo2Mew13 zboMIu*E$uA20s%B!~KQkFAgGR(R=*RPG0^J+qYv)LahlRH}&<8 zsH>|3G+Ffg2M-=NBL)y-a?{|Rkn$$h#I2^z4A)#Wy|#)sFR|f_1@Ju<*q7m<`Rudq4 zZFuJRrc2l5pt^$E=dkg7Evlc8CVvsmX)jC$RnEutB=2UdD1%)eIFE3+&coqwT_h5T z+ufP02h`c`MH~)7kKx*)FI*7QJ`ncmGY>s=Dr`?QqETlSN+s~#BBdCs5vDe%{vW3{ z@9~?JI*0)Oxs8;6X%9VLPt0mJi)^V2hbA{R#9%hw_sh1}*oP;W4Z=&`Q@7JMCXWxaocagQx zDJ!XsExQY*nzoDT4%XIW%9qe4svXZc#!SN?xZL$d)SCHe(BmLZ`+Ec8m;h;ut;F9<)D}=iSOT@F;03%!oxw zf(~meduXEHuTQmcMBlf&A;afir!;3;aRTdnwf*;}M-f#nTs&tk$JsXmxrigRDAtNi zM@L6Y^RpMsN8Qlu&(*OVf literal 0 HcmV?d00001 diff --git a/public/images/qiskit-ibm-runtime/noisy-sim-estimator-ideal.png b/public/images/qiskit-ibm-runtime/noisy-sim-estimator-ideal.png new file mode 100644 index 0000000000000000000000000000000000000000..e7bc8846ac127fcbde3df9f2168e41f8994166b5 GIT binary patch literal 16352 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 @kr}k9| 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 literal 0 HcmV?d00001 diff --git a/public/images/qiskit-ibm-runtime/noisy-sim-estimator-noisy.png b/public/images/qiskit-ibm-runtime/noisy-sim-estimator-noisy.png new file mode 100644 index 0000000000000000000000000000000000000000..50c4df97ffc1387ac8f9c145180f1ff142332329 GIT binary patch literal 19818 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 literal 0 HcmV?d00001 diff --git a/public/images/qiskit-ibm-runtime/noisy-sim-sampler-noisy.png b/public/images/qiskit-ibm-runtime/noisy-sim-sampler-noisy.png new file mode 100644 index 0000000000000000000000000000000000000000..8acc3151b9a916a2bf5e1872b0742283a95ec9d0 GIT binary patch literal 18322 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

>6~!YI9>_q<7=@|3CeCfWj8 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%0ALiDR{jI4&GE$Q_w|( zRlX81nA-y+Fb0~mP(A`wudNX*^IpvkkdOG~Ffw8;(e0)Tu+w7b>w{()A1UVSQp_3p zlg48XUEcuOe+C2idP-R{!Jvt(7K8J}pO>1Tm%z}(mG|d!x5ZwRp#aQ>SvNsLl@OF1 z({bM1@q4<(#aP^r|KXN&B@7Ee4hwav4$>opDVt1&!xCaGY$`dLjO=HQey|Cle)q?iUluhQ^QOw&BrtbJgy5e@HOBc^%kH_+*Q# z2Fim@?7D>K&2a|O?w@~LW4V*maj=jteYi#a>sQ8v;%jI2`57a{99*polK@oq*Bk^? z4@b)$KwHGrI}U>XVbZa4{fhLUl}#sS(}v-wX3SsT8(1vo6X^msEfaKJ&=5y-_%HYQXBL6!-?Y9Qdc1XDW)W!2B9)F^vobL`K*BFxIHkHsStH=ttsRn? zPW~$t??=`7K03`k^9h3r8<`WSxApV@U#j{+jr7KcOW~Ce*KRgJEf713bG2S_1MIj| zp_X5(W`Cjs(&lW&5o`sEU^~!i*#+PYB&47iKOJP{BU{_^@{sg@5?uoF5Lr@aP4m>) z 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%0Axy|&<^k&_W7MGhp+6#RiO-=}n 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 z%0A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 literal 0 HcmV?d00001 diff --git a/public/images/migration/graph-view1.png b/public/images/migration/graph-view1.png new file mode 100644 index 0000000000000000000000000000000000000000..e41cdb7db927846172b987ac58caf08968ea31dd GIT binary patch literal 14943 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 literal 0 HcmV?d00001 diff --git a/public/images/migration/hummingbird.svg b/public/images/migration/hummingbird.svg new file mode 100644 index 0000000000..7adc77c554 --- /dev/null +++ b/public/images/migration/hummingbird.svg @@ -0,0 +1,16 @@ + + + + + + + + + + + + + + + + diff --git a/public/images/migration/leaving1.png b/public/images/migration/leaving1.png new file mode 100644 index 0000000000000000000000000000000000000000..bb90e9a75a3020cd2b5492aa74d74ee5de4d7485 GIT binary patch literal 52121 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 + + + + + + + + + + + + diff --git a/public/images/migration/overflow-menu--vertical.png b/public/images/migration/overflow-menu--vertical.png new file mode 100644 index 0000000000000000000000000000000000000000..421f040ed949c4a9482517393ee68023d4d0c05e GIT binary patch literal 1864 zcmb7FO>7%Q6y8#il+p^Sq$)xc8a5Ilg8lV+*Sm_FCbp?9bwiX`s)>ZecxG&`;@#Qo zZely~fs`IXgdhzZ_`4MmAyr5mkdQbKfy4!bIB+C~f>e%GZn>3N|208LTP&@2cIKP! zz4y&~Z{D4qxpMaO^QSqEJ6p(S=h*vc_FOnM#Qt}``}Sw{ddkng5wiJ__&LFS`uTGl zH#F}QOHs+bY9Z>15YsXdo378$95*r9^dVX#5h#N! z)qu>e&J@w=A~G>Qc?nE3Ek@vy2!f_t_d=_g<~zI=8^_ZU4?2)&G0jiK20_W51sNI; zkQ8+RDVholQ&e=>RJB)uDl3L08sB&(9D3Jf8HEiZyi!3)Rw3|SJQ!0{u8dLU+mWx5=tdFE+11lJ$X zdSOo{CYaQOzNCn998w2}(E#T!2lb9|j3iPgF7cv}VU+>auhEExHF^y7VEK>%CarA` zY#ix}>kdqWQEr8W(G%oIbXaWpM4BTZT@Db*tuQyo;%Iy;6A&2Dph#)Ge^9f1mq8{2 zUcTmdm^Q-k18|as5lQo^tSW+R2&z_8RZG<^O%>#%CCgo?O|esH9R*FumYg~SWeI~} z1Rn{;$g0r5g)Cghg;gT?UX=#}5v>fZ(|{Rf-X#vs7c!aIfL5G3TL|Z_OoKu$qbsJa z3#zDe+_i11;Dr(N5GiESJd;Lr9Bi3p$}p3d2iU|^zG6a(QD();_f z6fMUI5by8S0;Y&@Ja8|W#8@$nq`>wi1dKFYNF^0RNMRir2C2xpR_U|79yqKVVf`R$ z>=kB=P*u!w!cZ86!D>m@pir*p2|*#M#$1$TLq&1Yck;-}J0UyaRHzfmKM^dVW&wI0$+)PMn*sxs{!k%Q8)u2XM?1P7e= zVE|blB0-quD*<%@^!>VnU>vEm;^AI-56%We6g)_&W9@`+<>3N7Ucz)EKT4oOwekN2 z>Pe4k(5n*G!zDfrMT)y!_u!@f=0s=hKxgd3S-XvggFeqb1~&!q7;rq_z%7;y|8}o?LWA^1#ov~yE#&P@l4~+eEXEW zceTB-dvo;CaQS?DW9stB^;>JD8=J$*&d&JzPyCg;TrcF8&Mo}j`g^{8(cYVAZ*1Qh z|Lv#kkI%3F!|f%2cyap9uS52Q_il{7!tK3T%ikXRXy5p7YyX+8t^M82(d$1he6l&b bbl2mwKYtVjll^-7t?T~+x;|JT literal 0 HcmV?d00001 diff --git a/public/images/migration/overflow-menu.png b/public/images/migration/overflow-menu.png new file mode 100644 index 0000000000000000000000000000000000000000..bbbb6f0e75c9f9b0fd72f13200a94f028a8099c8 GIT binary patch literal 1937 zcmb_dO=uid9N%CY+tNstNP`#0iC+chb7$wvj%&KRCR^P!rVCAD559TxW_QTWym4ld z-9){J&{kU{BBCH3M8Qk7If!7jQi zSW;w0Gk8fA4Ow}Jkwr-pL`{&goG6*1YGw_l`(r^{$NF8EFXG1 zi|_YU#7Suh+~@{mAUdutheVhqFDJ_AS-c; z1rBY-`!>Ky5hcW8Wl@$mG0VwHRZ>g|a;9@)&J@KCv_c)vT^brT>zqW4tc{30eW7@@HBAhmX#o{#k#9_N+Z$JcY%!7{DW}Sf0Yt%&t7E?EAqKHh?AX?X{ zI$-Tx@j-^mvZ=r{>J;>UH@q8C zTt`8Tz%&)un|I~Ls&MNZY-+gw%M~FVp`F?i{#|zMyA9(OlGrA}3{Q{!;2Kli7UUW z;=}omf3(KN_B?R3bo|UmZ{*Ki{NeG1)2F1}f1mvs-}~aD2loy0FI}AfX8zmHORIaY z9(?!D?@x@sH+o?{8$P-I?D<2x_m;jI`{gZs`JJy{e*V5!V|RV^wF{r!c5L*d^y`je jqi@E4)H3-ipA4NEI{xA7&$TAgrCBab7e6@g^b7w0@U3wz literal 0 HcmV?d00001 diff --git a/public/images/migration/providers1.jpg b/public/images/migration/providers1.jpg new file mode 100644 index 0000000000000000000000000000000000000000..6f6f36dbd4b55a69b88e3bc560c7a8c8e2d3f853 GIT binary patch literal 252975 zcmeFZ2{c^m)-GJOh=hpfgM_`Ki$0A$qIMz(HWftQRKylRM08OoRcVCiVn>@0D%y%Z znj+c?rP&Cgk6x9Co+_d&s=I5Sd;ar}yT7yV|BZ9LasP3@fq^krS*vQ!HQ)Kn`ON2C ztS_uN$O#ieV?zkr4{VU%z;6g^5~2@b`!~P-xX8bG2{ty?M+o1MLwZMt+1dCYKk%`! z^RcnoAd(OW8^`~=HstSLY(KCc;yBEC zd>s5goxgHez`~XDjGy3z$1k&wNL{UH5waX0OJBV0|Kuo_u*gYKF&SC8v+@dR>Kd9_ z+B*8z3=EB~8=F|&w6?Levv+X&)%}jgT~Duoz@Uf0h>*~y5ziu{o=3+dCMBn&roDQd zo|BuGUx0mASX5b6jjO5sP*>kdXlw82{JpDtaAZ9M(((#rYy0~S zbr;y%|HCde2>U-=_CF2#lU<+_*nT*4i2V@fA9k_*5DfmX^Bv;&>HJ~-D;AutegbDM zJU$|L^<{QN%TcL|mSmyZ{sUaX(rQE*${(iv&9eWTVNd=g%l={5|7+I-yvr@eQTZ6Q-^F@345f3xOvpAML?ml5`_^UPxzXvDn6{*fJnhCRp;EAmj$y&m55d(my^+I@D|; z4Nz4olZofQ=^Y#NaO-~dG2P$q#Qr3G>@}C&{rLBkN}b~4r%>#?uWn?DeJ9G!%b4ey zW+hMTdK`63*LdioEL|=tn*mz}V6hibe7*0-Q|)8hEU;YP^W$1t^O{Q&2py&qM2ebr zib7G~RPIr;fPsv72P>>4-y2j{d1u1+h<|n6?Uj>u+owGUp#$XpNEdF$3`fMB;T=&Q zQhmDiMvg#>w+~ON@x5&2Un5Dzzs9&pnZGRRI1`|`?jnH*OI@`0rOpJ4;g)PmZL+vI z&8wHJG8F^@i^fVVYWlOzRgM3f2AkW4qn#@RFdM*OZf}~jQ!|3{YM_7<-Ip(ibXr}LF$+amF`W_3? zor2!Gg>GF1GFT9OO{PU76g*Z0C5e)a7)PPoGT`BD1p3Y#ezBiBL3Sr7$l@Wsb02zNQjmvL-%&ydW5 zfJfi4AkRHoB)?0uAfHlwS&&{LBjX7Rf`RT?ma`yAynr)W0KEiS)U6o>Ue4O+fAu%- zfx8dfeGuIT$>boJ9OUl*R!|vLMLz>Hl_HYtVaI@1lhaevSNt?G3kip8s=CxmV1DYj z;S)*^%fu$M-D9r*^ep#W)zqYcSu>jniPH&Y<{AU3#U*>yWY)TFgI`2_vylZpeM~sGw$}_8*zV|Bx9}G5M>85jm>an zZ)mX_qz%{&~)E?#no zP@(i=y{T|+HK>@`+ZBy|aph4=acRmzv5&|Jqb5yAn8?}~3&L@f5skjb{aS5vyq1~{ zz$jMm7{%Dvx{|p-qOxY^!1#o`cjgtQBoK31yrZY!>f5Rnk1Jvb2&Vdt7=(7_e?#va zgYp9y0*d>yI$8+mY}1j9pew(%>n~iLk)f!Rx@O-Mlg+r-uo1)qw;NGW4qVshnAQu~ z*i> zRTOclC3H7J?)j_9o-7{!>#~;df-fo!?byGI&jqiGlX9@qZWX@5^%3Zox0*woKiLCLG1>w0&f=8pPHQTvM^*AZI`$nIhN!z(}>?TDrR#j$XbVm8-yY;*i(u3KMJrO1s*!CQ5w?m#L zcNEgVUZh18C5^NtkF`T11`;He;T-DF6V6`EQo|~Z+VUfMV`M9mO=@6*$P!9z&}Y4Q z>@5QApeK!|NMOY#mYd}URkOOg*VuOim^?e6&0q#*a>>#304#B~^RnT@CN+nVDXu?+ z^eZXF)x4H#+hq67*`IAi^OYo%~9`|R|A)Uz$L~Q&{`BU_J$(C^QNejt)kxURo z;H`cx&dU>$FLYr9^zM)z0aF!wy*LMOrHMD5L#xYX2I z)ahYM>FYW5i9odb8+J05x(WKxnK_In|BOEcgfY3;z<2_Hg?Y39U2qU-2z!t4Af>fpPI_G()5kdZ@U{*vOUTrJ_Q@TpUPr-sf#gT% zyKpjWb5gZMvUYYYg&a%GCSR^xJ^|1SvUr66i!z&)#TMuZ-AiG5&*srbow~0D7z?MB zf0^#eb(w1MR;eO3l#0L|?R<9Zgdgek9I(TXx4e<7)NOk0f57|y8s3#4IKU1k(bMhkvNa(7RyX8EJ+PKjEi}(Nj>yrC(?p_$1zxKf94B zjGueFk4hu4Ab_e7T@ceg%lDJ%Y>e0`N!)#0j%@i4#$oxZI_2vI#CYBgvC`)a{LXeO zH5y_`KroVD>HX3^wG>;YvCFRvK?hbtZg7%u;93f=9cnzyf^dRazvYUqJo#gb=bY$$ zupG-&p_vUxXselqpXr}Zd!{ZuL^MTzzpE6OAT((|Zr6EY(rv-WmG6kN9Xl=muc9A% zi3OP}ok(rUL${oV`YLYn;JUqHY05~~8c*dzSx5(v*?GF7$a~_Kcy6VaB|02^SfwgO zwnNvqHLQ=kFLl%>5+K8$P!fPIxs-k} z$H^%tHd?J$6E<3g^U;}jcz1mhX;f+ku?o@n8CvK70kBLi;~a!(8@TKfCWDPB!w$%1 zku<6muoG0MQ9y3@_LhB3?rE#f%6M0@&D@yTHXXUQ7No4P%5X2s_4M}R-OPRQ2+D?@ z``l#Z{DBdT_cW7T345)3sen0r(fRIxagvX3;R>3oS+cCY=2HMJ?+HOa5s}7KV(FZ{ z`0y6*>ec^Eo%ydu_5XF}>4}$5_HRx7RRQvE+QVC?NMUDO|MS}U&%T@9ApqE`222)(%SNb>XS8raHk?1I;KWezrT3^W>`X~ux~ zoLpSNkg^;FMt~=THbQxDaBi^;Sn2X+ zL5|*OAngs#nou&SN#YvWIf&p^p0eeM6uJ$?d%q^>w!O-u^XRz=G$6;>wmH5?+-&Ea zjHSLBr0W+T!x_asIZp}cusDM$m-7R9Ler~8?GxDNjn+K#u}ffS63`AGN69o+jhP8>>1||2%d&3j%d#K@#An@N*NqlQa@$ZIyNn zfVItBV*G|uU#Za?Wy%khI`&gUo>s@wR^c2-f51;Lu`_oDkzp{1Gp?45(K}>X?EU(_ z08PVm^U^hP)ASPO&iY(ApezZNVVzmWVdBe@wa|~JRZYC1HO(3G@RLSlTF1G!@p%Zz zk0`CD1g4sI+e8=jdZ4^V>d(bLn0>qE#J&dx-jhyr%Y!)vJ}?6YdXz38b%oO3eiIlc zi9}cX^R{RF!tb0o|g5zb*NU1*z&Crq)NbiT*l_I)ii{EpfjvzJeEOyi=3p zO&Py_vRxySn0cY|Dp@Zj_=l_YFH(r!%I0^UO|SQy<6ORc(A;uBkecvX%)*C%vHARq z?&2QUuXRzJ0g!#%9$p<(fAD>7UUf>1wM)bE1@pFMD(=jA9-zi zrE+#x0lF)|f|w8MRyMC~{Hr(H)JgfJbM z9xW5_$GZA?F0D27SqY_%z_)L_yektyQzDAK;n-Q3_Gq_H*P`Z6vv)8LGu}eoH{6+2bnG%&PuY`FMeG}j(=$vy+rZ9Y%O{8)_YiKH- zq{<6qwASz2%{1CHOOXq5^Hv{H(<(cC-gRz<&^=JoQAya=h1LX&UsVR@3uJ~J$ zPtfFR{a+?6edMSYflQk84AO$alkO>&5bwswZI+6m)QxswHjn6)7+*{-pUZv(4V5_9}DOoOW|K#LjMfi4xU{kwh4gRG)oIH+3IFikB}p|2UMmaVmsrDlhI)1KyyuOaUX3{XRcO~-z@Tp&@Z^ZEYN_eIf;)xasoDrc(^$!~fd$=_aU$joiu z!;7Ypa)spd#iNR&iioO_e(`qgef+eG@kEvQOvb$s;$PuCqH~>%c7^^UBMl`4q|F<3 zLdBMw4*_9BJ2xMFTfD%Olk?0}MFMOf&`hCQF&^eThBNMbS+F!=T{^Ne85J0ze{8G0 zKf3L6%Rna5z`#6NGijuT8fV#%oYgI_(eEhz`?mR+Pw)54VG)IKowpso=5rgKj|j^2 z8j+nhj~DZvDYVJUJyI;YF^K*IO@PiVopyAg80P1pdNCD7&yl`FhWbMKW#0~zMsq@& z=7hiQ@3q0GV`QTUFc z^ek97`a`qd!;M03J{VqEq&w?#y5txSw7UMdbT!v_t5YPd{YJ_ioQ<6W>`r;b&f*#< zQsCrA^<%2>ZD#CqW1Y|_o$|F#ib&f;5h9E*QBX{ZMGMo_N09nz6%*rkC!(Td2at+I z2z~1j-`8tv>pM-yozE!Z&-Bf=-TwAX`u-X|n*61{BKvtBImJW8u2x;gGPPR;`Tjw2 zRe)VE0efsQPOQ`{@*mn^hN26cyzved+|2PKm}JPo=XdF5!HyrCIIe zGeGKfZUOoP%7MCo=qIMN_&ydJTbCoEA#Cm>$(VX*TQQmg;V|!1J1p|cNG^Fz|D($V zA2)&yDmMVTd=Am<*n0^!it~<^8YtaVs~yC}yM3j+v5g{(6`Jx!rm6^jPq{mCbM9*< zMs;H);EF~LHZWgqqoB@Rb?NwNGN)#5Wr?h7hKE|^F+P*{4(ubZ+e-hoWP61pw2aHf(7BKnb<(tchHqpj**mHt|;9L5P6m#QM~hxI3sj(e^e~%%uM@e zo7PsCxhc&)z%gSQuRt?t=uiABnErz-()(K8#=G<5pW2%LG>rrZ%){x)vjXTTaTdga zp@1);U;G2=L7_-}8ncwLIO2}qxQX77V`jb!aStD#`VX0vGlm|{$kF3r_RR9CpcIk8 zloAOxGDksi{!*I6Pag*824$TRg(cnOmirmlQuUiH=>x@`t8V*bKT+KA5^t@ru~@~fAZ2Z)+~-UN zo%b1@NX3v%H}`eoYS7L8zC+oHPa zx%T<&XK#L7?!IsOdOZK`bg61s1GXRwyK0zFH11t*o>sbCsXOto3Ty9G!{2qRX3Nz5 zoufgpx71|c%YODo0mI&719=ta<59E#Z zI&GM#rH>bv8{Qo`_V*zDx=7i4T-s>H`J@c#NxXy>b&BxzJqjZ!OQ;GsDWz@(i(h%$ zg{UvdUUy4eIQFnaY+Azolh>znh>{B>@B0O=+?E(V?d4Tf|IH?Ep^q`VkoVB`OV-`l zv~=Cso*)#>w_?<0;qMiMI_T6kEqu zNz?4>1k2CjRurSBf#GaHC-#GeHO|$P94__$v1ZU=pS0B{&-6+-`QV$>MP>)~wZR?K zOo8}H$^)QVfcm|zZaH9#FqGfFVQdh`uI&_{HtPL&PM6oW^C5Xf zLpkpQ-vf;XFmG!)uKRY#%MM--6a8b;1BaT-Z@%tTa*IvUy9B$hR{2{kF)|*cNJ!LdBJ96 zNRL+jm9X%?a(BFK34jVGT_}~nJo=cXcNar`GQO-Q!zgIhG%Z_#9;RO|R!S3tMJlOz zYe9*!Kq)EgS{xxP4=|a(IiM7X;hl1tFeaf-tWaNGQwj8uY}>MXguaBS45o|k(C(mH zU`qEu3Kj#%!`ClSxIb3WZEy+g5+})hg|}u@fu14&ZF^Vc`?`@u#h6O<<`Mdj{z$eu3>@JO{%7R=M){M;7u93Iqc7$asyfW)*!FxV zX;hFPe)0<4Qa#JBD@W;^v+Xd0&F`+cli-4O4u~O`&co6iy2hxwc->3KR`^N1lcps= zR?o*QnbEad-m08*TXF~X^3YT#_3Vz19%-E}U-$^^Cs|Ru?noY^PBGF^0?Z-&(S=N; z6vc>8T$m}bZznTCmm`UD7spGrqmGT4)tv+VgRp9QD3%o+rUYH8?dVk(Kb&UXSe|PmABSm?dODUQpL7kDs*d2tsr@+m|sMh-M z*O|ZAXzs_?%jP~{`wshOH*B6B1l}87Vd%z6N2lAx!2);zNavD%6UnJ40x z1$KqBdf~_Jr{W8)>l(3N<9&4|!#8zKk{{JGThqS|+IQ$E<2_xK2DaKQKhyO| zydarb(HUD-qBhHkXk|fej(}6X&7%l~ZHuSZhnR{;L5fO+_^L)0Ke;VljD8h>`Va7M zeStf9ItabM`C(^(ICk17uD+(Jrnaf_!;_7^jU#2HD(mhqNE0g)B=uD8*btIO%w5^& z!Rz_)6WUVlfp=^UJ%asJas5wL>wnAMiH)uT-hodp>XbW$G;gFPS$#96WJi?)fXzXp zaK5~N6>P+(%qSAaf(QWE_E~b`w0G!DOZAQn63_kq>*O`!<{20ccsNVgnn;D|Jkm-4 zG;t_UJU}o(+J&F+G9q3FOm$J0r={nAh6_TY)ilXcuOedaGo@*|F7jsT)6$6Vwv-cl zx@~f+2%||xFkesa4!RicjhCxlOsL#itgT*PZfetazek6__p6c>m_0N{nv1GxWx}Xl z(fg6n%PvzrJfFxfip=DkU2ChL$;UpZ8ygD3|A)T&P=gWn#ndx(u_52#?cvsh*bTVfvrzxZW z&^udd#h1{s@Hr*h%ikMYQ?6;QVp=ZEztB9jwSl%n@TC$j+!r93Uu?6WzKT+EKWj4E zXn)`8S>y$rj+N&Y!$Uw`p-8?^SNZV9Tq3ia1-X+jo-o(HmPF1VKsoh}AXJUW3D4-4 z3%*QDPmSA65K4h6>zbPD_vu#iJPv0Qx7#G7NAmfd;a;H;RoBJfRSvOXCzVTGX}Yrf zkz8?SU6(sf#28nnseMhYdQ+Rc(BL~@Z!g*FbfrzZR^S^VZcM9vr2V$y@S9xGKJyo1 z$$3)`zBrhD_)HkIiIZ=U!K&32EXa}j*FmEFP%tA6>^t7-X#;)~kxuvoo`>#EG`l7D z0%=YD)@l5nqS_8+SB{@(C-Q_@G(HK_QeDGYVVyl)R2v3yO;%=uw?_ic`h0RoN%2g3GAy{e{t>u-N=TP?a&fvH5j)^J~aPnaa$D z?W_F&6oFTc8}DXluDjla_u%a5mEFsmPMHi2t=T}TNT_P`oi#c!Z}u%De-4M}3X#w+xJj5O zCLh2~P9R>(QmsUvG%L45^xvT1qmlM{h3^1@wT{Ts>;a_qDGk)AAxWzdb=V2}WskMd z+BC6mQCosqWhL)yQk>MaN!rW$JcbE6i{GqI8~4^~`x8>dt~l4p`;I4k zQKZs<1Q27@fC`!oY65*66t(3*pXptoe0P|6H6u#tkNU9&@SDSP07h-|ZBf@Lakb1d zBfjM-xOi_foSA~0v&%;7r0L*2+2Njc&4$!(*4}f9Zs)(J3VazZ{8Xo4I9xasvA5^t zV(HUu>`yn75enGKQkyF|Y~3E>!Sf(h4|_tl=jf9_uW&a`=N`$}cG7zm#FqNOnoBVI z$Y8#u%SgGqXm`GS(L-+vxZOa~4IBuaV^r$;%>OZV@H0sy9iDL&fh zOp^bU`|!>FMwRcpF9(8~5L!^^mGF+2bE1cI+NN)OB+ahriELe38*{d|VnhM$eoIP0 zZTij1Rjaf#wG@-Uxrwot0cy=dQw$^KPm)nniV>~oa=N2Uq(^L&?gQW#gHy^JKC_f{QZrvzpz_8H@<@+y}`MjXpHPaa23lLfybT9>r9lJDWT#hQRsG z<%a}wifZI{Ww#Eo>WAnrdi)gCr$}qR60a<=VWf@9nKXigR5e8y`__AGjH+|b#=+8Q z+<7KwVd{!af&8tDx;m|-Ux!_#u}8Y^Prc97uG7+^Z5zn^MehtwNm*0XCz?QdKadaOJEo~<7sH=z-gNS6(5V%zzH_uBCO10` zi8KN|8ieZA;{?XZ_?DR?lx93B;RQ+zun)-t=hlk@>)*qDKSBkNj(+bPd3n9|l{cx$ zw#`R|*0V268+%h78+xgm@=vZe9oxQ8oI;c*ogKnjTD4t`jW@q3X^TvUjR=S{yCc0Xo;cF%%xl&>k`p3RJtSh;h{p@R zyrqQpYW(nO%R&D)&im|qN-n%S(Qn*DNAtxJ<9xf{)GOAkuZ(Y>a!mS6WXkkaI;lJ0 z-tXPftKm;^pl40w$*Uz7g=w{(>MvJ1)0oih17&gzQ3`gM+){FMfskf#x+?5hA*mPk zvxJTv-3E#Bxu{yW7A#P@F&zZxAcIHb~Pi)VwmAe~# z+5SL-p(n;&r+pU}@E2+cwOQC@b=?cyu0+fE+466y7Z6@SOe|7!xDNZKQ`u{VFu7G^ zNyT*Ft5`Nc!FXQY*9LZCl*j7q)BK24In#0*^K>OE`l_WkR0-D49Q1I z4=L$d5SKP}m5FG6vm)U3mky@-SWxu$dD+0?gzwtA6Lm8_&m-hg-8b@O%#Y`XSQcva zl`8~E8OV2#BQ`nc#>VB9-}Q#riRh@;dQyDP=27P(dCz63G(HG%Rw8gbD}44bEcCY) z>rX2%UT1u@^XAF7;1YisXo9UW)Dn=DDuuyf3e3YH(=dMEDH8WMZWz-S+vb@~E=v z3?EIa<*usTgc35M-Xc53#QgZFZlP1E{l|@GZmt-}DQX)V%Oh3fp(1VgBZcHtXV~)( zXi2!*?^vDl<;RRF3ZJ(S_;cQW$&Vov1)fKk?8u0j_+^{i%(slh&0AW7@|mkU-xrD4 zZ<2JOa-!UNKBb>(GS)1FYS-zHQri>)<{gF_&r?**hjD7;*=XG>tC|PjD_-c`FqJOTkbhgH@ z8y+9-4ts4dJDs+K61{_zOY&1c)f4M^Tfy~xVA1Uh`^n4oK&WVnpBs|EYpDf3s~RIXhOTHR`P z_%JbGJX%M(fj1^nx&k1G?r1^n>~ft9JDjaz8y9+yJ(-g=c2H-eW;t zK)3v=d}$or=pDyMsE^_j@9$6katZ~C)c*fhh_C@*@6E{tZcNjngLId>FVTaUsk*ui z6NY~Mt(XOI1tb|N9+~OrdQG)s{sW7?d#2~@NjnfWZ=4&8<~!O@JyQ6oW%GyMSp zn$JE?@wAS2a=VA5x~DKa#H05&Yf5*fIuf82pZo&lnH!NRDQC9^^UWm|v_KxpHpypu z?!BGE7YAzv%WrS$HuhE&C-O+uaf9PBIdm8}gs8=k&EVt3R2jgV>@mN&hRXpGi01id zip|)^(DJBKq|ZDrzdiT3u6j8Ff0g1ATa0LM7(>Exy+h4rBg&*aYR2MABB`Tcj*gdN zrIco&BpBzfQ<_hEs+tC$pTt3q?Tht+vk}ds zCxLC_#vk((4#h;P_w%plNe?xPnU+m12aBa9-QFw%BCqfC3{Y3EyVf**NSxuTRMg+k zVvq53)lyU;{W3e*t0XM2>Yr2{yX; z6XW-7dpX(38%<@Y<<4VE{tlaT;Z-URxgXqt2BG_nAsy$vxuMbhBn`4H0S#PpYXY!E zo=jniNZh)WX+^=m`&^$a5CN<1{<91W!3ZHfo6vCXQxOj2rdmU;5;j z<^V9OA=0oLyiKqoWzO3){!Xu=>2_{0?EmM7WT7u}yQzPsY;@qr=+^ z8N{T@cze}v7BO%cdAZ#@R0Zny*_zF@WtuNSV!H#pOO4))4{G+M>qvW|@}1uAFmd3* z7WtRahfHZQeanQbk4)XJ!4!Lr>7+g@6c77Q&9GSsQ~XlO-29RBOK$Xo!L|iEjQ83^ ze5jDr8b!;~gkFS`oiwpQru?{Q@-Q*t>%4TsyW8@&-Fi)IYuklO&*Ihh)C2b~^Ty)m z3P6=RT>vvzp3r>Q4vb&6S<-Htx_3C-4uHRFArBEynmWp5uZx#$#zq~U&D54JdC+uL zt?H{j=*V&64X~P^jlqy51>@& z_YzF%5=S>XB-lP9wcX}2Ub}j{upS74iXgB*kKiI+{HmZ@`dx5fgCrkNuo6t&c!56m z3F%0DBYYg9)*VuN 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%0DoFBf0H_*y$HLn2qa84_2i4v{d9$rq?xZEV{JAM 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