Skip to content

WaveBench v0.3.0

Choose a tag to compare

View all tags
@Scaxlibur Scaxlibur released this 05 May 12:47
· 502 commits to master since this release
v0.3.0
ee34f5a

WaveBench v0.3.0 - visual evidence reports / 可视化证据报告

中文

WaveBench v0.3.0 把报告从“可读日志”推进到“小型可视化证据包”。它继续保持离线优先边界：报告和 inspect 命令只读取已有 artifact，不连接仪器。

主要变化

  • run report 顶部新增 Summary card，显示状态、实验标签、步骤数、失败步骤、采集包、warning、expect 失败、截图、恢复状态和主要信号指标。
  • 新增 Expected vs measured 表格，直接展示 [steps.expect] 的目标值与实测值。
  • 从保存的 ch*.npy 生成内联 SVG 波形预览。
  • 新增 report-assets/manifest.json，记录报告引用的 artifact 和缺失 artifact warning。
  • 新增可选离线 FFT 文本摘要：
python -m wavebench capture inspect data/raw/<capture_dir> --fft

报告改进

python -m wavebench run report data/runs/<run_dir> 现在会写出：

report.html
report-assets/manifest.json

HTML 报告包含：

  • Summary card
  • 带截图缩略图的 Steps 表格
  • Expected vs measured 检查表
  • Signal analysis 表格
  • 波形预览
  • 截图库

FFT inspect

capture inspect --fft 会对保存的 NPY 波形输出轻量频域摘要：

  • Hann 窗
  • 采样率
  • 频率分辨率
  • 主峰频率和幅度
  • 噪声底估计
  • 2 到 5 次谐波 bin
  • 粗略 THD 估计
  • 非均匀采样或异常时间轴 warning

它故意只是文本 inspect 工具，不是默认 report 区块。

保持的边界

v0.3.0 不做：

  • GUI / SPA
  • 交互式图表
  • 新工作流语言
  • 条件分支或矩阵 run plan
  • 默认频谱报告
  • zip export
  • 新仪器型号

验证

124 passed

备注

报告可以生成派生预览和 manifest 文件，但不会修改原始采集数据、metadata 或 run records。

English

WaveBench v0.3.0 turns reports from plain readable logs into small visual evidence packets. It keeps the offline-first boundary: reports and inspect commands read existing artifacts only and do not connect to instruments.

Highlights

  • Added a run-report Summary card for status, experiment label, steps, failed steps, captures, warnings, failed expectations, screenshots, restore status, and primary signal metrics.
  • Added an Expected vs measured table for [steps.expect] checks.
  • Added inline SVG waveform previews generated from saved ch*.npy data.
  • Added report-assets/manifest.json for report artifact references and missing-artifact warnings.
  • Added optional offline FFT text summaries:
python -m wavebench capture inspect data/raw/<capture_dir> --fft

Report improvements

python -m wavebench run report data/runs/<run_dir> now writes:

report.html
report-assets/manifest.json

The HTML report includes:

  • Summary card
  • Steps table with screenshot thumbnails
  • Expected vs measured checks
  • Signal analysis table
  • Waveform previews
  • Screenshot gallery

FFT inspect

capture inspect --fft prints a lightweight frequency-domain summary for saved NPY waveforms:

  • Hann window
  • sample rate
  • frequency resolution
  • peak frequency and amplitude
  • noise floor estimate
  • 2nd to 5th harmonic bins
  • rough THD estimate
  • warnings for non-uniform or problematic time axes

This is intentionally a text inspect tool, not a default report section.

Boundaries kept

v0.3.0 does not add:

  • GUI / SPA
  • interactive charts
  • new workflow language
  • conditional or matrix run plans
  • default spectrum reports
  • zip export
  • new instrument models

Validation

124 passed

Notes

The report can generate derived preview and manifest files, but it does not modify original capture data, metadata, or run records.

Assets 2
Loading