ultralytics 8.3.11__py3-none-any.whl → 8.3.13__py3-none-any.whl

ultralytics/utils/plotting.py

@@ -804,31 +804,30 @@ class Annotator:
                 self.im, label, (int(mask[0][0]) - text_size[0] // 2, int(mask[0][1])), 0, self.sf, txt_color, self.tf
             )
 
-    def plot_distance_and_line(self, pixels_distance, centroids, line_color, centroid_color):
+    def plot_distance_and_line(
+        self, pixels_distance, centroids, line_color=(104, 31, 17), centroid_color=(255, 0, 255)
+    ):
         """
         Plot the distance and line on frame.
 
         Args:
             pixels_distance (float): Pixels distance between two bbox centroids.
             centroids (list): Bounding box centroids data.
-            line_color (tuple): RGB distance line color.
-            centroid_color (tuple): RGB bounding box centroid color.
+            line_color (tuple, optional): Distance line color.
+            centroid_color (tuple, optional): Bounding box centroid color.
         """
         # Get the text size
-        (text_width_m, text_height_m), _ = cv2.getTextSize(
-            f"Pixels Distance: {pixels_distance:.2f}", 0, self.sf, self.tf
-        )
+        text = f"Pixels Distance: {pixels_distance:.2f}"
+        (text_width_m, text_height_m), _ = cv2.getTextSize(text, 0, self.sf, self.tf)
 
         # Define corners with 10-pixel margin and draw rectangle
-        top_left = (15, 25)
-        bottom_right = (15 + text_width_m + 20, 25 + text_height_m + 20)
-        cv2.rectangle(self.im, top_left, bottom_right, centroid_color, -1)
+        cv2.rectangle(self.im, (15, 25), (15 + text_width_m + 20, 25 + text_height_m + 20), line_color, -1)
 
         # Calculate the position for the text with a 10-pixel margin and draw text
-        text_position = (top_left[0] + 10, top_left[1] + text_height_m + 10)
+        text_position = (25, 25 + text_height_m + 10)
         cv2.putText(
             self.im,
-            f"Pixels Distance: {pixels_distance:.2f}",
+            text,
             text_position,
             0,
             self.sf,
@@ -1156,16 +1155,16 @@ def plot_results(file="path/to/results.csv", dir="", segment=False, pose=False,
     save_dir = Path(file).parent if file else Path(dir)
     if classify:
         fig, ax = plt.subplots(2, 2, figsize=(6, 6), tight_layout=True)
-        index = [1, 4, 2, 3]
+        index = [2, 5, 3, 4]
     elif segment:
         fig, ax = plt.subplots(2, 8, figsize=(18, 6), tight_layout=True)
-        index = [1, 2, 3, 4, 5, 6, 9, 10, 13, 14, 15, 16, 7, 8, 11, 12]
+        index = [2, 3, 4, 5, 6, 7, 10, 11, 14, 15, 16, 17, 8, 9, 12, 13]
     elif pose:
         fig, ax = plt.subplots(2, 9, figsize=(21, 6), tight_layout=True)
-        index = [1, 2, 3, 4, 5, 6, 7, 10, 11, 14, 15, 16, 17, 18, 8, 9, 12, 13]
+        index = [2, 3, 4, 5, 6, 7, 8, 11, 12, 15, 16, 17, 18, 19, 9, 10, 13, 14]
     else:
         fig, ax = plt.subplots(2, 5, figsize=(12, 6), tight_layout=True)
-        index = [1, 2, 3, 4, 5, 8, 9, 10, 6, 7]
+        index = [2, 3, 4, 5, 6, 9, 10, 11, 7, 8]
     ax = ax.ravel()
     files = list(save_dir.glob("results*.csv"))
     assert len(files), f"No results.csv files found in {save_dir.resolve()}, nothing to plot."

{ultralytics-8.3.11.dist-info → ultralytics-8.3.13.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ultralytics
-Version: 8.3.11
+Version: 8.3.13
 Summary: Ultralytics YOLO for SOTA object detection, multi-object tracking, instance segmentation, pose estimation and image classification.
 Author-email: Glenn Jocher <glenn.jocher@ultralytics.com>, Jing Qiu <jing.qiu@ultralytics.com>
 Maintainer-email: Ultralytics <hello@ultralytics.com>
@@ -60,10 +60,6 @@ Requires-Dist: mkdocs-jupyter; extra == "dev"
 Requires-Dist: mkdocs-redirects; extra == "dev"
 Requires-Dist: mkdocs-ultralytics-plugin>=0.1.8; extra == "dev"
 Requires-Dist: mkdocs-macros-plugin>=1.0.5; extra == "dev"
-Provides-Extra: explorer
-Requires-Dist: lancedb; extra == "explorer"
-Requires-Dist: duckdb<=0.9.2; extra == "explorer"
-Requires-Dist: streamlit; extra == "explorer"
 Provides-Extra: export
 Requires-Dist: onnx>=1.12.0; extra == "export"
 Requires-Dist: openvino>=2024.0.0; extra == "export"
@@ -85,6 +81,9 @@ Provides-Extra: logging
 Requires-Dist: comet; extra == "logging"
 Requires-Dist: tensorboard>=2.13.0; extra == "logging"
 Requires-Dist: dvclive>=2.12.0; extra == "logging"
+Provides-Extra: solutions
+Requires-Dist: shapely>=2.0.0; extra == "solutions"
+Requires-Dist: streamlit; extra == "solutions"
 
 <div align="center">
   <p>

{ultralytics-8.3.11.dist-info → ultralytics-8.3.13.dist-info}/RECORD

@@ -1,16 +1,16 @@
 tests/__init__.py,sha256=iVH5nXrACTDv0_ZIVRPi-9f6oYBl6g-tCkeR2Hb8MFM,666
 tests/conftest.py,sha256=9PFAiwAy6eeORGspr5dOKxVuFDVKqYg8Nn_RxSJ27UI,2919
-tests/test_cli.py,sha256=E4lMt49TGo12Lb5CgQfpk1bwyFUZuFxF0V9j_ykV7xM,4821
-tests/test_cuda.py,sha256=KoRtRLUB7KOb9IXYX4mCi295Uh_cZEEFhCyvCDGRK9s,5381
+tests/test_cli.py,sha256=G7OJ1ErQYsGy2Dx1zP-0p7EZR4aPoAdtLGiY4Hm7jQM,5006
+tests/test_cuda.py,sha256=cxohrqAjjPCgTaChYhQ4CObQzz7ZyhVGPTxkcxHSf0g,5940
 tests/test_engine.py,sha256=dcEcJsMQh61rDSNv7l4TIAgybLpzjVwerv9JZC_KCM8,4934
 tests/test_exports.py,sha256=fpTKEVBUGLF3WiZPNKRs-IEcIY4cfxgvgKjUNfodjww,8042
 tests/test_integrations.py,sha256=f5-QCUk1SU_-qn4mBCZwS3GN3tXEBIIXo4z2EhExbHw,6126
 tests/test_python.py,sha256=I1RRdCwLdrc3jX06huVxct8HX8ccQOmQgVpuEflRl0U,23560
 tests/test_solutions.py,sha256=dpxWGKO-aJ3Yff4KR7BQGajX9VyFdGTWEtcbmFC3WwE,3005
-ultralytics/__init__.py,sha256=19JcU9M-VZ6RCIz0c3u-8ynzEpeqhYIKNSN9t_kpNuI,753
+ultralytics/__init__.py,sha256=2rg2RMDy6HqtBcSx4b7eBss9eXQ6leZvZ6drzM-8sFI,681
 ultralytics/assets/bus.jpg,sha256=wCAZxJecGR63Od3ZRERe9Aja1Weayrb9Ug751DS_vGM,137419
 ultralytics/assets/zidane.jpg,sha256=Ftc4aeMmen1O0A3o6GCDO9FlfBslLpTAw0gnetx7bts,50427
-ultralytics/cfg/__init__.py,sha256=N-XONBXwmD3vzoE4icBXznkV8LOLmf6ak6mRdGPucvw,33146
+ultralytics/cfg/__init__.py,sha256=CUg1z4zY3KyR-V4_bghMY8s1xuu-M50gm-v_vpHdXEM,31753
 ultralytics/cfg/default.yaml,sha256=ul49zgSzTegMmc8CFeu9tXkWNvQhETdZMa9EgDNSnY4,8319
 ultralytics/cfg/datasets/Argoverse.yaml,sha256=FyeuJT5CHq_9d4hlfAf0kpZlnbUMO0S--UJ1yIqcdKk,3134
 ultralytics/cfg/datasets/DOTAv1.5.yaml,sha256=QVfp_Qp-4rukuicaB4qx86NxSHM8Mrzym8l_fIDo8gw,1195
@@ -85,7 +85,7 @@ ultralytics/cfg/models/v9/yolov9e.yaml,sha256=dhaR47WxuLOrZWDCceS4bQG00sQdrMc8FQ
 ultralytics/cfg/models/v9/yolov9m.yaml,sha256=l6CmivzNu44sRVmkQXk4-tXflbV1nWnk5MSc8su2vhs,1311
 ultralytics/cfg/models/v9/yolov9s.yaml,sha256=lPWcu-6ub1kCBD6zIDFwthYZ3RvdJfODWKy3vEQWRjo,1291
 ultralytics/cfg/models/v9/yolov9t.yaml,sha256=qL__kr6GoefpQWP4jV0jdzwTp46bdFUcqtPRnfDbkY8,1275
-ultralytics/cfg/solutions/default.yaml,sha256=CByxINYMyoGzGKdurDk2GhYc8XOa8Z6H7CZx7uZSPpc,1532
+ultralytics/cfg/solutions/default.yaml,sha256=zZ_ksoZ-BcAIL5jjw0jzHgraoe7363oxXqfSsg9yopk,1673
 ultralytics/cfg/trackers/botsort.yaml,sha256=8B0xNbnG_E-9DCUpap72PWkUgBb1AjuApEn7gHiVngE,916
 ultralytics/cfg/trackers/bytetrack.yaml,sha256=8vpTZ2x9mhRXJymoJvs1G8kTXo_HxbSwHup2FQALT3A,721
 ultralytics/data/__init__.py,sha256=VGe-ATG7j35F4A4r8Jmzffjlhve4JAJPgRa5ahKTU18,616
@@ -98,13 +98,8 @@ ultralytics/data/dataset.py,sha256=D556AW0ZEsW3V8c5zJiHM_prc_YfZqymIkDKPw3k9Io,2
 ultralytics/data/loaders.py,sha256=Fr70Q9p9t7buLW_8R2_lI_nyCMG033gWSxvwy1M-a-U,28449
 ultralytics/data/split_dota.py,sha256=yOtypHoY5HvIVBKZgFXdfj2tuCLLEBnMwNfAeG94Eik,10680
 ultralytics/data/utils.py,sha256=u6OZ7InLpI1em5aEPz13ZzS9BcO37dcY9_s2btXGZYQ,31076
-ultralytics/data/explorer/__init__.py,sha256=-Y3m1ZedepOQUv_KW82zaGxvU_PSHcuwUTFqG9BhAr4,113
-ultralytics/data/explorer/explorer.py,sha256=JWmLHHhp68h2q3vx4poBou5RYoAX3R89yihR50YLDb0,18881
-ultralytics/data/explorer/utils.py,sha256=EvvukQiQUTBrsZznmMnyEX2EqTuwZo_Geyc8yfi8NIA,7085
-ultralytics/data/explorer/gui/__init__.py,sha256=mHtJuK4hwF8cuV-VHDc7tp6u6D1gHz2Z7JI8grmQDTs,42
-ultralytics/data/explorer/gui/dash.py,sha256=6XOZy9NrkPEXREJPbi0EBkGgu78TAdHpdhSB2HuBOAo,10222
 ultralytics/engine/__init__.py,sha256=mHtJuK4hwF8cuV-VHDc7tp6u6D1gHz2Z7JI8grmQDTs,42
-ultralytics/engine/exporter.py,sha256=b3OIHAABVyqqSizJKQxiWPZvKzIvThK9kucN2iYWnwE,57487
+ultralytics/engine/exporter.py,sha256=lKmVaypzVY3R-RkCs1KQNrSpF6W4jKMZqNBKZ0CfzmA,57670
 ultralytics/engine/model.py,sha256=pvL1uf-wwdWL8Iph7VEAYn1-z7wEHzVug21V_0_gO6M,51456
 ultralytics/engine/predictor.py,sha256=keTelEeo23Dcbs-XvmRWAPIs4pbCNDtsMBz88WM1eK8,17534
 ultralytics/engine/results.py,sha256=BxanBI8PhBCfs-9cSy-GS6naScuiD3hdvUAJWPW2mS0,75043
@@ -135,7 +130,7 @@ ultralytics/models/sam/__init__.py,sha256=o4_D6y8YJlOXIK7Lwo9RHnIJJ9xoFNi4zK99QS
 ultralytics/models/sam/amg.py,sha256=GrmO_8YfIDt_QkPEMF_WFjPZkhwhf7iwx7ig8JgOUnE,8709
 ultralytics/models/sam/build.py,sha256=np9vP7AETCZA2Wdds-uj2eQKVnpHQaVpRrE2-U2uMTI,12153
 ultralytics/models/sam/model.py,sha256=2KFUp8SHiqOgwUjkdqdau0oduJwKQxm4N9GHWjdhUFo,7382
-ultralytics/models/sam/predict.py,sha256=_spP0uYNFzUnybwBvzZhF3iEMwvAi6bxryRdUwxwweM,38608
+ultralytics/models/sam/predict.py,sha256=LSxys7fuQycrAoqf_EFohk9ftu7cq1F2GY9_fuIl5uE,40384
 ultralytics/models/sam/modules/__init__.py,sha256=mHtJuK4hwF8cuV-VHDc7tp6u6D1gHz2Z7JI8grmQDTs,42
 ultralytics/models/sam/modules/blocks.py,sha256=Q-KwhFbdyZhl1tjG_kP2LcQkZbzoNt618i-NRrKNx2Y,45919
 ultralytics/models/sam/modules/decoders.py,sha256=mODsqnTN_CjE3H0Sh9cd8PfTnHANPjGB1bjqHxfezSg,25830
@@ -152,7 +147,7 @@ ultralytics/models/yolo/__init__.py,sha256=e1cZr9pbSbf3Ya2OvkTjGRwD_E2YZpe610xsk
 ultralytics/models/yolo/model.py,sha256=E4TuJZZux0L_SG7sC0SDgxrmeBvuZRpxprPrCC26lvs,4233
 ultralytics/models/yolo/classify/__init__.py,sha256=t-4pUHmgI2gjhc-l3bqNEcEtKD1dO40nD4Vc6Y2xD6o,355
 ultralytics/models/yolo/classify/predict.py,sha256=0CEJ4B4fXbOMUnJy79gRvG-qdszOzTSLOb1xxkgsKek,2444
-ultralytics/models/yolo/classify/train.py,sha256=THXSkQVQVBuw1QxcEVA8MtLHYYdaAEqepObJCXoLcZ8,6358
+ultralytics/models/yolo/classify/train.py,sha256=3aYzLDqX_03xR1xqlTn1TxA4t58cCIGI8RCtWheTrm0,6273
 ultralytics/models/yolo/classify/val.py,sha256=Tzizhp3ebzPvwJejrE8tb-TuXw4MdkEI9mOANV74eXQ,4909
 ultralytics/models/yolo/detect/__init__.py,sha256=JR8gZJWn7wMBbh-0j_073nxJVZTMFZVWTOG5Wnvk6w0,229
 ultralytics/models/yolo/detect/predict.py,sha256=-uZFLutxGYZX47RANcaxC-LFStRbv0nBv_8-ypadQoI,1471
@@ -185,10 +180,10 @@ ultralytics/nn/modules/transformer.py,sha256=tGiK8NmPfswwW1rbF21r5ILUkkZQ6Nk4s8j
 ultralytics/nn/modules/utils.py,sha256=a88cKl2wz1nMVSEBiajtvaCbDBQIkESWOKTZ_WAJy90,3195
 ultralytics/solutions/__init__.py,sha256=6RDeXWO1QSaMgCq8YrWXaj2xvPw2sJwJL_a0dgjCvz0,648
 ultralytics/solutions/ai_gym.py,sha256=lBAkWV8vrEdKAXcBFVbugPeZZ08MOjGYTdnFlG22vKM,3772
-ultralytics/solutions/analytics.py,sha256=bGuZes11D7DNiTsHdwu6PJ0QA0vCiqMMAtZ7NyEkshY,11568
-ultralytics/solutions/distance_calculation.py,sha256=o_DAHk4JX8n2Vt7E68MX67mREOBZuy5skbXtVZ6iu_4,5228
+ultralytics/solutions/analytics.py,sha256=w5hnnBNSTQ35tJp6DDeWYw2ASjylp3ZmzrTXcdWwDw8,9319
+ultralytics/solutions/distance_calculation.py,sha256=3D5qj9g-XGt_QPEu5IQI2ubTC0n2pmISDrNPl__JK9M,3373
 ultralytics/solutions/heatmap.py,sha256=2C4s_rVFcOc5oSWxb0pNxNoCawe4lxajpTDNFd4tVL8,3850
-ultralytics/solutions/object_counter.py,sha256=1Nsivk-cyGBM1G6eWe11_vdDWTdbJwaUFMJ1A7OK-Qg,5495
+ultralytics/solutions/object_counter.py,sha256=7s3Q--CAFHr_uXzeq6epXgl5YSinc6q-VThPBx1Gj3Y,5485
 ultralytics/solutions/parking_management.py,sha256=VgYyhoSEo7fnPegIhNUqnFL0jlMEevALx0QQbzJ3vGI,9049
 ultralytics/solutions/queue_management.py,sha256=5d1RURQiqffAoET8S66gHimK0l3gKNAfuPO5U6_08jc,2716
 ultralytics/solutions/solutions.py,sha256=qWKGlwlH9858GfAdZkcu_QXbrzjTFStDvg16Eky0oyo,3541
@@ -213,10 +208,10 @@ ultralytics/utils/errors.py,sha256=GqP_Jgj_n0paxn8OMhn3DTCgoNkB2WjUcUaqs-M6SQk,8
 ultralytics/utils/files.py,sha256=uiXQSVABJRoI5ImnM6ndEBIFbECfksmWNEldBg8GnSo,8224
 ultralytics/utils/instance.py,sha256=QSms7mPHZ5e8JGuJYLohLWltzI0aBE8dob2rOUK4RtM,16249
 ultralytics/utils/loss.py,sha256=SW3FVFFp8Ki_LCT8wIdFbm6KmyPcQn3RmKNcvVAhMQI,34174
-ultralytics/utils/metrics.py,sha256=UgLGudWp57uXDMlMUJy4gsz6cfVjcq7tYmHeto3TqvM,53927
+ultralytics/utils/metrics.py,sha256=msPaXc244ndc0NPBhnNlHsKkVhdc-TMgFn5NATlZZVI,53918
 ultralytics/utils/ops.py,sha256=dsXNdyrYx_p6io6zezig9p84dxS7U-10vceHNVu2IL0,32888
 ultralytics/utils/patches.py,sha256=J-iOwIRbfUs-inBZerhnXby5tUKjYcOIyvhLTS352JE,3270
-ultralytics/utils/plotting.py,sha256=aozAEwcbc447ume9bQrEBTU04AzyiZZrnzcTzA2S6j0,61165
+ultralytics/utils/plotting.py,sha256=RYTdMJtWOO5qPowca1a8izfasoIyGxzmfp9VGB_g0xE,61092
 ultralytics/utils/tal.py,sha256=ECsu95xEqOItmxMDN4YTD3FsUiIsQNWy0pZC3TfvFfk,16877
 ultralytics/utils/torch_utils.py,sha256=gVN-KSrAzJC1rW3woQd4FsTT693GD8rXiccToL2m4kM,30059
 ultralytics/utils/triton.py,sha256=gg1finxno_tY2Ge9PMhmu7PI9wvoFZoiicdT4Bhqv3w,3936
@@ -232,9 +227,9 @@ ultralytics/utils/callbacks/neptune.py,sha256=IbGQfEltamUKXJt93uSLQFn8c2rYh3DMTg
 ultralytics/utils/callbacks/raytune.py,sha256=ODVYzy-CoM4Uge0zjkh3Hnh9nF2M0vhDrSenXnvcizw,705
 ultralytics/utils/callbacks/tensorboard.py,sha256=bv4fkkesdgmZv_E2MU6wuaMBwEV5iI2G53RHPyD9quw,4170
 ultralytics/utils/callbacks/wb.py,sha256=upfbF8-LLXueUvulLaMDmKDhKCl_PWbNa_87PQ0L0Rc,6752
-ultralytics-8.3.11.dist-info/LICENSE,sha256=DZak_2itbUtvHzD3E7GNUYSRK6jdOJ-GqncQ2weavLA,34523
-ultralytics-8.3.11.dist-info/METADATA,sha256=bD92haGae0_AYj7u5Z8EE6OoUn5sAhwau3R0S-z6pVQ,34700
-ultralytics-8.3.11.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-ultralytics-8.3.11.dist-info/entry_points.txt,sha256=YM_wiKyTe9yRrsEfqvYolNO5ngwfoL4-NwgKzc8_7sI,93
-ultralytics-8.3.11.dist-info/top_level.txt,sha256=XP49TwiMw4QGsvTLSYiJhz1xF_k7ev5mQ8jJXaXi45Q,12
-ultralytics-8.3.11.dist-info/RECORD,,
+ultralytics-8.3.13.dist-info/LICENSE,sha256=DZak_2itbUtvHzD3E7GNUYSRK6jdOJ-GqncQ2weavLA,34523
+ultralytics-8.3.13.dist-info/METADATA,sha256=lwU4l_KFBx8TzMo_vwe4pyKOaepvZ3mPvWwm6Y951_A,34660
+ultralytics-8.3.13.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
+ultralytics-8.3.13.dist-info/entry_points.txt,sha256=YM_wiKyTe9yRrsEfqvYolNO5ngwfoL4-NwgKzc8_7sI,93
+ultralytics-8.3.13.dist-info/top_level.txt,sha256=XP49TwiMw4QGsvTLSYiJhz1xF_k7ev5mQ8jJXaXi45Q,12
+ultralytics-8.3.13.dist-info/RECORD,,

ultralytics/data/explorer/__init__.py

@@ -1,5 +0,0 @@
-# Ultralytics YOLO 🚀, AGPL-3.0 license
-
-from .utils import plot_query_result
-
-__all__ = ["plot_query_result"]

ultralytics/data/explorer/explorer.py

@@ -1,460 +0,0 @@
-# Ultralytics YOLO 🚀, AGPL-3.0 license
-
-from io import BytesIO
-from pathlib import Path
-from typing import Any, List, Tuple, Union
-
-import cv2
-import numpy as np
-import torch
-from matplotlib import pyplot as plt
-from PIL import Image
-from tqdm import tqdm
-
-from ultralytics.data.augment import Format
-from ultralytics.data.dataset import YOLODataset
-from ultralytics.data.utils import check_det_dataset
-from ultralytics.models.yolo.model import YOLO
-from ultralytics.utils import LOGGER, USER_CONFIG_DIR, IterableSimpleNamespace, checks
-
-from .utils import get_sim_index_schema, get_table_schema, plot_query_result, prompt_sql_query, sanitize_batch
-
-
-class ExplorerDataset(YOLODataset):
-    """Extends YOLODataset for advanced data exploration and manipulation in model training workflows."""
-
-    def __init__(self, *args, data: dict = None, **kwargs) -> None:
-        """Initializes the ExplorerDataset with the provided data arguments, extending the YOLODataset class."""
-        super().__init__(*args, data=data, **kwargs)
-
-    def load_image(self, i: int) -> Union[Tuple[np.ndarray, Tuple[int, int], Tuple[int, int]], Tuple[None, None, None]]:
-        """Loads 1 image from dataset index 'i' without any resize ops."""
-        im, f, fn = self.ims[i], self.im_files[i], self.npy_files[i]
-        if im is None:  # not cached in RAM
-            if fn.exists():  # load npy
-                im = np.load(fn)
-            else:  # read image
-                im = cv2.imread(f)  # BGR
-                if im is None:
-                    raise FileNotFoundError(f"Image Not Found {f}")
-            h0, w0 = im.shape[:2]  # orig hw
-            return im, (h0, w0), im.shape[:2]
-
-        return self.ims[i], self.im_hw0[i], self.im_hw[i]
-
-    def build_transforms(self, hyp: IterableSimpleNamespace = None):
-        """Creates transforms for dataset images without resizing."""
-        return Format(
-            bbox_format="xyxy",
-            normalize=False,
-            return_mask=self.use_segments,
-            return_keypoint=self.use_keypoints,
-            batch_idx=True,
-            mask_ratio=hyp.mask_ratio,
-            mask_overlap=hyp.overlap_mask,
-        )
-
-
-class Explorer:
-    """Utility class for image embedding, table creation, and similarity querying using LanceDB and YOLO models."""
-
-    def __init__(
-        self,
-        data: Union[str, Path] = "coco128.yaml",
-        model: str = "yolov8n.pt",
-        uri: str = USER_CONFIG_DIR / "explorer",
-    ) -> None:
-        """Initializes the Explorer class with dataset path, model, and URI for database connection."""
-        # Note duckdb==0.10.0 bug https://github.com/ultralytics/ultralytics/pull/8181
-        checks.check_requirements(["lancedb>=0.4.3", "duckdb<=0.9.2"])
-        import lancedb
-
-        self.connection = lancedb.connect(uri)
-        self.table_name = f"{Path(data).name.lower()}_{model.lower()}"
-        self.sim_idx_base_name = (
-            f"{self.table_name}_sim_idx".lower()
-        )  # Use this name and append thres and top_k to reuse the table
-        self.model = YOLO(model)
-        self.data = data  # None
-        self.choice_set = None
-
-        self.table = None
-        self.progress = 0
-
-    def create_embeddings_table(self, force: bool = False, split: str = "train") -> None:
-        """
-        Create LanceDB table containing the embeddings of the images in the dataset. The table will be reused if it
-        already exists. Pass force=True to overwrite the existing table.
-
-        Args:
-            force (bool): Whether to overwrite the existing table or not. Defaults to False.
-            split (str): Split of the dataset to use. Defaults to 'train'.
-
-        Example:
-            ```python
-            exp = Explorer()
-            exp.create_embeddings_table()
-            ```
-        """
-        if self.table is not None and not force:
-            LOGGER.info("Table already exists. Reusing it. Pass force=True to overwrite it.")
-            return
-        if self.table_name in self.connection.table_names() and not force:
-            LOGGER.info(f"Table {self.table_name} already exists. Reusing it. Pass force=True to overwrite it.")
-            self.table = self.connection.open_table(self.table_name)
-            self.progress = 1
-            return
-        if self.data is None:
-            raise ValueError("Data must be provided to create embeddings table")
-
-        data_info = check_det_dataset(self.data)
-        if split not in data_info:
-            raise ValueError(
-                f"Split {split} is not found in the dataset. Available keys in the dataset are {list(data_info.keys())}"
-            )
-
-        choice_set = data_info[split]
-        choice_set = choice_set if isinstance(choice_set, list) else [choice_set]
-        self.choice_set = choice_set
-        dataset = ExplorerDataset(img_path=choice_set, data=data_info, augment=False, cache=False, task=self.model.task)
-
-        # Create the table schema
-        batch = dataset[0]
-        vector_size = self.model.embed(batch["im_file"], verbose=False)[0].shape[0]
-        table = self.connection.create_table(self.table_name, schema=get_table_schema(vector_size), mode="overwrite")
-        table.add(
-            self._yield_batches(
-                dataset,
-                data_info,
-                self.model,
-                exclude_keys=["img", "ratio_pad", "resized_shape", "ori_shape", "batch_idx"],
-            )
-        )
-
-        self.table = table
-
-    def _yield_batches(self, dataset: ExplorerDataset, data_info: dict, model: YOLO, exclude_keys: List[str]):
-        """Generates batches of data for embedding, excluding specified keys."""
-        for i in tqdm(range(len(dataset))):
-            self.progress = float(i + 1) / len(dataset)
-            batch = dataset[i]
-            for k in exclude_keys:
-                batch.pop(k, None)
-            batch = sanitize_batch(batch, data_info)
-            batch["vector"] = model.embed(batch["im_file"], verbose=False)[0].detach().tolist()
-            yield [batch]
-
-    def query(
-        self, imgs: Union[str, np.ndarray, List[str], List[np.ndarray]] = None, limit: int = 25
-    ) -> Any:  # pyarrow.Table
-        """
-        Query the table for similar images. Accepts a single image or a list of images.
-
-        Args:
-            imgs (str or list): Path to the image or a list of paths to the images.
-            limit (int): Number of results to return.
-
-        Returns:
-            (pyarrow.Table): An arrow table containing the results. Supports converting to:
-                - pandas dataframe: `result.to_pandas()`
-                - dict of lists: `result.to_pydict()`
-
-        Example:
-            ```python
-            exp = Explorer()
-            exp.create_embeddings_table()
-            similar = exp.query(img="https://ultralytics.com/images/zidane.jpg")
-            ```
-        """
-        if self.table is None:
-            raise ValueError("Table is not created. Please create the table first.")
-        if isinstance(imgs, str):
-            imgs = [imgs]
-        assert isinstance(imgs, list), f"img must be a string or a list of strings. Got {type(imgs)}"
-        embeds = self.model.embed(imgs)
-        # Get avg if multiple images are passed (len > 1)
-        embeds = torch.mean(torch.stack(embeds), 0).cpu().numpy() if len(embeds) > 1 else embeds[0].cpu().numpy()
-        return self.table.search(embeds).limit(limit).to_arrow()
-
-    def sql_query(
-        self, query: str, return_type: str = "pandas"
-    ) -> Union[Any, None]:  # pandas.DataFrame or pyarrow.Table
-        """
-        Run a SQL-Like query on the table. Utilizes LanceDB predicate pushdown.
-
-        Args:
-            query (str): SQL query to run.
-            return_type (str): Type of the result to return. Can be either 'pandas' or 'arrow'. Defaults to 'pandas'.
-
-        Returns:
-            (pyarrow.Table): An arrow table containing the results.
-
-        Example:
-            ```python
-            exp = Explorer()
-            exp.create_embeddings_table()
-            query = "SELECT * FROM 'table' WHERE labels LIKE '%person%'"
-            result = exp.sql_query(query)
-            ```
-        """
-        assert return_type in {
-            "pandas",
-            "arrow",
-        }, f"Return type should be either `pandas` or `arrow`, but got {return_type}"
-        import duckdb
-
-        if self.table is None:
-            raise ValueError("Table is not created. Please create the table first.")
-
-        # Note: using filter pushdown would be a better long term solution. Temporarily using duckdb for this.
-        table = self.table.to_arrow()  # noqa NOTE: Don't comment this. This line is used by DuckDB
-        if not query.startswith("SELECT") and not query.startswith("WHERE"):
-            raise ValueError(
-                f"Query must start with SELECT or WHERE. You can either pass the entire query or just the WHERE "
-                f"clause. found {query}"
-            )
-        if query.startswith("WHERE"):
-            query = f"SELECT * FROM 'table' {query}"
-        LOGGER.info(f"Running query: {query}")
-
-        rs = duckdb.sql(query)
-        if return_type == "arrow":
-            return rs.arrow()
-        elif return_type == "pandas":
-            return rs.df()
-
-    def plot_sql_query(self, query: str, labels: bool = True) -> Image.Image:
-        """
-        Plot the results of a SQL-Like query on the table.
-
-        Args:
-            query (str): SQL query to run.
-            labels (bool): Whether to plot the labels or not.
-
-        Returns:
-            (PIL.Image): Image containing the plot.
-
-        Example:
-            ```python
-            exp = Explorer()
-            exp.create_embeddings_table()
-            query = "SELECT * FROM 'table' WHERE labels LIKE '%person%'"
-            result = exp.plot_sql_query(query)
-            ```
-        """
-        result = self.sql_query(query, return_type="arrow")
-        if len(result) == 0:
-            LOGGER.info("No results found.")
-            return None
-        img = plot_query_result(result, plot_labels=labels)
-        return Image.fromarray(img)
-
-    def get_similar(
-        self,
-        img: Union[str, np.ndarray, List[str], List[np.ndarray]] = None,
-        idx: Union[int, List[int]] = None,
-        limit: int = 25,
-        return_type: str = "pandas",
-    ) -> Any:  # pandas.DataFrame or pyarrow.Table
-        """
-        Query the table for similar images. Accepts a single image or a list of images.
-
-        Args:
-            img (str or list): Path to the image or a list of paths to the images.
-            idx (int or list): Index of the image in the table or a list of indexes.
-            limit (int): Number of results to return. Defaults to 25.
-            return_type (str): Type of the result to return. Can be either 'pandas' or 'arrow'. Defaults to 'pandas'.
-
-        Returns:
-            (pandas.DataFrame): A dataframe containing the results.
-
-        Example:
-            ```python
-            exp = Explorer()
-            exp.create_embeddings_table()
-            similar = exp.get_similar(img="https://ultralytics.com/images/zidane.jpg")
-            ```
-        """
-        assert return_type in {"pandas", "arrow"}, f"Return type should be `pandas` or `arrow`, but got {return_type}"
-        img = self._check_imgs_or_idxs(img, idx)
-        similar = self.query(img, limit=limit)
-
-        if return_type == "arrow":
-            return similar
-        elif return_type == "pandas":
-            return similar.to_pandas()
-
-    def plot_similar(
-        self,
-        img: Union[str, np.ndarray, List[str], List[np.ndarray]] = None,
-        idx: Union[int, List[int]] = None,
-        limit: int = 25,
-        labels: bool = True,
-    ) -> Image.Image:
-        """
-        Plot the similar images. Accepts images or indexes.
-
-        Args:
-            img (str or list): Path to the image or a list of paths to the images.
-            idx (int or list): Index of the image in the table or a list of indexes.
-            labels (bool): Whether to plot the labels or not.
-            limit (int): Number of results to return. Defaults to 25.
-
-        Returns:
-            (PIL.Image): Image containing the plot.
-
-        Example:
-            ```python
-            exp = Explorer()
-            exp.create_embeddings_table()
-            similar = exp.plot_similar(img="https://ultralytics.com/images/zidane.jpg")
-            ```
-        """
-        similar = self.get_similar(img, idx, limit, return_type="arrow")
-        if len(similar) == 0:
-            LOGGER.info("No results found.")
-            return None
-        img = plot_query_result(similar, plot_labels=labels)
-        return Image.fromarray(img)
-
-    def similarity_index(self, max_dist: float = 0.2, top_k: float = None, force: bool = False) -> Any:  # pd.DataFrame
-        """
-        Calculate the similarity index of all the images in the table. Here, the index will contain the data points that
-        are max_dist or closer to the image in the embedding space at a given index.
-
-        Args:
-            max_dist (float): maximum L2 distance between the embeddings to consider. Defaults to 0.2.
-            top_k (float): Percentage of the closest data points to consider when counting. Used to apply limit.
-                           vector search. Defaults: None.
-            force (bool): Whether to overwrite the existing similarity index or not. Defaults to True.
-
-        Returns:
-            (pandas.DataFrame): A dataframe containing the similarity index. Each row corresponds to an image,
-                and columns include indices of similar images and their respective distances.
-
-        Example:
-            ```python
-            exp = Explorer()
-            exp.create_embeddings_table()
-            sim_idx = exp.similarity_index()
-            ```
-        """
-        if self.table is None:
-            raise ValueError("Table is not created. Please create the table first.")
-        sim_idx_table_name = f"{self.sim_idx_base_name}_thres_{max_dist}_top_{top_k}".lower()
-        if sim_idx_table_name in self.connection.table_names() and not force:
-            LOGGER.info("Similarity matrix already exists. Reusing it. Pass force=True to overwrite it.")
-            return self.connection.open_table(sim_idx_table_name).to_pandas()
-
-        if top_k and not (1.0 >= top_k >= 0.0):
-            raise ValueError(f"top_k must be between 0.0 and 1.0. Got {top_k}")
-        if max_dist < 0.0:
-            raise ValueError(f"max_dist must be greater than 0. Got {max_dist}")
-
-        top_k = int(top_k * len(self.table)) if top_k else len(self.table)
-        top_k = max(top_k, 1)
-        features = self.table.to_lance().to_table(columns=["vector", "im_file"]).to_pydict()
-        im_files = features["im_file"]
-        embeddings = features["vector"]
-
-        sim_table = self.connection.create_table(sim_idx_table_name, schema=get_sim_index_schema(), mode="overwrite")
-
-        def _yield_sim_idx():
-            """Generates a dataframe with similarity indices and distances for images."""
-            for i in tqdm(range(len(embeddings))):
-                sim_idx = self.table.search(embeddings[i]).limit(top_k).to_pandas().query(f"_distance <= {max_dist}")
-                yield [
-                    {
-                        "idx": i,
-                        "im_file": im_files[i],
-                        "count": len(sim_idx),
-                        "sim_im_files": sim_idx["im_file"].tolist(),
-                    }
-                ]
-
-        sim_table.add(_yield_sim_idx())
-        self.sim_index = sim_table
-        return sim_table.to_pandas()
-
-    def plot_similarity_index(self, max_dist: float = 0.2, top_k: float = None, force: bool = False) -> Image:
-        """
-        Plot the similarity index of all the images in the table. Here, the index will contain the data points that are
-        max_dist or closer to the image in the embedding space at a given index.
-
-        Args:
-            max_dist (float): maximum L2 distance between the embeddings to consider. Defaults to 0.2.
-            top_k (float): Percentage of closest data points to consider when counting. Used to apply limit when
-                running vector search. Defaults to 0.01.
-            force (bool): Whether to overwrite the existing similarity index or not. Defaults to True.
-
-        Returns:
-            (PIL.Image): Image containing the plot.
-
-        Example:
-            ```python
-            exp = Explorer()
-            exp.create_embeddings_table()
-
-            similarity_idx_plot = exp.plot_similarity_index()
-            similarity_idx_plot.show()  # view image preview
-            similarity_idx_plot.save("path/to/save/similarity_index_plot.png")  # save contents to file
-            ```
-        """
-        sim_idx = self.similarity_index(max_dist=max_dist, top_k=top_k, force=force)
-        sim_count = sim_idx["count"].tolist()
-        sim_count = np.array(sim_count)
-
-        indices = np.arange(len(sim_count))
-
-        # Create the bar plot
-        plt.bar(indices, sim_count)
-
-        # Customize the plot (optional)
-        plt.xlabel("data idx")
-        plt.ylabel("Count")
-        plt.title("Similarity Count")
-        buffer = BytesIO()
-        plt.savefig(buffer, format="png")
-        buffer.seek(0)
-
-        # Use Pillow to open the image from the buffer
-        return Image.fromarray(np.array(Image.open(buffer)))
-
-    def _check_imgs_or_idxs(
-        self, img: Union[str, np.ndarray, List[str], List[np.ndarray], None], idx: Union[None, int, List[int]]
-    ) -> List[np.ndarray]:
-        """Determines whether to fetch images or indexes based on provided arguments and returns image paths."""
-        if img is None and idx is None:
-            raise ValueError("Either img or idx must be provided.")
-        if img is not None and idx is not None:
-            raise ValueError("Only one of img or idx must be provided.")
-        if idx is not None:
-            idx = idx if isinstance(idx, list) else [idx]
-            img = self.table.to_lance().take(idx, columns=["im_file"]).to_pydict()["im_file"]
-
-        return img if isinstance(img, list) else [img]
-
-    def ask_ai(self, query):
-        """
-        Ask AI a question.
-
-        Args:
-            query (str): Question to ask.
-
-        Returns:
-            (pandas.DataFrame): A dataframe containing filtered results to the SQL query.
-
-        Example:
-            ```python
-            exp = Explorer()
-            exp.create_embeddings_table()
-            answer = exp.ask_ai("Show images with 1 person and 2 dogs")
-            ```
-        """
-        result = prompt_sql_query(query)
-        try:
-            return self.sql_query(result)
-        except Exception as e:
-            LOGGER.error("AI generated query is not valid. Please try again with a different prompt")
-            LOGGER.error(e)
-            return None

ultralytics/data/explorer/gui/__init__.py

@@ -1 +0,0 @@
-# Ultralytics YOLO 🚀, AGPL-3.0 license