sandialabs / LoQS / 31993797025

88%

push

github

Multiqubit generalization of `PatchDict` to `PatchLayout` (#112)

* Add QECCodePatch.data_qubits and the PatchLayout/PatchRelation classes (#103)

QECCodePatch.data_qubits maps a patch's template data qubits onto its own real qubits, the same computation QECCode.create_patch already does inline for a patch's initial PauliFrame. PatchLayout is a superset of PatchDict that additionally tracks PatchRelation objects -- data-only runtime state about a relationship between a set of patches (e.g. seam qubits, joint measurement bookkeeping), keyed by the sorted tuple of participants' patch labels (not a frozenset, unsupported by LoQS's serialization framework). Patch removal auto-drops any relation referencing the removed label, and get_relation warns on an unknown label. Added alongside the existing PatchDict, not yet wired into QuantumProgram/builders.py/codepacks.

* Wire QuantumProgram to PatchLayout and add patch_data[<name>] priority (#103)

* Retrofit builders.py and all codepacks for PatchLayout (#103)

build_patch_builder_instruction/build_patch_remover_instruction now construct/consume PatchLayout; patch removal auto-drops any PatchRelation referencing the removed label via PatchLayout's own __delitem__, needing no extra code here.

codepack_surf17_multipatch.py: build_cnot_bookkeeping_instruction drops its ctrl_data_qubits/tgt_data_qubits parameters, reading each patch's own data qubits via QECCodePatch.data_qubits at apply time instead; the joint_parity_zz/xx frame keys are now scoped by participant patch labels to avoid collisions between simultaneous multi-patch operations.

codepack_surf17_surgery.py: build_merge_instruction's bookkeeping now registers a PatchRelation holding the grown-check rows, byproduct, and repair-key data that build_split_byproduct_repair_instruction previously recomputed independently via its own _surgery_metadata call -- that instruction's signature drops kind/qubits_a/qubits_b/seam_qubits/layout entirely, reading the r... (continued)

1359 of 1493 branches covered (91.02%)

Branch coverage included in aggregate %.

7553 of 8506 relevant lines covered (88.8%)

0.89 hits per line