Struct LogicalQubitAllocator 

pub struct LogicalQubitAllocator { /* private fields */ }

Allocates logical qubit patches on a physical qubit grid.

A distance-d surface code patch requires d^2 data qubits and (d-1)^2 + (d-1)^2 = 2(d-1)^2 ancilla qubits, totaling d^2 + 2(d-1)^2 = 2d^2 - 2d + 1 physical qubits per logical qubit.

Patches are laid out on a 2D grid with d-qubit spacing between patch origins to avoid overlap.

Implementations

impl LogicalQubitAllocator

pub fn new(total_physical: u32, code_distance: u32) -> Self

Create a new allocator with the given total physical qubit count and default code distance.

pub fn max_logical_qubits(&self) -> u32

Maximum number of logical qubits that can be allocated.

Each logical qubit requires 2d^2 - 2d + 1 physical qubits.

pub fn allocate(&mut self) -> Option<SurfaceCodePatch>

Allocate a new logical qubit patch.

Returns None if insufficient physical qubits remain.

pub fn deallocate(&mut self, logical_id: u32)

Deallocate a logical qubit by its logical ID.

pub fn utilization(&self) -> f64

Return the fraction of physical qubits currently allocated.

pub fn patches(&self) -> &[SurfaceCodePatch]

Return a reference to all currently allocated patches.