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

qiskit/transpiler/preset_passmanagers/generate_preset_pass_manager.py

@@ -344,13 +344,34 @@ def generate_preset_pass_manager(
             # preserve the former behavior of transpile.
             backend_properties = _parse_backend_properties(backend_properties, backend)
             with warnings.catch_warnings():
-                # TODO: inst_map will be removed in 2.0
+                # TODO: inst_map and backend_properties will be removed in 2.0
                 warnings.filterwarnings(
                     "ignore",
                     category=DeprecationWarning,
                     message=".*``inst_map`` is deprecated as of Qiskit 1.3.*",
                     module="qiskit",
                 )
+                warnings.filterwarnings(
+                    "ignore",
+                    category=DeprecationWarning,
+                    message=".* ``backend_properties`` is deprecated as of Qiskit 1.4",
+                    module="qiskit",
+                )
+                warnings.filterwarnings(
+                    "ignore",
+                    category=DeprecationWarning,
+                    message=".*``qiskit.providers.exceptions.BackendPropertyError``",
+                )
+                # TODO: This is a temporary usage of deprecated backend_properties in
+                #   Target.from_configuration. Probably the logic needs to be restructured
+                #   in a more target-centric transpiler
+                #   https://github.com/Qiskit/qiskit/issues/9256
+                warnings.filterwarnings(
+                    "ignore",
+                    category=DeprecationWarning,
+                    message=r".+qiskit\.transpiler\.target\.Target\.from_configuration.+",
+                    module="qiskit",
+                )
                 # Build target from constraints.
                 target = Target.from_configuration(
                     basis_gates=basis_gates,
@@ -403,7 +424,6 @@ def generate_preset_pass_manager(
     initial_layout = _parse_initial_layout(initial_layout)
     approximation_degree = _parse_approximation_degree(approximation_degree)
     seed_transpiler = _parse_seed_transpiler(seed_transpiler)
-
     pm_options = {
         "target": target,
         "basis_gates": basis_gates,
@@ -428,12 +448,18 @@ def generate_preset_pass_manager(
     }
 
     with warnings.catch_warnings():
-        # inst_map is deprecated in the PassManagerConfig initializer
+        # inst_map and backend_properties are deprecated in the PassManagerConfig initializer
         warnings.filterwarnings(
             "ignore",
             category=DeprecationWarning,
             message=".*argument ``inst_map`` is deprecated as of Qiskit 1.3",
         )
+        warnings.filterwarnings(
+            "ignore",
+            category=DeprecationWarning,
+            message=".*argument ``backend_properties`` is deprecated as of Qiskit 1.4",
+            module="qiskit",
+        )
         if backend is not None:
             pm_options["_skip_target"] = _skip_target
             pm_config = PassManagerConfig.from_backend(backend, **pm_options)

qiskit/transpiler/preset_passmanagers/plugin.py

@@ -11,6 +11,8 @@
 # that they have been altered from the originals.
 
 """
+.. _transpiler-preset-stage-plugins:
+
 =======================================================================================
 Transpiler Stage Plugin Interface (:mod:`qiskit.transpiler.preset_passmanagers.plugin`)
 =======================================================================================
@@ -35,8 +37,10 @@ see :mod:`qiskit.transpiler.passes.synthesis.plugin`.
 Plugin Stages
 =============
 
-Currently, there are 6 stages in the preset pass managers, all of which actively
-load external plugins via corresponding entry points.
+There are six stages in the preset pass managers, all of which actively
+load external plugins using corresponding entry points.  The following table summarizes
+each stage.  For more details on the description and expectations of each stage, follow the link
+in the stages' names to the full documentation.
 
 .. list-table:: Stages
    :header-rows: 1
@@ -44,57 +48,44 @@ load external plugins via corresponding entry points.
    * - Stage Name
      - Entry Point
      - Reserved Names
-     - Description and expectations
-   * - ``init``
+     - Summary
+
+   * - :ref:`init <transpiler-preset-stage-init>`
      - ``qiskit.transpiler.init``
      - ``default``
-     - This stage runs first and is typically used for any initial logical optimization. Because most
-       layout and routing algorithms are only designed to work with 1 and 2 qubit gates, this stage
-       is also used to translate any gates that operate on more than 2 qubits into gates that only
-       operate on 1 or 2 qubits.
-   * - ``layout``
+     - High-level, logical optimizations on abstract circuits, and reduction of multi-qubit
+       operations to one- and two-qubit operations.
+
+   * - :ref:`layout <transpiler-preset-stage-layout>`
      - ``qiskit.transpiler.layout``
      - ``trivial``, ``dense``, ``sabre``, ``default``
-     - The output from this stage is expected to have the ``layout`` property
-       set field set with a :class:`~.Layout` object. Additionally, the circuit is
-       typically expected to be embedded so that it is expanded to include all
-       qubits and the :class:`~.ApplyLayout` pass is expected to be run to apply the
-       layout. The embedding of the :class:`~.Layout` can be generated with
-       :func:`~.generate_embed_passmanager`.
-   * - ``routing``
+     - Choose an initial mapping of virtual qubits to physical qubits, including expansion of the
+       circuit to include explicit ancillas.  This stage is sometimes combined with ``routing``.
+
+   * - :ref:`routing <transpiler-preset-stage-routing>`
      - ``qiskit.transpiler.routing``
      - ``basic``, ``stochastic``, ``lookahead``, ``sabre``
-     - The output from this stage is expected to have the circuit match the
-       connectivity constraints of the target backend. This does not necessarily
-       need to match the directionality of the edges in the target as a later
-       stage typically will adjust directional gates to match that constraint
-       (but there is no penalty for doing that in the ``routing`` stage). The output
-       of this stage is also expected to have the ``final_layout`` property set field
-       set with a :class:`~.Layout` object that maps the :class:`.Qubit` to the
-       output final position of that qubit in the circuit. If there is an
-       existing ``final_layout`` entry in the property set (such as might be set
-       by an optimization pass that introduces a permutation) it is expected
-       that the final layout will be the composition of the two layouts (this
-       can be computed using :meth:`.DAGCircuit.compose`, for example:
-       ``second_final_layout.compose(first_final_layout, dag.qubits)``).
-   * - ``translation``
+     - Insert gates into the circuit to ensure it matches the connectivity constraints of the
+       :class:`.Target`.  The inserted gates do not need to be in the target ISA yet, so are often
+       just output as ``swap`` instructions.  This stage is sometimes subsumed by ``layout``.
+
+   * - :ref:`translation <transpiler-preset-stage-translation>`
      - ``qiskit.transpiler.translation``
-     - ``translator``, ``synthesis``, ``unroller``
-     - The output of this stage is expected to have every operation be a native
-        instruction on the target backend.
-   * - ``optimization``
+     - ``translator``, ``synthesis``
+     - Rewrite all gates outside the target ISA to use only gates within the ISA.
+
+   * - :ref:`optimization <transpiler-preset-stage-optimization>`
      - ``qiskit.transpiler.optimization``
      - ``default``
-     - This stage is expected to perform optimization and simplification.
-       The constraints from earlier stages still apply to the output of this
-       stage. After the ``optimization`` stage is run we expect the circuit
-       to still be executable on the target.
-   * - ``scheduling``
+     - Low-level, physical-circuit-aware optimizations.  Unlike ``init``, the ``optimization`` stage
+       acts at the level of a physical circuit.
+
+   * - :ref:`scheduling <transpiler-preset-stage-scheduling>`
      - ``qiskit.transpiler.scheduling``
      - ``alap``, ``asap``, ``default``
-     - This is the last stage run and it is expected to output a scheduled
-       circuit such that all idle periods in the circuit are marked by explicit
-       :class:`~qiskit.circuit.Delay` instructions.
+     - Insert :class:`~.circuit.Delay` instructions to make the wall-clock timing of the circuit
+       fully explicit.
+
 
 Writing Plugins
 ===============

qiskit/transpiler/target.py

@@ -56,9 +56,10 @@ from qiskit.exceptions import QiskitError
 # full target
 from qiskit.providers.backend import QubitProperties  # pylint: disable=unused-import
 from qiskit.providers.models.backendproperties import BackendProperties
-from qiskit.utils import deprecate_func
+from qiskit.utils import deprecate_func, deprecate_arg
 from qiskit.utils.deprecate_pulse import deprecate_pulse_dependency, deprecate_pulse_arg
 
+
 logger = logging.getLogger(__name__)
 
 
@@ -656,28 +657,43 @@ class Target(BaseTarget):
         self,
         operation_name: str,
         qargs: tuple[int, ...],
+        operation_params: list[float] | float | None = None,
     ) -> bool:
-        """Return whether the instruction (operation + qubits) defines a calibration.
+        """Return whether the instruction (operation + operation_params + qubits) defines
+        a calibration.
 
         Args:
             operation_name: The name of the operation for the instruction.
-            qargs: The tuple of qubit indices for the instruction.
+            qargs: The qubit indices for the instruction.
+            operation_params: The parameters for the Instruction. In case
+            of multi-parameter gates, the order of parameters in the tuple
+            must match the order of the gate parameters.
 
         Returns:
             Returns ``True`` if the calibration is supported and ``False`` if it isn't.
         """
-        return self._has_calibration(operation_name, qargs)
+        return self._has_calibration(operation_name, qargs, operation_params)
 
     def _has_calibration(
         self,
         operation_name: str,
         qargs: tuple[int, ...],
+        operation_params: list[float] | float | None = None,
     ) -> bool:
-        qargs = tuple(qargs)
+        if operation_params is not None and not isinstance(operation_params, list):
+            operation_params = [operation_params]
+
         if operation_name not in self._gate_map:
             return False
+
         if qargs not in self._gate_map[operation_name]:
             return False
+
+        if operation_params is not None and not (
+            operation_params == self._gate_name_map[operation_name].params
+        ):
+            return False
+
         return getattr(self._gate_map[operation_name][qargs], "_calibration", None) is not None
 
     @deprecate_pulse_dependency
@@ -686,6 +702,7 @@ class Target(BaseTarget):
         operation_name: str,
         qargs: tuple[int, ...],
         *args: ParameterValueType,
+        operation_params: list[float] | float | None = None,
         **kwargs: ParameterValueType,
     ) -> Schedule | ScheduleBlock:
         """Get calibrated pulse schedule for the instruction.
@@ -695,25 +712,32 @@ class Target(BaseTarget):
 
         Args:
             operation_name: The name of the operation for the instruction.
-            qargs: The tuple of qubit indices for the instruction.
+            qargs: The qubit indices for the instruction.
             args: Parameter values to build schedule if any.
+            operation_params: The parameters for the Instruction. In case
+            of multi-parameter gate, the order of parameters in the tuple
+            must match the order of the gate parameters.
             kwargs: Parameter values with name to build schedule if any.
 
         Returns:
             Calibrated pulse schedule of corresponding instruction.
         """
-        return self._get_calibration(operation_name, qargs, *args, *kwargs)
+        return self._get_calibration(
+            operation_name, qargs, *args, operation_params=operation_params, **kwargs
+        )
 
     def _get_calibration(
         self,
         operation_name: str,
         qargs: tuple[int, ...],
         *args: ParameterValueType,
+        operation_params: list[float] | float | None = None,
         **kwargs: ParameterValueType,
     ) -> Schedule | ScheduleBlock:
-        if not self._has_calibration(operation_name, qargs):
+        if not self._has_calibration(operation_name, qargs, operation_params):
             raise KeyError(
-                f"Calibration of instruction {operation_name} for qubit {qargs} is not defined."
+                f"Calibration of instruction: `{operation_name}`, with params: "
+                f"`{operation_params}` for qubit: {qargs} is not defined."
             )
         cal_entry = getattr(self._gate_map[operation_name][qargs], "_calibration")
         return cal_entry.get_schedule(*args, **kwargs)
@@ -971,6 +995,14 @@ class Target(BaseTarget):
 
     @classmethod
     @deprecate_pulse_arg("inst_map")
+    @deprecate_arg(
+        name="backend_properties",
+        since="1.4",
+        package_name="Qiskit",
+        removal_timeline="in Qiskit 2.0",
+        additional_msg="To add instructions with specific properties "
+        "use Target.add_instruction(instruction, properties, name).",
+    )
     def from_configuration(
         cls,
         basis_gates: list[str],

qiskit/visualization/circuit/text.py

@@ -1153,9 +1153,10 @@ class TextDrawing:
             if not self.plotbarriers:
                 return layer, current_cons, current_cons_cond, connection_label
 
-            for i, qubit in enumerate(node.qargs):
+            top_qubit = min(node.qargs, key=lambda q: self._wire_map.get(q, float("inf")))
+            for qubit in node.qargs:
                 if qubit in self.qubits:
-                    label = op.label if i == 0 else ""
+                    label = op.label if qubit == top_qubit else ""
                     layer.set_qubit(qubit, Barrier(label))
 
         elif isinstance(op, SwapGate):

qiskit/visualization/gate_map.py

@@ -13,6 +13,7 @@
 """A module for visualizing device coupling maps"""
 
 import math
+import warnings
 from typing import List
 
 import numpy as np
@@ -21,6 +22,7 @@ from rustworkx.visualization import graphviz_draw
 
 from qiskit.exceptions import QiskitError
 from qiskit.utils import optionals as _optionals
+from qiskit.providers import BackendV2
 from qiskit.providers.exceptions import BackendPropertyError
 from qiskit.transpiler.coupling import CouplingMap
 from .exceptions import VisualizationError
@@ -50,6 +52,12 @@ def plot_gate_map(
 ):
     """Plots the gate map of a device.
 
+    .. deprecated:: 1.4
+        The function ``plot_gate_map`` will stop supporting inputs of type
+        :class:`.BackendV1` in the `backend` parameter in a future release no
+        earlier than 2.0. :class:`.BackendV1` is deprecated and implementations should
+        move to :class:`.BackendV2`.
+
     Args:
         backend (Backend): The backend instance that will be used to plot the device
             gate map.
@@ -92,6 +100,15 @@ def plot_gate_map(
 
            plot_gate_map(backend)
     """
+    if not isinstance(backend, BackendV2):
+        warnings.warn(
+            "The function `plot_gate_map` will stop supporting inputs of "
+            f"type `BackendV1` ( {backend} ) in the `backend` parameter in a future "
+            "release no earlier than 2.0. `BackendV1` is deprecated and implementations "
+            "should move to `BackendV2`.",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
     qubit_coordinates_map = {}
 
     qubit_coordinates_map[5] = [[1, 0], [0, 1], [1, 1], [1, 2], [2, 1]]
@@ -1145,6 +1162,12 @@ def plot_circuit_layout(circuit, backend, view="virtual", qubit_coordinates=None
     """Plot the layout of a circuit transpiled for a given
     target backend.
 
+    .. deprecated:: 1.4
+        The function ``plot_circuit_layout`` will stop supporting inputs of type
+        :class:`.BackendV1` in the `backend` parameter in a future release no
+        earlier than 2.0. :class:`.BackendV1` is deprecated and implementations should
+        move to :class:`.BackendV2`.
+
     Args:
         circuit (QuantumCircuit): Input quantum circuit.
         backend (Backend): Target backend.
@@ -1187,6 +1210,17 @@ def plot_circuit_layout(circuit, backend, view="virtual", qubit_coordinates=None
             new_circ_lv3 = transpile(ghz, backend=backend, optimization_level=3)
             plot_circuit_layout(new_circ_lv3, backend)
     """
+
+    if not isinstance(backend, BackendV2):
+        warnings.warn(
+            "The function `plot_circuit_layout` will stop supporting inputs of "
+            f"type `BackendV1` ( {backend} ) in the `backend` parameter in a future "
+            "release no earlier than 2.0. `BackendV1` is deprecated and implementations "
+            "should move to `BackendV2`.",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+
     if circuit._layout is None:
         raise QiskitError("Circuit has no layout. Perhaps it has not been transpiled.")
 
@@ -1254,6 +1288,12 @@ def plot_circuit_layout(circuit, backend, view="virtual", qubit_coordinates=None
 def plot_error_map(backend, figsize=(15, 12), show_title=True, qubit_coordinates=None):
     """Plots the error map of a given backend.
 
+    .. deprecated:: 1.4
+        The function ``plot_error_map`` will stop supporting inputs of type
+        :class:`.BackendV1` in the `backend` parameter in a future release no
+        earlier than 2.0. :class:`.BackendV1` is deprecated and implementations should
+        move to :class:`.BackendV2`.
+
     Args:
         backend (Backend): Given backend.
         figsize (tuple): Figure size in inches.
@@ -1282,6 +1322,16 @@ def plot_error_map(backend, figsize=(15, 12), show_title=True, qubit_coordinates
             backend = GenericBackendV2(num_qubits=5)
             plot_error_map(backend)
     """
+    if not isinstance(backend, BackendV2):
+        warnings.warn(
+            "The function `plot_error_map` will stop supporting inputs of "
+            f"type `BackendV1` ( {backend} ) in the `backend` parameter in a future "
+            "release no earlier than 2.0. `BackendV1` is deprecated and implementations "
+            "should move to `BackendV2`.",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+
     import matplotlib
     import matplotlib.pyplot as plt
     from matplotlib import gridspec, ticker

qiskit/visualization/pulse_v2/interface.py

@@ -27,12 +27,10 @@ from qiskit.pulse.channels import Channel
 from qiskit.visualization.exceptions import VisualizationError
 from qiskit.visualization.pulse_v2 import core, device_info, stylesheet, types
 from qiskit.exceptions import MissingOptionalLibraryError
-from qiskit.utils import deprecate_arg
 from qiskit.utils.deprecate_pulse import deprecate_pulse_dependency
 
 
 @deprecate_pulse_dependency(moving_to_dynamics=True)
-@deprecate_arg("show_barrier", new_alias="plot_barrier", since="1.1.0", pending=True)
 def draw(
     program: Union[Waveform, SymbolicPulse, Schedule, ScheduleBlock],
     style: Optional[Dict[str, Any]] = None,

qiskit/visualization/timeline/interface.py

@@ -30,8 +30,8 @@ from qiskit.visualization.timeline import types, core, stylesheet
 from qiskit.utils import deprecate_arg
 
 
-@deprecate_arg("show_idle", new_alias="idle_wires", since="1.1.0", pending=True)
-@deprecate_arg("show_barriers", new_alias="plot_barriers", since="1.1.0", pending=True)
+@deprecate_arg("show_idle", new_alias="idle_wires", since="1.4")
+@deprecate_arg("show_barriers", new_alias="plot_barriers", since="1.4")
 def draw(
     program: circuit.QuantumCircuit,
     style: Optional[Dict[str, Any]] = None,
@@ -372,7 +372,7 @@ def draw(
         warnings.warn(
             "Target is not specified. In Qiskit 2.0.0 this will be required to get the duration of "
             "instructions.",
-            PendingDeprecationWarning,
+            DeprecationWarning,
             stacklevel=2,
         )
 

{qiskit-1.3.2.dist-info → qiskit-1.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: qiskit
-Version: 1.3.2
+Version: 1.4.0
 Summary: An open-source SDK for working with quantum computers at the level of extended quantum circuits, operators, and primitives.
 Author-email: Qiskit Development Team <qiskit@us.ibm.com>
 License: Apache 2.0
@@ -56,7 +56,7 @@ Requires-Dist: qiskit[crosstalk-pass,csp-layout-pass,qasm3-import,visualization]
 
 [![License](https://img.shields.io/github/license/Qiskit/qiskit.svg?)](https://opensource.org/licenses/Apache-2.0) <!--- long-description-skip-begin -->
 [![Current Release](https://img.shields.io/github/release/Qiskit/qiskit.svg?logo=Qiskit)](https://github.com/Qiskit/qiskit/releases)
-[![Extended Support Release](https://img.shields.io/github/v/release/Qiskit/qiskit?sort=semver&filter=0.*&logo=Qiskit&label=extended%20support)](https://github.com/Qiskit/qiskit/releases?q=tag%3A0)
+<!-- [![Extended Support Release](https://img.shields.io/github/v/release/Qiskit/qiskit?sort=semver&filter=0.*&logo=Qiskit&label=extended%20support)](https://github.com/Qiskit/qiskit/releases?q=tag%3A0) -->
 [![Downloads](https://img.shields.io/pypi/dm/qiskit.svg)](https://pypi.org/project/qiskit/)
 [![Coverage Status](https://coveralls.io/repos/github/Qiskit/qiskit/badge.svg?branch=main)](https://coveralls.io/github/Qiskit/qiskit?branch=main)
 ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/qiskit)
@@ -76,9 +76,6 @@ For more details on how to use Qiskit, refer to the documentation located here:
 
 ## Installation
 
-> [!WARNING]
-> Do not try to upgrade an existing Qiskit 0.* environment to Qiskit 1.0 in-place. [Read more](https://docs.quantum.ibm.com/migration-guides/qiskit-1.0-installation).
-
 We encourage installing Qiskit via ``pip``:
 
 ```bash
@@ -200,9 +197,9 @@ to the project at different levels. If you use Qiskit, please cite as per the in
 
 The changelog for a particular release is dynamically generated and gets
 written to the release page on Github for each release. For example, you can
-find the page for the `0.46.0` release here:
+find the page for the `1.2.0` release here:
 
-<https://github.com/Qiskit/qiskit/releases/tag/0.46.0>
+<https://github.com/Qiskit/qiskit/releases/tag/1.2.0>
 
 The changelog for the current release can be found in the releases tab:
 [![Releases](https://img.shields.io/github/release/Qiskit/qiskit.svg?style=flat&label=)](https://github.com/Qiskit/qiskit/releases)