ultralytics_ndjson_parser
最后更新
luxonis_ml.data.parsers.ultralytics_ndjson_parser类
UltralyticsNDJSONParser
"train"。"valid" 和 "validation" 被规范化为 "val"。图像记录通过两个字段定位其图像:file命名本地图像。相对路径根据包含.ndjson清单的目录进行解析。绝对路径按原样使用。url命名远程图像。解析器下载它,然后file只提供缓存的文件名。解析器将 URL 的哈希附加到该名称,并将图像写入每个拆分的缓存目录。
url 的记录从不读取本地 file 路径。一个清单可以描述一个完全远程的数据集。方法
from_dir
Python
1def from_dir(dataset_dir: Path, reuse_cached: bool = True, **kwargs) -> tuple[list[Path], list[Path], list[Path]]:dataset_dir(Path): 包含一个.ndjson文件的目录,或.ndjson文件的直接路径。reuse_cached(bool): 是否重用已缓存的远程图像(如果它们已存在)。**kwargs: 解析器特定参数。
tuple[list[Path], list[Path], list[Path]]: 训练、验证和测试拆分中添加的图像。
ValueError: 如果无法解析 NDJSON 数据集文件,解析的文件具有无效的标头,远程图像下载目录已存在,或者姿势注释无法推断关键点维度。
from_split
Python
1def from_split(ndjson_path: Path, reuse_cached: bool = True) -> ParserOutput:ndjson_path(Path): Ultralytics NDJSON 文件的路径。reuse_cached(bool): 是否重用已缓存的远程图像(如果它们已存在)。
ParserOutput: 包含注释记录、空骨架元数据和添加图像的解析器输出。
ValueError: 如果文件具有无效的标头,远程图像下载目录已存在,或者姿势注释无法推断关键点维度。
parse_dir
Python
1def parse_dir(dataset_dir: Path, reuse_cached: bool = True, **kwargs) -> BaseDataset:dataset_dir(Path): 包含一个.ndjson文件的目录,或.ndjson文件的直接路径。reuse_cached(bool): 是否重用已缓存的远程图像(如果它们已存在)。**kwargs: 解析器特定参数。可以提供split_ratios以重新采样拆分分配。
BaseDataset: 包含已解析图像和注释的数据集。
ValueError: 如果 NDJSON 文件无法解析或无法解析为有效的 Ultralytics 数据集。
parse_split
Python
1def parse_split(split: str | None = None, random_split: bool = True, split_ratios: dict[str, float | int] | None = None, reuse_cached: bool = True, **kwargs) -> BaseDataset:split(str | None): 可选的拆分名称,用于分配给所有已解析的图像。random_split(bool): 百分比split_ratios是否应重新采样所有图像。split_ratios(dict[str, float | int] | None): 可选的比率或计数。浮点值被视为比率;整数值被视为计数。reuse_cached(bool): 是否重用已缓存的远程图像(如果它们已存在)。**kwargs: 解析器特定参数。必须包含ndjson_path。
BaseDataset: 包含已解析图像和注释的数据集。
ValueError: 如果缺少ndjson_path,文件具有无效的标头,远程图像下载目录已存在,或者姿势注释无法推断关键点维度。
validate
Python
1def validate(dataset_dir: Path) -> bool:dataset_dir(Path): 源数据集目录。
bool: 数据集是否为预期格式。
validate_split
Python
1def validate_split(split_path: Path) -> dict[str, Any] | None:split_path(Path): 拆分目录的路径。
dict[str, Any] | None:from_split的关键字参数,如果拆分不是预期格式,则为None。