qiskit 1.3.0__cp39-abi3-macosx_11_0_arm64.whl

qiskit/circuit/library/templates/nct/template_nct_9d_6.py

@@ -0,0 +1,44 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2020.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+# pylint: disable=missing-module-docstring
+
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def template_nct_9d_6():
+    """
+    Template 9d_6:
+
+    .. code-block:: text
+
+        q_0: ──■────■──────────────■────■─────────■───────
+               │    │  ┌───┐       │  ┌─┴─┐       │  ┌───┐
+        q_1: ──■────┼──┤ X ├───────■──┤ X ├───────■──┤ X ├
+             ┌─┴─┐┌─┴─┐└─┬─┘┌───┐┌─┴─┐└─┬─┘┌───┐┌─┴─┐└─┬─┘
+        q_2: ┤ X ├┤ X ├──■──┤ X ├┤ X ├──■──┤ X ├┤ X ├──■──
+             └───┘└───┘     └───┘└───┘     └───┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(3)
+    qc.ccx(0, 1, 2)
+    qc.cx(0, 2)
+    qc.cx(2, 1)
+    qc.x(2)
+    qc.ccx(0, 1, 2)
+    qc.ccx(0, 2, 1)
+    qc.x(2)
+    qc.ccx(0, 1, 2)
+    qc.cx(2, 1)
+    return qc

qiskit/circuit/library/templates/nct/template_nct_9d_7.py

@@ -0,0 +1,44 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2020.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+# pylint: disable=missing-module-docstring
+
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def template_nct_9d_7():
+    """
+    Template 9d_7:
+
+    .. code-block:: text
+
+        q_0: ──■────■─────────■────■────■────■────■───────
+               │    │  ┌───┐  │    │  ┌─┴─┐  │    │  ┌───┐
+        q_1: ──■────┼──┤ X ├──┼────■──┤ X ├──┼────■──┤ X ├
+             ┌─┴─┐┌─┴─┐└─┬─┘┌─┴─┐┌─┴─┐└─┬─┘┌─┴─┐┌─┴─┐└─┬─┘
+        q_2: ┤ X ├┤ X ├──■──┤ X ├┤ X ├──■──┤ X ├┤ X ├──■──
+             └───┘└───┘     └───┘└───┘     └───┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(3)
+    qc.ccx(0, 1, 2)
+    qc.cx(0, 2)
+    qc.cx(2, 1)
+    qc.cx(0, 2)
+    qc.ccx(0, 1, 2)
+    qc.ccx(0, 2, 1)
+    qc.cx(0, 2)
+    qc.ccx(0, 1, 2)
+    qc.cx(2, 1)
+    return qc

qiskit/circuit/library/templates/nct/template_nct_9d_8.py

@@ -0,0 +1,44 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2020.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+# pylint: disable=missing-module-docstring
+
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def template_nct_9d_8():
+    """
+    Template 9d_8:
+
+    .. code-block:: text
+
+        q_0: ──■────■────■────■─────────■────■─────────■──
+               │    │  ┌─┴─┐  │       ┌─┴─┐  │       ┌─┴─┐
+        q_1: ──■────┼──┤ X ├──┼────■──┤ X ├──┼────■──┤ X ├
+             ┌─┴─┐┌─┴─┐└─┬─┘┌─┴─┐┌─┴─┐└─┬─┘┌─┴─┐┌─┴─┐└─┬─┘
+        q_2: ┤ X ├┤ X ├──■──┤ X ├┤ X ├──■──┤ X ├┤ X ├──■──
+             └───┘└───┘     └───┘└───┘     └───┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(3)
+    qc.ccx(0, 1, 2)
+    qc.cx(0, 2)
+    qc.ccx(0, 2, 1)
+    qc.cx(0, 2)
+    qc.cx(1, 2)
+    qc.ccx(0, 2, 1)
+    qc.cx(0, 2)
+    qc.cx(1, 2)
+    qc.ccx(0, 2, 1)
+    return qc

qiskit/circuit/library/templates/nct/template_nct_9d_9.py

@@ -0,0 +1,44 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2020.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+# pylint: disable=missing-module-docstring
+
+from qiskit.circuit.quantumcircuit import QuantumCircuit
+
+
+def template_nct_9d_9():
+    """
+    Template 9d_9:
+
+    .. code-block:: text
+
+        q_0: ──■────■────■─────────■────■─────────■────■──
+               │    │  ┌─┴─┐       │  ┌─┴─┐       │  ┌─┴─┐
+        q_1: ──■────┼──┤ X ├───────■──┤ X ├───────■──┤ X ├
+             ┌─┴─┐┌─┴─┐└─┬─┘┌───┐┌─┴─┐└─┬─┘┌───┐┌─┴─┐└─┬─┘
+        q_2: ┤ X ├┤ X ├──■──┤ X ├┤ X ├──■──┤ X ├┤ X ├──■──
+             └───┘└───┘     └───┘└───┘     └───┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(3)
+    qc.ccx(0, 1, 2)
+    qc.cx(0, 2)
+    qc.ccx(0, 2, 1)
+    qc.x(2)
+    qc.ccx(0, 1, 2)
+    qc.ccx(0, 2, 1)
+    qc.x(2)
+    qc.ccx(0, 1, 2)
+    qc.ccx(0, 2, 1)
+    return qc

qiskit/circuit/library/templates/rzx/__init__.py

@@ -0,0 +1,25 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2020.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+"""
+A library of template circuits.
+
+Templates are circuits that compute the identity. They find use
+in circuit optimization where matching part of the template allows the compiler
+to replace the match with the inverse of the remainder from the template.
+"""
+from .rzx_yz import rzx_yz
+from .rzx_xz import rzx_xz
+from .rzx_cy import rzx_cy
+from .rzx_zz1 import rzx_zz1
+from .rzx_zz2 import rzx_zz2
+from .rzx_zz3 import rzx_zz3

qiskit/circuit/library/templates/rzx/rzx_cy.py

@@ -0,0 +1,47 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2021.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+# pylint: disable=missing-module-docstring
+
+from __future__ import annotations
+
+import numpy as np
+
+from qiskit.circuit import Parameter, QuantumCircuit
+from qiskit.circuit.parameterexpression import ParameterValueType
+
+
+def rzx_cy(theta: ParameterValueType | None = None):
+    """RZX-based template for CX - RYGate - CX.
+
+    .. code-block:: text
+
+                                                                 ┌──────────┐
+          q_0: ──■─────────────■─────────────────────────────────┤0         ├───────────
+               ┌─┴─┐┌───────┐┌─┴─┐┌────────┐┌──────────┐┌───────┐│  RZX(-ϴ) │┌─────────┐
+          q_1: ┤ X ├┤ RY(ϴ) ├┤ X ├┤ RY(-ϴ) ├┤ RZ(-π/2) ├┤ RX(ϴ) ├┤1         ├┤ RZ(π/2) ├
+               └───┘└───────┘└───┘└────────┘└──────────┘└───────┘└──────────┘└─────────┘
+    """
+    if theta is None:
+        theta = Parameter("ϴ")
+
+    circ = QuantumCircuit(2)
+    circ.cx(0, 1)
+    circ.ry(theta, 1)
+    circ.cx(0, 1)
+    circ.ry(-1 * theta, 1)
+    circ.rz(-np.pi / 2, 1)
+    circ.rx(theta, 1)
+    circ.rzx(-1 * theta, 0, 1)
+    circ.rz(np.pi / 2, 1)
+
+    return circ

qiskit/circuit/library/templates/rzx/rzx_xz.py

@@ -0,0 +1,54 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2021.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+# pylint: disable=missing-module-docstring
+
+from __future__ import annotations
+
+import numpy as np
+
+from qiskit.circuit import Parameter, QuantumCircuit
+from qiskit.circuit.parameterexpression import ParameterValueType
+
+
+def rzx_xz(theta: ParameterValueType | None = None):
+    """RZX-based template for CX - RXGate - CX.
+
+    .. code-block:: text
+
+             ┌───┐         ┌───┐┌─────────┐┌─────────┐┌─────────┐┌──────────┐»
+        q_0: ┤ X ├─────────┤ X ├┤ RZ(π/2) ├┤ RX(π/2) ├┤ RZ(π/2) ├┤0         ├»
+             └─┬─┘┌───────┐└─┬─┘└─────────┘└─────────┘└─────────┘│  RZX(-ϴ) │»
+        q_1: ──■──┤ RX(ϴ) ├──■───────────────────────────────────┤1         ├»
+                  └───────┘                                      └──────────┘»
+        «     ┌─────────┐┌─────────┐┌─────────┐
+        «q_0: ┤ RZ(π/2) ├┤ RX(π/2) ├┤ RZ(π/2) ├
+        «     └─────────┘└─────────┘└─────────┘
+        «q_1: ─────────────────────────────────
+        «
+    """
+    if theta is None:
+        theta = Parameter("ϴ")
+
+    qc = QuantumCircuit(2)
+    qc.cx(1, 0)
+    qc.rx(theta, 1)
+    qc.cx(1, 0)
+
+    qc.rz(np.pi / 2, 0)
+    qc.rx(np.pi / 2, 0)
+    qc.rz(np.pi / 2, 0)
+    qc.rzx(-1 * theta, 0, 1)
+    qc.rz(np.pi / 2, 0)
+    qc.rx(np.pi / 2, 0)
+    qc.rz(np.pi / 2, 0)
+    return qc

qiskit/circuit/library/templates/rzx/rzx_yz.py

@@ -0,0 +1,45 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2021.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+# pylint: disable=missing-module-docstring
+
+from __future__ import annotations
+
+import numpy as np
+
+from qiskit.circuit import Parameter, QuantumCircuit
+from qiskit.circuit.parameterexpression import ParameterValueType
+
+
+def rzx_yz(theta: ParameterValueType | None = None):
+    """RZX-based template for CX - RYGate - CX.
+
+    .. code-block:: text
+
+                  ┌────────┐     ┌─────────┐┌─────────┐┌──────────┐
+        q_0: ──■──┤ RY(-ϴ) ├──■──┤ RX(π/2) ├┤0        ├┤ RX(-π/2) ├
+             ┌─┴─┐└────────┘┌─┴─┐└─────────┘│  RZX(ϴ) │└──────────┘
+        q_1: ┤ X ├──────────┤ X ├───────────┤1        ├────────────
+             └───┘          └───┘           └─────────┘
+    """
+    if theta is None:
+        theta = Parameter("ϴ")
+
+    circ = QuantumCircuit(2)
+    circ.cx(0, 1)
+    circ.ry(-1 * theta, 0)
+    circ.cx(0, 1)
+    circ.rx(np.pi / 2, 0)
+    circ.rzx(theta, 0, 1)
+    circ.rx(-np.pi / 2, 0)
+
+    return circ

qiskit/circuit/library/templates/rzx/rzx_zz1.py

@@ -0,0 +1,69 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2021.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+# pylint: disable=missing-module-docstring
+
+from __future__ import annotations
+
+import numpy as np
+
+from qiskit.circuit import Parameter, QuantumCircuit
+from qiskit.circuit.parameterexpression import ParameterValueType
+
+
+def rzx_zz1(theta: ParameterValueType | None = None):
+    """RZX-based template for CX - RZGate - CX.
+
+    .. code-block:: text
+
+                                                                                      »
+          q_0: ──■────────────────────────────────────────────■───────────────────────»
+               ┌─┴─┐┌───────┐┌────┐┌───────┐┌────┐┌────────┐┌─┴─┐┌────────┐┌─────────┐»
+          q_1: ┤ X ├┤ RZ(ϴ) ├┤ √X ├┤ RZ(π) ├┤ √X ├┤ RZ(3π) ├┤ X ├┤ RZ(-ϴ) ├┤ RZ(π/2) ├»
+               └───┘└───────┘└────┘└───────┘└────┘└────────┘└───┘└────────┘└─────────┘»
+          «                                    ┌──────────┐                      »
+          «q_0: ───────────────────────────────┤0         ├──────────────────────»
+          «     ┌─────────┐┌─────────┐┌───────┐│  RZX(-ϴ) │┌─────────┐┌─────────┐»
+          «q_1: ┤ RX(π/2) ├┤ RZ(π/2) ├┤ RX(ϴ) ├┤1         ├┤ RZ(π/2) ├┤ RX(π/2) ├»
+          «     └─────────┘└─────────┘└───────┘└──────────┘└─────────┘└─────────┘»
+          «
+          «q_0: ───────────
+          «     ┌─────────┐
+          «q_1: ┤ RZ(π/2) ├
+          «     └─────────┘
+    """
+    if theta is None:
+        theta = Parameter("ϴ")
+
+    qc = QuantumCircuit(2)
+    qc.cx(0, 1)
+    qc.rz(theta, 1)
+    qc.sx(1)
+    qc.rz(np.pi, 1)
+    qc.sx(1)
+    qc.rz(3 * np.pi, 1)
+    qc.cx(0, 1)
+    qc.rz(-1 * theta, 1)
+
+    # Hadamard
+    qc.rz(np.pi / 2, 1)
+    qc.rx(np.pi / 2, 1)
+    qc.rz(np.pi / 2, 1)
+
+    qc.rx(theta, 1)
+    qc.rzx(-1 * theta, 0, 1)
+    # Hadamard
+    qc.rz(np.pi / 2, 1)
+    qc.rx(np.pi / 2, 1)
+    qc.rz(np.pi / 2, 1)
+
+    return qc

qiskit/circuit/library/templates/rzx/rzx_zz2.py

@@ -0,0 +1,59 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2021.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+# pylint: disable=missing-module-docstring
+
+from __future__ import annotations
+
+import numpy as np
+
+from qiskit.circuit import Parameter, QuantumCircuit
+from qiskit.circuit.parameterexpression import ParameterValueType
+
+
+def rzx_zz2(theta: ParameterValueType | None = None):
+    """RZX-based template for CX - PhaseGate - CX.
+
+    .. code-block:: text
+
+                                                                                    »
+          q_0: ──■────────────■─────────────────────────────────────────────────────»
+               ┌─┴─┐┌──────┐┌─┴─┐┌───────┐┌─────────┐┌─────────┐┌─────────┐┌───────┐»
+          q_1: ┤ X ├┤ P(ϴ) ├┤ X ├┤ P(-ϴ) ├┤ RZ(π/2) ├┤ RX(π/2) ├┤ RZ(π/2) ├┤ RX(ϴ) ├»
+               └───┘└──────┘└───┘└───────┘└─────────┘└─────────┘└─────────┘└───────┘»
+          «     ┌──────────┐
+          «q_0: ┤0         ├─────────────────────────────────
+          «     │  RZX(-ϴ) │┌─────────┐┌─────────┐┌─────────┐
+          «q_1: ┤1         ├┤ RZ(π/2) ├┤ RX(π/2) ├┤ RZ(π/2) ├
+          «     └──────────┘└─────────┘└─────────┘└─────────┘
+    """
+    if theta is None:
+        theta = Parameter("ϴ")
+
+    qc = QuantumCircuit(2)
+    qc.cx(0, 1)
+    qc.p(theta, 1)
+    qc.cx(0, 1)
+    qc.p(-1 * theta, 1)
+    # Hadamard
+    qc.rz(np.pi / 2, 1)
+    qc.rx(np.pi / 2, 1)
+    qc.rz(np.pi / 2, 1)
+
+    qc.rx(theta, 1)
+    qc.rzx(-1 * theta, 0, 1)
+    # Hadamard
+    qc.rz(np.pi / 2, 1)
+    qc.rx(np.pi / 2, 1)
+    qc.rz(np.pi / 2, 1)
+
+    return qc

qiskit/circuit/library/templates/rzx/rzx_zz3.py

@@ -0,0 +1,59 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2021.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+# pylint: disable=missing-module-docstring
+
+from __future__ import annotations
+
+import numpy as np
+
+from qiskit.circuit import Parameter, QuantumCircuit
+from qiskit.circuit.parameterexpression import ParameterValueType
+
+
+def rzx_zz3(theta: ParameterValueType | None = None):
+    """RZX-based template for CX - RZGate - CX.
+
+    .. code-block:: text
+
+                                                                                      »
+          q_0: ──■─────────────■──────────────────────────────────────────────────────»
+               ┌─┴─┐┌───────┐┌─┴─┐┌────────┐┌─────────┐┌─────────┐┌─────────┐┌───────┐»
+          q_1: ┤ X ├┤ RZ(ϴ) ├┤ X ├┤ RZ(-ϴ) ├┤ RZ(π/2) ├┤ RX(π/2) ├┤ RZ(π/2) ├┤ RX(ϴ) ├»
+               └───┘└───────┘└───┘└────────┘└─────────┘└─────────┘└─────────┘└───────┘»
+          «     ┌──────────┐
+          «q_0: ┤0         ├─────────────────────────────────
+          «     │  RZX(-ϴ) │┌─────────┐┌─────────┐┌─────────┐
+          «q_1: ┤1         ├┤ RZ(π/2) ├┤ RX(π/2) ├┤ RZ(π/2) ├
+          «     └──────────┘└─────────┘└─────────┘└─────────┘
+    """
+    if theta is None:
+        theta = Parameter("ϴ")
+
+    qc = QuantumCircuit(2)
+    qc.cx(0, 1)
+    qc.rz(theta, 1)
+    qc.cx(0, 1)
+    qc.rz(-1 * theta, 1)
+    # Hadamard
+    qc.rz(np.pi / 2, 1)
+    qc.rx(np.pi / 2, 1)
+    qc.rz(np.pi / 2, 1)
+
+    qc.rx(theta, 1)
+    qc.rzx(-1 * theta, 0, 1)
+    # Hadamard
+    qc.rz(np.pi / 2, 1)
+    qc.rx(np.pi / 2, 1)
+    qc.rz(np.pi / 2, 1)
+
+    return qc

qiskit/circuit/measure.py

@@ -0,0 +1,44 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2017.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+"""
+Quantum measurement in the computational basis.
+"""
+
+from qiskit.circuit.singleton import SingletonInstruction, stdlib_singleton_key
+from qiskit.circuit.exceptions import CircuitError
+
+
+class Measure(SingletonInstruction):
+    """Quantum measurement in the computational basis."""
+
+    def __init__(self, label=None, *, duration=None, unit="dt"):
+        """
+        Args:
+            label: optional string label for this instruction.
+        """
+        super().__init__("measure", 1, 1, [], label=label, duration=duration, unit=unit)
+
+    _singleton_lookup_key = stdlib_singleton_key()
+
+    def broadcast_arguments(self, qargs, cargs):
+        qarg = qargs[0]
+        carg = cargs[0]
+
+        if len(carg) == len(qarg):
+            for qarg, carg in zip(qarg, carg):
+                yield [qarg], [carg]
+        elif len(qarg) == 1 and carg:
+            for each_carg in carg:
+                yield qarg, [each_carg]
+        else:
+            raise CircuitError("register size error")

qiskit/circuit/operation.py

@@ -0,0 +1,67 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2017.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+"""Quantum Operation Mixin."""
+
+from abc import ABC, abstractmethod
+
+
+class Operation(ABC):
+    """Quantum operation interface.
+
+    The minimal interface that any object must fulfil in order to be added to a
+    :class:`.QuantumCircuit`.
+
+    Concrete instances of this interface include :class:`~qiskit.circuit.Gate`,
+    :class:`~qiskit.circuit.Reset`, :class:`~qiskit.circuit.Barrier`,
+    :class:`~qiskit.circuit.Measure`, and operators such as :class:`~qiskit.quantum_info.Clifford`.
+
+    The main purpose is to allow abstract mathematical objects to be added directly onto
+    abstract circuits, and for the exact syntheses of these to be determined later, during
+    compilation.
+
+    Example:
+
+        Add a Clifford and a Toffoli gate to a :class:`QuantumCircuit`.
+
+        .. plot::
+           :include-source:
+
+           from qiskit import QuantumCircuit
+           from qiskit.quantum_info import Clifford, random_clifford
+
+           qc = QuantumCircuit(3)
+           cliff = random_clifford(2)
+           qc.append(cliff, [0, 1])
+           qc.ccx(0, 1, 2)
+           qc.draw('mpl')
+    """
+
+    __slots__ = ()
+
+    @property
+    @abstractmethod
+    def name(self):
+        """Unique string identifier for operation type."""
+        raise NotImplementedError
+
+    @property
+    @abstractmethod
+    def num_qubits(self):
+        """Number of qubits."""
+        raise NotImplementedError
+
+    @property
+    @abstractmethod
+    def num_clbits(self):
+        """Number of classical bits."""
+        raise NotImplementedError