native_parser
最后更新
luxonis_ml.data.parsers.native_parser类
NativeParser
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 条目示例:Pycon1{ 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):*argsdataset: 用于填充解析记录的数据集。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: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。