Skip to content

2.1 导入数据 ​

导入是数据侧的入口,做对三件事:图像进得来、类别立得对、视频抽帧有策略。

2.1.1 导入图像 ​

操作路径 ​

文件 → 新建项目 → 导入数据(或已有项目中 数据 → 导入图像)。

支持情况 ​

项目支持说明
格式JPG / PNG / BMP / TIFF / WebP其他格式先用转换工具转码
来源本地文件夹批量导入支持递归包含子目录
组织方式保留目录结构 / 拍平到单层序列数据建议保留结构,便于抽帧与按序列划分
文件处理复制进项目 / 原地引用复制为默认;引用模式不占空间但源文件移动后失效

导入选项 ​

选项建议理由
复制到项目目录✅ 开启源文件被清理时标注不丢
保留目录结构序列数据开、散图关保留结构后「按序列划分」才可用(见 2.4)
基于文件内容哈希去重✅ 开启同一张图重复导入会导致训练集泄漏,导入时自动识别跳过
跳过损坏文件并记录✅ 开启个别坏图不阻塞整批导入,事后在报告里处理

去重与「权衡 / 编码」

去重依赖文件内容哈希;遇到「同图不同文件」或需要批量转码的场景,见附录 D · 权衡 / 编码。

导入后自检 ​

导入完成页会给出统计:成功数、跳过(去重/损坏)数、尺寸分布。抽 3–5 张打开确认:能正常显示、EXIF 方向正确、无明显黑边。尺寸分布异常(混入超大图)时,先统一处理再标注,避免训练时频繁缩放。

2.1.2 建立类别体系 ​

导入时或项目内 数据 → 类别管理 均可维护类别。类别是标注与训练的契约,宁可前期多想一小时,不要中期反复改。

字段要求示例
类别名英文小写 + 下划线,训练后不可随意改scratch、dent、stain
显示名给人看的中文名,可随时改划痕、凹陷、污渍
颜色自动分配,可改—
属性定义可选;键值对,如 severity: minor/major用于标注时补充描述

类别名即契约

模型输出、导出格式、推理端配置全都引用类别名。中期改类别名等于换契约:旧标注要映射、旧模型要重训。新增类别可以,改名/删类别谨慎。

2.1.3 视频与序列抽帧 ​

对视频文件或连续序列图,先抽帧再标注。

抽帧模式 ​

模式规则适用
定间隔抽帧每 N 帧取 1长视频快速建库,目标运动慢
定帧率抽帧每秒 M 帧需要稳定时间分辨率时
关键帧抽帧按场景切换检测镜头切换少的监控视频
全部导入逐帧导入短视频(几百帧内)

抽帧设置 ​

  • 帧范围:可只导入视频的某个时间段(如 00:10–05:00)。
  • 输出组织:按「视频名/帧序号」目录结构存放,保留该结构——后续按序列划分(2.4)和 track_id 关联(2.2.4)都依赖它。
  • 命名规则:帧序号统一补零(frame_000123.jpg),保证字典序 = 时间序。

抽帧后自检 ​

  1. 时间轴(底部)能从第一帧拖到最后一帧,无断档;
  2. 相邻帧内容连续,无跳变;
  3. 帧数量与抽帧策略估算值一致。

抽帧密度的权衡

抽太稀:目标位移大,时序标注的插值帮不上忙,漏检风险高。抽太密:存储与标注量线性上涨,且相邻帧高度相似会让 train/val 随机划分「泄漏」。起点建议:定间隔 5–10 帧,后续按 2.4 的按序列划分策略收敛。

常见问题 ​

现象原因处理
导入后数量对不上哈希去重跳过了重复文件看导入报告的跳过清单
图像显示方向不对EXIF 方向标记导入时启用「应用 EXIF 方向」
视频无法解析编码不受支持先转码为 H.264 MP4
引用模式图片变红叉源文件被移动改回复制模式重新导入,或恢复源路径

下一步 → 2.2 标注(核心)