base_dataset
最后更新
luxonis_ml.data.datasets.base_dataset类
BaseDataset
方法
add
Python
1def add(generator: DatasetIterator, batch_size: int = 1000000):generator(DatasetIterator): 生成DatasetRecord实例或可转换为DatasetRecord的字典的迭代器。batch_size(int): 处理前缓冲的记录数。值越低,峰值内存使用量越少。
delete_dataset
Python
1def delete_dataset(self):exists
Python
1def exists(dataset_name: str) -> bool:dataset_name(str): 要检查的数据集名称。
bool: 如果数据集存在,则为True,否则为False。
get_class_names
Python
1def get_class_names(self) -> dict[str, list[str]]:按任务名称键入的类名:Python1{ 2 "vehicles": ["red", "green", "blue"], 3 "brands": ["audi", "bmw", "mercedes"], 4}
get_classes
Python
1def get_classes(self) -> dict[str, dict[str, int]]:按任务名称分组的从类名到类 ID 的映射:Python1{ 2 "color": {"red": 0, "green": 1, "blue": 2}, 3 "brand": {"audi": 0, "bmw": 1, "mercedes": 2}, 4}
get_n_classes
Python
1def get_n_classes(self) -> dict[str, int]:dict[str, int]: 从任务名称到类计数的映射。
get_n_keypoints
Python
1def get_n_keypoints(self) -> dict[str, int]:dict[str, int]: 按任务名称键入的关键点数。
get_skeletons
Python
1def get_skeletons(self) -> dict[str, tuple[list[str], list[tuple[int, int]]]]:dict[str, tuple[list[str], list[tuple[int, int]]]]: 按任务名称键入的关键点标签和边。
get_source_names
Python
1def get_source_names(self) -> list[str]:list[str]: 用于标识输入数据的源名称。
get_task_names
Python
1def get_task_names(self) -> list[str]:list[str]: 任务名称。
get_tasks
Python
1def get_tasks(self) -> dict[str, list[str]]:dict[str, list[str]]: 按任务名称键入的任务类型。
make_splits
Python
1def make_splits(splits: Mapping[str, Sequence[PathType]] | Mapping[str, float] | tuple[float, float, float] | None = None, *, replace_old_splits: bool = False):注意
尽管
"train"、"val" 和 "test" 是传统的拆分名称,但您可以通过向 splits 参数提供映射来使用任何您想要的拆分名称。这对于组合来自多个源的记录("train_real"、"train_synth")或创建完全自定义的拆分非常有用。splits(Mapping[str, Sequence[PathType]] | Mapping[str, float] | tuple[float, float, float] | None): 定义拆分的映射。可以是以下之一:- 拆分名称到文件路径列表的映射。
- 拆分名称到比率的映射。
- 训练、验证和测试拆分的三个比率的元组。 比率是 0 到 1 之间的数字,比率之和为 1。
1和1.0都有效。
replace_old_splits(bool): 是否用新拆分替换旧拆分。如果为False(默认),则将新拆分添加到现有拆分中。如果为True,则首先丢弃现有拆分。
TypeError: 如果映射值既不是比率也不是文件路径列表。该方法会警告并跳过文件路径列表的每个不是文件路径的元素。ValueError: 如果提供了splits但为空。ValueError: 如果比率超出 0 到 1 的范围或不等于 1。ValueError: 如果使用了拆分比率,但所有数据都已属于一个拆分,而replace_old_splits为False。FileNotFoundError: 如果数据集为空。
set_classes
Python
1def set_classes(classes: list[str] | dict[str, int], task: str | None = None):classes(list[str] | dict[str, int]): 类名,或按类名键入的类 ID。如果提供了类名,则 ID 从 0 开始按字母顺序分配。名为"background"的类始终分配 ID 0。task(str | None): 要更新的可选任务。如果省略,则更新所有任务。
set_skeletons
Python
1def set_skeletons(labels: list[str] | None = None, edges: list[tuple[int, int]] | None = None, task: str | None = None):Python
1dataset.set_skeletons(
2 labels=["right hand", "right shoulder", ...],
3 edges=[[0, 1], [4, 5], ...]
4)labels(list[str] | None): 可选的关键点名称。edges(list[tuple[int, int]] | None): 关键点之间的可选边。task(str | None): 要更新的可选任务。如果省略,则更新所有关键点任务。
ValueError: 如果既未提供labels也未提供edges。
set_tasks
Python
1def set_tasks(tasks: dict[str, list[str]]):tasks(dict[str, list[str]]): 从任务名称到任务类型的映射。
update_source
Python
1def update_source(source: LuxonisSource):source(LuxonisSource): 要存储的源定义。