Class ArrayOfLatencyRecords

LatencyMap.py:285–496

Holds the scrolling window (time axis) of LatencyRecord objects.

class ArrayOfLatencyRecords:
    """
    Holds the scrolling window (time axis) of LatencyRecord objects.
    """
    BLUE_PALETTE = {0: 15, 1: 51, 2: 45, 3: 39, 4: 33, 5: 27, 6: 21}    # white→deep blue bg
    RED_PALETTE = {0: 15, 1: 226, 2: 220, 3: 214, 4: 208, 5: 202, 6: 196}  # white→red bg
    ESC_RESET = "\x1b[0m"

    def __init__(self) -> None:
        self.sample_number: int = 0
        # IMPORTANT: create distinct empty records (no shared reference)
        self.data: List[LatencyRecord] = [LatencyRecord() for _ in range(0, g_params.num_latency_records + 1)]

    # ------------------------------- Debug -------------------------------- #

    def print_frequency_histograms_debug(self) -> None:
        print('\nFrequency histograms:')
        for record in self.data:
            print(record.frequency_histogram, record.delta_time)

    def print_intensity_histograms_debug(self) -> None:
        print('\nIntensity histograms:')
        for record in self.data:
            print(record.intensity_histogram, record.delta_time)

    # ------------------------------ Charting ------------------------------ #

    def add_new_record(self, record: LatencyRecord) -> None:
        # Scroll window: discard oldest, append newest
        self.data = self.data[1:] + [record]
        self.sample_number += 1

    @staticmethod
    def _bg_color(token: int, palette: str) -> str:
        if palette == 'blue':
            c = ArrayOfLatencyRecords.BLUE_PALETTE[token]
        elif palette == 'red':
            c = ArrayOfLatencyRecords.RED_PALETTE[token]
        else:
            raise ValueError("palette must be 'blue' or 'red'")
        return f"\x1b[48;5;{c}m"

    @staticmethod
    def _fmt_value(v: float) -> str:
        if v < 0:
            return "0"
        if v <= 9:
            return f"{v:.1g}"
        if v < 1_000_000:
            return str(int(round(v)))
        return f"{v:.2g}"

    @staticmethod
    def _bucket_ms_label(bucket_exp: int) -> str:
        """
        Render the bucket upper bound as milliseconds for the left axis.
        - Always display in ms.
        - For <1ms: show with leading dot, e.g., .512