Merge pull request #830 from roboflow/feature/update_fps_monitor_api

Update `FPSMonitor` API
fix(pre_commit): 🎨 auto format pre-commit hooks
2024-01-31 22:29:29 +01:00 · 2024-01-31 21:27:15 +00:00 · 2024-01-31 22:25:47 +01:00 · 2024-01-31 21:18:42 +00:00 · 2024-01-31 22:18:29 +01:00 · 2024-01-31 22:12:54 +01:00
46 changed files with 529 additions and 276 deletions
@@ -1,10 +1,8 @@
-name: Docs WorkFlow
+name: Docs WorkFlow - Develop Tag 📚

 on:
  push:
    branches:
-      - master
-      - main
      - develop

 permissions:
@@ -16,11 +14,26 @@ jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
+      - name: 🔄 Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: 🐍 Set up Python
+        uses: actions/setup-python@v5
        with:
          python-version: 3.x
-      - run: pip install mkdocs-material
-      - run: pip install "mkdocstrings[python]"
-      - run: pip install "mkdocs-material[imaging]"
-      - run: mkdocs gh-deploy --force
+      - name: 📦 Install mkdocs-material
+        run: pip install mkdocs-material
+      - name: 📦 Install mkdocstrings[python]
+        run: pip install "mkdocstrings[python]"
+      - name: 📦 Install mkdocs-material[imaging]
+        run: pip install "mkdocs-material[imaging]"
+      - name: 📦 Install mike
+        run: pip install "mike"
+      - name: ⚙️ Configure git for github-actions
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
+      - name: 🚀 Deploy MkDoc-Material with mike
+        run: |
+          mike deploy --push develop
@@ -30,7 +30,7 @@ repos:


  -   repo: https://github.com/PyCQA/bandit
-      rev: '1.7.6'
+      rev: '1.7.7'
      hooks:
      -   id: bandit
          args: ["-c", "pyproject.toml"]
@@ -15,7 +15,7 @@ url: 'https://roboflow.github.io/supervision/'
 abstract: >-
  supervision features a range of utilities for use in
  computer vision projects, from detections processing and
-  filtering to confusion matrix calcuation.
+  filtering to confusion matrix calculation.
 keywords:
  - computer vision
  - image processing
@@ -3,6 +3,8 @@ comments: true
 status: new
 ---

+# Annotators
+
 === "BoundingBox"

    ```python
@@ -378,78 +380,116 @@ status: new

    </div>

-## BoundingBoxAnnotator
+<div class="md-typeset">
+  <h2>BoundingBoxAnnotator</h2>
+</div>

 :::supervision.annotators.core.BoundingBoxAnnotator

-## RoundBoxAnnotator
+<div class="md-typeset">
+  <h2>RoundBoxAnnotator</h2>
+</div>

 :::supervision.annotators.core.RoundBoxAnnotator

-## BoxCornerAnnotator
+<div class="md-typeset">
+  <h2>BoxCornerAnnotator</h2>
+</div>

 :::supervision.annotators.core.BoxCornerAnnotator

-## OrientedBoxAnnotator
+<div class="md-typeset">
+  <h2>OrientedBoxAnnotator</h2>
+</div>

 :::supervision.annotators.core.OrientedBoxAnnotator

-## ColorAnnotator
+<div class="md-typeset">
+  <h2>ColorAnnotator</h2>
+</div>

 :::supervision.annotators.core.ColorAnnotator

-## CircleAnnotator
+<div class="md-typeset">
+  <h2>CircleAnnotator</h2>
+</div>

 :::supervision.annotators.core.CircleAnnotator

-## DotAnnotator
+<div class="md-typeset">
+  <h2>DotAnnotator</h2>
+</div>

 :::supervision.annotators.core.DotAnnotator

-## TriangleAnnotator
+<div class="md-typeset">
+  <h2>TriangleAnnotator</h2>
+</div>

 :::supervision.annotators.core.TriangleAnnotator

-## EllipseAnnotator
+<div class="md-typeset">
+  <h2>EllipseAnnotator</h2>
+</div>

 :::supervision.annotators.core.EllipseAnnotator

-## HaloAnnotator
+<div class="md-typeset">
+  <h2>HaloAnnotator</h2>
+</div>

 :::supervision.annotators.core.HaloAnnotator

-## PercentageBarAnnotator
+<div class="md-typeset">
+  <h2>PercentageBarAnnotator</h2>
+</div>

 :::supervision.annotators.core.PercentageBarAnnotator

-## HeatMapAnnotator
+<div class="md-typeset">
+  <h2>HeatMapAnnotator</h2>
+</div>

 :::supervision.annotators.core.HeatMapAnnotator

-## MaskAnnotator
+<div class="md-typeset">
+  <h2>MaskAnnotator</h2>
+</div>

 :::supervision.annotators.core.MaskAnnotator

-## PolygonAnnotator
+<div class="md-typeset">
+  <h2>PolygonAnnotator</h2>
+</div>

 :::supervision.annotators.core.PolygonAnnotator

-## LabelAnnotator
+<div class="md-typeset">
+  <h2>LabelAnnotator</h2>
+</div>

 :::supervision.annotators.core.LabelAnnotator

-## BlurAnnotator
+<div class="md-typeset">
+  <h2>BlurAnnotator</h2>
+</div>

 :::supervision.annotators.core.BlurAnnotator

-## PixelateAnnotator
+<div class="md-typeset">
+  <h2>PixelateAnnotator</h2>
+</div>

 :::supervision.annotators.core.PixelateAnnotator

-## TraceAnnotator
+<div class="md-typeset">
+  <h2>TraceAnnotator</h2>
+</div>

 :::supervision.annotators.core.TraceAnnotator

-## ColorLookup
+<div class="md-typeset">
+  <h2>ColorLookup</h2>
+</div>

 :::supervision.annotators.utils.ColorLookup
@@ -2,11 +2,14 @@
 comments: true
 ---

+# Assets
+
 Supervision offers an assets download utility that allows you to download video files
 that you can use in your demos.

 ## install extra

+
 To install the Supervision assets utility, you can use `pip`. This utility is available
 as an extra within the Supervision package.

@@ -16,10 +19,14 @@ as an extra within the Supervision package.
    pip install supervision[assets]
    ```

-## download_assets
+<div class="md-typeset">
+  <h2>download_assets</h2>
+</div>

 :::supervision.assets.downloader.download_assets

-## VideoAssets
+<div class="md-typeset">
+  <h2>VideoAssets</h2>
+</div>

 :::supervision.assets.list.VideoAssets
@@ -54,18 +54,18 @@ ColorPalette(colors=[Color(r=68, g=1, b=84), Color(r=59, g=82, b=139), ...])

 - Changed [#756](https://github.com/roboflow/supervision/pull/756): [`sv.Color`](https://supervision.roboflow.com/draw/color/#color)'s and [`sv.ColorPalette`](https://supervision.roboflow.com/draw/color/#colorpalette)'s method of accessing predefined colors, transitioning from a function-based approach (`sv.Color.red()`) to a more intuitive and conventional property-based method (`sv.Color.RED`).

-!!! warning
+!!! failure "Deprecated"

-    `sv.ColorPalette.default()` is deprecated and will be removed in `supervision-0.21.0`. Use `sv.ColorPalette.DEFAULT` instead.
+    `sv.ColorPalette.default()` is deprecated and will be removed in `supervision-0.22.0`. Use `sv.ColorPalette.DEFAULT` instead.


 - Changed [#769](https://github.com/roboflow/supervision/pull/769): [`sv.ColorPalette.DEFAULT`](https://supervision.roboflow.com/draw/color/#colorpalette) value, giving users a more extensive set of annotation colors.

 - Changed [#677](https://github.com/roboflow/supervision/pull/677): `sv.Detections.from_roboflow` to [`sv.Detections.from_inference`](https://supervision.roboflow.com/detection/core/#supervision.detection.core.Detections.from_inference) streamlining its functionality to be compatible with both the both [inference](https://github.com/roboflow/inference) pip package and the Robloflow [hosted API](https://docs.roboflow.com/deploy/hosted-api).

-!!! warning
+!!! failure "Deprecated"

-    `Detections.from_roboflow()` is deprecated and will be removed in `supervision-0.21.0`. Use `Detections.from_inference` instead.
+    `Detections.from_roboflow()` is deprecated and will be removed in `supervision-0.22.0`. Use `Detections.from_inference` instead.


 - Fixed [#735](https://github.com/roboflow/supervision/pull/735): [`sv.LineZone`](https://supervision.roboflow.com/detection/tools/line_zone/#linezone) functionality to accurately update the counter when an object crosses a line from any direction, including from the side. This enhancement enables more precise tracking and analytics, such as calculating individual in/out counts for each lane on the road.
@@ -152,7 +152,7 @@ ColorPalette(colors=[Color(r=68, g=1, b=84), Color(r=59, g=82, b=139), ...])

 - Added [#454](https://github.com/roboflow/supervision/pull/454): 🤗 Hugging Face Annotators [space](https://huggingface.co/spaces/Roboflow/Annotators).

- Changed [#482](https://github.com/roboflow/supervision/pull/482): [`sv.LineZone.tigger`](https://supervision.roboflow.com/detection/tools/line_zone/#supervision.detection.line_counter.LineZone.trigger) now return `Tuple[np.ndarray, np.ndarray]`. The first array indicates which detections have crossed the line from outside to inside. The second array indicates which detections have crossed the line from inside to outside.
+- Changed [#482](https://github.com/roboflow/supervision/pull/482): [`sv.LineZone.trigger`](https://supervision.roboflow.com/detection/tools/line_zone/#supervision.detection.line_counter.LineZone.trigger) now return `Tuple[np.ndarray, np.ndarray]`. The first array indicates which detections have crossed the line from outside to inside. The second array indicates which detections have crossed the line from inside to outside.

 - Changed [#465](https://github.com/roboflow/supervision/pull/465): Annotator argument name from `color_map: str` to `color_lookup: ColorLookup` enum to increase type safety.

@@ -162,7 +162,7 @@ ColorPalette(colors=[Color(r=68, g=1, b=84), Color(r=59, g=82, b=139), ...])

 - Fixed [#430](https://github.com/roboflow/supervision/pull/430):  [`sv.ByteTrack`](https://supervision.roboflow.com/trackers/#supervision.tracker.byte_tracker.core.ByteTrack) to return `np.array([], dtype=int)` when `svDetections` is empty.

-!!! warning
+!!! failure "Deprecated"

    `sv.Detections.from_yolov8` and `sv.Classifications.from_yolov8` as those are now replaced by [`sv.Detections.from_ultralytics`](https://supervision.roboflow.com/detection/core/#supervision.detection.core.Detections.from_ultralytics) and [`sv.Classifications.from_ultralytics`](https://supervision.roboflow.com/classification/core/#supervision.classification.core.Classifications.from_ultralytics).

@@ -231,9 +231,9 @@ ColorPalette(colors=[Color(r=68, g=1, b=84), Color(r=59, g=82, b=139), ...])

 - Added [#281](https://github.com/roboflow/supervision/pull/281): [`sv.Classifications.from_ultralytics`](https://supervision.roboflow.com/classification/core/#supervision.classification.core.Classifications.from_ultralytics) to enable seamless integration with [Ultralytics](https://github.com/ultralytics/ultralytics) framework. This will enable you to use supervision with all [models](https://docs.ultralytics.com/models/) that Ultralytics supports.

-!!! warning
+!!! failure "Deprecated"

-    [sv.Detections.from_yolov8](https://roboflow.github.io/supervision/detection/core/#supervision.detection.core.Detections.from_yolov8) and [sv.Classifications.from_yolov8](https://supervision.roboflow.com/classification/core/#supervision.classification.core.Classifications.from_yolov8) are now deprecated and will be removed with supervision-0.16.0 release.
+    [sv.Detections.from_yolov8](https://roboflow.github.io/supervision/detection/core/#supervision.detection.core.Detections.from_yolov8) and [sv.Classifications.from_yolov8](https://supervision.roboflow.com/classification/core/#supervision.classification.core.Classifications.from_yolov8) are now deprecated and will be removed with `supervision-0.16.0` release.

 - Added [#341](https://github.com/roboflow/supervision/pull/341): First supervision usage example script showing how to detect and track objects on video using YOLOv8 + Supervision.

@@ -269,7 +269,7 @@ ColorPalette(colors=[Color(r=68, g=1, b=84), Color(r=59, g=82, b=139), ...])

 - Added [#222](https://github.com/roboflow/supervision/pull/222): [`sv.Detections.from_ultralytics`](https://roboflow.github.io/supervision/detection/core/#supervision.detection.core.Detections.from_ultralytics) to enable seamless integration with [Ultralytics](https://github.com/ultralytics/ultralytics) framework. This will enable you to use `supervision` with all [models](https://docs.ultralytics.com/models/) that Ultralytics supports.

-!!! warning
+!!! failure "Deprecated"

    [`sv.Detections.from_yolov8`](https://roboflow.github.io/supervision/detection/core/#supervision.detection.core.Detections.from_yolov8) is now deprecated and will be removed with `supervision-0.15.0` release.

@@ -279,7 +279,7 @@ ColorPalette(colors=[Color(r=68, g=1, b=84), Color(r=59, g=82, b=139), ...])

 ### 0.12.0 <small>July 24, 2023</small>

-!!! warning
+!!! failure "Python 3.7. Support Terminated"

    With the `supervision-0.12.0` release, we are terminating official support for Python 3.7.

@@ -342,7 +342,7 @@ array([
 ... )
 ```

- Added [#158](https://github.com/roboflow/supervision/pull/158): ability to marge multiple [`sv.DetectionDataset`](https://roboflow.github.io/supervision/dataset/core/#detectiondataset) together using [`merge`](https://roboflow.github.io/supervision/dataset/core/#supervision.dataset.core.DetectionDataset.merge) method.
+- Added [#158](https://github.com/roboflow/supervision/pull/158): ability to merge multiple [`sv.DetectionDataset`](https://roboflow.github.io/supervision/dataset/core/#detectiondataset) together using [`merge`](https://roboflow.github.io/supervision/dataset/core/#supervision.dataset.core.DetectionDataset.merge) method.

 ```python
 >>> import supervision as sv
@@ -2,6 +2,6 @@
 comments: true
 ---

-## Classifications
+# Classifications

 :::supervision.classification.core.Classifications
@@ -2,15 +2,21 @@
 comments: true
 ---

+# Datasets
+
 !!! warning

    Dataset API is still fluid and may change. If you use Dataset API in your project until further notice, freeze the
    `supervision` version in your `requirements.txt` or `setup.py`.

-## DetectionDataset
+<div class="md-typeset">
+  <h2>DetectionDataset</h2>
+</div>

 :::supervision.dataset.core.DetectionDataset

-## ClassificationDataset
+<div class="md-typeset">
+  <h2>ClassificationDataset</h2>
+</div>

 :::supervision.dataset.core.ClassificationDataset
@@ -0,0 +1,16 @@
+---
+comments: true
+status: deprecated
+---
+
+These features are phased out due to better alternatives or potential issues in future versions. Deprecated functionalities are supported for **three subsequent releases**, providing time for users to transition to updated methods.
+
+- [`Detections.from_froboflow`](detection/core.md/#supervision.detection.core.Detections.from_roboflow) is deprecated and will be removed in `supervision-0.22.0`. Use [`Detections.from_inference`](detection/core.md/#supervision.detection.core.Detections.from_inference) instead.
+- `Color.white()` is deprecated and will be removed in `supervision-0.22.0`. Use `Color.WHITE` instead.
+- `Color.black()` is deprecated and will be removed in `supervision-0.22.0`. Use `Color.BLACK` instead.
+- `Color.red()` is deprecated and will be removed in `supervision-0.22.0`. Use `Color.RED` instead.
+- `Color.green()` is deprecated and will be removed in `supervision-0.22.0`. Use `Color.GREEN` instead.
+- `Color.blue()` is deprecated and will be removed in `supervision-0.22.0`. Use `Color.BLUE` instead.
+- [`ColorPalette.default()`](draw/color.md/#supervision.draw.color.ColorPalette.default) is deprecated and will be removed in `supervision-0.22.0`. Use [`ColorPalette.DEFAULT`](draw/color.md/#supervision.draw.color.ColorPalette.DEFAULT) instead.
+- `BoxAnnotator` is deprecated and will be removed in `supervision-0.22.0`. Use [`BoundingBoxAnnotator`](annotators.md/#supervision.annotators.core.BoundingBoxAnnotator) and [`LabelAnnotator`](annotators.md/#supervision.annotators.core.LabelAnnotator) instead.
+- [`FPSMonitor.__call__`](utils/video.md/#supervision.utils.video.FPSMonitor.__call__) is deprecated and will be removed in `supervision-0.22.0`. Use [`FPSMonitor.fps`](utils/video.md/#supervision.utils.video.FPSMonitor.fps) instead.
@@ -3,6 +3,6 @@ comments: true
 status: new
 ---

-## Detections
+# Detections

 :::supervision.detection.core.Detections
@@ -2,6 +2,6 @@
 comments: true
 ---

-## InferenceSlicer
+# InferenceSlicer

 :::supervision.detection.tools.inference_slicer.InferenceSlicer
@@ -2,6 +2,6 @@
 comments: true
 ---

-## LineZone
+# LineZone

 :::supervision.detection.line_counter.LineZone
@@ -2,10 +2,12 @@
 comments: true
 ---

-## PolygonZone
+# PolygonZone

 :::supervision.detection.tools.polygon_zone.PolygonZone

-## PolygonZoneAnnotator
+<div class="md-typeset">
+  <h2>PolygonZoneAnnotator</h2>
+</div>

 :::supervision.detection.tools.polygon_zone.PolygonZoneAnnotator
@@ -3,6 +3,6 @@ comments: true
 status: new
 ---

-## Detection Smoother
+# Detection Smoother

 :::supervision.detection.tools.smoother.DetectionsSmoother
@@ -2,38 +2,58 @@
 comments: true
 ---

-## box_iou_batch
+# Detection Utils
+
+<div class="md-typeset">
+  <h2>box_iou_batch</h2>
+</div>

 :::supervision.detection.utils.box_iou_batch

-## non_max_suppression
+<div class="md-typeset">
+  <h2>non_max_suppression</h2>
+</div>

 :::supervision.detection.utils.non_max_suppression

-## polygon_to_mask
+<div class="md-typeset">
+    <h2>polygon_to_mask</h2>
+</div>

 :::supervision.detection.utils.polygon_to_mask

-## mask_to_xyxy
+<div class="md-typeset">
+    <h2>mask_to_xyxy</h2>
+</div>

 :::supervision.detection.utils.mask_to_xyxy

-## mask_to_polygons
+<div class="md-typeset">
+    <h2>mask_to_polygons</h2>
+</div>

 :::supervision.detection.utils.mask_to_polygons

-## polygon_to_xyxy
+<div class="md-typeset">
+    <h2>polygon_to_xyxy</h2>
+</div>

 :::supervision.detection.utils.polygon_to_xyxy

-## filter_polygons_by_area
+<div class="md-typeset">
+    <h2>filter_polygons_by_area</h2>
+</div>

 :::supervision.detection.utils.filter_polygons_by_area

-## move_boxes
+<div class="md-typeset">
+    <h2>move_boxes</h2>
+</div>

 :::supervision.detection.utils.move_boxes

-## scale_boxes
+<div class="md-typeset">
+    <h2>scale_boxes</h2>
+</div>

 :::supervision.detection.utils.scale_boxes
@@ -2,10 +2,12 @@
 comments: true
 ---

-## Color
+# Color

 :::supervision.draw.color.Color

-## ColorPalette
+<div class="md-typeset">
+  <h2>ColorPalette</h2>
+</div>

 :::supervision.draw.color.ColorPalette
@@ -2,34 +2,52 @@
 comments: true
 ---

-## draw_line
+# Draw Utils
+
+<div class="md-typeset">
+  <h2>draw_line</h2>
+</div>

 :::supervision.draw.utils.draw_line

-## draw_rectangle
+<div class="md-typeset">
+  <h2>draw_rectangle</h2>
+</div>

 :::supervision.draw.utils.draw_rectangle

-## draw_filled_rectangle
+<div class="md-typeset">
+  <h2>draw_filled_rectangle</h2>
+</div>

 :::supervision.draw.utils.draw_filled_rectangle

-## draw_polygon
+<div class="md-typeset">
+  <h2>draw_polygon</h2>
+</div>

 :::supervision.draw.utils.draw_polygon

-## draw_text
+<div class="md-typeset">
+  <h2>draw_text</h2>
+</div>

 :::supervision.draw.utils.draw_text

-## draw_image
+<div class="md-typeset">
+  <h2>draw_image</h2>
+</div>

 :::supervision.draw.utils.draw_image

-## calculate_dynamic_font_scale
+<div class="md-typeset">
+  <h2>calculate_dynamic_font_scale</h2>
+</div>

 :::supervision.draw.utils.calculate_dynamic_text_scale

-## calculate_dynamic_line_thickness
+<div class="md-typeset">
+  <h2>calculate_dynamic_line_thickness</h2>
+</div>

 :::supervision.draw.utils.calculate_dynamic_line_thickness
@@ -2,6 +2,6 @@
 comments: true
 ---

-## Position
+# Position

 :::supervision.geometry.core.Position
@@ -2,6 +2,8 @@
 comments: true
 ---

+# Detect and Annotate
+
 Supervision offers a streamlined solution to effortlessly annotate predictions from a
 range of object detection and segmentation models. This guide demonstrates how to
 execute inference using the YOLOv8 model with either the
@@ -2,6 +2,8 @@
 comments: true
 ---

+# Filter Detections
+
 The advanced filtering capabilities of the `Detections` class offer users a versatile and efficient way to narrow down
 and refine object detections. This section outlines various filtering methods, including filtering by specific class
 or a set of classes, confidence, object area, bounding box area, relative area, box dimensions, and designated zones.
@@ -42,7 +44,6 @@ Allows you to select detections that belong only to one selected class.

    </div>

-
 ### by set of classes

 Allows you to select detections that belong only to selected set of classes.
@@ -2,6 +2,8 @@
 comments: true
 ---

+# Track Objects
+
 Leverage Supervision's advanced capabilities for enhancing your video analysis by
 seamlessly [tracking](https://supervision.roboflow.com/trackers/) objects recognized by
 a multitude of object detection and segmentation models. This comprehensive guide will
@@ -34,7 +34,7 @@ We write your reusable computer vision tools. Whether you need to load your data

    Annotate predictions from a range of object detection and segmentation models

-    [:octicons-arrow-right-24: Tutorial](how_to/detect_and_annotate)
+    [:octicons-arrow-right-24: Tutorial](how_to/detect_and_annotate.md)

 -   __Track Objects__

@@ -42,7 +42,7 @@ We write your reusable computer vision tools. Whether you need to load your data

    Discover how to enhance video analysis by implementing seamless object tracking

-    [:octicons-arrow-right-24: Tutorial](how_to/track_objects)
+    [:octicons-arrow-right-24: Tutorial](how_to/track_objects.md)

 -   > __Count Objects Crossing Line__

@@ -2,6 +2,6 @@
 comments: true
 ---

-## ByteTrack
+# ByteTrack

 :::supervision.tracker.byte_tracker.core.ByteTrack
@@ -2,6 +2,10 @@
 comments: true
 ---

-## list_files_with_extensions
+# File
+
+<div class="md-typeset">
+  <h2>list_files_with_extensions</h2>
+</div>

 :::supervision.utils.file.list_files_with_extensions
@@ -2,10 +2,12 @@
 comments: true
 ---

-## ImageSink
+# ImageSink

 :::supervision.utils.image.ImageSink

-## crop
+<div class="md-typeset">
+  <h2>crop_image</h2>
+</div>

 :::supervision.utils.image.crop_image
@@ -2,10 +2,17 @@
 comments: true
 ---

-## plot_image
+# Notebooks
+
+<div class="md-typeset">
+  <h2>plot_image</h2>
+</div>

 :::supervision.utils.notebook.plot_image

-## plot_images_grid
+<div class="md-typeset">
+  <h2>## plot_images_grid
+</h2>
+</div>

 :::supervision.utils.notebook.plot_images_grid
@@ -2,22 +2,34 @@
 comments: true
 ---

-## VideoInfo
+# Video
+
+<div class="md-typeset">
+  <h2>VideoInfo</h2>
+</div>

 :::supervision.utils.video.VideoInfo

-## VideoSink
+<div class="md-typeset">
+  <h2>VideoSink</h2>
+</div>

 :::supervision.utils.video.VideoSink

-## FPSMonitor
+<div class="md-typeset">
+  <h2>FPSMonitor</h2>
+</div>

 :::supervision.utils.video.FPSMonitor

-## get_video_frames_generator
+<div class="md-typeset">
+  <h2>get_video_frames_generator</h2>
+</div>

 :::supervision.utils.video.get_video_frames_generator

-## process_video
+<div class="md-typeset">
+  <h2>process_video</h2>
+</div>

 :::supervision.utils.video.process_video
@@ -48,10 +48,12 @@ class DetectionsManager:
                    self.counts.setdefault(zone_out_id, {})
                    self.counts[zone_out_id].setdefault(zone_in_id, set())
                    self.counts[zone_out_id][zone_in_id].add(tracker_id)
-
-        detections_all.class_id = np.vectorize(
-            lambda x: self.tracker_id_to_zone_id.get(x, -1)
-        )(detections_all.tracker_id)
+        if len(detections_all) > 0:
+            detections_all.class_id = np.vectorize(
+                lambda x: self.tracker_id_to_zone_id.get(x, -1)
+            )(detections_all.tracker_id)
+        else:
+            detections_all.class_id = np.array([], dtype=int)
        return detections_all[detections_all.class_id != -1]


@@ -47,10 +47,12 @@ class DetectionsManager:
                    self.counts.setdefault(zone_out_id, {})
                    self.counts[zone_out_id].setdefault(zone_in_id, set())
                    self.counts[zone_out_id][zone_in_id].add(tracker_id)
-
-        detections_all.class_id = np.vectorize(
-            lambda x: self.tracker_id_to_zone_id.get(x, -1)
-        )(detections_all.tracker_id)
+        if len(detections_all) > 0:
+            detections_all.class_id = np.vectorize(
+                lambda x: self.tracker_id_to_zone_id.get(x, -1)
+            )(detections_all.tracker_id)
+        else:
+            detections_all.class_id = np.array([], dtype=int)
        return detections_all[detections_all.class_id != -1]


@@ -5,7 +5,7 @@ site_description: A set of easy-to-use utilities that will come in handy in any
 repo_name: roboflow/supervision
 repo_url: https://github.com/roboflow/supervision
 edit_uri: https://github.com/roboflow/supervision/tree/main/docs
-copyright: Roboflow 2023. All rights reserved.
+copyright: Roboflow 2024. All rights reserved.

 extra:
  social:
@@ -15,11 +15,13 @@ extra:
      link: https://www.youtube.com/roboflow
    - icon: fontawesome/brands/linkedin
      link: https://www.linkedin.com/company/roboflow-ai/mycompany/
-    - icon: fontawesome/brands/twitter
+    - icon: fontawesome/brands/x-twitter
      link: https://twitter.com/roboflow
  analytics:
    provider: google
    property: G-P7ZG0Y19G5
+  version:
+    provider: mike

 extra_css:
  - stylesheets/extra.css
@@ -55,7 +57,9 @@ nav:
        - Notebook: utils/notebook.md
        - File: utils/file.md
  - Assets: assets.md
-  - Changelog: changelog.md
+  - Changelog:
+        - Changelog: changelog.md
+        - Deprecated: deprecated.md

 theme:
  name: 'material'
@@ -555,6 +555,7 @@ files = [
    {file = "contourpy-1.1.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:18a64814ae7bce73925131381603fff0116e2df25230dfc80d6d690aa6e20b37"},
    {file = "contourpy-1.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:90c81f22b4f572f8a2110b0b741bb64e5a6427e0a198b2cdc1fbaf85f352a3aa"},
    {file = "contourpy-1.1.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:53cc3a40635abedbec7f1bde60f8c189c49e84ac180c665f2cd7c162cc454baa"},
+    {file = "contourpy-1.1.0-cp310-cp310-win32.whl", hash = "sha256:9b2dd2ca3ac561aceef4c7c13ba654aaa404cf885b187427760d7f7d4c57cff8"},
    {file = "contourpy-1.1.0-cp310-cp310-win_amd64.whl", hash = "sha256:1f795597073b09d631782e7245016a4323cf1cf0b4e06eef7ea6627e06a37ff2"},
    {file = "contourpy-1.1.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:0b7b04ed0961647691cfe5d82115dd072af7ce8846d31a5fac6c142dcce8b882"},
    {file = "contourpy-1.1.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:27bc79200c742f9746d7dd51a734ee326a292d77e7d94c8af6e08d1e6c15d545"},
@@ -563,6 +564,7 @@ files = [
    {file = "contourpy-1.1.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e5cec36c5090e75a9ac9dbd0ff4a8cf7cecd60f1b6dc23a374c7d980a1cd710e"},
    {file = "contourpy-1.1.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1f0cbd657e9bde94cd0e33aa7df94fb73c1ab7799378d3b3f902eb8eb2e04a3a"},
    {file = "contourpy-1.1.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:181cbace49874f4358e2929aaf7ba84006acb76694102e88dd15af861996c16e"},
+    {file = "contourpy-1.1.0-cp311-cp311-win32.whl", hash = "sha256:edb989d31065b1acef3828a3688f88b2abb799a7db891c9e282df5ec7e46221b"},
    {file = "contourpy-1.1.0-cp311-cp311-win_amd64.whl", hash = "sha256:fb3b7d9e6243bfa1efb93ccfe64ec610d85cfe5aec2c25f97fbbd2e58b531256"},
    {file = "contourpy-1.1.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:bcb41692aa09aeb19c7c213411854402f29f6613845ad2453d30bf421fe68fed"},
    {file = "contourpy-1.1.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:5d123a5bc63cd34c27ff9c7ac1cd978909e9c71da12e05be0231c608048bb2ae"},
@@ -571,6 +573,7 @@ files = [
    {file = "contourpy-1.1.0-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:317267d915490d1e84577924bd61ba71bf8681a30e0d6c545f577363157e5e94"},
    {file = "contourpy-1.1.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d551f3a442655f3dcc1285723f9acd646ca5858834efeab4598d706206b09c9f"},
    {file = "contourpy-1.1.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:e7a117ce7df5a938fe035cad481b0189049e8d92433b4b33aa7fc609344aafa1"},
+    {file = "contourpy-1.1.0-cp38-cp38-win32.whl", hash = "sha256:108dfb5b3e731046a96c60bdc46a1a0ebee0760418951abecbe0fc07b5b93b27"},
    {file = "contourpy-1.1.0-cp38-cp38-win_amd64.whl", hash = "sha256:d4f26b25b4f86087e7d75e63212756c38546e70f2a92d2be44f80114826e1cd4"},
    {file = "contourpy-1.1.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:bc00bb4225d57bff7ebb634646c0ee2a1298402ec10a5fe7af79df9a51c1bfd9"},
    {file = "contourpy-1.1.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:189ceb1525eb0655ab8487a9a9c41f42a73ba52d6789754788d1883fb06b2d8a"},
@@ -579,6 +582,7 @@ files = [
    {file = "contourpy-1.1.0-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:143dde50520a9f90e4a2703f367cf8ec96a73042b72e68fcd184e1279962eb6f"},
    {file = "contourpy-1.1.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e94bef2580e25b5fdb183bf98a2faa2adc5b638736b2c0a4da98691da641316a"},
    {file = "contourpy-1.1.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:ed614aea8462735e7d70141374bd7650afd1c3f3cb0c2dbbcbe44e14331bf002"},
+    {file = "contourpy-1.1.0-cp39-cp39-win32.whl", hash = "sha256:71551f9520f008b2950bef5f16b0e3587506ef4f23c734b71ffb7b89f8721999"},
    {file = "contourpy-1.1.0-cp39-cp39-win_amd64.whl", hash = "sha256:438ba416d02f82b692e371858143970ed2eb6337d9cdbbede0d8ad9f3d7dd17d"},
    {file = "contourpy-1.1.0-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:a698c6a7a432789e587168573a864a7ea374c6be8d4f31f9d87c001d5a843493"},
    {file = "contourpy-1.1.0-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:397b0ac8a12880412da3551a8cb5a187d3298a72802b45a3bd1805e204ad8439"},
@@ -1867,6 +1871,30 @@ files = [
    {file = "mergedeep-1.3.4.tar.gz", hash = "sha256:0096d52e9dad9939c3d975a774666af186eda617e6ca84df4c94dec30004f2a8"},
 ]

+[[package]]
+name = "mike"
+version = "2.0.0"
+description = "Manage multiple versions of your MkDocs-powered documentation"
+optional = false
+python-versions = "*"
+files = [
+    {file = "mike-2.0.0-py3-none-any.whl", hash = "sha256:87f496a65900f93ba92d72940242b65c86f3f2f82871bc60ebdcffc91fad1d9e"},
+    {file = "mike-2.0.0.tar.gz", hash = "sha256:566f1cab1a58cc50b106fb79ea2f1f56e7bfc8b25a051e95e6eaee9fba0922de"},
+]
+
+[package.dependencies]
+importlib-metadata = "*"
+importlib-resources = "*"
+jinja2 = ">=2.7"
+mkdocs = ">=1.0"
+pyparsing = ">=3.0"
+pyyaml = ">=5.1"
+verspec = "*"
+
+[package.extras]
+dev = ["coverage", "flake8 (>=3.0)", "flake8-quotes", "shtab"]
+test = ["coverage", "flake8 (>=3.0)", "flake8-quotes", "shtab"]
+
 [[package]]
 name = "mistune"
 version = "3.0.2"
@@ -1926,13 +1954,13 @@ mkdocs = ">=1.1"

 [[package]]
 name = "mkdocs-material"
-version = "9.5.5"
+version = "9.5.6"
 description = "Documentation that simply works"
 optional = false
 python-versions = ">=3.8"
 files = [
-    {file = "mkdocs_material-9.5.5-py3-none-any.whl", hash = "sha256:ac50b2431a79a3b160fdefbba37c9132485f1a69166aba115ad49fafdbbbc5df"},
-    {file = "mkdocs_material-9.5.5.tar.gz", hash = "sha256:4480d9580faf42fed0123d0465502bfc1c0c239ecc9c4d66159cf0459ea1b4ae"},
+    {file = "mkdocs_material-9.5.6-py3-none-any.whl", hash = "sha256:e115b90fccf5cd7f5d15b0c2f8e6246b21041628b8f590630e7fca66ed7fcf6c"},
+    {file = "mkdocs_material-9.5.6.tar.gz", hash = "sha256:5b24df36d8ac6cecd611241ce6f6423ccde3e1ad89f8360c3f76d5565fc2d82a"},
 ]

 [package.dependencies]
@@ -2303,31 +2331,12 @@ files = [
    {file = "opencv_python-4.8.1.78-cp37-abi3-win_amd64.whl", hash = "sha256:b983197f97cfa6fcb74e1da1802c7497a6f94ed561aba6980f1f33123f904956"},
 ]

-[package.dependencies]
-numpy = {version = ">=1.23.5", markers = "python_version >= \"3.11\""}
-
-[[package]]
-name = "opencv-python"
-version = "4.9.0.80"
-description = "Wrapper package for OpenCV python bindings."
-optional = true
-python-versions = ">=3.6"
-files = [
-    {file = "opencv-python-4.9.0.80.tar.gz", hash = "sha256:1a9f0e6267de3a1a1db0c54213d022c7c8b5b9ca4b580e80bdc58516c922c9e1"},
-    {file = "opencv_python-4.9.0.80-cp37-abi3-macosx_10_16_x86_64.whl", hash = "sha256:7e5f7aa4486651a6ebfa8ed4b594b65bd2d2f41beeb4241a3e4b1b85acbbbadb"},
-    {file = "opencv_python-4.9.0.80-cp37-abi3-macosx_11_0_arm64.whl", hash = "sha256:71dfb9555ccccdd77305fc3dcca5897fbf0cf28b297c51ee55e079c065d812a3"},
-    {file = "opencv_python-4.9.0.80-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7b34a52e9da36dda8c151c6394aed602e4b17fa041df0b9f5b93ae10b0fcca2a"},
-    {file = "opencv_python-4.9.0.80-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e4088cab82b66a3b37ffc452976b14a3c599269c247895ae9ceb4066d8188a57"},
-    {file = "opencv_python-4.9.0.80-cp37-abi3-win32.whl", hash = "sha256:dcf000c36dd1651118a2462257e3a9e76db789a78432e1f303c7bac54f63ef6c"},
-    {file = "opencv_python-4.9.0.80-cp37-abi3-win_amd64.whl", hash = "sha256:3f16f08e02b2a2da44259c7cc712e779eff1dd8b55fdb0323e8cab09548086c0"},
-]
-
 [package.dependencies]
 numpy = [
    {version = ">=1.21.0", markers = "python_version <= \"3.9\" and platform_system == \"Darwin\" and platform_machine == \"arm64\" and python_version >= \"3.8\""},
    {version = ">=1.19.3", markers = "platform_system == \"Linux\" and platform_machine == \"aarch64\" and python_version >= \"3.8\" and python_version < \"3.10\" or python_version > \"3.9\" and python_version < \"3.10\" or python_version >= \"3.9\" and platform_system != \"Darwin\" and python_version < \"3.10\" or python_version >= \"3.9\" and platform_machine != \"arm64\" and python_version < \"3.10\""},
    {version = ">=1.17.3", markers = "(platform_system != \"Darwin\" and platform_system != \"Linux\") and python_version >= \"3.8\" and python_version < \"3.9\" or platform_system != \"Darwin\" and python_version >= \"3.8\" and python_version < \"3.9\" and platform_machine != \"aarch64\" or platform_machine != \"arm64\" and python_version >= \"3.8\" and python_version < \"3.9\" and platform_system != \"Linux\" or (platform_machine != \"arm64\" and platform_machine != \"aarch64\") and python_version >= \"3.8\" and python_version < \"3.9\""},
-    {version = ">=1.23.5", markers = "python_version >= \"3.11\" and python_version < \"3.12\""},
+    {version = ">=1.23.5", markers = "python_version >= \"3.11\""},
    {version = ">=1.21.4", markers = "python_version >= \"3.10\" and platform_system == \"Darwin\" and python_version < \"3.11\""},
    {version = ">=1.21.2", markers = "platform_system != \"Darwin\" and python_version >= \"3.10\" and python_version < \"3.11\""},
 ]
@@ -2348,31 +2357,12 @@ files = [
    {file = "opencv_python_headless-4.8.1.78-cp37-abi3-win_amd64.whl", hash = "sha256:0a0f1e9f836f7d5bad1dd164694944c8761711cbdf4b36ebbd4815a8ef731079"},
 ]

-[package.dependencies]
-numpy = {version = ">=1.23.5", markers = "python_version >= \"3.11\""}
-
-[[package]]
-name = "opencv-python-headless"
-version = "4.9.0.80"
-description = "Wrapper package for OpenCV python bindings."
-optional = false
-python-versions = ">=3.6"
-files = [
-    {file = "opencv-python-headless-4.9.0.80.tar.gz", hash = "sha256:71a4cd8cf7c37122901d8e81295db7fb188730e33a0e40039a4e59c1030b0958"},
-    {file = "opencv_python_headless-4.9.0.80-cp37-abi3-macosx_10_16_x86_64.whl", hash = "sha256:2ea8a2edc4db87841991b2fbab55fc07b97ecb602e0f47d5d485bd75cee17c1a"},
-    {file = "opencv_python_headless-4.9.0.80-cp37-abi3-macosx_11_0_arm64.whl", hash = "sha256:e0ee54e27be493e8f7850847edae3128e18b540dac1d7b2e4001b8944e11e1c6"},
-    {file = "opencv_python_headless-4.9.0.80-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:57ce2865e8fec431c6f97a81e9faaf23fa5be61011d0a75ccf47a3c0d65fa73d"},
-    {file = "opencv_python_headless-4.9.0.80-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:976656362d68d9f40a5c66f83901430538002465f7db59142784f3893918f3df"},
-    {file = "opencv_python_headless-4.9.0.80-cp37-abi3-win32.whl", hash = "sha256:11e3849d83e6651d4e7699aadda9ec7ed7c38957cbbcb99db074f2a2d2de9670"},
-    {file = "opencv_python_headless-4.9.0.80-cp37-abi3-win_amd64.whl", hash = "sha256:a8056c2cb37cd65dfcdf4153ca16f7362afcf3a50d600d6bb69c660fc61ee29c"},
-]
-
 [package.dependencies]
 numpy = [
    {version = ">=1.21.0", markers = "python_version <= \"3.9\" and platform_system == \"Darwin\" and platform_machine == \"arm64\" and python_version >= \"3.8\""},
    {version = ">=1.19.3", markers = "platform_system == \"Linux\" and platform_machine == \"aarch64\" and python_version >= \"3.8\" and python_version < \"3.10\" or python_version > \"3.9\" and python_version < \"3.10\" or python_version >= \"3.9\" and platform_system != \"Darwin\" and python_version < \"3.10\" or python_version >= \"3.9\" and platform_machine != \"arm64\" and python_version < \"3.10\""},
    {version = ">=1.17.3", markers = "(platform_system != \"Darwin\" and platform_system != \"Linux\") and python_version >= \"3.8\" and python_version < \"3.9\" or platform_system != \"Darwin\" and python_version >= \"3.8\" and python_version < \"3.9\" and platform_machine != \"aarch64\" or platform_machine != \"arm64\" and python_version >= \"3.8\" and python_version < \"3.9\" and platform_system != \"Linux\" or (platform_machine != \"arm64\" and platform_machine != \"aarch64\") and python_version >= \"3.8\" and python_version < \"3.9\""},
-    {version = ">=1.23.5", markers = "python_version >= \"3.11\" and python_version < \"3.12\""},
+    {version = ">=1.23.5", markers = "python_version >= \"3.11\""},
    {version = ">=1.21.4", markers = "python_version >= \"3.10\" and platform_system == \"Darwin\" and python_version < \"3.11\""},
    {version = ">=1.21.2", markers = "platform_system != \"Darwin\" and python_version >= \"3.10\" and python_version < \"3.11\""},
 ]
@@ -2803,13 +2793,13 @@ tomli = {version = ">=1.1.0", markers = "python_version < \"3.11\""}

 [[package]]
 name = "pytest"
-version = "7.4.4"
+version = "8.0.0"
 description = "pytest: simple powerful testing with Python"
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=3.8"
 files = [
-    {file = "pytest-7.4.4-py3-none-any.whl", hash = "sha256:b090cdf5ed60bf4c45261be03239c2c1c22df034fbffe691abe93cd80cea01d8"},
-    {file = "pytest-7.4.4.tar.gz", hash = "sha256:2cf0005922c6ace4a3e2ec8b4080eb0d9753fdc93107415332f50ce9e7994280"},
+    {file = "pytest-8.0.0-py3-none-any.whl", hash = "sha256:50fb9cbe836c3f20f0dfa99c565201fb75dc54c8d76373cd1bde06b06657bdb6"},
+    {file = "pytest-8.0.0.tar.gz", hash = "sha256:249b1b0864530ba251b7438274c4d251c58d868edaaec8762893ad4a0d71c36c"},
 ]

 [package.dependencies]
@@ -2817,7 +2807,7 @@ colorama = {version = "*", markers = "sys_platform == \"win32\""}
 exceptiongroup = {version = ">=1.0.0rc8", markers = "python_version < \"3.11\""}
 iniconfig = "*"
 packaging = "*"
-pluggy = ">=0.12,<2.0"
+pluggy = ">=1.3.0,<2.0"
 tomli = {version = ">=1.0.0", markers = "python_version < \"3.11\""}

 [package.extras]
@@ -2920,6 +2910,7 @@ files = [
    {file = "PyYAML-6.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:69b023b2b4daa7548bcfbd4aa3da05b3a74b772db9e23b982788168117739938"},
    {file = "PyYAML-6.0.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:81e0b275a9ecc9c0c0c07b4b90ba548307583c125f54d5b6946cfee6360c733d"},
    {file = "PyYAML-6.0.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ba336e390cd8e4d1739f42dfe9bb83a3cc2e80f567d8805e11b46f4a943f5515"},
+    {file = "PyYAML-6.0.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:326c013efe8048858a6d312ddd31d56e468118ad4cdeda36c719bf5bb6192290"},
    {file = "PyYAML-6.0.1-cp310-cp310-win32.whl", hash = "sha256:bd4af7373a854424dabd882decdc5579653d7868b8fb26dc7d0e99f823aa5924"},
    {file = "PyYAML-6.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:fd1592b3fdf65fff2ad0004b5e363300ef59ced41c2e6b3a99d4089fa8c5435d"},
    {file = "PyYAML-6.0.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:6965a7bc3cf88e5a1c3bd2e0b5c22f8d677dc88a455344035f03399034eb3007"},
@@ -2927,8 +2918,16 @@ files = [
    {file = "PyYAML-6.0.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:42f8152b8dbc4fe7d96729ec2b99c7097d656dc1213a3229ca5383f973a5ed6d"},
    {file = "PyYAML-6.0.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:062582fca9fabdd2c8b54a3ef1c978d786e0f6b3a1510e0ac93ef59e0ddae2bc"},
    {file = "PyYAML-6.0.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d2b04aac4d386b172d5b9692e2d2da8de7bfb6c387fa4f801fbf6fb2e6ba4673"},
+    {file = "PyYAML-6.0.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:e7d73685e87afe9f3b36c799222440d6cf362062f78be1013661b00c5c6f678b"},
    {file = "PyYAML-6.0.1-cp311-cp311-win32.whl", hash = "sha256:1635fd110e8d85d55237ab316b5b011de701ea0f29d07611174a1b42f1444741"},
    {file = "PyYAML-6.0.1-cp311-cp311-win_amd64.whl", hash = "sha256:bf07ee2fef7014951eeb99f56f39c9bb4af143d8aa3c21b1677805985307da34"},
+    {file = "PyYAML-6.0.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:855fb52b0dc35af121542a76b9a84f8d1cd886ea97c84703eaa6d88e37a2ad28"},
+    {file = "PyYAML-6.0.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:40df9b996c2b73138957fe23a16a4f0ba614f4c0efce1e9406a184b6d07fa3a9"},
+    {file = "PyYAML-6.0.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a08c6f0fe150303c1c6b71ebcd7213c2858041a7e01975da3a99aed1e7a378ef"},
+    {file = "PyYAML-6.0.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6c22bec3fbe2524cde73d7ada88f6566758a8f7227bfbf93a408a9d86bcc12a0"},
+    {file = "PyYAML-6.0.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:8d4e9c88387b0f5c7d5f281e55304de64cf7f9c0021a3525bd3b1c542da3b0e4"},
+    {file = "PyYAML-6.0.1-cp312-cp312-win32.whl", hash = "sha256:d483d2cdf104e7c9fa60c544d92981f12ad66a457afae824d146093b8c294c54"},
+    {file = "PyYAML-6.0.1-cp312-cp312-win_amd64.whl", hash = "sha256:0d3304d8c0adc42be59c5f8a4d9e3d7379e6955ad754aa9d6ab7a398b59dd1df"},
    {file = "PyYAML-6.0.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:50550eb667afee136e9a77d6dc71ae76a44df8b3e51e41b77f6de2932bfe0f47"},
    {file = "PyYAML-6.0.1-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1fe35611261b29bd1de0070f0b2f47cb6ff71fa6595c077e42bd0c419fa27b98"},
    {file = "PyYAML-6.0.1-cp36-cp36m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:704219a11b772aea0d8ecd7058d0082713c3562b4e271b849ad7dc4a5c90c13c"},
@@ -2945,6 +2944,7 @@ files = [
    {file = "PyYAML-6.0.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a0cd17c15d3bb3fa06978b4e8958dcdc6e0174ccea823003a106c7d4d7899ac5"},
    {file = "PyYAML-6.0.1-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:28c119d996beec18c05208a8bd78cbe4007878c6dd15091efb73a30e90539696"},
    {file = "PyYAML-6.0.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7e07cbde391ba96ab58e532ff4803f79c4129397514e1413a7dc761ccd755735"},
+    {file = "PyYAML-6.0.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:49a183be227561de579b4a36efbb21b3eab9651dd81b1858589f796549873dd6"},
    {file = "PyYAML-6.0.1-cp38-cp38-win32.whl", hash = "sha256:184c5108a2aca3c5b3d3bf9395d50893a7ab82a38004c8f61c258d4428e80206"},
    {file = "PyYAML-6.0.1-cp38-cp38-win_amd64.whl", hash = "sha256:1e2722cc9fbb45d9b87631ac70924c11d3a401b2d7f410cc0e3bbf249f2dca62"},
    {file = "PyYAML-6.0.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:9eb6caa9a297fc2c2fb8862bc5370d0303ddba53ba97e71f08023b6cd73d16a8"},
@@ -2952,6 +2952,7 @@ files = [
    {file = "PyYAML-6.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5773183b6446b2c99bb77e77595dd486303b4faab2b086e7b17bc6bef28865f6"},
    {file = "PyYAML-6.0.1-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b786eecbdf8499b9ca1d697215862083bd6d2a99965554781d0d8d1ad31e13a0"},
    {file = "PyYAML-6.0.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bc1bf2925a1ecd43da378f4db9e4f799775d6367bdb94671027b73b393a7c42c"},
+    {file = "PyYAML-6.0.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:04ac92ad1925b2cff1db0cfebffb6ffc43457495c9b3c39d3fcae417d7125dc5"},
    {file = "PyYAML-6.0.1-cp39-cp39-win32.whl", hash = "sha256:faca3bdcf85b2fc05d06ff3fbc1f83e1391b3e724afa3feba7d13eeab355484c"},
    {file = "PyYAML-6.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:510c9deebc5c0225e8c96813043e62b680ba2f9c50a08d3724c7f28a747d1486"},
    {file = "PyYAML-6.0.1.tar.gz", hash = "sha256:bfdf460b1736c775f2ba9f6a92bca30bc2095067b8a9d77876d1fad6cc3b4a43"},
@@ -3415,28 +3416,28 @@ files = [

 [[package]]
 name = "ruff"
-version = "0.1.14"
+version = "0.1.15"
 description = "An extremely fast Python linter and code formatter, written in Rust."
 optional = false
 python-versions = ">=3.7"
 files = [
-    {file = "ruff-0.1.14-py3-none-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:96f76536df9b26622755c12ed8680f159817be2f725c17ed9305b472a757cdbb"},
-    {file = "ruff-0.1.14-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:ab3f71f64498c7241123bb5a768544cf42821d2a537f894b22457a543d3ca7a9"},
-    {file = "ruff-0.1.14-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7060156ecc572b8f984fd20fd8b0fcb692dd5d837b7606e968334ab7ff0090ab"},
-    {file = "ruff-0.1.14-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a53d8e35313d7b67eb3db15a66c08434809107659226a90dcd7acb2afa55faea"},
-    {file = "ruff-0.1.14-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:bea9be712b8f5b4ebed40e1949379cfb2a7d907f42921cf9ab3aae07e6fba9eb"},
-    {file = "ruff-0.1.14-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:2270504d629a0b064247983cbc495bed277f372fb9eaba41e5cf51f7ba705a6a"},
-    {file = "ruff-0.1.14-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:80258bb3b8909b1700610dfabef7876423eed1bc930fe177c71c414921898efa"},
-    {file = "ruff-0.1.14-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:653230dd00aaf449eb5ff25d10a6e03bc3006813e2cb99799e568f55482e5cae"},
-    {file = "ruff-0.1.14-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:87b3acc6c4e6928459ba9eb7459dd4f0c4bf266a053c863d72a44c33246bfdbf"},
-    {file = "ruff-0.1.14-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:6b3dadc9522d0eccc060699a9816e8127b27addbb4697fc0c08611e4e6aeb8b5"},
-    {file = "ruff-0.1.14-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:1c8eca1a47b4150dc0fbec7fe68fc91c695aed798532a18dbb1424e61e9b721f"},
-    {file = "ruff-0.1.14-py3-none-musllinux_1_2_i686.whl", hash = "sha256:62ce2ae46303ee896fc6811f63d6dabf8d9c389da0f3e3f2bce8bc7f15ef5488"},
-    {file = "ruff-0.1.14-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:b2027dde79d217b211d725fc833e8965dc90a16d0d3213f1298f97465956661b"},
-    {file = "ruff-0.1.14-py3-none-win32.whl", hash = "sha256:722bafc299145575a63bbd6b5069cb643eaa62546a5b6398f82b3e4403329cab"},
-    {file = "ruff-0.1.14-py3-none-win_amd64.whl", hash = "sha256:e3d241aa61f92b0805a7082bd89a9990826448e4d0398f0e2bc8f05c75c63d99"},
-    {file = "ruff-0.1.14-py3-none-win_arm64.whl", hash = "sha256:269302b31ade4cde6cf6f9dd58ea593773a37ed3f7b97e793c8594b262466b67"},
-    {file = "ruff-0.1.14.tar.gz", hash = "sha256:ad3f8088b2dfd884820289a06ab718cde7d38b94972212cc4ba90d5fbc9955f3"},
+    {file = "ruff-0.1.15-py3-none-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:5fe8d54df166ecc24106db7dd6a68d44852d14eb0729ea4672bb4d96c320b7df"},
+    {file = "ruff-0.1.15-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:6f0bfbb53c4b4de117ac4d6ddfd33aa5fc31beeaa21d23c45c6dd249faf9126f"},
+    {file = "ruff-0.1.15-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e0d432aec35bfc0d800d4f70eba26e23a352386be3a6cf157083d18f6f5881c8"},
+    {file = "ruff-0.1.15-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:9405fa9ac0e97f35aaddf185a1be194a589424b8713e3b97b762336ec79ff807"},
+    {file = "ruff-0.1.15-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:c66ec24fe36841636e814b8f90f572a8c0cb0e54d8b5c2d0e300d28a0d7bffec"},
+    {file = "ruff-0.1.15-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:6f8ad828f01e8dd32cc58bc28375150171d198491fc901f6f98d2a39ba8e3ff5"},
+    {file = "ruff-0.1.15-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:86811954eec63e9ea162af0ffa9f8d09088bab51b7438e8b6488b9401863c25e"},
+    {file = "ruff-0.1.15-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:fd4025ac5e87d9b80e1f300207eb2fd099ff8200fa2320d7dc066a3f4622dc6b"},
+    {file = "ruff-0.1.15-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b17b93c02cdb6aeb696effecea1095ac93f3884a49a554a9afa76bb125c114c1"},
+    {file = "ruff-0.1.15-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:ddb87643be40f034e97e97f5bc2ef7ce39de20e34608f3f829db727a93fb82c5"},
+    {file = "ruff-0.1.15-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:abf4822129ed3a5ce54383d5f0e964e7fef74a41e48eb1dfad404151efc130a2"},
+    {file = "ruff-0.1.15-py3-none-musllinux_1_2_i686.whl", hash = "sha256:6c629cf64bacfd136c07c78ac10a54578ec9d1bd2a9d395efbee0935868bf852"},
+    {file = "ruff-0.1.15-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:1bab866aafb53da39c2cadfb8e1c4550ac5340bb40300083eb8967ba25481447"},
+    {file = "ruff-0.1.15-py3-none-win32.whl", hash = "sha256:2417e1cb6e2068389b07e6fa74c306b2810fe3ee3476d5b8a96616633f40d14f"},
+    {file = "ruff-0.1.15-py3-none-win_amd64.whl", hash = "sha256:3837ac73d869efc4182d9036b1405ef4c73d9b1f88da2413875e34e0d6919587"},
+    {file = "ruff-0.1.15-py3-none-win_arm64.whl", hash = "sha256:9a933dfb1c14ec7a33cceb1e49ec4a16b51ce3c20fd42663198746efc0427360"},
+    {file = "ruff-0.1.15.tar.gz", hash = "sha256:f6dfa8c1b21c913c326919056c390966648b680966febcb796cc9d1aaab8564e"},
 ]

 [[package]]
@@ -3824,6 +3825,20 @@ brotli = ["brotli (>=1.0.9)", "brotlicffi (>=0.8.0)"]
 socks = ["pysocks (>=1.5.6,!=1.5.7,<2.0)"]
 zstd = ["zstandard (>=0.18.0)"]

+[[package]]
+name = "verspec"
+version = "0.1.0"
+description = "Flexible version handling"
+optional = false
+python-versions = "*"
+files = [
+    {file = "verspec-0.1.0-py3-none-any.whl", hash = "sha256:741877d5633cc9464c45a469ae2a31e801e6dbbaa85b9675d481cda100f11c31"},
+    {file = "verspec-0.1.0.tar.gz", hash = "sha256:c4504ca697b2056cdb4bfa7121461f5a0e81809255b41c03dda4ba823637c01e"},
+]
+
+[package.extras]
+test = ["coverage", "flake8 (>=3.7)", "mypy", "pretend", "pytest"]
+
 [[package]]
 name = "virtualenv"
 version = "20.25.0"
@@ -3972,4 +3987,4 @@ desktop = ["opencv-python"]
 [metadata]
 lock-version = "2.0"
 python-versions = "^3.8"
-content-hash = "5e5a6f753fc524c096453bc89bb70514d1a7b4ffda3a9c8ed4938b549d194b3f"
+content-hash = "07b8d86e8a1e4688ed81283e49b3969889b5374ca079cbafc1b4b7038b01b949"
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "supervision"
-version = "0.18.0"
+version = "0.19.0rc1"
 description = "A set of easy-to-use utils that will come in handy in any Computer Vision project"
 authors = ["Piotr Skalski <piotr.skalski92@gmail.com>"]
 maintainers = ["Piotr Skalski <piotr.skalski92@gmail.com>"]
@@ -53,7 +53,7 @@ assets = ["requests","tqdm"]

 [tool.poetry.group.dev.dependencies]
 twine = "^4.0.2"
-pytest = "^7.2.2"
+pytest = ">=7.2.2,<9.0.0"
 wheel = ">=0.40,<0.43"
 notebook = ">=6.5.3,<8.0.0"
 build = ">=0.10,<1.1"
@@ -67,6 +67,7 @@ tox = "^4.11.4"
 [tool.poetry.group.docs.dependencies]
 mkdocs-material = {extras = ["imaging"], version = "^9.5.5"}
 mkdocstrings = {extras = ["python"], version = ">=0.20,<0.25"}
+mike = "^2.0.0"


 [tool.isort]
@@ -6,7 +6,7 @@ import numpy as np

 from supervision.annotators.base import BaseAnnotator
 from supervision.annotators.utils import ColorLookup, Trace, resolve_color
-from supervision.config import CLASS_NAME_DATA_FIELD
+from supervision.config import CLASS_NAME_DATA_FIELD, ORIENTED_BOX_COORDINATES
 from supervision.detection.core import Detections
 from supervision.detection.utils import clip_boxes, mask_to_polygons
 from supervision.draw.color import Color, ColorPalette
@@ -153,11 +153,11 @@ class OrientedBoxAnnotator(BaseAnnotator):
            ```
        """  # noqa E501 // docs

-        if detections.data is None or "xyxyxyxy" not in detections.data:
+        if detections.data is None or ORIENTED_BOX_COORDINATES not in detections.data:
            return scene

        for detection_idx in range(len(detections)):
-            bbox = np.int0(detections.data.get("xyxyxyxy")[detection_idx])
+            bbox = np.int0(detections.data.get(ORIENTED_BOX_COORDINATES)[detection_idx])
            color = resolve_color(
                color=self.color,
                detections=detections,
@@ -1 +1,2 @@
 CLASS_NAME_DATA_FIELD = "class_name"
+ORIENTED_BOX_COORDINATES = "xyxyxyxy"
@@ -106,7 +106,7 @@ def detections_to_coco_annotations(
    approximation_percentage: float = 0.75,
 ) -> Tuple[List[Dict], int]:
    coco_annotations = []
-    for xyxy, mask, _, class_id, _ in detections:
+    for xyxy, mask, _, class_id, _, _ in detections:
        box_width, box_height = xyxy[2] - xyxy[0], xyxy[3] - xyxy[1]
        polygon = []
        if mask is not None:
@@ -109,7 +109,7 @@ def detections_to_pascal_voc(
    segmented.text = "0"

    # Add object elements
-    for xyxy, mask, _, class_id, _ in detections:
+    for xyxy, mask, _, class_id, _, _ in detections:
        name = classes[class_id]
        if mask is not None:
            polygons = approximate_mask_with_polygons(
@@ -194,7 +194,7 @@ def detections_to_yolo_annotations(
    approximation_percentage: float = 0.75,
 ) -> List[str]:
    annotation = []
-    for xyxy, mask, _, class_id, _ in detections:
+    for xyxy, mask, _, class_id, _, _ in detections:
        if mask is not None:
            polygons = approximate_mask_with_polygons(
                mask=mask,
@@ -5,8 +5,13 @@ import numpy as np

 from supervision.detection.core import Detections
 from supervision.draw.color import Color, ColorPalette
+from supervision.utils.internal import deprecated


+@deprecated(
+    "`BoxAnnotator` is deprecated and will be removed in "
+    "`supervision-0.22.0`. Use `BoundingBoxAnnotator` and `LabelAnnotator` instead"
+)
 class BoxAnnotator:
    """
    A class for drawing bounding boxes on an image using detections provided.
@@ -6,6 +6,7 @@ from typing import Any, Dict, Iterator, List, Optional, Tuple, Union

 import numpy as np

+from supervision.config import CLASS_NAME_DATA_FIELD, ORIENTED_BOX_COORDINATES
 from supervision.detection.utils import (
    calculate_masks_centroids,
    extract_ultralytics_masks,
@@ -24,7 +25,34 @@ from supervision.utils.internal import deprecated
@dataclass
 class Detections:
    """
-    A dataclass representing detection results.
+    The `sv.Detections` allows you to convert results from a variety of object detection
+    and segmentation models into a single, unified format. The `sv.Detections` class
+    enables easy data manipulation and filtering, and provides a consistent API for
+    Supervision's tools like trackers, annotators, and zones.
+
+    ```python
+    import cv2
+    import supervision as sv
+    from ultralytics import YOLO
+
+    image = cv2.imread(<SOURCE_IMAGE_PATH>)
+    model = YOLO('yolov8s.pt')
+    annotator = sv.BoundingBoxAnnotator()
+
+    result = model(image)[0]
+    detections = sv.Detections.from_ultralytics(result)
+
+    annotated_image = annotator.annotate(image, detections)
+    ```
+
+    !!! tip
+
+        In `sv.Detections`, detection data is categorized into two main field types:
+        fixed and custom. The fixed fields include `xyxy`, `mask`, `confidence`,
+        `class_id`, and `tracker_id`. For any additional data requirements, custom
+        fields come into play, stored in the data field. These custom fields are easily
+        accessible using the `detections[<FIELD_NAME>]` syntax, providing flexibility
+        for diverse data handling needs.

    Attributes:
        xyxy (np.ndarray): An array of shape `(n, 4)` containing
@@ -179,24 +207,33 @@ class Detections:
        """  # noqa: E501 // docs

        if ultralytics_results.obb is not None:
+            class_id = ultralytics_results.obb.cls.cpu().numpy().astype(int)
+            class_names = np.array([ultralytics_results.names[i] for i in class_id])
+            oriented_box_coordinates = ultralytics_results.obb.xyxyxyxy.cpu().numpy()
            return cls(
                xyxy=ultralytics_results.obb.xyxy.cpu().numpy(),
-                data={"xyxyxyxy": ultralytics_results.obb.xyxyxyxy.cpu().numpy()},
                confidence=ultralytics_results.obb.conf.cpu().numpy(),
-                class_id=ultralytics_results.obb.cls.cpu().numpy().astype(int),
+                class_id=class_id,
                tracker_id=ultralytics_results.obb.id.int().cpu().numpy()
                if ultralytics_results.obb.id is not None
                else None,
+                data={
+                    ORIENTED_BOX_COORDINATES: oriented_box_coordinates,
+                    CLASS_NAME_DATA_FIELD: class_names,
+                },
            )

+        class_id = ultralytics_results.boxes.cls.cpu().numpy().astype(int)
+        class_names = np.array([ultralytics_results.names[i] for i in class_id])
        return cls(
            xyxy=ultralytics_results.boxes.xyxy.cpu().numpy(),
            confidence=ultralytics_results.boxes.conf.cpu().numpy(),
-            class_id=ultralytics_results.boxes.cls.cpu().numpy().astype(int),
+            class_id=class_id,
            mask=extract_ultralytics_masks(ultralytics_results),
            tracker_id=ultralytics_results.boxes.id.int().cpu().numpy()
            if ultralytics_results.boxes.id is not None
            else None,
+            data={CLASS_NAME_DATA_FIELD: class_names},
        )

    @classmethod
@@ -463,10 +500,15 @@ class Detections:
    @classmethod
    @deprecated(
        "`Detections.from_roboflow` is deprecated and will be removed in "
-        "`supervision-0.21.0`. Use `Detections.from_inference` instead."
+        "`supervision-0.22.0`. Use `Detections.from_inference` instead."
    )
    def from_roboflow(cls, roboflow_result: Union[dict, Any]) -> Detections:
        """
+        !!! failure "Deprecated"
+
+            `Detections.from_roboflow` is deprecated and will be removed in
+            `supervision-0.22.0`. Use `Detections.from_inference` instead.
+
        Create a Detections object from the [Roboflow](https://roboflow.com/)
            API inference result or the [Inference](https://inference.roboflow.com/)
            package results.
@@ -5,7 +5,8 @@ import numpy as np

 from supervision.detection.core import Detections
 from supervision.draw.color import Color
-from supervision.geometry.core import Point, Position, Rect, Vector
+from supervision.draw.utils import draw_text
+from supervision.geometry.core import Point, Position, Vector


 class LineZone:
@@ -174,6 +175,8 @@ class LineZoneAnnotator:
        text_padding: int = 10,
        custom_in_text: Optional[str] = None,
        custom_out_text: Optional[str] = None,
+        display_in_count: bool = True,
+        display_out_count: bool = True,
    ):
        """
        Initialize the LineCounterAnnotator object with default values.
@@ -186,6 +189,8 @@ class LineZoneAnnotator:
            text_scale (float): The scale of the text that will be drawn.
            text_offset (float): The offset of the text that will be drawn.
            text_padding (int): The padding of the text that will be drawn.
+            display_in_count (bool): Whether to display the in count or not.
+            display_out_count (bool): Whether to display the out count or not.

        """
        self.thickness: float = thickness
@@ -197,6 +202,43 @@ class LineZoneAnnotator:
        self.text_padding: int = text_padding
        self.custom_in_text: str = custom_in_text
        self.custom_out_text: str = custom_out_text
+        self.display_in_count: bool = display_in_count
+        self.display_out_count: bool = display_out_count
+
+    def _annotate_count(
+        self,
+        frame: np.ndarray,
+        center_text_anchor: Point,
+        text: str,
+        is_in_count: bool,
+    ) -> None:
+        """This method is drawing the text on the frame.
+
+        Args:
+            frame (np.ndarray): The image on which the text will be drawn.
+            center_text_anchor: The center point that the text will be drawn.
+            text (str): The text that will be drawn.
+            is_in_count (bool): Whether to display the in count or out count.
+        """
+        _, text_height = cv2.getTextSize(
+            text, cv2.FONT_HERSHEY_SIMPLEX, self.text_scale, self.text_thickness
+        )[0]
+
+        if is_in_count:
+            center_text_anchor.y -= int(self.text_offset * text_height)
+        else:
+            center_text_anchor.y += int(self.text_offset * text_height)
+
+        draw_text(
+            scene=frame,
+            text=text,
+            text_anchor=center_text_anchor,
+            text_color=self.text_color,
+            text_scale=self.text_scale,
+            text_thickness=self.text_thickness,
+            text_padding=self.text_padding,
+            background_color=self.color,
+        )

    def annotate(self, frame: np.ndarray, line_counter: LineZone) -> np.ndarray:
        """
@@ -237,90 +279,33 @@ class LineZoneAnnotator:
            lineType=cv2.LINE_AA,
        )

-        in_text = (
-            f"{self.custom_in_text}: {line_counter.in_count}"
-            if self.custom_in_text is not None
-            else f"in: {line_counter.in_count}"
-        )
-        out_text = (
-            f"{self.custom_out_text}: {line_counter.out_count}"
-            if self.custom_out_text is not None
-            else f"out: {line_counter.out_count}"
+        text_anchor = Vector(
+            start=line_counter.vector.start, end=line_counter.vector.end
        )

-        (in_text_width, in_text_height), _ = cv2.getTextSize(
-            in_text, cv2.FONT_HERSHEY_SIMPLEX, self.text_scale, self.text_thickness
-        )
-        (out_text_width, out_text_height), _ = cv2.getTextSize(
-            out_text, cv2.FONT_HERSHEY_SIMPLEX, self.text_scale, self.text_thickness
-        )
+        if self.display_in_count:
+            in_text = (
+                f"{self.custom_in_text}: {line_counter.in_count}"
+                if self.custom_in_text is not None
+                else f"in: {line_counter.in_count}"
+            )
+            self._annotate_count(
+                frame=frame,
+                center_text_anchor=text_anchor.center,
+                text=in_text,
+                is_in_count=True,
+            )

-        in_text_x = int(
-            (line_counter.vector.end.x + line_counter.vector.start.x - in_text_width)
-            / 2
-        )
-        in_text_y = int(
-            (line_counter.vector.end.y + line_counter.vector.start.y + in_text_height)
-            / 2
-            - self.text_offset * in_text_height
-        )
-
-        out_text_x = int(
-            (line_counter.vector.end.x + line_counter.vector.start.x - out_text_width)
-            / 2
-        )
-        out_text_y = int(
-            (line_counter.vector.end.y + line_counter.vector.start.y + out_text_height)
-            / 2
-            + self.text_offset * out_text_height
-        )
-
-        in_text_background_rect = Rect(
-            x=in_text_x,
-            y=in_text_y - in_text_height,
-            width=in_text_width,
-            height=in_text_height,
-        ).pad(padding=self.text_padding)
-        out_text_background_rect = Rect(
-            x=out_text_x,
-            y=out_text_y - out_text_height,
-            width=out_text_width,
-            height=out_text_height,
-        ).pad(padding=self.text_padding)
-
-        cv2.rectangle(
-            frame,
-            in_text_background_rect.top_left.as_xy_int_tuple(),
-            in_text_background_rect.bottom_right.as_xy_int_tuple(),
-            self.color.as_bgr(),
-            -1,
-        )
-        cv2.rectangle(
-            frame,
-            out_text_background_rect.top_left.as_xy_int_tuple(),
-            out_text_background_rect.bottom_right.as_xy_int_tuple(),
-            self.color.as_bgr(),
-            -1,
-        )
-
-        cv2.putText(
-            frame,
-            in_text,
-            (in_text_x, in_text_y),
-            cv2.FONT_HERSHEY_SIMPLEX,
-            self.text_scale,
-            self.text_color.as_bgr(),
-            self.text_thickness,
-            cv2.LINE_AA,
-        )
-        cv2.putText(
-            frame,
-            out_text,
-            (out_text_x, out_text_y),
-            cv2.FONT_HERSHEY_SIMPLEX,
-            self.text_scale,
-            self.text_color.as_bgr(),
-            self.text_thickness,
-            cv2.LINE_AA,
-        )
+        if self.display_out_count:
+            out_text = (
+                f"{self.custom_out_text}: {line_counter.out_count}"
+                if self.custom_out_text is not None
+                else f"out: {line_counter.out_count}"
+            )
+            self._annotate_count(
+                frame=frame,
+                center_text_anchor=text_anchor.center,
+                text=out_text,
+                is_in_count=False,
+            )
        return frame
@@ -206,7 +206,7 @@ class Color:
    @classmethod
    @deprecated(
        "`Color.white()` is deprecated and will be removed in "
-        "`supervision-0.20.0`. Use `Color.WHITE` instead."
+        "`supervision-0.22.0`. Use `Color.WHITE` instead."
    )
    def white(cls) -> Color:
        return Color.from_hex(color_hex="#ffffff")
@@ -214,7 +214,7 @@ class Color:
    @classmethod
    @deprecated(
        "`Color.black()` is deprecated and will be removed in "
-        "`supervision-0.20.0`. Use `Color.BLACK` instead."
+        "`supervision-0.22.0`. Use `Color.BLACK` instead."
    )
    def black(cls) -> Color:
        return Color.from_hex(color_hex="#000000")
@@ -222,7 +222,7 @@ class Color:
    @classmethod
    @deprecated(
        "`Color.red()` is deprecated and will be removed in "
-        "`supervision-0.20.0`. Use `Color.RED` instead."
+        "`supervision-0.22.0`. Use `Color.RED` instead."
    )
    def red(cls) -> Color:
        return Color.from_hex(color_hex="#ff0000")
@@ -230,7 +230,7 @@ class Color:
    @classmethod
    @deprecated(
        "`Color.green()` is deprecated and will be removed in "
-        "`supervision-0.20.0`. Use `Color.GREEN` instead."
+        "`supervision-0.22.0`. Use `Color.GREEN` instead."
    )
    def green(cls) -> Color:
        return Color.from_hex(color_hex="#00ff00")
@@ -238,7 +238,7 @@ class Color:
    @classmethod
    @deprecated(
        "`Color.blue()` is deprecated and will be removed in "
-        "`supervision-0.20.0`. Use `Color.BLUE` instead."
+        "`supervision-0.22.0`. Use `Color.BLUE` instead."
    )
    def blue(cls) -> Color:
        return Color.from_hex(color_hex="#0000ff")
@@ -297,10 +297,15 @@ class ColorPalette:
    @classmethod
    @deprecated(
        "`ColorPalette.default()` is deprecated and will be removed in "
-        "`supervision-0.20.0`. Use `Color.DEFAULT` instead."
+        "`supervision-0.22.0`. Use `Color.DEFAULT` instead."
    )
    def default(cls) -> ColorPalette:
        """
+        !!! failure "Deprecated"
+
+            `ColorPalette.default()` is deprecated and will be removed in
+            `supervision-0.22.0`. Use `Color.DEFAULT` instead.
+
        Returns a default color palette.

        Returns:
@@ -148,9 +148,12 @@ def draw_text(
        fontScale=text_scale,
        thickness=text_thickness,
    )[0]
+
+    text_anchor_x, text_anchor_y = text_anchor.as_xy_int_tuple()
+
    text_rect = Rect(
-        x=text_anchor.x - text_width // 2,
-        y=text_anchor.y - text_height // 2,
+        x=text_anchor_x - text_width // 2,
+        y=text_anchor_y - text_height // 2,
        width=text_width,
        height=text_height,
    ).pad(text_padding)
@@ -163,7 +166,7 @@ def draw_text(
    cv2.putText(
        img=scene,
        text=text,
-        org=(text_anchor.x - text_width // 2, text_anchor.y + text_height // 2),
+        org=(text_anchor_x - text_width // 2, text_anchor_y + text_height // 2),
        fontFace=text_font,
        fontScale=text_scale,
        color=text_color.as_bgr(),
@@ -56,6 +56,19 @@ class Vector:
        dy = self.end.y - self.start.y
        return sqrt(dx**2 + dy**2)

+    @property
+    def center(self) -> Point:
+        """
+        Calculate the center point of the vector.
+
+        Returns:
+            Point: The center point of the vector.
+        """
+        return Point(
+            x=(self.start.x + self.end.x) / 2,
+            y=(self.start.y + self.end.y) / 2,
+        )
+
    def cross_product(self, point: Point) -> float:
        """
        Calculate the 2D cross product (also known as the vector product or outer
@@ -210,6 +210,7 @@ class ByteTrack:
            ```python
            import supervision as sv
            from ultralytics import YOLO
+            import numpy as np

            model = YOLO(<MODEL_PATH>)
            tracker = sv.ByteTrack()
@@ -220,7 +221,7 @@ class ByteTrack:
            def callback(frame: np.ndarray, index: int) -> np.ndarray:
                results = model(frame)[0]
                detections = sv.Detections.from_ultralytics(results)
-                detections = byte_tracker.update_with_detections(detections)
+                detections = tracker.update_with_detections(detections)

                labels = [f"#{tracker_id}" for tracker_id in detections.tracker_id]

@@ -26,7 +26,7 @@ def crop_image(image: np.ndarray, xyxy: np.ndarray) -> np.ndarray:
        with sv.ImageSink(target_dir_path='target/directory/path') as sink:
            for xyxy in detection.xyxy:
                cropped_image = sv.crop_image(image=image, xyxy=xyxy)
-                sink.save_image(image=image)
+                sink.save_image(image=cropped_image)
        ```
    """

@@ -8,6 +8,8 @@ from typing import Callable, Generator, Optional, Tuple
 import cv2
 import numpy as np

+from supervision.utils.internal import deprecated
+

@dataclass
 class VideoInfo:
@@ -219,25 +221,43 @@ class FPSMonitor:
            ```python
            import supervision as sv

-            frames_generator = sv.get_video_frames_generator('source.mp4')
+            frames_generator = sv.get_video_frames_generator(source_path=<SOURCE_FILE_PATH>)
            fps_monitor = sv.FPSMonitor()

            for frame in frames_generator:
                # your processing code here
                fps_monitor.tick()
-                fps = fps_monitor()
+                fps = fps_monitor.fps
            ```
-        """
+        """  # noqa: E501 // docs
        self.all_timestamps = deque(maxlen=sample_size)

+    @deprecated(
+        "`FPSMonitor.__call__` is deprecated and will be removed in "
+        "`supervision-0.22.0`. Use `FPSMonitor.fps` instead."
+    )
    def __call__(self) -> float:
+        """
+        !!! failure "Deprecated"
+
+            `FPSMonitor.__call__` is deprecated and will be removed in
+            `supervision-0.22.0`. Use `FPSMonitor.fps` instead.
+
+        Computes and returns the average FPS based on the stored time stamps.
+
+        Returns:
+            float: The average FPS. Returns 0.0 if no time stamps are stored.
+        """
+        return self.fps
+
+    @property
+    def fps(self) -> float:
        """
        Computes and returns the average FPS based on the stored time stamps.

        Returns:
            float: The average FPS. Returns 0.0 if no time stamps are stored.
        """
-
        if not self.all_timestamps:
            return 0.0
        taken_time = self.all_timestamps[-1] - self.all_timestamps[0]
Author	SHA1	Message	Date
Piotr Skalski	46426f816a	Merge pull request #830 from roboflow/feature/update_fps_monitor_api Update `FPSMonitor` API	2024-01-31 22:29:29 +01:00
pre-commit-ci[bot]	2280de707b	fix(pre_commit): 🎨 auto format pre-commit hooks	2024-01-31 21:27:15 +00:00
SkalskiP	da8cc0cbaa	documentation updated	2024-01-31 22:25:47 +01:00
pre-commit-ci[bot]	b6ddd21cdb	fix(pre_commit): 🎨 auto format pre-commit hooks	2024-01-31 21:18:42 +00:00
SkalskiP	92f8fefef1	Merge branch 'develop' into feature/update_fps_monitor_api	2024-01-31 22:18:29 +01:00
SkalskiP	5771a29d33	`deprecated.md` added	2024-01-31 22:12:54 +01:00
Piotr Skalski	34af22581e	Merge pull request #828 from roboflow/feature/improved-communication-of-deprecated-features improved communication of deprecated features	2024-01-31 22:05:00 +01:00
pre-commit-ci[bot]	3d2530f3a6	fix(pre_commit): 🎨 auto format pre-commit hooks	2024-01-31 21:02:30 +00:00
SkalskiP	9817598c2c	improved communication of deprecated features	2024-01-31 21:59:06 +01:00
SkalskiP	173719020e	ready for tests	2024-01-31 18:01:42 +01:00
Piotr Skalski	c692d264ae	Merge pull request #823 from roboflow/doc/fix-table-of-content-duplicates docs(fix): 🐞📝 removal of table of content duplicates	2024-01-31 14:40:03 +01:00
Onuralp SEZER	840fe2c5d5	docs(fix): 🐞📝 removal of table of content duplicates assets and datasets Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 16:33:08 +03:00
Onuralp SEZER	49a30f9830	docs: ✨ Twitter logo updated Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 16:19:23 +03:00
Onuralp SEZER	c7501868d0	docs: ✨ Supervision 2024 docs (copyright fix) Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 16:15:43 +03:00
Onuralp SEZER	5f684e717c	docs(fix): 🐞📝 removal of table of content duplicates annotators Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 15:58:31 +03:00
Onuralp SEZER	95a19d1c0e	docs(fix): 🐞📝 removal of table of content duplicates assets,datasets,trackers,file,utils/(image,notebook,video) Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 15:54:36 +03:00
Onuralp SEZER	b81eb85616	docs(fix): 🐞📝 add missing h1 for how tos Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 15:19:51 +03:00
Onuralp SEZER	bf9d56215a	docs(fix): 🐞📝 removal of table of content duplicates core/geometry Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 15:19:36 +03:00
Onuralp SEZER	31fff6c821	docs(fix): 🐞📝 removal of table of content duplicates utils/draw functions Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 15:18:54 +03:00
Onuralp SEZER	9a3c3fee2f	docs(fix): 🐞📝 removal of table of content duplicates Color Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 15:18:41 +03:00
Onuralp SEZER	443edc9760	docs(fix): 🐞📝 removal of table of content duplicates Detection Smoother Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 15:18:19 +03:00
Onuralp SEZER	beec044421	docs(fix): 🐞📝 removal of table of content duplicates PolygonZone,PolygonZoneAnnotator Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 15:17:53 +03:00
Onuralp SEZER	1aab21c333	docs(fix): 🐞📝 removal of table of content duplicates LineZone Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 15:15:06 +03:00
Onuralp SEZER	05aed165dc	docs(fix): 🐞📝 removal of table of content duplicates InferenceSlicer Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 15:14:11 +03:00
Onuralp SEZER	921b450040	docs(fix): 🐞📝 removal of table of content duplicates Detections/utils Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 15:13:30 +03:00
Onuralp SEZER	a8d8ed5cb4	docs(fix): 🐞📝 removal of table of content duplicates core(Detections,Classification) Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 15:09:07 +03:00
Onuralp SEZER	c44767cc12	Merge pull request #822 from roboflow/mike-provider-typo-fix fix: 🐞 version provider typo fix	2024-01-31 14:24:30 +03:00
Onuralp SEZER	947f8d35c4	fix: 🐞 version provider typo fix Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 14:22:21 +03:00
Piotr Skalski	eaaa1a83c7	Merge pull request #815 from roboflow/gh-mike-docs-setup ci: 👷 documentation build via mike for develop tag configuration	2024-01-31 12:05:24 +01:00
Piotr Skalski	0d36d01afc	Merge pull request #814 from roboflow/feature/make-from_ultralytics-extract-class-names-from-result make `from_ultralytics` extract class names from result	2024-01-31 08:30:33 +01:00
SkalskiP	fc571cc191	Merge remote-tracking branch 'origin/feature/make-from_ultralytics-extract-class-names-from-result' into feature/make-from_ultralytics-extract-class-names-from-result	2024-01-31 08:28:45 +01:00
SkalskiP	c6718d374c	update docs	2024-01-31 08:28:34 +01:00
Onuralp SEZER	4b75daaad6	ci: 👷 documentation build via mike for develop tag configuration Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-31 01:28:22 +03:00
Onuralp SEZER	e801879e70	Merge pull request #811 from roboflow/dependabot/pip/ruff-0.1.15 ⬆️ Bump ruff from 0.1.14 to 0.1.15	2024-01-31 00:05:55 +03:00
pre-commit-ci[bot]	33b7861c70	fix(pre_commit): 🎨 auto format pre-commit hooks	2024-01-30 17:36:04 +00:00
Onuralp SEZER	5d93ae61ee	Merge pull request #813 from Kadermiyanyedi/fix-typos-in-the-changelog-file Fix typos in the CITATION.cff and changelog.md files	2024-01-30 20:35:51 +03:00
SkalskiP	7f9153e826	initial commit	2024-01-30 18:34:41 +01:00
Kader Miyanyedi	a1cc319293	chore(docs): fix typos	2024-01-30 20:16:31 +03:00
Piotr Skalski	6147b6ee03	Merge pull request #802 from Kadermiyanyedi/make-display-values-optional LineZoneAnnotator make display of int/out values optional	2024-01-30 13:37:27 +01:00
Kader Miyanyedi	c285ff68b4	chore(line_zone_annotator): update is_in_count parameter description	2024-01-30 15:32:10 +03:00
Piotr Skalski	5ae3327737	Merge pull request #801 from KingKokouvi/traffic_analysis_0 Refactor class DetectionsManager to handle empty detections_all array	2024-01-30 13:08:38 +01:00
Kader Miyanyedi	e0294cd296	refactor(line_zone_annotator): refactor _annotate_count method	2024-01-30 14:28:15 +03:00
Kokouvi	226090aeaf	Update inference_example.py formattig	2024-01-30 11:20:55 +00:00
Kokouvi	0603527bb2	Update inference_example.py fix formatting	2024-01-30 11:12:54 +00:00
Kokouvi	c781a8efa1	Update ultralytics_example.py adding else statement to return an empty array when there is no detections	2024-01-30 10:58:16 +00:00
Kokouvi	82aa4bb857	Update inference_example.py Formatting	2024-01-30 10:55:34 +00:00
pre-commit-ci[bot]	6c98e211e5	fix(pre_commit): 🎨 auto format pre-commit hooks	2024-01-30 10:54:00 +00:00
Kokouvi	1e482e172f	Update inference_example.py Adding else statement	2024-01-30 10:53:40 +00:00
dependabot[bot]	499cf7e294	⬆️ Bump ruff from 0.1.14 to 0.1.15 Bumps [ruff](https://github.com/astral-sh/ruff) from 0.1.14 to 0.1.15. - [Release notes](https://github.com/astral-sh/ruff/releases) - [Changelog](https://github.com/astral-sh/ruff/blob/main/CHANGELOG.md) - [Commits](https://github.com/astral-sh/ruff/compare/v0.1.14...v0.1.15) --- updated-dependencies: - dependency-name: ruff dependency-type: direct:development update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com>	2024-01-30 01:00:51 +00:00
Onuralp SEZER	9aaa18865b	Merge pull request #810 from roboflow/pre-commit-ci-update-config chore(pre_commit): ⬆ pre_commit autoupdate	2024-01-30 00:15:55 +03:00
Kader Miyanyedi	9210ccf8b7	refactor(line_zone_annotator): use draw_text function in the annotate_count method and add center method to vector	2024-01-29 22:30:34 +03:00
pre-commit-ci[bot]	563a0299a8	chore(pre_commit): ⬆ pre_commit autoupdate updates: - [github.com/PyCQA/bandit: 1.7.6 → 1.7.7](https://github.com/PyCQA/bandit/compare/1.7.6...1.7.7)	2024-01-29 17:40:27 +00:00
Piotr Skalski	30db3c3f06	Merge pull request #806 from roboflow/multi-version-docs-prep feat: ✨ mkdocs multi versioning package and old doc deployment CI disabled	2024-01-29 12:35:05 +01:00
Onuralp SEZER	5cc21bc768	feat: ✨ mkdocs multi versioning package and old doc deployment CI disabled Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-29 14:30:46 +03:00
Onuralp SEZER	9deea66679	Merge pull request #805 from roboflow/dependabot/pip/pytest-8.0.0 ⬆️ bump pytest from 7.4.4 to 8.0.0	2024-01-29 11:31:45 +03:00
Onuralp SEZER	cfc086f3ea	Merge pull request #804 from roboflow/dependabot/pip/mkdocs-material-9.5.6 ⬆️ bump mkdocs-material from 9.5.5 to 9.5.6	2024-01-29 11:31:22 +03:00
dependabot[bot]	28730308a5	⬆️ bump pytest from 7.4.4 to 8.0.0 --- updated-dependencies: - dependency-name: pytest dependency-type: direct:development update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com>	2024-01-29 01:22:57 +00:00
dependabot[bot]	89edbcf8ff	⬆️ bump mkdocs-material from 9.5.5 to 9.5.6 --- updated-dependencies: - dependency-name: mkdocs-material dependency-type: direct:development update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com>	2024-01-29 01:10:27 +00:00
Kader Miyanyedi	598e387f7c	feat(line_zone_annotator): make display of int/out values optional	2024-01-28 23:54:37 +03:00
bright1205	2d494893fc	Refactor class DetectionsManager to handle empty detections_all array	2024-01-28 16:29:11 +00:00
Piotr Skalski	a44c76563e	Merge pull request #798 from roboflow/fix/iterating-over-detections-in-detaset-loaders fix looping over detections in dataset loaders	2024-01-28 09:46:09 +01:00
SkalskiP	c41b68e9cb	fix looping over detections in dataset loaders	2024-01-28 09:39:26 +01:00
Piotr Skalski	9b21231204	Merge pull request #797 from roboflow/fix/crop_image_docs small `crop_image` documentation fix	2024-01-28 08:00:17 +01:00
SkalskiP	83fa7d0f2c	small `crop_image` documentation fix	2024-01-28 07:56:41 +01:00
Piotr Skalski	fff13d5ef2	Merge pull request #796 from roboflow/tracker-doc-fix docs: 📝 missing import of numpy and correct variable name in tracker section	2024-01-28 07:54:13 +01:00
Onuralp SEZER	5347b78469	docs: 📝 missing import of numpy and correct variable name in tracker section Signed-off-by: Onuralp SEZER <thunderbirdtr@gmail.com>	2024-01-28 01:25:35 +03:00
Piotr Skalski	3024ddca83	Merge pull request #776 from roboflow/main Merge pull request #764 from roboflow/develop	2024-01-25 10:35:54 +01:00