Screph 计算机视觉
在 Screph 中，您可以用示例图像配置处理：标注对象、选择操作和参数，并检查结果。准备好的素材可用于程序代码开发。
可用操作、标注类型和保存目标取决于程序模式。状态和限制见“程序模式”。
从示例标注到程序运行
在 Selector 的 Canvas 画布上选定对象，添加特征、描述及对象间的关系。主“计算机视觉”面板从当前画布视图接收所选区域的图像。以此为例配置如何查找或分析目标对象。需要时也可将整幅图像作为输入。
计算机视觉方法序列的可视化构建器可用于选择传统算法或可用的模型操作、修改参数，以及构建处理链或图。您可以自行配置处理，也可以使用已连接的智能体。Python 代码操作可包含自定义逻辑。基于数据集的模型训练在“训练”分区进行。
保存的对象、描述和选定材料会传递到 Screph Code。用户或编程智能体在此将配置好的计算机视觉流程与程序逻辑连接起来，包括获取新帧、调用已保存流程并使用其输出。在编辑器中可处理所选操作的代码，并添加自己的逻辑。
- 打开示例图像，标注所需对象，并选择要配置的区域。
- 请选择一个操作、处理链或处理图。
- 配置设置并运行预览。
- 比较原始素材、结果、掩码、轮廓和指标。
- 将所需结果附加到项目，或确认受支持的标注修改。
- 在其他帧上验证处理流程，保存项目，并在 Screph Code 中使用准备好的材料。
标注描述要查找的内容，配置好的处理流程确定查找方法。在新图像上验证，有助于在将方案用于程序前进一步调整。
来源和处理区域
操作接收活动图像或所选区域。请确认该区域属于正确的帧，并且缩放和坐标与画布显示一致。
结果可与原图并排显示、叠加在原图上，或作为独立掩码显示。选择视图不会更改已保存的标注。
操作类别
| 类别 | 示例 |
|---|---|
| 准备图像 | 亮度、对比度、模糊、调整大小、裁剪、旋转和几何校正。 |
| 边缘和区域 | 阈值、边缘、轮廓、连通分量、形态学和分割。 |
| 匹配和运动 | 模板匹配、比较、配准、光流和跟踪。 |
| OCR | 使用本地 Tesseract 安装进行文本识别。 |
| 模型类操作 | YOLO, SAM, OmniParser |
操作的实际可用性取决于已安装的组件、模型文件和所选程序模式。
一个操作
适用于一次转换或分析。更改参数后，请刷新预览并与原图比较结果。保存的参数属于所选操作和素材。
处理链
线性序列将每个步骤的结果传递到下一步。它适用于可预测的无分支处理，例如裁剪、对比度增强、阈值处理和边缘提取。
检查中间步骤：早期处理中的错误会影响所有后续结果。
处理图
处理图支持分支处理、合并兼容结果，以及选择单独的输出进行查看。只能在数据类型兼容的端口之间创建连线。
- 为步骤提供清晰的名称并分别测试每个输出。
- 对于复杂的图，从一个小的工作部分开始，逐渐添加分支。
- 实验图的可用操作可能与线性序列不同。
预览、保存并应用
| 操作 | 结果 |
|---|---|
| 预览 | 显示当前参数的处理结果，不更改主标注。 |
| 附加结果 | 将所选掩码、图像或其他结果保存在项目旁，并关联到对象。 |
| 应用变更 | 检查后，添加或修改受支持的主标注对象。 |
审查拟议的变更
操作建议可以接受、修改、拒绝或重新计算。应用前请检查源帧、对象边界、标注类型，并确认没有重复项。
Industrial 和 UAV 支持有限的领域修改，但仍处于实验阶段，尚不提供可直接用于生产的审查与导出流程。
视频和时序结果
对于视频和帧序列，操作可以生成随时间变化的观测数据和轨迹。请检查整个所选范围内的结果。
从界面隐藏结果并不一定会删除其文件。移动项目前，请检查关联的序列数据，并将所需结果与项目一同保存。
模型和依赖项
典型问题
- 结果为空：检查来源、处理区域和参数范围。
- 坐标不正确：检查缩放、裁剪和所选视图。
- 操作不可用：请检查依赖项和模型文件。
- 项目变得很大：删除不必要的临时结果，只附加必要的材料。
选择操作与结果的时效性
目录根据任务、输入和程序模式提供操作。操作卡片显示所需参数、模型和不可用原因。选择算法、设置步骤和开始运行是独立操作；安装模型不会自动开始处理。
更改来源、区域或参数后，需要重新运行才能应用结果。“停止”取消当前工作；早期运行的迟到响应不能更改当前标注。可以单独查看已保存结果，但查看不代表它适用于新帧。
比较方案时，请指定原始素材、操作和待调整的参数。在相同输入上比较结果，然后通过常规运行检查所选方案。还需使用独立数据评估；仅凭推荐或一张效果良好的图像并不足够。
帧序列：运行与结果
- 在 Capture 中选择来源和范围，然后打开“帧序列”。设置方向和帧步长。播放头的位置不能替代所选输入的起点。
- 选择操作后，其参数会在工作区内展开。跟踪器需要初始框，视觉里程计需要兼容的标定。解决列出的阻碍后，运行按钮才可用。
- 运行会固定输入和参数。执行时显示进度和“停止”。切换项目会取消当前工作；旧来源的结果不会转移到新选择上。
处理使用固定的帧范围。此流程不提供直接处理实时流、自动重试或多路流同步处理。应先在 Capture 中打开或录制来源。
结果可包含表格、图表、掩码、轨迹和变换。选择帧、帧对或窗口后，结果视图会与时间线关联。图像坐标与空间位姿不同；未定标的单目视觉里程计不能给出以米为单位的距离。
序列历史与 A/B 比较
可将已完成且仍有效的运行选为 A，再运行变体 B，并在同一固定输入上比较。结果字段、单位、坐标和时间必须一致。无法比较时会显示原因；不兼容的输出不会被转换成数值差。
“保存实验”关联两个运行及所选帧、帧对或窗口。保存项目后，可在历史中连同已验证的数据一起查看。查看旧记录不会重新运行处理，也不会自动修改编辑器参数。
参数更改后，历史数据仍可读取，但不再是当前结果。即使恢复原参数，也不会自动激活旧结果。应用时需要明确恢复兼容的上下文并重新准备；数据缺失或损坏会阻止读取。