Skip to content

v0.2.1 - Bug Fix and Parameter Refinement (2025-12-21)

What Changed?

This patch release fixes a bug in the threshold scanning examples where unscanned channels were incorrectly using center values instead of masked values. Additionally, parameter naming has been refined for better clarity in threshold measurement workflows.

What's New

Bug Fix: Correct Threshold Masking in Threshold Scanning

What it does: When scanning thresholds on specific channels, the scan_serial() function now correctly masks unscanned channels to their configured mask value (default: 1000) rather than using arbitrary center values. This ensures predictable and consistent threshold behavior during measurements.

How to use it: No changes needed. The fix applies automatically when running threshold scan examples:

# Threshold scanning now correctly masks unused channels
python examples/get_thresholds.py --help

Code example:

The fix ensures channels not being scanned stay at masked values:

# Before: CH2={center[2]}, CH3={center[3]}  # Unpredictable
# After: CH2={masked[2]}, CH3={masked[3]}   # Consistent (default: 1000)

Parameter Refinement: Clearer Parameter Naming

The event_or_duration parameter has been renamed to events_or_secs throughout the threshold scanning examples for improved clarity:

  • Parameter name now clearly indicates it can be either event count or duration in seconds
  • Affects: scan_serial(), scan_parallel(), and _run_sessions() functions
  • Makes code more self-documenting when reading threshold measurement code

Installation

Quick Start

# Get the release
git checkout v0.2.1

# Setup
uv sync

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

🐛 Fixed

  • Use masked thresholds instead of center values in scan_serial to ensure consistent threshold behavior

🔧 Changed

  • Rename event_or_duration parameter to events_or_secs for clarity in threshold scanning examples

Is It Safe to Upgrade?

Backward Compatible: Yes

  • Bug fix applies transparently to existing threshold scanning workflows
  • Parameter renaming only affects internal example scripts, not the library API
  • All CLI commands remain unchanged

Tests Passed

  • ✅ Builds without errors
  • ✅ Pre-commit hooks validation passed
  • ✅ All example scripts run correctly with new parameter names

Release Details

  • Date: 2025-12-21
  • Version: v0.2.1
  • Files Changed: 1
  • Commits: 3af04f0, e405014, ae39421

Next Steps

Recommended for all users. No migration needed from v0.2.0.