迁移到本版本

本主题包含关于将现有 VisionPro Deep Learning 项目从先前版本迁移到当前版本时所产生的更改的信息，这些更改可能影响现有项目。

迁移到 VisionPro Deep Learning 3.3.0

• 从 VisionPro Deep Learning 3.3.0 版开始，每次版本更新后都必须重新训练所有工具，包括次要版本更新。

• 绿色分类工具的高细节快速架构已被弃用。

• 红色分析和绿色分类高细节工具的网络模型参数的特大选项已被弃用。

• 当您将先前创建的工作区导入到 VisionPro Deep Learning 3.3.0 时，最大时期数和容忍度时期数作为默认参数导入。

3.0 → 3.1

使用 TensorRT 时要求重新优化  

在将 TensorRT 用于 VisionPro Deep Learning 3.1 时，请注意即使您已经针对 VisionPro Deep Learning3.0 优化了 TensorRT，还必须再次针对 VisionPro Deep Learning3.1 进行优化。

2.1 (2.1.1) → 3.0

从绿色分类高细节网络模型中删除“特大”

由于 VisionPro Deep Learning 3.0 中的绿色分类高细节进行了更新，绿色分类高细节的网络模型参数中的“特大”选项已从 VisionPro Deep Learning中删除。如果您要在VisionPro Deep Learning 3.0 中使用绿色分类高细节（已在 VisionPro Deep Learning 旧版中保存为“特大”网络大小），则导入工具并将其网络模型参数从空白更改为另一个（小、普通、大）。

删除红色分析高细节快速

由于内部原因，VisionPro Deep Learning 不支持红色分析高细节快速 3.0。当您打开红色分析高细节快速工具，该工具已在VisionPro Deep Learning 3.0 上的旧版 VisionPro Deep Learning 中进行过训练，则：

• 该工具将作为红色分析高细节工具打开。

• 此工具的训练网络将丢失。

• 此工具的视图及其标签将被保留。

• 工具参数值将重置为红色分析高细节工具的默认值。

此外，禁止将在旧版 VisionPro Deep Learning 中训练的红色分析高细节快速工具导入 VisionPro Deep Learning 3.0 工作区。

高细节 向后兼容性

当您打开红色分析高细节或绿色分类高细节工具，该工具已在VisionPro Deep Learning 3.0 上的旧版VisionPro Deep Learning 中进行了训练，则：

• 此工具的训练网络将丢失。

• 此工具的视图及其标签将被保留。

• 工具参数值将被保留。

在您将已在旧版 VisionPro Deep Learning 上训练的红色分析高细节 工具 (.vrta) 或 绿色分类高细节 工具 (.vgta) 导入 VisionPro Deep Learning 3.0 工作区：

• 此工具的训练网络将丢失。

• 此工具的视图及其标签将被保留。

• 工具参数值将被保留。

运行时工作区向后兼容性

在 VisionPro Deep Learning 3.0 之前版本中创建且包含红色分析高细节、红色分析高细节快速、绿色分类高细节或绿色分类高细节快速的运行时工作区不能导入 VisionPro Deep Learning 3.0。在此情况下，您需要在 VisionPro Deep Learning 3.0 中创建新的运行时工作区。

SuaKIT 分割和分类项目兼容性

由于无法导入在 VisionPro Deep Learning 3.0 之前的版本中创建和训练的高细节工具，也无法将现有分割或分类项目的训练模型（神经网络）从 SuaKIT 导入 VisionPro Deep Learning 3.0。

2.0 → 2.1 (2.1.1)

终止 CIE1 部署支持

VisionPro Deep Learning 2.1 不再正式支持 CIE1 部署目标，因为 VisionPro Deep Learning 不支持智能相机。自 VisionPro Deep Learning 2.0 起，对 CIE1 部署目标的支持已非正式终止，但该选项在 2.0 的 VisionPro Deep Learning GUI 中可见。

1.1 → 2.0

终止 Designer 支持

VisionPro Deep Learning 2.0 不再支持与 Cognex Designer 的集成。对于此特定更新，需要使用 Designer 的用户应使用VisionPro Deep Learning 1.1。

1.0.1 → 1.1

验证损失计算的更改

在高细节模式（红色分析和绿色分类）下，验证损失的计算基础从 128 次迭代更改为 0.125 个时期。基于此更改，在 128 次迭代（128 次迭代的 N 倍）基础上计算的容忍度参数不再用于高细节模式，而改用名为容忍度时期数的新参数。这个新参数是基于时期（N 个时期）计算的。对于已经训练好的绿色分类高细节工具，由于计算基础发生了变化，您必须手动重新配置容忍度时期数的值。

日志消息中的损失跟踪

日志消息中不再提供高细节模式（绿色分类和红色分析高细节）下的验证损失记录，因为其提供验证损失历史记录的功能已被损失检查器取代。

混淆矩阵的区域筛选条件

对于所有红色分析工具，区域筛选条件现在也应用于混淆矩阵的结果。也可以通过使用 filtered() 表达式来应用区域筛选条件。

1.0 → 1.0.1

VisionPro Deep Learning 1.0.0 中创建的工作区与 VisionPro Deep Learning 1.0.1 完全兼容

VisionPro ViDi 4.1 → VisionPro Deep Learning 1.0

现有绿色分类工具的架构

当您打开从先前版本 (ViDi Suite) 创建的工作区时，如果有绿色分类工具，您会看到聚焦模式下的绿色分类工具。绿色分类工具的现有架构称为聚焦模式，绿色分类工具的新架构称为高细节模式。

保留 API 的现有名称

由于 VisionPro Deep Learning 继承了 ViDi，因此在 API 的许多部分中都保留了名称 ViDi

API 的内部版本

产品版本为 1.0.0，但 API 和二进制文件中的版本为 5.0.0。

不再受支持或已弃用的 API

不再支持 GPUMode.MultipleDevicesPerTool。

对 Designer 功能的更改

使用 4.1（或以前）版本的 Designer Deep Learning 插件构建的项目与 Cognex Deep Learning 插件不兼容。要强制使用正确的插件，请使用 Designer 实用程序中的项目插件配置器。

不能在 Designer 中进行训练，可以导入从 Cognex Deep Learning Studio 1.0 中创建的 Cognex Deep Learning Studio 运行时工作区（.vrws 文件）并处理图像。

运行时块仅包含一个输出识别码。工具链中的各个工具在 UI 中不可见。而且，没有预置的结果识别码，因此您需要为每个应用程序编写脚本。

Deep Learning 运行时块不支持外部定位特征。

3.4.1 → 4.1

对特征过滤器语法的更改

在 VisionPro ViDi 4.1.0 版本中，特征过滤器处理工具参数的语法已被修改。如果在表达式中使用了 width 和 height，则现在必须用 view 进行限定，如 view.width 和 view.height。

例如，在版本 3.2 和更早版本中，用于将找到的特征限制为那些特征中心位于 ROI 内的特征的语法应该如下： 

x < width and x > 0 and y > 0 and y < height

在 VisionPro ViDi 4.1.0 及更高版本中，该语法现在必须表示为以下形式：

x < view.width and x > 0 and y > 0 and y < view.height

3.4 → 3.4.1

对叠加图形查看方式的更改

在 VisionPro ViDi 3.4.1 版本中，用于显示和隐藏图像显示区域中的重叠图形的快捷键已更改。新的按键如下：

• Alt 键加右箭头键或 Alt 键加左箭头键

这些按键用于循环通过显示图形（标签、标记、标签和标记，或无叠加图形）的可用组合。

在以前的版本中，空格键可用于显示或隐藏所有叠加图形，但现在不再受支持。

3.3 → 3.4

对工具训练工作流的更改

在 VisionPro ViDi 3.4.0 版本中，有一种新方法可用于指定将用于训练工具的图像/视图。如果要重新训练在先前版本中训练过的工具，则需要通过“选择训练集”对话框配置工具，以使用新的训练集范例。请参阅每个工具的额“训练神经网络”一节。

C 库叠加函数弃用

VisionPro ViDi 提供两种机制，即 C API 和 .NET API，用于显示结果图形。但是，此版本弃用以下 C 库叠加图形函数，并将在以下版本中删除：

• vidi_training_tool_get_overlay ();
• vidi_runtime_sample_get_overlay ();
• vidi_runtime_get_overlay ();
• vidi_training_sample_get_overlay();

要在将来访问叠加图形，您需要使用 CognexDesigner、.NET API 或 In-SightVisionPro ViDi。

3.2 → 3.3

• 不支持导入使用 2.1 及更早版本创建的工作区存档。如果您要从 VisionPro ViDi 套件版本 2.1 或更早版本迁移，您必须首先使用 VisionPro ViDi 版本 3.0、3.1、3.2 或 3.2.1 导入工作区然后导出，然后才能将它们导入 VisionPro ViDi 3.3.0。

• VisionPro ViDi 3.3.0 要求使用 411.31 及以上的 NVIDIA 驱动程序版本。

  要获取更新的 NVIDIA 驱动程序，请访问：https://www.nvidia.com/download/find.aspx

  有关 VisionPro ViDi 驱动兼容性的更多信息，请访问：https://support.cognex.com/en/downloads/detail/deep-learning/3763/1033

• VisionPro ViDi 3.3.0 中的客户端/服务器功能已更新为使用 HTTP 通信协议，不再支持 TCP 协议。要在客户端/服务器应用程序中使用新的 HTTP 协议，必须将客户端和服务器都升级到 VisionPro ViDi 3.3.0。软件没有跨版本客户端/服务器兼容性（例如运行 3.2.1 的客户端只能连接到运行 3.2.1 的服务器，运行 3.3.0 的客户端只能连接到运行 3.3.0 的服务器。

  Note: HTTP 通信通常为运行时图像处理提供更好的吞吐量。但是，对于高延迟网络拓扑，HTTP 通信可能会增加训练和开发过程中的接口延迟。

3.1 → 3.2

C 库函数弃用

一系列 C 库函数被弃用，如下所示：

• 运行时函数

  Note: 弃用的函数位于新的 vidi_runtime_legacy.h 头文件中。

  先前版本	新版本
  vidi_runtime_get_overlay	不可用
  vidi_runtime_process_sample	vidi_runtime_sample_process
  vidi_runtime_get_image	vidi_runtime_sample_get_image

• 训练函数

  Note: 弃用的函数位于新的 vidi_training_legacy.h 头文件中。

  先前版本	新版本
  vidi_training_stream_process_sample	vidi_training_sample_process
  vidi_training_blue_add_feature	vidi_training_blue_set_feature
  vidi_training_blue_add_model	vidi_training_blue_create_model
  vidi_training_tool_set_mask	vidi_training_roi_set_mask
  vidi_training_tool_get_mask	vidi_training_roi_get_mask
  vidi_training_ini_sample	vidi_training_add_sample
  vidi_training_process_sample	vidi_training_sample_process

NuGet 包弃用

NuGet 包已被弃用，并且不再包含在 VisionPro ViDi 安装程序中。如果您有从早期 VisionPro ViDi 版本引用 NuGet 包的运行时和/或训练应用程序，您需要删除这些引用，并将其替换为对 .NET .dll 库的引用。

要在 Visual Studio 中删除 NuGet 包，请选择工具 -> NuGet 包管理器 -> 管理解决方案的 NuGet 包...

要在项目中添加 .NET .dll，请右键单击并选择添加 -> 参考。

VisionPro ViDi 3.0 → 3.1

对于蓝色定位工具，使用模型匹配时，X 和 Y 位置夹紧的行为发生了变化。在 VisionPro ViDi 2.1 版中，这些约束条件被解析，以应用于模型坐标原点的位置。在 VisionPro ViDi 3.0 版中，它们被解释为对模型中节点的质心位置的约束。