Physics Software Sensors — 物理実験ソフトウェアセンサーライブラリ
Markdown sources: English | 简体中文 | 日本語
これは何か?
物理実験のための再利用可能なソフトウェアセンサー基盤です。 カメラフレーム、画面ピクセル、画像処理による観測を、来歴を追跡できる FramePacket と SensorEvent に統一し、将来の物理実験プロジェクトから再利用できるようにします。
Sensor の出力を処理する再利用可能な補助処理ツールも収録します。これらのツールを、新しい直接観測を行う Sensor とは扱いません。
新しい実験アプリケーションではなく、長期的に保守する基盤ライブラリです。ソースプロジェクトは変更せず、過去の実装と利用状況の事実源として維持します。
物理実験プロジェクト
↓
再利用可能な成熟機能
↓
Physics Software Sensors
↓
将来の物理実験プロジェクト
成熟した機能を adapter として段階的に抽出し、固定 commit に対するテスト、文書化、ベンチマークを経て再利用します。ピクセル位置、OCR 文字列、信頼度、バウンディングボックスは直接観測であり、自動的に校正済み物理量になるわけではありません。
物理的/ソフトウェア source
↓
Capture Sensor → FramePacket
↓
Processor Sensor → SensorEvent / スカラー測定値
↓
補助処理ツール
↓
物理実験アプリケーション
例:screen.capture → ocr.number → vector.compose-3d → 3次元合成ベクトル。最後の段階は既存のスカラー測定値を再構成するもので、新しい量を観測しません。
言語アクセス
repository の 3 言語コンテンツ完全性:PASS。English、简体中文、日本語の Markdown はいずれも完全な source document として維持されています。地域によって GitHub の file view が一時的に失敗しても、repository のトップから次の概要を確認できます。
- English quick summary: A reusable software sensing layer for physics experiments with 9 Software Sensors, 4 Companion Processing Tools and 13 public capabilities. It keeps direct image/screen/OCR/tracking observations separate from downstream physical quantities. Public
v0.6.0contains seven Sensor Bundles, whilevector.compose-3dis an unreleased experimental Tool. The trilingual documentation website is now served by GitHub Pages frommain /docs. - 简体中文快速说明:这是面向物理实验的可复用软件传感器基础层,包含 9 个软件传感器、4 个配套处理工具和 13 项公开能力。它明确区分图像、屏幕、OCR、追踪的直接观测与后续物理量。公开
v0.6.0包含 7 个 Sensor Bundle,vector.compose-3d仍是未发布的 experimental 工具。三语静态阅读页现在由 GitHub Pages 从main /docs提供。
Project status
9 Software Sensor · 4 Companion Processing Tools · 再利用可能な公開 capability 全 13 項 · English / 简体中文 / 日本語
9 個の adapter と4個のツールはすべて experimental です。公開 v0.6.0 Release には 7 個の Sensor Bundle が含まれ、本ツールは未リリースです。最初の E5 downstream reuse は完了していますが、すべての Sensor が validated であるとは主張しません。
センサーカタログ
| Sensor | 用途 | 言語 | 成熟度 | エビデンス | Example | Download |
|---|---|---|---|---|---|---|
camera.capture |
時刻・バックエンド情報付きカメラフレーム | Python | experimental | E1 | example | bundle |
screen.capture |
ユーザー許可済みの画面ピクセル | TypeScript | experimental | E1 | example | bundle |
ocr.number |
ROI から数値を OCR | TypeScript | experimental | E3 | example | bundle |
tracker.color-marker |
HSV・輪郭によるカラーマーカー追跡 | Python | experimental | E2 | example | bundle |
tracker.spot-centroid |
光スポットの輝度加重重心 | Python | experimental | E5 | example | bundle |
tracker.template |
ROI 初期化型の単一物体追跡 | Python | experimental | E3 | example | bundle |
tracker.yolo |
複数対象の検出・追跡 adapter | Python | experimental | E2 | example | bundle |
image.strip-profile |
回転 ROI の断面プロファイルと飽和メタデータ | TypeScript | experimental | E2 | demo | unreleased 0.1.0 |
vision.ruler-ticks |
実物定規の目盛り検出と未確認スケール候補 | TypeScript | experimental | E2 | demo | unreleased 0.1.0 |
詳細はセンサーカタログを参照してください。エビデンスレベルと成熟度は別の概念です。
Companion Processing Tools
| Tool | 用途 | 言語 | 状態 | Example | 文書 |
|---|---|---|---|---|---|
vector.compose-3d |
スカラー成分から3次元ベクトルを合成・再構成 | TypeScript | experimental | Web demo | Tool Page |
calibration.scale-1d |
人が確認する2点・区分多点1次元校正 | TypeScript | experimental | Web demo | Tool Page |
signal.profile-features |
平滑化、背景減算、ピーク幅・周期解析 | TypeScript | experimental | Web demo | Tool Page |
optics.fringe-wavelength |
干渉・回折の波長逆算、回帰と不確かさ | TypeScript | experimental | Web demo | Tool Page |
詳細は Companion Tool Catalogを参照してください。Companion Tool は拡張可能な測定処理 layer であり、Sensor 数には含めません。
クイックスタート
Getting Started を読み、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 から2つの Sensor、3つの処理 Tool、電卓・ROI・仮想定規 UI を追加しました。両バッチを独立した0.1.0パッケージに収録し、不変の v0.6.0 ダウンロードは従来の7 bundle を維持します。 FringeLab toolkit · runnable demo
ダウンロード
Release には Python wheel、TypeScript tgz、7 個の Sensor Bundle、release-manifest.json、SHA256SUMS が含まれます。Sensor Bundle は文書・example 用であり、共通 core を複製しません。Downloading Sensors と Installation を参照してください。
Capability Showcase
新規:FringeLab toolkit — 電卓、ROI、手動・自動定規、校正、断面、OCR、カメラ、光学逆算。ガイド。
standalone、synthetic、replay の代表的なデモを 1 枚にまとめています。エビデンスレベルは capability ごとに異なり、YOLO tile は recorded detector replay であって実 YOLO inference ではありません。画像は補助表示であり、配信できない場合も下記のテキストリンクから全項目へ移動できます。
Camera Capture · Screen Capture · Number OCR · Color Marker · 光スポット重心 · Template / Single-object Tracker · YOLO Tracker · 3次元ベクトル合成
従来の画像の範囲:7/7 Software Sensor + 1/1 Companion Processing Tool = 再利用可能な公開 capability 8/8 項。8 枚の詳細 demo とエビデンス境界は、3 言語の Capability Showcase に掲載しています。
FringeLab 光強度分布・光学測定ツールキット
光強度分布実験から抽出した再利用コンポーネントを @physics-software-sensors/fringelab 0.1.0 に収録しました。両バッチを組み合わせても、将来のプロジェクトに個別導入しても利用できます。
第1バッチ:電卓、ROI、仮想定規、手動校正、断面解析。
第2バッチ:自動定規、目盛り OCR、ブラウザカメラ、光学逆算。
| コンポーネント | 再利用する機能 | 入口 |
|---|---|---|
| 浮動電卓 | 移動、複数インスタンス、四則・括弧・累乗・科学記数法 | UI |
| ROI・仮想定規 | 元画像座標で移動・回転・サイズ変更、端点・目盛り・吸着 | UI |
| 手動校正 | 既知の長さによる2点校正と編集可能な区分多点写像 | calibration.scale-1d |
| 断面・信号解析 | 相対応答、チャンネル品質、平滑化、ピークと幅 | image.strip-profile |
| 自動定規 | 実物目盛り候補、手動・領域指定・コントラスト・吸着設定 | vision.ruler-ticks |
| 定規 OCR・カメラ | cm 数値候補、ブラウザ取得・静止フレーム・カメラ設定 | browser |
| 光学逆算 | 干渉・回折波長、回帰、不確かさとシミュレーション | optics.fringe-wavelength |
中国語ガイド · API・導入 · 実行可能なサンプル · 信号特徴ツール · FringeLab guide
自動・OCR 候補は人の確認後に適用し、手動・多点モードも保持します。画像は650 nm 合成サンプルの実行結果です。DN は相対応答であり、実機測定精度を認証するものではありません。
現在のカタログ:9/9 Sensor + 4/4 処理 Tool = 13/13 capability。電卓・オーバーレイ UI は追加の再利用コンポーネントで、Sensor 数には含めません。
基本原則
- ソースプロジェクトを壊さず、暗黙に書き換えない。
- repository、完全な commit SHA、path、symbol まで来歴を固定する。
- 生の観測値を保存し、下流の導出値と区別する。
- 時刻、座標、単位、信頼度、不確かさを明示する。
- エビデンス、成熟度、ライセンス、モデル境界を保守的に記述する。
長期 workflow
新しい物理実験 project
↓
再利用可能な成熟機能
↓
Sensor Intake
↓
Physics Software Sensors
↓
Experimental / Validation / Release
↓
将来の物理実験 project
今後の作業は Sensor Intake、Add New Sensor recipe、または既存 Sensor の maintenance track から開始し、新しい Phase を自動的に作りません。最初の抽出から再利用までの完全な cycle は最初の完全な再利用ループに記録しています。
ドキュメント
- 3 言語ドキュメントサイト
- センサーカタログ
- Companion Tool カタログ
- Capability Showcase
- Getting Started
- エビデンスと成熟度
- Sensor Intake
- 最初の完全な再利用ループ と Maintenance Guide
- Current Project Status
- 用語 と i18n Style Guide
- Demo Asset Inventory
- Architecture、Data Format、Benchmarking
- 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 モデルを自動取得せず、weight を同梱しない。
- 過去の実験プロジェクトに移行を強制しない。
- PyPI/npm には公開しません。最初に merge された E5 統合は offline replay 経路であり、下流の live-camera 実装を置き換えません。
ライセンス
本 repository 固有のコードと文書は MIT です。過去のソースコード、モデル、データ、依存関係にはそれぞれのライセンス境界があります。THIRD_PARTY_NOTICES.md を参照してください。
最新 handoff: .agent-handoff/latest.md · .agent-handoff/latest.json

