qiskit 1.3.0b1__cp39-abi3-win32.whl → 1.3.0rc2__cp39-abi3-win32.whl

qiskit/circuit/library/standard_gates/u.py

@@ -35,7 +35,7 @@ class UGate(Gate):
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
              ┌──────────┐
         q_0: ┤ U(ϴ,φ,λ) ├
@@ -218,7 +218,7 @@ class CUGate(ControlledGate):
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
         q_0: ──────■──────
              ┌─────┴──────┐
@@ -251,7 +251,8 @@ class CUGate(ControlledGate):
         which in our case would be q_1. Thus a textbook matrix for this
         gate will be:
 
-        .. parsed-literal::
+        .. code-block:: text
+
                  ┌────────────┐
             q_0: ┤ U(ϴ,φ,λ,γ) ├
                  └─────┬──────┘
@@ -393,3 +394,10 @@ class CUGate(ControlledGate):
         out = super().__deepcopy__(memo)
         out._params = _copy.deepcopy(out._params, memo)
         return out
+
+    def __eq__(self, other):
+        return (
+            isinstance(other, CUGate)
+            and self.ctrl_state == other.ctrl_state
+            and self._compare_parameters(other)
+        )

qiskit/circuit/library/standard_gates/u1.py

@@ -34,47 +34,47 @@ class U1Gate(Gate):
 
        .. math::
 
-           U1(\lambda) = P(\lambda)= U(0,0,\lambda)
+           U1(\theta) = P(\theta)= U(0,0,\theta)
 
        .. code-block:: python
 
           circuit = QuantumCircuit(1)
-          circuit.p(lambda, 0) # or circuit.u(0, 0, lambda)
+          circuit.p(lambda, 0) # or circuit.u(0, 0, lambda, 0)
 
 
 
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
              ┌───────┐
-        q_0: ┤ U1(λ) ├
+        q_0: ┤ U1(θ) ├
              └───────┘
 
     **Matrix Representation:**
 
     .. math::
 
-        U1(\lambda) =
+        U1(\theta) =
             \begin{pmatrix}
                 1 & 0 \\
-                0 & e^{i\lambda}
+                0 & e^{i\theta}
             \end{pmatrix}
 
     **Examples:**
 
         .. math::
 
-            U1(\lambda = \pi) = Z
+            U1(\theta = \pi) = Z
 
         .. math::
 
-            U1(\lambda = \pi/2) = S
+            U1(\theta = \pi/2) = S
 
         .. math::
 
-            U1(\lambda = \pi/4) = T
+            U1(\theta = \pi/4) = T
 
     .. seealso::
 
@@ -83,7 +83,7 @@ class U1Gate(Gate):
 
             .. math::
 
-                U1(\lambda) = e^{i{\lambda}/2} RZ(\lambda)
+                U1(\theta) = e^{i{\theta}/2} RZ(\theta)
 
         :class:`~qiskit.circuit.library.standard_gates.U3Gate`:
         U3 is a generalization of U2 that covers all single-qubit rotations,
@@ -170,6 +170,9 @@ class U1Gate(Gate):
         lam = float(self.params[0])
         return numpy.array([[1, 0], [0, numpy.exp(1j * lam)]], dtype=dtype)
 
+    def __eq__(self, other):
+        return isinstance(other, U1Gate) and self._compare_parameters(other)
+
 
 class CU1Gate(ControlledGate):
     r"""Controlled-U1 gate.
@@ -177,13 +180,29 @@ class CU1Gate(ControlledGate):
     This is a diagonal and symmetric gate that induces a
     phase on the state of the target qubit, depending on the control state.
 
+    .. warning::
+
+       This gate is deprecated. Instead, the :class:`.CPhaseGate` should be used
+
+       .. math::
+
+           CU1(\lambda) = CP(\lambda)
+
+       .. code-block:: python
+
+          circuit = QuantumCircuit(2)
+          circuit.cp(lambda, 0, 1)
+
+
+
+
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
 
         q_0: ─■──
-              │λ
+              │θ
         q_1: ─■──
 
 
@@ -191,13 +210,13 @@ class CU1Gate(ControlledGate):
 
     .. math::
 
-        CU1(\lambda) =
+        CU1(\theta) =
             I \otimes |0\rangle\langle 0| + U1 \otimes |1\rangle\langle 1| =
             \begin{pmatrix}
                 1 & 0 & 0 & 0 \\
                 0 & 1 & 0 & 0 \\
                 0 & 0 & 1 & 0 \\
-                0 & 0 & 0 & e^{i\lambda}
+                0 & 0 & 0 & e^{i\theta}
             \end{pmatrix}
 
     .. seealso::
@@ -325,6 +344,13 @@ class CU1Gate(ControlledGate):
                 [[1, 0, 0, 0], [0, 1, 0, 0], [0, 0, eith, 0], [0, 0, 0, 1]], dtype=dtype
             )
 
+    def __eq__(self, other):
+        return (
+            isinstance(other, CU1Gate)
+            and self.ctrl_state == other.ctrl_state
+            and self._compare_parameters(other)
+        )
+
 
 class MCU1Gate(ControlledGate):
     r"""Multi-controlled-U1 gate.
@@ -332,9 +358,25 @@ class MCU1Gate(ControlledGate):
     This is a diagonal and symmetric gate that induces a
     phase on the state of the target qubit, depending on the state of the control qubits.
 
+    .. warning::
+
+       This gate is deprecated. Instead, the following replacements should be used
+
+       .. math::
+
+           MCU1(\lambda) = MCP(\lambda)
+
+       .. code-block:: python
+
+          circuit = QuantumCircuit(5)
+          circuit.mcp(lambda, list(range(4)), 4)
+
+
+
+
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
             q_0: ────■────
                      │
@@ -449,3 +491,11 @@ class MCU1Gate(ControlledGate):
             MCU1Gate: inverse gate.
         """
         return MCU1Gate(-self.params[0], self.num_ctrl_qubits)
+
+    def __eq__(self, other):
+        return (
+            isinstance(other, MCU1Gate)
+            and self.num_ctrl_qubits == other.num_ctrl_qubits
+            and self.ctrl_state == other.ctrl_state
+            and self._compare_parameters(other)
+        )

qiskit/circuit/library/standard_gates/u2.py

@@ -43,7 +43,7 @@ class U2Gate(Gate):
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
              ┌─────────┐
         q_0: ┤ U2(φ,λ) ├
@@ -144,3 +144,6 @@ class U2Gate(Gate):
             ],
             dtype=dtype or complex,
         )
+
+    def __eq__(self, other):
+        return isinstance(other, U2Gate) and self._compare_parameters(other)

qiskit/circuit/library/standard_gates/u3.py

@@ -43,7 +43,7 @@ class U3Gate(Gate):
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
              ┌───────────┐
         q_0: ┤ U3(ϴ,φ,λ) ├
@@ -178,6 +178,9 @@ class U3Gate(Gate):
             dtype=dtype or complex,
         )
 
+    def __eq__(self, other):
+        return isinstance(other, U3Gate) and self._compare_parameters(other)
+
 
 class CU3Gate(ControlledGate):
     r"""Controlled-U3 gate (3-parameter two-qubit gate).
@@ -186,9 +189,26 @@ class CU3Gate(ControlledGate):
     It is restricted to 3 parameters, and so cannot cover generic two-qubit
     controlled gates).
 
+    .. warning::
+
+       This gate is deprecated. Instead, the :class:`.CUGate` should be used
+
+       .. math::
+
+           CU3(\theta, \phi, \lambda) = CU(\theta, \phi, \lambda, 0)
+
+       .. code-block:: python
+
+          circuit = QuantumCircuit(2)
+          gamma = 0
+          circuit.cu(theta, phi, lambda, gamma, 0, 1)
+
+
+
+
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
         q_0: ──────■──────
              ┌─────┴─────┐
@@ -219,7 +239,8 @@ class CU3Gate(ControlledGate):
         which in our case would be q_1. Thus a textbook matrix for this
         gate will be:
 
-        .. parsed-literal::
+        .. code-block:: text
+
                  ┌───────────┐
             q_0: ┤ U3(ϴ,φ,λ) ├
                  └─────┬─────┘
@@ -351,6 +372,13 @@ class CU3Gate(ControlledGate):
                 dtype=dtype or complex,
             )
 
+    def __eq__(self, other):
+        return (
+            isinstance(other, CU3Gate)
+            and self.ctrl_state == other.ctrl_state
+            and self._compare_parameters(other)
+        )
+
 
 def _generate_gray_code(num_bits):
     """Generate the gray code for ``num_bits`` bits."""

qiskit/circuit/library/standard_gates/x.py

@@ -44,7 +44,7 @@ class XGate(SingletonGate):
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
              ┌───┐
         q_0: ┤ X ├
@@ -163,7 +163,7 @@ class CXGate(SingletonControlledGate):
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
         q_0: ──■──
              ┌─┴─┐
@@ -191,7 +191,8 @@ class CXGate(SingletonControlledGate):
         which in our case would be q_1. Thus a textbook matrix for this
         gate will be:
 
-        .. parsed-literal::
+        .. code-block:: text
+
                  ┌───┐
             q_0: ┤ X ├
                  └─┬─┘
@@ -310,7 +311,7 @@ class CCXGate(SingletonControlledGate):
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
         q_0: ──■──
                │
@@ -344,7 +345,8 @@ class CCXGate(SingletonControlledGate):
         which in our case would be q_2 and q_1. Thus a textbook matrix for this
         gate will be:
 
-        .. parsed-literal::
+        .. code-block:: text
+
                  ┌───┐
             q_0: ┤ X ├
                  └─┬─┘

qiskit/circuit/library/standard_gates/xx_minus_yy.py

@@ -41,7 +41,7 @@ class XXMinusYYGate(Gate):
 
     **Circuit Symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
              ┌───────────────┐
         q_0: ┤0              ├
@@ -73,7 +73,7 @@ class XXMinusYYGate(Gate):
         phase is added on q_0. If :math:`\beta` is set to its default value
         of :math:`0`, the gate is equivalent in big and little endian.
 
-        .. parsed-literal::
+        .. code-block:: text
 
                  ┌───────────────┐
             q_0: ┤1              ├

qiskit/circuit/library/standard_gates/xx_plus_yy.py

@@ -35,7 +35,7 @@ class XXPlusYYGate(Gate):
 
     **Circuit Symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
              ┌───────────────┐
         q_0: ┤0              ├
@@ -67,7 +67,7 @@ class XXPlusYYGate(Gate):
         phase is added on q_1. If :math:`\beta` is set to its default value
         of :math:`0`, the gate is equivalent in big and little endian.
 
-        .. parsed-literal::
+        .. code-block:: text
 
                  ┌───────────────┐
             q_0: ┤1              ├

qiskit/circuit/library/standard_gates/y.py

@@ -42,7 +42,7 @@ class YGate(SingletonGate):
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
              ┌───┐
         q_0: ┤ Y ├
@@ -152,7 +152,7 @@ class CYGate(SingletonControlledGate):
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
         q_0: ──■──
              ┌─┴─┐
@@ -181,7 +181,8 @@ class CYGate(SingletonControlledGate):
         which in our case would be q_1. Thus a textbook matrix for this
         gate will be:
 
-        .. parsed-literal::
+        .. code-block:: text
+
                  ┌───┐
             q_0: ┤ Y ├
                  └─┬─┘

qiskit/circuit/library/standard_gates/z.py

@@ -45,7 +45,7 @@ class ZGate(SingletonGate):
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
              ┌───┐
         q_0: ┤ Z ├
@@ -161,7 +161,7 @@ class CZGate(SingletonControlledGate):
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
         q_0: ─■─
               │
@@ -257,7 +257,7 @@ class CCZGate(SingletonControlledGate):
 
     **Circuit symbol:**
 
-    .. parsed-literal::
+    .. code-block:: text
 
         q_0: ─■─
               │

qiskit/circuit/library/templates/clifford/clifford_2_1.py

@@ -10,20 +10,21 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 2_1:
-.. parsed-literal::
-
-        q_0: ─■──■─
-              │  │
-        q_1: ─■──■─
-"""
+# pylint: disable=missing-module-docstring
 
 from qiskit.circuit.quantumcircuit import QuantumCircuit
 
 
 def clifford_2_1():
     """
+    Clifford template 2_1:
+
+    .. code-block:: text
+
+        q_0: ─■──■─
+              │  │
+        q_1: ─■──■─
+
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_2_2.py

@@ -10,21 +10,22 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 2_2:
-.. parsed-literal::
-
-        q_0: ──■────■──
-             ┌─┴─┐┌─┴─┐
-        q_1: ┤ X ├┤ X ├
-             └───┘└───┘
-"""
+# pylint: disable=missing-module-docstring
 
 from qiskit.circuit.quantumcircuit import QuantumCircuit
 
 
 def clifford_2_2():
     """
+    Clifford template 2_2:
+
+    .. code-block:: text
+
+        q_0: ──■────■──
+             ┌─┴─┐┌─┴─┐
+        q_1: ┤ X ├┤ X ├
+             └───┘└───┘
+
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_2_3.py

@@ -10,19 +10,21 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 2_3:
-.. parsed-literal::
-             ┌───┐┌───┐
-        q_0: ┤ H ├┤ H ├
-             └───┘└───┘
-"""
+# pylint: disable=missing-module-docstring
 
 from qiskit.circuit.quantumcircuit import QuantumCircuit
 
 
 def clifford_2_3():
     """
+    Clifford template 2_3:
+
+    .. code-block:: text
+
+             ┌───┐┌───┐
+        q_0: ┤ H ├┤ H ├
+             └───┘└───┘
+
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_2_4.py

@@ -10,20 +10,21 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 2_4:
-.. parsed-literal::
-
-        q_0: ─X──X─
-              │  │
-        q_1: ─X──X─
-"""
+# pylint: disable=missing-module-docstring
 
 from qiskit.circuit.quantumcircuit import QuantumCircuit
 
 
 def clifford_2_4():
     """
+    Clifford template 2_4:
+
+    .. code-block:: text
+
+        q_0: ─X──X─
+              │  │
+        q_1: ─X──X─
+
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_3_1.py

@@ -10,20 +10,21 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 3_1:
-.. parsed-literal::
-
-             ┌───┐┌───┐┌───┐
-        q_0: ┤ S ├┤ S ├┤ Z ├
-             └───┘└───┘└───┘
-"""
+# pylint: disable=missing-module-docstring
 
 from qiskit.circuit.quantumcircuit import QuantumCircuit
 
 
 def clifford_3_1():
     """
+    Clifford template 3_1:
+
+    .. code-block:: text
+
+             ┌───┐┌───┐┌───┐
+        q_0: ┤ S ├┤ S ├┤ Z ├
+             └───┘└───┘└───┘
+
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_4_1.py

@@ -10,22 +10,23 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 4_1:
-.. parsed-literal::
+# pylint: disable=missing-module-docstring
+
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def clifford_4_1():
+    """
+    Clifford template 4_1:
+
+    .. code-block:: text
 
                   ┌───┐
         q_0: ──■──┤ X ├──■───X─
              ┌─┴─┐└─┬─┘┌─┴─┐ │
         q_1: ┤ X ├──■──┤ X ├─X─
              └───┘     └───┘
-"""
-
-from qiskit.circuit.quantumcircuit import QuantumCircuit
 
-
-def clifford_4_1():
-    """
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_4_2.py

@@ -10,21 +10,22 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 4_2:
-.. parsed-literal::
-
-        q_0: ───────■────────■─
-             ┌───┐┌─┴─┐┌───┐ │
-        q_1: ┤ H ├┤ X ├┤ H ├─■─
-             └───┘└───┘└───┘
-"""
+# pylint: disable=missing-module-docstring
 
 from qiskit.circuit.quantumcircuit import QuantumCircuit
 
 
 def clifford_4_2():
     """
+    Clifford template 4_2:
+
+    .. code-block:: text
+
+        q_0: ───────■────────■─
+             ┌───┐┌─┴─┐┌───┐ │
+        q_1: ┤ H ├┤ X ├┤ H ├─■─
+             └───┘└───┘└───┘
+
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """

qiskit/circuit/library/templates/clifford/clifford_4_3.py

@@ -10,22 +10,23 @@
 # copyright notice, and modified files need to carry a notice indicating
 # that they have been altered from the originals.
 
-"""
-Clifford template 4_3:
-.. parsed-literal::
+# pylint: disable=missing-module-docstring
+
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def clifford_4_3():
+    """
+    Clifford template 4_3:
+
+    .. code-block:: text
 
              ┌───┐     ┌─────┐
         q_0: ┤ S ├──■──┤ SDG ├──■──
              └───┘┌─┴─┐└─────┘┌─┴─┐
         q_1: ─────┤ X ├───────┤ X ├
                   └───┘       └───┘
-"""
-
-from qiskit.circuit.quantumcircuit import QuantumCircuit
 
-
-def clifford_4_3():
-    """
     Returns:
         QuantumCircuit: template as a quantum circuit.
     """