流程管理

“流程”指基于VM的算法能力,由不同视觉功能模块按照指定的逻辑依次执行的视觉应用流程。

说明:

视觉功能模块包括采集定位图像处理测量逻辑工具通信等类型的模块。

本节内容包含:

流程操作

VM支持创建多个流程,各流程互不干扰。同时也可通过全局脚本数据队列全局变量设计跨流程的数据交互与执行逻辑。

创建流程

方案中默认已创建单个流程(未包含模块)。如果单个流程无法满足业务需求,可按需新建流程。

说明:

最多可创建64个流程。

  1. 在流程栏上单击添加流程。
    图 1 添加流程
  2. 为流程添加模块。
    • 选项1:右键单击流程编辑区,并从弹出的右键菜单中选择模块(见下图)。

      图 2 右键菜单选择模块
    • 选项2:按需从模块箱中选择模块,并拖入流程编辑区(见如下视频)。

  3. 按执行流程对模块进行排序,并建立模块间的连接(具体操作见如下视频)。
    说明:
    • 各模块的前后序模块以及多模块如何搭配使用相关详情,请参见模块介绍中的对应模块章节。

    • 如果在上一步拖入某个模块时与流程编辑区中已有模块垂直对齐,两者之间将自动连接。

  4. 可选操作: 进行如下可选操作。
    选项 描述

    删除连接线

    将光标悬浮至模块间的连接线,直至连接线略微增粗显示。此时右键单击连接线,并在弹出菜单单击删除

    删除模块

    右键单击某个模块,并在右键菜单选择删除

    禁用/启用模块

    右键单击某个模块,并在右键菜单选择禁用。模块被禁用后置灰。禁用后在右键菜单选择启用

    重新启用该模块。

    复制与粘贴模块

    右键单击某个模块,并在右键菜单选择复制。复制后再在需粘贴该模块的区域,右键菜单选择粘贴

    复制与粘贴参数

    如果存在两个相同模块(例如两个圆查找),可将其中一个的参数取值复制粘贴至另一个。

    1. 右键单击某个模块,并在右键菜单选择复制参数

    2. 右键单击“待复制参数取值”的相同模块,并在右键菜单选择粘贴参数

  5. 完成流程中各模块的配置。
    说明:

    模块配置详情,请参见模块介绍中的对应模块章节。

  6. 执行流程。
    • 选项1:单击快捷工具条上的单次执行流程。

    • 选项2:单击快捷工具条上的连续执行流程。

其他流程操作

可在流程栏上右键单击某个流程,并单击右键菜单上的选项进行其他操作。

图 3 右键菜单
表 1 其他流程操作

操作

描述

流程导出

单击右键菜单上的流程导出,将该流程(包括该流程的参数设置)以.Prc格式文件保存至指定的本地路径

流程拷贝

单击右键菜单上的流程拷贝,将选中的流程复制为新流程

删除

单击右键菜单上的删除,删除选中的流程

设置运行间隔

单击右键菜单上的设置运行间隔,在弹出窗口上设置流程连续执行时,前后两次运行的间隔时间(单位:ms)

流程执行NG时停止

将右键菜单上的流程执行NG时停止开启后,如果流程中的模块运行状态为NG,则停止执行流程

重命名

单击右键菜单上的重命名,对选中的流程进行重命名

设置流程超时时间

单击右键菜单上的设置流程超时时间,在弹出窗口设置选中流程单次执行的最大时间。如果该流程实际执行时间达到超时时长,该流程中当前正在执行的模块执行完毕后,该流程将停止继续执行并报错。超时时间默认为0,表示不限制流程执行时间

多流程配置

VM支持配置多个流程的异步执行逻辑。多流程异步执行适用于视觉检测时序复杂的业务场景。

说明:

VM也支持通过数据队列全局变量设计跨流程的数据交互与执行逻辑。

定义多流程执行逻辑

  1. 在流程栏单击显示当前已建立的所有流程、全局相机、以及数据队列
  2. 可选操作: 添加流程、全局相机或数据队列。
    选项 描述

    添加流程

    选项1:将光标悬浮至左侧的,直至其变为橙色,再将其拖入右侧的编辑区。

    选项2:在编辑区任意空白区域右键单击,并在弹出的右键菜单上选择工具 > 流程。如果本地路径中已有流程文件,也可在右键菜单上选择导入流程,将流程文件导入。

    添加数据队列

    选项1:将光标悬浮至左侧的,直至其变为橙色,再将其拖入右侧的编辑区。

    选项2:在编辑区任意空白区域右键单击,并在弹出的右键菜单上选择工具 > 数据队列

    可双击数据队列对其进行配置,详情参见数据队列

    添加全局相机

    选项1:将光标悬浮至左侧的,直至其变为橙色,再将其拖入右侧的编辑区。

    选项2:在编辑区任意空白区域右键单击,并在弹出的右键菜单上选择工具 > 全局相机

    可双击数据队列对其进行配置,详情参见配置全局相机

  3. 拖动上述任意实体,按需排布。
  4. 建立实体之间连接。

    连接方式与单个流程中的模块间连接相同。

    图 4 多流程连接
  5. 可选操作: 执行如下可选操作。
    选项 描述

    删除连接线

    将光标悬浮至实体间的连接线,直至连接线略微增粗显示。此时右键单击连接线,并在弹出菜单上单击删除

    执行单个流程的右键菜单操作

    右键单击某个流程弹出右键菜单,根据右键菜单选项执行流程导出、流程删除、流程拷贝粘贴等操作。详情参见其他流程操作

    配置单个流程

    单击某个流程上的配置该流程的输入参数、输出参数、运行参数和显示设置。详情参见配置单个流程

    执行单个流程

    单击某流程上的,分别执行一次或连续执行该流程。

    启用/禁用单个流程

    将某流程上的开关关闭,禁用该流程。禁用后,多流程异步执行时,该流程不执行,且软触发和硬触发对该流程均不生效;打开开关,重新启用该流程。

    返回单流程界面

    单击某流程上的,返回对应的单流程界面。

  6. 执行多流程。
    • 选项1:单击快捷工具条上的单次执行流程。

    • 选项2:单击快捷工具条上的连续执行流程。

    说明:
    • 当流程间连线不存在全局相机或数据队列时,流程按照连线顺序依次执行。

    • 当流程间连线存在全局相机或数据队列时,则每个流程均独立运行。

配置单个流程

可配置单个流程的输入参数、输出参数、运行参数以及需在图像显示窗口呈现的数据。

单击某个流程上的打开流程配置窗口,配置上述各类流程参数。

输入设置

输入设置页签选择前序流程输出的参数(可多选),作为当前流程的输入参数,供当前流程中的模块进行订阅。

支持的数据类型包括int、float、string、byte、pointset、IMAGE(图像)、PIXELIMAGE(像素图)、BOX(目标区域)、POINT(点)、LINE(线)、FIXTURE(修正信息)、ANNULUS(圆环)、CONTOURPOINT(轮廓点)、RECT(矩形)、CLASSINFO、POLYGON(多边形)、POSTURE(位姿)、ELLIPSE(椭圆)

图 5 输入设置
说明:

IMAGE或PIXELIMAGE类型的参数如果在此处勾选(如上图所示),则默认为需在图像显示窗口呈现的流程数据。

输出设置

输出设置页签选择当前流程下属模块的输出参数(可多选),作为当前流程的输出参数,输出至后序流程。

支持的数据类型包括int、float、string、byte、pointset、IMAGE(图像)、PIXELIMAGE(像素图)、BOX(目标区域)、POINT(点)、LINE(线)、FIXTURE(修正信息)、ANNULUS(圆环)、CONTOURPOINT(轮廓点)、RECT(矩形)、CLASSINFO、POLYGON(多边形)、POSTURE(位姿)、ELLIPSE(椭圆)

图 6 输出设置
说明:

IMAGE或PIXELIMAGE类型的参数如果在此处勾选(如上图所示),则默认为需在图像显示窗口呈现的流程数据。

运行参数

运行参数页签添加当前流程下属各模块的参数,作为当前流程的运行参数,方便后续快速查看或修改这些参数。详情参见自定义流程运行参数

显示设置

显示设置页签设置当前流程执行完成后,需在图像显示窗口呈现的数据。

说明:

如下图所示,输入设置输出设置页签中添加且勾选的类型为IMAGE或PIXELIMAGE的参数,在显示设置页签中默认关联,作为需在图像显示窗口呈现的数据。如无需呈现,请前往输入设置输出设置页签,不勾选对应参数。

图 7 显示设置

如下示例展示了运行多流程后,全局图像的显示效果示例。根据该示例中的显示设置,全局图像中显示的数据包括输出图像圆心点轮廓点卡尺检测区显示文本

图 8 显示设置效果示例

自定义流程运行参数

可自定义当前流程的运行参数,方便后续快速查看或修改这些参数。

  • 已完成当前流程各模块配置。

  • 已进入流程配置窗口(单击多流程中某个流程上的进入)。

  1. 在流程配置窗口选择运行参数页签。
  2. 单击编辑打开配置窗口。
  3. 可选操作: 在如下图所示的下拉列表处,选择参数数据类型(默认为全部)。
    图 9 选择数据类型
  4. 展开选择列表中的可选项,并单击将对应参数添加至右侧的已选择参数列表。
    说明:
    • 首次添加参数时,该参数自动添加至首个分组。首个分组默认名称为“分组0”,可自定义。

    • 如需将参数添加至其他分组,可先单击右上角的添加分组,再添加参数。最多可添加32个分组。

    • 存在多个分组时,需先选中分组,再添加参数。选中的分组显示在橙色矩形框中,如下图所示。

    图 10 配置窗口
  5. 可选操作: 执行如下可选步骤。
    选项 描述

    删除分组/参数

    单击删除对应分组或参数。

    修改分组/参数排序

    单击将对应分组或参数在列表中上移。

    单击将对应分组或参数在列表中下移。

    清空列表

    单击右上角的清空,将已选择参数列表清空。

    修改订阅数据

    单击修改已添加参数订阅的数据(即修改该参数绑定的数据)。

    说明:

    如果修改后,订阅的数据源数量为两个或两个以上(例如下图所示的情况),那么需在修改后单击数据同步列的进行数据同步,使修改生效。

    图 11 从订阅单数据源修改为订阅双数据源
  6. 单击配置窗口右下角的确定,返回运行参数页签。

    可在该页签内配置所选的运行参数。

    图 12 运行参数页签