qat.model.loaders.lucy module

class LucyCouplingDirection(value)

Bases: Enum

Enum for the coupling direction between qubits on a Lucy model.

LEFT = 'left'
RANDOM = 'random'
RIGHT = 'right'
class LucyCouplingQuality(value)

Bases: Enum

Describes the coupling quality settings for a Lucy model.

RANDOM = 'random'
UNIFORM = 'uniform'
class LucyModelLoader(qubit_count=8, coupling_direction=LucyCouplingDirection.RIGHT, coupling_qualities=LucyCouplingQuality.UNIFORM, qubit_baseband_frequency=5500000000.0, resonator_baseband_frequency=8500000000.0, qubit_baseband_if_frequency=250000000.0, resonator_baseband_if_frequency=250000000.0, drive_frequency=5500000000.0, measure_frequency=8500000000.0, cr_scale=50.0, crc_scale=0.0, random_seed=None, start_index=0)

Bases: BasePhysicalModelLoader

Factory for creating mock Lucy hardware models. That is, a model of QPUs that have qubits arranged on a ring.

The direction of couplings can be specified to go in either direction, or have each coupling choosen randomly. The coupling quality can be set to uniform, or random, or custom qualities can be provided as a dictionary mapping pairs of qubits to their coupling quality. Furthermore, some properties of the pulse channels can be provided.

Parameters:

  • qubit_count (int) – The number of qubits in the model. Default is 8.

  • coupling_direction (LucyCouplingDirection) – The direction of the coupling between qubits. Default is LucyCouplingDirection.RIGHT.

  • coupling_qualities (LucyCouplingQuality | dict[tuple[int, int], float]) – The coupling quality settings for the model. Default is LucyCouplingQuality.UNIFORM. Can also be a dictionary mapping pairs of qubits to their coupling quality.

  • qubit_baseband_frequency (float) – The baseband frequency for the qubits. Default is 5.5 GHz.

  • resonator_baseband_frequency (float) – The baseband frequency for the resonators. Default is 8.5 GHz.

  • qubit_baseband_if_frequency (float) – The IF frequency for the qubits. Default is 250 MHz.

  • resonator_baseband_if_frequency (float) – The IF frequency for the resonators. Default is 250 MHz.

  • drive_frequency (float) – The frequency of the drive pulse channels. Default is 5.5 GHz.

  • measure_frequency (float) – The frequency of the measure pulse channels. Default is 8.5 GHz.

  • cr_scale (float) – The scale factor for the cross-resonance pulse channels. Default is 50.0.

  • crc_scale (float) – The scale factor for the cross-resonance cancellation pulse channels. Default is 0.0.

  • random_seed (Optional[int]) – An optional seed for the random number generator to ensure reproducibility.

  • start_index (int) – The starting index for the qubits; useful for testing systems with non-standard indexing conventions. Default is 0.

load()

Load and return the Hardware Model.

Returns:

A loaded Hardware Model

Return type:

LegacyHardwareModel | LogicalHardwareModel