Skip to content

v0.22.0 - BME280 Validity Flag in Conversion Scripts (2026-06-09)

What Changed?

This release adds a bme280_valid column to the output of from_jsonl_to_parquet.py and from_jsonl_to_root.py. The column is a boolean flag that marks rows where all BME280 sensor values are within the hardware specification limits, making it easy to filter valid environmental data in downstream analysis.

What's New

Main Feature: bme280_valid column

What it does: Automatically adds a bme280_valid boolean column during conversion. A row is marked True only when all three BME280 channels are within their hardware specification:

Channel Min Max
tmp_c -40 °C 85 °C
hmd_pct 0 % 100 %
atm_pa 300 Pa 110000 Pa

How to use it:

# Convert JSONL to Parquet (bme280_valid added automatically)
uv run from_jsonl_to_parquet.py 20251221_run126/

# Convert JSONL to ROOT (bme280_valid added automatically)
uv run from_jsonl_to_root.py 20251221_run126/

Filter in pandas:

df = pd.read_parquet("run.parquet")
df_valid = df[df["bme280_valid"]]

Installation

Quick Start

# Get the release
git checkout v0.22.0

# Setup
task env:setup

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

✅ Added

  • bme280_valid column in from_jsonl_to_parquet.py output (Parquet)
  • bme280_valid branch in from_jsonl_to_root.py output (ROOT TTree)

Is It Safe to Upgrade?

Backward Compatible: Yes

  • Existing columns and branches are unchanged
  • One new column/branch added to output files

Tests Passed

  • ✅ Builds without errors
  • ✅ Pre-commit hooks passed

Release Details

  • Date: 2026-06-09
  • Version: v0.22.0
  • Files Changed: 2 example scripts
  • Commits: c9740fa, 06afc8a, 3195115

Next Steps

No specific roadmap items at this time.