bloqade.lanes.analysis.atom.AtomPosition
← Module overview
class
classAtomPosition¶source
bloqade.lanes.analysis.atom.AtomPosition
One atom, and where it was when a measurement happened.
class AtomPositionBoth optional fields are deliberately non-defaulting: every
construction site states them, so a missing value is a type error
rather than a silent None.
Attributes
| Name | Type | Description |
|---|---|---|
qubit_id | int | the physical qubit occupying ``location_address``. |
location_address | LocationAddress | the hardware location it occupied. |
position | tuple[float, float] | that location's physical ``(x, y)`` coordinates, resolved through ``ArchSpec.get_position``. |
measurement_id | int | None | the atom's column in the raw per-shot measurement array, or ``None`` when the program never read this atom's result. Set on every ``readout`` entry and ``None`` everywhere else — it is never invented for atoms the program didn't read. |
frame_index | int | None | the atom's slot in the measurement's frame (see the module docstring). ``None`` *only* for a ``qpu_state`` atom sitting in a zone the measurement doesn't cover, which has no slot in that frame. Always populated on ``readout`` and ``measured_zones``, both of which are built from the measurement's own zones. |