SỔ TAY / 01 Tra cứu nhanh

Không nhớ API?
Mở sổ tay.

Một trang để tra nhanh hàm OpenCV, tham số cần kiểm tra và lỗi thường gặp. Không thay thế tài liệu chính thức — nhưng đủ để bạn không bị kẹt ở bước đầu.

QUY TẮC / 03
01

Ảnh là BGR khi đọc bằng OpenCV. Kiểm tra None trước khi xử lý.

02

Kernel phải lẻ; ngưỡng phải được thử trên ảnh thật, không copy từ tutorial.

03

Đo bằng cặp nội tuyến, diện tích, dương tính giả — đừng chỉ nhìn ảnh đẹp.

01 / API

Bảng tra OpenCV

Những hàm xuất hiện nhiều nhất trong 46 chương. Cột “cần kiểm tra” là thứ dễ làm hỏng kết quả nhất.

Chủ đềHàm / APIĐiểm cần kiểm tra
Đọc / ghi ảnhcv2.imread, cv2.imwriteBGR; kiểm tra None; chất lượng JPEG 80–95.
Màucv2.cvtColorBGR↔GRAY, BGR↔HSV, BGR↔LAB.
Lọccv2.GaussianBlur, medianBlur, bilateralFilter, filter2DKích thước kernel lẻ; chuẩn hoá kernel làm mờ.
Biêncv2.Canny, cv2.Sobel, cv2.LaplacianLàm mờ trước; ngưỡng thấp:cao của Canny ≈ 1:2 hoặc 1:3.
Ngưỡngcv2.threshold, cv2.adaptiveThresholdOtsu cần biểu đồ tần suất lưỡng đỉnh; kích thước khối lẻ.
Hình thái họccv2.getStructuringElement, morphologyExMở bỏ hạt nhỏ; đóng lấp lỗ.
Đường baocv2.findContours, contourArea, approxPolyDPMặt nạ nhị phân; lọc diện tích trước khi phân loại.
Houghcv2.HoughLinesP, HoughCirclesCanny sạch; số phiếu/param2 quyết định độ nhạy.
Khớp mẫucv2.matchTemplateTM_CCOEFF_NORMED; NMS; không bất biến tỉ lệ/góc xoay.
Đặc trưngSIFT_create, ORB_create, BFMatcher, findHomographyNgưỡng tỉ lệ + RANSAC; đánh giá bằng cặp nội tuyến.
Luồng quang họccalcOpticalFlowFarneback, calcOpticalFlowPyrLKGiả định độ sáng không đổi; dùng kim tự tháp cho chuyển động lớn.
Hình họcfindHomography, findEssentialMat, recoverPoseH cho mặt phẳng; E cho camera đã hiệu chuẩn.
Khuôn mặtCascadeClassifier.detectMultiScaleMặt chính diện; mạng nơ-ron (DNN) thường chính xác hơn.
XGBoostXGBClassifier.fit, predict_probaDữ liệu dạng bảng; chia train/test; xem feature importance.
02 / CÔNG THỨC

Bốn công thức cốt lõi

Không phải tất cả công thức trong giáo trình, chỉ là bốn thứ hay dùng khi giải thích hoặc gỡ lỗi.

ĐỘ SÁNG

Từ màu sang xám

\[ Y = 0.299R + 0.587G + 0.114B \]

Dùng cho ảnh BT.601. Đừng lấy trung bình cộng ba kênh.

GRADIENT

Độ lớn biên

\[ \|\nabla I\| = \sqrt{G_x^2 + G_y^2} \]

Hướng gradient vuông góc với biên; Canny dùng nó để NMS.

HOMOGRAPHY

Mặt phẳng sang mặt phẳng

\[ \mathbf{x}' \sim H\mathbf{x} \]

8 bậc tự do; cần 4 cặp điểm không thẳng hàng.

EPIPOLAR

Ràng buộc hai khung nhìn

\[ \mathbf{x}'^{\top} E\mathbf{x} = 0 \]

E cho camera đã hiệu chuẩn; F cho pixel chưa hiệu chuẩn.

03 / THUẬT NGỮ

Nói cùng một ngôn ngữ

Những từ sẽ gặp lại nhiều lần. Nếu một khái niệm còn mơ hồ, hãy quay lại chương tương ứng thay vì đọc tiếp.

Pixel

Một mẫu màu/cường độ tại một vị trí trong lưới ảnh.

Kernel

Ma trận trọng số nhỏ dùng trong tích chập hoặc lọc.

Tiền cảnh / hậu cảnh

Vùng quan tâm và phần còn lại của ảnh, thường sau ngưỡng.

Điểm nội tuyến

Cặp điểm hoặc kết quả phát hiện nhất quán với mô hình hình học đang xét.

RANSAC

Thuật toán lặp khớp mô hình từ mẫu tối thiểu và đếm điểm nội tuyến để chống điểm ngoại lai.

Homography

Phép biến đổi 3×3 ánh xạ mặt phẳng giữa hai ảnh, 8 bậc tự do.

Epipolar

Ràng buộc hình học giữa hai khung nhìn của cùng một điểm 3D.

Luồng quang học

Trường vector chuyển động biểu kiến của pixel giữa hai khung hình.

Gradient boosting

Phương pháp ghép nhiều cây yếu, mỗi cây mới học phần lỗi còn lại của mô hình trước.

Feature importance

Mức đóng góp tương đối của từng đặc trưng vào các lần tách của mô hình cây.

Tracking-by-detection

Ghép detection của từng frame với track đang có, thường bằng Kalman + Hungarian + IoU.

Kalman filter

Bộ lọc đệ quy dự đoán trạng thái tiếp theo và hiệu chỉnh bằng quan sát mới.

Hungarian

Thuật toán gán một-một tối ưu giữa track và detection theo ma trận chi phí.

Cost volume

Tensor chứa độ giống giữa feature của hai frame tại nhiều cặp vị trí.

EPE

End-point error, khoảng cách trung bình giữa flow dự đoán và flow tham chiếu.

Bundle adjustment

Tối ưu đồng thời pose camera và điểm 3D để giảm sai số tái chiếu.

Loop closure

Phát hiện camera quay lại vùng đã thấy và hiệu chỉnh drift của toàn bộ quỹ đạo.

IMU preintegration

Tổng hợp gia tốc/vận tốc góc giữa hai keyframe để dùng trong tối ưu cửa sổ trượt.

Promptable segmentation

Mô hình sinh mask từ box, click hoặc mask gợi ý thay vì chỉ nhận ảnh.

Set prediction

Dự đoán một tập đối tượng và ghép với ground truth bằng Hungarian, không cần NMS.

Tube masking

Che cùng một vị trí không gian qua nhiều frame để buộc mô hình video học ngữ cảnh thời gian.

04 / DANH MỤC KIỂM TRA

Trước khi tin một kết quả

Một danh mục ngắn, dùng được cho hầu hết luồng xử lý thị giác cổ điển.

01

Ảnh đầu vào có đúng thứ tự màu, đúng hướng ảnh và không bị None?

02

Tham số có được chọn trên tập ảnh đa dạng, hay chỉ một ảnh đẹp?

03

Bạn đã đo dương tính giả và âm tính giả, không chỉ đếm kết quả đúng?

04

Bước sau có giả định tiền cảnh là trắng / ảnh xám / cùng kích thước không?

05

Kết quả có còn đúng khi ánh sáng, góc nhìn hoặc vật thể thay đổi nhẹ không?

06

Có một phương án đơn giản hơn để so sánh không?