【标注工具 03】labelfast标注工具使用指南(支持YOLO\COCO\VOC格式)v3版本

介绍

[一. 创建数据集 (Create Dataset)](#一. 创建数据集 (Create Dataset))

[二. 导出数据 (Export Data)](#二. 导出数据 (Export Data))

[三. 批量重命名 (Batch Rename)](#三. 批量重命名 (Batch Rename))

[四. 图像调整大小 (Image Resize)](#四. 图像调整大小 (Image Resize))

总结

版本

链接

介绍

Labelfast 标注工具近期进行了功能更新，在菜单栏中新增了**"数据集（Dataset）"**选项。此次更新主要增加了四个实用功能，旨在帮助用户更高效地完成标注后的数据整理、划分和预处理工作。以下是这四个新功能的具体介绍。

一. 创建数据集 (Create Dataset)

点击"数据集创建"或者快捷键 Ctr+D

该功能用于将当前已标注的图像和标签文件，按照用户设定的比例自动划分为训练集、验证集和测试集，并生成标准的目录结构及配置文件。

可视化比例分配

界面提供了一个三段式滑块组件，分别代表训练集、验证集和测试集。用户可以通过拖动滑块直观地调整三者的百分比。系统会自动约束三者之和为 100%，并确保每个集合至少包含 1% 的数据，防止因比例设置不当导致某个集合为空。

灵活的文件的处理策略

用户可以选择在划分时是复制文件（保留原始位置的文件）还是移动文件。同时支持自定义数据集保存的根路径。

自动化目录与配置生成

执行后，程序会自动创建符合主流深度学习框架（如 YOLO）要求的目录结构：

数据集根目录/
├── train/
│ ├── images/ # 训练集图片
│ └── labels/ # 训练集标签
├── valid/
│ ├── images/ # 验证集图片
│ └── labels/ # 验证集标签
├── test/
│ ├── images/ # 测试集图片
│ └── labels/ # 测试集标签
└── data.yaml # 数据集配置文件

此外，程序会自动读取类别文件，统计类别数量并生成 data.yaml 配置文件，其中包含了类别名称列表和各集合的图片路径，无需手动编辑。

进度反馈

在处理大量文件时，界面会显示进度条，实时反映文件划分和复制的进度。

二. 导出数据 (Export Data)

点击 "数据导出" 或者快捷键Ctrl+E

当用户只需要部分数据进行测试或备份时，可以使用此功能。它允许用户从文件列表中手动选择特定的图像及其对应的标签文件进行导出。

选择性导出

在主界面的文件列表中，勾选需要导出的行（支持多选），点击"导出数据"即可。未勾选的文件将被忽略。

结构化输出

导出的文件会自动整理为 images 和 labels 两个文件夹，保持图像与标签的一一对应关系。同样支持选择"复制"或"移动"原文件。此功能适用于构建小型测试集或筛选高质量样本。

导出成功

图片文件与标签文件

三. 批量重命名 (Batch Rename)

点击"批量重命名"或者快捷键Ctrl+B

为了规范文件管理，新功能提供了批量重命名工具，能够同步修改图像文件和其关联的标签文件名，确保两者 basename 一致。

自定义命名规则

用户可以设置文件名的前缀（支持字母、数字、下划线等），并设定起始编号及编号长度。系统会自动补零（例如生成 sample_00001.jpg）。

智能同步与安全机制
- 同步修改：重命名图像时，对应的标签文件（.txt, .json, .xml）会自动同步改名。
- 冲突处理：如果目标文件名已存在，系统会提示用户选择"跳过"或"取消"。
- 事务回滚：若在重命名过程中发生错误或用户取消操作，系统会自动将所有已修改的文件名恢复至原始状态，保障数据安全。
操作统计

完成后会弹出报告，显示成功重命名的数量、因重名跳过的数量等信息。

重命名成功

文件列表已经更新名称

四. 图像调整大小 (Image Resize)

点击"图像调整大小"或者快捷键Ctrl+I

该功能用于批量调整图像尺寸，并能智能同步调整对应的标签坐标，确保缩放后的图像与标注信息依然匹配。

尺寸与比例设置

支持自定义目标宽度和高度。用户可选择是否保持长宽比：若选中，图像将按比例缩放（可能小于设定值）；若不选中，图像将被拉伸至设定尺寸。

多格式标签自适应

这是该功能的核心亮点，它能根据不同标签格式自动处理坐标数据：
- YOLO 格式：由于使用归一化坐标，通常无需修改数值，但系统会确保文件关联正确。
- COCO (JSON) 格式：自动解析 JSON 文件，按比例缩放 bbox（边界框）、segmentation（分割多边形）和 keypoints（关键点）的坐标，并更新图像宽高元数据。
- VOC (XML) 格式：自动解析 XML 文件，同步缩放坐标值并更新 <size> 节点。
调整范围

可以选择文件列表中勾选的复选框或者全部文件

插值算法与预览

提供最近邻、双线性（默认）、双三次三种 OpenCV 插值算法供选择。处理完成后，画布会自动刷新，用户可立即查看调整后的图像及标注效果。

原来的图片分辨率大小都是640x640

现在统一改成720x720

调整完全

图片已经改成720x720

标签文件中的标注同比例放缩了，因此目标物还是在标注框内，为改变。

总结

本次 Labelfast 更新的"数据集"菜单，通过创建数据集 、导出数据 、批量重命名 和图像调整大小四个功能，覆盖了从数据清洗到数据集构建的主要环节。这些功能通过图形化界面操作，简化了原本需要编写脚本才能完成的任务，特别是图像缩放时的坐标自动修正功能，有效提高了数据预处理的效率和准确性。

版本

|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 版本 | 描述 |
| v1.0 | 1、支持矩形、多边形和关键点三种标注模式。 2、兼容YOLO、COCO、VOC三种主流标注格式。 3、批量管理图片和标签文件，支持快速切换。 4、可视化编辑类别，自动分配颜色。 5、右侧文件列表和左侧标签列表联动管理。 6、支持三种保存模式：自动保存、手动保存、提示保存。 7、所有主要操作均支持快捷键。 8、文件列表支持图片和标签文件联动重命名。 9、提供试用期和注册码激活的授权系统。 10、可打包为独立可执行文件方便部署。 |
| v1.1 | 1、增加画布支持缩放、框体编辑等交互操作。 |
| v1.2 | 1、增加画布拖拽 |
| v1.2.1 | 1、修改分类列表修改名称按取消时，提示不正常。 2、修改文件列表修改名称，当修改的名称已经存在时，提示不正常。 3、修改如果图片文件夹包含不是图片的文件，表格无法加载图片文件问题。 4、修改画布上鼠标右击，撤销绘制的快捷键的错误由Escape改成Ctrl+Z。 5、修改当鼠标点击表格第二列中的标签文件时，鼠标会自动跳转到对应行的第一列图片文件 |
| v1.2.2 | 1、修改当图片分辨率大于1080p，不能在整个图像上拉框 |
| v1.3 | 1、增加文件列表按键盘 Enter键弹窗对话框进行文件重命名 2、修改文件列表修改文件名称限制中文输入 3、修改分类类别修改名称限制中文输入 4、增加文件列表每行添加复选框 5、增加文件列表鼠标右双击，删除列表勾选的行文件 6、增加数据菜单栏，数据集创建 7、增加数据菜单栏，数据导出 8、增加数据菜单栏，批量重命名 9、添加打开图像，清除画布和状态栏中信息的内容 10、添加标签列表和目标框右键菜单，添加变更该对象类别动作 11、修改窗口初始化大小把5/6改成9/10 12、修改文件列表点击文件状态栏更新画布大小以及图像的大小 13、修改窗口最大化与正常化切换时，画布跟着变化 14、增加数据菜单栏，调整图像大小 |

链接