dd02 setting tune + change Class name from UVUnrollFrameProcessor to FrameUnwarper
This commit is contained in:
+17
-17
@@ -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 视图
|
||||
|
||||
## 开发套件使用方法
|
||||
参考开发套件附带的开发文档。
|
||||
Reference in New Issue
Block a user