z i=SrSSKJr SSKJrJrJr SSKJrJr SSK J r J r SSK rSSKJr SSKJrJr S S KJrJrJr S S /r\\\4r\\\\\S 44\4r"SS\5rSSjrSSjrSSjrSSjr g)z Bindings array class ) annotations)MappingUnionTuple)Iterabler)chainisliceN) ArrayLike) ParameterQuantumCircuit) ShapedMixin ShapeInput shape_tuple ParameterLikeBindingsArrayLike.c^\rSrSrSrSSU4SjjjrSSjrSr\SSj5r \SSj5r SSSjjr SS jr SS jr SS jrSS jr\SS j5rSrSrU=r$) BindingsArray6aStores parameter binding value sets for a :class:`qiskit.QuantumCircuit`. A single parameter binding set provides numeric values to bind to a circuit with free :class:`qiskit.circuit.Parameter`\s. An instance of this class stores an array-valued collection of such sets. The simplest example is a 0-d array consisting of a single parameter binding set, whereas an n-d array of parameter binding sets represents an n-d sweep over values. The storage format is a dictionary of arrays attached to parameters, ``{params_0: values_0,...}``. A convention is used where the last dimension of each array indexes (a subset of) circuit parameters. For example, if the last dimension of ``values_0`` is 25, then it represents an array of possible binding values for the 25 distinct parameters ``params_0``, where its leading shape is the array :attr:`~.shape` of its binding array. This allows flexibility about whether values for different parameters are stored in one big array, or across several smaller arrays. .. plot:: :include-source: :nofigs: # 0-d array (i.e. only one binding) BindingsArray({"a": 4, ("b", "c"): [5, 6]}) # single array, last index is parameters parameters = tuple(f"a{idx}" for idx in range(100)) BindingsArray({parameters: np.ones((10, 10, 100))}) # multiple arrays, where each last index is parameters. notice that it's smart enough to # figure out that a missing last dimension corresponds to a single parameter. BindingsArray( {("c", "a"): np.zeros((10, 10, 2)), "b": np.ones((10, 10))} ) c >[TU]5 Uc0UlOrUR5VVs0sHOup4[ U[ [ 45(a [U45O [U5[R"U[S9_MQ snnUlUc[UR5O [U5Ul SUlUR5 gs snnf)ai Initialize a :class:`~.BindingsArray`. The ``shape`` argument does not need to be provided whenever it can unambiguously be inferred from the provided arrays. Ambiguity arises whenever the key of an entry of ``data`` contains only one parameter and the corresponding array's shape ends in a one. In this case, it can't be decided whether that one is an index over parameters, or whether it should be incorporated in :attr:`~shape`. Since :class:`~.Parameter` objects are only allowed to represent float values, this class casts all given values to float. If an incompatible dtype is given, such as complex numbers, a ``TypeError`` will be raised. Args: data: A mapping from one or more parameters to arrays of values to bind them to, where the last axis is over parameters. shape: The leading shape of every array in these bindings. Raises: ValueError: If all inputs are ``None``. ValueError: If the shape cannot be automatically inferred from the arrays, or if there is some inconsistency in the shape of the given arrays. TypeError: If some of the vaules can't be cast to a float type. Ndtype)super__init___dataitems isinstancer str _format_keynpasarrayfloat _infer_shaper_shape_num_parametersvalidate)selfdatashapekeyval __class__s e/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/primitives/containers/bindings_array.pyrBindingsArray.__init__Xs:  <DJ !% !-HC,6cIs;K+L+LK'R]^aRb::c/0 , DJ38-l4::.[QVEW # sAC c URR5VVs0sH up#X#U_M nnn[[UR 555R SSn[XE5$s snnf![ a SnNf=f)N)rrnextitervaluesr) StopIterationr)r'argsparamsr+r(r)s r- __getitem__BindingsArray.__getitem__s 6:ZZ5E5E5GH5GkfD !5GH dkkm,-33CR8ET)) I E sA-/A33 BBc SUR3SUR3/nUR(a[[[ [ [ R"[ [UR555S55n[U5UR:aURS5 URSSRU5S35 [U5RSSRU5S 3$) Nzshape=znum_parameters=z...z parameters=[z, ]z())r)num_parameterslistr mapreprr from_iterablerrlenappendjointype__name__)r' descriptionsnamess r-__repr__BindingsArray.__repr__s  -ATAT@U/VW   D%*=*=c+tzz>Z*[ \^_`aE5zD/// U#   ,tyy/?.@ B Ct*%%&b<)@(ADDcUR$)z!The keyword values of this array.)rr's r-r(BindingsArray.dataszzrKcURc/[SURR555UlUR$)zThe total number of parameters.c3># UHoRSv M g7f)r0Nr)).0r+s r- /BindingsArray.num_parameters..s&T@Syy}@Ss)r%sumrr4rMs r-r=BindingsArray.num_parameterss<    '#&&T @Q@Q@S&T#TD ###rKc ^ Sn[R"[URUR55nUc@UR R 5H nURSnXCSX"U-24'X%- nM" U$[U5n[U5UR:wa%[SURS[U5S35e[U5VVs0sHupg[U5U_M snnm UR R5H-upUV s/sHn T [U 5U-PM n n XCSU 4'M/ U$s snnfs sn f![a8n [U 4Sj[[U555n [S U S 35U eSn A ff=f) aReturn the contents of this bindings array as a single NumPy array. The parameters are indexed along the last dimension of the returned array. Parameters: parameters: Optional parameters that determine the order of the output. Returns: This bindings array as a single NumPy array. Raises: ValueError: If ``parameters`` are provided, but do not match those found in ``data``. rNr0. Expected z parameters but z received.c36># UHoT;dM Uv M g7fNr1)rRp idx_lookups r-rS)BindingsArray.as_array..s"b.JWaNa11.Js  z(Could not find placement for parameter 'z'.)r emptyrr)r=r(r4r>rB ValueError enumerate _param_namerKeyErrorr2r?)r' parameterspositionretarrsizeidx parameter arr_paramsparamidxsexmissingr\s @r-as_arrayBindingsArray.as_arrayshh{4::t/B/BCD  yy'')yy}7:CtO334 *2 'j)J:$"5"55  3 344DS_DUU_`MVV`LabLa.#+i0#5LabJ#'99??#4 eS]^S]%J{5'9:XES]D^"%CI $5 c_e""bc+z.J"bbG$'OPWyXZ%[\bddes0D;EE-EE F3FFc 2[U5UR:wa[SUSURS35eURR 5VVVVs0sHup4[ X4U5HupVXV_M M! nnnnnURU5$s snnnnf)aReturn a new circuit bound to the values at the provided index. Args: circuit: The circuit to bind. loc: A tuple of indices, on for each dimension of this array. Returns: The bound circuit. Raises: ValueError: If the index doesn't have the right number of values. rXz to index all dimensions of .)rBndimr_r)rrzipassign_parameters)r'circuitlocr7valsrkr+rcs r-bindBindingsArray.binds s8tyy y-I$**UVWX X!% 0 0 2 2 !&s)4  J4  2  ((44  s&B c[R"UR[S9n[R"UR5HnUR X5X#'M U$)zReturn an object array of bound circuits with the same shape. Args: circuit: The circuit to bind. Returns: An object array of the same shape containing all bound circuits. r)r r^r)objectndindexry)r'rvrfrhs r-bind_allBindingsArray.bind_allsDhhtzz0::djj)Cyy.CH* rKc8URUR5$)zReturn a new :class:`~BindingsArray` with one dimension. The returned bindings array has a :attr:`shape` given by ``(size, )``, where the size is the :attr:`~size` of this bindings array. Returns: A new bindings array. )reshapergrMs r-ravelBindingsArray.ravels||DII&&rKc ^[U5n[SU55(aU[R"UVs/sH o"S:dM UPM sn[S9nUR U-m[ U4SjU55n[R"U[S9UR :wa [S5eURR5VVs0sH%upEXERXRSS-5_M' nnn[XaS9$s snfs snnf) a+Return a new :class:`~BindingsArray` with a different shape. This results in a new view of the same arrays. Args: shape: The shape of the returned bindings array. Returns: A new bindings array. Raises: ValueError: If the provided shape has a different product than the current size. c3*# UH oS:v M g7frNr1)rRdims r-rS(BindingsArray.reshape..s(%3Qw%srrc36># UHoS:aUOTv M g7frr1)rRr missing_dims r-rSrsLes#{:esz5Reshaping cannot change the total number of elements.r0NrQ) ranyr prodintrgtupler_rrrr)r)r'r)r positive_sizepsr+r(rs @r-rBindingsArray.reshapesE" (%( ( (GGE$FESAXSE$FcRM))}4KLeLLE 775 $ 1TU UGKzzGWGWGYZGYGBKK "# 677GYZT//%G[s DD,DcUc U"5nU$[U[5(aU"US9nU$[U[5(aU$[S[ U5S35e)zCoerce an input that is :class:`~BindingsArrayLike` into a new :class:`~BindingsArray`. Args: bindings_array: An object to be bindings array. Returns: A new bindings array. )r(zUnsupported type z is given.)r_Mappingr TypeErrorrE)clsbindings_arrays r-coerceBindingsArray.coerce!sj  ! UN  1 1 n5N   6 6! !/^0D/EZPQ QrKcURR5HUup[X R5=o RU'[ U5UR S:wdMF[ SUSU35e g)z+Validate the consistency in bindings_array.r0z Length of z% inconsistent with last dimension of N)rr_standardize_shaper$rBr)r_)r'rcr+s r-r&BindingsArray.validate5si#zz//1OJ+=c;;+O OC**Z(:#))B-/   ,QRUQVW 2rK)rr%r$)NN)r(zBindingsArrayLike | Noner)zShapeInput | None)returnr)rz!dict[tuple[str, ...], np.ndarray])rrrZ)rczIterable[ParameterLike] | Noner np.ndarray)rvr rwtuple[int, ...]rr )rvr rr)r)zint | Iterable[int]rr)rrrr)rF __module__ __qualname____firstlineno____doc__rr8rIpropertyr(r=roryr~rr classmethodrr&__static_attributes__ __classcell__)r,s@r-rr6sF*.#',&,!,,\ *E$$ ,\5.  '06&rKrcURU:XaUSnU$URS- [U5:wdURSSU:wa[SURSU35eU$)aQReturn ``val`` or ``val[..., None]``. Args: val: The array whose shape to standardize. shape: The shape to standardize to. Returns: An array with one more dimension than ``len(shape)``, and whose leading dimensions match ``shape``. Raises: ValueError: If the leading shape of ``val`` does not match the ``shape``. ).Nr Nr0zArray with shape z inconsistent with )r)rsrBr_)r+r)s r-rr?sj yyE)n J AU #syy"~'>,SYYK7J5'RSS JrKc^SmU4SjnUR5Hxup#[U5S:waU"URSS5 M+UR(a*URSS:XaU"URSS5 MfU"UR5 Mz Tcg[T5S:Xa[[ T55$[T5S:Xa [ S5e[ STS 35e) axReturn a shape tuple that consistently defines the leading dimensions of all arrays. Args: data: A mapping from tuples to arrays, where the length of each tuple should match the last dimension of the corresponding array. Returns: A shape tuple that matches the leading dimension of every array. Raises: ValueError: If this cannot be done unambiguously. NcF>Tc [U5mgTRU5 grZ)setintersection_update)possible_shapesonly_possible_shapess r- examine_array#_infer_shape..examine_arraycs"  '#&#7 4 4_ ErKr r0r1rz$Could not find any consistent shape.zDCould not unambiguously determine the intended shape, all shapes in z7 are consistent with the input; specify shape manually.)rrBr)r2r3r_)r(rrcr+rs @r-r#r#Ts F ::< z?a  #))CR. ) YY399R=A- #))CR. ) #)) $(#  A%D-.// ! "a '?@@ N  W Y rKc4[[[U55$rZ)rr?ra)r*s r-rrs [#& ''rKcH[U[5(a UR$U$rZ)rr name)rks r-raras#E9555::@5@rK)r+rr)rrr)r(z'dict[tuple[Parameter, ...], np.ndarray]rr)r*ztuple[Parameter | str, ...])rkzParameter | strrr)!r __future__rtypingrrrcollections.abcrr itertoolsrr numpyr numpy.typingr qiskit.circuitr r r)rrr__all__rrrrrr#rrar1rKr-rs#((9#"477 / 0in% $E-}c7I1J"JKYVW"FKFR*+\(ArK