# utils

Python API: `luxonis_ml.data.utils`

数据包共享的实用程序助手。

此包收集了数据集创建、解析、加载、导出、验证和可视化所使用的公共助手 API。这些实用程序按其支持的数据工作流部分进行分组：

实用程序组

| 组 | 公共 API |
| --- | --- |
| 任务键 |
[task_is_metadata](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/task_utils.md)、[split_task](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/task_utils.md)、[get_task_name](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/task_utils.md)、[get_task_type](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/task_utils.md)
和
[task_type_iterator](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/task_utils.md)
解析和过滤 `"task_name/task_type"` 标签。 |
| 存储和解析器枚举 |
[BucketStorage](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/enums.md)、[BucketType](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/enums.md)、[MediaType](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/enums.md)、[ImageType](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/enums.md)、[UpdateMode](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/enums.md)、[ParserIssue](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/enums.md)
和
[ParserIssueMessage](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/enums.md)。
|
| 数据帧和 Parquet 助手 |
[ParquetFileManager](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/parquet.md)、[ParquetRecord](https://docs.luxonis.com/zh/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/ldf/parquet.md)、重复检测、类别分布、缺失注释摘要、热图和
UUID 合并。 |
| 远程媒体 |
[RemoteFileDownloader](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/remote_file_downloader.md)
和
[download_remote_file](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/remote_file_downloader.md)
将支持的远程文件复制到本地路径并验证图像输入。 |
| 可视化 |
[visualize](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/visualizations.md)、颜色映射助手、图像拼接、增强页脚和数据集统计图。
|
| 等效性 | LDF 等效性检查。 |

任务键助手遵循与
[LuxonisLoader](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/loaders/luxonis_loader.md)
相同的约定：标签通过 `"task_name/task_type"` 进行寻址，元数据标签在没有任务名称时使用 `"task_name/metadata/key"` 或 `"metadata/key"`。

## 子页面

 * [cli_utils](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/cli_utils.md)
 * [constants](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/constants.md)
 * [data_utils](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/data_utils.md)
 * [enums](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/enums.md)
 * [ldf_equivalence](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/ldf_equivalence.md)
 * [parquet](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/parquet.md)
 * [plot_utils](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/plot_utils.md)
 * [remote_file_downloader](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/remote_file_downloader.md)
 * [task_utils](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/task_utils.md)
 * [visualizations](/software-v3/ai-inference/model-source/training/luxonis-ml/luxonis-ml-api-reference/data/utils/visualizations.md)
