# NanoTrack_RK3588_python

**Repository Path**: zhenghongjiang/NanoTrack_RK3588_python

## Basic Information

- **Project Name**: NanoTrack_RK3588_python
- **Description**: Nanotrack of python for RK3588
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-27
- **Last Updated**: 2025-12-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NanoTrack_RK3588_python

基于瑞芯微RK3588 NPU的NanoTrack跟踪算法，可运行于RK3588开发板，可达120FPS.


## 依赖

```
	numpy
	opencv
	rknn_toolkit_lite2 == 1.3 
```

RKNN3588对应的rknn_toolkit_lite2官方开发库以及开发文档请参考[rknn-toolkit2](https://github.com/rockchip-linux/rknn-toolkit2)


## 普通运行方式（源代码）

模型转换需先使用rknn-toolkit2转为.rknn格式

```
	python3 main.py
```

- video_name 为目标视频地址
- init_rect 为初始检测bbox

## 使用编译后的SO文件运行（推荐在RK3588上使用）

### 运行方式

```
	python3 run_so.py
```

### 参数说明

- 默认使用摄像头进行跟踪
- 可指定视频文件：`python3 run_so.py --video path/to/video.mp4`

### 操作说明

- **s键**: 开始跟踪
- **q键**: 重置到初始状态
- **x键**: 退出程序

### 配置说明

程序会从`setting.ini`文件加载配置，主要配置项包括：

- 摄像头源设置
- 跟踪器参数
- 显示设置（颜色、窗口名称等）
- 模型路径设置

## reference

[rknn-toolkit2](https://github.com/rockchip-linux/rknn-toolkit2)  
[SiamTracker](https://github.com/HonglinChu/SiamTrackers)

## 版本更新记录

### V1.3

**功能优化**：

- **跟踪器启动逻辑修复**：修复了在Tracking模式下跟踪器无法正确启动的问题
- **初始框显示逻辑优化**：改进了蓝色初始框的显示条件，确保仅在非跟踪状态下显示
- **跟踪初始化流程完善**：重构了跟踪状态下的初始化逻辑，确保phase=0时能正确初始化并转为phase=1执行跟踪
- **帧率显示功能**：在跟踪模式下，在图像左上角状态信息下方实时显示帧率，帮助监控系统性能
- **调试日志增强**：添加了更详细的状态跟踪日志，便于问题定位和系统监控

**使用说明**：
- 跟踪模式启动后，左上角状态信息（绿色的"Tracking"）下方会自动显示当前帧率
- 帧率数据每秒更新一次，显示为"FPS: X.X"格式

### V1.2

**功能优化**：

- **参数配置外部化**：将初始化框大小调整相关参数配置移至setting.ini文件，提高程序的灵活性和可配置性
- **新增配置项**：
  - `min_box_size`：初始化框的最小尺寸（范围：10-300）
  - `max_box_size`：初始化框的最大尺寸（范围：10-300）
  - `box_size_step`：每次调整的步长（范围：2-10）
  - `key_hold_interval`：连续按键时的间隔时间（范围：0.1-0.5秒）
- **参数有效性检查**：自动验证配置参数是否在有效范围内，确保系统稳定性
- **配置错误处理**：当参数不在有效范围内时，自动调整到安全值并显示警告信息

**使用说明**：
- 打开setting.ini文件，在[Tracker]部分找到上述配置项
- 根据需要修改参数值，保存文件
- 重新运行程序，系统会自动加载新的配置

### V1.1


**新功能**：

- **初始化框大小可调整**：用户现在可以在初始化阶段（包括重置后）调整跟踪框的大小，以更好地匹配目标尺寸
- **键盘控制优化**：
  - 添加了**r键**：放大初始化框（每次增加5个单位）
  - 添加了**f键**：缩小初始化框（每次减少5个单位）
  - 实现了**按住键连续调整**功能：按住r或f键时，每隔0.2秒自动调整一次大小
  - 为初始化框大小添加了**边界限制**：最小10，最大256
- **用户界面增强**：
  - 在显示窗口中实时显示当前框大小
  - 添加了操作提示文本，指导用户如何使用r键和f键
- **稳定性优化**：确保在重置和切换状态时正确管理按键状态

**使用说明**：
- 在初始化阶段（未开始跟踪前），按r键放大框，按f键缩小框
- 按住不放可以连续调整大小
- 调整后按s键开始跟踪
- 该功能仅在初始化阶段和重置后生效，跟踪过程中不起作用