v0.32.0 - Zenith Angle Distribution Script (2026-07-03)¶

What Changed?¶

This release adds check_zenith.py, a new example script that plots event rate or layer efficiency as a function of zenith angle. It reads rate_summary_*.json files produced by check_event_rate.py --save from one or more directories.

What's New¶

Main Feature: check_zenith.py¶

What it does: Aggregates rate summary JSON files from multiple directories (one per zenith angle), sorts them by zenith angle, and produces a scatter plot of rate or efficiency vs zenith.

How to use it:

# Rate vs zenith from multiple directories
uv run examples/check_zenith.py ./deg0 ./deg30 ./deg45

# Efficiency vs zenith, saved to current directory
uv run examples/check_zenith.py ./deg0 ./deg30 ./deg45 --yaxis efficiency --save

# Filter hit_types
uv run examples/check_zenith.py ./deg0 ./deg30 --hit-type 1 --hit-type 7 --save

CLI Options:

Output files (with --save):

zenith_rate.png
zenith_efficiency.png

Installation¶

Quick Start¶

# Get the release
git checkout 0.32.0

# Setup
task env:setup

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?¶

✅ Added¶

• check_zenith.py: new example script for zenith angle dependence plots
• --yaxis rate: rate_mean per hit_type with rate_std error bars vs zenith
• --yaxis efficiency: η(T), η(M), η(B), η(TMB) vs zenith
• Accepts multiple input directories (list[Path])
• Marker-only plots (no connecting lines)

Is It Safe to Upgrade?¶

Backward Compatible: Yes

• New script only; no changes to existing scripts or library

Tests Passed¶

• ✅ Builds without errors
• ✅ uv run check_zenith.py ./deg0 ./deg30 ./deg45 plots rate vs zenith
• ✅ uv run check_zenith.py ./deg0 ./deg30 --yaxis efficiency --save saves zenith_efficiency.png

Release Details¶

• Date: 2026-07-03
• Version: v0.32.0
• Files Changed: 1 (check_zenith.py added)