VisionPro中文帮助_PMAlign

PMAlignEditControl本主题包含以下章节。ControlButtons(控件按钮)PMAlignEditControlBuffers(PMAlign编辑控件缓冲区)TrainParamsTab(TrainParams选项卡)TrainRegionandOriginTab(TrainRegionandOrigin选项卡)RunParamsTab(RunParams选项卡)SearchRegionTab(SearchRegion选项卡)GraphicsTab(Graphics选项卡)ResultsTab(Results选项卡)PMAlign编辑控件为CogPMAlignTool及其组件提供图形用户界面，此工具可用于训练样板，然后使用在连续的输入图像中搜索样板。可指定执行样板训练或样板搜索时要使用的算法类型，并可选择利用图像还是利用形状模型集合创建已训练样板。输入图像内的可选搜索区域可限制样板搜索的范围。PMAlign编辑控件的示例如下图所示：要在DevStudio.NET应用程序中包含此控件，必须先将其添加至VisualBasic项目工具箱。PMAlign编辑控件对象类型命名为CogPMAlignEdit。有关说明，请参阅主题“AddingEditControlstoVisualStudio”。PMAlign编辑控件包括以下组件：一排位于左上角的控件按钮。一个工具显示窗口，用于显示PMAlign工具的图像缓冲区：Current.TrainImage、Current.InputImage和LastRun.InputImage。这些缓冲区包含已训练样板，PMAlign工具在其中搜索样板的搜索图像，以及包含搜索结果的同一图像。右键单击工具显示可打开包括缩放图像或显示像素或子像素网格的菜单选项。一组按功能组织的选项卡。这些功能包括运行工具的参数设置、关注搜索区域的参数设置、工具显示的显示设置以及训练结果。按下Control+Tab键在选项卡组之间滚动。一个位于控件左下角的状态栏。绿色圆圈 表 关于同志近三年现实表现材料材料类招标技术评分表图表与交易pdf视力表打印pdf用图表说话 pdf 示工具已成功运行；红色圆圈表示工具未成功运行。状态栏还会显示运行工具的时间以及所有错误代码或消息。状态栏首次显示的时间是工具的原始执行时间。状态栏第二次显示的时间包含更新编辑控件所需的时间。ControlButtons(控件按钮)下表介绍了位于控件左上角按钮的功能。表1.控件按钮按钮说明Run（运行）PMAlign工具。必须具有已训练样板、输入图像以及指定的运行参数。PMAlign在输入图像中搜索已训练样板。您可以将样板搜索限制在输入图像内的某个搜索区域。切换为电动模式。将其选中后，如果更改了某些参数，PMAlign工具将自动运行。工具处于电动模式时，由出现的闪电图标指示这些参数。打开本地工具显示窗口，此窗口可显示Current.InputImage、Current.TrainImage或LastRun.InputImage缓冲区。打开一个或多个浮动工具显示窗口。可以显示Current.InputImage、Current.TrainImage或LastRun.InputImage缓冲区。与本地工具显示不同，您可以调整浮动工具显示窗口的大小或移动其位置。加载VisionPro固有(.vpp)文件，此文件包含该视觉工具对象类型的一组已保存属性。为其他对象类型加载固有文件时会出现错误，加载会失败。有关VisionPro固有功能的更多信息，请参阅VisionPro中的“Persistence”主题。将底层工具的当前属性保存至VisionPro固有文件。可以选择保存整个工具，也可选择保存不含其图像或结果的工具。将底层工具的当前属性保存至新的VisionPro固有文件。将底层工具重置为默认状态。打开ImageMaskEditor，以创建要添加至训练图像的掩模。打开单独的新结果窗口，不用转至Results选项卡即可查看运行结果。启动ModelMaker，以使用SyntheticPatMax编辑形状模型。启用或禁用此编辑控件中单个项目的工具提示显示。访问VisionPro的联机文档。PMAlignEditControlBuffers(PMAlign编辑控件缓冲区)PMAlign编辑控件具有三个图像缓冲区。其中两个缓冲区使用底层PMAlign工具的InputImage和TrainImage；第三个缓冲区显示运行PMAlign工具的最后一个输入图像以及该搜索的结果。全部三个缓冲区均可显示在本地和浮动工具显示窗口中。Current.InputImage为PMAlign工具提供输入图像。Current.TrainImage包含训练图像。LastRun.InputImage缓冲区显示最近运行此工具的最后一个图像。使用Graphics选项卡高亮显示搜索区域和搜索结果。运行PMAlign工具时，此工具为Current.TrainImage缓冲区的样板搜索Current.InputImage，然后将此搜索的结果存储在Results选项卡上。TrainParamsTab(TrainParams选项卡)使用TrainParams选项卡设置训练参数并训练搜索样板。单击选项卡最右端的AdvancedFeature按钮将显示不太常用的功能。表2.TrainParams选项卡功能功能说明Pattern显示利用图像或形状模型集合创建的已训练样板。这由TrainImage内以蓝色边框高亮显示的TrainRegion指定。可通过使用TrainRegionandOrigin选项卡或在Current.TrainImage中重新调整其显示大小来设置训练区域。选项卡底部的消息文本用于指示是否已训练PMAlign工具。LoadObjectFromFile打开扩展名为VPP的VisionPro固有文件，其包含已训练样板。SaveObjectToFile将当前已训练的样板保存到扩展名为VPP的VisionPro固有文件中。RunAlgorithm选择用于训练的搜索算法：PatMax：需要更长的执行时间，但更为准确，并且会返回额外的分数信息PatQuick：比PatMax快，但准确度较低PatMax和PatQuickPatFlex：查找已经历各种非线性变形的样板PatMax-HighSensitivity：适用于对比度很低或者视频噪音或图像变形严重的图像PerspectivePatMax：查找已经历透视失真的二维特征TrainMode选择是否应根据训练图像的像素内容或根据您使用建模器创建和修改的形状模型来训练PMAlign样板。IgnorePolarity如果启用，将忽略样板的极性。如果禁用，则只能找到极性与已训练样板匹配的样板。如果使用由形状模型创建的已训练样板并且其中有模型具有未定义的极性，则必须允许工具忽略极性。RepeatingPatterns当要训练的样板包含重复元素（例如网格、栏组或平行线样板）时，使用此参数。从Algorithm下拉列表中选择PatMax后，此参数才会生效。Train按照TrainImage中的TrainRegion或当前形状模型集合的具体说明训练所需样板。如果工具已经有已训练样板，将取消训练然后重新训练。样板训练成功后，控件底部的文本将显示“Trained”。GrabTrainImage按钮将InputImage缓冲区中的图像复制到TrainImage缓冲区。此按钮只在Current.InputImage中有图像时才会启用。如果利用形状模型和转换创建已训练样板，此按钮也不会启用。特征粒度限制如果未选中GrainLimitAutoSelect，将使用您提供的GrainLimitCoarse和GrainLimitFine粒度限制。Elasticity指定Elasticity属性，此属性为PMAlign工具允许的像素变量。通常，如果您希望运行时图像中的样板发生不同的变化，应指定非零的弹性值。AutoEdgeThresholdEnabled如果您希望为边缘幅度（下方的边缘方向将随机化）的绝对最小值设置不同的阈值，请禁用自动值。GetInfoStrings包含此样板信息的训练时诊断消息PCPString与此样板关联的PCP（PatMax可定制软件包）字符串。仅在加载PCP文件后显示，此文件为特定应用程序配置PMAlign参数。PCPLoadFromFile加载PCP文件。清除PCP清除从当前加载的PCP文件中所衍生配置的底层工具。TrainRegionandOrigin(TrainRegionandOrigin选项卡)使用TrainRegionandOrigin选项卡定义TrainRegion，此操作可定义成为已训练样板的TrainImage缓冲区的区域。您还可以图形方式定义Current.TrainImage缓冲区中的训练区域。首先以图形方式指定训练区域，然后使用此选项卡微调训练区域参数，这样可能会更容易。PMAlign编辑控件会更新训练区域值，以便此选项卡上的值与Current.TrainImage缓冲区中的训练区域形状始终匹配。可以度数（默认）或弧度指定此选项卡上的某些参数，如Rotation和Skew。底层工具始终使用弧度值，但编辑控件会在适当时会将它们转换成度数。表3.训练区域功能功能说明TrainRegionMode定义区域的限定框。PixelAlignedBoundingBox将已定义区域包围在矩形内。这表示包含位于已定义区域之外但位于限定矩形之内的图像部分。PixelAlignedBoundingBoxAdjustMask将已定义区域包围在矩形内，但会遮盖区域以外、外围矩形以内的图像部分，因此已定义区域更靠近您指定的区域。由于形状训练不支持PixelAlignedBoundingBoxAdjustMask，因此，利用形状模型集合来训练样板时，必须使用像素配对限定框。TrainRegion选择输入区域的形状。选择None=Useentireimage表示此工具使用整个输入图像。PMAlign工具支持以下输入区域形状：CogCircleCogEllipseCogPolygonCogRectangleCogRectangleAffineCogCircularAnnulusSectionCogEllipticalAnnulusSection所显示的区域定义参数集取决于所使用的区域形状。有关使用多边形作为输入区域的更多信息，请参阅主题“UsingPolygonInputRegions”。SelectedSpaceName解释训练区域的坐标空间。有关信息，请参阅“CoordinateSpaceNames”。利用形状模型和转换进行训练时，训练区域的所选空间名称将被忽略。SelectMode当RegionShape为cogRectangle或cogRectangleAffine时可用。选择用于定义矩形的参数集。如果选择cogRectangleAffine，请注意，旋转角度和倾斜角度可以度数或弧度指定，但底层工具始终使用弧度来作为度量。FitToImage使训练区域在Current.TrainImage内居中。表4.训练原点功能功能说明OriginXOriginYScreenX用于定义训练区域原点位置和方向的值。以图形方式修改原点时，这些值将改变。请注意，旋转角度和倾斜角度可以度数或弧度指定。相当于Origin属性。LenScreenAspectRotationSkewCenterOrigin将训练区域的原点置于训练区域的中心。RunParamsTab(RunParams选项卡)使用RunParams选项卡指定如何执行样板搜索。这些参数包括要使用的运行算法、阈值、限制、以及样板搜索期间允许的旋转角度和缩放比例。单击选项卡最右端的AdvancedFeature按钮显示不太常用的功能。表5.RunParams选项卡功能功能说明RunAlgorithm选择搜索算法。Patmax算法比Patquick更准确并且可返回额外的分数信息，但需要更长的处理时间。您也可以指定BestTrained，在此情况下，工具将使用已训练过的最高准确度算法来运行。如果为已训练算法指定PatMax-HighSensitivity，请指定PatMax或BestTrained。在任一情况下，都会使用PatMax高灵敏度模式。如果为已训练算法指定PerspectivePatMax，请指定PerspectivePatMax或BestTrained。RunMode默认情况下，PMAlign工具使用SearchImage模式为粗糙特征搜索整个图像，这些特征用于指示为了定位而训练的样板是否存在。切换至RefineStartPose模式，为此PMAlign工具提供特定StartPose，此StartPose是用于定义搜索起始位置的二维线性转换。此StartPose通常来自已执行并生成有关图像中已知特征的结果的其他视觉工具。注意：要使用RefineStartPose模式，必须添加输入终端以便为此PMAlign工具演示StartPose属性。CoarseAcceptThresholdPMAlign工具使用默认的CoarseAcceptthreshold，以根据样板的粗糙特征改进之前的搜索结果。可以启用CoarseAcceptthreshold并指定不同的值，迫使工具在每个运行时图像中考虑更多（较低值）或更少的（较高值）潜在匹配项。阈值不能超过Acceptthreshold的当前值。如果为CoarseAcceptthreshold设置的值高于Acceptthreshold，编辑控件将为Acceptthreshold自动校正值。ScoreUsingClutter如果选中，PatMax算法将在计算样板实例的分数时考虑无关特征或杂乱特征。考虑杂乱特征通常会导致分数较低。仅适用于PatMax算法。如果已训练样板由形状模型组成，您可能需要禁用此特征。ApproximateNumberToFind指定要查找的结果数。AcceptThreshold指定结果分数的接受阈值。仅接受分数大于或等于此值的结果。TimeoutEnabled如果选中，超时值将限制PMAlign 检测 工程第三方检测合同工程防雷检测合同植筋拉拔检测方案传感器技术课后答案检测机构通用要求培训 的执行时间。ZoneAngle指定PMAlign执行样板搜索时允许的旋转角度。您可指定PMAlign结果必须完全匹配的标称值，也可单击箭头来指定结果值的范围。ZoneScale指定PMAlign执行样板搜索时使用的缩放值。您可指定已搜索样板必须完全匹配的标称值，也可单击箭头来指定结果值的范围。ZoneScaleX指定PMAlign执行样板搜索时在X方向上使用的缩放值。您可指定已搜索样板必须完全匹配的标称值，也可单击箭头来指定结果值的范围。ZoneScaleY指定PMAlign执行样板搜索时在Y方向上使用的缩放值。您可指定已搜索样板必须完全匹配的标称值，也可单击箭头来指定结果值的范围。PartialMatchEnabled仅适用于PatFlex算法，PatFlex将查找仅与整个样板的某个部分匹配且分数高于AcceptThreshold的结果。PartialMatchCoverageThreshold仅适用于PatFlex算法，这将指定在有效的PatFlex结果中必须匹配的样板最小部分。GrainLimitsUsePattern如果选中，将使用通过训练样板确定的粒度限制。如果未选中，所指定的GrainLimitCoarse和GrainLimitFine值将生效。ContrastThreshold定义样板实例可接受的最小对比度。PMAlign仅考虑所有特征边界间的像素值平均差超出对比度阈值的样板实例。XYOverlap如果区域重叠的百分比大于XYOverlap，则候选结果在区域中重叠。如果两个样板实例在所有自由度以及指定重叠百分比区域重叠，PMAlign将放弃分值较小的样板实例。AutoEdgeThresholdEnabled如果您希望为边缘幅度（下方的边缘方向将随机化）的绝对最小值设置不同的阈值，请禁用自动值。如果使用PatFlex搜索算法，RunParams选项卡将显示多个不同的参数，如下所示：下表介绍了PatFlex算法的参数：表6.PatFlex参数功能说明Refinement在变形转换中完成的改进量。“None”值表示可能包含一些错误。花费更长时间可使较高水平的改进更加准确。MaxDeformationRate运行时图像中的预计最大deformation量。Smoothness在将变形转换与运行时输入图像进行拟合时使用的平滑度值。DeformationFit控制PatFlex将用于在运行时输入图像中进行模拟变形的拟合的类型。ControlPointsXX方向上的控制点数。控制点数增多后，转换能够使样板与严重局部变形（例如特征更加尖锐）区域的匹配度更高。ControlPointsYY方向上的控制点数。控制点数增多后，转换能够使样板与严重局部变形（例如特征更加尖锐）区域的匹配度更高。SearchRegionTab(SearchRegion选项卡)使用SearchRegion选项卡定义SearchRegionMode，即限制样板搜索的InputImage缓冲区区域。此搜索区域以蓝色边框显示在Current.InputImage中，您可以图形形式定义此缓冲区中的搜索区域。首先以图形方式指定搜索区域，然后使用此选项卡微调搜索区域参数，这样可能会更容易。重新调整InputImage中的搜索区域大小时，此选项卡上的值会变化；同样地，更改参数值会导致搜索区域改变其大小和形状。表7.SearchRegion选项卡功能功能说明SearchRegionMode定义区域的限定框。PixelAlignedBoundingBox将已定义区域包围在矩形内。这表示包含位于已定义区域之外但位于限定矩形之内的图像部分。PixelAlignedBoundingBoxAdjustMask将已定义区域包围在矩形内，但会遮盖区域以外、外围矩形以内的图像部分，因此已定义区域更靠近您指定的区域。区域以外计分参数选择FeaturesThreshold值，此值可指定已训练样板中可位于搜索区域以外且没有要罚分的特征的百分比。默认值0表示PMAlign工具希望已训练样板的所有特征位于搜索区域内，而值0.3表示已训练样板的最多30%部分可位于搜索区域以外且不会影响最终分数。如果您希望允许已训练样板中特征的某些部分存在于搜索区域以外，并且不会影响提供给此搜索区域仍包含特征的整体分数，请使用此功能。SearchRegion搜索区域的形状。选择“None=Useentireimage”表示整个Current.InputImage成为搜索区域。区域定义的参数集取决于所选的RegionShape。SelectedSpaceName解释搜索区域的坐标空间。有关更多信息，请参阅“CoordinateSpaceNames”。SelectMode当RegionShape为cogRectangle或cogRectangleAffine时可用。选择用于定义矩形的参数集。如果选择cogRectangleAffine，请注意，旋转角度和倾斜角度可以度数或弧度指定，但底层工具始终使用弧度来作为度量。FitToImage使搜索区域在Current.InputImage内居中。GraphicsTab(Graphics选项卡)使用Graphics选项卡选择LastRun.InputImage显示中显示的结果图形。表8.Graphics选项卡功能功能说明训练特征显示可在包含已训练样板的Current.TrainImage缓冲区中显示这些特征：显示按粗糙粒度限制训练的特征。特征显示为黄色。相当于CreateGraphicsCoarse 方法 快递客服问题件处理详细方法山木方法pdf计算方法pdf华与华方法下载八字理论方法下载 。显示按精细粒度限制训练的特征。特征显示为绿色。相当于CreateGraphicsFine方法。前述特征仅在成功训练样板时显示。显示形状模型。ShowSearchImageMask用于显示代表运行时掩模的图形（如有提供）。此图形显示在Current.InputImage显示中。ShowTrainImageMask用于显示代表训练时掩模的图形（如有提供）。此图形显示在Current.TrainImage显示中。Resultgraphicsdisplay可在LastRun.InputImage缓冲区中显示这些特征，LastRun.InputImage缓冲区包含PMAlign工具最后一次搜索的图像以及该搜索的结果。使用CreateResultGraphics方法生成这些结果。训练样板的原点训练样板的坐标轴。匹配区域。已找到特征的形状模型Diagnosticsdisplay显示LastRun.InputImage缓冲区中的以下特征。使用CreateResultGraphics方法生成这些结果。Showmatchfeatures用于显示已找到且曾用于匹配已训练样板的特征。不是所有已训练特征都可以显示出来。对于每个匹配的特征，图形颜色表示匹配质量（红色表示匹配较差，黄色表示匹配良好，绿色表示匹配非常好）。Showsearchregion用于显示Current.InputImage缓冲区或SearchRegion选项卡中定义的搜索区域。ShowDiagnosticSearchImageMask用于显示运行时掩模（如有指定）。ShowInputImage选项按钮用于指定为LastRun.InputImage显示输入图像的引用还是深层复制副本。您还可以指定不显示任何图像。ShowFlexDeformationGrid复选框将显示代表已计算的变形转换的网格。必须为运行时算法指定PatFlex，而且勾选此复选框后必须重新运行工具才能查看结果。ShowFlexUnwarpedImages复选框将显示输入图像的调正版本。在对应于已训练样板的区域内调正最准确。必须为运行时算法指定PatFlex，而且勾选此复选框后必须重新运行工具才能查看结果。ResultsTab(Results选项卡)Results选项卡显示最近的样板搜索结果。这对应于CogPMAlignResult界面。使用结果网格下面的滑块控件显示完整的结果集。表9.Results选项卡功能功能说明GetInfoStrings显示最后一个PMAlign结果的运行时诊断消息文本字符串。如果没有任何消息，此文本框为空。结果网格显示每个结果的以下信息。此结果的Score。范围为0.0至1.0，值越大表示越匹配。FitError，测量已找到的样板与已训练样板的特征的匹配度（不考虑缺失的特征）。范围为零（完美拟合）至无穷大（拟合很差）。仅用于PatMax算法。Coverage，在搜索结果中找到的已训练样板中特征的百分比。范围为0.0至1.0。仅用于PatMax算法。Clutter，结果中显示的无关特征数除以已训练样板中的特征数。范围为零至无穷大。仅用于PatMax算法。MaxCoarseAcceptThreshold，允许发现此结果的最大粗糙度接受阈值。使用GetPose方法检索坐标、角度和缩放系数。X和Y是在InputImage的所选空间中测得的样板原点的坐标。Angle是在InputImage的所选空间中测得的样板空间的旋转角度。Scale、ScaleX和ScaleY是样板空间与InputImage所选空间之间的缩放系数。