免费空间注册网站自媒体人专用网站

免费空间注册网站,自媒体人专用网站,微信上做网站编辑,9951026企业邮箱888HALCON算子 get_metrology_object_num_instances 全解析 一、算子核心定位 get_metrology_object_num_instances 是HALCON 2D计量#xff08;2D Metrology#xff09;模块的结果统计类核心算子#xff0c;核心功能是获取指定计量对象经apply_metrology_model检测后实际得到的…HALCON算子get_metrology_object_num_instances全解析一、算子核心定位get_metrology_object_num_instances是HALCON 2D计量2D Metrology模块的结果统计类核心算子核心功能是获取指定计量对象经apply_metrology_model检测后实际得到的“实例数量”即检测到的目标数量。它是统计2D计量模型检测结果数量的关键工具默认情况下每个计量对象最多仅返回1个实例需提前配置参数才能检测多个常用于判断目标是否被检测到、或统计同类型目标的数量。二、算法核心原理句柄与索引校验验证输入的计量模型句柄MetrologyHandle有效性并解析Index参数确定要查询的计量对象范围all遍历所有指定索引则仅处理对应对象实例数读取针对每个指定的计量对象读取其经apply_metrology_model检测后实际生成的实例数量未执行检测则为0结果返回将每个计量对象的实例数按Index的顺序封装为数组输出到NumInstances参数无修改逻辑仅读取实例数统计结果不改变计量模型/对象的任何属性或检测结果。三、参数全详解一输入参数Input Parameters参数名类型功能说明默认值关键取值规则注意事项MetrologyHandlemetrology_model → (handle)指定要查询的2D计量模型句柄-必须为已有效创建/加载的计量模型句柄1. 需通过create_metrology_model/read_metrology_model生成且未被clear_metrology_model释放2. 无效句柄直接触发“句柄无效”异常Indexinteger(-array) → (integer / string)指定要查询的计量对象索引0可选值▪ ‘all’查询模型内所有计量对象的实例数▪ 整数/整数数组查询指定索引的计量对象如0、[0,1]1. 整数索引必须是get_metrology_object_indices返回的有效索引2. 若Index为数组NumInstances会按相同顺序返回对应实例数二输出参数Output Parameters参数名类型功能说明关联说明NumInstancesinteger(-array) → (real / integer)返回指定计量对象的实例数量数组1. 顺序与Index完全对应Index为all时顺序与get_metrology_object_indices返回的索引一致2. 未执行apply_metrology_model时返回03. 默认最大值为1需提前设置num_instances参数才能返回更大值四、使用关键注意事项执行时序约束必须在调用apply_metrology_model执行检测后调用本算子否则NumInstances返回0若检测未找到目标也会返回0默认实例数限制每个计量对象默认参数num_instances1因此默认情况下NumInstances最大为1若需检测多个同类型目标如图像中有3个圆需提前通过set_metrology_object_param将该计量对象的num_instances设为更大值如5或all多线程特性多线程类型可重入能与非排他算子并行运行多线程范围全局可从任意线程调用无并行优化仅单线程读取数据无性能加速Index与NumInstances的对应性若Index为单个整数如0NumInstances为单个数值若Index为数组如[0,1]或allNumInstances为同长度数组顺序严格匹配返回值规则执行成功返回2H_MSG_TRUE参数无效如索引错误、句柄无效时直接抛出异常。五、算子调用链路一前置算子Possible Predecessorscreate_metrology_model创建空的2D计量模型基础前置add_metrology_object_*如add_metrology_object_circle_measure向模型添加计量对象set_metrology_object_param可选设置计量对象的num_instances参数如需检测多个实例apply_metrology_model执行边缘检测与实例拟合获取实例数的必要前置get_metrology_object_indices获取有效计量对象索引可选用于精准指定Index。二后置算子Possible Successorsget_metrology_object_result根据实例数读取每个实例的几何参数如圆的圆心、半径clear_metrology_model释放计量模型句柄收尾操作dev_print_var打印实例数用于结果校验或日志输出。六、与相似算子的核心差异算子名称核心区别适用场景get_metrology_object_num_instances返回计量对象的检测实例数量目标个数统计检测到的目标数量、判断目标是否存在get_metrology_object_indices返回计量模型中计量对象的索引列表定位要操作的计量对象get_metrology_object_measures返回计量对象的测量区域轮廓边缘原始坐标调试测量区域、验证边缘检测原始结果get_metrology_object_result返回每个实例的几何拟合结果如圆心、尺寸获取目标的具体测量参数八、总结关键点回顾get_metrology_object_num_instances核心作用是统计计量对象经apply_metrology_model检测后的实例数量未检测/未执行检测时返回0默认每个计量对象最多返回1个实例需提前用set_metrology_object_param设置num_instances为更大值或all才能统计多目标NumInstances的顺序与Index严格对应可据此精准读取每个计量对象的检测结果数量。