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

本页目录

  • 概述
  • 转换
  • 参数参考
  • 源模型输入设置
  • 平台和导出设置
  • 量化设置
  • 原始 ONNX 与 ONNX NN Archive
  • 故障排除

详细转换

最后更新

概述

为了充分利用我们设备上的 AI 模型,它们必须首先转换为目标平台的 RVC 编译格式。 如果您想了解什么是转换、为什么需要转换以及其中涉及的一些关键概念,请参阅 转换 部分。虽然 Hub 通过快速转换工具提供了快速简化的选项,但某些工作流需要更深层次的控制。 详细转换工作流专为这些更高级的用例而设计,提供精细的配置参数和版本/变体管理。 如果您更喜欢快速的一次性转换,且设置最少,请参阅 快速转换 部分。

转换

分步说明:

打开模型变体

打开 Hub,导航到 Models 部分,打开所需的模型,滚动到 Model Variants,然后单击要导出的变体旁边的 Convert。

选择目标平台

选择目标 RVC 平台。可用目标取决于上传的基础模型格式。 实际上,基于 ONNX 的模型源在所有平台中提供最广泛的转换支持。

配置转换表单

查看预填充值并根据需要进行调整。 如果基础模型是原始 ONNX 文件,请手动输入源模型输入设置。 如果基础模型是 ONNX NN Archive,请使用其 config.json 作为事实来源,并且仅在存档元数据不正确时更改值。请参阅下面的参考部分,了解每个字段的确切含义。

导出并确认结果

单击 Export 开始转换。 新的模型实例最初显示为 Pending,并在导出准备就绪时更改为 Success。 然后,您可以下载转换后的存档或通过 DepthAI 直接引用它。

参数参考

源模型输入设置

参数类别含义
Shape源模型源模型所需的输入形状
Mean Values源模型从输入中减去的每通道值
Scale Values源模型减去均值后应用的每通道除数
Encoding From源模型源模型所需的通道顺序
Encoding To导出模型转换后的模型在运行时所需的通道顺序

平台和导出设置

参数类别含义
Model Instance Name导出模型Hub 中显示转换实例的名称
Ir version / Snpe version转换过程目标转换格式或运行时版本
Disable Onnx Simplification转换过程在转换期间禁用 ONNX 图简化
Mo Args转换过程RVC2 和 RVC3 的额外 OpenVINO 模型优化器参数
Compile Tool Args转换过程RVC2 的额外 OpenVINO 编译工具参数
POT Target Device转换过程RVC3 的 POT 目标设备
Convert to blob导出模型为 RVC2 导出 .blob 而不是 .superblob

量化设置

参数类别含义
Quantization Data转换过程用于校准量化转换的数据集
Max Quantization Images转换过程量化期间使用的最大图像数量
Target Precision转换过程RVC4 的精度目标,例如 FP16 或 INT8
在 Hub UI 中,您可以从下面列出的通用数据集中进行选择:
  • Driving - 街道和车辆图像(OIv7 类,如 Vehicle、Car、Traffic light 等)
  • Food - 水果、蔬菜、生食和熟食图像(OIv7 类,如 Apple、Salad、Pizza 等)
  • General - OIv7 图像的随机子集,代表各种对象和场景
  • Indoors - 室内空间图像(OIv7 类,如 Table、Chair、Fireplace 等)
  • Random - 随机像素图像
  • Warehouse - 仓库内部图像(叉车-1 图像的随机子集)
如果您需要自定义量化数据集,请使用 HubAI SDK。 有关更高级的转换和量化选项,请参阅 ModelConverter 文档。

原始 ONNX 与 ONNX NN Archive

起始点Hub 可以自动确定什么您仍然需要定义什么
原始 ONNX图中的张量结构训练时预处理选择和语义输出元数据,例如类名和解析器配置
ONNX NN Archiveconfig.json 中的张量元数据、预处理和可选 heads 元数据导出选择,例如目标平台和转换特定选项
如果您从正确定义的 ONNX NN Archive 开始,通常不应手动编辑导出的存档。 导出的存档预计与源存档不同。 例如,模型路径从 model.onnx 更改为编译工件,例如 .superblob、.blob 或 .dlc,并且 mean / scale 可以变为 null,因为预处理已烘焙到编译模型中。

故障排除

并非所有模型都可以转换为所需的平台。 您可以按如下方式检查失败的转换日志:

打开失败的转换作业

在 Failed Conversions 部分找到失败的作业并打开它。

下载或检查日志

使用右上角的 Logs 按钮下载日志,或直接在页面上检查 Conversion process logs 部分。