iN5SrSSKJr SSKJr SSKJrJr SSKr SSK J r SS K J r \(a SS KJr SS KJr SSS jjrSSS jjrSSSjjrSSSjjrSSjrSSjrg)z>Functions to visualize :class:`~.EstimatorPubResult` ZNE data.) annotations)product)Sequence TYPE_CHECKINGN) plotly_module)EstimatorPubResult)Figure)Scatterc [S5Rn [S5Rn [UR5n Uc;[ SUR R56V s/sH o(dM U PM nn Uc)UVs/sHnS[U5S:waUOUS3PM nn[X5 U SnU SnU S nU "U [R"SS[U555n[[U5U5unnU "U(aUOUU[U5-S US 9n[5n[U5GHfunn [UU5unnUS-nUS-nUR R U nUR#[%UUUR R&U UUS S 9UUS9 UR)UU[R*"U5U- [R,"U5U-/S9 [U5HunnUR R.U UnUR R0U Un[3UU:5(d[3[5U5U:5(aMoUR7[9UUUUUUUUUU;5UUS9 UR;U5 M GMi UR=UUSSS9 UR?S SS S SS9 UR)S SS S SS9 U$s sn fs snf)aJPlot the zero noise extrapolation data in an :class:`~.EstimatorPubResult`. This function generates a subfigure for each estimated expectation value. Args: result: An :class:`~.EstimatorPubResult`. indices: The indices of the expectation values to include in the plot. If ``None``, includes all values. See :class:`~.ZneOptions` for information on the indexing scheme. names: The names to assign to the expectation values. If ``None``, the names correspond to the indices. num_stds: The number of standard deviations to include around each fit. max_mag: The maximum magnitude of expectation values to include. If ``evs_extrapolated`` has a greater magnitude than this value, the expectation value is omitted from the plot. max_std: The maximum standard deviation to include. If ``stds_extrapolated`` is greater than this value for an expectation value and extrapolator, the fit is omitted from the plot. height: The height of the plot in pixels. width: The width of the plot in pixels. num_cols: The maximum number of columns in the figure. colorscale: The colorscale to use. Returns: A plotly figure. Raises: ValueError: If ``result`` does not contain zero noise extrapolation data. ValueError: If the length of ``names`` is not equal to the length of ``indices``. .colors .subplotsc38# UHn[U5v M g7fNrange.0ss c/home/james-whalen/.local/lib/python3.13/site-packages/qiskit_ibm_runtime/visualization/draw_zne.py draw_zne_evs..I+P>OE!HH>Oevs_rr noise_factorsextrapolated_noise_factors extrapolatorsT)colsrows shared_xaxessubplot_titlesblack)namecolor)colrow)r'r(r)r r!whiterightheightwidth plot_bgcolorhoverlabel_alignoutside lightgreymirrorticksshowline linecolor gridcolor) rsample_colorscale make_subplots_validate_metadatametadatardatashapelen_validate_namesnplinspacedivmodboolset enumerateevs_noise_factors add_trace_scatter_tracestds_noise_factors update_yaxesminmaxevs_extrapolatedstds_extrapolatedanyabs add_traces_line_fill_traceadd update_layout update_xaxes)resultindicesnamesnum_stdsmax_magmax_stdr,r-num_cols colorscaler8r9 zne_metadataidxore_noise_factorsrcolorsdivmodfigmodelsir'r(evsidx_mmodelstdss r draw_zne_evsrlsN&i0BB!+.<O>O+P"QY"Q3UX3"QY }>EFg4SVq[ad34gFG# 1M"#?@O 1M z2;;q!S=O+P QFc'lH-HC X#C$s)O$_d CUFG$3!X&SAgAgkk++C0  ..s31X     Sc"&&+2GPSW^I^1_`%m4LE5++..s3E:C;;005e""c#c(W*<&=&= NN #5M'    JJu '5#%L    J_ZGs( K6K#K!c 2[S5Rn [S5Rn [UR5n Uc;[ SUR R56V s/sH o(dM U PM nn Uc)UV s/sHn S[U 5S:waU OU S3PM nn [X5 U SnU SnU S nU "U[R"SS[U555nU "[U5US 9n[U5Hunn S nUUn[U5HunnUR RU UnUR RU Un[UU:5(d[[!U5U:5(aMoUR#[%UUR R&U UR R(U UUUUU5/[+UUUUUUUS 9QSUS-S 9 SnM M UR-UUSSS9 UR/S SS SSS9 UR1[R2"UR R&5U- [R4"UR R&5U-/S SS SSS9 U$s sn fs sn f)aPlot the zero noise extrapolation data in an :class:`~.EstimatorPubResult`. This function generates a subfigure for each extrapolator. Args: result: An :class:`~.EstimatorPubResult`. indices: The indices of the expectation values to include in the plot. If ``None``, includes all values. See :class:`~.ZneOptions` for information on the indexing scheme. names: The names to assign to the expectation values. If ``None``, the names correspond to the indices. num_stds: The number of standard deviations to include around each fit. max_mag: The maximum magnitude of expectation values to include. If ``evs_extrapolated`` has a greater magnitude than this value, the expectation value is omitted from the plot. max_std: The maximum standard deviation to include. If ``stds_extrapolated`` is greater than this value for an expectation value and extrapolator, the fit is omitted from the plot. height: The height of the plot in pixels. width: The width of the plot in pixels. colorscale: The colorscale to use. Returns: A plotly figure. Raises: ValueError: If ``result`` does not contain zero noise extrapolation data. ValueError: If the length of ``names`` is not equal to the length of ``indices``. rrc38# UHn[U5v M g7frrrs rr)draw_zne_extrapolators..rrrrrrrr)r r#T)r% legend_groupr&)r!r Fr)r*r+r0r$r1r2)rr3r4r5r6r7)rr8r9r:r;rr<r=r>r?r@rArErMrNrOrPrQrHrFrIrRrTrUrJrKrL)rVrWrXrYrZr[r,r-r]r8r9r^r_r`rrarrbrerg show_legendr&ri extrapolatorrhrks rdraw_zne_extrapolatorsrssJ&i0BB!+.<O>O+P"QY"Q3UX3"QY }>EFg4SVq[ad34gFG# 1M"#?@O 1M z2;;q!S\+J KF S/ NCG$3 q #,]#; E<++..s3E:C;;005e""c#c(W*<&=&= NN"% 55c: 66s;a#&' )%&#(QY-  0 K;$<%D   FF6;;00 1G ; FF6;;00 1G ;   JUZGs( J6J#Jc ^^^^^^ [S5m SU-S-nUS- nT RTTTUSST0UTUS9 /UU UUUU4Sj[S US -55Q$) aReturn a list of traces for a line plot with a standard deviation fill. Args: x_values: The values for the x-axis. y_values: The values for the y-axis. stds: The standard deviation for the ``y_values``. num_stds: The number of standard deviations to include around the line plot. name: The name of this trace. legend_group: The legend group that this trace belongs to. color: The color of the fill around the line. show_legend: Whether to show this trace on a figure. Returns: A list of traces. .graph_objectszextrapolator: z-
noise_factor: %{x}
ev_extrap: %{y:.4f}z)
std: %{customdata:.4f}linesr&) xy customdatar%modeline hovertemplate legendgroup showlegendc 3># UHXnTRTTSSS2-TUT--R5TUT-- R5SSS2-STSS0STSSS9 v MZ g7f) Ntoselfr&zrgba(255,255,255,0)皙?skipF) rwrxfill fillcolorr{opacityr} hoverinfor~)r tolist)rrgr&gorprkx_valuesy_valuess rr#_line_fill_trace..:s , JJXdd^+a$h&..0Hq4x4G3O3O3QRVTVRV3WW45(    ,sA A#r)rr r) rrrkrYr%rpr&rqr|rs ``` `` @rrRrRs2 ' (B$t+.]]M@@M 5!'$"    1hl+  c N[S5nURUUSU0USSU0SUUS9 $)aReturn a trace for a scatter plot with error bars. Args: x_values: The values for the x-axis. y_values: The values for the y-axis. stds: The standard deviation for the ``y_values``. name: The name of this trace. legend_group: The legend group that this trace belongs to. color: The color of the markers. show_legend: Whether to show this trace on a legend. Returns: A trace containing a scatter plot. ruarraymarkersr&zOnoise_factor: %{x}
ev: %{y:.4f}
std: %{error_y.array:.4f}) rwrxerror_yr%rzmarkerr|r}r~)rr )rrrkr%rpr&rqrs rrHrHKsI. ' (B ::  $  g    rc|[U5[U5:wa$[S[U5S[U5S35eg)zValidate that the indices and names provided are compatible. Raises: ValueError: If the indices and names are different lengths. zLength of names z' is not equal to the length of indices .N)r> ValueError)rWrXs rr?r?psF  7|s5z!s5zl*QRUV]R^Q__` a  "rcURS5=n(d [S5eURS5=n(d [S5eU$)zValidate that the metadata contains ZNE metadata and return it. Raises: ValueError: If metadata does not contain ZNE metadata. Returns: The ZNE metadata. resiliencezeResult does not contain resilience metadata. Enable ZNE options on an estimator to use this function.znezZResult does not contain ZNE data. Enable ZNE options on an estimator to use this function.)getr)r;rr^s rr:r:|sX#,,|4 4J 4   'NN51 1L 1 h   r) NNr rAggrnyl)rVr rW Sequence[tuple[int, ...]] | NonerXSequence[str] | NonerYintrZfloatr[rr,rr-rr\rr]strreturn PlotlyFigure)NNrrrrrr)rVr rWrrXrrYrrZrr[rr,rr-rr]rrr)rNNNF)rnp.arrayrrrkrrYrr% str | Nonerp int | Noner&rrqrCrzlist[PlotlyScatter])NNNF)rrrrrkrr%rrprr&rrqrCr PlotlyScatter)rWzSequence[tuple[int, ...]]rXz Sequence[str]rNone)r;dictrr)__doc__ __future__r itertoolsrtypingrrnumpyr@utilsrutils.estimator_pub_resultr plotly.graph_objectsr rr rrlrsrRrHr?r:rrrs!E"* ;;= 15"&{ { -{ { {  {  { { {{{{@15"&t t -t t t  t  t t tttv#666 6 6  6  6 666z#""" "  "  "  """J  r