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

qiskit/circuit/library/grover_operator.py

@@ -103,6 +103,7 @@ def grover_operator(
         We can construct a Grover operator just from the phase oracle:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
             :context:
 
@@ -117,8 +118,9 @@ def grover_operator(
         We can also modify the state preparation:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
-            :context:
+            :context: close-figs
 
             oracle = QuantumCircuit(1)
             oracle.z(0)  # the qubit state |1> is the good state
@@ -132,8 +134,9 @@ def grover_operator(
         the oracle:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
-            :context:
+            :context: close-figs
 
             oracle = QuantumCircuit(4)
             oracle.z(3)
@@ -149,8 +152,9 @@ def grover_operator(
         objects:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
-            :context:
+            :context: close-figs
 
             from qiskit.quantum_info import Statevector, DensityMatrix, Operator
 

qiskit/circuit/library/hidden_linear_function.py

@@ -55,6 +55,7 @@ class HiddenLinearFunction(QuantumCircuit):
     **Reference Circuit:**
 
         .. plot::
+           :alt: Diagram illustrating the previously described circuit.
 
            from qiskit.circuit.library import HiddenLinearFunction
            from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -123,6 +124,7 @@ def hidden_linear_function(adjacency_matrix: list | np.ndarray) -> QuantumCircui
     **Reference Circuit:**
 
     .. plot::
+       :alt: Circuit diagram output by the previous code.
        :include-source:
 
        from qiskit.circuit.library import hidden_linear_function

qiskit/circuit/library/iqp.py

@@ -38,6 +38,7 @@ class IQP(QuantumCircuit):
     **Reference Circuit:**
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit.library import IQP
        A = [[6, 5, 3], [5, 4, 5], [3, 5, 1]]
@@ -47,6 +48,7 @@ class IQP(QuantumCircuit):
     **Expanded Circuit:**
 
         .. plot::
+           :alt: Diagram illustrating the previously described circuit.
 
            from qiskit.circuit.library import IQP
            from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -97,6 +99,7 @@ def iqp(
     **Reference Circuit:**
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit.library import iqp
        A = [[6, 5, 3], [5, 4, 5], [3, 5, 1]]
@@ -106,6 +109,7 @@ def iqp(
     **Expanded Circuit:**
 
         .. plot::
+           :alt: Diagram illustrating the previously described circuit.
 
            from qiskit.circuit.library import iqp
            from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -154,6 +158,7 @@ def random_iqp(
     Example:
 
     .. plot::
+       :alt: Circuit diagram output by the previous code.
        :include-source:
 
        from qiskit.circuit.library import random_iqp

qiskit/circuit/library/n_local/efficient_su2.py

@@ -71,6 +71,7 @@ def efficient_su2(
         CX gates, is equivalent to an all-to-all entanglement:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
             :context:
 
@@ -84,8 +85,9 @@ def efficient_su2(
         For example:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
-            :context:
+            :context: close-figs
 
             circuit = efficient_su2(4, su2_gates=["rx", "y"], entanglement="circular", reps=1)
             circuit.draw("mpl")
@@ -114,10 +116,13 @@ def efficient_su2(
     if su2_gates is None:
         su2_gates = ["ry", "rz"]
 
+    # Set entanglement_blocks to None when num_qubits == 1
+    entanglement_blocks = ["cx"] if num_qubits > 1 else []
+
     return n_local(
         num_qubits,
         su2_gates,
-        ["cx"],
+        entanglement_blocks,
         entanglement,
         reps,
         insert_barriers,

qiskit/circuit/library/n_local/evolved_operator_ansatz.py

@@ -61,6 +61,7 @@ def evolved_operator_ansatz(
     Examples:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
 
             from qiskit.circuit.library import evolved_operator_ansatz
@@ -213,6 +214,7 @@ def hamiltonian_variational_ansatz(
         A single operator will be split into commuting terms automatically:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
 
             from qiskit.quantum_info import SparsePauliOp
@@ -226,6 +228,7 @@ def hamiltonian_variational_ansatz(
         Alternatively, we can directly provide the terms:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
 
             from qiskit.quantum_info import SparsePauliOp

qiskit/circuit/library/n_local/excitation_preserving.py

@@ -70,8 +70,9 @@ def excitation_preserving(
         With linear entanglement, this circuit is given by:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
-            :context:
+            :context: close-figs
 
             from qiskit.circuit.library import excitation_preserving
 
@@ -83,6 +84,7 @@ def excitation_preserving(
         in each block:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
             :context:
 
@@ -112,17 +114,21 @@ def excitation_preserving(
         raise ValueError(f"Unsupported mode {mode}, choose one of {supported_modes}")
 
     theta = Parameter("θ")
-    swap = QuantumCircuit(2, name="Interaction")
-    swap.rxx(theta, 0, 1)
-    swap.ryy(theta, 0, 1)
-    if mode == "fsim":
-        phi = Parameter("φ")
-        swap.cp(phi, 0, 1)
+    if num_qubits > 1:
+        swap = QuantumCircuit(2, name="Interaction")
+        swap.rxx(theta, 0, 1)
+        swap.ryy(theta, 0, 1)
+        if mode == "fsim":
+            phi = Parameter("φ")
+            swap.cp(phi, 0, 1)
+        entanglement_blocks = [swap.to_gate()]
+    else:
+        entanglement_blocks = []
 
     return n_local(
         num_qubits,
         ["rz"],
-        [swap.to_gate()],
+        entanglement_blocks,
         entanglement,
         reps,
         insert_barriers,

qiskit/circuit/library/n_local/n_local.py

@@ -148,6 +148,7 @@ def n_local(
         are made up of a single block per layer:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
             :context:
 
@@ -160,8 +161,9 @@ def n_local(
         Pauli-Y and Pauli-Z rotations in the rotation layer:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
-            :context:
+            :context: close-figs
 
             circuit = n_local(3, ["ry", "rz"], "cz", "full", reps=1, insert_barriers=True)
             circuit.draw("mpl")
@@ -169,8 +171,9 @@ def n_local(
         To omit rotation or entanglement layers, the block can be set to an empty list:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
-            :context:
+            :context: close-figs
 
             circuit = n_local(4, [], "cry", reps=2)
             circuit.draw("mpl")
@@ -178,8 +181,9 @@ def n_local(
         The entanglement can be set explicitly via the ``entanglement`` argument:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
-            :context:
+            :context: close-figs
 
             entangler_map = [[0, 1], [2, 0]]
             circuit = n_local(3, "x", "crx", entangler_map, reps=2)
@@ -189,9 +193,10 @@ def n_local(
         as input the current layer index, and returns the entanglement structure. For example,
         the following uses different entanglements for odd and even layers:
 
-        .. plot:
+        .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
-            :context:
+            :context: close-figs
 
             def entanglement(layer_index):
                 if layer_index % 2 == 0:

qiskit/circuit/library/n_local/pauli_two_design.py

@@ -59,6 +59,7 @@ def pauli_two_design(
     Examples:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
 
             from qiskit.circuit.library import pauli_two_design
@@ -88,19 +89,20 @@ def pauli_two_design(
     """
     rng = np.random.default_rng(seed)
     random_block = Block.from_callable(1, 1, lambda params: _random_pauli_builder(params, rng))
-    cz_block = Block.from_standard_gate(CZGate._standard_gate)
+    entanglement_block = [Block.from_standard_gate(CZGate._standard_gate)] if num_qubits > 1 else []
 
     data = py_n_local(
         num_qubits=num_qubits,
         reps=reps,
         rotation_blocks=[random_block],
-        entanglement_blocks=[cz_block],
+        entanglement_blocks=entanglement_block,
         entanglement=["pairwise"],
         insert_barriers=insert_barriers,
         skip_final_rotation_layer=False,
         skip_unentangled_qubits=False,
         parameter_prefix=parameter_prefix,
     )
+
     two_design = QuantumCircuit._from_circuit_data(data)
 
     circuit = QuantumCircuit(num_qubits, name=name)
@@ -147,6 +149,7 @@ class PauliTwoDesign(TwoLocal):
     Examples:
 
         .. plot::
+           :alt: Circuit diagram output by the previous code.
            :include-source:
 
            from qiskit.circuit.library import PauliTwoDesign

qiskit/circuit/library/n_local/qaoa_ansatz.py

@@ -47,6 +47,7 @@ def qaoa_ansatz(
         optimization problem:
 
         .. plot::
+            :alt: Circuit diagram output by the previous code.
             :include-source:
 
             from qiskit.quantum_info import SparsePauliOp

qiskit/circuit/library/n_local/real_amplitudes.py

@@ -68,6 +68,7 @@ def real_amplitudes(
     Examples:
 
         .. plot::
+           :alt: Circuit diagram output by the previous code.
            :include-source:
            :context:
 
@@ -77,22 +78,25 @@ def real_amplitudes(
            ansatz.draw("mpl")
 
         .. plot::
+           :alt: Circuit diagram output by the previous code.
            :include-source:
-           :context:
+           :context: close-figs
 
            ansatz = real_amplitudes(3, entanglement="full", reps=2)  # it is the same unitary as above
            ansatz.draw("mpl")
 
         .. plot::
+           :alt: Circuit diagram output by the previous code.
            :include-source:
-           :context:
+           :context: close-figs
 
            ansatz = real_amplitudes(3, entanglement="linear", reps=2, insert_barriers=True)
            ansatz.draw("mpl")
 
         .. plot::
+           :alt: Circuit diagram output by the previous code.
            :include-source:
-           :context:
+           :context: close-figs
 
            ansatz = real_amplitudes(4, reps=2, entanglement=[[0,3], [0,2]], skip_unentangled_qubits=True)
            ansatz.draw("mpl")
@@ -114,11 +118,13 @@ def real_amplitudes(
     Returns:
         A real-amplitudes circuit.
     """
+    # Set entanglement_blocks to None when num_qubits == 1
+    entanglement_blocks = ["cx"] if num_qubits > 1 else []
 
     return n_local(
         num_qubits,
         ["ry"],
-        ["cx"],
+        entanglement_blocks,
         entanglement,
         reps,
         insert_barriers,

qiskit/circuit/library/overlap.py

@@ -128,6 +128,7 @@ def unitary_overlap(
     **Reference Circuit:**
 
     .. plot::
+        :alt: Circuit diagram output by the previous code.
         :include-source:
 
         import numpy as np

qiskit/circuit/library/phase_estimation.py

@@ -76,6 +76,7 @@ class PhaseEstimation(QuantumCircuit):
 
         Reference Circuit:
             .. plot::
+               :alt: Diagram illustrating the previously described circuit.
 
                from qiskit.circuit import QuantumCircuit
                from qiskit.circuit.library import PhaseEstimation
@@ -131,6 +132,7 @@ def phase_estimation(
     **Reference Circuit:**
 
     .. plot::
+       :alt: Circuit diagram output by the previous code.
        :include-source:
 
        from qiskit.circuit import QuantumCircuit

qiskit/circuit/library/quantum_volume.py

@@ -35,6 +35,7 @@ class QuantumVolume(QuantumCircuit):
     **Reference Circuit:**
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit.library import QuantumVolume
        circuit = QuantumVolume(5, 6, seed=10)
@@ -43,6 +44,7 @@ class QuantumVolume(QuantumCircuit):
     **Expanded Circuit:**
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit.library import QuantumVolume
        from qiskit.visualization.library import _generate_circuit_library_visualization
@@ -150,6 +152,7 @@ def quantum_volume(
     **Reference Circuit:**
 
     .. plot::
+       :alt: Diagram illustrating the previously described circuit.
 
        from qiskit.circuit.library import quantum_volume
        circuit = quantum_volume(5, 6, seed=10)

qiskit/circuit/operation.py

@@ -34,6 +34,7 @@ class Operation(ABC):
         Add a Clifford and a Toffoli gate to a :class:`QuantumCircuit`.
 
         .. plot::
+           :alt: Circuit diagram output by the previous code.
            :include-source:
 
            from qiskit import QuantumCircuit

qiskit/circuit/parameter.py

@@ -41,6 +41,7 @@ class Parameter(ParameterExpression):
         Construct a variable-rotation X gate using circuit parameters.
 
         .. plot::
+           :alt: Circuit diagram output by the previous code.
            :include-source:
 
            from qiskit.circuit import QuantumCircuit, Parameter

qiskit/circuit/parameterexpression.py

@@ -340,7 +340,7 @@ class ParameterExpression:
         either a constant or a second ParameterExpression.
 
         Args:
-            operation: One of operator.{add,sub,mul,truediv}.
+            operation: An operator, such as add, sub, mul, and truediv.
             other: The second argument to be used with self in operation.
             reflected: Optional - The default ordering is "self operator other".
                        If reflected is True, this is switched to "other operator self".

qiskit/circuit/quantumcircuit.py

@@ -835,6 +835,7 @@ class QuantumCircuit:
     Consider the following circuit:
 
     .. plot::
+       :alt: Circuit diagram output by the previous code.
        :include-source:
 
        from qiskit import QuantumCircuit
@@ -887,25 +888,6 @@ class QuantumCircuit:
 
        assert qc.size() == 19
 
-    A particularly important circuit property is known as the circuit :meth:`depth`.  The depth
-    of a quantum circuit is a measure of how many "layers" of quantum gates, executed in
-    parallel, it takes to complete the computation defined by the circuit.  Because quantum
-    gates take time to implement, the depth of a circuit roughly corresponds to the amount of
-    time it takes the quantum computer to execute the circuit.  Thus, the depth of a circuit
-    is one important quantity used to measure if a quantum circuit can be run on a device.
-
-    The depth of a quantum circuit has a mathematical definition as the longest path in a
-    directed acyclic graph (DAG).  However, such a definition is a bit hard to grasp, even for
-    experts.  Fortunately, the depth of a circuit can be easily understood by anyone familiar
-    with playing `Tetris <https://en.wikipedia.org/wiki/Tetris>`_.  Lets see how to compute this
-    graphically:
-
-    .. image:: /source_images/depth.gif
-
-    We can verify our graphical result using :meth:`QuantumCircuit.depth`::
-
-       assert qc.depth() == 9
-
     .. automethod:: count_ops
     .. automethod:: depth
     .. automethod:: get_instructions
@@ -2169,6 +2151,7 @@ class QuantumCircuit:
         Examples:
 
             .. plot::
+               :alt: Circuit diagram output by the previous code.
                :include-source:
 
                from qiskit import QuantumCircuit
@@ -3425,6 +3408,7 @@ class QuantumCircuit:
 
         Example:
             .. plot::
+               :alt: Circuit diagram output by the previous code.
                :include-source:
 
                from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit
@@ -3484,6 +3468,14 @@ class QuantumCircuit:
     ) -> int:
         """Return circuit depth (i.e., length of critical path).
 
+        The depth of a quantum circuit is a measure of how many
+        "layers" of quantum gates, executed in parallel, it takes to
+        complete the computation defined by the circuit.  Because
+        quantum gates take time to implement, the depth of a circuit
+        roughly corresponds to the amount of time it takes the quantum
+        computer to execute the circuit.
+
+
         .. warning::
             This operation is not well defined if the circuit contains control-flow operations.
 
@@ -4306,6 +4298,7 @@ class QuantumCircuit:
             Create a parameterized circuit and assign the parameters in-place.
 
             .. plot::
+               :alt: Circuit diagram output by the previous code.
                :include-source:
 
                from qiskit.circuit import QuantumCircuit, Parameter
@@ -4321,6 +4314,7 @@ class QuantumCircuit:
             Bind the values out-of-place by list and get a copy of the original circuit.
 
             .. plot::
+               :alt: Circuit diagram output by the previous code.
                :include-source:
 
                from qiskit.circuit import QuantumCircuit, ParameterVector

qiskit/circuit/random/utils.py

@@ -37,6 +37,7 @@ def random_circuit(
     from the set of standard gates in :mod:`qiskit.circuit.library.standard_gates`. For example:
 
     .. plot::
+       :alt: Circuit diagram output by the previous code.
        :include-source:
 
        from qiskit.circuit.random import random_circuit
@@ -295,6 +296,7 @@ def random_clifford_circuit(num_qubits, num_gates, gates="all", seed=None):
     gates from the set of standard gates in :mod:`qiskit.circuit.library.standard_gates`. For example:
 
     .. plot::
+       :alt: Circuit diagram output by the previous code.
        :include-source:
 
        from qiskit.circuit.random import random_clifford_circuit

qiskit/converters/dag_to_circuit.py

@@ -34,6 +34,7 @@ def dag_to_circuit(dag, copy_operations=True):
 
     Example:
         .. plot::
+           :alt: Circuit diagram output by the previous code.
            :include-source:
 
            from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit

qiskit/primitives/statevector_estimator.py

@@ -49,6 +49,7 @@ class StatevectorEstimator(BaseEstimatorV2):
         ``StatevectorEstimator(seed=123)``.
 
     .. plot::
+        :alt: Output from the previous code.
         :include-source:
 
         from qiskit.circuit import Parameter, QuantumCircuit

qiskit/providers/fake_provider/__init__.py

@@ -29,6 +29,7 @@ Example Usage
 Here is an example of using a simulated backend for transpilation and running.
 
 .. plot::
+   :alt: Output from the previous code.
    :include-source:
 
    from qiskit import QuantumCircuit, transpile

qiskit/pulse/builder.py

@@ -39,6 +39,7 @@ execution. For example, to play a series of pulses on channels is as simple as:
 
 
 .. plot::
+   :alt: Output from the previous code.
    :include-source:
 
    from qiskit import pulse
@@ -61,6 +62,7 @@ statements. For example, below we write a simple program that :func:`play`\s
 a pulse:
 
 .. plot::
+   :alt: Output from the previous code.
    :include-source:
 
    from qiskit import pulse
@@ -90,6 +92,7 @@ state we prepared. This program which mixes circuits and pulses will be
 automatically lowered to be run as a pulse program:
 
 .. plot::
+   :alt: Output from the previous code.
    :include-source:
 
    from math import pi
@@ -273,6 +276,7 @@ Instructions
 Pulse instructions are available within the builder interface. Here's an example:
 
 .. plot::
+   :alt: Output from the previous code.
    :include-source:
 
     from qiskit import pulse
@@ -321,6 +325,7 @@ example an alignment context like :func:`align_right` may
 be used to align all pulses as late as possible in a pulse program.
 
 .. plot::
+   :alt: Output from the previous code.
    :include-source:
 
    from qiskit import pulse
@@ -1165,6 +1170,7 @@ def align_equispaced(duration: int | ParameterExpression) -> Generator[None, Non
     Examples:
 
     .. plot::
+       :alt: Output from the previous code.
        :include-source:
 
         from qiskit import pulse
@@ -1219,6 +1225,7 @@ def align_func(
     Examples:
 
     .. plot::
+       :alt: Output from the previous code.
        :include-source:
 
         import numpy as np
@@ -2043,6 +2050,7 @@ def macro(func: Callable):
     Examples:
 
     .. plot::
+       :alt: Output from the previous code.
        :include-source:
 
         from qiskit import pulse

qiskit/pulse/library/symbolic_pulses.py

@@ -330,6 +330,7 @@ class SymbolicPulse(Pulse):
     without knowing the envelope definition. Now you need to provide the envelope.
 
     .. plot::
+       :alt: Output from the previous code.
        :include-source:
 
         import sympy

qiskit/qasm2/export.py

@@ -314,8 +314,8 @@ def _define_custom_operation(operation, gates_to_define):
     # definition, but still continue to return the given object as the call-site object.
     if operation.base_class in known_good_parameterized:
         parameterized_operation = type(operation)(*_FIXED_PARAMETERS[: len(operation.params)])
-    elif hasattr(operation, "_qasm2_decomposition"):
-        new_op = operation._qasm2_decomposition()
+    elif hasattr(operation, "_qasm_decomposition"):
+        new_op = operation._qasm_decomposition()
         parameterized_operation = operation = new_op.copy(name=_escape_name(new_op.name, "gate_"))
     else:
         parameterized_operation = operation

qiskit/qasm3/__init__.py

@@ -126,6 +126,7 @@ For example, we can define a quantum program using OpenQASM 3, and use :func:`lo
 convert it into a :class:`.QuantumCircuit`:
 
 .. plot::
+    :alt: Circuit diagram output by the previous code.
     :include-source:
 
     import qiskit.qasm3

qiskit/qasm3/exporter.py

@@ -1180,13 +1180,16 @@ class QASM3Builder:
 
         This will also push the gate into the symbol table (if required), including recursively
         defining the gate blocks."""
-        ident = self.symbols.get_gate(instruction.operation)
+        operation = instruction.operation
+        if hasattr(operation, "_qasm_decomposition"):
+            operation = operation._qasm_decomposition()
+        ident = self.symbols.get_gate(operation)
         if ident is None:
-            ident = self.define_gate(instruction.operation)
+            ident = self.define_gate(operation)
         qubits = [self._lookup_bit(qubit) for qubit in instruction.qubits]
         parameters = [
             ast.StringifyAndPray(self._rebind_scoped_parameters(param))
-            for param in instruction.operation.params
+            for param in operation.params
         ]
         if not self.disable_constants:
             for parameter in parameters: