[QILI-48] Implement platform, backend and settings classes

.github/workflows/pull_request_ci.yml

@@ -28,6 +28,7 @@ jobs:
         run: |
           python -m pip install -U pip
           python -m pip install -r dev-requirements.txt
+          python -m pip install -r requirements.txt
 
       - name: Code Quality
         run: |

.pre-commit-config.yaml

@@ -27,6 +27,7 @@ repos:
     hooks:
       - id: mypy
         args: [--no-strict-optional, --ignore-missing-imports]
+        additional_dependencies: [types-PyYAML==6.0.5]
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v4.1.0
@@ -59,10 +60,7 @@ repos:
         entry: pylint
         language: system
         types: [python]
-        args: [
-            "src",
-            "-E", # Only check for errors
-          ]
+        args: ["-E"] # Only check for errors
 
   - repo: https://github.com/executablebooks/mdformat
     rev: 0.7.14 # Use the ref you want to point at

MANIFEST.in

@@ -0,0 +1 @@
+recursive-include src *.yml

dev-requirements.txt

@@ -99,6 +99,7 @@ tomli==2.0.1
 tomlkit==0.10.0
 tornado==6.1
 traitlets==5.1.1
+types-PyYAML==6.0.5
 typing-extensions==4.1.1
 uc-micro-py==1.0.1
 urllib3==1.26.9

examples/load_platform.py

@@ -0,0 +1,27 @@
+import qibo
+
+from qililab import PLATFORM_BUILDER
+
+# FIXME: Need to add backend in qibo's profiles.yml file
+backend = {
+    "name": "qililab",
+    "driver": "qililab.backend.QililabBackend",
+    "minimum_version": "0.0.1.dev0",
+    "is_hardware": True,
+}
+qibo.K.profile["backends"].append(backend)
+# ------------------------------------------------------
+
+
+def load_platform() -> None:
+    """Load the platform 'platform_0' from the settings folder."""
+    # Using qibo (needed when using qibo circuits)
+    qibo.set_backend(backend="qililab", platform="platform_0")
+    print(f"Platform name: {qibo.K.platform}")
+    # Using PLATFORM_BUILDER
+    platform = PLATFORM_BUILDER.build(name="platform_0")
+    print(f"Platform name: {platform}")
+
+
+if __name__ == "__main__":
+    load_platform()

requirements.txt

@@ -1,4 +1,7 @@
 # here goes your library dependencies to be installed
 # with the exact version
-# example: 
-# scipy==1.8.0
+# example:
+# scipy==1.8.0
+qibo==0.1.7
+pyyaml==6.0
+typeguard==2.13.3

src/qililab/__init__.py

@@ -1,3 +1,5 @@
 __version__ = "0.0.0"
 
-from .qililab import Qililab
+from .circuit import HardwareCircuit
+from .gates import I, X, Y, Z
+from .platforms import PLATFORM_BUILDER

src/qililab/backend.py

@@ -0,0 +1,62 @@
+from dataclasses import dataclass
+from typing import ClassVar, Type
+
+from qibo.backends.numpy import NumpyBackend
+
+from qililab import gates
+from qililab.circuit import HardwareCircuit
+from qililab.platforms import PLATFORM_BUILDER
+from qililab.platforms.platform import Platform
+
+
+@dataclass
+class QililabBackend(NumpyBackend):
+    """Hardware backend used to execute circuits on specified lab platforms
+
+    Attributes:
+        name (str): Name of the backend.
+        is_hardware (bool): Flag used by Qibo to identify a hardware backend.
+        platform (object): Platform object describing the lab setup.
+
+    """
+
+    name: str
+    is_hardware: bool
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.platform: Platform
+        self.name = "qililab"
+        self.is_hardware = True
+
+    def set_platform(self, platform: str) -> None:
+        """Set platform for controlling quantum devices.
+
+        Args:
+            name (str): Name of the platform.
+        """
+        self.platform = PLATFORM_BUILDER.build(name=platform)
+
+    def get_platform(self) -> str:
+        """
+        Returns:
+            str: Platform name.
+        """
+        return str(self.platform)
+
+    def circuit_class(self, accelerators: dict = None, density_matrix: bool = False) -> Type[HardwareCircuit]:
+        """
+        Returns:
+            Type[HardwareCircuit]: Circuit class used to create circuit model.
+        """
+        if accelerators is not None:
+            raise NotImplementedError("Hardware backend does not support multi-GPU configuration.")
+        if density_matrix:
+            raise NotImplementedError("Hardware backend does not support density matrix simulation.")
+
+        return HardwareCircuit
+
+    def create_gate(self, cls, *args, **kwargs) -> object:
+        """Create gate object"""
+
+        return getattr(gates, cls.__name__)(*args, **kwargs)

src/qililab/circuit.py

@@ -0,0 +1,18 @@
+from dataclasses import dataclass
+
+from numpy import ndarray
+
+
+@dataclass
+class HardwareCircuit:
+    """Class used to create circuit model.
+
+    Args:
+        nqubits (int): Number of qubits.
+    """
+
+    nqubits: int
+
+    def execute(self, initial_state: ndarray = None, nshots: int = None):
+        """Executes a pulse sequence"""
+        raise NotImplementedError

src/qililab/constants.py

@@ -0,0 +1,2 @@
+DEFAULT_PLATFORM_FILENAME = "platform"
+DEFAULT_SETTINGS_FOLDERNAME = "qili"

src/qililab/gates/__init__.py

@@ -0,0 +1,4 @@
+from .i import I
+from .x import X
+from .y import Y
+from .z import Z

src/qililab/gates/hardware_gate.py

@@ -0,0 +1,17 @@
+import sys
+from abc import ABC, abstractmethod
+
+
+class HardwareGate(ABC):
+    """Abstract Base Class of a hardware gate."""
+
+    module = sys.modules[__name__]  # used to avoid maximum recursion depth with qibo gates
+
+    # TODO: Replace 'object' with PulseSequence class
+    @abstractmethod
+    def to_sequence(self, sequence: object) -> None:
+        """Translates the gate to pulses and adds them to the given PulseSequence.
+
+        Args:
+            sequence (PulseSequence): Class containing the sequence of pulses to be applied.
+        """

src/qililab/gates/i.py

@@ -0,0 +1,22 @@
+from dataclasses import dataclass
+
+from qililab.gates.hardware_gate import HardwareGate
+
+
+@dataclass
+class I(HardwareGate):  # noqa: E742
+    """Identity gate
+
+    Args:
+        q (int): Index of the qubit to which the gate is applied.
+    """
+
+    q: int
+
+    def to_sequence(self, sequence: object) -> None:
+        """Translates the gate to pulses and adds them to the given PulseSequence.
+
+        Args:
+            sequence (PulseSequence): Class containing the sequence of pulses to be applied.
+        """
+        raise NotImplementedError

src/qililab/gates/x.py

@@ -0,0 +1,22 @@
+from dataclasses import dataclass
+
+from qililab.gates.hardware_gate import HardwareGate
+
+
+@dataclass
+class X(HardwareGate):
+    """X gate
+
+    Args:
+        q (int): Index of the qubit to which the gate is applied.
+    """
+
+    q: int
+
+    def to_sequence(self, sequence: object) -> None:
+        """Translates the gate to pulses and adds them to the given PulseSequence.
+
+        Args:
+            sequence (PulseSequence): Class containing the sequence of pulses to be applied.
+        """
+        raise NotImplementedError

src/qililab/gates/y.py

@@ -0,0 +1,22 @@
+from dataclasses import dataclass
+
+from qililab.gates.hardware_gate import HardwareGate
+
+
+@dataclass
+class Y(HardwareGate):
+    """Y gate
+
+    Args:
+        q (int): Index of the qubit to which the gate is applied.
+    """
+
+    q: int
+
+    def to_sequence(self, sequence: object) -> None:
+        """Translates the gate to pulses and adds them to the given PulseSequence.
+
+        Args:
+            sequence (PulseSequence): Class containing the sequence of pulses to be applied.
+        """
+        raise NotImplementedError

src/qililab/gates/z.py

@@ -0,0 +1,22 @@
+from dataclasses import dataclass
+
+from qililab.gates.hardware_gate import HardwareGate
+
+
+@dataclass
+class Z(HardwareGate):
+    """Z gate
+
+    Args:
+        q (int): Index of the qubit to which the gate is applied.
+    """
+
+    q: int
+
+    def to_sequence(self, sequence: object) -> None:
+        """Translates the gate to pulses and adds them to the given PulseSequence.
+
+        Args:
+            sequence (PulseSequence): Class containing the sequence of pulses to be applied.
+        """
+        raise NotImplementedError

src/qililab/platforms/__init__.py

@@ -0,0 +1,4 @@
+from .platform import Platform
+from .platform_builder import PlatformBuilder
+
+PLATFORM_BUILDER = PlatformBuilder()

src/qililab/platforms/platform.py

@@ -0,0 +1,24 @@
+from dataclasses import dataclass
+
+from qililab.settings.settings import Settings
+
+
+@dataclass
+class Platform:
+    """Platform object that describes setup used to control quantum devices.
+
+    Args:
+        name (str): Name of the platform.
+        settings (Settings): Dataclass containing the settings of the platform.
+    """
+
+    name: str
+    settings: Settings
+
+    def __str__(self) -> str:
+        """String representation of the platform
+
+        Returns:
+            str: Name of the platform
+        """
+        return self.name