Deprecate PrimitivesV1 and their utils

qiskit/primitives/backend_estimator.py

@@ -35,6 +35,7 @@
     Optimize1qGatesDecomposition,
     SetLayout,
 )
+from qiskit.utils.deprecation import deprecate_func
 
 from .base import BaseEstimator, EstimatorResult
 from .primitive_job import PrimitiveJob
@@ -102,6 +103,7 @@ class BackendEstimator(BaseEstimator[PrimitiveJob[EstimatorResult]]):
     precludes doing any provider- or backend-specific optimizations.
     """
 
+    @deprecate_func(since="0.46.0", additional_msg="Use BackendEstimatorV2 instead.")
     def __init__(
         self,
         backend: BackendV1 | BackendV2,
@@ -236,7 +238,6 @@ def _call(
         parameter_values: Sequence[Sequence[float]],
         **run_options,
     ) -> EstimatorResult:
-
         # Transpile
         self._grouping = list(zip(circuits, observables))
         transpiled_circuits = self.transpiled_circuits
@@ -368,7 +369,6 @@ def _postprocessing(
         shots_list = []
 
         for i, j in zip(accum, accum[1:]):
-
             combined_expval = 0.0
             combined_var = 0.0
 

qiskit/primitives/backend_sampler.py

@@ -23,6 +23,7 @@
 from qiskit.providers.options import Options
 from qiskit.result import QuasiDistribution, Result
 from qiskit.transpiler.passmanager import PassManager
+from qiskit.utils.deprecation import deprecate_func
 
 from .backend_estimator import _prepare_counts, _run_circuits
 from .base import BaseSampler, SamplerResult
@@ -46,6 +47,7 @@ class BackendSampler(BaseSampler[PrimitiveJob[SamplerResult]]):
     precludes doing any provider- or backend-specific optimizations.
     """
 
+    @deprecate_func(since="0.46.0", additional_msg="Use BackendSamplerV2 instead.")
     def __init__(
         self,
         backend: BackendV1 | BackendV2,
@@ -135,7 +137,6 @@ def _call(
         parameter_values: Sequence[Sequence[float]],
         **run_options,
     ) -> SamplerResult:
-
         # This line does the actual transpilation
         transpiled_circuits = self.transpiled_circuits
         bound_circuits = [

qiskit/primitives/base/base_estimator.py

@@ -86,15 +86,15 @@
 from copy import copy
 from typing import Generic, TypeVar
 
-from qiskit.utils.deprecation import deprecate_func
 from qiskit.circuit import QuantumCircuit
 from qiskit.circuit.parametertable import ParameterView
 from qiskit.providers import JobV1 as Job
 from qiskit.quantum_info.operators import SparsePauliOp
 from qiskit.quantum_info.operators.base_operator import BaseOperator
+from qiskit.utils.deprecation import deprecate_func
 
-from .base_primitive import BasePrimitive
 from . import validation
+from .base_primitive import BasePrimitive
 
 T = TypeVar("T", bound=Job)
 
@@ -107,6 +107,7 @@ class BaseEstimator(BasePrimitive, Generic[T]):
 
     __hash__ = None
 
+    @deprecate_func(since="0.46.0", additional_msg="Use BaseEstimatorV2 instead.")
     def __init__(
         self,
         *,

qiskit/primitives/base/base_primitive.py

@@ -27,6 +27,7 @@
 class BasePrimitive(ABC):
     """Primitive abstract base class."""
 
+    @deprecate_func(since="0.46.0", additional_msg="Use BasePrimitiveV2 instead.")
     def __init__(self, options: dict | None = None):
         self._run_options = Options()
         if options is not None:

qiskit/primitives/base/base_result.py

@@ -19,10 +19,10 @@
 from collections.abc import Iterator, Sequence
 from dataclasses import fields
 from typing import Any, Dict
+from warnings import warn
 
 from numpy import ndarray
 
-
 ExperimentData = Dict[str, Any]
 
 
@@ -45,6 +45,12 @@ def __post_init__(self) -> None:
             TypeError: If one of the data fields is not a Sequence or ``numpy.ndarray``.
             ValueError: Inconsistent number of experiments across data fields.
         """
+        warn(
+            "The class ``BasePrimitiveResult`` is deprecated as of qiskit 0.46.0. "
+            "It will be removed no earlier than 3 months after the release date. "
+            "Use PrimitiveResult in PrimitiveV2 instead.",
+            DeprecationWarning,
+        )
         for value in self._field_values:  # type: Sequence
             # TODO: enforce all data fields to be tuples instead of sequences
             if not isinstance(value, (Sequence, ndarray)) or isinstance(value, (str, bytes)):

qiskit/primitives/base/base_sampler.py

@@ -100,6 +100,7 @@ class BaseSampler(BasePrimitive, Generic[T]):
 
     __hash__ = None
 
+    @deprecate_func(since="0.46.0", additional_msg="Use BaseSamplerV2 instead.")
     def __init__(
         self,
         *,

qiskit/primitives/estimator.py

@@ -24,15 +24,11 @@
 from qiskit.exceptions import QiskitError
 from qiskit.quantum_info import Statevector
 from qiskit.quantum_info.operators.base_operator import BaseOperator
+from qiskit.utils.deprecation import deprecate_func
 
 from .base import BaseEstimator, EstimatorResult
 from .primitive_job import PrimitiveJob
-from .utils import (
-    _circuit_key,
-    _observable_key,
-    bound_circuit_to_instruction,
-    init_observable,
-)
+from .utils import _circuit_key, _observable_key, bound_circuit_to_instruction, init_observable
 
 
 class Estimator(BaseEstimator[PrimitiveJob[EstimatorResult]]):
@@ -51,6 +47,7 @@ class Estimator(BaseEstimator[PrimitiveJob[EstimatorResult]]):
           this option is ignored.
     """
 
+    @deprecate_func(since="0.46.0", additional_msg="Use StatevectorEstimator instead.")
     def __init__(self, *, options: dict | None = None):
         """
         Args:

qiskit/primitives/sampler.py

@@ -24,6 +24,7 @@
 from qiskit.exceptions import QiskitError
 from qiskit.quantum_info import Statevector
 from qiskit.result import QuasiDistribution
+from qiskit.utils.deprecation import deprecate_func
 
 from .base import BaseSampler, SamplerResult
 from .primitive_job import PrimitiveJob
@@ -52,6 +53,7 @@ class Sampler(BaseSampler[PrimitiveJob[SamplerResult]]):
           option is ignored.
     """
 
+    @deprecate_func(since="0.46.0", additional_msg="Use StatevectorSampler instead.")
     def __init__(self, *, options: dict | None = None):
         """
         Args:

qiskit/primitives/utils.py

@@ -22,11 +22,13 @@
 from qiskit.circuit import Instruction, QuantumCircuit
 from qiskit.circuit.bit import Bit
 from qiskit.circuit.library.data_preparation import Initialize
-from qiskit.quantum_info import SparsePauliOp, Statevector, PauliList
+from qiskit.quantum_info import PauliList, SparsePauliOp, Statevector
 from qiskit.quantum_info.operators.base_operator import BaseOperator
 from qiskit.quantum_info.operators.symplectic.base_pauli import BasePauli
+from qiskit.utils.deprecation import deprecate_func
 
 
+@deprecate_func(since="0.46.0")
 def init_circuit(state: QuantumCircuit | Statevector) -> QuantumCircuit:
     """Initialize state by converting the input to a quantum circuit.
 
@@ -45,6 +47,7 @@ def init_circuit(state: QuantumCircuit | Statevector) -> QuantumCircuit:
     return qc
 
 
+@deprecate_func(since="0.46.0")
 def init_observable(observable: BaseOperator | str) -> SparsePauliOp:
     """Initialize observable by converting the input to a :class:`~qiskit.quantum_info.SparsePauliOp`.
 
@@ -73,6 +76,7 @@ def init_observable(observable: BaseOperator | str) -> SparsePauliOp:
         return SparsePauliOp(observable)
 
 
+@deprecate_func(since="0.46.0")
 def final_measurement_mapping(circuit: QuantumCircuit) -> dict[int, int]:
     """Return the final measurement mapping for the circuit.
 

releasenotes/notes/deprecate-v1-3cdeb826e55f98cb.yaml

@@ -0,0 +1,4 @@
+---
+deprecations:
+  - |
+    PrimitivesV1 has been deprecated. Use PrimitivesV2 instead.