# dataset_marker

**Repository Path**: lhh_ws/dataset_marker

## Basic Information

- **Project Name**: dataset_marker
- **Description**: 使用传统视觉的灯条特征提取，并将识别结果标注为数据集的项目。
- **Primary Language**: C++
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-06-05
- **Last Updated**: 2022-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dataset_marker

## 介绍
使用传统视觉的灯条特征提取，并将识别结果标注为数据集的项目。主要为了帮助数字分类器进行数字识别所需数据集而写
的程序。内部装甲板寻找逻辑来自于Hitwh:HERO@2022视觉代码中的自瞄逻辑。

### 程序流程
整体分为3部分。首先由自瞄代码找到图片中的可能装甲板；然后由数字分类器给出数字分类；
最后由人工进行结果修正并进行保存。

### 依赖库
本程序视觉处理部分由`OpenCV4.5.3`完成，所有文件操作由linux系统库`glibc`完成，json文件的处理部分由`jsoncpp`完成，其余均使用C++标准库。
神经网络推理部分使用OpenCV DNN模块并使用onnx作为模型文件。

#### jsoncpp库的安装
JsonCpp[[Github主页](https://github.com/open-source-parsers/jsoncpp)]是一个序列化反序列JSON格式的开源C++库，被C++程序广泛使用（包括Chromium项目）。JsonCpp还有一个重要特性是其支持在JSON格式内注释，这对于使用JSON格式作为配置文件很有意义，可以给配置添加注释说明其用途。
安装方式个人推荐直接源代码编译安装。

1.9.5版本源代码[下载链接](https://github.com/open-source-parsers/jsoncpp/archive/refs/tags/1.9.5.zip)

解压后进入源代码目录执行
```shell
mkdir build && cd build
cmake .. && sudo cmake --build . --target install -- -j12
```

### 操作方式
|          按键           |      作用      |
|:---------------------:|:------------:|
|           a           |    上一张图片     |
|           d           |    下一张图片     |
|      s/0/numpad0      | 将当前图片标记为负样本  |
| 1/numpad1 ～ 5/numpad5 | 将当前图片标记为1～5号 |
|       6/numpad6       |  将当前图片标记为哨兵  |
|       7/numpad7       | 将当前图片标记为前哨站  |
|       8/numpad8       |  将当前图片标记为基地  |

## Features
- 程序会自动按照`autogen_<img_cnt>_<armor_cnt>_<label>.bmp`的格式产生图像文件。
- 在每次保存前会自动检测是否有之前生成的文件，如果有，会以已经存在的标签为准而舍弃数字分类器的标签。
- 并且更改标签时有之前的旧文件存在，程序会使用`rename`而不是再次写入以减少磁盘IO。
- 如果对于一个已经存在的图片不更改标签那么程序什么都不会做而不是再次写入。
- 程序可以无限回退到之前的图片，不用再担心按错键了！
- 使用优化的log输出，可以很清晰的看到程序运行的log和当前的状态。
- 支持视频和图片两种数据源格式，并且视频支持跳帧读取