Cropped ROI Endpoint (Chỉ dành cho Classification)

Lưu ý về OV10i

OV10i chỉ hỗ trợ các mô hình classification. Các tính năng segmentation được đề cập trên trang này có sẵn trên camera OV20i và OV80i.

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 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ý đầu ra của segmenter theo cách 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 base URL là:

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

---

Cách Hoạt Động

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

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

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

---

Tóm Tắt Node-RED Flow

Luồng ROI_Crop thực hiện các công việc sau:

1. Trích Xuất Device IP

   • Phân tích trường image_url để tìm IP (ví dụ: 192.168.0.101)
   • Lưu trữ toàn cục để tái sử dụng

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

   • Gửi yêu cầu GET đế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 đây nhất và tất cả các mục classification_result

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

   • Bỏ qua 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 Các URL ROI Đã Cắt

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

---

Ví Dụ Sử Dụng

Truy Xuất Hình Ả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ụ Đầ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ố	Kiểu	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 của capture mới nhất qua /postgrest/captures.
2. Xác định các ID classification_result có sẵn.
3. Xây dựng các URL ROI đã cắt cho mỗi kết quả.
4. Hiển thị hoặc tải xuống các hình ảnh đó để phân tích, dữ liệu huấn luyện hoặc kiểm tra QA.

---

Tải Về Node-RED Flow

• ROI Crop Flow (JSON) - Node-RED flow hoàn chỉnh để trích xuất hình ả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ả hệ thống OV10i và OV80i

---