Skip to content

v0.3.10 - Enhanced Real-time Monitor Statistics (2025-12-23)

What Changed?

This release enhances the real-time TUI monitor with more detailed hit type analysis. The StatisticsPanel now displays individual hit type distributions (Type 1-7) alongside the existing layer-based hit distribution, providing users with deeper insight into detector event patterns.

What's New

Main Feature: HitType Distribution Display

What it does: The monitor now displays a breakdown of each hit type (1 through 7) showing the count of events matching each type. This complements the existing Hit Distribution view (1-Layer, 2-Layer, 3-Layer) and helps users analyze detector performance at a more granular level.

How to use it: The HitType Distribution appears automatically in the Statistics panel when monitoring detector events:

# Read from piped input
uv run kazunoko generate ... | uv run monitor.py

# Monitor a directory
uv run monitor.py --watch /path/to/data/directory

The statistics panel will display:

  • Total Events and File Count
  • Event Rate (events/sec)
  • Hit Distribution (layer-based summary)
  • HitType Distribution (Type 1-7 breakdown)
  • ADC Statistics
  • Last Update timestamp

Installation

Quick Start

# Get the release
git checkout v0.3.10

# Setup
task env:setup

# Run monitor
uv run examples/monitor.py

# Or with directory watching
uv run examples/monitor.py --watch ~/detector_data

What's Different from the Last Version?

✅ Added

  • HitType Distribution display in StatisticsPanel showing counts for each hit type (Type 1-7)
  • Real-time hit type analysis alongside existing layer-based distribution

🔧 Changed

  • Enhanced _update_display() method to calculate individual hit_type distributions
  • Improved statistics panel rendering for better data visibility

Is It Safe to Upgrade?

Backward Compatible: Yes

  • All existing monitor functionality is preserved
  • The new HitType Distribution is displayed alongside existing statistics without affecting other features
  • No API changes or breaking changes

Tests Passed

  • ✅ Builds without errors
  • ✅ Monitor displays HitType Distribution correctly
  • ✅ Pre-commit hooks passed

Release Details

  • Date: 2025-12-23
  • Version: v0.3.10
  • Files Changed: 1
  • Commits: 59af2e8 (feat: add HitType Distribution to StatisticsPanel), 8eee30b (bump: version 0.3.9 → 0.3.10)

Next Steps

Future enhancements could include filtering statistics by hit type ranges, historical trend analysis, and customizable display layouts for the monitor panel.