此页面由 AI 自动翻译。查看英文原版
最后更新

本页目录

  • 类
  • FiftyOneClassificationParser
  • 函数
  • clean_imagenet_annotations
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

fiftyone_classification_parser

最后更新
Python API: luxonis_ml.data.parsers.fiftyone_classification_parser

类

FiftyOneClassificationParser

将 FiftyOne 图像分类数据解析为 LDF。支持两种目录结构:带有 train/test/validation 子目录的拆分结构:
Text
1dataset_dir/
2├── train/
3│   ├── data/
4│   │   ├── img1.jpg
5│   │   └── ...
6│   └── labels.json
7├── validation/
8│   ├── data/
9│   └── labels.json
10└── test/
11    ├── data/
12    └── labels.json
平面结构(单个目录,解析时应用随机拆分):
Text
1dataset_dir/
2├── data/
3│   ├── img1.jpg
4│   └── ...
5└── labels.json
labels.json 格式为:
Text
1{
2    "classes": ["class1", "class2", ...],
3    "labels": {
4        "image_stem": class_index,
5        ...
6    }
7}
此解析器支持 FiftyOne 图像分类导出布局。

方法

from_dir
Python
1def from_dir(dataset_dir: Path, **kwargs) -> tuple[list[Path], list[Path], list[Path]]:
解析源数据集目录中的所有数据。参数
  • dataset_dir (Path): 源数据集目录。
  • **kwargs: 其他解析器特定参数。
返回
  • tuple[list[Path], list[Path], list[Path]]: 训练、验证和测试拆分中添加的图像。
from_split
Python
1def from_split(split_path: Path) -> ParserOutput:
从一个拆分子目录解析数据。参数
  • split_path (Path)
  • **kwargs: 解析器特定参数,通常由 validate_split 生成。
返回
  • ParserOutput: LDF 生成器、骨架元数据和添加的图像。
validate_split
Python
1def validate_split(split_path: Path) -> dict[str, Any] | None:
验证拆分目录是否具有预期格式。参数
  • split_path (Path): 拆分目录的路径。
返回
  • dict[str, Any] | None: from_split 的关键字参数,如果拆分不是预期格式,则为 None。

函数

clean_imagenet_annotations

Python
1def clean_imagenet_annotations(labels_path: Path) -> Path:
清理 FiftyOne 标签中已知的 ImageNet 问题。清理修复了 ImageNet FiftyOne 导出中重复的类名和已知的标签索引错误:
  • 第一个 "crane"(鸟)变为 "crane bird",将其与起重机区分开来;
  • 第二个 "maillot" 变为 "maillot swim suit";
  • 图像 006742 从索引 517 移动到索引 134;
  • 图像 031933 从索引 639 移动到索引 638。
该函数将结果写入原始文件旁边的 labels_fixed.json,并在未更改任何内容时返回原始路径。参数
  • labels_path (Path): labels.json 的路径。
返回
  • Path: 清理后的标签文件的路径。