Source code for mimiqcircuits.operations.gates.generalized.diffusion
#
# Copyright © 2022-2023 University of Strasbourg. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
import mimiqcircuits as mc
from symengine import pi
[docs]
class Diffusion(mc.Gate):
"""
Grover's diffusion operator.
Args:
num_qubits (int): The number of qubits.
Raises:
ValueError: If the number of qubits is not an integer or less than 1.
Returns:
Diffusion: Grover's diffusion operator.
Attributes:
num_qubits (int): The number of qubits for the diffusion operator.
Examples:
>>> from mimiqcircuits import *
>>> c = Circuit()
>>> c.push(Diffusion(2), 1, 2)
3-qubit circuit with 1 instructions:
└── Diffusion @ q[1,2]
<BLANKLINE>
"""
_name = "Diffusion"
_num_qregs = 1
_num_qubits = None
def __init__(self, num_qubits):
if not isinstance(num_qubits, int):
raise ValueError("Number of qubits must be an integer.")
if num_qubits < 1:
raise ValueError("Number of qubits must be at least 1.")
super().__init__()
self._num_qubits = num_qubits
self._qregsizes = [num_qubits]
self._params = [num_qubits]
self._params = [num_qubits]
def __new__(cls, *args):
if len(args) == 0:
return mc.LazyExpr(Diffusion, mc.LazyArg())
elif len(args) == 1:
return object.__new__(cls)
else:
raise ValueError("Invalid number of arguments.")
def __str__(self):
return "Diffusion"
def _matrix(self):
raise NotImplementedError(
"Matrix representation for Diffusion operator is not implemented.")
def _decompose(self, circ, qubits, bits):
circ.push(mc.GateRY(pi / 2), qubits)
circ.push(mc.control(self.num_qubits - 1, mc.GateZ()), *qubits)
circ.push(mc.GateRY(pi / 2), qubits)
return circ
__all__ = ['Diffusion']