qiskit 1.3.2__cp39-abi3-win32.whl → 1.4.0__cp39-abi3-win32.whl

qiskit/transpiler/layout.py

@@ -445,10 +445,10 @@ class TranspileLayout:
 
     The :mod:`~qiskit.transpiler` is unitary-preserving up to the "initial layout"
     and "final layout" permutations. The initial layout permutation is caused by
-    setting and applying the initial layout during the :ref:`layout_stage`.
+    setting and applying the initial layout during the :ref:`transpiler-preset-stage-layout`.
     The final layout permutation is caused by :class:`~.SwapGate` insertion during
-    the :ref:`routing_stage`. This class provides an interface to reason about these
-    permutations using a variety of helper methods.
+    the :ref:`transpiler-preset-stage-routing`. This class provides an interface to reason about
+    these permutations using a variety of helper methods.
 
     During the layout stage, the transpiler can potentially remap the order of the
     qubits in the circuit as it fits the circuit to the target backend. For example,
@@ -524,7 +524,7 @@ class TranspileLayout:
     state from the transpiler. They are defined as:
 
       * :attr:`initial_layout` - This attribute is used to model the
-        permutation caused by the :ref:`layout_stage`. It is a
+        permutation caused by the :ref:`transpiler-preset-stage-layout`. It is a
         :class:`~.Layout` object that maps the input :class:`~.QuantumCircuit`\s
         :class:`~.circuit.Qubit` objects to the position in the output
         :class:`.QuantumCircuit.qubits` list.
@@ -536,12 +536,12 @@ class TranspileLayout:
         is needed when computing the permutation of the :class:`Operator` of
         the circuit (and used by :meth:`.Operator.from_circuit`).
       * :attr:`final_layout` - This attribute is used to model the
-        permutation caused by the :ref:`routing_stage`. It is a
+        permutation caused by the :ref:`transpiler-preset-stage-routing`. It is a
         :class:`~.Layout` object that maps the output circuit's qubits from
         :class:`.QuantumCircuit.qubits` in the output circuit to their final
         positions after routing. Importantly, this only represents the
         permutation caused by inserting :class:`~.SwapGate`\s into
-        the :class:`~.QuantumCircuit` during the :ref:`routing_stage`.
+        the :class:`~.QuantumCircuit` during the :ref:`transpiler-preset-stage-routing`.
         It is **not** a mapping from the original input circuit's position
         to the final position at the end of the transpiled circuit.
         If you need this, you can use the :meth:`.final_index_layout` to generate this.

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/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/sabre_layout.py

@@ -328,6 +328,19 @@ class SabreLayout(TransformationPass):
                 for initial, final in enumerate(component.final_permutation)
             }
         )
+
+        # The coupling map may have been split into more components than the DAG.  In this case,
+        # there will be some physical qubits unaccounted for in our `final_layout`.  Strictly the
+        # `if` check is unnecessary, but we can avoid the loop for most circuits and backends.
+        if len(final_layout) != len(physical_qubits):
+            used_qubits = {
+                qubit for component in components for qubit in component.coupling_map.graph.nodes()
+            }
+            for index, qubit in enumerate(physical_qubits):
+                if index in used_qubits:
+                    continue
+                final_layout[qubit] = index
+
         if self.property_set["final_layout"] is None:
             self.property_set["final_layout"] = final_layout
         else:

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/optimization/remove_identity_equiv.py

@@ -23,9 +23,8 @@ from qiskit._accelerate.remove_identity_equiv import remove_identity_equiv
 class RemoveIdentityEquivalent(TransformationPass):
     r"""Remove gates with negligible effects.
 
-    Removes gates whose effect is close to an identity operation, up to the specified
-    tolerance. Zero qubit gates such as :class:`.GlobalPhaseGate` are not considered
-    by this pass.
+    Removes gates whose effect is close to an identity operation up to a global phase
+    and up to the specified tolerance. Parameterized gates are not considered by this pass.
 
     For a cutoff fidelity :math:`f`, this pass removes gates whose average
     gate fidelity with respect to the identity is below :math:`f`. Concretely,

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/scheduling/scheduling/alap.py

@@ -20,7 +20,7 @@ from qiskit.transpiler.passes.scheduling.scheduling.base_scheduler import BaseSc
 class ALAPScheduleAnalysis(BaseScheduler):
     """ALAP Scheduling pass, which schedules the **stop** time of instructions as late as possible.
 
-    See the :ref:`scheduling_stage` section in the :mod:`qiskit.transpiler`
+    See the :ref:`transpiler-scheduling-description` section in the :mod:`qiskit.transpiler`
     module documentation for the detailed behavior of the control flow
     operation, i.e. ``c_if``.
     """

qiskit/transpiler/passes/scheduling/scheduling/asap.py

@@ -20,7 +20,7 @@ from qiskit.transpiler.passes.scheduling.scheduling.base_scheduler import BaseSc
 class ASAPScheduleAnalysis(BaseScheduler):
     """ASAP Scheduling pass, which schedules the start time of instructions as early as possible.
 
-    See the :ref:`scheduling_stage` section in the :mod:`qiskit.transpiler`
+    See the :ref:`transpiler-scheduling-description` section in the :mod:`qiskit.transpiler`
     module documentation for the detailed behavior of the control flow
     operation, i.e. ``c_if``.
     """

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,

qiskit/transpiler/passmanager_config.py

@@ -18,11 +18,22 @@ import warnings
 from qiskit.transpiler.coupling import CouplingMap
 from qiskit.transpiler.instruction_durations import InstructionDurations
 from qiskit.utils.deprecate_pulse import deprecate_pulse_arg
+from qiskit.utils.deprecation import deprecate_arg
 
 
 class PassManagerConfig:
     """Pass Manager Configuration."""
 
+    @deprecate_arg(
+        name="backend_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_pulse_arg("inst_map", predicate=lambda inst_map: inst_map is not None)
     def __init__(
         self,

qiskit/transpiler/preset_passmanagers/__init__.py

@@ -32,21 +32,23 @@ part) the stages that comprise the preset pass managers
 
 .. _preset_pass_manager_generators:
 
-Preset Pass Manager Generation
-------------------------------
+Low-level preset pass manager generation
+----------------------------------------
 
-.. autofunction:: generate_preset_pass_manager
 .. autofunction:: level_0_pass_manager
 .. autofunction:: level_1_pass_manager
 .. autofunction:: level_2_pass_manager
 .. autofunction:: level_3_pass_manager
 
+..
+    `generate_preset_pass_manager` is not documented here because it's documented to be at the root
+    of `qiskit.transpiler`.
+
 .. _stage_generators:
 
-Stage Generator Functions
+Stage generator functions
 -------------------------
 
-.. currentmodule:: qiskit.transpiler.preset_passmanagers.common
 .. autofunction:: generate_control_flow_options_check
 .. autofunction:: generate_error_on_control_flow
 .. autofunction:: generate_unroll_3q
@@ -55,8 +57,18 @@ Stage Generator Functions
 .. autofunction:: generate_pre_op_passmanager
 .. autofunction:: generate_translation_passmanager
 .. autofunction:: generate_scheduling
-.. currentmodule:: qiskit.transpiler.preset_passmanagers
 """
+
+from .common import (
+    generate_control_flow_options_check,
+    generate_error_on_control_flow,
+    generate_unroll_3q,
+    generate_embed_passmanager,
+    generate_routing_passmanager,
+    generate_pre_op_passmanager,
+    generate_translation_passmanager,
+    generate_scheduling,
+)
 from .generate_preset_pass_manager import generate_preset_pass_manager
 from .level0 import level_0_pass_manager
 from .level1 import level_1_pass_manager
@@ -70,4 +82,12 @@ __all__ = [
     "level_2_pass_manager",
     "level_3_pass_manager",
     "generate_preset_pass_manager",
+    "generate_control_flow_options_check",
+    "generate_error_on_control_flow",
+    "generate_unroll_3q",
+    "generate_embed_passmanager",
+    "generate_routing_passmanager",
+    "generate_pre_op_passmanager",
+    "generate_translation_passmanager",
+    "generate_scheduling",
 ]