z i SrSSKJr SSKJr SSKJr SSKJrJ r SSK r SSK J r SS KJrJr SS KJrJr SS KJr S /r"S S\5r\ \\\ \4\\ \\4\\ \\\44rg)z Estimator Pub class ) annotations)Real)Mapping)TupleUnionN)QuantumCircuit) BindingsArrayBindingsArrayLike)ObservablesArrayObservablesArrayLike) ShapedMixinEstimatorPubLikec^\rSrSrSrSrS S U4Sjjjr\S Sj5r\SSj5r \SSj5r \SSj5r \ SSS jj5r S rSrU=r$) EstimatorPub$a7Primitive Unified Bloc for any Estimator primitive. An estimator pub is essentially a tuple ``(circuit, observables, parameter_values, precision)``. If precision is provided this should be used for the target precision of an estimator, if ``precision=None`` the estimator will determine the target precision. )_circuit _observables_parameter_values _precision_shapec>[TU]5 XlX lU=(d [ 5UlX@l[R"URRURR5Ul U(aUR5 gg![a@n[SURRSURRS35UeSnAff=f)aInitialize an estimator pub. Args: circuit: A quantum circuit. observables: An observables array. parameter_values: A bindings array, if the circuit is parametric. precision: An optional target precision for expectation value estimates. validate: Whether to validate arguments during initialization. Raises: ValueError: If the ``observables`` and ``parameter_values`` are not broadcastable, that is, if their shapes, when right-aligned, do not agree or equal 1. zThe observables shape z and the parameter values shape z are not broadcastable.N)super__init__rrr rrnpbroadcast_shapes observablesshapeparameter_valuesr ValueErrorvalidate)selfcircuitrr precisionr!ex __class__s d/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/primitives/containers/estimator_pub.pyrEstimatorPub.__init__/s*  '!1!D]_# --d.>.>.D.DdF[F[FaFabDK  MMO   ()9)9)?)?(@A**.*?*?*E*E)FF]_  sAB C"";CC"cUR$)zA quantum circuit.)rr"s r'r#EstimatorPub.circuitWs}}cUR$)zAn observables array.)rr*s r'rEstimatorPub.observables\s   r,cUR$)zA bindings array.)rr*s r'rEstimatorPub.parameter_valuesas%%%r,cUR$)z@The target precision for expectation value estimates (optional).)rr*s r'r$EstimatorPub.precisionfsr,cUb>[U[5(d[S[U5S35eUS:a [ S5e[U[ 5(a:UR c+Ub(U"URURURUSS9$U$[U[5(a[ S[U5S 35e[U5S ;a[ S [U5S 35eUSn[R"US 5n[U5S:aTUSbNUSn[U[[45(d[!UR"5U0n[R"U5nOSn[U5S:a USbUSnU"UUUUSS9$)aCoerce :class:`~.EstimatorPubLike` into :class:`~.EstimatorPub`. Args: pub: A compatible object for coercion. precision: an optional default precision to use if not already specified by the pub-like object. Returns: An estimator pub. N%precision must be a real number, not .rzprecision must be non-negativeF)r#rrr$r!z)An invalid Estimator pub-like was given (z). If you want to run a single pub, you need to wrap it with `[]` like `estimator.run([(circuit, observables, param_values)])` instead of `estimator.run((circuit, observables, param_values))`.)z0The length of pub must be 2, 3 or 4, but length z is given.r r6r7T) isinstancer TypeErrortyper rr$r#rrrlenr coercer rtuple parameters)clspubr$r#rvaluesrs r'r=EstimatorPub.coerceks  i.."GYGXXY Z[[1} !ABB c< ( (}}$)>KK #%(%9%9'" J c> * *;DI;GTT  s89 $B3s8*JW a&&--c!f5 s8a?? 2 23V<,33F; #  s8a[SURR SUS US 35e UR R"nX@RR":wa&[S US URR"S 35eg)zValidate the pub.zcircuit must be QuantumCircuit.Nr4r5rzprecision must be non-negative.z%The number of qubits of the circuit (z-) does not match the number of qubits of the z-th observable (z).zThe number of values (z+) does not match the number of parameters (z) for the circuit.)r9r#rr:rr!rr$rr;r r ndenumerater<nextiter num_qubitsnum_parameters)r"i observablerHrIs r'r!EstimatorPub.validateso$,,77=> > !!# &&( >> %dnnd33"GT^^H\G]]^ _``~~! !BCC ^^D,<,<=MAT$z"234J||&&*4 ;DLLC?OPZ|[]_>..== \\88 8((89--1\\-H-H,II[]  9r,)NNT) r#rrr rzBindingsArray | Noner$ float | Noner!bool)returnr)rOr )rOr )rOrM)N)rArr$rMrOr)__name__ __module__ __qualname____firstlineno____doc__ __slots__rpropertyr#rrr$ classmethodr=r!__static_attributes__ __classcell__)r&s@r'rr$sZI 26"& &&&&/ &  &  &&P!!&&< < |r,r)rT __future__rnumbersrcollections.abcrtypingrrnumpyrqiskitrbindings_arrayr r observables_arrayr r rr__all__rrr,r'rds##!<E  c;cL .. ./ ..0A AB ..0A4 GHJ r,