ykcheungab 7f8e5d0975 四个滤波预设落成机器可读的配置文件，并加上防漂移测试 - What: 新增 examples/filters/filters_{off,low_latency,balanced,low_noise}.json —— 每个都是完整可整块替换的 filters 段（五键齐全：flow_ema_alpha / force_median_window / force_lowpass_cutoff_hz / force_lowpass_order / force_lowpass_sample_rate_hz），数值即 FILTER_PRESETS 展开后的结果；examples/filters/README.md 说明这四份副本的存在与用途；新增 tests/test_filter_presets.py（12 项）：预设名恰为四个、每个示例文件 == 默认块叠加该预设（改预设或改文件都会红）、每份都是含三个开关键的真实 filters 段、三个出厂 bundle（box/mini/finger）的 filters 段仍为全关、且用 external-frame 模式构造真实 Sensor 核对 filters_state() 报的也是全关（文件与设备必须一致）。 - Why: 之前的实现计划里写的是"四个 sensor_<preset>.json 整机配置"，但整机配置要按传感器各复制一份、且必然随 bundle 漂移；README 里内嵌的 JSON 又无法被测试覆盖，等于把"建议用哪档滤波"这句话留在了一处会过时的散文里。改成"filters 片段 + 断言与 FILTER_PRESETS 逐值一致的测试"，既不谎称是完整配置，也不会静默过时。 - Verification: pytest tests/test_filter_presets.py → 12 passed；SDK 全量 335 passed / 15 skipped（唯一失败仍是需要 1200 帧而样例只有 577 帧的 longrun 测试）。 - Not in this change: 未生成按传感器复制的整机配置；docs/filters.md 的预设表未纳入测试（只有这四个文件与代码常量对齐）；app 侧未动。

2026-09-14 10:44:07 +08:00

..

conftest.py

faster linux build

2026-09-12 16:36:59 +08:00

dd06.py

exclude docs from wheel; harden bundle item handling; single-source version

2026-09-12 16:19:34 +08:00

DIS_no_integrate.py

test if optical flow integration error: not significant for Mems

2026-09-01 21:27:10 +08:00

note.txt

update test and build scripts

2026-03-09 13:33:18 +08:00

test_backends.py

update test and build scripts

2026-03-09 13:33:18 +08:00

test_calibration.py

标定指纹改读生效值并按测量/读数分组 - What: calibration.py 新增 FILTER_MEASUREMENT_KEYS（flow_ema_alpha）与 FILTER_READOUT_KEYS（中值窗口、低通截止/阶数/采样率/rate_auto）、filters_fingerprint()（把 Sensor.filters_state() 归一化成 {measurement, readout, preset, source}：非法值丢弃、来源没写的键不出现而不是补默认、空映射返回 {} 表示"无记录"）、filter_mismatches()（按组判读差异）与 _filters_from_config / _flat_filters_from（扁平旧格式与 preset 展开的兼容解析，显式键优先）；pipeline_from_sensor_json() 新增 filters_state= 关键字——传了生效值就用生效值，否则读文件的 filters 段并标注 source="sensor.json.filters"，返回结构化 filters 键，删除原先会凭空补出 0.5/3/10 的扁平键与 enabled 覆盖逻辑；Calibration.to_dict() 写 meta.filters（同时保留扁平键供旧读者按名取用）；parse() 把 filters 读回 pipeline（此前 to_dict 写进 meta 的滤波键在读回时被整段丢弃，指纹实际是"只写不读"）；check() 改用 filter_mismatches 分开报告——measurement 组差异进 warnings 且措辞含 not comparable，readout 组差异进新增字段 CheckResult.notes（只记录、不拦截）；build(extra_meta=…) 把 filters 与扁平滤波键折进结构化组。tests/test_calibration.py 新增 11 项测试（分组、preset 展开与显式键优先、enabled:false 全关、非法值为空而非默认、写入-读回往返、旧扁平文档读回、生效值压过文件、四个预设逐档核对）。docs/filters.md 新增第 7 节。 - Why: 用户决策 B 要求"Sensor.filters_state() 作为唯一生效值出口，calibration.py 指纹与 session.json 都读它、不读配置文件，指纹分 measurement/readout 两组"；动手时确认旧实现三个问题叠加：来源错（读文件、被 filters.enabled 覆盖、文件没写就补默认 0.5/3/10），写进 meta 的指纹在读回时被丢弃，check() 因此永远比不出滤波差异——审计链是断的，不是不精确。 - Verification: SDK 全量 pytest 335 passed / 15 skipped，唯一失败 test_vnormal_longrun_no_outlier_jumps 需要 1200 帧而 data/sample/s1_480p.mp4 只有 577 帧（环境/数据，与本改动无关）；external-frame 模式逐预设构造真实 Sensor，filters_fingerprint(filters_state()) 得 off(1.0,1,0.0) / low_latency(1.0,3,0.0) / balanced(0.5,3,0.0) / low_noise(0.3,3,10.0)；写入→读回往返后 measurement/readout/preset 完整保留且 to_dict 幂等；旧扁平 meta 文档仍读回同一指纹；.repro/verify_cal_filters.py 50 项全绿。 - Not in this change: 未动 app（app 的 meta_from_sensor_json 只取 4 个键，不受影响）；未升级 venv 内 SDK；examples/filters 的四个机器可读预设片段与 app 侧 wrapper/齿轮/CSV 17 列未动。

2026-09-14 10:43:58 +08:00

test_capture.py

hotfix/camera not connected error

2026-09-02 21:37:40 +08:00

test_contact_arrow_scale.py

1. tuned arrow mesh drawing

2026-06-19 14:28:28 +08:00

test_draw_arrows.py

added 5 sensors multi-stream support, 5 finger reach > 100 fps stable using .mp4 video

2026-09-13 12:18:27 +08:00

test_errors_and_cleanup.py

update test and build scripts

2026-03-09 13:33:18 +08:00

test_export_sensor_bundle.py

added calibration data handling functions

2026-09-10 21:47:36 +08:00

test_export.py

added 5 sensors multi-stream support, 5 finger reach > 100 fps stable using .mp4 video

2026-09-13 12:18:27 +08:00

test_ffc.py

Update FFC files

2026-07-02 16:53:08 +08:00

test_filter_presets.py

四个滤波预设落成机器可读的配置文件，并加上防漂移测试 - What: 新增 examples/filters/filters_{off,low_latency,balanced,low_noise}.json —— 每个都是完整可整块替换的 filters 段（五键齐全：flow_ema_alpha / force_median_window / force_lowpass_cutoff_hz / force_lowpass_order / force_lowpass_sample_rate_hz），数值即 FILTER_PRESETS 展开后的结果；examples/filters/README.md 说明这四份副本的存在与用途；新增 tests/test_filter_presets.py（12 项）：预设名恰为四个、每个示例文件 == 默认块叠加该预设（改预设或改文件都会红）、每份都是含三个开关键的真实 filters 段、三个出厂 bundle（box/mini/finger）的 filters 段仍为全关、且用 external-frame 模式构造真实 Sensor 核对 filters_state() 报的也是全关（文件与设备必须一致）。 - Why: 之前的实现计划里写的是"四个 sensor_<preset>.json 整机配置"，但整机配置要按传感器各复制一份、且必然随 bundle 漂移；README 里内嵌的 JSON 又无法被测试覆盖，等于把"建议用哪档滤波"这句话留在了一处会过时的散文里。改成"filters 片段 + 断言与 FILTER_PRESETS 逐值一致的测试"，既不谎称是完整配置，也不会静默过时。 - Verification: pytest tests/test_filter_presets.py → 12 passed；SDK 全量 335 passed / 15 skipped（唯一失败仍是需要 1200 帧而样例只有 577 帧的 longrun 测试）。 - Not in this change: 未生成按传感器复制的整机配置；docs/filters.md 的预设表未纳入测试（只有这四个文件与代码常量对齐）；app 侧未动。

2026-09-14 10:44:07 +08:00

test_finger_runtime.py

split example visualizaiton pipeline

2026-06-18 13:47:16 +08:00

test_harness_guards.py

faster linux build

2026-09-12 16:36:59 +08:00

test_longrun_stability.py

update test and build scripts

2026-03-09 13:33:18 +08:00

test_masked_hhd.py

added preflight check

2026-09-12 15:49:28 +08:00

test_masked_poisson_capfft.py

split example visualizaiton pipeline

2026-06-18 13:47:16 +08:00

test_nuitka_nofollow.py

faster linux build

2026-09-12 16:36:59 +08:00

test_pipeline.py

added 5 sensors multi-stream support, 5 finger reach > 100 fps stable using .mp4 video

2026-09-13 12:18:27 +08:00

test_pyproject.py

exclude docs from wheel; harden bundle item handling; single-source version

2026-09-12 16:19:34 +08:00

test_qt_viewer_backend.py

included low pass filter in package and add to plot_data example

2026-08-17 22:11:17 +08:00

test_release_auth.py

fixed testpypi upload

2026-09-12 17:34:46 +08:00

test_release_publish.py

fix pypi cannot check after upload

2026-09-12 17:43:40 +08:00

test_release_version.py

exclude docs from wheel; harden bundle item handling; single-source version

2026-09-12 16:19:34 +08:00

test_signal_processing.py

added calibration data handling functions

2026-09-10 21:47:36 +08:00

test_smoke_api.py

update test and build scripts

2026-03-09 13:33:18 +08:00

test_stitch.py

refractor stitcher class into module

2026-08-23 16:24:53 +08:00

test_uv_geometry.py

split example visualizaiton pipeline

2026-06-18 13:47:16 +08:00

test_uv_mesh_viewer.py

split example visualizaiton pipeline

2026-06-18 13:47:16 +08:00

test_uv_remap.py

integrated finger process pipeline on remapped 2d image

2026-06-14 17:48:30 +08:00

test_uv_unroll_processor.py

dd02 setting tune + change Class name from UVUnrollFrameProcessor to FrameUnwarper

2026-07-14 20:00:40 +08:00

test_wheel_build.py

exclude docs from wheel; harden bundle item handling; single-source version

2026-09-12 16:19:34 +08:00

test_wheel_contents.py

exclude docs from wheel; harden bundle item handling; single-source version

2026-09-12 16:19:34 +08:00

test_wheel_setup_metadata.py

exclude docs from wheel; harden bundle item handling; single-source version

2026-09-12 16:19:34 +08:00