g  dZddlmZddlmZddlmZddlmZm Z ddl m Z ddl m Z dd lmZmZdd lmZd gZGd d eZe e ee ee efee ee edfffZdS)z Sampler Pub class ) annotations)Mapping)Integral)TupleUnion)QuantumCircuit)CircuitInstruction) BindingsArrayBindingsArrayLike) ShapedMixinSamplerPubLikeceZdZdZ ddfd ZeddZeddZeddZe dddZ dZ xZ S) SamplerPuba Pub (Primitive Unified Bloc) for a Sampler. Pub is composed of tuple (circuit, parameter_values, shots). If shots are provided this number of shots will be run with the sampler, if ``shots=None`` the number of run shots is determined by the sampler. NTcircuitrparameter_valuesBindingsArray | Noneshots int | Nonevalidateboolct||_|p t|_||_|jj|_|r|dSdS)awInitialize a sampler pub. Args: circuit: A quantum circuit. parameter_values: A bindings array. shots: A specific number of shots to run with. This value takes precedence over any value owed by or supplied to a sampler. validate: If ``True``, the input data is validated during initialization. N) super__init___circuitr _parameter_values_shotsshape_shaper)selfrrrr __class__s ^/granary/edev/quantum/lib/python3.11/site-packages/qiskit/primitives/containers/sampler_pub.pyrzSamplerPub.__init__+sj  !1!D]__ ,2   MMOOOOO  returnc|jS)zA quantum circuit.)rr s r"rzSamplerPub.circuitCs }r#r c|jS)zA bindings array.)rr&s r"rzSamplerPub.parameter_valuesHs %%r#c|jS)zAn specific number of shots to run with (optional). This value takes precedence over any value owed by or supplied to a sampler. )rr&s r"rzSamplerPub.shotsMs {r#pubrcr|Nt|trt|trtd|dkrt dt|t r$|j|||j|j|dS|St|tr|||dSt|tr t d t|d t|d vr t d t|d |d}t|dkrW|dO|d}t|ttfst|j|i}tj|}nd}t|dkr|d|d}||||dS)aECoerce a :class:`~.SamplerPubLike` object into a :class:`~.SamplerPub` instance. Args: pub: An object to coerce. shots: An optional default number of shots to use if not already specified by the pub-like object. Returns: A coerced sampler pub. Nshots must be an integerrshots must be positiveF)rrrrT)rrrz'An invalid Sampler pub-like was given (z). If you want to run a single circuit, you need to wrap it with `[]` like `sampler.run([circuit])` instead of `sampler.run(circuit)`.)r z0The length of pub must be 1, 2 or 3, but length z is given.r r-) isinstancerr TypeError ValueErrorrrrrrr typelenr rtuple parameterscoerce)clsr)rrvaluesrs r"r6zSamplerPub.coerceUs  eX.. <*UD2I2I < :;;;zz !9::: c: & & y U%6sK%(%9"  J c> * * @3s%$??? ? c- . . 5$s))555  s889 $ $W3s88WWW a& s88a<?? = 233V<,3F;;  #  s88a<> > &&((( : !dj(33  W%% % 9 8r#)NNT)rrrrrrrr)r$r)r$r )r$r)N)r)rrrr$r) __name__ __module__ __qualname____doc__rpropertyrrr classmethodr6r __classcell__)r!s@r"rr"s26  0X&&&X&X7c7c7c7c[7cr&&&&&&&r#rN)r? __future__rcollections.abcrnumbersrtypingrrqiskitrqiskit.circuitr bindings_arrayr r rr __all__rrr#r"rLs8#"""""######!!!!!!------<<<<<<<<  G&G&G&G&G&G&G&G&T . .+ +, .+U8T>-B BCE r#