Skip to content

Flow 转换与校准节点 ​

数据转换节点位于 FlowEngineLib,使用模板编辑器的校准节点位于 Engine 的 FlowProcessing/Nodes/Compatibility/Calibration/;相关选择器和校准设备服务由 Engine 提供。

单输入“校正”节点(CalibrationNode)在新建节点菜单的“相机”分类下;节点类型标识、参数和旧流程加载保持兼容。

CalibrationNode 和原“实时关注点算法”(RealPOINode)复用服务节点的内部执行交接链路。校正服务显示配置中的“使用本地校正”开启时,旧节点分别把参数和输入转交给现有的 LocalCalibrationNode / LocalRealPoiNode,图像加载、计算、入库及通知均复用本地节点实现;关闭后两者使用原 MQTT 请求。切换只影响后续请求,已经开始的调用保持所选后端;内部失败不会再次发送服务请求。本地分支等待调用完成或流程停止,不使用服务节点的最大超时。

单输入“关注点算法”(POINode)沿图像输入分支查找最近的相机,跟随相机实际后端:本地相机会话或关闭后选择本地打开时,将所选 POI 模板和图像输入交给现有 LocalPoiNode;相机仍由服务持有时继续使用原算法服务。显式本地相机节点也使用内部测量;无法确定唯一上游相机时保留原服务路径。本地分支直接消费当前内存帧,或读取显式图像文件,不要求生成 .cvcie;POI 主从表、结果类型与下游交接沿用本地节点。过滤、修正、亚像素和文件输出设置保留但不参与本地测量,内部失败不补发服务请求。此路由不依赖“使用本地校正”开关。

实时关注点从 IN_CIE 沿图像分支查找最近的校正服务;直接相机输入通过物理相机关联校正服务。没有对应上游设备时使用默认校正服务,或唯一的校正服务;无法唯一确定时使用原服务。多个校正服务的开关分别生效。原节点类型、输入端口及参数保存格式保持不变,校正结果类型仍为 30。本地实时关注点按实际明细使用三通道 POI_XYZ=1 / 单通道 POI_Y=2,入库主表、流程输出、通知及下游关注点分析均使用同一类型;不能为兼容旧节点而覆盖成服务端 RealPOI=18,否则下游可能将已有点误判为空。原服务分支继续沿用服务返回的结果类型。

校正并实时测量上游 POI 使用本地 LocalCalibrationRealPoiNode(“本地设备 → 校正+实时 POI”),图像接 IN_IMG,布点结果接 IN_POI。迁移旧服务端双输入节点时,手动替换并重新选择校正资源、核对连线。外部 CVRAW 曝光全零的兼容条件见校正专题。 Flow 本地校正

“灯珠定位”输出运行内存点集时,应使用单输入本地 POI,或分开校正后接本地实时 POI;这些分支不创建 POI 模板或逐点结果记录,可选本地 CSV。原“关注点算法”和“实时关注点算法”直接连接灯珠定位节点时也转为本地执行。该例外及运行期句柄的消费范围见本地灯珠分析;普通数据库布点结果仍沿用上文的持久化链。

该节点直接按 IN_POI 提供的点位、形状和尺寸测量,输入点位须对应当前图像坐标。旧流程保存的 UseROI 字段在加载时忽略,重新保存时不再写入;之前依赖全幅坐标转换的流程,需在上游布点时提供当前图像坐标。物理相机 ROI 采集及校正文件区域匹配仍由相机和本地校正链路负责。

本地“关注点布点(Re)”沿用 POI 模板中的点名。旧流程保存的 PrefixName 在加载时忽略,重新保存时省略。按带前缀点名匹配的下游需改用模板点名。

节点诊断将重映射布点分成 LoadPoiTemplate、ResolvePoiLayout、RemapPoi、PersistPoiLayoutMaster 和 PersistPoiLayoutDetails。下游读取已保存的点位时,ReadPoiLayoutDetails 记录 MySQL 明细查询。使用旧版布点文件时还会记录 FindPoiLayoutFiles,实际解析的文件分别记为 ReadPoiLayoutFile。这些阶段已包含在节点的 ExecuteLocal 中。

先查什么 ​

现象第一检查点
数据转换不像文件转换器AlgDataConvertNode 只覆盖当前枚举和上游结果转换
图像转换输出不对ImageFormat、Channel、上游图像参数、输出文件名
校准模板面板不出现选中的 DeviceCalibration / DeviceCamera 是否有 PhyCamera
旧色差校正节点找不到节点已从目录隐藏;仅保留类型用于旧流程反序列化

真实入口 ​

能力节点/对象入口维护重点
数据转换AlgDataConvertNodeFlowEngineLib/Node/Algorithm/AlgDataConvertNode.cs发送 Math.DataConvert 到 Algorithm 服务
数据转换参数DataConvertDataDataConvertData.csMethodType、InType、OutType、TemplateParam
图像转换AlgorithmImageConvertNodeAlgorithmImageConvertNode.cs发送 Image.Convert
图像转换参数AlgorithmImageConvertParamAlgorithmImageConvertParam.csResultImageFormat、ResultDataFileName、Channel
单输入校准CalibrationNodeColorVision.Engine/FlowProcessing/Nodes/Compatibility/Calibration/CalibrationNode.cs输入图像和校正模板
校准 ROICalibrationROINodeNode/Camera/CalibrationROINode.cs发送 SetROI,不执行完整校准
旧色差校正AlgorithmCaliNodeNode/Algorithm/AlgorithmCaliNode.cs不提供新建入口,仅兼容旧流程解析

节点矩阵 ​

节点operatorCode服务/设备参数对象
AlgDataConvertNodeMath.DataConvertAlgorithm 默认服务DataConvertData
AlgorithmImageConvertNodeImage.ConvertAlgorithm 默认服务AlgorithmImageConvertParam
CalibrationNodeCalibration所选 Calibration 服务的本地偏好决定内部调用或 MQTTCalibrationData
CalibrationROINodeSetROICalibration 默认服务CalibrationSetROIParam
AlgorithmCaliNodeCaliAngleShiftAlgorithm 默认服务AlgorithmCaliParam

关键边界 ​

链路当前边界
数据转换CVDataConvertMethodType 当前很窄,不是任意文件格式互转
图像转换当前目标格式主要是 CSV、TIF;默认通道为 GREEN
单输入校准只执行图像校正,使用输入图像携带的曝光信息;服务端请求固定 IsSaveCIE=true;内部调用复用本地校正实现,保留完整 CIE 内存及本地结果交接策略
校准 ROI只设置 ROI,不保存校准结果文件
旧色差校正AlgorithmCaliNode 同时保留 STNode 和 Obsolete,由编辑器的 Obsolete 过滤隐藏但仍可反序列化旧画布

旧画布中单输入校准节点的 POI、曝光、文件输出模板及 IsSaveCIE 字段在加载时忽略,重存时不再写入;类型标识和端口连接保持兼容。请求不携带 POIParam、POI_MasterId 或 ExpTemplateParam,不会触发附带 POI 或曝光模板查找。输入图像须保留实际曝光信息;缺失时应在图像输入端补齐。本地校正节点不读取服务端 IsSaveCIE,CIE 生成和文件输出遵循本地执行策略。

原实时关注点的内部调用优先使用 IN_CIE 分支的内存帧,也能从图像结果或显式图像文件读取 CIE / 带色度参数的 RAW。POIType=None 沿用上游点形状和尺寸,普通点、圆和矩形按节点配置覆盖。过滤、修正、二次修正文件、亚像素、文件输出、POI 新增及色温/波长开关仅保留配置,内部测量忽略这些高级设置并计算可用色度指标;亚像素和键盘专用类型沿用上游点定义。关闭“使用本地校正”后,原服务请求继续携带全部原参数。需要这些高级能力时应关闭该开关。

历史循环校准节点仍可通过 CalibrationData.ExpTemplateParam 提供曝光参数,不受单输入校准节点的配置精简影响。

Engine 属性编辑器 ​

编辑器对应节点补充内容
CalibrationTemplatePropertiesEditorCalibrationNode 和相机节点根据节点设备和 PhyCamera 提供 TemplateCalibrationParam 选择
TextSelectFilePropertiesEditor校准节点选择图像路径

这些节点在属性上直接使用 PropertyEditorTypeAttribute 声明 FlowTemplatePropertiesEditors.cs 中的具体编辑器;模板控件复用 FlowNodePropertyEditorRegistration.cs 的构建方法,无需模板代理注册。

验收 ​

场景必验项
数据转换Math.DataConvert 收到上一步参数、MethodType 和 TemplateParam
图像转换Image.Convert 对已知图像结果输出 CSV / TIF,通道正确
单输入校准开关两侧均保留参数和结果类型;内部调用交接当前帧,服务请求固定 IsSaveCIE=true,不携带曝光或 POI 参数
实时关注点随图像分支的校正开关切换;双输入任意到达顺序均使用 IN_CIE 的帧;内部忽略高级设置,服务请求保留原字段
校准 ROISetROI 后设备端 ROI 更新
旧色差校正新建节点目录不显示;包含该类型的旧流程可正常反序列化

维护要求 ​

  • 新增转换类型时,同步枚举、算法服务解释、节点 UI、测试样例和本页矩阵。
  • 新增服务端校准字段时,检查 CalibrationData、CalibrationNode 和属性编辑器声明。
  • 修改 PhyCamera 关系时,回归校准模板选择器。
  • 新需求使用 JSON V2 或强类型模板规范。

验证入口与缺口 ​

真实设备、数据库入库和完整服务协议需独立集成验证。

基于 MIT License 发布。