Skip to content

v0.4.8 - Threshold Plotting Script Enhancements (2025-12-24)

What Changed?

This release adds progress bars to the plot_thresholds.py example script for visual feedback during channel plotting. The script now displays a progress bar as it generates threshold response plots for each detector channel. All improvements maintain backward compatibility with existing threshold plotting workflows.

What's New

Main Feature: Progress Bars for Threshold Plot Generation

What it does: The plot_thresholds.py example script now includes visual progress bars during the plotting phase. Users receive real-time feedback on plot generation progress as the script iterates through each detector channel.

How to use it: Simply run the plot_thresholds.py script as before - progress bars are automatic and transparent:

# Progress bar shown during plot generation
uv run plot_thresholds.py ./measurements/fitted_thresholds.json

# Save plots with progress feedback
uv run plot_thresholds.py ./measurements/fitted_thresholds.json --format pdf --save

# High resolution plots with progress
uv run plot_thresholds.py ./measurements/fitted_thresholds.json --dpi 300 --save

Installation

Quick Start

# Get the release
git checkout v0.4.8

# Setup
task env:setup

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

✅ Added

  • Progress bars for threshold plot generation with visual feedback
  • Rich console output with colored status messages
  • Global console instances (stdout/stderr) for consistent formatting
  • rich dependency to PEP 723 script dependencies

🔧 Changed

  • Replaced plain print() calls with stderr.print() for consistent output stream
  • Updated all output messages to use Rich color markup:
  • [cyan] for informational messages
  • [green] for success messages
  • [red] for error messages
  • Progress bars display on stderr during channel plotting
  • Verbose logging switched to silent during progress bar display for cleaner output

🐛 Fixed

  • None (enhancement release)

Is It Safe to Upgrade?

Backward Compatible: Yes

  • All existing functionality preserved
  • Plot generation algorithm unchanged
  • Plot output format and quality unaffected
  • Progress bars only enhance visibility without disrupting operations
  • Command-line interface remains the same

Tests Passed

  • ✅ Builds without errors
  • ✅ Progress bars display correctly during channel plotting
  • ✅ Plot generation logic unchanged and verified
  • ✅ Console output formatting consistent with project standards
  • ✅ Pre-commit hooks passed (commitizen check)

Release Details

  • Date: 2025-12-24
  • Version: v0.4.8
  • Files Changed: 2 (examples/plot_thresholds.py, version files)
  • Commits:
  • 7cb35c8 - feat: add progress bar to plot_thresholds.py channel plotting
  • 35c136e - bump: version 0.4.7 → 0.4.8

Next Steps

  • Consider adding elapsed time and ETA to progress bars for long-running plot generation
  • Evaluate consistency of progress bars across all example scripts
  • Gather user feedback on visual output and progress bar styling