裁剪 ROI 端点（仅分类）

概览

端点 cropped_roi 提供对在设备上运行的 Haystack 中由 classification results（分类结果） 生成的 cropped Regions of Interest (ROIs) 的访问。

仅分类

Haystack 目前不支持 segmentation 结果。本端点仅适用于 classification-type 结果。如需以编程方式处理 segmenter 输出，请改用标准的 inspection results API。

基础 URL 格式为：

http://{device-ip}/edge/haystack/cropped_roi/{classification_result_id}

---

工作原理

当相机完成一个 classification capture（分类捕获） 时，Node-RED 流通过将设备 IP 与 classification result ID（分类结果 ID） 配对，动态构造裁剪 ROI 图像的 URL：

const imageUrl = `http://${baseUrl}/edge/haystack/cropped_roi/${result.id}`;

每个 URL 提供一个对应于单个 classification ROI（分类 ROI） 的裁剪图像，通常表示一次检查。

---

Node-RED Flow 摘要

ROI_Crop 流执行以下操作：

1. 提取设备 IP

   • 解析 image_url 字段以找到 IP（如 192.168.0.101）
   • 将其全局存储以便复用

2. 查询最新捕获数据

   • 向设备的 PostgREST API 发送 GET 请求：

     http://{device-ip}/postgrest/captures?select=...
     &order=id.desc&limit=1

   • 检索最近的捕获以及所有 classification_result 条目

3. 仅筛选 classification_result 条目

   • 跳过 segmentation 或 alignment 结果

   • 对每个 classification_result 条目进行迭代：

     classificationResults.forEach(result => {
       const roiName = result.roi_result?.inspection_region?.name || `ROI_${result.id}`;
       const imageUrl = `http://${baseUrl}/edge/haystack/cropped_roi/${result.id}`;
       imageMap[roiName] = imageUrl;
     });

4. 输出裁剪后的 ROI URLs

   • 将所有 ROI 图像链接保存到全局 imageMap
   • 返回最新裁剪 ROI 图像 URL 的列表

---

示例用法

获取一个裁剪后的 ROI 图像

curl http://192.168.0.101/edge/haystack/cropped_roi/42 -o roi_42.jpg

在 Web 界面中的使用

<img src="http://192.168.0.101/edge/haystack/cropped_roi/42" alt="Cropped ROI 42">

输出示例

{
  "ROI_1": "http://192.168.0.101/edge/haystack/cropped_roi/1",
  "ROI_2": "http://192.168.0.101/edge/haystack/cropped_roi/2"
}

---

参数

参数	类型	描述
device-ip	string	相机的 IP 地址（例如 192.168.0.101）

---

集成流程

1. 通过 /postgrest/captures 获取最新捕获元数据。
2. 标识可用的 classification_result ID。
3. 为每个结果构造裁剪 ROI URL。
4. 显示或下载这些图像用于分析、训练数据，或 QA 检查。

---

下载 Node-RED Flow

• ROI Crop Flow (JSON) - 提取裁剪 ROI 图像的完整 Node-RED Flow
  • 将此 Flow 直接导入到 Node-RED 以访问裁剪的 classification ROIs
  • Works with both OV20i and OV80i systems

---