Skip to content

Deprecated

These features are phased out due to better alternatives or potential issues in future versions. Deprecated functionalities are typically supported for multiple subsequent releases, providing time for users to transition to updated methods.

  • sv.ByteTrack is deprecated in supervision-0.28.0 in favour of ByteTrackTracker from the external trackers package (pip install trackers). The update method is renamed from update_with_detections() to update(). Removal is planned for supervision-0.31.0.
  • supervision.keypoint module is deprecated in supervision-0.27.0; use supervision.key_points instead. It will be removed in supervision-0.31.0.
  • create_tiles in supervision.utils.image is deprecated in supervision-0.27.0. It will be removed in supervision-0.31.0.
  • ensure_cv2_image_for_processing in supervision.utils.conversion is deprecated in supervision-0.27.0. It will be removed in supervision-0.31.0.
  • Keypoint validation utilities in supervision.validators are deprecated in supervision-0.27.0. They will be removed in supervision-0.31.0.
  • normalized_xyxy argument in sv.denormalize_boxes is deprecated in supervision-0.27.0 and renamed to xyxy. Passing normalized_xyxy= emits a FutureWarning; support will be removed in supervision-0.31.0.
  • supervision.dataset.utils import path for sv.rle_to_mask and sv.mask_to_rle is deprecated in supervision-0.28.0. These functions moved to supervision.detection.utils.converters and will be removed from supervision.dataset.utils in supervision-0.31.0.
  • sv.LMM enum is deprecated in supervision-0.27.0 and will be removed in supervision-0.31.0. Use sv.VLM instead.
  • sv.Detections.from_lmm classmethod is deprecated in supervision-0.26.0 and will be removed in supervision-0.31.0. Use sv.Detections.from_vlm instead.
  • KeyPoints.confidence is deprecated in supervision-0.29.0. Use KeyPoints.keypoint_confidence instead. It will be removed in supervision-0.32.0.
  • Public validate_* helper functions are deprecated in supervision-0.29.0 and will be removed in supervision-0.32.0. Supervision internals now use private _validate_* helpers.

Removed

0.27.0

  • overlap_ratio_wh parameter in sv.InferenceSlicer has been removed. Use the pixel-based overlap_wh parameter instead.
  • overlap_filter_strategy parameter in sv.InferenceSlicer has been removed. Use overlap_strategy instead.

0.26.0

  • The sv.DetectionDataset.images property has been removed in supervision-0.26.0. Please loop over images with for path, image, annotation in dataset:, as that does not require loading all images into memory. Also, constructing sv.DetectionDataset with parameter images as Dict[str, np.ndarray] is deprecated and has been removed in supervision-0.26.0. Please pass a list of paths List[str] instead.
  • The name sv.BoundingBoxAnnotator is deprecated and has been removed in supervision-0.26.0. It has been renamed to sv.BoxAnnotator.

0.24.0

  • The frame_resolution_wh parameter in sv.PolygonZone has been removed.
  • Supervision installation methods "headless" and "desktop" were removed, as they are no longer needed. pip install supervision[headless] will install the base library and harmlessly warn of non-existent extras.

0.23.0

  • The track_buffer, track_thresh, and match_thresh parameters in ByteTrack are deprecated and were removed as of supervision-0.23.0. Use lost_track_buffer, track_activation_threshold, and minimum_matching_threshold instead.
  • The triggering_position parameter in sv.PolygonZone was removed as of supervision-0.23.0. Use triggering_anchors instead.

0.22.0

  • sv.Detections.from_roboflow is removed as of supervision-0.22.0. Use Detections.from_inference instead.
  • The method sv.Color.white() was removed as of supervision-0.22.0. Use the constant sv.Color.WHITE instead.
  • The method sv.Color.black() was removed as of supervision-0.22.0. Use the constant sv.Color.BLACK instead.
  • The method sv.Color.red() was removed as of supervision-0.22.0. Use the constant sv.Color.RED instead.
  • The method sv.Color.green() was removed as of supervision-0.22.0. Use the constant sv.Color.GREEN instead.
  • The method sv.Color.blue() was removed as of supervision-0.22.0. Use the constant sv.Color.BLUE instead.
  • The method sv.ColorPalette.default() was removed as of supervision-0.22.0. Use the constant ColorPalette.DEFAULT instead.
  • sv.BoxAnnotator was removed as of supervision-0.22.0, however sv.BoundingBoxAnnotator was immediately renamed to sv.BoxAnnotator. Use BoxAnnotator and LabelAnnotator instead of the old sv.BoxAnnotator.
  • The method sv.FPSMonitor.__call__ was removed as of supervision-0.22.0. Use the attribute sv.FPSMonitor.fps instead.

Comments