# native_exporter

Python API: `luxonis_ml.data.exporters.native_exporter`

## 类

### NativeExporter

用于原生 LDF 目录格式的导出器。

原生导出器会写入带有复制媒体和 `annotations.json` 文件的拆分目录。每个注释条目都遵循
[NativeParser](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/parsers/native_parser.md)
和
[LuxonisDataset.add](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/datasets/luxonis_dataset.md)
接受的相同记录级形状。

`sample_metadata` 作为 JSON 对象导出，位于 `file` 或 `files` 旁边。它是记录级元数据，而不是注释标签。

导出根目录还包含一个 `metadata.json` 版本戳，例如 `{"ldf_version": "2.1.0"}`。它不是数据集在其自身存储中保留的完整
[Metadata](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/datasets/metadata.md)
模型。

传递较旧的 `ldf_version` 会剥离该版本不知道的字段——导出 LDF 2.0 会省略 `sample_metadata`。请参阅
[LDFDowngrader](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/exporters/ldf_downgrade.md)。

> **示例**
> ```json
{
  "file": "images/0.jpg",
  "task_name": "detection",

  "sample_metadata": {
    "record_id": 123,
    "camera": "left",
    "tags": ["night", "warehouse"]
  },

  "annotation": {
    "instance_id": 0,
    "class": "person",
    "boundingbox": {
      "x": 0.1,
      "y": 0.2,
      "w": 0.3,
      "h": 0.4
    }
  }
}
```

#### 方法

##### init

```python
def __init__(dataset_identifier: str, output_path: Path, max_partition_size_gb: float | None, *, ldf_version: Version | None =
None):
```

##### export

```python
def export(prepared_ldf: PreparedLDF):
```

将准备好的数据集转换为导出器格式。

参数

 * `prepared_ldf` (`PreparedLDF`): 为导出准备的数据集数据。

引发

 * `NotImplementedError`: 抽象基类实现总是引发此错误。

##### get_split_names

```python
def get_split_names() -> dict[str, str]:
```

##### supported_ann_types

```python
def supported_ann_types(self) -> list[str]:
```

返回此导出器支持的任务类型。

返回

 * `list[str]`: 支持的注释任务类型。

引发

 * `NotImplementedError`: 抽象基类实现总是引发此错误。

#### 属性

##### current_size

##### ldf_version
