# native_parser

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

## 类

### NativeParser

解析带有原生 LDF 注释的目录。

预期格式：

```json
dataset_dir/
├── metadata.json  (可选；命名写入的 LDF 版本)
├── train/
│   └── annotations.json
├── val/
└── test/
```

`metadata.json` 是由
[NativeExporter](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/exporters/native_exporter.md)
写入的版本戳。它不是必需的，并且仅在警告来自较新 LDF 版本的导出时才读取。

注释存储在单个 JSON 文件中，作为字典列表，其格式与
[BaseDataset.add](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/datasets/base_dataset.md)
使用的生成器函数的输出相同。

`sample_metadata` 被读取为记录级元数据，并保留在生成的
[DatasetRecord](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/annotation.md)
上。它与 `annotation["metadata"]` 不同，后者创建元数据标签任务。

`annotations.json` 条目示例：

> ```pycon
> {
>   "file": "images/0.jpg",
>   "task_name": "detection",
> 
>   "sample_metadata": {
>     "record_id": 123,
>     "camera": "left",
>     "tags": ["night", "warehouse"]
>   },
> 
>   "annotation": {
>     "class": "person",
>     "boundingbox": {
>       "x": 0.1,
>       "y": 0.2,
>       "w": 0.3,
>       "h": 0.4
>     }
>   }
> }
> ```

#### 方法

##### init

```python
def __init__(*args, **kwargs):
```

为目标数据集创建解析器。

参数

 * `*args`
 * `dataset`: 用于填充解析记录的数据集。
 * `dataset_type`: 源数据集格式。
 * `task_name`: 可选的任务命名规则。字符串用于所有记录。映射使用类名作为键，任务名作为值。
 * `full_warnings`: 是否记录所有跳过的注释警告。当为 `False` 时，只记录前 50 个警告，其余的进行总结。
 * `**kwargs`

##### from_dir

```python
def from_dir(dataset_dir: Path) -> tuple[list[Path], list[Path], list[Path]]:
```

解析源数据集目录中的所有数据。

参数

 * `dataset_dir` (`Path`): 源数据集目录。
 * `**kwargs`: 额外的解析器特定参数。

返回

 * `tuple[list[Path], list[Path], list[Path]]`: 训练、验证和测试拆分中添加的图像。

##### from_split

```python
def from_split(annotation_path: Path) -> ParserOutput:
```

解析原生 LDF 注释。

参数

 * `annotation_path` (`Path`): 包含注释的 JSON 文件。

返回

 * `ParserOutput`: 包含注释记录、骨架元数据和添加图像的解析器输出。

##### validate_split

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

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

参数

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

返回

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