Source code for quantify_scheduler.backends.qblox.conditional
# Repository: https://gitlab.com/quantify-os/quantify-scheduler
# Licensed according to the LICENCE file on the main branch
"""Module containing logic to handle conditional playback."""
from __future__ import annotations
from dataclasses import InitVar, dataclass, field
from enum import Enum
from typing import TYPE_CHECKING, Sequence
if TYPE_CHECKING:
from quantify_scheduler.backends.qblox.operation_handling.base import (
IOperationStrategy,
)
@dataclass
[docs]
class ConditionalManager:
"""Class to manage a conditional control flow."""
[docs]
enable_conditional: list = field(default_factory=list)
"""Reference to initial `FEEDBACK_SET_COND` instruction."""
[docs]
num_real_time_instructions: int = 0
"""Number of real time instructions."""
[docs]
duration: int = field(default=0, init=False)
"""Duration of the conditional playback (not exposed to the user)."""
"""Start time of conditional playback."""
"""End time of conditional playback."""
[docs]
def update(self, operation: IOperationStrategy) -> None:
"""
Update the conditional manager.
Parameters
----------
operation : IOperationStrategy
Operation whose information is used to update the conditional manager.
time :
Timing
"""
if operation.operation_info.is_real_time_io_operation:
self.num_real_time_instructions += 1
[docs]
def replace_enable_conditional(self, instruction: list[str | int]) -> None:
"""
Replace the enable conditional instruction.
Parameters
----------
instruction : list[list]
Instruction that will replace the enable conditional instruction.
"""
self.enable_conditional.clear()
self.enable_conditional.extend(instruction)
[docs]
def reset(self) -> None:
"""Reset the conditional manager."""
self.enable_conditional = []
self.num_real_time_instructions = 0
self.duration = 0
@property
[docs]
def wait_per_real_time_instruction(self) -> int:
"""Instruction duration per real time instruction."""
self.duration = self.end_time - self.start_time
return self.duration // self.num_real_time_instructions
[docs]
class FeedbackTriggerOperator(Enum):
"""Enum for feedback trigger operations."""
"""Any selected counters exceed their thresholds."""
"""No selected counters exceed their thresholds."""
"""All selected counters exceed their thresholds."""
"""Any selected counters do not exceed their thresholds."""
"""An odd number of selected counters exceed their thresholds."""
"""An even number of selected counters exceed their thresholds."""
@dataclass
[docs]
class FeedbackTriggerCondition:
"""Contains all information needed to enable conditional playback."""
"""Enable/disable conditional playback."""
[docs]
operator: FeedbackTriggerOperator
"""
Specifies the logic to apply on the triggers that are selected by the mask.
See :class:`~FeedbackTriggerOperator` for more information.
"""
[docs]
addresses: InitVar[Sequence[int]]
"""
Sequence of trigger addresses to condition on. Addresses may
range from 1 to 15.
"""
[docs]
mask: int = field(init=False)
"""
Represents a bitwise mask in base-10. It dictates which trigger addresses
will be monitored. For example, to track addresses 0 and 3, the mask would
be 1001 in binary, which is 17 in base-10. This mask together with the
operator will determine the conditional operation.
"""
def __post_init__(self, addresses: Sequence[int]) -> None:
"""
Compute the mask that selects the addresses to be used.
This method is automatically invoked during the object's initialization
to set the `mask` attribute.
Example:
If we want to create a mask for the addresses 1 and 3, we have
the mask in binary `0101`, which corresponds to 5 in decimal notation.
Parameters
----------
duration : int
Duration of the conditional playback in ns (at least 4).
addresses : Sequence[int]
List of addresses used for computing the mask.
"""
self.mask = sum(2 ** (address - 1) for address in addresses)
