qiskit 1.3.0__cp39-abi3-macosx_11_0_arm64.whl

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

@@ -0,0 +1,33 @@
+# 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.
+
+"""
+Template circuits over Clifford gates.
+"""
+from .clifford_2_1 import clifford_2_1
+from .clifford_2_2 import clifford_2_2
+from .clifford_2_3 import clifford_2_3
+from .clifford_2_4 import clifford_2_4
+from .clifford_3_1 import clifford_3_1
+from .clifford_4_1 import clifford_4_1
+from .clifford_4_2 import clifford_4_2
+from .clifford_4_3 import clifford_4_3
+from .clifford_4_4 import clifford_4_4
+from .clifford_5_1 import clifford_5_1
+from .clifford_6_1 import clifford_6_1
+from .clifford_6_2 import clifford_6_2
+from .clifford_6_3 import clifford_6_3
+from .clifford_6_4 import clifford_6_4
+from .clifford_6_5 import clifford_6_5
+from .clifford_8_1 import clifford_8_1
+from .clifford_8_2 import clifford_8_2
+from .clifford_8_3 import clifford_8_3

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

@@ -0,0 +1,34 @@
+# 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 clifford_2_1():
+    """
+    Clifford template 2_1:
+
+    .. code-block:: text
+
+        q_0: ─■──■─
+              │  │
+        q_1: ─■──■─
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(2)
+    qc.cz(0, 1)
+    qc.cz(0, 1)
+    return qc

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

@@ -0,0 +1,35 @@
+# 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 clifford_2_2():
+    """
+    Clifford template 2_2:
+
+    .. code-block:: text
+
+        q_0: ──■────■──
+             ┌─┴─┐┌─┴─┐
+        q_1: ┤ X ├┤ X ├
+             └───┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(2)
+    qc.cx(0, 1)
+    qc.cx(0, 1)
+    return qc

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

@@ -0,0 +1,34 @@
+# 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 clifford_2_3():
+    """
+    Clifford template 2_3:
+
+    .. code-block:: text
+
+             ┌───┐┌───┐
+        q_0: ┤ H ├┤ H ├
+             └───┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(1)
+    qc.h(0)
+    qc.h(0)
+    return qc

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

@@ -0,0 +1,34 @@
+# 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 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.
+    """
+    qc = QuantumCircuit(2)
+    qc.swap(0, 1)
+    qc.swap(1, 0)
+    return qc

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

@@ -0,0 +1,35 @@
+# 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 clifford_3_1():
+    """
+    Clifford template 3_1:
+
+    .. code-block:: text
+
+             ┌───┐┌───┐┌───┐
+        q_0: ┤ S ├┤ S ├┤ Z ├
+             └───┘└───┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(1)
+    qc.s(0)
+    qc.s(0)
+    qc.z(0)
+    return qc

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

@@ -0,0 +1,38 @@
+# 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 clifford_4_1():
+    """
+    Clifford template 4_1:
+
+    .. code-block:: text
+
+                  ┌───┐
+        q_0: ──■──┤ X ├──■───X─
+             ┌─┴─┐└─┬─┘┌─┴─┐ │
+        q_1: ┤ X ├──■──┤ X ├─X─
+             └───┘     └───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(2)
+    qc.cx(0, 1)
+    qc.cx(1, 0)
+    qc.cx(0, 1)
+    qc.swap(0, 1)
+    return qc

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

@@ -0,0 +1,37 @@
+# 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 clifford_4_2():
+    """
+    Clifford template 4_2:
+
+    .. code-block:: text
+
+        q_0: ───────■────────■─
+             ┌───┐┌─┴─┐┌───┐ │
+        q_1: ┤ H ├┤ X ├┤ H ├─■─
+             └───┘└───┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(2)
+    qc.h(1)
+    qc.cx(0, 1)
+    qc.h(1)
+    qc.cz(0, 1)
+    return qc

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

@@ -0,0 +1,38 @@
+# 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 clifford_4_3():
+    """
+    Clifford template 4_3:
+
+    .. code-block:: text
+
+             ┌───┐     ┌─────┐
+        q_0: ┤ S ├──■──┤ SDG ├──■──
+             └───┘┌─┴─┐└─────┘┌─┴─┐
+        q_1: ─────┤ X ├───────┤ X ├
+                  └───┘       └───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(2)
+    qc.s(0)
+    qc.cx(0, 1)
+    qc.sdg(0)
+    qc.cx(0, 1)
+    return qc

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

@@ -0,0 +1,37 @@
+# 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 clifford_4_4():
+    """
+    Clifford template 4_4:
+
+    .. code-block:: text
+
+             ┌───┐   ┌─────┐
+        q_0: ┤ S ├─■─┤ SDG ├─■─
+             └───┘ │ └─────┘ │
+        q_1: ──────■─────────■─
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(2)
+    qc.s(0)
+    qc.cz(0, 1)
+    qc.sdg(0)
+    qc.cz(0, 1)
+    return qc

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

@@ -0,0 +1,40 @@
+# 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 clifford_5_1():
+    """
+    Clifford template 5_1:
+
+     .. code-block:: text
+
+        q_0: ──■─────────■─────────■──
+             ┌─┴─┐     ┌─┴─┐       │
+        q_1: ┤ X ├──■──┤ X ├──■────┼──
+             └───┘┌─┴─┐└───┘┌─┴─┐┌─┴─┐
+        q_2: ─────┤ X ├─────┤ X ├┤ X ├
+                  └───┘     └───┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(3)
+    qc.cx(0, 1)
+    qc.cx(1, 2)
+    qc.cx(0, 1)
+    qc.cx(1, 2)
+    qc.cx(0, 2)
+    return qc

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

@@ -0,0 +1,40 @@
+# 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 clifford_6_1():
+    """
+    Clifford template 6_1:
+
+     .. code-block:: text
+
+             ┌───┐     ┌───┐┌───┐
+        q_0: ┤ H ├──■──┤ H ├┤ X ├
+             ├───┤┌─┴─┐├───┤└─┬─┘
+        q_1: ┤ H ├┤ X ├┤ H ├──■──
+             └───┘└───┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(2)
+    qc.h(0)
+    qc.h(1)
+    qc.cx(0, 1)
+    qc.h(0)
+    qc.h(1)
+    qc.cx(1, 0)
+    return qc

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

@@ -0,0 +1,40 @@
+# 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 clifford_6_2():
+    """
+    Clifford template 6_2:
+
+     .. code-block:: text
+
+             ┌───┐
+        q_0: ┤ S ├──■───────────■───■─
+             ├───┤┌─┴─┐┌─────┐┌─┴─┐ │
+        q_1: ┤ S ├┤ X ├┤ SDG ├┤ X ├─■─
+             └───┘└───┘└─────┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(2)
+    qc.s(0)
+    qc.s(1)
+    qc.cx(0, 1)
+    qc.sdg(1)
+    qc.cx(0, 1)
+    qc.cz(0, 1)
+    return qc

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

@@ -0,0 +1,40 @@
+# 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 clifford_6_3():
+    """
+    Clifford template 6_3:
+
+    .. code-block:: text
+
+                   ┌───┐     ┌───┐
+        q_0: ─X──■─┤ H ├──■──┤ X ├─────
+              │  │ └───┘┌─┴─┐└─┬─┘┌───┐
+        q_1: ─X──■──────┤ X ├──■──┤ H ├
+                        └───┘     └───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(2)
+    qc.swap(0, 1)
+    qc.cz(0, 1)
+    qc.h(0)
+    qc.cx(0, 1)
+    qc.cx(1, 0)
+    qc.h(1)
+    return qc

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

@@ -0,0 +1,38 @@
+# 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 clifford_6_4():
+    """
+    Clifford template 6_4:
+
+    .. code-block:: text
+
+             ┌───┐┌───┐┌───┐┌───┐┌───┐┌───┐
+        q_0: ┤ S ├┤ H ├┤ S ├┤ H ├┤ S ├┤ H ├
+             └───┘└───┘└───┘└───┘└───┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(1)
+    qc.s(0)
+    qc.h(0)
+    qc.s(0)
+    qc.h(0)
+    qc.s(0)
+    qc.h(0)
+    return qc

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

@@ -0,0 +1,40 @@
+# 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 clifford_6_5():
+    """
+    Clifford template 6_5:
+
+    .. code-block:: text
+
+                      ┌───┐
+        q_0: ─■───■───┤ S ├───■───────
+              │ ┌─┴─┐┌┴───┴┐┌─┴─┐┌───┐
+        q_1: ─■─┤ X ├┤ SDG ├┤ X ├┤ S ├
+                └───┘└─────┘└───┘└───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(2)
+    qc.cz(0, 1)
+    qc.cx(0, 1)
+    qc.s(0)
+    qc.sdg(1)
+    qc.cx(0, 1)
+    qc.s(1)
+    return qc

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

@@ -0,0 +1,42 @@
+# 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 clifford_8_1():
+    """
+    Clifford template 8_1:
+
+    .. code-block:: text
+
+                       ┌───┐ ┌───┐ ┌───┐┌─────┐
+        q_0: ──■───────┤ X ├─┤ S ├─┤ X ├┤ SDG ├
+             ┌─┴─┐┌───┐└─┬─┘┌┴───┴┐└─┬─┘└┬───┬┘
+        q_1: ┤ X ├┤ H ├──■──┤ SDG ├──■───┤ H ├─
+             └───┘└───┘     └─────┘      └───┘
+
+    Returns:
+        QuantumCircuit: template as a quantum circuit.
+    """
+    qc = QuantumCircuit(2)
+    qc.cx(0, 1)
+    qc.h(1)
+    qc.cx(1, 0)
+    qc.s(0)
+    qc.sdg(1)
+    qc.cx(1, 0)
+    qc.sdg(0)
+    qc.h(1)
+    return qc