图表定义实用程序是 Imatest Master 中的一个独立图形用户界面窗口，它可以帮助创建和验证供任意图表模块使用的图表定义 JSON文件。该实用程序提供的主要服务包括：
- 指出图表定义 JSON 构造中的错误，包括语义错误（例如，无效的值类型）和语法错误（例如，缺少逗号）。
- 根据提供的定义，显示图表设计的示意图，以便快速进行视觉验证。
- 将图表设计与图表的实际照片进行对齐，以展示该图像中图表设计所产生的投资回报率（ ROI ，即兴趣区域）。
该实用程序可以帮助用户完成图表设计过程，例如，通过说明图表图像中生成的 ROI 与其他图表特征如果距离太近可能会重叠。
它还可以辅助创建图表定义文件（这是流程中的一个不同步骤），通过验证 JSON 文件是否具有正确、可解析的结构以及每个字段的值是否合适。该实用程序能够提供关于 JSON 定义文件中错误性质的反馈，帮助用户迭代并纠正定义中的技术问题。
打开图表定义实用程序
海图定义实用程序在 Imatest Master 5.0 及更高版本中可用。可以直接从 Imatest 主窗口的“实用程序”面板中的“海图定义实用程序”按钮访问它，或者通过菜单栏“实用程序”下拉菜单中的相同选项访问它。
也可以从任意图表模块窗口的“图表定义”窗格中打开该实用程序。如果已在此窗格中选择了图表定义文件，则该文件将在实用程序窗口打开时预先加载（无论任意图表是否已成功读取该文件）。
图表定义验证
实用工具窗口的顶部窗格用于验证图表定义 JSON 文件的有效性。
有效的图表设计图示
如果选定的文件是有效的图表定义，则会向用户显示图表设计的渲染图。这可用于快速直观地检查其正确性。
需要注意的是，这只是根据所提供的定义绘制的图表示意图。它可能无法完全匹配实际打印的测试图表上的每个特征（该定义文件用于分析这些特征），它只会根据定义文件绘制出已知的概念性示意图。
显示选项
- 用户可以选择在渲染图上以红色轮廓线显示禁区。这些特征（用于识别图表上 Imatest 无法分析的区域，仅用于从图表背景区域进行均匀性分析）有时会使图表显得杂乱，因此提供了关闭其显示的选项。
- 要素索引可以显示在每个要素的渲染图上方，方便用户将绘制的要素与相应的图表定义文件条目关联起来。每个要素上方显示的数字是该要素在要素数组中的“ind”字段值。请注意，每个要素类型的索引值都从 1 开始递增。
无效的图表设计消息
如果所选文件不是有效的图表定义文件，则可能是以下两种原因：输入的参数和值不符合图表定义页面上列出的规则，或者该文件甚至不是有效的、可解析的 JSON 结构。
Imatest 会显示一条红色消息，描述遇到的问题，希望这条消息足够清晰易懂，方便用户在图表定义文件中查找并纠正问题。如果存在多个问题，则只会报告第一个遇到的问题，直到该问题得到解决。
图表定义问题
如果图表定义文件（JSON 格式正确）不符合任意图表定义规则，系统会生成提示信息引导用户纠正错误。例如，如果文件缺少必需的“name”字段，则会显示以下信息：
图表定义错误的来源包括缺少必填字段和字段值类型不正确，例如，在需要数值的字段中输入了字符串。
解析问题
导致 JSON 无法解析的错误可能有很多。例如，可能缺少逗号、用于标记数组结尾的右括号或冒号。也可能存在无效字符，例如字符串中使用了单引号而不是双引号。（还有许多其他可能的错误。）
遗憾的是，由于解析错误类型繁多，Imatest 在显示解析错误信息方面作用有限。有些问题，例如缺少逗号或数组缺少右括号，可以得到明确的提示。
然而，有时错误信息只会显示“位置 X 处缺少值”，并显示缺失值的上下文片段。用户需要根据这些信息自行查找 JSON 结构错误。在这种情况下， JSON Lint等在线工具可能会提供更有用的信息。
样本区域检测
图表定义实用程序窗口的下部窗格允许查看图表定义文件中定义的特征与图表实际图像的对齐情况。
此面板对于测试特定图像是否能通过 Imatest 的自动配准功能也非常有用，无需直接将图像输入分析模块。如果自动检测失败，则会弹出警告窗口。
当在此窗格中选择图像文件，并在顶部窗格中加载有效的图表定义文件时，图表将自动与图像对齐（如果可能）。
用户可以选择多个图形引导，这些引导可以使用提供的定义文件来验证图像中检测到的 ROI。
- 图表特征轮廓，以红色高亮显示
- 可分析的投资回报率轮廓（源自各项特征），以绿色高亮显示
- 图表背景网格的均匀性
- 图表背景（用于均匀性网格分析）的像素位置，以蓝色突出显示
绿色方框区域所示的感兴趣区域 (ROI) 指示了任意图表模块分析程序将使用的区域。例如，您可以更改不同特征类型的填充因子INI 字段设置（例如， [arbcharts] roiFillFactor_edge ），并查看它将如何影响从给定图像生成的 ROI。
标记为蓝色的像素表示图表背景区域，这些像素位于图表边界内，但不在图表要素或禁区内。像素与这些区域（边界、要素或禁区）之间的边距由 INI 字段[arbcharts] backgroundMargin决定。
均匀性网格位置会以绿色（如果该区域有足够的有效图表背景像素进行测量）或红色（如果没有足够的有效像素）突出显示。红色区域的输出结果将返回 NaN 值。网格部分的数量由[arbcharts] nRowsGrid和nColumnsGrid控制，区域内所需的有效像素数量由[arbcharts] minValidPxGrid控制。
功能概述与投资回报率概述
该工具还展示了图表特征与由该特征生成的ROI之间的区别。例如，在真实图像中检测到的倾斜正方形特征与由该特征生成的四个倾斜边缘 ROI 截然不同。