物理实验软件传感器库
Markdown sources: English | 简体中文 | 日本語
它是什么?
面向物理实验的可复用软件传感器基础层。 它把摄像头帧、屏幕像素和图像算法观测统一为可追溯的 FramePacket 与 SensorEvent,供后续物理实验项目复用。
仓库也承载处理 Sensor 输出的可复用配套处理工具;这些工具不会假装产生新的直接观测。
这是长期维护的基础能力库,不是新的实验应用。来源项目保持原状,继续作为历史实现和实际使用情境的事实来源。
物理实验项目
↓
可复用成熟能力
↓
物理实验软件传感器库
↓
未来物理实验项目
成熟能力通过 adapter 渐进抽取,对固定来源 commit 做测试、文档和 benchmark,再服务未来项目。像素位置、OCR 文本、置信度和边界框是软件直接观测,不会自动成为经标定的物理量。
物理 / 软件来源
↓
采集 Sensor → FramePacket
↓
处理 Sensor → SensorEvent / 标量测量值
↓
配套处理工具
↓
物理实验应用
例如:screen.capture → ocr.number → vector.compose-3d → 三维合矢量。最后一步只重建已有标量测量值,不感知新的物理量。
语言访问
仓库三语内容完整性:PASS。英文、简体中文、日文 Markdown 都是完整的来源文档。如果某些地区的 GitHub 文件查看页暂时失败,仍可从仓库首页获得以下简要说明:
- English quick summary: A reusable software sensing layer for physics experiments with 9 Software Sensors, 4 Companion Processing Tools and 13 public capabilities. It separates direct image/screen/OCR/tracking observations from downstream physical quantities. The public
v0.6.0contains seven Sensor Bundles;vector.compose-3dremains an unreleased experimental Tool. The trilingual documentation website is now served by GitHub Pages frommain /docs. - 日本語クイックガイド:物理実験向けの再利用可能なソフトウェアセンサー基盤であり、9 個の Software Sensor、4 個の Companion Processing Tool、合計 13 項目の公開 capability を提供します。画像・画面・OCR・追跡の直接観測と下流の物理量は区別されます。公開
v0.6.0には 7 個の Sensor Bundle が含まれ、vector.compose-3dは未リリースの experimental Tool です。3 言語の static reader は GitHub Pages のmain /docsから公開されています。
项目状态
9 个软件传感器 · 4 个配套处理工具 · 共 13 项可复用公开能力 · 英文 / 简体中文 / 日文
9 个 adapter 和 4 个工具目前均为 experimental。公开 v0.6.0 Release 包含 7 个 Sensor Bundle;工具尚未发布。首次 E5 下游复用已经完成,但不能把任何 Sensor 描述为已经全面 validated。
传感器目录
| Sensor | 用途 | 语言 | 成熟度 | 证据 | 示例 | 下载 |
|---|---|---|---|---|---|---|
camera.capture |
带时间/后端信息的摄像头帧 | Python | experimental | E1 | 示例 | bundle |
screen.capture |
用户授权的屏幕/窗口像素 | TypeScript | experimental | E1 | 示例 | bundle |
ocr.number |
从图像 ROI 读取数字 | TypeScript | experimental | E3 | 示例 | bundle |
tracker.color-marker |
HSV/轮廓颜色标记追踪 | Python | experimental | E2 | 示例 | bundle |
tracker.spot-centroid |
光斑亮度加权重心 | Python | experimental | E5 | 示例 | bundle |
tracker.template |
ROI 初始化的单目标追踪 | Python | experimental | E3 | 示例 | bundle |
tracker.yolo |
多目标检测/追踪 adapter | Python | experimental | E2 | 示例 | bundle |
image.strip-profile |
旋转 ROI 灰度/通道剖面及饱和质量记录 | TypeScript | experimental | E2 | demo | unreleased 0.1.0 |
vision.ruler-ticks |
实体尺刻线识别与待确认尺度候选 | TypeScript | experimental | E2 | demo | unreleased 0.1.0 |
完整信息见传感器目录。证据等级表示实际跑过的路径;成熟度是另一项发布决策。
配套处理工具
| Tool | 用途 | 语言 | 状态 | 示例 | 文档 |
|---|---|---|---|---|---|
vector.compose-3d |
从标量分量进行三维矢量合成与重建 | TypeScript | experimental | Web demo | Tool Page |
calibration.scale-1d |
人工确认的两点及分段多点一维标定 | TypeScript | experimental | Web demo | Tool Page |
signal.profile-features |
平滑、背景扣除、峰谷、峰宽与周期分析 | TypeScript | experimental | Web demo | Tool Page |
optics.fringe-wavelength |
干涉/衍射波长反演、回归与不确定度 | TypeScript | experimental | Web demo | Tool Page |
完整信息见配套工具目录。配套工具构成可扩展的测量处理层,不计入 Sensor 数量。
快速开始
先阅读快速开始,再从 v0.6.0 Experimental Release 选择 Python wheel 或 TypeScript tgz。本项目没有发布到 PyPI 或 npm registry。
python -m pip install './physics_software_sensors-0.5.0-py3-none-any.whl[classical-trackers]'
npm install ./physics-software-sensors-core-0.3.0.tgz
FringeLab 新增两个 Sensor、三个处理工具以及计算器/ROI/虚拟尺 UI。两批组件均已收录为独立 0.1.0 工具包;已有 v0.6.0 下载仍保留原来的七个 bundle。 FringeLab toolkit · runnable demo
下载
Release 包含一个 Python wheel、一个 TypeScript tgz、七个 Sensor Bundle、release-manifest.json 和 SHA256SUMS。Sensor Bundle 是便于阅读的文档/示例包,不复制公共 core。参阅下载传感器和安装。
能力总览
新增:FringeLab 组件套件 — 计算器、ROI、人工/自动尺、标定、剖面、OCR、相机和光学反演。组件使用指南。
图中汇总了 standalone、synthetic 和 replay 演示,各能力的证据等级并不相同;YOLO tile 明确是 recorded detector replay,不是真实 YOLO inference。图片只是增强展示;即使图片服务不可用,下面的文字链接仍是可靠入口。
摄像头采集 · 屏幕采集 · 数字 OCR · 颜色标记追踪 · 光斑重心 · 模板 / 单目标追踪 · YOLO 追踪 · 三维矢量合成
历史八项展示图覆盖:7/7 个软件传感器 + 1/1 个配套处理工具 = 8/8 项可复用公开能力。进入三语能力展示详情页可查看八张独立 demo 图及其证据边界。
FringeLab 光强分布与光学测量组件套件
从光强分布实验中拆解的可复用组件,收录在 @physics-software-sensors/fringelab 0.1.0;可以组合使用,也可以单独引入以后其他项目。两批均已收录。
第一批:计算器、ROI、虚拟尺、人工标定、剖面分析。
第二批:自动尺、尺标 OCR、浏览器相机、光学反演。
| 组件 | 可以复用的功能 | 使用入口 |
|---|---|---|
| 浮窗计算器 | 拖动浮窗、多实例、四则/括号/乘方和科学计数 | UI |
| ROI 与虚拟尺 | 原图坐标下移动、旋转、缩放选区;尺端点、刻度和吸附 | UI |
| 人工标定 | 已知长度两点标定、可编辑多点读数和分段映射 | calibration.scale-1d |
| 剖面与信号分析 | 相对光强剖面、通道质量、平滑、峰谷和峰宽 | image.strip-profile |
| 自动尺 | 实体刻线候选;保留人工/框选、对比色和吸附选项 | vision.ruler-ticks |
| 尺标 OCR 与相机 | 厘米数字候选;浏览器采集/冻结画面、检查相机设置 | browser |
| 光学反演 | 干涉/衍射波长、回归、不确定度和模拟 | optics.fringe-wavelength |
中文使用指南 · API 与安装 · 可运行示例 · 剖面特征工具 · FringeLab guide
自动识别与 OCR 结果经人工核对后应用,人工和多点模式完整保留。截图来自可运行的 650 nm 合成示例;DN 表示相对响应,尚未认证实机测量精度。
当前目录覆盖:9/9 个 Sensor + 4/4 个处理工具 = 13/13 项能力。计算器和叠加 UI 是额外可复用组件,不计入 Sensor 数量。
核心原则
- 不破坏或静默改写来源项目。
- 来源追溯固定到仓库、完整 commit SHA、路径和符号。
- 保存原始观测,明确区分后续派生值。
- 显式记录时间、坐标、单位、置信度和不确定度。
- 保守说明证据、成熟度、许可证和模型边界。
长期工作流
新的物理实验项目
↓
可复用的成熟能力
↓
Sensor Intake
↓
Physics Software Sensors
↓
Experimental / Validation / Release
↓
未来物理实验项目
今后的工作通过 Sensor Intake、新增 Sensor 操作说明或已有 Sensor 维护轨道进入,不再默认创建新 Phase。首次从抽取到复用的完整周期见首次完整复用闭环。
文档
- 三语文档网站
- 传感器目录
- 配套工具目录
- 能力展示详情
- 快速开始
- 证据与成熟度
- Sensor 接入流程
- 首次完整复用闭环和维护指南
- 当前项目状态
- 术语和 i18n 风格指南
- Demo 素材清单
- 架构、数据格式、benchmark
- v0.6.0 Release
开发与校验
python3 tools/validate_repo.py
pytest
npm --prefix packages/typescript test
参阅 CONTRIBUTING.md。新 Sensor 或重大能力必须走正式 intake;普通 bugfix 不需要。
当前非目标
- 不声称 stable、production-ready、measurement-grade 或 metrology-ready。
- 不自动下载 YOLO 模型,也不捆绑模型权重。
- 不强制来源实验项目迁移。
- 不发布 PyPI/npm;首次已合并的 E5 接入是离线回放路径,不替换下游实时摄像头实现。
许可
本仓库自有代码和文档采用 MIT。来源代码、模型、数据和依赖继续遵守各自许可证边界;参阅 THIRD_PARTY_NOTICES.md。
最新 handoff:.agent-handoff/latest.md · .agent-handoff/latest.json

