g dZddlmZddlmZddlmZddlmZm Z ddl Z ddl m Z dd lmZmZdd lmZmZdd lmZd gZGd deZe eee efee eefee eeeffZdS)z Estimator Pub class ) annotations)Real)Mapping)TupleUnionN)QuantumCircuit) BindingsArrayBindingsArrayLike)ObservablesArrayObservablesArrayLike) ShapedMixinEstimatorPubLikeceZdZdZdZ ddfd ZeddZeddZeddZ eddZ e d d!dZ dZ xZS)" EstimatorPubaGPrimitive 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_shapeNTcircuitr observablesr parameter_valuesBindingsArray | None precision float | Nonevalidateboolct||_||_|p t |_||_ tj|j j |j j |_ n=#t$r0}td|j j d|j j d|d}~wwxYw|r|dSdS)a@Initialize 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_shapesrshaperr ValueErrorr)selfrrrrrex __class__s `/granary/edev/quantum/lib/python3.11/site-packages/qiskit/primitives/containers/estimator_pub.pyr!zEstimatorPub.__init__/s*  '!1!D]__# -d.>.DdF[FabbDKK   _)9)?__*.*?*E___     MMOOOOO  s .A<< B6+B11B6returnc|jS)zA quantum circuit.)rr&s r)rzEstimatorPub.circuitWs }c|jS)zAn observables array.)rr,s r)rzEstimatorPub.observables\s   r-r c|jS)zA bindings array.)rr,s r)rzEstimatorPub.parameter_valuesas %%r-c|jS)z@The target precision for expectation value estimates (optional).)rr,s r)rzEstimatorPub.precisionfs r-pubrcf|Jt|ts tdt|d|dkrt dt|t r*|j!|||j|j|j |dS|St|tr t dt|d t|d vr t d t|d |d}tj |d }t|dkrW|dO|d}t|ttfst!|j|i}tj |}nd}t|dkr|d|d}|||||dS)a?Coerce :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)rrrrrz)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 r5r6T) isinstancer TypeErrortyper%rrrrrrlenr coercer rtuple parameters)clsr1rrrvaluesrs r)r<zEstimatorPub.coerceks  i.. \ ZY Z Z Z[[[1}} !ABBB c< ( ( }$)>sK #%(%9'" J c> * * TDIITTT  s889 $ $W3s88WWW a&&-c!f55 s88a<?? = 233V<,3F;;  #  s88a<> > !!### &&((( > %dnd33 a _T^H\H\ _ _ _```~!! !BCCC ^D,<==  MAzT$z"2"23344J|&*44 _DL__PZ___5.= T\8 8 8]]]-1\-H]]]  9 8r-)NNT) rrrr rrrrrr)r*r)r*r )r*r )r*r)N)r1rrrr*r)__name__ __module__ __qualname____doc__ __slots__r!propertyrrrr classmethodr<r __classcell__)r(s@r)rr$sZI 26"& &&&&&&&PX!!!X!&&&X&X< < < < [< |r-r)rL __future__rnumbersrcollections.abcrtypingrrnumpyr"qiskitrbindings_arrayr r observables_arrayr r r$r__all__rrr-r)r[sN#"""""######!!!!!!<<<<<<<<EEEEEEEE  ccccc;cccL .. ./ ..0A AB ..0A4 GHJ r-