qiskit 1.3.0rc2__cp39-abi3-win32.whl → 1.3.2__cp39-abi3-win32.whl

qiskit/transpiler/__init__.py

@@ -33,6 +33,8 @@ branches, and other complex behaviors. That being said, the standard
 compilation flow follows the structure given below:
 
 .. image:: /source_images/transpiling_core_steps.png
+   :alt: The transpilation process takes the input circuit, applies the transpilation \
+      passes, then produces the output circuit.
 
 .. raw:: html
 
@@ -331,7 +333,8 @@ example 3 qubit :class:`~.Target` above:
 
 .. plot::
    :include-source:
-
+   :alt: Output from the previous code.
+   
    from qiskit.circuit import Parameter, Measure
    from qiskit.transpiler import Target, InstructionProperties
    from qiskit.circuit.library import UGate, RZGate, RXGate, RYGate, CXGate, CZGate
@@ -390,6 +393,7 @@ see the individual connectivity, you can pass the operation name to
 :meth:`.CouplingMap.build_coupling_map`:
 
 .. plot::
+   :alt: Output from the previous code.
    :include-source:
 
    from qiskit.circuit import Parameter, Measure
@@ -445,6 +449,7 @@ see the individual connectivity, you can pass the operation name to
    target.build_coupling_map('cx').draw()
 
 .. plot::
+   :alt: Output from the previous code.
    :include-source:
 
    from qiskit.circuit import Parameter, Measure
@@ -532,6 +537,7 @@ Every quantum circuit run on the target device must be expressed using only thes
 For example, to run a simple phase estimation circuit:
 
 .. plot::
+   :alt: Circuit diagram output by the previous code.
    :include-source:
 
    import numpy as np
@@ -557,6 +563,7 @@ the target IBM Quantum device (the :class:`~.GenericBackendV2` class generates
 a fake backend with a specified number of qubits for test purposes):
 
 .. plot::
+   :alt: Circuit diagram output by the previous code.
    :include-source:
 
    from qiskit import transpile
@@ -608,6 +615,7 @@ It is important to highlight two special cases:
       ['id', 'rz', 'sx', 'x', 'cx', 'measure', 'delay']
 
    .. plot:
+      :alt: Circuit diagram output by the previous code.
       :include-source:
 
       from qiskit.circuit import QuantumCircuit
@@ -628,6 +636,7 @@ It is important to highlight two special cases:
    this gate must be decomposed.  This decomposition is quite costly:
 
    .. plot::
+      :alt: Circuit diagram output by the previous code.
       :include-source:
 
       from qiskit.circuit import QuantumCircuit
@@ -653,6 +662,7 @@ qubits used in computations.  We need to be able to map these virtual qubits in
 manner to the "physical" qubits in an actual quantum device.
 
 .. image:: /source_images/mapping.png
+   :alt: Diagram illustrating how virtual qubits are mapped to physical qubits.
 
 
 By default, qiskit will do this mapping for you.  The choice of mapping depends on the
@@ -700,6 +710,7 @@ and we can view this layout selection graphically using
 :func:`qiskit.visualization.plot_circuit_layout`:
 
 .. plot::
+   :alt: Circuit diagram output by the previous code.
    :include-source:
 
    from qiskit import QuantumCircuit, transpile
@@ -718,6 +729,7 @@ and we can view this layout selection graphically using
 - **Layout Using Optimization Level 0**
 
    .. plot::
+      :alt: Output from the previous code.
       :include-source:
 
       from qiskit import QuantumCircuit, transpile
@@ -737,6 +749,7 @@ and we can view this layout selection graphically using
 - **Layout Using Optimization Level 3**
 
    .. plot::
+      :alt: Output from the previous code.
       :include-source:
 
       from qiskit import QuantumCircuit, transpile
@@ -760,6 +773,7 @@ keyword argument, where the index labels the virtual qubit in the circuit and th
 corresponding value is the label for the physical qubit to map onto:
 
 .. plot::
+   :alt: Output from the previous code.
    :include-source:
 
    from qiskit import QuantumCircuit, transpile
@@ -807,6 +821,7 @@ In order to highlight this, we run a GHZ circuit 100 times, using a "bad" (disco
 ``initial_layout`` in a heavy hex coupling map:
 
 .. plot::
+   :alt: Diagram illustrating the previously described circuit.
 
    from qiskit import QuantumCircuit, transpile
 
@@ -816,6 +831,7 @@ In order to highlight this, we run a GHZ circuit 100 times, using a "bad" (disco
    ghz.draw(output='mpl')
 
 .. plot::
+   :alt: Output from the previous code.
    :include-source:
 
    import matplotlib.pyplot as plt
@@ -888,6 +904,7 @@ setting the optimization level higher:
 
 
 .. plot::
+   :alt: Diagram illustrating the previously described circuit.
 
    import matplotlib.pyplot as plt
    from qiskit import QuantumCircuit, transpile
@@ -900,6 +917,7 @@ setting the optimization level higher:
    ghz.draw(output='mpl')
 
 .. plot::
+   :alt: Output from the previous code.
    :include-source:
 
    import matplotlib.pyplot as plt
@@ -946,6 +964,7 @@ for idle time on the qubits between the execution of instructions. For example,
 circuit such as:
 
 .. plot::
+   :alt: Diagram illustrating the previously described circuit.
 
    from qiskit import QuantumCircuit
 
@@ -957,6 +976,7 @@ circuit such as:
 we can then call :func:`~.transpile` on it with ``scheduling_method`` set:
 
 .. plot::
+   :alt: Circuit diagram output by the previous code.
    :include-source:
 
    from qiskit import QuantumCircuit, transpile
@@ -976,6 +996,7 @@ account for idle time on each qubit. To get a better idea of the timing of the c
 also look at it with the :func:`.timeline.draw` function:
 
 .. plot::
+   :alt: Output from circuit timeline drawer.
 
    from qiskit.visualization.timeline import draw as timeline_draw
 

qiskit/transpiler/layout.py

@@ -455,6 +455,7 @@ class TranspileLayout:
     let the input circuit be:
 
     .. plot::
+       :alt: Circuit diagram output by the previous code.
        :include-source:
 
        from qiskit.circuit import QuantumCircuit, QuantumRegister
@@ -470,6 +471,7 @@ class TranspileLayout:
     Suppose that during the layout stage the transpiler reorders the qubits to be:
 
     .. plot::
+       :alt: Circuit diagram output by the previous code.
        :include-source:
 
        from qiskit import QuantumCircuit
@@ -498,6 +500,7 @@ class TranspileLayout:
     becomes:
 
     .. plot::
+       :alt: Circuit diagram output by the previous code.
        :include-source:
 
        from qiskit import QuantumCircuit

qiskit/transpiler/passes/basis/decompose.py

@@ -17,8 +17,10 @@ from __future__ import annotations
 from collections.abc import Sequence
 from typing import Type
 from fnmatch import fnmatch
+import warnings
 
 from qiskit.transpiler.basepasses import TransformationPass
+from qiskit.transpiler.passes.utils import control_flow
 from qiskit.dagcircuit.dagnode import DAGOpNode
 from qiskit.dagcircuit.dagcircuit import DAGCircuit
 from qiskit.converters.circuit_to_dag import circuit_to_dag
@@ -58,7 +60,7 @@ class Decompose(TransformationPass):
             output dag where ``gate`` was expanded.
         """
         # We might use HLS to synthesize objects that do not have a definition
-        hls = HighLevelSynthesis() if self.apply_synthesis else None
+        hls = HighLevelSynthesis(qubits_initially_zero=False) if self.apply_synthesis else None
 
         # Walk through the DAG and expand each non-basis node
         for node in dag.op_nodes():
@@ -66,12 +68,18 @@ class Decompose(TransformationPass):
             if not self._should_decompose(node):
                 continue
 
-            if getattr(node.op, "definition", None) is None:
+            if node.is_control_flow():
+                decomposition = control_flow.map_blocks(self.run, node.op)
+                dag.substitute_node(node, decomposition, inplace=True)
+
+            elif getattr(node.op, "definition", None) is None:
                 # if we try to synthesize, turn the node into a DAGCircuit and run HLS
                 if self.apply_synthesis:
+                    # note that node_as_dag does not include the condition, which will
+                    # be propagated in ``substitute_node_with_dag``
                     node_as_dag = _node_to_dag(node)
                     synthesized = hls.run(node_as_dag)
-                    dag.substitute_node_with_dag(node, synthesized)
+                    dag.substitute_node_with_dag(node, synthesized, propagate_condition=True)
 
                 # else: no definition and synthesis not enabled, so we do nothing
             else:
@@ -123,9 +131,21 @@ class Decompose(TransformationPass):
 
 
 def _node_to_dag(node: DAGOpNode) -> DAGCircuit:
+    # Control flow is already handled separately, however that does not capture
+    # c_if, which we are treating here. We explicitly ignore the condition attribute,
+    # which will be handled by ``substitute_node_with_dag``, so we create a copy of the node
+    # and set the condition to None. Once ``c_if`` is removed for 2.0, this block can go, too.
+    with warnings.catch_warnings():
+        warnings.filterwarnings("ignore", category=DeprecationWarning)
+        if getattr(node.op, "condition", None) is not None:
+            op = node.op.copy()
+            op.condition = None
+            node = DAGOpNode(op, node.qargs, node.cargs)
+
+    # create new dag and apply the operation
     dag = DAGCircuit()
     dag.add_qubits(node.qargs)
     dag.add_clbits(node.cargs)
-
     dag.apply_operation_back(node.op, node.qargs, node.cargs)
+
     return dag

qiskit/transpiler/passes/optimization/inverse_cancellation.py

@@ -19,6 +19,7 @@ from qiskit.circuit import Gate
 from qiskit.dagcircuit import DAGCircuit
 from qiskit.transpiler.basepasses import TransformationPass
 from qiskit.transpiler.exceptions import TranspilerError
+from qiskit.transpiler.passes.utils import control_flow
 
 from qiskit._accelerate.inverse_cancellation import inverse_cancellation
 
@@ -74,6 +75,7 @@ class InverseCancellation(TransformationPass):
 
         super().__init__()
 
+    @control_flow.trivial_recurse
     def run(self, dag: DAGCircuit):
         """Run the InverseCancellation pass on `dag`.
 

qiskit/transpiler/passes/routing/star_prerouting.py

@@ -89,6 +89,7 @@ class StarPreRouting(TransformationPass):
     For example:
 
       .. plot::
+         :alt: Circuit diagram output by the previous code.
          :include-source:
 
          from qiskit.circuit import QuantumCircuit

qiskit/transpiler/passes/scheduling/dynamical_decoupling.py

@@ -47,6 +47,7 @@ class DynamicalDecoupling(TransformationPass):
     (including global phase).
 
     .. plot::
+       :alt: Output from the previous code.
        :include-source:
 
         import numpy as np

qiskit/transpiler/passes/scheduling/padding/dynamical_decoupling.py

@@ -53,6 +53,7 @@ class PadDynamicalDecoupling(BasePadding):
     (including global phase).
 
     .. plot::
+       :alt: Output from the previous code.
        :include-source:
 
         import numpy as np