qiskit/test/python/circuit/library/test_grover_operator.py

222 lines
8.6 KiB
Python

# This code is part of Qiskit.
#
# (C) Copyright IBM 2017, 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.
"""Test the grover operator."""
import unittest
from ddt import ddt, data
import numpy as np
from qiskit import transpile
from qiskit.circuit import QuantumCircuit, Qubit, AncillaQubit
from qiskit.circuit.library import GroverOperator, grover_operator
from qiskit.converters import circuit_to_dag
from qiskit.quantum_info import Operator, Statevector, DensityMatrix
from test import QiskitTestCase # pylint: disable=wrong-import-order
@ddt
class TestGroverOperator(QiskitTestCase):
"""Test the Grover operator."""
def assertGroverOperatorIsCorrect(self, grover_op, oracle, state_in=None, zero_reflection=None):
"""Test that ``grover_op`` implements the correct Grover operator."""
oracle = Operator(oracle)
if state_in is None:
state_in = QuantumCircuit(oracle.num_qubits)
state_in.h(state_in.qubits)
state_in = Operator(state_in)
if zero_reflection is None:
zero_reflection = np.eye(2**oracle.num_qubits)
zero_reflection[0][0] = -1
zero_reflection = Operator(zero_reflection)
expected = state_in.dot(zero_reflection).dot(state_in.adjoint()).dot(oracle)
self.assertTrue(Operator(grover_op).equiv(expected))
@data(True, False)
def test_grover_operator(self, use_function):
"""Test the base case for the Grover operator."""
grover_constructor = grover_operator if use_function else GroverOperator
with self.subTest("single Z oracle"):
oracle = QuantumCircuit(3)
oracle.z(2) # good state if last qubit is 1
grover_op = grover_constructor(oracle)
self.assertGroverOperatorIsCorrect(grover_op, oracle)
with self.subTest("target state x0x1"):
oracle = QuantumCircuit(4)
oracle.x(1)
oracle.z(1)
oracle.x(1)
oracle.z(3)
grover_op = grover_constructor(oracle)
self.assertGroverOperatorIsCorrect(grover_op, oracle)
@data(True, False)
def test_quantum_info_input(self, use_function):
"""Test passing quantum_info.Operator and Statevector as input."""
grover_constructor = grover_operator if use_function else GroverOperator
mark = Statevector.from_label("001")
diffuse = 2 * DensityMatrix.from_label("000") - Operator.from_label("III")
grover_op = grover_constructor(oracle=mark, zero_reflection=diffuse)
self.assertGroverOperatorIsCorrect(
grover_op, oracle=np.diag((-1) ** mark.data), zero_reflection=diffuse.data
)
@data(True, False)
def test_stateprep_contains_instruction(self, use_function):
"""Test wrapping works if the state preparation is not unitary."""
oracle = QuantumCircuit(1)
oracle.z(0)
instr = QuantumCircuit(1)
instr.s(0)
instr = instr.to_instruction()
stateprep = QuantumCircuit(1)
stateprep.append(instr, [0])
grover_constructor = grover_operator if use_function else GroverOperator
grover_op = grover_constructor(oracle, stateprep)
self.assertEqual(grover_op.num_qubits, 1)
@data(True, False)
def test_reflection_qubits(self, use_function):
"""Test setting idle qubits doesn't apply any operations on these qubits."""
oracle = QuantumCircuit(4)
oracle.z(3)
grover_constructor = grover_operator if use_function else GroverOperator
grover_op = grover_constructor(oracle, reflection_qubits=[0, 3])
dag = circuit_to_dag(grover_op.decompose())
self.assertEqual(set(dag.idle_wires()), {dag.qubits[1], dag.qubits[2]})
@data(True, False)
def test_custom_state_in(self, use_function):
"""Test passing a custom state_in operator."""
oracle = QuantumCircuit(1)
oracle.z(0)
bernoulli = QuantumCircuit(1)
sampling_probability = 0.2
bernoulli.ry(2 * np.arcsin(np.sqrt(sampling_probability)), 0)
grover_constructor = grover_operator if use_function else GroverOperator
grover_op = grover_constructor(oracle, bernoulli)
self.assertGroverOperatorIsCorrect(grover_op, oracle, bernoulli)
@data(True, False)
def test_custom_zero_reflection(self, use_function):
"""Test passing in a custom zero reflection."""
oracle = QuantumCircuit(1)
oracle.z(0)
zero_reflection = QuantumCircuit(1)
zero_reflection.x(0)
zero_reflection.rz(np.pi, 0)
zero_reflection.x(0)
grover_constructor = grover_operator if use_function else GroverOperator
grover_op = grover_constructor(oracle, zero_reflection=zero_reflection)
with self.subTest("zero reflection up to phase works"):
self.assertGroverOperatorIsCorrect(grover_op, oracle)
with self.subTest("circuits match"):
expected = QuantumCircuit(*grover_op.qregs, global_phase=np.pi)
expected.compose(oracle, inplace=True)
expected.h(0) # state_in is H
expected.compose(zero_reflection, inplace=True)
expected.h(0)
self.assertEqual(expected, grover_op if use_function else grover_op.decompose())
@data(True, False)
def test_num_mcx_ancillas(self, use_function):
"""Test the number of ancilla bits for the mcx gate in zero_reflection."""
#
# q_0: ──■──────────────────────
# │
# q_1: ──■──────────────────────
# │
# q_2: ──┼────■─────────────────
# │ │
# q_3: ──┼────■─────────────────
# ┌─┴─┐ │
# q_4: ┤ X ├──┼────■────────────
# └───┘┌─┴─┐ │
# q_5: ─────┤ X ├──■────────────
# ┌───┐├───┤┌─┴─┐┌───┐┌───┐
# q_6: ┤ X ├┤ H ├┤ X ├┤ H ├┤ X ├
# └───┘└───┘└───┘└───┘└───┘
oracle = QuantumCircuit(7)
oracle.x(6)
oracle.h(6)
oracle.ccx(0, 1, 4)
oracle.ccx(2, 3, 5)
oracle.ccx(4, 5, 6)
oracle.h(6)
oracle.x(6)
grover_constructor = grover_operator if use_function else GroverOperator
grover_op = grover_constructor(oracle, reflection_qubits=[0, 1])
self.assertEqual(grover_op.width(), 7)
def test_mcx_allocation(self):
"""The the automatic allocation of auxiliary qubits for MCX."""
num_qubits = 10
oracle = QuantumCircuit(num_qubits)
oracle.z(oracle.qubits)
grover_op = grover_operator(oracle)
# without extra qubit space, the MCX gates are synthesized without ancillas
basis_gates = ["u", "cx"]
is_2q = lambda inst: len(inst.qubits) == 2
with self.subTest(msg="no auxiliaries"):
tqc = transpile(grover_op, basis_gates=basis_gates)
depth = tqc.depth(filter_function=is_2q)
self.assertLess(depth, 500)
self.assertGreater(depth, 100)
# add extra bits that can be used as scratch space
grover_op.add_bits([Qubit() for _ in range(num_qubits)])
with self.subTest(msg="with auxiliaries"):
tqc = transpile(grover_op, basis_gates=basis_gates)
depth = tqc.depth(filter_function=is_2q)
self.assertLess(depth, 100)
def test_ancilla_detection(self):
"""Test AncillaQubit objects are correctly identified in the oracle."""
qubits = [AncillaQubit(), Qubit()]
oracle = QuantumCircuit()
oracle.add_bits(qubits)
oracle.z(qubits[1]) # the "good" state is qubit 1 being in state |1>
grover_op = grover_operator(oracle)
expected_h = 2 # would be 4 if the ancilla is not detected
self.assertEqual(expected_h, grover_op.count_ops().get("h", 0))
if __name__ == "__main__":
unittest.main()