supervision Files

🚀 Added

• Added sv.VertexEllipseAreaAnnotator (supervision.roboflow.com), sv.VertexEllipseOutlineAnnotator (supervision.roboflow.com), and sv.VertexEllipseHaloAnnotator (supervision.roboflow.com) for visualizing keypoint uncertainty as covariance ellipses. (#2277, #2286)

  ```python import cv2 import supervision as sv from rfdetr import RFDETRKeypointPreview

  image = cv2.imread("<SOURCE_IMAGE_PATH>") model = RFDETRKeypointPreview()

  key_points = model.predict(image)

  annotator = sv.VertexEllipseAreaAnnotator( sigma=[1.0, 2.0, 3.0], color=[sv.Color.GREEN, sv.Color.YELLOW, sv.Color.RED], opacity=0.4, ) annotated = annotator.annotate(image.copy(), key_points) ```

  https://github.com/user-attachments/assets/e01322ff-f39c-420c-bf72-81efba8b0fd3

  ```python import cv2 import supervision as sv from rfdetr import RFDETRKeypointPreview

  image = cv2.imread("<SOURCE_IMAGE_PATH>") model = RFDETRKeypointPreview()

  key_points = model.predict(image)

  annotator = sv.VertexEllipseOutlineAnnotator( sigma=[1.0, 2.0, 3.0], color=[sv.Color.GREEN, sv.Color.YELLOW, sv.Color.RED], thickness=2, ) annotated = annotator.annotate(image.copy(), key_points) ```

  https://github.com/user-attachments/assets/bce268c4-7e85-477b-b90c-9f12ef8500b2

  ```python import cv2 import supervision as sv from rfdetr import RFDETRKeypointPreview

  image = cv2.imread("<SOURCE_IMAGE_PATH>") model = RFDETRKeypointPreview()

  key_points = model.predict(image)

  annotator = sv.VertexEllipseHaloAnnotator( sigma=[1.0, 2.0, 3.0], color=[sv.Color.GREEN, sv.Color.YELLOW, sv.Color.RED], opacity=0.6, ) annotated = annotator.annotate(image.copy(), key_points) ```

  https://github.com/user-attachments/assets/b8662ea4-666a-4ac7-a2fb-11d59c68fd74

• Added sv.oriented_box_non_max_suppression and sv.oriented_box_non_max_merge for performing NMS and NMM directly on oriented bounding boxes. (#2303)

• Added OBB (Oriented Bounding Box) support to sv.ConfusionMatrix (supervision.roboflow.com) via MetricTarget.ORIENTED_BOUNDING_BOXES. (#2247)

• Added preserve_audio parameter to sv.process_video. When enabled, the audio stream from the source video is muxed into the output using ffmpeg. (#2252)

• Added is_obb parameter to sv.DetectionDataset.as_yolo for exporting oriented bounding box annotations in the YOLO OBB format (9-token lines with 4 corner coordinates). (#2302, #2289)

🌱 Changed

• sv.EdgeAnnotator (supervision.roboflow.com) and sv.VertexAnnotator (supervision.roboflow.com) now respect the visible mask. Invisible keypoints and their edges are skipped during rendering. (#2286)

• sv.EdgeAnnotator (supervision.roboflow.com) and sv.VertexLabelAnnotator (supervision.roboflow.com) now support per-class skeleton definitions, enabling correct rendering when multiple skeleton topologies (e.g. person + animal) coexist in one frame. (#2286)

• sv.Detections.with_nms and sv.Detections.with_nmm are now OBB-aware. When data[ORIENTED_BOX_COORDINATES] is present, oriented-box IoU is used automatically instead of axis-aligned box IoU. (#2303)

• sv.Detections.area (supervision.roboflow.com) is now OBB-aware. When oriented box coordinates are present, the property returns the polygon area of the rotated bounding box (via the shoelace formula) instead of the axis-aligned box area. (#2306)

• sv.InferenceSlicer (supervision.roboflow.com) now detects OBB outputs from callbacks and automatically falls back to sequential processing to avoid thread-safety issues when thread_workers > 1. (#2256)

• Fixed sv.oriented_box_iou_batch to correctly handle non-square canvases. Previously, rasterization assumed square dimensions, leading to incorrect IoU values for tall or wide images. (#2282)

🔧 Fixed

• Fixed sv.process_video audio stream handling. The audio muxing path now correctly creates temp files on the same filesystem, decodes ffmpeg errors, and avoids muxing incomplete output. (#2252)

• Fixed sv.Detections.from_vlm returning None for class_id on empty VLM parses. Now returns an empty int ndarray. (#2239)

• Fixed sv.Detections.from_inference to preserve class_name as a string-dtype array when predictions are empty. Previously it returned an untyped empty array. (#2270)

• Fixed sv.HeatMapAnnotator (supervision.roboflow.com) divide-by-zero crash when called with empty detections. (#2269)

• Fixed COCO export emitting 0-indexed category_id values. Now correctly emits 1-indexed IDs as per the COCO specification. (#2276)

• Fixed COCO annotation and image IDs not being chainable across dataset splits. IDs are now sequential across train/val/test. (#2267)

• Fixed sv.DetectionDataset.as_yolo losing OBB rotation when exporting oriented bounding boxes. (#2289)

• Fixed YOLO dataset loading to sort class names by numeric keys when the data.yaml uses integer class IDs. (#2296)

• Fixed letterbox utility to support grayscale images. (#2297)

• Fixed file extension filters to normalize casing (e.g. .JPG now matches .jpg). (#2298)

⚠️ Deprecated

🏆 Contributors

@SkalskiP (Piotr Skalski), @Borda (Jirka Borovec), @kounelisagis (Agis Kounelis), @RitwijParmar (Ritwij Aryan Parmar), @Khanz9664 (Shahid Ul Islam), @satishkc7 (SATISH K C), @Ace3Z (Mahbod Tajdini), @Madhav-C, @RubenHaisma (Ruben Haisma), @adhavan18 (Tamil Adhavan), @Bortlesboat (Andrew Barnes), @Lourdhu02, @tarunbommawar27, @YousefZahran1 (Youssef Ibrahim), @JFrench-Enterprise, @Patel-Prem (Premkumar Patel)