# 设置参数搜索测试

Note: 可以加载以前配置和保存的参数搜索数据 XML 文件，并按下加载按钮，从而将其作为新测试的基础。

1. 从工作区下拉菜单，选择要加载的工作区。加载的工作区将包含该工作区中的所有已配置的流和工具。

   Note: 实用程序自动指向存储 Cognex ViDi Suite 工作区的路径。如果要使用其他目录中的其他工作区，请按“导入”按钮以加载该工作区。
2. 从流下拉菜单，选择要测试的流。
3. 从工具中选择工具。
4. 在表格中，选择要测试的参数。点击参数字段，将弹出一个下拉菜单，您可以在其中滚动浏览完整的工具参数列表。
5. 如果您只想改变处理参数，同时在多次迭代中保持训练参数相同，勾选仅处理复选框（默认为禁用）。

6. 在值字段，输入要测试的参数值组合。

   Note:
   - 要输入其他参数，请在添加值后按 Enter 键。
   - 输入值后，值字段以红色标出，则表明语法中有错误。

   参数 | 工具 | 数据类型 | 示例
   --- | --- | --- | ---
   AspectRatio | 全部 | 双 | 语法是一个 0 到 100（其中 0 = 关闭）的数字，设置后将显示为百分比。 如果要测试 0%、2% 和 5%，则应输入：0 2 5
   BorderType | 全部 | 枚举：黑 白 反射 封装 复制品 | 语法是参数设置的名称。 如果要测试黑色和复制品，请输入：黑色 复制品
   容量 | 红色分析 - 无监督模式 | 枚举：巨大 大 中 小 微 | 语法是参数设置的名称。
   居中 | 红色分析 | 布尔型 | 语法是布尔状态，即 True 或 False。 如果要测试这两种状态，请输入：True False
   ColorChannels | 全部 | Int32 | 语法是 1 到 4 的 32 位整数。 如果要测试灰度 BGR 和 BGR(A)，请输入：1 3 4
   对比度 | 全部 | 双 | 语法是一个 0 到 100（其中 0 = 关闭）的数字，设置后将显示为百分比。
   CountEpochs | 全部 | Int32 | 语法是 1 到 1000 的 32 位整数。
   独占 | 绿色分类 | 布尔型 | 语法是布尔状态，即 True 或 False。
   FeatureFilter | 蓝色定位 蓝色读取 | 字符串 | 语法是表示要使用的筛选条件的字符串。 要筛选出中心位于 ROI 内的特征，请在 [0,width] 中输入 x，在 [0,height] 中输入 y
   FeatureSize | 全部 | 大小 | 如果要测试 90、100、110 的组合，请输入：90x90 100x100 110x110
   翻转 | 全部 | 枚举：无 水平 垂直 两者 | 语法是参数设置的名称。
   GenerateLowPrecisionModel | 绿色分类 红色分析 | 布尔型 | 语法是布尔状态，即 True 或 False。
   InvertContrast | 全部 | 布尔型 | 语法是布尔状态，即 True 或 False。
   KeepTrainSelection | 全部 | 布尔型 | 语法是布尔状态，即 True 或 False。
   LowPrecision | 绿色分类 红色分析 | 布尔型 | 语法是布尔状态，即 True 或 False。
   亮度 | 全部 | 双 | 语法是一个 0 到 100（其中 0 = 关闭）的数字，设置后将显示为百分比。
   MaskingMode | 全部 | 枚举：透明遮蔽叠加 | 语法是参数设置的名称。
   OrientedFeatures | 蓝色定位 蓝色读取 | 布尔型 | 语法是布尔状态，即 True 或 False。
   精度 | 蓝色定位 | 双 | 语法是一个 0 到 100（其中 0 = 关闭）的数字，设置后将显示为百分比。
   RegionFilter | 红色分析 | 字符串 | 语法是表示要使用的筛选条件的字符串。
   旋转 | 全部 | 间隔列表 | 语法为 [low,high]，其中“low”和“high”为数字。要输入一系列间隔，请将值放在括号中，中间以空格分开。 如果要测试 (0°, 90°)、(5°, 110°) 和 (-5°, -90°) 的旋转间隔，请输入：[0,90] [5,110] [-5,-90]
   SamplingDensity | 全部 | 双 | 语法是一个 0 到 100（其中 0 = 关闭）的数字，设置后将显示为百分比。
   SamplingIterations | 红色分析 | Int32 | 语法是 1 到 10 的 32 位整数。
   比例 | 全部 | 双 | 语法是一个 0 到 100（其中 0 = 关闭）的数字，设置后将显示为百分比。
   ScaledFeatures | 蓝色定位 蓝色读取 | 布尔型 | 语法是布尔状态，即 True 或 False。
   剪切 | 全部 | 双 | 语法是一个 0 到 100（其中 0 = 关闭）的数字，设置后将显示为百分比。
   SimpleRegions | 红色分析 | 布尔型 | 语法是布尔状态，即 True 或 False。
   阈值 | 全部 | 双 | 语法是一个 0 到 100（其中 0 = 关闭）的数字，设置后将显示为百分比。
   TrainingPasses | 红色分析 - 无监督模式 | Int32 | 语法是 1 到 3 的 32 位整数。
   TrainSelection | 全部 | 双 | 语法是一个 0 到 100（其中 0 = 关闭）的数字，设置后将显示为百分比。
   UseBaseline | 红色分析 | 布尔型 | 语法是布尔状态，即 True 或 False。

7. 在运行字段，输入要执行的迭代次数。多次迭代将提供更多的统计分析，例如均值、中位数和标准差，但也需要更多的时间来执行。
8. 如果要在训练/过程循环之间重置（即取消训练）工具，则勾选重启复选框（默认为禁用）。
9. 如果您不希望训练选择参数之间的拆分发生变更，则使保持训练选择保持启用状态。否则，请禁用该复选框。
10. 如果要将工具导出到包含参数搜索实验文件的目录，则勾选保存工具复选框（默认为禁用）。
11. 筛选条件字段用于创建显示筛选条件。默认情况下，它设置为没有训练。

12. 按下 Init 按钮初始化参数设置，然后参数设置将显示在结果表格。这也将启用开始按钮。

    Note: 如果您对参数及其设置进行了其他更改，则需要再次按 Init 按钮更新参数和值。

13. 按下保存按钮以保存参数搜索数据 XML 文件。

    Note: 如果您尚未保存文件，在按开始按钮时，将自动提示您保存参数搜索数据文件。

14. 按下开始按钮以开始计算参数设置。

    一旦测试开始执行，实用程序将在应用程序的左下角指示测试的剩余时间。

15. 测试完成后，可以查看结果，从而确定参数设置的最佳组合。