Source code for braket.circuits.gate

# Copyright 2019-2019 Amazon.com, Inc. or its affiliates. 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. A copy of
# the License is located at
#
#     http://aws.amazon.com/apache2.0/
#
# or in the "license" file accompanying this file. This file 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 typing import Any, Sequence

from braket.circuits.quantum_operator import QuantumOperator
from braket.circuits.qubit_set import QubitSet


[docs]class Gate(QuantumOperator): """ Class `Gate` represents a quantum gate that operates on N qubits. Gates are considered the building blocks of quantum circuits. This class is considered the gate definition containing the metadata that defines what a gate is and what it does. """ def __init__(self, qubit_count: int, ascii_symbols: Sequence[str]): """ Args: qubit_count (int): Number of qubits this gate interacts with. ascii_symbols (Sequence[str]): ASCII string symbols for the gate. These are used when printing a diagram of circuits. Length must be the same as `qubit_count`, and index ordering is expected to correlate with target ordering on the instruction. For instance, if CNOT instruction has the control qubit on the first index and target qubit on the second index. Then ASCII symbols would have ["C", "X"] to correlate a symbol with that index. Raises: ValueError: `qubit_count` is less than 1, `ascii_symbols` are None, or `ascii_symbols` length != `qubit_count` """ super().__init__(qubit_count=qubit_count, ascii_symbols=ascii_symbols)
[docs] def to_ir(self, target: QubitSet) -> Any: """Returns IR object of quantum operator and target Args: target (QubitSet): target qubit(s) Returns: IR object of the quantum operator and target """ raise NotImplementedError("to_ir has not been implemented yet.")
def __eq__(self, other): if isinstance(other, Gate): return self.name == other.name return NotImplemented def __repr__(self): return f"{self.name}('qubit_count': {self.qubit_count})"
[docs] @classmethod def register_gate(cls, gate: "Gate"): """Register a gate implementation by adding it into the Gate class. Args: gate (Gate): Gate class to register. """ setattr(cls, gate.__name__, gate)