Bộ công cụ desktop chuẩn bị bằng chứng kỹ thuật từ video camera ngoại vi — lọc theo vùng quan tâm (ROI), phát hiện người, và xuất clip ứng viên để con người rà soát.
person_detected đã lọc ROI và tín hiệu phụ camera_anomaly —
tất cả là bằng chứng để rà soát, không phải nhãn cuối cùng.
Chọn công cụ đúng với việc bạn đang làm.
| Công cụ | Lệnh | Dùng để làm gì |
|---|---|---|
| Candidate Mining | candidate-mining-gui |
Công cụ chính. Nạp video thô, vẽ ROI, chạy phát hiện, rà soát và xuất ứng viên kỹ thuật. Bắt đầu từ đây. |
| Clip Cutter | candidate-mining clip-cutter-gui |
Bản nhẹ, độc lập: biến JSON ứng viên đã có sẵn thành file MP4. Không nạp model phát hiện. |
| Candidate Labeling | candidate-mining candidate-labeling-gui |
Rà soát ứng viên trong data/results/cameras/, gán Kịch bản / Hành vi / Khoảng cách, xuất clip kèm JSON đã gán nhãn. |
| Video Cutter | python -m video_cutter.main |
Công cụ batch độc lập: cắt video trong data/output/ về cửa sổ cố định 60 giây và đồng bộ JSON đi kèm. |
Yêu cầu Python 3.11 và FFmpeg/FFprobe có trong PATH (hoặc đặt tại tools/ffmpeg/).
# Windows
py -3.11 -m venv .venv
.\.venv\Scripts\python -m pip install --upgrade pip
.\.venv\Scripts\python -m pip install -e ".[vision,gui,dev]"
# Tải trọng số model — bước xử lý KHÔNG tự tải
.\.venv\Scripts\candidate-mining download-weights --model rtdetr-l
# Chạy ứng dụng chính
.\.venv\Scripts\candidate-mining-guiTrên Linux/macOS, thay .\.venv\Scripts\ bằng .venv/bin/.
Profile trong configs/candidate-mining.toml. Tab Process cho phép ghi đè sampling và batch size theo từng lần chạy.
Ultralytics RT-DETR-L, pretrained COCO, lọc riêng lớp person.
2 FPS, image size 960, batch size 4.
0.30
Không đọc file .env. config.py đọc thẳng biến môi trường OS, fallback về TOML. Mặc định ~/Desktop.
Toàn bộ nằm trong thư mục docs/ của repo.