# Repository: https://gitlab.com/quantify-os/quantify-scheduler
# Licensed according to the LICENCE file on the main branch
"""The module provides classes related CZ operations."""
from __future__ import annotations
from typing import TYPE_CHECKING, Any
from qcodes.instrument import InstrumentChannel
from qcodes.instrument.parameter import ManualParameter
from quantify_scheduler.backends.graph_compilation import OperationCompilationConfig
from quantify_scheduler.device_under_test.edge import Edge
from quantify_scheduler.helpers.validators import (
Numbers,
)
from quantify_scheduler.operations.pulse_factories import (
composite_square_pulse,
non_implemented_pulse,
)
if TYPE_CHECKING:
from qcodes.instrument.base import InstrumentBase
[docs]
class PortSpinEdge(InstrumentChannel):
"""Submodule containing the ports."""
def __init__(
self,
parent: InstrumentBase,
name: str,
*,
gate: str | None = None,
) -> None:
super().__init__(parent=parent, name=name)
[docs]
self.gate = ManualParameter(
name="gate",
instrument=self,
initial_value=gate or f"{parent._parent_element_name}_{parent._child_element_name}:gt",
)
"""Name of the element's gate port."""
[docs]
class SpinInit(InstrumentChannel):
"""Submodule containing parameters for performing a SpinInit operation."""
def __init__(self, parent: InstrumentBase, name: str, **kwargs: Any) -> None: # noqa: ANN401, ARG002
super().__init__(parent=parent, name=name)
[docs]
class CZ(InstrumentChannel):
"""Submodule containing parameters for performing a CZ operation."""
def __init__(self, parent: InstrumentBase, name: str, **kwargs: float) -> None:
super().__init__(parent=parent, name=name)
[docs]
self.square_amp = ManualParameter(
"square_amp",
docstring=r"""Amplitude of the square envelope.""",
unit="V",
initial_value=kwargs.get("square_amp", 0),
vals=Numbers(min_value=0, allow_nan=True),
instrument=self,
)
[docs]
self.square_duration = ManualParameter(
"square_duration",
docstring=r"""The square pulse duration in seconds.""",
unit="s",
initial_value=kwargs.get("square_duration", 2e-8),
vals=Numbers(min_value=0, allow_nan=True),
instrument=self,
)
self.add_parameter(
name=f"{parent._parent_element_name}_phase_correction",
docstring=r"""The phase correction for the parent qubit after the"""
r""" square pulse operation has been performed.""",
unit="degrees",
parameter_class=ManualParameter,
initial_value=kwargs.get(f"{parent._parent_element_name}_phase_correction", 0),
vals=Numbers(min_value=-1e12, max_value=1e12, allow_nan=True),
)
self.add_parameter(
name=f"{parent._child_element_name}_phase_correction",
docstring=r"""The phase correction for the child qubit after the"""
r""" Square pulse operation has been performed.""",
unit="degrees",
parameter_class=ManualParameter,
initial_value=kwargs.get(f"{parent._child_element_name}_phase_correction", 0),
vals=Numbers(min_value=-1e12, max_value=1e12, allow_nan=True),
)
[docs]
class CNOT(InstrumentChannel):
"""Submodule containing parameters for performing a CNOT operation."""
def __init__(self, parent: InstrumentBase, name: str, **kwargs: Any) -> None: # noqa: ANN401, ARG002
super().__init__(parent=parent, name=name)
[docs]
class SpinEdge(Edge):
"""
Spin edge implementation which connects two SpinElements.
This edge implements some operations between the two SpinElements.
"""
def __init__(
self,
parent_element_name: str,
child_element_name: str,
**kwargs,
) -> None:
spin_init_data = kwargs.pop("spin_init", {})
cz_data = kwargs.pop("cz", {})
cnot_data = kwargs.pop("cnot", {})
ports_data = kwargs.pop("ports", {})
super().__init__(
parent_element_name=parent_element_name,
child_element_name=child_element_name,
**kwargs,
)
self.add_submodule("spin_init", SpinInit(parent=self, name="spin_init", **spin_init_data))
self.add_submodule("cz", CZ(parent=self, name="cz", **cz_data))
self.add_submodule("cnot", CNOT(parent=self, name="cnot", **cnot_data))
self.add_submodule("ports", PortSpinEdge(parent=self, name="ports", **ports_data))
[docs]
def generate_edge_config(self) -> dict[str, dict[str, OperationCompilationConfig]]:
"""
Generate valid device config.
Fills in the edges information to produce a valid device config for the
quantify-scheduler making use of the
:func:`~.circuit_to_device.compile_circuit_to_device_with_config_validation` function.
"""
edge_op_config = {
f"{self.name}": {
"SpinInit": OperationCompilationConfig(
factory_func=non_implemented_pulse,
factory_kwargs={},
),
"CZ": OperationCompilationConfig(
factory_func=composite_square_pulse,
factory_kwargs={
"square_port": self.ports.gate(),
"square_clock": "cl0.baseband",
"square_amp": self.cz.square_amp(),
"square_duration": self.cz.square_duration(),
"virt_z_parent_qubit_phase": self.cz.parameters[
f"{self._parent_element_name}_phase_correction"
](),
"virt_z_parent_qubit_clock": f"{self.parent_device_element.name}.f_larmor",
"virt_z_child_qubit_phase": self.cz.parameters[
f"{self._child_element_name}_phase_correction"
](),
"virt_z_child_qubit_clock": f"{self.child_device_element.name}.f_larmor",
},
),
"CNOT": OperationCompilationConfig(
factory_func=non_implemented_pulse,
factory_kwargs={},
),
}
}
return edge_op_config
