supervision 0.29.0 release notes

🚀 Added

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

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

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

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 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 and sv.VertexAnnotator now respect the visible mask. Invisible keypoints and their edges are skipped during rendering. (#2286)
sv.EdgeAnnotator and sv.VertexLabelAnnotator 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 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 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 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

Deprecated	Removal	Replacement
`KeyPoints.confidence`	`0.32.0`	`KeyPoints.keypoint_confidence`
`merge_inner_detection_object_pair`	`0.32.0`	None (internal use only)
`merge_inner_detections_objects`	`0.32.0`	None (internal use only)
`merge_inner_detections_objects_without_iou`	`0.32.0`	None (internal use only)
`validate_detections_fields`	`0.32.0`	None (internal use only)
`validate_vlm_parameters`	`0.32.0`	None (internal use only)
`validate_fields_both_defined_or_none`	`0.32.0`	None (internal use only)
`validate_xyxy`	`0.32.0`	None (internal use only)
`validate_mask`	`0.32.0`	None (internal use only)
`validate_class_id`	`0.32.0`	None (internal use only)
`validate_confidence`	`0.32.0`	None (internal use only)
`validate_tracker_id`	`0.32.0`	None (internal use only)
`validate_data`	`0.32.0`	None (internal use only)
`validate_xy`	`0.32.0`	None (internal use only)
`validate_key_point_confidence`	`0.32.0`	None (internal use only)
`validate_key_points_fields`	`0.32.0`	None (internal use only)
`validate_resolution`	`0.32.0`	None (internal use only)
`validate_custom_values`	`0.32.0`	None (internal use only)
`validate_input_tensors`	`0.32.0`	None (internal use only)
`validate_labels`	`0.32.0`	None (internal use only)

🏆 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)

supervision 0.29.0

supervision-0.29.0

🚀 Added

🌱 Changed

🔧 Fixed

⚠️ Deprecated

🏆 Contributors