 ykcheungab
|
35190562e5
|
标定指纹改读生效值并按测量/读数分组 - 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 |
|
|
ykcheungab
|
b956d071ea
|
滤波说明落到文档与 examples：三级位置/性质、四个预设、可追溯性清单 - What: 新增 docs/filters.md（json.load 不支持注释，故建议以"代码预设 + 文档 + 可复制配置"承载：三级滤波的作用位置与性质对照——flow_ema_alpha 在 compute_flow/HHD 之前、改变测量故两次录制不可比，中值与低通是读数滤波；取值规则：每级按值开关、非法值一律关、filters.enabled 仅作废弃别名、显式键优先于预设；FILTER_PRESETS 四个档位的延迟与用途表；configure()/filters_state() 用法；force_triplets() 两个 buffer 的语义与尖峰实测 10/999；可追溯性五条清单）与 examples/filters/README.md（off/low_latency/balanced/low_noise 四段可直接整块替换的 filters 配置、preset 等价写法、"从预设出发只改一个键"的写法、复制后用 filters_state() 核对生效值的片段）。 - Why: 用户提出"在 json 里加 comment 说明建议的滤波，或在 examples 里写"，查证 configs.py 使用 json.load 且环境无 json5/commentjson，加注释会导致加载失败；因此把建议做成可执行预设并在文档与 examples 中给出可复制版本。 - Verification: 文档中的四个预设与 FILTER_PRESETS 逐值一致；示例片段与 sensors/*/sensor.json 的 filters 段结构一致；filters_state()/force_triplets() 的行为已用 external-frame 模式实测（预设解析结果与尖峰 10/999 对照）。 - Not in this change: 未生成四个独立的 sensor_<preset>.json 整机配置文件（README 里给的是整块 filters 段）；calibration.py 指纹尚未改读 filters_state()；venv 内 SDK 未升级；app 侧 wrapper/齿轮与 CSV 17 列未动。
|
2026-09-14 10:36:00 +08:00 |
|
|
ykcheungab
|
5f78115429
|
fix pypi cannot check after upload
|
2026-09-12 17:43:40 +08:00 |
|
|
ykcheungab
|
488c8b0bc1
|
fixed testpypi upload
|
2026-09-12 17:34:46 +08:00 |
|
|
ykcheungab
|
174bceabc4
|
automate publishing: release github + release pypi
|
2026-09-12 16:50:55 +08:00 |
|
|
ykcheungab
|
388f34ca85
|
faster linux build
|
2026-09-12 16:36:59 +08:00 |
|
|
ykcheungab
|
35af74f639
|
exclude docs from wheel; harden bundle item handling; single-source version
|
2026-09-12 16:19:34 +08:00 |
|
|
ykcheungab
|
57bef85e32
|
fix preflight
|
2026-09-12 16:00:40 +08:00 |
|
|
ykcheungab
|
9537cf91a1
|
added preflight check
|
2026-09-12 15:49:28 +08:00 |
|
|
ykcheungab
|
96f4428230
|
added calibration data handling functions
|
2026-09-10 21:47:36 +08:00 |
|
|
ykcheungab
|
ad680b77dc
|
0.5.1
|
2026-09-02 21:47:51 +08:00 |
|
|
ykcheungab
|
8a4be5f8f2
|
update to 0.5.0
|
2026-08-26 20:20:37 +08:00 |
|
|
ykcheungab
|
d59e1cb7fb
|
fix path errors
|
2026-08-26 19:22:37 +08:00 |
|
|
ykcheungab
|
44bcc19426
|
update docs and downstream sync
|
2026-08-18 11:00:57 +08:00 |
|
|
ykcheungab
|
2e09c9360e
|
included low pass filter in package and add to plot_data example
|
2026-08-17 22:11:17 +08:00 |
|
|
ykcheungab
|
9a69f01278
|
reorganized build directory
|
2026-08-03 22:14:19 +08:00 |
|
|
ykcheungab
|
d7c5845646
|
finished docker manylinux compliation for pypi
|
2026-08-03 17:07:54 +08:00 |
|
|
ykcheungab
|
3117ddd5b9
|
organize exampels according to products
|
2026-08-03 15:52:15 +08:00 |
|
|
ykcheungab
|
11a747a771
|
added camera search and select, auto preference saving and version tag to 0.4.2
|
2026-07-15 15:08:59 +08:00 |
|
|
ykcheungab
|
30f9deb5b2
|
dd02 setting tune + change Class name from UVUnrollFrameProcessor to FrameUnwarper
|
2026-07-14 20:00:40 +08:00 |
|
|
ykcheungab
|
c2fb0b12b5
|
AI 更新文档
|
2026-07-09 14:03:45 +08:00 |
|
|
ykcheungab
|
c77a64ffe7
|
update version tag to 0.4.1
|
2026-07-09 13:59:19 +08:00 |
|
|
ykcheungab
|
9317bb3942
|
update examples read.me
|
2026-06-30 09:55:41 +08:00 |
|
|
ykcheungab
|
30bebcd439
|
integrated finger process pipeline on remapped 2d image
|
2026-06-14 17:48:30 +08:00 |
|
|
ykcheungab
|
7224fea411
|
Merge branch 'stable'
|
2026-05-14 21:02:23 +08:00 |
|
|
ykcheungab
|
d38ce82059
|
clean up folder
|
2026-05-10 17:41:39 +08:00 |
|
|
bluepulsar
|
b0a750f11c
|
clean up source folder
|
2026-04-28 21:02:37 +08:00 |
|