Cropped ROI Endpoint (Chỉ Dành Cho Classification)

Tổng Quan

Endpoint cropped_roi cung cấp quyền truy cập vào các Regions of Interest (ROIs) đã được cắt được tạo từ kết quả classification trong Haystack đang chạy trên thiết bị.

Chỉ dành cho classification

Haystack hiện tại không hỗ trợ kết quả segmentation. Endpoint này chỉ hoạt động với các kết quả dạng classification. Nếu bạn cần xử lý kết quả segmenter theo phương thức lập trình, hãy sử dụng API kết quả kiểm tra tiêu chuẩn thay thế.

Định dạng URL cơ sở là:

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

---

Cách Thức Hoạt Động

Khi camera hoàn tất một classification capture, luồng Node-RED sẽ tự động xây dựng URL cho các ảnh ROI đã cắt bằng cách ghép IP thiết bị với ID của kết quả classification:

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

Mỗi URL phục vụ một ảnh đã cắt tương ứng với một ROI classification riêng lẻ, thường đại diện cho một lần kiểm tra đơn lẻ.

---

Tóm Tắt Luồng Node-RED

Luồng ROI_Crop thực hiện các bước sau:

1. Trích Xuất Địa Chỉ IP Của Thiết Bị

   • Phân tích trường image_url để tìm địa chỉ IP (ví dụ: 192.168.0.101)
   • Lưu trữ nó ở phạm vi global để tái sử dụng

2. Truy Vấn Dữ Liệu Capture Mới Nhất

   • Gửi một GET request đến PostgREST API của thiết bị:

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

   • Truy xuất capture gần nhất và tất cả các mục classification_result

3. Lọc Chỉ Lấy Kết Quả Classification

   • Bỏ qua các kết quả segmentation hoặc alignment

   • Lặp qua từng kết quả classification:

     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. Xuất Ra Các URL ROI Đã Cắt

   • Lưu tất cả các liên kết ảnh ROI vào một imageMap global
   • Trả về danh sách các URL ảnh ROI đã cắt mới nhất

Ví Dụ Sử Dụng

Truy Xuất Một Ảnh ROI Đã Cắt

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

Sử Dụng Trong Giao Diện Web

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

Ví Dụ Kết Quả Đầu Ra

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

---

Tham Số

Tham Số	Loại	Mô Tả
device-ip	string	Địa chỉ IP của camera (ví dụ: 192.168.0.101)

---

Luồng Tích Hợp

1. Lấy metadata capture mới nhất thông qua /postgrest/captures.
2. Xác định các ID classification_result khả dụng.
3. Xây dựng URL ROI đã cắt cho từng kết quả.
4. Hiển thị hoặc tải xuống những ảnh đó để phân tích, làm dữ liệu huấn luyện hoặc kiểm tra QA.

---

Tải Xuống Luồng Node-RED

• ROI Crop Flow (JSON) - Luồng Node-RED hoàn chỉnh để trích xuất các ảnh ROI đã cắt
  • Import luồng này trực tiếp vào Node-RED để truy cập các ROI classification đã cắt
  • Hoạt động với cả hai hệ thống OV20i và OV80i

---