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

本页目录

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

native_parser

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

类

NativeParser

解析带有原生 LDF 注释的目录。预期格式:
JSON
1dataset_dir/
2├── metadata.json  (可选;命名写入的 LDF 版本)
3├── train/
4│   └── annotations.json
5├── val/
6└── test/
metadata.json 是由 NativeExporter 写入的版本戳。它不是必需的,并且仅在警告来自较新 LDF 版本的导出时才读取。注释存储在单个 JSON 文件中,作为字典列表,其格式与 BaseDataset.add 使用的生成器函数的输出相同。sample_metadata 被读取为记录级元数据,并保留在生成的 DatasetRecord 上。它与 annotation["metadata"] 不同,后者创建元数据标签任务。annotations.json 条目示例:
Pycon
1{
2  "file": "images/0.jpg",
3  "task_name": "detection",
4
5  "sample_metadata": {
6    "record_id": 123,
7    "camera": "left",
8    "tags": ["night", "warehouse"]
9  },
10
11  "annotation": {
12    "class": "person",
13    "boundingbox": {
14      "x": 0.1,
15      "y": 0.2,
16      "w": 0.3,
17      "h": 0.4
18    }
19  }
20}

方法

init
Python
1def __init__(*args, **kwargs):
为目标数据集创建解析器。参数
  • *args
  • dataset: 用于填充解析记录的数据集。
  • dataset_type: 源数据集格式。
  • task_name: 可选的任务命名规则。字符串用于所有记录。映射使用类名作为键,任务名作为值。
  • full_warnings: 是否记录所有跳过的注释警告。当为 False 时,只记录前 50 个警告,其余的进行总结。
  • **kwargs
from_dir
Python
1def 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
1def from_split(annotation_path: Path) -> ParserOutput:
解析原生 LDF 注释。参数
  • annotation_path (Path): 包含注释的 JSON 文件。
返回
  • ParserOutput: 包含注释记录、骨架元数据和添加图像的解析器输出。
validate_split
Python
1def validate_split(split_path: Path) -> dict[str, Any] | None:
验证拆分目录是否具有预期格式。参数
  • split_path (Path): 拆分目录的路径。
返回
  • dict[str, Any] | None: from_split 的关键字参数,如果拆分不符合预期格式,则为 None。