Appearance
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),保证字典序 = 时间序。
抽帧后自检
- 时间轴(底部)能从第一帧拖到最后一帧,无断档;
- 相邻帧内容连续,无跳变;
- 帧数量与抽帧策略估算值一致。
抽帧密度的权衡
抽太稀:目标位移大,时序标注的插值帮不上忙,漏检风险高。抽太密:存储与标注量线性上涨,且相邻帧高度相似会让 train/val 随机划分「泄漏」。起点建议:定间隔 5–10 帧,后续按 2.4 的按序列划分策略收敛。
常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 导入后数量对不上 | 哈希去重跳过了重复文件 | 看导入报告的跳过清单 |
| 图像显示方向不对 | EXIF 方向标记 | 导入时启用「应用 EXIF 方向」 |
| 视频无法解析 | 编码不受支持 | 先转码为 H.264 MP4 |
| 引用模式图片变红叉 | 源文件被移动 | 改回复制模式重新导入,或恢复源路径 |
下一步 → 2.2 标注(核心)