dd02 setting tune + change Class name from UVUnrollFrameProcessor to FrameUnwarper

This commit is contained in:
ykcheungab
2026-07-14 20:00:40 +08:00
parent c2fb0b12b5
commit 30f9deb5b2
14 changed files with 275 additions and 94 deletions
+17 -17
View File
@@ -1,16 +1,16 @@
叠动科技软件使用手册
版本: 0.4.1
更新日期: 2026年4月16日
更新日期: 2026年7月13日
# 简介
本文件介绍如何上手和运行叠动视触觉传感器配套的开发套件。本套件是配合叠动视触觉传感器进行图像处理,计算形变、力以及接触信息。它可以从摄像头或视频文件中读取图像,处理后打印和展示处理后信息。
支持操作系统:Windows、Ubuntu
建议Python 版本: 3.10
建议Python 版本: 3.10, 3.11, 3.12
# 基础环境设置
## 安装 Python 与 Anaconda
1. 访问 [Anaconda 官网](https://www.anaconda.com/download)下载适合您操作系统的安装包(Windows、Linux)。
2. 按照提示完成安装。(Widnows:建议在安装过程中勾选“将 Anaconda 添加到系统环境变量”选项,方便后续使用)。
2. 按照提示完成安装。
3. 安装完成后,打开命令行终端(Windows 用户可在”Anaconda Navigator”打开“Anaconda Prompt”),输入 `conda info` ,若能显示 conda 的信息,则说明安装成功。
## 创建conda虚拟环境
@@ -115,8 +115,8 @@ print(orisys.__version__)
套件里面包含了多个例子,建议都在仓库根目录运行(即 `config/`、`examples/`、`assets/` 同级目录)。常见入口分为两类:
1. `examples/basic_pipeline.py`:复眼/拼接传感器基础 OpenCV 示例
2. `examples/finger_pipeline.py`:指纹传感器 UV 展开最小流程示例
3. `examples/finger_pipeline_3dview.py`:指纹传感器 Qt 3D 可视化界面
2. `examples/finger_pipeline.py`:手指传感器2维显示最小流程示例
3. `examples/finger_pipeline_3dview.py`:手指传感器 Qt 3D 可视化界面
下面先介绍最基础的 `basic_pipeline.py` 运行方式。
@@ -140,9 +140,9 @@ print(orisys.__version__)
```
5. 程序会运行,并自动打开可视化窗口和打印资料,在窗口上按键盘”q”键可以停止运行,按”r”键可以重设数据
### 指纹传感器 UV 示例
### 手指传感器 UV 示例
如果您使用的是指纹/单相机 UV 展开流程,可运行:
如果您使用的是手指/单相机 UV 展开流程,可运行:
``` bash
python examples/finger_pipeline.py --camera_id 0 --config ./config/dd02-ov.json
@@ -164,30 +164,30 @@ python examples/finger_pipeline.py --video ./data/sample.mp4 --config ./config/d
常用参数:
- `--verbose`:输出更详细的初始化日志
- `--profile`:打印每个阶段的耗时统计
- `--profile-every N`:每 N 帧输出一次平均耗时
例如:
``` bash
python examples/finger_pipeline.py --camera_id 0 --config ./config/dd02-ov.json --profile --profile-every 30
python examples/finger_pipeline.py --camera_id 0 --config ./config/dd02-ov.json
```
### 指纹 3D 可视化界面
如果已经安装 GUI 依赖,还可以运行:
### 手指 3D 可视化界面
如果要使用 GUI ,安装GUI依赖:
``` bash
pip install open3d
pip install pyqt5 pyqtgraph
```
然后运行:
``` bash
pip install -e ".[gui]"
python examples/finger_pipeline_3dview.py --video 0 --config ./config/dd02-ov.json
```
该界面会提供:
- 指纹 UV 展开图
- 手指平面化光流箭头显示
- 力曲线
- 3D mesh 视图
- 录制与重置等交互控件
- 3D 视图
## 开发套件使用方法
参考开发套件附带的开发文档。