# ldf

Python API: `luxonis_ml.ldf`

Luxonis 数据格式的标注模式。

luxonis_ml.ldf 包描述了一个 LDF 数据集的单个样本：一个
[DatasetRecord](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/annotation.md)
及其
[Detection](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/annotation.md)，标注负载（[BBoxAnnotation](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/annotation.md)、[KeypointAnnotation](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/annotation.md)、[SegmentationAnnotation](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/annotation.md)、[InstanceSegmentationAnnotation](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/annotation.md)、[ArrayAnnotation](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/annotation.md)、[ClassificationAnnotation](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/annotation.md)），以及它们存储的
[ParquetRecord](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/parquet.md)
行。

> **示例**
> 构建一个带有单个边界框标注的记录。引用的文件必须存在——[DatasetRecord](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/annotation.md) 会对其进行验证并将其存储为绝对路径。

```python
from luxonis_ml.ldf import DatasetRecord

record = DatasetRecord(
    file="images/frame_001.jpg",
    annotation={
        "class": "person",
        "boundingbox": {"x": 0.1, "y": 0.2, "w": 0.3, "h": 0.4},
    },
)
```

> **注意**
> 安装 `luxonis-ml[ldf]` 以在没有数据栈其余部分的情况下使用该格式。该额外部分是 `luxonis-ml[data]` 的子集。

> **另请参阅**
> [luxonis_ml.ldf.annotation](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/annotation.md) 用于记录和标注模式，[luxonis_ml.ldf.parquet](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/parquet.md) 用于它们序列化到的行。

## 子页面

 * [annotation](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/annotation.md)
 * [parquet](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/parquet.md)
