qiskit 1.3.3__cp39-abi3-win32.whl → 1.4.1__cp39-abi3-win32.whl

qiskit/providers/basic_provider/basic_simulator.py

@@ -576,8 +576,14 @@ class BasicSimulator(BackendV2):
         self._memory = getattr(qobj.config, "memory", False)
         self._qobj_config = qobj.config
         start = time.time()
-        for experiment in qobj.experiments:
-            result_list.append(self.run_experiment(experiment))
+        with warnings.catch_warnings():
+            warnings.filterwarnings(
+                "ignore",
+                category=DeprecationWarning,
+                message=r".+qiskit\.providers\.basic_provider\.basic_simulator\..+",
+            )
+            for experiment in qobj.experiments:
+                result_list.append(self.run_experiment(experiment))
         end = time.time()
         result = {
             "backend_name": self.name,
@@ -590,9 +596,15 @@ class BasicSimulator(BackendV2):
             "time_taken": (end - start),
             "header": qobj.header.to_dict(),
         }
-
         return Result.from_dict(result)
 
+    @deprecate_func(
+        since="1.4.0",
+        removal_timeline="in Qiskit 2.0.0",
+        additional_msg="This method takes a `QasmQobjExperiment` as input argument. "
+        "The `Qobj` class and related functionality are part of the deprecated "
+        "`BackendV1` workflow,  and no longer necessary for `BackendV2`. Use `run` instead.",
+    )
     def run_experiment(self, experiment: QasmQobjExperiment) -> dict[str, ...]:
         """Run an experiment (circuit) and return a single experiment result.
 

qiskit/providers/exceptions.py

@@ -13,6 +13,7 @@
 """Exceptions for errors raised while handling Backends and Jobs."""
 
 from qiskit.exceptions import QiskitError
+from qiskit.utils import deprecate_func
 
 
 class JobError(QiskitError):
@@ -36,10 +37,30 @@ class QiskitBackendNotFoundError(QiskitError):
 class BackendPropertyError(QiskitError):
     """Base class for errors raised while looking for a backend property."""
 
-    pass
+    @deprecate_func(
+        since="1.4",
+        removal_timeline="in the 2.0 release",
+        additional_msg="The models in ``qiskit.providers.models`` and related objects are part "
+        "of the deprecated `BackendV1` workflow,  and no longer necessary for `BackendV2`. If a user "
+        "workflow requires these representations it likely relies on deprecated functionality and "
+        "should be updated to use `BackendV2`.",
+        stacklevel=2,
+    )
+    def __init__(self, *message):
+        super().__init__(*message)
 
 
 class BackendConfigurationError(QiskitError):
     """Base class for errors raised by the BackendConfiguration."""
 
-    pass
+    @deprecate_func(
+        since="1.4",
+        removal_timeline="in the 2.0 release",
+        additional_msg="The models in ``qiskit.providers.models`` and related objects are part "
+        "of the deprecated `BackendV1` workflow,  and no longer necessary for `BackendV2`. If a user "
+        "workflow requires these representations it likely relies on deprecated functionality and "
+        "should be updated to use `BackendV2`.",
+        stacklevel=2,
+    )
+    def __init__(self, *message):
+        super().__init__(*message)

qiskit/providers/models/backendproperties.py

@@ -34,6 +34,15 @@ class Nduv:
         value: value.
     """
 
+    @deprecate_func(
+        since="1.4",
+        removal_timeline="in the 2.0 release",
+        additional_msg="The models in ``qiskit.providers.models`` and related objects are part "
+        "of the deprecated `BackendV1` workflow,  and no longer necessary for `BackendV2`. If a user "
+        "workflow requires these representations it likely relies on deprecated functionality and "
+        "should be updated to use `BackendV2`.",
+        stacklevel=2,
+    )
     def __init__(self, date, name, unit, value):
         """Initialize a new name-date-unit-value object
 
@@ -97,6 +106,15 @@ class GateProperties:
 
     _data = {}
 
+    @deprecate_func(
+        since="1.4",
+        removal_timeline="in the 2.0 release",
+        additional_msg="The models in ``qiskit.providers.models`` and related objects are part "
+        "of the deprecated `BackendV1` workflow,  and no longer necessary for `BackendV2`. If a user "
+        "workflow requires these representations it likely relies on deprecated functionality and "
+        "should be updated to use `BackendV2`.",
+        stacklevel=2,
+    )
     def __init__(self, qubits, gate, parameters, **kwargs):
         """Initialize a new :class:`GateProperties` object
 
@@ -180,7 +198,7 @@ class BackendProperties:
         "of the deprecated `BackendV1` workflow,  and no longer necessary for `BackendV2`. If a user "
         "workflow requires these representations it likely relies on deprecated functionality and "
         "should be updated to use `BackendV2`.",
-        stacklevel=3,
+        stacklevel=2,
     )
     def __init__(
         self, backend_name, backend_version, last_update_date, qubits, gates, general, **kwargs

qiskit/providers/models/backendstatus.py

@@ -14,11 +14,21 @@
 
 import html
 from qiskit.exceptions import QiskitError
+from qiskit.utils import deprecate_func
 
 
 class BackendStatus:
     """Class representing Backend Status."""
 
+    @deprecate_func(
+        since="1.4",
+        removal_timeline="in the 2.0 release",
+        additional_msg="The models in ``qiskit.providers.models`` and related objects are part "
+        "of the deprecated `BackendV1` workflow,  and no longer necessary for `BackendV2`. If a user "
+        "workflow requires these representations it likely relies on deprecated functionality and "
+        "should be updated to use `BackendV2`.",
+        stacklevel=2,
+    )
     def __init__(
         self,
         backend_name: str,

qiskit/providers/models/jobstatus.py

@@ -12,6 +12,8 @@
 
 """Class for job status."""
 
+from qiskit.utils import deprecate_func
+
 
 class JobStatus:
     """Model for JobStatus.
@@ -24,6 +26,15 @@ class JobStatus:
 
     _data = {}
 
+    @deprecate_func(
+        since="1.4",
+        removal_timeline="in the 2.0 release",
+        additional_msg="The models in ``qiskit.providers.models`` and related objects are part "
+        "of the deprecated `BackendV1` workflow,  and no longer necessary for `BackendV2`. If a user "
+        "workflow requires these representations it likely relies on deprecated functionality and "
+        "should be updated to use `BackendV2`.",
+        stacklevel=2,
+    )
     def __init__(self, job_id, status, status_msg, **kwargs):
         self._data = {}
         self.job_id = job_id

qiskit/pulse/schedule.py

@@ -1637,7 +1637,7 @@ def _common_method(*classes):
     return decorator
 
 
-@deprecate_arg("show_barriers", new_alias="plot_barriers", since="1.1.0", pending=True)
+@deprecate_arg("show_barriers", new_alias="plot_barriers", since="1.4")
 @_common_method(Schedule, ScheduleBlock)
 def draw(
     self,

qiskit/pulse/utils.py

@@ -51,7 +51,7 @@ def format_parameter_value(
         decimal: Number of digit to round returned value.
 
     Returns:
-        Value casted to non-parameter data type, when possible.
+        Value cast to non-parameter data type, when possible.
     """
     if isinstance(operand, ParameterExpression):
         try:

qiskit/qpy/binary_io/value.py

@@ -142,6 +142,8 @@ def _encode_replay_subs(subs, file_obj, version):
 
 
 def _write_parameter_expression_v13(file_obj, obj, version):
+    # A symbol is `Parameter` or `ParameterVectorElement`.
+    # `symbol_map` maps symbols to ParameterExpression (which may be a symbol).
     symbol_map = {}
     for inst in obj._qpy_replay:
         if isinstance(inst, _SUBS):
@@ -234,9 +236,17 @@ def _write_parameter_expression(file_obj, obj, use_symengine, *, version):
             # serialize key
             if symbol_key == type_keys.Value.PARAMETER_VECTOR:
                 symbol_data = common.data_to_binary(symbol, _write_parameter_vec)
+            elif symbol_key == type_keys.Value.PARAMETER_EXPRESSION:
+                symbol_data = common.data_to_binary(
+                    symbol,
+                    _write_parameter_expression,
+                    use_symengine=use_symengine,
+                    version=version,
+                )
             else:
                 symbol_data = common.data_to_binary(symbol, _write_parameter)
             # serialize value
+
             value_key, value_data = dumps_value(
                 symbol, version=version, use_symengine=use_symengine
             )
@@ -516,10 +526,13 @@ def _read_parameter_expression_v13(file_obj, vectors, version):
             symbol = _read_parameter(file_obj)
         elif symbol_key == type_keys.Value.PARAMETER_VECTOR:
             symbol = _read_parameter_vec(file_obj, vectors)
+        elif symbol_key == type_keys.Value.PARAMETER_EXPRESSION:
+            symbol = _read_parameter_expression_v13(file_obj, vectors, version)
         else:
             raise exceptions.QpyError(f"Invalid parameter expression map type: {symbol_key}")
 
         elem_key = type_keys.Value(elem_data.type)
+
         binary_data = file_obj.read(elem_data.size)
         if elem_key == type_keys.Value.INTEGER:
             value = struct.unpack("!q", binary_data)
@@ -534,6 +547,7 @@ def _read_parameter_expression_v13(file_obj, vectors, version):
                 binary_data,
                 _read_parameter_expression_v13,
                 vectors=vectors,
+                version=version,
             )
         else:
             raise exceptions.QpyError(f"Invalid parameter expression map type: {elem_key}")

qiskit/result/result.py

@@ -12,6 +12,7 @@
 
 """Model for schema-conformant Results."""
 
+from collections.abc import Iterable
 import copy
 import warnings
 
@@ -25,47 +26,135 @@ from qiskit.result.counts import Counts
 from qiskit.qobj.utils import MeasLevel
 from qiskit.qobj import QobjHeader
 
+_MISSING = object()
+
 
 class Result:
     """Model for Results.
 
-    Attributes:
-        backend_name (str): backend name.
-        backend_version (str): backend version, in the form X.Y.Z.
-        qobj_id (str): user-generated Qobj id.
-        job_id (str): unique execution id from the backend.
-        success (bool): True if complete input qobj executed correctly. (Implies
+    .. deprecated:: 1.4
+        The use of positional arguments in the constructor of :class:`.Result`
+        is deprecated as of Qiskit 1.4, and will be disabled in Qiskit 2.0.
+        Please set all arguments using kwarg syntax, i.e: ``Result(backend_name="name", ....)``.
+        In addition to this, the ``qobj_id`` argument is deprecated and will no longer
+        be used in Qiskit 2.0. It will, however, still be possible to set ``qobj_id`` as a
+        generic kwarg, which will land in the metadata field with the other generic kwargs.
+
+    Args:
+        backend_name (str): (REQUIRED) backend name.
+        backend_version (str): (REQUIRED) backend version, in the form X.Y.Z.
+        qobj_id (str): (REQUIRED) user-generated Qobj id.
+        job_id (str): (REQUIRED) unique execution id from the backend.
+        success (bool): (REQUIRED) True if complete input qobj executed correctly. (Implies
             each experiment success)
-        results (list[ExperimentResult]): corresponding results for array of
+        results (list[ExperimentResult]): (REQUIRED) corresponding results for array of
             experiments of the input qobj
+        date (str): (OPTIONAL) date of the experiment
+        header(dict): (OPTIONAL)experiment header
+        kwargs: generic keyword arguments. (OPTIONAL) These will be stored in the metadata field.
     """
 
     _metadata = {}
 
     def __init__(
         self,
-        backend_name,
-        backend_version,
-        qobj_id,
-        job_id,
-        success,
-        results,
+        *args,
         date=None,
         status=None,
         header=None,
         **kwargs,
     ):
+        # The following arguments are required.
+        required_args = {
+            "backend_name": _MISSING,
+            "backend_version": _MISSING,
+            "qobj_id": _MISSING,
+            "job_id": _MISSING,
+            "success": _MISSING,
+            "results": _MISSING,
+        }
+        # Step 1: iterate over kwargs.
+        # An item from required_args might be set as a kwarg, so we must separate
+        # true kwargs from "required_args" kwargs.
+        true_kwargs = {}
+        for key, value in kwargs.items():
+            if key in required_args:
+                required_args[key] = value
+            else:
+                true_kwargs[key] = value
+        # Step 2: iterate over args, which are expected in the order of the index_map below.
+        index_map = ["backend_name", "backend_version", "qobj_id", "job_id", "success", "results"]
+        raise_qobj = False
+        missing_args = []
+        for index, name in enumerate(index_map):
+            try:
+                value = args[index]
+                required_args[name] = value
+                # The use of args is deprecated in 1.4 and will be removed in 2.0.
+                # Furthermore, qobj_id will be ignored if set as a kwarg in 2.0.
+                if name == "qobj_id":
+                    warnings.warn(
+                        "The use of positional arguments in `qiskit.result.result.Result.__init__()` "
+                        "is deprecated as of Qiskit 1.4, and will be disabled in Qiskit 2.0. "
+                        "Please set this value using kwarg syntax, "
+                        f"i.e: `Result(...,{name}={name}_value)`. "
+                        "The `qobj_id` argument will no longer be used in Qiskit 2.0, "
+                        "but it will still be possible to "
+                        "set as a kwarg that will land in the metadata field.",
+                        category=DeprecationWarning,
+                        stacklevel=2,
+                    )
+                else:
+                    warnings.warn(
+                        "The use of positional arguments in `qiskit.result.result.Result.__init__()` "
+                        "is deprecated as of Qiskit 1.4, and will be disabled in Qiskit 2.0. "
+                        "Please set this value using kwarg syntax, "
+                        f"i.e: `Result(...,{name}={name}_value)`. ",
+                        category=DeprecationWarning,
+                        stacklevel=2,
+                    )
+            except IndexError:
+                if required_args[name] is _MISSING:
+                    missing_args = [
+                        key for (key, value) in required_args.items() if value is _MISSING
+                    ]
+                elif name == "qobj_id":
+                    raise_qobj = True
+                break
+
+        # The deprecation warning should be raised outside of the try-except,
+        # not to show a confusing trace that points to the IndexError
+        if len(missing_args) > 1:
+            raise TypeError(
+                f"Result.__init__() missing {len(missing_args)} required arguments: {missing_args}"
+            )
+        if len(missing_args) == 1:
+            raise TypeError(f"Result.__init__() missing a required argument: {missing_args[0]}")
+        if raise_qobj:
+            # qobj_id will be ignored if set as a kwarg in 2.0.
+            warnings.warn(
+                "The `qobj_id` argument will no longer be used in Qiskit 2.0, "
+                "but it will still be possible to "
+                "set as a kwarg that will land in the metadata field.",
+                category=DeprecationWarning,
+                stacklevel=2,
+            )
+
         self._metadata = {}
-        self.backend_name = backend_name
-        self.backend_version = backend_version
-        self.qobj_id = qobj_id
-        self.job_id = job_id
-        self.success = success
-        self.results = results
+        self.backend_name = required_args["backend_name"]
+        self.backend_version = required_args["backend_version"]
+        self.qobj_id = required_args["qobj_id"]
+        self.job_id = required_args["job_id"]
+        self.success = required_args["success"]
+        self.results = (
+            [required_args["results"]]
+            if not isinstance(required_args["results"], Iterable)
+            else required_args["results"]
+        )
         self.date = date
         self.status = status
         self.header = header
-        self._metadata.update(kwargs)
+        self._metadata.update(true_kwargs)
 
     def __repr__(self):
         out = (

qiskit/synthesis/evolution/product_formula.py

@@ -44,7 +44,7 @@ class ProductFormula(EvolutionSynthesis):
 
     @deprecate_arg(
         name="atomic_evolution",
-        since="1.2",
+        since="1.4",
         predicate=lambda callable: callable is not None
         and len(inspect.signature(callable).parameters) == 2,
         deprecation_description=(
@@ -55,7 +55,6 @@ class ProductFormula(EvolutionSynthesis):
             "Instead you should update your 'atomic_evolution' function to be of the following "
             "type: 'Callable[[QuantumCircuit, Pauli | SparsePauliOp, float], None]'."
         ),
-        pending=True,
     )
     def __init__(
         self,

qiskit/synthesis/evolution/qdrift.py

@@ -43,7 +43,7 @@ class QDrift(ProductFormula):
 
     @deprecate_arg(
         name="atomic_evolution",
-        since="1.2",
+        since="1.4",
         predicate=lambda callable: callable is not None
         and len(inspect.signature(callable).parameters) == 2,
         deprecation_description=(
@@ -54,7 +54,6 @@ class QDrift(ProductFormula):
             "Instead you should update your 'atomic_evolution' function to be of the following "
             "type: 'Callable[[QuantumCircuit, Pauli | SparsePauliOp, float], None]'."
         ),
-        pending=True,
     )
     def __init__(
         self,

qiskit/synthesis/evolution/suzuki_trotter.py

@@ -62,7 +62,7 @@ class SuzukiTrotter(ProductFormula):
 
     @deprecate_arg(
         name="atomic_evolution",
-        since="1.2",
+        since="1.4",
         predicate=lambda callable: callable is not None
         and len(inspect.signature(callable).parameters) == 2,
         deprecation_description=(
@@ -73,7 +73,6 @@ class SuzukiTrotter(ProductFormula):
             "Instead you should update your 'atomic_evolution' function to be of the following "
             "type: 'Callable[[QuantumCircuit, Pauli | SparsePauliOp, float], None]'."
         ),
-        pending=True,
     )
     def __init__(
         self,

qiskit/transpiler/passes/calibration/rzx_templates.py

@@ -16,10 +16,17 @@ Convenience function to load RZXGate based templates.
 
 from enum import Enum
 from typing import List, Dict
+from qiskit.utils import deprecate_func
 
 from qiskit.circuit.library.templates import rzx
 
 
+@deprecate_func(
+    since="1.4",
+    removal_timeline="in Qiskit 2.0",
+    additional_msg="Use the functions in "
+    "qiskit.circuit.library.templates.rzx instead to generate rzx templates",
+)
 def rzx_templates(template_list: List[str] = None) -> Dict:
     """Convenience function to get the cost_dict and templates for template matching.
 

qiskit/transpiler/passes/layout/apply_layout.py

@@ -59,6 +59,7 @@ class ApplyLayout(TransformationPass):
         q = QuantumRegister(len(layout), "q")
 
         new_dag = DAGCircuit()
+        new_dag.name = dag.name
         new_dag.add_qreg(q)
         for var in dag.iter_input_vars():
             new_dag.add_input_var(var)

qiskit/transpiler/passes/layout/dense_layout.py

@@ -21,6 +21,8 @@ from qiskit.transpiler.basepasses import AnalysisPass
 from qiskit.transpiler.exceptions import TranspilerError
 from qiskit.transpiler.passes.layout import disjoint_utils
 
+from qiskit.utils import deprecate_arg
+
 from qiskit._accelerate.dense_layout import best_subset
 
 
@@ -36,6 +38,16 @@ class DenseLayout(AnalysisPass):
         by being set in ``property_set``.
     """
 
+    @deprecate_arg(
+        name="backend_prop",
+        since="1.4",
+        package_name="Qiskit",
+        removal_timeline="in Qiskit 2.0",
+        additional_msg="The BackendProperties data structure has been deprecated and will be "
+        "removed in Qiskit 2.0. The `target` input argument should be used instead. "
+        "You can use Target.from_configuration() to build the target from the properties "
+        "object, but in 2.0 you will need to generate a target directly.",
+    )
     def __init__(self, coupling_map=None, backend_prop=None, target=None):
         """DenseLayout initializer.
 

qiskit/transpiler/passes/layout/vf2_layout.py

@@ -24,6 +24,7 @@ from qiskit.transpiler.basepasses import AnalysisPass
 from qiskit.transpiler.exceptions import TranspilerError
 from qiskit.transpiler.passes.layout import vf2_utils
 
+from qiskit.utils import deprecate_arg
 
 logger = logging.getLogger(__name__)
 
@@ -73,6 +74,16 @@ class VF2Layout(AnalysisPass):
     ``vf2_avg_error_map`` key in the property set when :class:`~.VF2Layout` is run.
     """
 
+    @deprecate_arg(
+        name="properties",
+        since="1.4",
+        package_name="Qiskit",
+        removal_timeline="in Qiskit 2.0",
+        additional_msg="The BackendProperties data structure has been deprecated and will be "
+        "removed in Qiskit 2.0. The `target` input argument should be used instead. "
+        "You can use Target.from_configuration() to build the target from the properties "
+        "object, but in 2.0 you will need to generate a target directly.",
+    )
     def __init__(
         self,
         coupling_map=None,

qiskit/transpiler/passes/layout/vf2_post_layout.py

@@ -26,6 +26,7 @@ from qiskit.transpiler.exceptions import TranspilerError
 from qiskit.providers.exceptions import BackendPropertyError
 from qiskit.transpiler.passes.layout import vf2_utils
 
+from qiskit.utils import deprecate_arg
 
 logger = logging.getLogger(__name__)
 
@@ -99,6 +100,27 @@ class VF2PostLayout(AnalysisPass):
     is run.
     """
 
+    @deprecate_arg(
+        name="properties",
+        since="1.4",
+        package_name="Qiskit",
+        removal_timeline="in Qiskit 2.0",
+        additional_msg="The BackendProperties data structure has been deprecated and will be "
+        "removed in Qiskit 2.0. The `target` input argument should be used instead. "
+        "You can use Target.from_configuration() to build the target from the properties "
+        "object, but in 2.0 you will need to generate a target directly.",
+    )
+    @deprecate_arg(
+        name="coupling_map",
+        since="1.4",
+        package_name="Qiskit",
+        removal_timeline="in Qiskit 2.0",
+        additional_msg="This argument was only used with `properties`, which relied on "
+        "the deprecated BackendProperties data structure. The `target` input argument "
+        "should be used instead. "
+        "You can use Target.from_configuration() to build the target from coupling "
+        "map + properties, but in 2.0 you will need to generate a target directly.",
+    )
     def __init__(
         self,
         target=None,

qiskit/transpiler/passes/optimization/normalize_rx_angle.py

@@ -20,6 +20,8 @@ that differ within a resolution provided by the user.
 
 import numpy as np
 
+from qiskit.utils import deprecate_func
+
 from qiskit.transpiler.basepasses import TransformationPass
 from qiskit.dagcircuit import DAGCircuit
 from qiskit.circuit.library.standard_gates import RXGate, RZGate, SXGate, XGate
@@ -48,6 +50,12 @@ class NormalizeRXAngle(TransformationPass):
     Note that pulse calibration might be attached per each rotation angle.
     """
 
+    @deprecate_func(
+        since="1.4",
+        removal_timeline="in Qiskit 2.0",
+        additional_msg="This pass was used as pre-processing step of ``RXCalibrationBuilder``."
+        " With the removal of Pulse in Qiskit 2.0, this pass is no longer needed.",
+    )
     def __init__(self, target=None, resolution_in_radian=0):
         """NormalizeRXAngle initializer.
 

qiskit/transpiler/passes/routing/star_prerouting.py

@@ -11,12 +11,20 @@
 # that they have been altered from the originals.
 
 """Search for star connectivity patterns and replace them with."""
+import itertools
 from typing import Iterable, Union, Optional, List, Tuple
 from math import floor, log10
 
 from qiskit.circuit import SwitchCaseOp, Clbit, ClassicalRegister, Barrier
 from qiskit.circuit.controlflow import condition_resources, node_resources
-from qiskit.dagcircuit import DAGOpNode, DAGDepNode, DAGDependency, DAGCircuit
+from qiskit.dagcircuit import (
+    DAGOpNode,
+    DAGDepNode,
+    DAGDependency,
+    DAGCircuit,
+    DAGOutNode,
+    DAGInNode,
+)
 from qiskit.transpiler.basepasses import TransformationPass
 from qiskit.transpiler.layout import Layout
 from qiskit.transpiler.passes.routing.sabre_swap import _build_sabre_dag, _apply_sabre_result
@@ -331,7 +339,14 @@ class StarPreRouting(TransformationPass):
         }
 
         def tie_breaker_key(node):
-            return processing_order_index_map.get(node, node.sort_key)
+            processing_order = processing_order_index_map.get(node, None)
+            if processing_order is not None:
+                return processing_order
+            if isinstance(node, (DAGInNode, DAGOutNode)):
+                return str(node.wire)
+            return ",".join(
+                f"{dag.find_bit(q).index:04d}" for q in itertools.chain(node.qargs, node.cargs)
+            )
 
         rust_processing_order = _extract_nodes(dag.topological_op_nodes(key=tie_breaker_key), dag)
 

qiskit/transpiler/passes/synthesis/unitary_synthesis.py

@@ -73,6 +73,7 @@ from qiskit.transpiler.passes.optimization.optimize_1q_decomposition import (
 from qiskit.transpiler.passes.synthesis import plugin
 from qiskit.transpiler.target import Target
 
+from qiskit.utils.deprecation import deprecate_arg
 from qiskit._accelerate.unitary_synthesis import run_default_main_loop
 
 GATE_NAME_MAP = {
@@ -315,6 +316,16 @@ def _preferred_direction(
 class UnitarySynthesis(TransformationPass):
     """Synthesize gates according to their basis gates."""
 
+    @deprecate_arg(
+        name="backend_props",
+        since="1.4",
+        package_name="Qiskit",
+        removal_timeline="in Qiskit 2.0",
+        additional_msg="The BackendProperties data structure has been deprecated and will be "
+        "removed in Qiskit 2.0. The `target` input argument should be used instead. "
+        "You can use Target.from_configuration() to build the target from the properties "
+        "object, but in 2.0 you will need to generate a target directly.",
+    )
     def __init__(
         self,
         basis_gates: list[str] = None,