iqm.error_reduction_tools.utils.topology_utils.compute_crystal_layout

iqm.error_reduction_tools.utils.topology_utils.compute_crystal_layout#

iqm.error_reduction_tools.utils.topology_utils.compute_crystal_layout(couplers, qubits)#

Compute a square-grid layout for IQM Crystal architecture QPUs.

Uses the coupler connectivity graph to recursively identify 4-qubit plaquettes and assign (x, y) grid coordinates. This algorithm works for any IQM Crystal QPU (Garnet, Emerald, etc.) but will not work with the IQM Star topology.

Parameters:

  • couplers (list[tuple[str, str]]) – Qubit pairs representing the connectivity.

  • qubits (list[str]) – Qubit names on the QPU.

Returns:

Mapping from qubit names to (x, y) integer grid positions. Qubits that could not be placed (e.g. in a Star topology) are omitted.

Return type:

dict[str, tuple[int, int]]

Contents