"""Standardized container for loaded readout data."""
from __future__ import annotations
from dataclasses import dataclass, field
from typing import Any
import numpy as np
[docs]
@dataclass
class DataBundle:
"""Standardized container for loaded readout data.
Attributes:
traces: IQ trace array. Shape is ``(n_shots, n_time, 2)`` or
``(n_states, n_shots, n_time, 2)`` for state-sorted data.
labels: Integer class labels, or ``None`` if not available.
time: Time-axis array, or ``None``.
metadata: Provenance information (source path, format, etc.).
"""
traces: np.ndarray
labels: np.ndarray | None = None
time: np.ndarray | None = None
metadata: dict[str, Any] = field(default_factory=dict)