iSSrSSKJr SSKJrJrJrJr SSKrSSK J r SSK J r SSK Jr SSKJr S S KJr S S KJr S S KJr S S KJr S SKJr S SKJr \R:"\5r"SS5r "SS\\\ \ 5r!g)zEstimator primitive.) annotations)OptionalDictUnionIterableN) BackendV2)BaseEstimatorV2)EstimatorPubLike) EstimatorPub) RuntimeJobV2)EstimatorOptions)BasePrimitiveV2)validate_estimator_pubs)Session)Batchc\rSrSrSrSrSrg) Estimator&z(Base class for Qiskit Runtime Estimator.rN)__name__ __module__ __qualname____firstlineno____doc__version__static_attributes__rV/home/james-whalen/.local/lib/python3.13/site-packages/qiskit_ibm_runtime/estimator.pyrr&s 2Grrcr\rSrSrSr\rSrS S SjjrSS.S Sjjr SSjr \ SS j5r S r g) EstimatorV2,aClass for interacting with Qiskit Runtime Estimator primitive service. Qiskit Runtime Estimator primitive service estimates expectation values of quantum circuits and observables. The :meth:`run` can be used to submit circuits, observables, and parameters to the Estimator primitive. Following construction, an estimator is used by calling its :meth:`run` method with a list of PUBs (Primitive Unified Blocs). Each PUB contains four values that, together, define a computation unit of work for the estimator to complete: * a single :class:`~qiskit.circuit.QuantumCircuit`, possibly parametrized, whose final state we define as :math:`\psi(\theta)`, * one or more observables (specified as any :class:`~.ObservablesArrayLike`, including :class:`~.Pauli`, :class:`~.SparsePauliOp`, ``str``) that specify which expectation values to estimate, denoted :math:`H_j`, and * a collection parameter value sets to bind the circuit against, :math:`\theta_k`. * an optional target precision for expectation value estimates. Here is an example of how the estimator is used. .. code-block:: python from qiskit.circuit.library import real_amplitudes from qiskit.quantum_info import SparsePauliOp from qiskit.transpiler.preset_passmanagers import generate_preset_pass_manager from qiskit_ibm_runtime import QiskitRuntimeService, EstimatorV2 as Estimator service = QiskitRuntimeService() backend = service.least_busy(operational=True, simulator=False) psi = real_amplitudes(num_qubits=2, reps=2) hamiltonian = SparsePauliOp.from_list([("II", 1), ("IZ", 2), ("XI", 3)]) theta = [0, 1, 1, 2, 3, 5] pm = generate_preset_pass_manager(backend=backend, optimization_level=1) isa_psi = pm.run(psi) isa_observables = hamiltonian.apply_layout(isa_psi.layout) estimator = Estimator(mode=backend) # calculate [ ] job = estimator.run([(isa_psi, isa_observables, [theta])]) pub_result = job.result()[0] print(f"Expectation values: {pub_result.data.evs}") Nc[R"U5 [RU5 [R"XUS9 g)aPInitializes the Estimator primitive. Args: mode: The execution mode used to make the primitive query. It can be: * A :class:`Backend` if you are using job mode. * A :class:`Session` if you are using session execution mode. * A :class:`Batch` if you are using batch execution mode. Refer to the `Qiskit Runtime documentation `_. for more information about the ``Execution modes``. options: Estimator options, see :class:`EstimatorOptions` for detailed description. )modeoptionsN)r __init__rr)selfr%r&s rr'EstimatorV2.__init__ds0,   &4   'Br) precisioncUbUS::a [S5eUVs/sHn[R"X25PM nn[U5 UR U5$s snf)aSubmit a request to the estimator primitive. Args: pubs: An iterable of pub-like (primitive unified bloc) 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: Submitted job. Raises: ValueError: if precision value is not strictly greater than 0. rz4The precision value must be strictly greater than 0.) ValueErrorr coercer_run)r(pubsr*pub coerced_pubss rrunEstimatorV2.runsY$  A~ !WXXGKLt ++C;t L -yy&&Ms AcURS05RSS5SLaOURbAURR5RSLaUSS(d [ S5egggg) zValidate that primitive inputs (options) are valid Raises: ValidationError: if validation fails. ValueError: if validation fails. resiliencepec_mitigationFTN simulator coupling_mapzZWhen the backend is a simulator and pec_mitigation is enabled, a coupling map is required.)get_backend configurationr7r,)r(r&s r_validate_optionsEstimatorV2._validate_optionss KK b ) - -.> F$ N ) ++-774?K(8. 9@* Orcg)zReturn the program ID. estimatorr)clss r _program_idEstimatorV2._program_idsrr)NN)r%z/Optional[Union[BackendV2, Session, Batch, str]]r&z'Optional[Union[Dict, EstimatorOptions]])r/zIterable[EstimatorPubLike]r*z float | Nonereturnr )r&dictrCNone)rCstr)rrrrrr_options_classrr'r2r< classmethodrArrrrr!r!,su1f&NGAE;?C=C9C8NR'.'>J' '2&rr!)"r __future__rtypingrrrrloggingqiskit.providersrqiskit.primitives.baser qiskit.primitives.containersr *qiskit.primitives.containers.estimator_pubr runtime_job_v2r options.estimator_optionsrbase_primitiverutilsrsessionrbatchr getLoggerrloggerrr!rrrrXsh"22&29C(7+*   8 $ B/"23YBr