gFdZddlmZddlmZmZddlmZmZddl m Z ddl m Z m Z ddl mZddlmZdd lmZd d lmZd d lmZd d lmZddlmZddlmZddlmZe deZ Gddee e Z!Gdde!e Z"GddeZ#dS)zBase Sampler V1 and V2 classes) annotations)ABCabstractmethod)IterableSequence)copy)GenericTypeVar)QuantumCircuit)JobV1)deprecate_func)PrimitiveResult)SamplerPubLike)SamplerPubResult) validation) BasePrimitive)BasePrimitiveJobT)boundcReZdZdZdZdddfdZ ddd ZeddZxZ S) BaseSamplerV1aSampler V1 base class Base class of Sampler that calculates quasi-probabilities of bitstrings from quantum circuits. A sampler is initialized with an empty parameter set. The sampler is used to create a :class:`~qiskit.providers.JobV1`, via the :meth:`qiskit.primitives.Sampler.run()` method. This method is called with the following parameters * quantum circuits (:math:`\psi_i(\theta)`): list of (parameterized) quantum circuits. (a list of :class:`~qiskit.circuit.QuantumCircuit` objects) * parameter values (:math:`\theta_k`): list of sets of parameter values to be bound to the parameters of the quantum circuits. (list of list of float) The method returns a :class:`~qiskit.providers.JobV1` object, calling :meth:`qiskit.providers.JobV1.result()` yields a :class:`~qiskit.primitives.SamplerResult` object, which contains probabilities or quasi-probabilities of bitstrings, plus optional metadata like error bars in the samples. Here is an example of how sampler is used. .. code-block:: python from qiskit.primitives import Sampler from qiskit import QuantumCircuit from qiskit.circuit.library import RealAmplitudes # a Bell circuit bell = QuantumCircuit(2) bell.h(0) bell.cx(0, 1) bell.measure_all() # two parameterized circuits pqc = RealAmplitudes(num_qubits=2, reps=2) pqc.measure_all() pqc2 = RealAmplitudes(num_qubits=2, reps=3) pqc2.measure_all() theta1 = [0, 1, 1, 2, 3, 5] theta2 = [0, 1, 2, 3, 4, 5, 6, 7] # initialization of the sampler sampler = Sampler() # Sampler runs a job on the Bell circuit job = sampler.run(circuits=[bell], parameter_values=[[]], parameters=[[]]) job_result = job.result() print([q.binary_probabilities() for q in job_result.quasi_dists]) # Sampler runs a job on the parameterized circuits job2 = sampler.run( circuits=[pqc, pqc2], parameter_values=[theta1, theta2], parameters=[pqc.parameters, pqc2.parameters]) job_result = job2.result() print([q.binary_probabilities() for q in job_result.quasi_dists]) Noptionsr dict | NonecJt|dS)= Args: options: Default options. Nsuper__init__selfr __class__s Y/granary/edev/quantum/lib/python3.11/site-packages/qiskit/primitives/base/base_sampler.pyr!zBaseSamplerV1.__init__ds# !!!!!circuits)QuantumCircuit | Sequence[QuantumCircuit]parameter_values2Sequence[float] | Sequence[Sequence[float]] | Nonereturnrc tj||\}}t|j}|jdi||j||fi|jS)aRun the job of the sampling of bitstrings. Args: circuits: One of more circuit objects. parameter_values: Parameters to be bound to the circuit. run_options: Backend runtime options used for circuit execution. Returns: The job object of the result of the sampler. The i-th result corresponds to ``circuits[i]`` evaluated with parameters bound as ``parameter_values[i]``. Raises: ValueError: Invalid arguments are given. )r_validate_sampler_argsrrupdate_options_run__dict__)r#r'r) run_optionsrun_optss r%runzBaseSamplerV1.runosu*&0%FxQa%b%b"" %%..+...ty       r&tuple[QuantumCircuit, ...]tuple[tuple[float, ...], ...]c  td)Nz9The subclass of BaseSampler must implement `_run` method.)NotImplementedError)r#r'r)r2s r%r0zBaseSamplerV1._runs""]^^^r&rr)N)r'r(r)r*r+r)r'r5r)r6r+r) __name__ __module__ __qualname____doc____hash__r!r4rr0 __classcell__r$s@r%rr$s;;zH $ " " " " " " " "PT     B___^_____r&rcPeZdZdZeddddd fd ZxZS) BaseSamplerzcDEPRECATED. Type alias for Sampler V1 base class See :class:`.BaseSamplerV1` for details. z1.2arThe `BaseSampler` class is a type alias for the `BaseSamplerV1` interface that has been deprecated in favor of explicitly versioned interface classes. It is recommended to migrate all implementations to use `BaseSamplerV2`. However, for implementations incompatible with `BaseSamplerV2`, `BaseSampler` can be replaced with the explicitly versioned `BaseSamplerV1` class.)sinceadditional_msgNrrrcLt|dS)rrNrr"s r%r!zBaseSampler.__init__s&" )))))r&r9)r:r;r<r=r r!r?r@s@r%rBrBs ^K $ * * * * * * * * * * * *r&rBc0eZdZdZeddd d ZdS) BaseSamplerV2aSampler V2 base class. A Sampler returns samples of quantum circuit outputs. All sampler implementations must implement default value for the ``shots`` in the :meth:`.run` method if ``None`` is given both as a ``kwarg`` and in all of the pubs. N)shotspubsIterable[SamplerPubLike]rH int | Noner+3BasePrimitiveJob[PrimitiveResult[SamplerPubResult]]cdS)aRun and collect samples from each pub. Args: pubs: An iterable of pub-like objects. For example, a list of circuits or tuples ``(circuit, parameter_values)``. shots: The total number of shots to sample for each sampler pub that does not specify its own shots. If ``None``, the primitive's default shots value will be used, which can vary by implementation. Returns: The job object of Sampler's result. Nr-)r#rIrHs r%r4zBaseSamplerV2.runsr&)rIrJrHrKr+rL)r:r;r<r=rr4r-r&r%rGrGsKEI     ^   r&rGN)$r= __future__rabcrrcollections.abcrrrtypingr r qiskit.circuitr qiskit.providersr Jobqiskit.utils.deprecationr containers.primitive_resultrcontainers.sampler_pubrcontainers.sampler_pub_resultrrbase_primitiverbase_primitive_jobrrrrBrGr-r&r%r\s%$""""""########........########))))))))))))333333999999333333<<<<<<))))))000000 GCss_s_s_s_s_M71:s_s_s_l*****-"***4     C     r&