"""
Copyright 2024 Entropica Labs Pte Ltd
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.
"""
from dataclasses import dataclass, field
from abc import abstractmethod
from .base_operation import Operation, OpType
from .controlled_operation import has_ccontrol
[docs]
@dataclass
@has_ccontrol
class GateOperation(Operation):
"""
Operations of this type perform quantum gate operations on qubits within the Engine
during runtime.
"""
operation_type: str = field(default=OpType.QUANTUMGATE, init=False)
@property
@abstractmethod
def operating_qubit(self):
"""
Returns a list of qubits that the gate operation acts on.
"""
raise NotImplementedError
[docs]
@dataclass
class OneQubitGateOperation(GateOperation):
"""
A gate operation that acts on a single qubit.
"""
target_qubit: int
@property
def operating_qubit(self):
return [self.target_qubit]
[docs]
@dataclass
class Identity(OneQubitGateOperation):
"""
The Identity gate operation. It does nothing to the qubit.
"""
name: str = field(default="Identity", init=False)
[docs]
@dataclass
class Hadamard(OneQubitGateOperation):
"""
The Hadamard gate operation. Acts on a single qubit.
"""
name: str = field(default="Hadamard", init=False)
[docs]
@dataclass
class Phase(OneQubitGateOperation):
"""
The Phase gate operation. Acts on a single qubit.
"""
name: str = field(default="Phase", init=False)
[docs]
@dataclass
class PhaseInv(OneQubitGateOperation):
"""
The Phase Inverse gate operation. Acts on a single qubit.
"""
name: str = field(default="PhaseInv", init=False)
[docs]
@dataclass
class X(OneQubitGateOperation):
"""
The Pauli-X gate operation. Acts on a single qubit.
"""
name: str = field(default="X", init=False)
[docs]
@dataclass
class Z(OneQubitGateOperation):
"""
The Pauli-Z gate operation. Acts on a single qubit.
"""
name: str = field(default="Z", init=False)
[docs]
@dataclass
class Y(OneQubitGateOperation):
"""
The Pauli-Y gate operation. Acts on a single qubit.
"""
name: str = field(default="Y", init=False)
[docs]
@dataclass
class TwoQubitGateOperation(GateOperation):
"""
A gate operation that acts on two qubits.
"""
control_qubit: int
target_qubit: int
@property
def operating_qubit(self):
return [self.control_qubit, self.target_qubit]
[docs]
@dataclass
class CNOT(TwoQubitGateOperation):
"""
The CNOT gate operation. Acts on two qubits, the control and target qubits.
"""
name: str = field(default="CNOT", init=False)
[docs]
@dataclass
class CZ(TwoQubitGateOperation):
"""
The CZ gate operation. Acts on two qubits, the control and target qubits.
"""
name: str = field(default="CZ", init=False)
[docs]
@dataclass
class CY(TwoQubitGateOperation):
"""
The CY gate operation. Acts on two qubits, the control and target qubits.
"""
name: str = field(default="CY", init=False)
[docs]
@dataclass
class SWAP(TwoQubitGateOperation):
"""
The SWAP gate operation. Acts on two qubits, swapping their states.
"""
name: str = field(default="SWAP", init=False)