g<"^dZddlmZddlmZmZddlmZmZddl m Z ddl m Z m Z ddl mZddlmZdd lmZdd lmZdd lmZd d lmZmZmZmZd dlmZddlm Z ddl!m"Z"ddl#m$Z$e deZ%Gdde"e e%Z&Gdde&e%Z'GddeZ(dS)z Base Estimator V1 and V2 classes) annotations)abstractmethodABC)IterableSequence)copy)GenericTypeVar)QuantumCircuit)JobV1) SparsePauliOp) BaseOperator)deprecate_func)DataBinEstimatorPubLikePrimitiveResult PubResult) EstimatorPub) validation) BasePrimitive)BasePrimitiveJobT)boundcReZdZdZdZdddfdZ dddZeddZxZ S)BaseEstimatorV1ad Estimator V1 base class. Base class for Estimator that estimates expectation values of quantum circuits and observables. An estimator is initialized with an empty parameter set. The estimator is used to create a :class:`~qiskit.providers.JobV1`, via the :meth:`qiskit.primitives.Estimator.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). * observables (:math:`H_j`): a list of :class:`~qiskit.quantum_info.SparsePauliOp` objects. * parameter values (:math:`\theta_k`): list of sets of 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 the a list of expectation values plus optional metadata like confidence intervals for the estimation. .. math:: \langle\psi_i(\theta_k)|H_j|\psi_i(\theta_k)\rangle Here is an example of how the estimator is used. .. code-block:: python from qiskit.primitives import Estimator from qiskit.circuit.library import RealAmplitudes from qiskit.quantum_info import SparsePauliOp psi1 = RealAmplitudes(num_qubits=2, reps=2) psi2 = RealAmplitudes(num_qubits=2, reps=3) H1 = SparsePauliOp.from_list([("II", 1), ("IZ", 2), ("XI", 3)]) H2 = SparsePauliOp.from_list([("IZ", 1)]) H3 = SparsePauliOp.from_list([("ZI", 1), ("ZZ", 1)]) theta1 = [0, 1, 1, 2, 3, 5] theta2 = [0, 1, 1, 2, 3, 5, 8, 13] theta3 = [1, 2, 3, 4, 5, 6] estimator = Estimator() # calculate [ ] job = estimator.run([psi1], [H1], [theta1]) job_result = job.result() # It will block until the job finishes. print(f"The primitive-job finished with result {job_result}") # calculate [ , # , # ] job2 = estimator.run([psi1, psi2, psi1], [H1, H2, H3], [theta1, theta2, theta3]) job_result = job2.result() print(f"The primitive-job finished with result {job_result}") Noptionsr dict | NonecJt|dS)z Creating an instance of an Estimator V1, or using one in a ``with`` context opens a session that holds resources until the instance is ``close()`` ed or the context is exited. Args: options: Default options. Nsuper__init__selfr __class__s [/granary/edev/quantum/lib/python3.11/site-packages/qiskit/primitives/base/base_estimator.pyr$zBaseEstimatorV1.__init__ks# !!!!!circuits)Sequence[QuantumCircuit] | QuantumCircuit observables1Sequence[BaseOperator | str] | BaseOperator | strparameter_values:Sequence[Sequence[float]] | Sequence[float] | float | Nonereturnrc tj|||\}}}t|j}|jdi||j|||fi|jS)aaRun the job of the estimation of expectation value(s). ``circuits``, ``observables``, and ``parameter_values`` should have the same length. The i-th element of the result is the expectation of observable .. code-block:: python obs = observables[i] for the state prepared by .. code-block:: python circ = circuits[i] with bound parameters .. code-block:: python values = parameter_values[i] Args: circuits: one or more circuit objects. observables: one or more observable objects. Several formats are allowed; importantly, ``str`` should follow the string representation format for :class:`~qiskit.quantum_info.Pauli` objects. parameter_values: concrete parameters to be bound. run_options: runtime options used for circuit execution. Returns: The job object of EstimatorResult. Raises: TypeError: Invalid argument type given. ValueError: Invalid argument values given. )r_validate_estimator_argsrrupdate_options_run__dict__)r&r*r,r. run_optionsrun_optss r(runzBaseEstimatorV1.runysX3=2U k#33 3 /+/  %%..+...ty         r)tuple[QuantumCircuit, ...]tuple[SparsePauliOp, ...]tuple[tuple[float, ...], ...]c  td)Nz;The subclass of BaseEstimator must implement `_run` method.)NotImplementedError)r&r*r,r.r7s r(r5zBaseEstimatorV1._runs""_```r)rr N)r*r+r,r-r.r/r0r)r*r:r,r;r.r<r0r) __name__ __module__ __qualname____doc____hash__r$r9rr5 __classcell__r's@r(rr*s<<|H $ " " " " " " " "$X\ 9 9 9 9 9 vaaa^aaaaar)rcPeZdZdZeddddd fd ZxZS) BaseEstimatorzhDEPRECATED. Type alias for Estimator V1 base class. See :class:`.BaseEstimatorV1` for details. z1.2a~The `BaseEstimator` class is a type alias for the `BaseEstimatorV1` interface that has been deprecated in favor of explicitly versioned interface classes. It is recommended to migrate all implementations to use `BaseEstimatorV2`. However, for implementations incompatible with `BaseEstimatorV2`, `BaseEstimator` can be replaced with the explicitly versioned `BaseEstimatorV1` class.)sinceadditional_msgNrrr cLt|dS)z Creating an instance of an Estimator, or using one in a ``with`` context opens a session that holds resources until the instance is ``close()`` ed or the context is exited. Args: options: Default options. rNr"r%s r(r$zBaseEstimator.__init__s&( )))))r)r?)rArBrCrDrr$rFrGs@r(rIrIs ^M $ * * * * * * * * * * * *r)rIcHeZdZdZeddZeddddZdS)BaseEstimatorV2apEstimator V2 base class. An estimator estimates expectation values for provided quantum circuit and observable combinations. An Estimator implementation must treat the :meth:`.run` method ``precision=None`` kwarg as using a default ``precision`` value. The default value and methods to set it can be determined by the Estimator implementor. _rr0 type[DataBin]ctSr@)r)rOs r(_make_data_binzBaseEstimatorV2._make_data_bins r)N) precisionpubsIterable[EstimatorPubLike]rS float | None,BasePrimitiveJob[PrimitiveResult[PubResult]]cdS)a@Estimate expectation values for each provided pub (Primitive Unified Bloc). Args: pubs: An iterable of pub-like objects, such as tuples ``(circuit, observables)`` or ``(circuit, observables, parameter_values)``. precision: The target precision for expectation value estimates of each run Estimator Pub that does not specify its own precision. If None the estimator's default precision value will be used. Returns: A job object that contains results. Nr2)r&rTrSs r(r9zBaseEstimatorV2.runsr))rOrr0rP)rTrUrSrVr0rW)rArBrCrD staticmethodrRrr9r2r)r(rNrNsk\ MQ     ^   r)rNN))rD __future__rabcrrcollections.abcrrrtypingr r qiskit.circuitr qiskit.providersr Jobqiskit.quantum_info.operatorsr +qiskit.quantum_info.operators.base_operatorrqiskit.utils.deprecationr containersrrrrcontainers.estimator_pubrrbase_primitiverbase_primitive_jobrrrrIrNr2r)r(ris'&""""""########........########))))))))))))777777DDDDDD333333 433333))))))000000 GCsRaRaRaRaRamWQZRaRaRaj*****OA&***:      c      r)