matrice-streaming 0.1.69__tar.gz → 0.1.70__tar.gz

{matrice_streaming-0.1.69 → matrice_streaming-0.1.70}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matrice_streaming
-Version: 0.1.69
+Version: 0.1.70
 Summary: Common server utilities for Matrice.ai services
 Author-email: "Matrice.ai" <dipendra@matrice.ai>
 License-Expression: MIT

{matrice_streaming-0.1.69 → matrice_streaming-0.1.70}/matrice_streaming.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matrice_streaming
-Version: 0.1.69
+Version: 0.1.70
 Summary: Common server utilities for Matrice.ai services
 Author-email: "Matrice.ai" <dipendra@matrice.ai>
 License-Expression: MIT

{matrice_streaming-0.1.69 → matrice_streaming-0.1.70}/src/matrice_streaming/streaming_gateway/camera_streamer/async_camera_worker.py

@@ -88,7 +88,7 @@ class AsyncCameraWorker:
         health_queue: multiprocessing.Queue,
         command_queue: Optional[multiprocessing.Queue] = None,
         response_queue: Optional[multiprocessing.Queue] = None,
-        frame_optimizer_enabled: bool = True,
+        frame_optimizer_enabled: bool = False,  # Disabled for ML quality
         frame_optimizer_config: Optional[Dict[str, Any]] = None,
         # ================================================================
         # SHM_MODE: New parameters for shared memory architecture
@@ -99,7 +99,7 @@ class AsyncCameraWorker:
         # ================================================================
         # PERFORMANCE: New parameters for optimized frame capture
         # ================================================================
-        drop_stale_frames: bool = True,  # Use grab()/grab()/retrieve() pattern for latest frame
+        drop_stale_frames: bool = False,  # Disabled for ML quality
         pin_cpu_affinity: bool = True,   # Pin worker to specific CPU cores
         total_workers: int = 1,          # Total worker count for CPU affinity calculation
         buffer_size: int = 1,            # Minimal buffer for low latency (cv2_bench uses 1)
@@ -1313,10 +1313,14 @@ def run_async_worker(
     # ================================================================
     # PERFORMANCE: New parameters for optimized frame capture
     # ================================================================
-    drop_stale_frames: bool = True,
+    drop_stale_frames: bool = False,  # Disabled for ML quality
     pin_cpu_affinity: bool = True,
     total_workers: int = 1,
     buffer_size: int = 1,
+    # ================================================================
+    # FRAME OPTIMIZER: Control frame similarity detection
+    # ================================================================
+    frame_optimizer_enabled: bool = False,  # Disabled for ML quality
 ):
     """Entry point for async worker process.
 
@@ -1337,6 +1341,7 @@ def run_async_worker(
         pin_cpu_affinity: Pin worker process to specific CPU cores
         total_workers: Total number of workers for CPU affinity calculation
         buffer_size: VideoCapture buffer size (1 = minimal latency)
+        frame_optimizer_enabled: Enable frame similarity detection (skip similar frames)
     """
     # Setup logging for this process
     logging.basicConfig(
@@ -1378,6 +1383,8 @@ def run_async_worker(
             pin_cpu_affinity=pin_cpu_affinity,
             total_workers=total_workers,
             buffer_size=buffer_size,
+            # FRAME OPTIMIZER: Pass through frame similarity detection setting
+            frame_optimizer_enabled=frame_optimizer_enabled,
         )
 
         # Run event loop

{matrice_streaming-0.1.69 → matrice_streaming-0.1.70}/src/matrice_streaming/streaming_gateway/camera_streamer/async_ffmpeg_worker.py

@@ -86,7 +86,7 @@ class AsyncFFmpegWorker:
         pin_cpu_affinity: bool = True,
         total_workers: int = 1,
         # Frame optimizer options
-        frame_optimizer_enabled: bool = True,
+        frame_optimizer_enabled: bool = False,  # Disabled for ML quality
         frame_optimizer_config: Optional[Dict[str, Any]] = None,
     ):
         """Initialize async FFmpeg worker.
@@ -905,7 +905,7 @@ def run_ffmpeg_worker(
     shm_frame_format: str = "BGR",
     pin_cpu_affinity: bool = True,
     total_workers: int = 1,
-    frame_optimizer_enabled: bool = True,
+    frame_optimizer_enabled: bool = False,  # Disabled for ML quality
     frame_optimizer_config: Optional[Dict[str, Any]] = None,
 ):
     """Entry point for FFmpeg worker process.

{matrice_streaming-0.1.69 → matrice_streaming-0.1.70}/src/matrice_streaming/streaming_gateway/camera_streamer/camera_streamer.py

@@ -41,7 +41,7 @@ class CameraStreamer:
         gateway_util: StreamingGatewayUtil = None,
         connection_refresh_threshold: int = 10,
         connection_refresh_interval: float = 60.0,
-        frame_optimizer_enabled: bool = True,
+        frame_optimizer_enabled: bool = False,  # Disabled for ML quality
         frame_optimizer_config: Optional[Dict[str, Any]] = None,
     ):
         """Initialize CameraStreamer.

{matrice_streaming-0.1.69 → matrice_streaming-0.1.70}/src/matrice_streaming/streaming_gateway/camera_streamer/ffmpeg_camera_streamer.py

@@ -315,7 +315,7 @@ class FFmpegCameraStreamer:
         shm_slot_count: int = 1000,
         shm_frame_format: str = "BGR",
         # Frame optimizer options
-        frame_optimizer_enabled: bool = True,
+        frame_optimizer_enabled: bool = False,  # Disabled for ML quality
         frame_optimizer_config: Optional[Dict[str, Any]] = None,
         # CPU affinity options
         pin_cpu_affinity: bool = False,

{matrice_streaming-0.1.69 → matrice_streaming-0.1.70}/src/matrice_streaming/streaming_gateway/camera_streamer/gstreamer_camera_streamer.py

@@ -532,7 +532,7 @@ class GStreamerCameraStreamer:
         video_codec: Optional[str] = None,
         gateway_util: StreamingGatewayUtil = None,
         gstreamer_config: Optional[GStreamerConfig] = None,
-        frame_optimizer_enabled: bool = True,
+        frame_optimizer_enabled: bool = False,  # Disabled for ML quality
         frame_optimizer_config: Optional[Dict[str, Any]] = None,
     ):
         """Initialize GStreamerCameraStreamer.

{matrice_streaming-0.1.69 → matrice_streaming-0.1.70}/src/matrice_streaming/streaming_gateway/camera_streamer/worker_manager.py

@@ -43,9 +43,13 @@ class WorkerManager:
         # ================================================================
         # PERFORMANCE: New parameters for optimized frame capture
         # ================================================================
-        drop_stale_frames: bool = True,   # Use grab()/grab()/retrieve() for latest frame
+        drop_stale_frames: bool = False,   # Use grab()/grab()/retrieve() for latest frame (disabled for ML quality)
         pin_cpu_affinity: bool = True,    # Pin workers to specific CPU cores
         buffer_size: int = 1,             # VideoCapture buffer size (1 = minimal latency)
+        # ================================================================
+        # FRAME OPTIMIZER: Control frame similarity detection
+        # ================================================================
+        frame_optimizer_enabled: bool = False,  # Enable frame similarity detection (disabled for ML quality)
     ):
         """Initialize worker manager with dynamic CPU-based scaling.
 
@@ -62,6 +66,7 @@ class WorkerManager:
             drop_stale_frames: Use grab()/grab()/retrieve() pattern for latest frame
             pin_cpu_affinity: Pin worker processes to specific CPU cores for cache locality
             buffer_size: VideoCapture buffer size (1 = minimal latency)
+            frame_optimizer_enabled: Enable frame similarity detection (skip similar frames for bandwidth saving)
         """
         self.camera_configs = camera_configs
         self.stream_config = stream_config
@@ -122,14 +127,28 @@ class WorkerManager:
         self.pin_cpu_affinity = pin_cpu_affinity
         self.buffer_size = buffer_size
 
-        if drop_stale_frames or pin_cpu_affinity:
+        # ================================================================
+        # FRAME OPTIMIZER: Store frame similarity detection configuration
+        # ================================================================
+        self.frame_optimizer_enabled = frame_optimizer_enabled
+
+        if frame_optimizer_enabled:
             self.logger.info(
-                f"PERFORMANCE OPTIMIZATIONS ENABLED: "
-                f"drop_stale_frames={drop_stale_frames}, "
-                f"pin_cpu_affinity={pin_cpu_affinity}, "
-                f"buffer_size={buffer_size}"
+                "FRAME OPTIMIZER ENABLED: Similar frames will be skipped (may reduce ML quality)"
             )
 
+        if drop_stale_frames:
+            self.logger.info(
+                "DROP STALE FRAMES ENABLED: Using grab/grab/retrieve pattern (may reduce ML quality)"
+            )
+
+        self.logger.info(
+            f"Worker config: frame_optimizer={frame_optimizer_enabled}, "
+            f"drop_stale_frames={drop_stale_frames}, "
+            f"pin_cpu_affinity={pin_cpu_affinity}, "
+            f"buffer_size={buffer_size}"
+        )
+
         # Note: Batch parameters are calculated per-worker in _start_worker()
         # based on each worker's camera count, not the global total.
         # This ensures optimal batching when cameras are distributed across workers.
@@ -291,6 +310,8 @@ class WorkerManager:
                     self.pin_cpu_affinity,
                     self.num_workers,     # Total workers for CPU affinity calculation
                     self.buffer_size,
+                    # FRAME OPTIMIZER: Pass frame similarity detection setting
+                    self.frame_optimizer_enabled,
                 ),
                 name=f"AsyncWorker-{worker_id}",
                 daemon=False  # Non-daemon so we can properly wait for shutdown