# fiftyone_classification_parser

Python API: `luxonis_ml.data.parsers.fiftyone_classification_parser`

## 类

### FiftyOneClassificationParser

将 FiftyOne 图像分类数据解析为 LDF。

支持两种目录结构：

带有 train/test/validation 子目录的拆分结构：

```text
dataset_dir/
├── train/
│   ├── data/
│   │   ├── img1.jpg
│   │   └── ...
│   └── labels.json
├── validation/
│   ├── data/
│   └── labels.json
└── test/
    ├── data/
    └── labels.json
```

平面结构（单个目录，解析时应用随机拆分）：

```text
dataset_dir/
├── data/
│   ├── img1.jpg
│   └── ...
└── labels.json
```

labels.json 格式为：

```text
{
    "classes": ["class1", "class2", ...],
    "labels": {
        "image_stem": class_index,
        ...
    }
}
```

此解析器支持 FiftyOne 图像分类导出布局。

#### 方法

##### from_dir

```python
def 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
def from_split(split_path: Path) -> ParserOutput:
```

从一个拆分子目录解析数据。

> **示例**
> ```pycon
split_kwargs = parser.validate_split(split_path)
if split_kwargs is not None:
    parser.from_split(**split_kwargs)
```

参数

 * `split_path` (`Path`)
 * `**kwargs`: 解析器特定参数，通常由 `validate_split` 生成。

返回

 * `ParserOutput`: LDF 生成器、骨架元数据和添加的图像。

##### validate_split

```python
def validate_split(split_path: Path) -> dict[str, Any] | None:
```

验证拆分目录是否具有预期格式。

参数

 * `split_path` (`Path`): 拆分目录的路径。

返回

 * `dict[str, Any] | None`: `from_split` 的关键字参数，如果拆分不是预期格式，则为 `None`。

## 函数

### clean_imagenet_annotations

```python
def 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`，并在未更改任何内容时返回原始路径。

> **注意**
> [FiftyOneClassificationParser](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/parsers/fiftyone_classification_parser.md) 仅对平面布局运行此清理。当目录名不是 `train`、`validation` 或 `test` 时，它将拆分视为平面，因此基于拆分的数据集保持其标签不变。

参数

 * `labels_path` (`Path`): `labels.json` 的路径。

返回

 * `Path`: 清理后的标签文件的路径。
