update from asus 106

This commit is contained in:
asus committed 2026-08-05 15:56:11 +07:00
1 parent 6637fb1302
commit 8285400254
28 files changed
+3215 -459

No files matched your search

+485
View File
@@ -0,0 +1,485 @@
"""
Batch Video Cropper — Rekam Video RTSP per Sesi Batch Truk
Program ini membaca livestream CCTV (RTSP), menjalankan algoritma penentuan batch
menggunakan YOLO + State Machine, dan menyimpan potongan video per-batch ke folder
yang terorganisir berdasarkan tanggal.
Struktur Output:
~/reTraining/data/archive/
├── 2026-08-05/
│ ├── batch_1_09-15-30.mp4
│ ├── batch_2_10-22-45.mp4
│ └── batch_3_14-08-12.mp4
└── 2026-08-06/
└── batch_1_07-30-00.mp4
Menjalankan:
cd ~/reTraining/algoritma-batch
python3 batch_video_cropper.py
"""
import os
import cv2
import numpy as np
import time
import json
import threading
from datetime import datetime, timedelta
from shapely.geometry import Point, Polygon
from ultralytics import YOLO
# Import modules
from src.tracking import ByteTrackTracker
from src.stabilizer import BboxStabilizer
from src.truck_roi import TruckROI
from src.counting import LineCrossCounter
from src.batch import BatchLifecycleManager, BatchRecord
# =====================================================================
# 1. KONFIGURASI
# =====================================================================
import platform
IS_WINDOWS = platform.system() == "Windows"
# --- Path Konfigurasi ---
BASE_DIR = os.path.dirname(os.path.abspath(__file__))
ZONES_JSON = os.path.join(BASE_DIR, "zones.json")
if IS_WINDOWS:
MODEL_PATH = os.path.join(BASE_DIR, "v1-best.pt")
ARCHIVE_BASE = os.path.join(BASE_DIR, "archive_output")
else:
MODEL_PATH = os.path.join(BASE_DIR, "v1-best.pt")
ARCHIVE_BASE = os.path.expanduser("~/reTraining/data/archive")
# --- Sumber Video RTSP ---
RTSP_URL = "rtsp://frigate:zenai@192.168.192.209:8554/camera_stream_640"
# --- Batas Pergantian Hari (Cutoff) ---
DAILY_CUTOFF_TIME = "20:00"
# --- Parameter State Machine ---
SACK_IDLE_TIMEOUT = 5.0 # Jeda aktivitas sebelum masuk WAITING_FOR_ACTIVITY
MIN_BATCH_DURATION = 2.0 # Durasi minimal batch sebelum boleh masuk WAITING
TOLERANCE_LOW_COUNT = 0.0 # Instan (0s) — batch langsung berakhir saat area truk kosong
TOLERANCE_MED_COUNT = 0.0
TOLERANCE_HIGH_COUNT = 0.0
# --- Video Recording ---
VIDEO_FPS = 10.0 # FPS output video (10 fps sudah cukup untuk rekaman arsip)
VIDEO_CODEC = "mp4v" # Codec untuk .mp4
# =====================================================================
# 2. THREADED RTSP READER (Menghindari Lag Buffer)
# =====================================================================
class RTSPStreamReader:
"""Threaded RTSP reader yang selalu mengambil frame terbaru."""
def __init__(self, source_url):
self.source_url = source_url
self.cap = cv2.VideoCapture(source_url)
self.frame = None
self.ret = False
self.running = True
self.lock = threading.Lock()
self.new_frame_event = threading.Event()
self.thread = threading.Thread(target=self._update, daemon=True)
self.thread.start()
def _update(self):
while self.running:
if not self.cap.isOpened():
print("[RTSP] Stream terputus, mencoba reconnect dalam 5 detik...")
time.sleep(5)
self.cap = cv2.VideoCapture(self.source_url)
continue
ret, frame = self.cap.read()
if not ret:
time.sleep(0.01)
continue
with self.lock:
self.ret = ret
self.frame = frame
self.new_frame_event.set()
time.sleep(0.001)
def read(self):
if self.new_frame_event.wait(timeout=2.0):
self.new_frame_event.clear()
with self.lock:
if self.frame is None:
return False, None
return self.ret, self.frame.copy()
else:
with self.lock:
if self.frame is None:
return False, None
return self.ret, self.frame.copy()
def isOpened(self):
return self.cap.isOpened()
def release(self):
self.running = False
if self.cap.isOpened():
self.cap.release()
# =====================================================================
# 3. FUNGSI UTILITAS TANGGAL & FOLDER
# =====================================================================
def get_counting_date(dt=None):
"""Menentukan tanggal kerja berdasarkan cutoff harian."""
if dt is None:
dt = datetime.now()
try:
cutoff = datetime.strptime(DAILY_CUTOFF_TIME, "%H:%M").time()
except Exception:
cutoff = datetime.strptime("20:00", "%H:%M").time()
if cutoff.hour == 0 and cutoff.minute == 0:
return dt.date().isoformat()
if dt.time() < cutoff:
return dt.date().isoformat()
return (dt.date() + timedelta(days=1)).isoformat()
def ensure_date_folder(counting_date):
"""Membuat folder tanggal di archive jika belum ada. Mengembalikan path folder."""
folder = os.path.join(ARCHIVE_BASE, counting_date)
os.makedirs(folder, exist_ok=True)
return folder
# =====================================================================
# 4. BATCH VIDEO RECORDER (Mengelola VideoWriter per Batch)
# =====================================================================
class BatchVideoRecorder:
"""Mengelola pembukaan dan penutupan file video per sesi batch."""
def __init__(self, archive_base, video_fps=10.0, codec="mp4v"):
self.archive_base = archive_base
self.video_fps = video_fps
self.codec = codec
self.writer = None
self.current_path = None
self.frame_count = 0
def start_recording(self, batch_number, counting_date, frame_width=1280, frame_height=720):
"""Membuka file video baru untuk batch ini."""
self.stop_recording() # Pastikan writer sebelumnya ditutup
folder = ensure_date_folder(counting_date)
timestamp_str = datetime.now().strftime("%H-%M-%S")
filename = f"batch_{batch_number}_{timestamp_str}.mp4"
self.current_path = os.path.join(folder, filename)
fourcc = cv2.VideoWriter_fourcc(*self.codec)
self.writer = cv2.VideoWriter(
self.current_path, fourcc, self.video_fps, (frame_width, frame_height)
)
self.frame_count = 0
if self.writer.isOpened():
print(f"[RECORD] Mulai merekam video batch #{batch_number} -> {self.current_path}")
else:
print(f"[RECORD ERROR] Gagal membuka VideoWriter untuk: {self.current_path}")
self.writer = None
def write_frame(self, frame):
"""Menulis satu frame ke video aktif."""
if self.writer is not None and self.writer.isOpened():
self.writer.write(frame)
self.frame_count += 1
def stop_recording(self):
"""Menutup file video yang sedang aktif."""
if self.writer is not None:
self.writer.release()
self.writer = None
if self.current_path and self.frame_count > 0:
print(f"[RECORD] Video selesai disimpan: {self.current_path} ({self.frame_count} frames)")
elif self.current_path and self.frame_count == 0:
# Hapus file kosong
try:
os.remove(self.current_path)
print(f"[RECORD] File video kosong dihapus: {self.current_path}")
except Exception:
pass
self.current_path = None
self.frame_count = 0
@property
def is_recording(self):
return self.writer is not None and self.writer.isOpened()
# =====================================================================
# 5. FUNGSI UTAMA — LOOP UTAMA DETEKSI & PEREKAMAN
# =====================================================================
def run_batch_video_cropper():
print("=" * 60)
print(" BATCH VIDEO CROPPER — RTSP → Per-Batch MP4 Recorder")
print("=" * 60)
print(f" Model : {MODEL_PATH}")
print(f" RTSP : {RTSP_URL}")
print(f" Archive : {ARCHIVE_BASE}")
print(f" Cutoff : {DAILY_CUTOFF_TIME}")
print(f" Tolerance : Instan (0s)")
print("=" * 60)
# Pastikan folder archive ada
os.makedirs(ARCHIVE_BASE, exist_ok=True)
# --- Load Model YOLO ---
print("[INFO] Memuat model YOLO...")
model = YOLO(MODEL_PATH)
# Warm-up model
print("[INFO] Warm-up model...")
dummy = np.zeros((720, 1280, 3), dtype=np.uint8)
device = "cuda" if os.path.exists("/usr/local/cuda") else "cpu"
try:
import torch
if torch.cuda.is_available():
device = "cuda"
except ImportError:
pass
_ = model(dummy, imgsz=640, device=device, verbose=False)
print(f"[INFO] Model siap. Device: {device}")
# --- Setup Components ---
tracker = ByteTrackTracker(model, conf=0.55)
stabilizer = BboxStabilizer(
ema_alpha=0.35,
max_hold_frames=10,
max_height_ratio=1.5,
min_height_ratio=0.70,
)
# Skala koordinat (kalibrasi 1920x1080 -> 1280x720)
scale_x = 1280.0 / 1920.0
scale_y = 720.0 / 1080.0
# Detection polygon
detection_poly_pts = [
[int(574 * scale_x), int(50 * scale_y)],
[int(586 * scale_x), int(1077 * scale_y)],
[int(1418 * scale_x), int(1076 * scale_y)],
[int(1397 * scale_x), int(50 * scale_y)],
]
detection_polygon = Polygon(detection_poly_pts)
# Truck polygon (untuk monitoring kehadiran karung)
truck_poly_pts = [
[int(600 * scale_x), int(385 * scale_y)],
[int(609 * scale_x), int(1076 * scale_y)],
[int(1404 * scale_x), int(1078 * scale_y)],
[int(1381 * scale_x), int(343 * scale_y)],
]
truck_polygon = Polygon(truck_poly_pts)
# Line crossing
static_line_y = int(330 * scale_y)
static_line_x_start = int(577 * scale_x)
static_line_x_end = int(1401 * scale_x)
static_roi = TruckROI(
x1=int(600 * scale_x),
y1=int(343 * scale_y),
x2=int(1404 * scale_x),
y2=int(1078 * scale_y),
line_y=static_line_y,
confidence=1.0,
)
counter = LineCrossCounter(
line_y=static_line_y,
line_x_start=static_line_x_start,
line_x_end=static_line_x_end,
margin=20,
dedup_radius=60.0,
)
batch_mgr = BatchLifecycleManager(
stabilize_seconds=0.0,
stabilize_threshold_px=9999.0,
sack_idle_timeout=SACK_IDLE_TIMEOUT,
min_batch_duration=MIN_BATCH_DURATION,
truck_gone_tolerance=TOLERANCE_LOW_COUNT,
)
recorder = BatchVideoRecorder(
archive_base=ARCHIVE_BASE,
video_fps=VIDEO_FPS,
codec=VIDEO_CODEC,
)
# --- Buka RTSP Stream ---
print(f"[INFO] Membuka RTSP stream: {RTSP_URL}")
cap = RTSPStreamReader(RTSP_URL)
if not cap.isOpened():
print(f"[ERROR] Gagal membuka RTSP stream: {RTSP_URL}")
return
# Tracking state
batch_counter = 0
frame_idx = 0
last_fps_time = time.time()
fps_counter = 0
print("\n[INFO] Memulai loop utama... Tekan Ctrl+C untuk berhenti.\n")
try:
while True:
ret, frame = cap.read()
if not ret or frame is None:
time.sleep(0.01)
continue
# Resize ke 1280x720 (sesuai kalibrasi koordinat zona)
frame = cv2.resize(frame, (1280, 720))
timestamp = time.time()
frame_idx += 1
# FPS counter
fps_counter += 1
if fps_counter % 100 == 0:
elapsed = time.time() - last_fps_time
fps = 100.0 / elapsed if elapsed > 0 else 0
last_fps_time = time.time()
state_str = batch_mgr.state
rec_str = "REC" if recorder.is_recording else "---"
print(f"[FPS] {fps:.1f} fps | State: {state_str} | {rec_str} | Frames: {frame_idx}")
# Simpan state sebelum update
prev_active = batch_mgr.is_active
prev_state = batch_mgr.state
# --- 1. YOLO Tracking ---
raw_tracked_all = tracker.update(frame, [])
raw_tracked_sacks = [d for d in raw_tracked_all if d.class_name == "sack"]
# --- 2. Stabilizer ---
stable = stabilizer.update(raw_tracked_sacks)
# --- 3. Filter Detection Polygon ---
stable = [
d for d in stable
if detection_polygon.contains(
Point((d.bbox[0] + d.bbox[2]) / 2.0, (d.bbox[1] + d.bbox[3]) / 2.0)
)
]
# --- 4. Hitung karung di 70% area bawah truk ---
min_ty, max_ty = truck_polygon.bounds[1], truck_polygon.bounds[3]
truck_height = max_ty - min_ty
truck_cutoff_y = min_ty + 0.30 * truck_height
sacks_in_truck_area = 0
for d in stable:
cx = (d.bbox[0] + d.bbox[2]) / 2.0
cy = (d.bbox[1] + d.bbox[3]) / 2.0
if truck_polygon.contains(Point(cx, cy)) and cy >= truck_cutoff_y:
sacks_in_truck_area += 1
# --- 5. Line Crossing ---
tracked_in_roi = [
d for d in stable
if static_roi.contains_x((d.bbox[0] + d.bbox[2]) / 2.0)
]
events = counter.update(tracked_in_roi)
has_crossing = len(events) > 0
# =============================================================
# LOGIKA ALGORITMA PENENTUAN BATCH (STATE MACHINE)
# =============================================================
# A. Mulai Batch
if batch_mgr.state in ("IDLE", "TRUCK_STABILIZING"):
batch_mgr.update_truck(has_crossing, (0.0, 0.0), timestamp)
# B. Monitoring Batch Aktif
if batch_mgr.state in ("COUNTING_SACKS", "WAITING_FOR_ACTIVITY"):
current_count = counter.loading_count
if current_count < 20:
batch_mgr._truck_gone_tolerance = TOLERANCE_LOW_COUNT
elif current_count >= 40:
batch_mgr._truck_gone_tolerance = TOLERANCE_HIGH_COUNT
else:
batch_mgr._truck_gone_tolerance = TOLERANCE_MED_COUNT
batch_mgr.update_sacks(
has_crossing_event=has_crossing,
sacks_in_area_count=sacks_in_truck_area,
timestamp=timestamp,
loading_count=counter.loading_count,
unloading_count=counter.unloading_count,
)
if batch_mgr.state == "WAITING_FOR_ACTIVITY":
batch_mgr.update_truck(sacks_in_truck_area > 0, None, timestamp)
for ev in events:
now_str = datetime.now().strftime("%H:%M:%S")
print(f"[{now_str}] [KARUNG] #{ev['track_id']} melintasi garis. Total: {counter.loading_count}")
# =============================================================
# TRANSISI BATCH — MULAI/SELESAI REKAMAN VIDEO
# =============================================================
# C. Batch baru saja dimulai
if batch_mgr.is_active and not prev_active:
counting_date = get_counting_date()
batch_counter += 1
now_str = datetime.now().strftime("%H:%M:%S")
print(f"\n>>> [{now_str}] BATCH #{batch_counter} DIMULAI (tanggal: {counting_date}) <<<")
recorder.start_recording(batch_counter, counting_date, 1280, 720)
# D. Batch baru saja selesai
elif not batch_mgr.is_active and prev_active:
final_count = counter.loading_count
now_str = datetime.now().strftime("%H:%M:%S")
print(f"\n>>> [{now_str}] BATCH #{batch_counter} SELESAI. Total karung: {final_count} <<<")
recorder.stop_recording()
# Reset counter dan stabilizer untuk batch berikutnya
counter.reset()
stabilizer.reset()
# E. Log transisi status
if batch_mgr.state != prev_state:
now_str = datetime.now().strftime("%H:%M:%S")
print(f"[{now_str}] [STATE] {prev_state} -> {batch_mgr.state}")
# =============================================================
# TULIS FRAME KE VIDEO (jika batch aktif)
# =============================================================
if batch_mgr.is_active and recorder.is_recording:
recorder.write_frame(frame)
except KeyboardInterrupt:
print("\n\n[INFO] Program dihentikan oleh pengguna (Ctrl+C).")
finally:
# Tutup rekaman yang masih terbuka
if recorder.is_recording:
print("[INFO] Menyimpan rekaman batch terakhir...")
recorder.stop_recording()
cap.release()
print("\n" + "=" * 60)
print(" BATCH VIDEO CROPPER SELESAI")
print(f" Total batch terekam: {batch_counter}")
print(f" Total frame diproses: {frame_idx}")
print(f" Folder output: {ARCHIVE_BASE}")
print("=" * 60)
if __name__ == "__main__":
run_batch_video_cropper()
+26
View File
@@ -0,0 +1,26 @@
# Custom FastTrack config tuned for sack counting:
# - track_buffer=60: hold lost tracks for 60 frames (~2.4s at 25fps)
# to survive worker occlusion
# - new_track_thresh=0.3: harder to spawn duplicate IDs
# - track_low_thresh=0.05: recover faint detections behind workers
# - active_occ_to_lost_thresh=15: tolerate 15 occluded frames
# - occ_reappear_window=60: re-find tracks after long occlusion
# - enlarge_bbox_occ=1.15: widen search region during occlusion
tracker_type: bytetrack
track_high_thresh: 0.20
track_low_thresh: 0.05
new_track_thresh: 0.30
track_buffer: 60
match_thresh: 0.85
fuse_score: true
# Occlusion handling (FastTrack-specific)
reset_velocity_offset_occ: 5
reset_pos_offset_occ: 3
enlarge_bbox_occ: 1.15
dampen_motion_occ: 0.4
active_occ_to_lost_thresh: 15
occ_cover_thresh: 0.6
occ_reappear_window: 60
init_iou_suppress: 0.65
+1
View File
@@ -0,0 +1 @@
"""Package marker."""
+390
View File
@@ -0,0 +1,390 @@
"""Batch lifecycle manager — 4-state machine for truck+sack sessions.
State machine:
IDLE ──truck detected──▶ TRUCK_STABILIZING ──stable 5s──▶ COUNTING_SACKS
▲ │ truck gone │ ▲
│ └──────▶ IDLE │ │
│ │ │
│ 10s no sack activity │ │ sacks resume
│ ▼ │
│ WAITING_FOR_ACTIVITY
│ (batch OPEN)
│ │
└──────────────── truck leaves ─────────────────────────────┘
(batch finalized)
"""
from __future__ import annotations
import time
import math
from dataclasses import dataclass, field
from enum import Enum, auto
class BatchState(Enum):
IDLE = auto()
TRUCK_STABILIZING = auto()
COUNTING_SACKS = auto()
WAITING_FOR_ACTIVITY = auto() # Paused: no sacks, but truck still here
@dataclass
class BatchRecord:
"""Completed batch summary."""
batch_id: int
start_time: float
end_time: float
loading_count: int
unloading_count: int
@property
def net_count(self) -> int:
return self.loading_count - self.unloading_count
@property
def duration_seconds(self) -> float:
return self.end_time - self.start_time
class BatchLifecycleManager:
"""Manages batch transitions based on truck stability and sack activity.
State flow:
- IDLE: waiting for truck to appear in ROI polygon
- TRUCK_STABILIZING: truck seen, tracking centroid stability
- COUNTING_SACKS: actively counting sacks crossing line
- WAITING_FOR_ACTIVITY: sacks idle, but truck still present — batch stays open
"""
def __init__(
self,
stabilize_seconds: float = 5.0,
stabilize_threshold_px: float = 15.0,
sack_idle_timeout: float = 10.0,
min_batch_duration: float = 30.0,
truck_gone_tolerance: float = 3.0,
timeout_seconds: float = 30.0, # kept for backward compat (unused)
) -> None:
# Tunable parameters
self._stabilize_seconds = stabilize_seconds
self._stabilize_threshold_px = stabilize_threshold_px
self._sack_idle_timeout = sack_idle_timeout
self._min_batch_duration = min_batch_duration
self._truck_gone_tolerance = truck_gone_tolerance
# Internal state
self._state = BatchState.IDLE
self._batch_counter = 0
self._current_batch_id: int | None = None
self._batch_start_time = 0.0
self._history: list[BatchRecord] = []
# Truck stabilization tracking
self._truck_first_seen_time = 0.0
self._truck_last_centroid: tuple[float, float] | None = None
self._truck_stable_since = 0.0
self._truck_is_stable = False
self._truck_last_seen = 0.0 # timestamp when truck was last detected
# Sack activity tracking (for pause condition)
self._last_sack_crossing_time = 0.0
self._last_sack_seen_in_area_time = 0.0
# Waiting state tracking
self._waiting_since = 0.0
# Callbacks
self._on_batch_start: list = []
self._on_batch_end: list = []
# -- Public API: Register callbacks --
def on_batch_start(self, callback) -> None:
"""Register callback: fn(batch_id, timestamp)."""
self._on_batch_start.append(callback)
def on_batch_end(self, callback) -> None:
"""Register callback: fn(BatchRecord)."""
self._on_batch_end.append(callback)
# -- Public API: State update methods --
def update_truck(
self,
truck_detected: bool,
truck_centroid: tuple[float, float] | None,
timestamp: float,
) -> None:
"""Called during IDLE, TRUCK_STABILIZING, and WAITING_FOR_ACTIVITY states.
Args:
truck_detected: whether a truck is detected in the ROI polygon
truck_centroid: (cx, cy) of the truck bounding box, or None
timestamp: current time.time()
"""
if self._state == BatchState.IDLE:
if truck_detected and truck_centroid is not None:
# Transition to STABILIZING
self._state = BatchState.TRUCK_STABILIZING
self._truck_first_seen_time = timestamp
self._truck_last_centroid = truck_centroid
self._truck_stable_since = timestamp
self._truck_is_stable = False
self._truck_last_seen = timestamp
print(f"[BATCH] Truk terdeteksi di area. Memantau stabilitas...")
elif self._state == BatchState.TRUCK_STABILIZING:
if truck_detected:
self._truck_last_seen = timestamp
# Check if truck has been gone for too long (tolerance)
time_since_last_seen = timestamp - self._truck_last_seen
if not truck_detected and time_since_last_seen >= self._truck_gone_tolerance:
print(f"[BATCH] Truk hilang selama {time_since_last_seen:.1f}s. Kembali ke IDLE.")
self._state = BatchState.IDLE
self._truck_last_centroid = None
self._truck_is_stable = False
return
if truck_centroid is not None and self._truck_last_centroid is not None:
# Calculate centroid displacement
dx = truck_centroid[0] - self._truck_last_centroid[0]
dy = truck_centroid[1] - self._truck_last_centroid[1]
displacement = math.sqrt(dx * dx + dy * dy)
if displacement > self._stabilize_threshold_px:
# Truck moved too much -> reset stability timer
self._truck_stable_since = timestamp
self._truck_is_stable = False
self._truck_last_centroid = truck_centroid
# Check if stable long enough
stable_duration = timestamp - self._truck_stable_since
if stable_duration >= self._stabilize_seconds:
if not self._truck_is_stable:
self._truck_is_stable = True
print(f"[BATCH] Truk stabil selama {stable_duration:.1f}s. Memulai counting...")
self._start_batch(timestamp)
elif self._state == BatchState.WAITING_FOR_ACTIVITY:
if truck_detected:
self._truck_last_seen = timestamp
# Check if truck has been gone for tolerance period
time_since_last_seen = timestamp - self._truck_last_seen
if not truck_detected and time_since_last_seen >= self._truck_gone_tolerance:
# Truck has truly left! NOW we finalize the batch.
wait_duration = timestamp - self._waiting_since
print(
f"[BATCH] Truk pergi setelah menunggu {wait_duration:.0f}s. "
f"Batch selesai."
)
self._end_batch(timestamp, self._pending_loading, self._pending_unloading)
def update_sacks(
self,
has_crossing_event: bool,
sacks_in_area_count: int,
timestamp: float,
loading_count: int = 0,
unloading_count: int = 0,
) -> None:
"""Called during COUNTING_SACKS and WAITING_FOR_ACTIVITY states.
Args:
has_crossing_event: True if a sack crossed the counting line this frame
sacks_in_area_count: number of sacks currently detected in truck area
timestamp: current time.time()
loading_count: current cumulative loading count
unloading_count: current cumulative unloading count
"""
# WAITING_FOR_ACTIVITY: if sacks appear again, resume counting in the SAME batch
if self._state == BatchState.WAITING_FOR_ACTIVITY:
if has_crossing_event or sacks_in_area_count > 0:
wait_duration = timestamp - self._waiting_since
print(
f"[BATCH] Aktivitas karung terdeteksi setelah {wait_duration:.0f}s menunggu. "
f"Melanjutkan counting batch #{self._current_batch_id}..."
)
self._state = BatchState.COUNTING_SACKS
self._last_sack_crossing_time = timestamp
self._last_sack_seen_in_area_time = timestamp
# Fall through to counting logic below
else:
return
if self._state != BatchState.COUNTING_SACKS:
return
# Update activity timers
if has_crossing_event:
self._last_sack_crossing_time = timestamp
if sacks_in_area_count > 0:
self._last_sack_seen_in_area_time = timestamp
# Store latest counts for when batch eventually ends
self._pending_loading = loading_count
self._pending_unloading = unloading_count
# Check pause condition: no sack activity for timeout period
batch_duration = timestamp - self._batch_start_time
time_since_last_crossing = timestamp - self._last_sack_crossing_time
time_since_last_sack_seen = timestamp - self._last_sack_seen_in_area_time
if (
batch_duration >= self._min_batch_duration
and time_since_last_crossing >= self._sack_idle_timeout
and time_since_last_sack_seen >= self._sack_idle_timeout
):
print(
f"[BATCH] Tidak ada aktivitas karung selama {self._sack_idle_timeout}s. "
f"Menunggu truk pergi atau palet selanjutnya..."
)
self._state = BatchState.WAITING_FOR_ACTIVITY
self._waiting_since = timestamp
# -- Public API: Backward-compatible update (legacy) --
def update(
self,
truck_detected: bool,
timestamp: float,
loading_count: int = 0,
unloading_count: int = 0,
) -> None:
"""Legacy update method — kept for backward compatibility."""
if self._state in (BatchState.IDLE, BatchState.TRUCK_STABILIZING):
self.update_truck(truck_detected, None, timestamp)
elif self._state in (BatchState.COUNTING_SACKS, BatchState.WAITING_FOR_ACTIVITY):
self.update_sacks(
has_crossing_event=False,
sacks_in_area_count=1 if truck_detected else 0,
timestamp=timestamp,
loading_count=loading_count,
unloading_count=unloading_count,
)
# -- Properties --
@property
def state(self) -> str:
"""Return current state as human-readable string."""
return self._state.name
@property
def current_batch_id(self) -> int | None:
return self._current_batch_id
@property
def is_active(self) -> bool:
"""True during COUNTING or WAITING (batch is still open)."""
return self._state in (BatchState.COUNTING_SACKS, BatchState.WAITING_FOR_ACTIVITY)
@property
def is_counting(self) -> bool:
"""True only during active sack counting."""
return self._state == BatchState.COUNTING_SACKS
@property
def is_waiting(self) -> bool:
"""True when paused waiting for next pallet or truck departure."""
return self._state == BatchState.WAITING_FOR_ACTIVITY
@property
def is_stabilizing(self) -> bool:
return self._state == BatchState.TRUCK_STABILIZING
@property
def history(self) -> list[BatchRecord]:
return list(self._history)
@property
def batch_duration(self) -> float:
"""Duration of current batch in seconds (0 if not active)."""
if not self.is_active:
return 0.0
return time.time() - self._batch_start_time
@property
def time_since_last_sack_activity(self) -> float:
"""Seconds since last sack crossed line or seen in area."""
if not self.is_active:
return 0.0
now = time.time()
last_activity = max(self._last_sack_crossing_time, self._last_sack_seen_in_area_time)
return now - last_activity if last_activity > 0 else 0.0
@property
def waiting_duration(self) -> float:
"""How long we've been in WAITING_FOR_ACTIVITY state."""
if self._state != BatchState.WAITING_FOR_ACTIVITY:
return 0.0
return time.time() - self._waiting_since
@property
def stabilize_progress(self) -> float:
"""Progress of truck stabilization (0.0 to 1.0)."""
if self._state != BatchState.TRUCK_STABILIZING:
return 0.0
if self._stabilize_seconds <= 0.0:
return 1.0
elapsed = time.time() - self._truck_stable_since
return min(1.0, elapsed / self._stabilize_seconds)
def resume_batch(
self,
batch_id: int,
start_time: float,
loading_count: int,
unloading_count: int,
) -> None:
"""Resume a previously finalized batch."""
self._current_batch_id = batch_id
self._batch_counter = max(self._batch_counter, batch_id)
self._batch_start_time = start_time
self._pending_loading = loading_count
self._pending_unloading = unloading_count
self._state = BatchState.COUNTING_SACKS
# Pop from history if it was just completed
if self._history and self._history[-1].batch_id == batch_id:
self._history.pop()
# -- Private methods --
def _start_batch(self, timestamp: float) -> None:
self._batch_counter += 1
self._current_batch_id = self._batch_counter
self._batch_start_time = timestamp
self._last_sack_crossing_time = timestamp # Grace period
self._last_sack_seen_in_area_time = timestamp # Grace period
self._pending_loading = 0
self._pending_unloading = 0
self._state = BatchState.COUNTING_SACKS
for cb in self._on_batch_start:
cb(self._current_batch_id, timestamp)
def _end_batch(
self,
timestamp: float,
loading_count: int,
unloading_count: int,
) -> None:
record = BatchRecord(
batch_id=self._current_batch_id or 0,
start_time=self._batch_start_time,
end_time=timestamp,
loading_count=loading_count,
unloading_count=unloading_count,
)
self._history.append(record)
self._state = BatchState.IDLE
self._current_batch_id = None
self._truck_last_centroid = None
self._truck_is_stable = False
for cb in self._on_batch_end:
cb(record)
+237
View File
@@ -0,0 +1,237 @@
"""Line-crossing counter — hybrid zone-based state tracking.
Counting logic (Low-FPS robust):
Uses y1 (top edge) of the stabilized sack bounding box.
Each track_id goes through states:
UNKNOWN → ABOVE → COUNTED (when seen below line)
UNKNOWN → BELOW (ghost/appeared below line first → never counted)
Loading: track had state ABOVE, now detected BELOW the zone
Unloading: track had state BELOW, now detected ABOVE the zone (if needed)
3-Layer deduplication:
Layer 1: State guard — must have been ABOVE before counting
Layer 2: Spatial dedup radius — same position can't trigger twice
Layer 3: Track ID — one track_id can only be counted once per direction
This approach is immune to low FPS because it doesn't require
detecting the exact frame of crossing. It only needs the track
to have been seen ABOVE the line at ANY point in its lifetime.
"""
from __future__ import annotations
import time
from src.interfaces import Detection
class LineCrossCounter:
"""Counts sacks crossing a horizontal zone using y1 (top edge).
The zone is a band [line_y - margin, line_y + margin].
A sack is "above" if y1 < line_y - margin,
"below" if y1 > line_y + margin.
While y1 is inside the band, state is held (no trigger).
Loading = track was ever "above", now "below" (entered truck)
Unloading = track was ever "below", now "above" (left truck)
"""
def __init__(
self,
line_y: int,
line_x_start: int,
line_x_end: int,
margin: int = 20,
dedup_radius: float = 60.0,
) -> None:
self._line_y = line_y
self._line_x_start = line_x_start
self._line_x_end = line_x_end
self._margin = margin
self._dedup_radius = dedup_radius
self._loading_count = 0
self._unloading_count = 0
# track_id -> zone state for y1: "above" | "below" | None
self._state: dict[int, str | None] = {}
# track_id -> whether this track has EVER been in each zone
self._has_been_above: dict[int, bool] = {}
self._has_been_below: dict[int, bool] = {}
# track_id -> set of directions already counted
self._counted: dict[int, set[str]] = {}
# track_id -> initial coordinates (cx, y1) when first tracked
self._entry_points: dict[int, tuple[float, float]] = {}
# list of active deduplication circles
self._dedup_circles: list[dict] = []
@property
def entry_points(self) -> dict[int, tuple[float, float]]:
return self._entry_points
@property
def counted_tracks(self) -> dict[int, set[str]]:
return self._counted
@property
def line_y(self) -> int:
return self._line_y
@line_y.setter
def line_y(self, value: int) -> None:
self._line_y = value
@property
def line_x_start(self) -> int:
return self._line_x_start
@line_x_start.setter
def line_x_start(self, value: int) -> None:
self._line_x_start = value
@property
def line_x_end(self) -> int:
return self._line_x_end
@line_x_end.setter
def line_x_end(self, value: int) -> None:
self._line_x_end = value
def update(self, detections: list[Detection]) -> list[dict]:
"""Process detections, return list of crossing events.
Hybrid approach:
- Tracks zone state per frame (above/below/in-band)
- BUT uses accumulated history (has_been_above) for counting decision
- A track counts as "loading" when:
1. It has been seen ABOVE the line at any previous point
2. Its current y1 is now BELOW the line
3. It hasn't been counted for loading yet
4. It passes spatial dedup check
"""
now_t = time.time()
events: list[dict] = []
upper = self._line_y - self._margin
lower = self._line_y + self._margin
# Clean up expired dedup circles (older than 3.0 seconds)
self._dedup_circles = [c for c in self._dedup_circles if (now_t - c["time"]) <= 3.0]
for det in detections:
if det.track_id is None:
continue
x1, y1, x2, y2 = det.bbox
cx = (x1 + x2) / 2.0
tid = det.track_id
if tid not in self._entry_points:
self._entry_points[tid] = (cx, y1)
# Skip if centroid X outside counting bounds
if cx < self._line_x_start or cx > self._line_x_end:
continue
counted_dirs = self._counted.setdefault(tid, set())
# Determine y1 zone state (top edge of sack bbox)
if y1 < upper:
new_state = "above"
elif y1 > lower:
new_state = "below"
else:
new_state = self._state.get(tid) # in band: hold
prev_state = self._state.get(tid)
self._state[tid] = new_state
# Track zone history — CRITICAL for low-FPS robustness
# Once a track has been seen above/below, it stays recorded forever
if new_state == "above":
self._has_been_above[tid] = True
elif new_state == "below":
self._has_been_below[tid] = True
# --- HYBRID COUNTING LOGIC ---
# Loading: track was EVER above, NOW below (entered truck from top)
# This works even if the track jumped over the line between frames
is_loading = (
new_state == "below"
and self._has_been_above.get(tid, False)
and "loading" not in counted_dirs
)
# Unloading: track was EVER below, NOW above (left truck)
is_unloading = (
new_state == "above"
and self._has_been_below.get(tid, False)
and "unloading" not in counted_dirs
)
if is_loading or is_unloading:
# Check spatial distance against all active dedup circles
is_duplicate = False
for circle in self._dedup_circles:
dist = ((cx - circle["x"]) ** 2 + (y1 - circle["y"]) ** 2) ** 0.5
if dist <= self._dedup_radius:
is_duplicate = True
break
if is_duplicate:
continue
# Add this coordinate to the active dedup circles
self._dedup_circles.append({
"x": cx,
"y": y1,
"time": now_t,
"track_id": tid
})
if is_loading:
self._loading_count += 1
counted_dirs.add("loading")
events.append({
"track_id": tid,
"direction": "loading",
"cx": cx,
"cy": y1
})
elif is_unloading:
self._unloading_count += 1
counted_dirs.add("unloading")
events.append({
"track_id": tid,
"direction": "unloading",
"cx": cx,
"cy": y1
})
return events
@property
def loading_count(self) -> int:
return self._loading_count
@property
def unloading_count(self) -> int:
return self._unloading_count
@property
def net_count(self) -> int:
return self._loading_count - self._unloading_count
def reset(self) -> None:
"""Reset all counters (new batch)."""
self._loading_count = 0
self._unloading_count = 0
self._state.clear()
self._has_been_above.clear()
self._has_been_below.clear()
self._counted.clear()
self._entry_points.clear()
self._dedup_circles.clear()
+251
View File
@@ -0,0 +1,251 @@
"""Dashboard overlay — draws counting info onto the video frame.
Draws: truck ROI, counting zone (band), sack bounding boxes with y1
marker (the crossing trigger edge), stats panel, batch history,
and system state indicator.
"""
from __future__ import annotations
import cv2
import numpy as np
from src.batch import BatchRecord
from src.interfaces import Detection
from src.truck_roi import TruckROI
# Colors (BGR)
GREEN = (0, 200, 0)
RED = (0, 0, 220)
CYAN = (220, 200, 0)
WHITE = (255, 255, 255)
YELLOW = (0, 230, 255)
MAGENTA = (255, 0, 255)
ORANGE = (0, 165, 255)
GRAY = (140, 140, 140)
DARK_GREEN = (0, 130, 0)
LIGHT_BLUE = (255, 200, 100)
# State display labels and colors
STATE_DISPLAY = {
"IDLE": ("MENCARI TRUK...", ORANGE),
"TRUCK_STABILIZING": ("TRUK TERDETEKSI - STABILISASI", YELLOW),
"COUNTING_SACKS": ("MENGHITUNG KARUNG", GREEN),
"WAITING_FOR_ACTIVITY": ("MENUNGGU PALET / TRUK PERGI", LIGHT_BLUE),
}
class DashboardOverlay:
"""Draws detection boxes, ROI, counting line, and stats onto frames."""
def draw(
self,
frame: np.ndarray,
detections: list[Detection],
roi: TruckROI | None,
loading_count: int,
unloading_count: int,
batch_id: int | None,
history: list[BatchRecord] | None = None,
system_state: str = "IDLE",
batch_duration: float = 0.0,
idle_timer: float = 0.0,
stabilize_progress: float = 0.0,
waiting_duration: float = 0.0,
) -> np.ndarray:
out = frame.copy()
if roi is not None:
self._draw_roi(out, roi)
self._draw_counting_zone(out, roi)
self._draw_detections(out, detections)
self._draw_stats(out, loading_count, unloading_count, batch_id, history)
self._draw_system_state(
out, system_state, batch_duration, idle_timer, stabilize_progress,
waiting_duration,
)
return out
def _draw_roi(self, frame: np.ndarray, roi: TruckROI) -> None:
cv2.rectangle(
frame, (roi.x1, roi.y1), (roi.x2, roi.y2), ORANGE, 2,
)
cv2.putText(
frame, f"TRUCK ROI ({roi.confidence:.0%})",
(roi.x1, roi.y1 - 8),
cv2.FONT_HERSHEY_SIMPLEX, 0.5, ORANGE, 1,
)
# Draw truck top reference line (dashed via short segments)
for x in range(roi.x1, roi.x2, 20):
cv2.line(frame, (x, roi.y1), (min(x + 10, roi.x2), roi.y1), GRAY, 1)
def _draw_counting_zone(
self, frame: np.ndarray, roi: TruckROI, margin: int = 20,
) -> None:
y = roi.line_y
# Draw zone band (semi-transparent)
overlay = frame.copy()
cv2.rectangle(
overlay, (roi.x1, y - margin), (roi.x2, y + margin),
MAGENTA, -1,
)
cv2.addWeighted(overlay, 0.15, frame, 0.85, 0, frame)
# Draw center line
cv2.line(frame, (roi.x1, y), (roi.x2, y), MAGENTA, 2)
cv2.putText(
frame,
f"COUNT LINE Y={y} (y1 trigger)",
(roi.x1, y - margin - 8),
cv2.FONT_HERSHEY_SIMPLEX, 0.5, MAGENTA, 1,
)
def _draw_detections(
self,
frame: np.ndarray,
detections: list[Detection],
) -> None:
for det in detections:
x1, y1, x2, y2 = [int(v) for v in det.bbox]
label = "sack"
if det.track_id is not None:
label += f" #{det.track_id}"
label += f" {det.confidence:.0%}"
cv2.rectangle(frame, (x1, y1), (x2, y2), CYAN, 2)
cv2.putText(
frame, label, (x1, y1 - 6),
cv2.FONT_HERSHEY_SIMPLEX, 0.4, CYAN, 1,
)
# Mark TOP edge (y1) — the crossing trigger
cv2.line(frame, (x1, y1), (x2, y1), GREEN, 3)
def _draw_stats(
self,
frame: np.ndarray,
loading: int,
unloading: int,
batch_id: int | None,
history: list[BatchRecord] | None,
) -> None:
# Panel background
cv2.rectangle(frame, (10, 10), (320, 160), (0, 0, 0), -1)
cv2.rectangle(frame, (10, 10), (320, 160), WHITE, 1)
batch_text = f"Batch #{batch_id}" if batch_id else "IDLE"
net = loading - unloading
y0 = 35
cv2.putText(
frame, batch_text, (20, y0),
cv2.FONT_HERSHEY_SIMPLEX, 0.7, YELLOW, 2,
)
cv2.putText(
frame, f"Loading: {loading}", (20, y0 + 30),
cv2.FONT_HERSHEY_SIMPLEX, 0.6, GREEN, 2,
)
cv2.putText(
frame, f"Unloading: {unloading}", (20, y0 + 60),
cv2.FONT_HERSHEY_SIMPLEX, 0.6, RED, 2,
)
cv2.putText(
frame, f"Net: {net}", (20, y0 + 90),
cv2.FONT_HERSHEY_SIMPLEX, 0.6, WHITE, 2,
)
# History (last 3 batches)
if history:
y_h = 180
cv2.putText(
frame, "HISTORY", (20, y_h),
cv2.FONT_HERSHEY_SIMPLEX, 0.5, YELLOW, 1,
)
for rec in history[-3:]:
y_h += 22
txt = (
f"B#{rec.batch_id}: "
f"L={rec.loading_count} "
f"U={rec.unloading_count} "
f"Net={rec.net_count}"
)
cv2.putText(
frame, txt, (20, y_h),
cv2.FONT_HERSHEY_SIMPLEX, 0.4, WHITE, 1,
)
def _draw_system_state(
self,
frame: np.ndarray,
system_state: str,
batch_duration: float,
idle_timer: float,
stabilize_progress: float,
waiting_duration: float = 0.0,
) -> None:
"""Draw system state indicator bar at bottom of frame."""
h, w = frame.shape[:2]
# Get display info for current state
label, color = STATE_DISPLAY.get(system_state, ("UNKNOWN", GRAY))
# Draw state bar background
bar_h = 36
bar_y = h - bar_h
overlay = frame.copy()
cv2.rectangle(overlay, (0, bar_y), (w, h), (0, 0, 0), -1)
cv2.addWeighted(overlay, 0.7, frame, 0.3, 0, frame)
# Draw colored indicator dot
cv2.circle(frame, (20, bar_y + bar_h // 2), 8, color, -1)
cv2.circle(frame, (20, bar_y + bar_h // 2), 8, WHITE, 1)
# Draw state label
cv2.putText(
frame, label, (36, bar_y + bar_h // 2 + 5),
cv2.FONT_HERSHEY_SIMPLEX, 0.55, color, 2,
)
# Draw additional info based on state
if system_state == "TRUCK_STABILIZING":
# Draw stabilization progress bar
prog_x = 340
prog_w = 150
prog_h = 14
prog_y = bar_y + (bar_h - prog_h) // 2
cv2.rectangle(frame, (prog_x, prog_y), (prog_x + prog_w, prog_y + prog_h), GRAY, 1)
fill_w = int(prog_w * stabilize_progress)
if fill_w > 0:
cv2.rectangle(frame, (prog_x, prog_y), (prog_x + fill_w, prog_y + prog_h), YELLOW, -1)
pct_text = f"{stabilize_progress * 100:.0f}%"
cv2.putText(
frame, pct_text, (prog_x + prog_w + 8, prog_y + prog_h - 2),
cv2.FONT_HERSHEY_SIMPLEX, 0.4, YELLOW, 1,
)
elif system_state == "COUNTING_SACKS":
# Draw batch duration and idle timer
info_x = 340
dur_text = f"Durasi: {batch_duration:.0f}s"
cv2.putText(
frame, dur_text, (info_x, bar_y + 15),
cv2.FONT_HERSHEY_SIMPLEX, 0.4, WHITE, 1,
)
if idle_timer > 0:
idle_color = RED if idle_timer > 7.0 else (YELLOW if idle_timer > 4.0 else WHITE)
idle_text = f"Idle: {idle_timer:.1f}s / 10s"
cv2.putText(
frame, idle_text, (info_x, bar_y + 30),
cv2.FONT_HERSHEY_SIMPLEX, 0.4, idle_color, 1,
)
elif system_state == "WAITING_FOR_ACTIVITY":
# Show waiting duration and batch info
info_x = 360
wait_text = f"Menunggu: {waiting_duration:.0f}s | Batch masih terbuka"
cv2.putText(
frame, wait_text, (info_x, bar_y + bar_h // 2 + 5),
cv2.FONT_HERSHEY_SIMPLEX, 0.4, LIGHT_BLUE, 1,
)
+82
View File
@@ -0,0 +1,82 @@
"""YOLO-based detectors for sacks and trucks.
Each detector is a single-responsibility unit (S). New model types can be
added as new classes without touching these (O).
"""
from __future__ import annotations
import numpy as np
from ultralytics import YOLO
from src.interfaces import Detection
class SackDetector:
"""Detects sacks (and persons) using a YOLO segmentation model."""
def __init__(self, model_path: str, conf: float = 0.40) -> None:
self._model = YOLO(model_path)
self._conf = conf
def detect(self, frame: np.ndarray) -> list[Detection]:
results = self._model.predict(
frame, conf=self._conf, verbose=False
)
return self._parse(results[0])
def _parse(self, result) -> list[Detection]:
detections: list[Detection] = []
masks = result.masks
for i, box in enumerate(result.boxes):
cls_id = int(box.cls[0])
name = self._model.names[cls_id]
if name != "sack":
continue
x1, y1, x2, y2 = box.xyxy[0].tolist()
mask = None
if masks is not None and i < len(masks):
mask = masks[i].data.cpu().numpy().squeeze()
detections.append(
Detection(
bbox=(x1, y1, x2, y2),
confidence=float(box.conf[0]),
class_id=cls_id,
class_name=name,
mask=mask,
)
)
return detections
class TruckDetector:
"""Detects trucks using a YOLO detection model."""
def __init__(self, model_path_or_model: str | YOLO, conf: float = 0.50) -> None:
if isinstance(model_path_or_model, str):
self._model = YOLO(model_path_or_model)
else:
self._model = model_path_or_model
self._conf = conf
def detect(self, frame: np.ndarray) -> list[Detection]:
results = self._model.predict(
frame, conf=self._conf, verbose=False
)
return self._parse(results[0])
def _parse(self, result) -> list[Detection]:
detections: list[Detection] = []
for box in result.boxes:
cls_id = int(box.cls[0])
name = self._model.names[cls_id]
x1, y1, x2, y2 = box.xyxy[0].tolist()
detections.append(
Detection(
bbox=(x1, y1, x2, y2),
confidence=float(box.conf[0]),
class_id=cls_id,
class_name=name,
)
)
return detections
+98
View File
@@ -0,0 +1,98 @@
"""Abstract interfaces — all components code against these, never concretions.
Keeps Interface Segregation (I) and Dependency Inversion (D) satisfied.
Each protocol is tiny and single-purpose (S).
"""
from __future__ import annotations
from dataclasses import dataclass, field
from typing import Protocol, runtime_checkable
import numpy as np
# ── Data transfer objects ────────────────────────────────────────────────
@dataclass
class Detection:
"""Single object detection."""
bbox: tuple[float, float, float, float] # x1, y1, x2, y2
confidence: float
class_id: int
class_name: str
track_id: int | None = None
mask: np.ndarray | None = None # segmentation mask (optional)
@dataclass
class FrameResult:
"""All detections for one frame."""
detections: list[Detection] = field(default_factory=list)
frame_index: int = 0
timestamp: float = 0.0
# ── Protocols ────────────────────────────────────────────────────────────
@runtime_checkable
class StreamSource(Protocol):
"""Reads frames from a video source."""
def open(self) -> bool: ...
def read(self) -> tuple[bool, np.ndarray | None]: ...
def release(self) -> None: ...
@property
def fps(self) -> float: ...
@property
def frame_size(self) -> tuple[int, int]: ...
@runtime_checkable
class Detector(Protocol):
"""Runs inference on a frame and returns detections."""
def detect(self, frame: np.ndarray) -> list[Detection]: ...
@runtime_checkable
class Tracker(Protocol):
"""Assigns persistent IDs to detections across frames."""
def update(
self, frame: np.ndarray, detections: list[Detection]
) -> list[Detection]: ...
def reset(self) -> None: ...
@runtime_checkable
class Counter(Protocol):
"""Counts objects crossing a virtual boundary."""
def update(self, detections: list[Detection]) -> None: ...
@property
def loading_count(self) -> int: ...
@property
def unloading_count(self) -> int: ...
def reset(self) -> None: ...
@runtime_checkable
class BatchManager(Protocol):
"""Manages batch lifecycle based on truck presence."""
def update(self, truck_detected: bool, timestamp: float) -> None: ...
@property
def current_batch_id(self) -> int | None: ...
@property
def is_active(self) -> bool: ...
+126
View File
@@ -0,0 +1,126 @@
"""Bounding-box stabilizer — EMA smoothing + dual height clamping + dropout hold.
Addresses four occlusion/flickering problems:
1. Bbox jitter: raw detections jump 10-50px between frames.
Fix: EMA (exponential moving average) on bbox coordinates.
2. Bbox loss at line: worker's head/body blocks sack for 5-10 frames.
Fix: hold last known smoothed bbox for `max_hold_frames` (10 frames).
3. Height expansion spike: worker body merges into sack bbox.
Fix: clamp height expansion (`raw_h > smooth_h * max_h_ratio`).
4. Height shrinkage collapse: worker head/shoulder covers bottom of sack.
Fix: clamp height shrinkage (`raw_h < smooth_h * min_h_ratio`).
All rules are applied per track ID to maintain smooth trajectories.
"""
from __future__ import annotations
from src.interfaces import Detection
class BboxStabilizer:
"""Smooths and holds bounding boxes per track ID against worker occlusion."""
def __init__(
self,
ema_alpha: float = 0.35,
max_hold_frames: int = 10,
max_height_ratio: float = 1.5,
min_height_ratio: float = 0.70,
) -> None:
self._alpha = ema_alpha
self._max_hold = max_hold_frames
self._max_h_ratio = max_height_ratio
self._min_h_ratio = min_height_ratio
# tid -> (smoothed_x1, smoothed_y1, smoothed_x2, smoothed_y2)
self._smooth: dict[int, tuple[float, float, float, float]] = {}
# tid -> frames since last real detection
self._age: dict[int, int] = {}
# tid -> last confidence and class info
self._meta: dict[int, tuple[float, int, str]] = {}
def update(self, detections: list[Detection]) -> list[Detection]:
"""Smooth incoming detections + inject held tracks during occlusion."""
seen_tids: set[int] = set()
result: list[Detection] = []
# 1. Process real detections — apply EMA & dual height clamping
for det in detections:
tid = det.track_id
if tid is None:
result.append(det)
continue
seen_tids.add(tid)
self._age[tid] = 0
self._meta[tid] = (det.confidence, det.class_id, det.class_name)
x1, y1, x2, y2 = det.bbox
raw_h = y2 - y1
if tid in self._smooth:
sx1, sy1, sx2, sy2 = self._smooth[tid]
smooth_h = sy2 - sy1
if smooth_h > 0:
# Height expansion clamp (worker body merged)
if raw_h > smooth_h * self._max_h_ratio:
y2 = y1 + smooth_h * self._max_h_ratio
# Height shrinkage clamp (worker head/shoulder blocking bottom)
elif raw_h < smooth_h * self._min_h_ratio:
y2 = y1 + smooth_h * self._min_h_ratio
a = self._alpha
sx1 = a * x1 + (1 - a) * sx1
sy1 = a * y1 + (1 - a) * sy1
sx2 = a * x2 + (1 - a) * sx2
sy2 = a * y2 + (1 - a) * sy2
else:
sx1, sy1, sx2, sy2 = x1, y1, x2, y2
self._smooth[tid] = (sx1, sy1, sx2, sy2)
result.append(Detection(
bbox=(sx1, sy1, sx2, sy2),
confidence=det.confidence,
class_id=det.class_id,
class_name=det.class_name,
track_id=tid,
mask=det.mask,
))
# 2. Hold tracks missing this frame (occlusion tolerance)
expired: list[int] = []
for tid in list(self._age.keys()):
if tid in seen_tids:
continue
self._age[tid] += 1
if self._age[tid] > self._max_hold:
expired.append(tid)
continue
# Inject held bbox from last smoothed position
sx1, sy1, sx2, sy2 = self._smooth[tid]
conf, cls_id, cls_name = self._meta[tid]
result.append(Detection(
bbox=(sx1, sy1, sx2, sy2),
confidence=conf * 0.85, # gentle decay during occlusion hold
class_id=cls_id,
class_name=cls_name,
track_id=tid,
))
# 3. Clean up expired tracks
for tid in expired:
del self._smooth[tid]
del self._age[tid]
del self._meta[tid]
return result
def reset(self) -> None:
"""Clear all state (new batch)."""
self._smooth.clear()
self._age.clear()
self._meta.clear()
+83
View File
@@ -0,0 +1,83 @@
"""FastTrack wrapper — occlusion-aware tracker with custom tuning.
Uses Ultralytics FastTrack which handles:
- Kalman rollback on occlusion onset (restores pre-occlusion velocity)
- Enlarged search region during occlusion
- Re-identification of occluded tracks after reappearance
Our custom cfg/tracker.yaml tunes:
- track_buffer=60 (hold lost tracks ~2.4s to survive worker occlusion)
- new_track_thresh=0.3 (prevent duplicate IDs from spawning)
- active_occ_to_lost_thresh=15 (tolerate 15 occluded frames)
"""
from __future__ import annotations
import os
import numpy as np
from ultralytics import YOLO
from src.interfaces import Detection
_TRACKER_CFG = os.path.join(
os.path.dirname(os.path.dirname(__file__)), "cfg", "tracker.yaml"
)
class ByteTrackTracker:
"""Tracks sacks across frames using FastTrack (occlusion-aware)."""
def __init__(self, model_path_or_model: str | YOLO, conf: float = 0.35) -> None:
if isinstance(model_path_or_model, str):
self._model = YOLO(model_path_or_model)
self._model_path = model_path_or_model
else:
self._model = model_path_or_model
self._model_path = model_path_or_model.ckpt_path if hasattr(model_path_or_model, 'ckpt_path') else ""
self._conf = conf
self._tracker_cfg = _TRACKER_CFG
def update(
self, frame: np.ndarray, detections: list[Detection]
) -> list[Detection]:
"""Run tracking on the frame, return detections with track IDs."""
results = self._model.track(
frame,
conf=self._conf,
persist=True,
tracker=self._tracker_cfg,
verbose=False,
)
return self._parse(results[0])
def _parse(self, result) -> list[Detection]:
tracked: list[Detection] = []
ids = result.boxes.id
for i, box in enumerate(result.boxes):
cls_id = int(box.cls[0])
name = self._model.names[cls_id]
# Retain both 'sack' and 'truck' classes
if name not in ("sack", "truck"):
continue
track_id = int(ids[i]) if ids is not None else None
x1, y1, x2, y2 = box.xyxy[0].tolist()
mask = None
tracked.append(
Detection(
bbox=(x1, y1, x2, y2),
confidence=float(box.conf[0]),
class_id=cls_id,
class_name=name,
track_id=track_id,
mask=mask,
)
)
return tracked
def reset(self) -> None:
"""Reset tracker state (new batch / new truck)."""
if self._model_path:
self._model = YOLO(self._model_path)
+151
View File
@@ -0,0 +1,151 @@
"""Truck ROI tracker — identifies the main truck and provides a stable ROI.
Uses exponential moving average (EMA) to smooth the bounding box across
frames, preventing jitter from frame-to-frame detection variance.
For y2-based counting (bottom edge of sack bbox), the counting line is
placed `LINE_OFFSET_PX` pixels relative to the truck bottom edge (`roi.y2`).
With `offset = +20`, the line sits at `roi.y2 + 20` (~620px), cleanly
separating sacks on the ground (`y2 > 650`) from loaded sacks (`y2 < 580`).
"""
from __future__ import annotations
from dataclasses import dataclass
from src.interfaces import Detection
# Offset for y1 counting line relative to truck top edge (px).
# Positive = below truck top edge (into the truck).
# Negative = above truck top edge (towards the camera).
LINE_OFFSET_PX = 0
@dataclass
class TruckROI:
"""Region of interest derived from the main truck bbox."""
x1: int
y1: int
x2: int
y2: int
line_y: int # counting line Y position (pixels)
confidence: float
@property
def width(self) -> int:
return self.x2 - self.x1
@property
def height(self) -> int:
return self.y2 - self.y1
def contains_x(self, cx: float) -> bool:
"""Check if a centroid X falls within the truck X bounds."""
return self.x1 <= cx <= self.x2
class TruckROITracker:
"""Tracks the main truck and provides a smoothed ROI + counting line.
Main truck = largest truck detection whose center X falls in the
expected lane (center region of the frame).
The counting line is placed `line_offset` pixels below the truck
bottom edge (`roi.y2`).
"""
def __init__(
self,
frame_width: int,
frame_height: int,
lane_x_min: float = 0.35,
lane_x_max: float = 0.80,
ema_alpha: float = 0.15,
line_offset: int = LINE_OFFSET_PX,
) -> None:
self._fw = frame_width
self._fh = frame_height
self._lane_x_min = int(lane_x_min * frame_width)
self._lane_x_max = int(lane_x_max * frame_width)
self._alpha = ema_alpha
self._line_offset = line_offset
# Smoothed bbox (None until first detection)
self._sx1: float | None = None
self._sy1: float | None = None
self._sx2: float | None = None
self._sy2: float | None = None
self._last_roi: TruckROI | None = None
self._frames_without_truck = 0
def update(self, truck_detections: list[Detection]) -> TruckROI | None:
"""Pick the main truck, smooth its bbox, return ROI."""
main = self._pick_main_truck(truck_detections)
if main is None:
self._frames_without_truck += 1
if self._frames_without_truck > 5: # Clear ROI if truck is missing for >5 updates (~3 seconds)
self.reset()
return None
return self._last_roi # hold last known ROI briefly
self._frames_without_truck = 0
x1, y1, x2, y2 = main.bbox
# EMA smoothing
if self._sx1 is None:
self._sx1, self._sy1 = float(x1), float(y1)
self._sx2, self._sy2 = float(x2), float(y2)
else:
a = self._alpha
self._sx1 = a * x1 + (1 - a) * self._sx1
self._sy1 = a * y1 + (1 - a) * self._sy1
self._sx2 = a * x2 + (1 - a) * self._sx2
self._sy2 = a * y2 + (1 - a) * self._sy2
# Build ROI — line placed at truck top edge
roi_x1 = max(0, int(self._sx1))
roi_y1 = max(0, int(self._sy1))
roi_x2 = min(self._fw, int(self._sx2))
roi_y2 = min(self._fh, int(self._sy2))
line_y = roi_y1 + self._line_offset
self._last_roi = TruckROI(
x1=roi_x1, y1=roi_y1, x2=roi_x2, y2=roi_y2,
line_y=line_y, confidence=main.confidence,
)
return self._last_roi
@property
def roi(self) -> TruckROI | None:
return self._last_roi
@property
def frames_without_truck(self) -> int:
return self._frames_without_truck
def reset(self) -> None:
self._sx1 = self._sy1 = self._sx2 = self._sy2 = None
self._last_roi = None
self._frames_without_truck = 0
def _pick_main_truck(
self, detections: list[Detection]
) -> Detection | None:
"""Select the largest truck whose center X is in the expected lane."""
best: Detection | None = None
best_area = 0
for det in detections:
x1, y1, x2, y2 = det.bbox
cx = (x1 + x2) / 2
if not (self._lane_x_min <= cx <= self._lane_x_max):
continue
area = (x2 - x1) * (y2 - y1)
if area > best_area:
best = det
best_area = area
return best
+43
View File
@@ -0,0 +1,43 @@
{
"palet": [
[
612,
628
],
[
1454,
630
],
[
1458,
1074
],
[
608,
1071
]
],
"truck": [
[600, 385],
[609, 1076],
[1404, 1078],
[1381, 343]
],
"counting": [
[574, 50],
[586, 1077],
[1418, 1076],
[1397, 50]
],
"left_limit": 0.27578,
"right_limit": 0.72578,
"duplicate_circle_radius": 60,
"min_valid_area": 15000,
"jarak_toleransi_duplikat": 30,
"max_reid_transit_distance": 400,
"circle_stay_timeout_sec": 10.0,
"inference_stride": 2,
"confirm_delay_sec": 0.5,
"exit_confirm_delay_sec": 6.0,
"external_stream_url": "http://192.168.192.96:8888/cam/"
}