a yf@sddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlmZddl mZddlmZddlmZddlZddlmZddlZddlZddlZddlmZ ddl!m"Z"e#e$dd Z%e#e$d d Z&e j'pd d gZ(ee)*Z+e+j,d Z-e-d Z.e-dZ/e0de1d e2d Z3e4e$dd5dkZ6e4e$dd5dkZ7e7rdndZ8dZ9dddD\Z:Z;Ze?Z@ej"ZAejBCdZDejEFdddkZGdZHejIdd d!d"ejIdd#d$jJid%eKde4e3ejEd&<d'ejEd(<d)ejEd*<d+ejEd,<d-ejEd.<Gd/d0d0e ZLGd1d2d2ZMGd3d4d4eZNdd6d7ZOdd9d:ZPePe9e7d;ZQdZVGd?d@d@ZWddBdCZXddDdEZYee4eeZfddFdGdHZ[eYe/Z\e\]D],\Z^Z_e`e_e4re_5dIkrde\e^<qe\aZbeNfie\Zce4dJdKdLZdeedJdMdNZfdOdPZgdQdRZhdSdTZieedJdUdVZjeedJdWdXZkeedJdYdZZleedJd[d\Zmenfe4eed]d^d_Zoee4efeed`dadbZpdcddZqeedJdedfZrdgdhZsdidjZtdkdlZudmdnZvdodpZwdqdrZxddtduZyedZzemZ{egZ|ejZ}elZ~eiZehZeoZekZesZetZee$dvpeyZedwZdxdyZdzd{ZGd|d}d}ejZGd~ddejZddZddZGdddeZZGdddeZddZddZddZde4dJddZedZeZeedZeedZeedZeedZe|rndn$erxdnerdne}rdneZeqperZeddlmZmZmZmZmZee_ee_e<reeee_e_e_dS)N)Path)Lock)SimpleNamespace)Union)tqdm) __version__RANK LOCAL_RANKZassetszcfg/default.yamlZYOLO_AUTOINSTALLTtrueZ YOLO_VERBOSEz{l_bar}{bar:10}{r_bar} ultralyticsccs|]}t|kVqdSN)platformsystem.0xrV/var/www/html/django/DPS/env/lib/python3.9/site-packages/ultralytics/utils/__init__.py .r)DarwinLinuxWindows>arm64aarch64Z torchvisionZ TERM_PROGRAMFZvscodea Examples for running Ultralytics: 1. Install the ultralytics package: pip install ultralytics 2. Use the Python SDK: from ultralytics import YOLO # Load a model model = YOLO("yolov8n.yaml") # build a new model from scratch model = YOLO("yolov8n.pt") # load a pretrained model (recommended for training) # Use the model results = model.train(data="coco8.yaml", epochs=3) # train the model results = model.val() # evaluate model performance on the validation set results = model("https://ultralytics.com/images/bus.jpg") # predict on an image success = model.export(format="onnx") # export the model to ONNX format 3. Use the command line interface (CLI): Ultralytics 'yolo' CLI commands use the following syntax: yolo TASK MODE ARGS Where TASK (optional) is one of [detect, segment, classify, pose, obb] MODE (required) is one of [train, val, predict, export, benchmark] ARGS (optional) are any number of custom "arg=value" pairs like "imgsz=320" that override defaults. See all ARGS at https://docs.ultralytics.com/usage/cfg or with "yolo cfg" - Train a detection model for 10 epochs with an initial learning_rate of 0.01 yolo detect train data=coco8.yaml model=yolov8n.pt epochs=10 lr0=0.01 - Predict a YouTube video using a pretrained segmentation model at image size 320: yolo segment predict model=yolov8n-seg.pt source='https://youtu.be/LNwODJXcvt4' imgsz=320 - Val a pretrained detection model at batch-size 1 and image size 640: yolo detect val model=yolov8n.pt data=coco8.yaml batch=1 imgsz=640 - Export a YOLOv8n classification model to ONNX format at image size 224 by 128 (no TASK required) yolo export model=yolov8n-cls.pt format=onnx imgsz=224,128 - Run special commands: yolo help yolo checks yolo version yolo settings yolo copy-cfg yolo cfg Docs: https://docs.ultralytics.com Community: https://community.ultralytics.com GitHub: https://github.com/ultralytics/ultralytics i@default) linewidth precisionZprofileZ float_kindz{:11.5g})r! formatterZNUMEXPR_MAX_THREADSz:4096:8ZCUBLAS_WORKSPACE_CONFIG3ZTF_CPP_MIN_LOG_LEVELERRORZTORCH_CPP_LOG_LEVEL5ZKINETO_LOG_LEVELcs eZdZdZfddZZS)TQDMa A custom TQDM progress bar class that extends the original tqdm functionality. This class modifies the behavior of the original tqdm progress bar based on global settings and provides additional customization options. Attributes: disable (bool): Whether to disable the progress bar. Determined by the global VERBOSE setting and any passed 'disable' argument. bar_format (str): The format string for the progress bar. Uses the global TQDM_BAR_FORMAT if not explicitly set. Methods: __init__: Initializes the TQDM object with custom settings. Examples: >>> from ultralytics.utils import TQDM >>> for i in TQDM(range(100)): ... # Your processing code here ... pass cs8t p|dd|d<|dttj|i|dS)a Initializes a custom TQDM progress bar. This class extends the original tqdm class to provide customized behavior for Ultralytics projects. Args: *args (Any): Variable length argument list to be passed to the original tqdm constructor. **kwargs (Any): Arbitrary keyword arguments to be passed to the original tqdm constructor. Notes: - The progress bar is disabled if VERBOSE is False or if 'disable' is explicitly set to True in kwargs. - The default bar format is set to TQDM_BAR_FORMAT unless overridden in kwargs. Examples: >>> from ultralytics.utils import TQDM >>> for i in TQDM(range(100)): ... # Your code here ... pass disableFZ bar_formatN)VERBOSEget setdefaultTQDM_BAR_FORMATsuper__init__selfargskwargs __class__rrr.s z TQDM.__init__)__name__ __module__ __qualname____doc__r. __classcell__rrr3rr'xsr'c@s(eZdZdZddZddZddZdS) SimpleClassa A simple base class for creating objects with string representations of their attributes. This class provides a foundation for creating objects that can be easily printed or represented as strings, showing all their non-callable attributes. It's useful for debugging and introspection of object states. Methods: __str__: Returns a human-readable string representation of the object. __repr__: Returns a machine-readable string representation of the object. __getattr__: Provides a custom attribute access error message with helpful information. Examples: >>> class MyClass(SimpleClass): ... def __init__(self): ... self.x = 10 ... self.y = "hello" >>> obj = MyClass() >>> print(obj) __main__.MyClass object with attributes: x: 10 y: 'hello' Notes: - This class is designed to be subclassed. It provides a convenient way to inspect object attributes. - The string representation includes the module and class name of the object. - Callable attributes and attributes starting with an underscore are excluded from the string representation. cCsg}t|D]d}t||}t|s |ds t|trT|d|jd|jjd}n|dt |}| |q |jd|jjdd |S)Return a machine-readable string representation of the object.)rLr0rrr__repr__szSimpleClass.__repr__cCs(|jj}td|d|d|jdS)?Custom attribute access error message with helpful information.'' object has no attribute 'z'. See valid attributes below. N)r4r5AttributeErrorr8r0rHnamerrr __getattr__szSimpleClass.__getattr__N)r5r6r7r8rLrNrUrrrrr:sr:c@s2eZdZdZddZddZddZd d d ZdS) IterableSimpleNamespacea An iterable SimpleNamespace class that provides enhanced functionality for attribute access and iteration. This class extends the SimpleNamespace class with additional methods for iteration, string representation, and attribute access. It is designed to be used as a convenient container for storing and accessing configuration parameters. Methods: __iter__: Returns an iterator of key-value pairs from the namespace's attributes. __str__: Returns a human-readable string representation of the object. __getattr__: Provides a custom attribute access error message with helpful information. get: Retrieves the value of a specified key, or a default value if the key doesn't exist. Examples: >>> cfg = IterableSimpleNamespace(a=1, b=2, c=3) >>> for k, v in cfg: ... print(f"{k}: {v}") a: 1 b: 2 c: 3 >>> print(cfg) a=1 b=2 c=3 >>> cfg.get("b") 2 >>> cfg.get("d", "default") 'default' Notes: This class is particularly useful for storing configuration parameters in a more accessible and iterable format compared to a standard dictionary. cCstt|S)zFReturn an iterator of key-value pairs from the namespace's attributes.)itervarsitemsrMrrr__iter__sz IterableSimpleNamespace.__iter__cCsdddt|DS)r;r?css |]\}}|d|VqdS)=NrrkrJrrrrrz2IterableSimpleNamespace.__str__..)rGrXrYrMrrrrLszIterableSimpleNamespace.__str__cCs(|jj}td|d|dtddS)rOz 'rQz'. This may be caused by a modified or out of date ultralytics 'default.yaml' file. Please update your code with 'pip install -U ultralytics' and if necessary replace z with the latest version from https://github.com/ultralytics/ultralytics/blob/main/ultralytics/cfg/default.yaml N)r4r5rRDEFAULT_CFG_PATHrSrrrrU sz#IterableSimpleNamespace.__getattr__NcCs t|||S)zXReturn the value of the specified key if it exists; otherwise, return the default value.)rA)r0keyr rrrr*szIterableSimpleNamespace.get)N)r5r6r7r8rZrLrUr*rrrrrVs " rVAggcs"durddifdd}|S)ai Decorator to temporarily set rc parameters and the backend for a plotting function. Example: decorator: @plt_settings({"font.size": 12}) context manager: with plt_settings({"font.size": 12}): Args: rcparams (dict): Dictionary of rc parameters to set. backend (str, optional): Name of the backend to use. Defaults to 'Agg'. Returns: (Callable): Decorated function with temporarily set rc parameters and backend. This decorator can be applied to any function that needs to have specific matplotlib rc parameters and backend for its execution. Nz font.size csfdd}|S)zEDecorator to apply temporary rc parameters and backend to a function.c st}|k}|r0tdtzTt|i|}Wdn1s`0YW|rtdt|n|rtdt|0|S)zWSets rc parameters and backend, calls the original function, and restores the settings.allN)plt get_backendlowercloseZswitch_backendZ rc_context)r1r2Zoriginal_backendswitchresult)backendfuncrcparamsrrwrapper0s   .    z0plt_settings..decorator..wrapperrrjrlrirkrjr decorator-szplt_settings..decoratorr)rkrirprrnr plt_settingssrq LOGGING_NAMEc Cs&|rtdvrtjntj}td}trttjdrtjj dkrGdddtj}zRttjdrntjj ddn2ttjd rd d l }|j tjj ddt_n|d}Wn:ty}z"td ||d}WYd }~n d }~00ttj}||||t|}||||d |_|S)ar Sets up logging with UTF-8 encoding and configurable verbosity. This function configures logging for the Ultralytics library, setting the appropriate logging level and formatter based on the verbosity flag and the current process rank. It handles special cases for Windows environments where UTF-8 encoding might not be the default. Args: name (str): Name of the logger. Defaults to "LOGGING_NAME". verbose (bool): Flag to set logging level to INFO if True, ERROR otherwise. Defaults to True. Examples: >>> set_logging(name="ultralytics", verbose=True) >>> logger = logging.getLogger("ultralytics") >>> logger.info("This is an info message") Notes: - On Windows, this function attempts to reconfigure stdout to use UTF-8 encoding if possible. - If reconfiguration is not possible, it falls back to a custom formatter that handles non-UTF-8 environments. - The function sets up a StreamHandler with the appropriate formatter and level. - The logger's propagate flag is set to False to prevent duplicate logging in parent loggers. rr z %(message)sencodingutf-8cseZdZfddZZS)z$set_logging..CustomFormattercstt|S)z?Sets up logging with UTF-8 encoding and configurable verbosity.)emojisr-format)r0recordr3rrrwesz+set_logging..CustomFormatter.format)r5r6r7rwr9rrr3rCustomFormatterdsry reconfigure)rtbufferrNz.decorated) functoolsr)r0rrrrrr__call__s zThreadingLocked.__call__Nr5r6r7r8r.rrrrrrsr data.yamlc Cs|dur i}t|}|js.|jjdddtttttt t t df}| D]\}}t ||sNt|||<qNt|dddd0}|r||tj||ddd Wdn1s0YdS) a Save YAML data to a file. Args: file (str, optional): File name. Default is 'data.yaml'. data (dict): Data to save in YAML format. header (str, optional): YAML header to add. Returns: (None): Data is saved to the specified file. NTparentsexist_okwrruerrorsrtF) sort_keys allow_unicode)rparentexistsmkdirintfloatstrboollisttupledicttyperYrDopenwriteyamlZ safe_dump)filedataheaderZ valid_typesr]rJrrrr yaml_saves    rcCst|jdvsJd|dt|dddP}|}|sLtdd|}t|pXi}|rjt ||d <|Wd S1s0Yd S) a Load YAML data from a file. Args: file (str, optional): File name. Default is 'data.yaml'. append_filename (bool): Add the YAML filename to the YAML dictionary. Default is False. Returns: (dict): YAML data and file name. >z.ymlz.yamlz!Attempting to load non-YAML file z with yaml_load()rrurzJ[^\x09\x0A\x0D\x20-\x7E\x85\xA0-\uD7FF\uE000-\uFFFD\U00010000-\U0010ffff]+r yaml_fileN) rsuffixrread isprintableresubrZ safe_loadr)rZappend_filenamerrKrrrr yaml_loads  r)rreturncCsRt|ttfrt|n|}tj|ddtdd}tdt dd|d|d S) z Pretty prints a YAML file or a YAML-formatted dictionary. Args: yaml_file: The file path of the YAML file or a YAML-formatted dictionary. Returns: (None) FTinf)rrwidthz Printing 'boldblackz' N) rDrrrrdumprLOGGERinfocolorstr)rZ yaml_dictrrrr yaml_prints rnone)rc CslttNtd&}|WdWdS1s@0YWdn1s^0YdS)z Reads the device model information from the system and caches it for quick access. Used by is_jetson() and is_raspberrypi(). Returns: (str): Model file contents if read successfully or empty string otherwise. z/proc/device-tree/modelNr  contextlibsuppressrrrrrrrread_device_models  Rrc CspttRtd*}d|vWdWdS1sD0YWdn1sb0YdS)zi Check if the OS is Ubuntu. Returns: (bool): True if OS is Ubuntu, False otherwise. /etc/os-releasez ID=ubuntuNF)rrFileNotFoundErrorrrrrrr is_ubuntus  VrcCsdtjvpdtjvS)z Check if the current script is running inside a Google Colab notebook. Returns: (bool): True if running inside a Colab notebook, False otherwise. ZCOLAB_RELEASE_TAGZCOLAB_BACKEND_VERSIONosenvironrrrris_colab!srcCs tjddkotjddkS)z Check if the current script is running inside a Kaggle kernel. Returns: (bool): True if running inside a Kaggle kernel, False otherwise. ZPWDz/kaggle/workingZKAGGLE_URL_BASEzhttps://www.kaggle.com)rrr*rrrr is_kaggle+srcCsDtt&ddlm}|duWdS1s60YdS)z Check if the current script is running inside a Jupyter Notebook. Verified on Colab, Jupyterlab, Kaggle, Paperspace. Returns: (bool): True if running inside a Jupyter Notebook, False otherwise. r get_ipythonNF)rrrZIPythonrrrrr is_jupyter5s  (rc CspttRtd*}d|vWdWdS1sD0YWdn1sb0YdS)z Determine if the script is running inside a Docker container. Returns: (bool): True if the script is running inside a Docker container, False otherwise. z/proc/self/cgroupdockerNFrrrrr is_dockerCs  VrcCsdtvS)z Determines if the Python environment is running on a Raspberry Pi by checking the device model information. Returns: (bool): True if running on a Raspberry Pi, False otherwise. z Raspberry PiPROC_DEVICE_MODELrrrris_raspberrypiPsrcCsdtvS)z Determines if the Python environment is running on a Jetson Nano or Jetson Orin device by checking the device model information. Returns: (bool): True if running on a Jetson Nano or Jetson Orin, False otherwise. ZNVIDIArrrrr is_jetsonZsrcCsttdttdddks(Jddl}dD]*}|j|dfdd  Wdd SWdn1st0Yd S) z Check internet connectivity by attempting to connect to a known online host. Returns: (bool): True if connection is successful, False otherwise. Z YOLO_OFFLINEr rrN)z1.1.1.1z8.8.8.8Pg@)addresstimeoutTF) rrrrrgetenvresocketcreate_connectionrf)rZdnsrrr is_onlinees 0r)filepathrcCs&ddl}|j|}|duo$|jduS)z Determines if the file at the given filepath is part of a pip package. Args: filepath (str): The filepath to check. Returns: (bool): True if the file is part of a pip package, False otherwise. rN)importlib.utilutil find_specorigin)r importlibspecrrris_pip_packagevs  r)dir_pathrcCstt|tjS)z Check if a directory is writeable. Args: dir_path (str | Path): The path to the directory. Returns: (bool): True if the directory is writeable, False otherwise. )raccessrW_OK)rrrris_dir_writeables rcCs&dtjvp$dtjvp$dttdjvS)z Determines whether pytest is currently running or not. Returns: (bool): True if pytest is running, False otherwise. ZPYTEST_CURRENT_TESTZpytestr)rrrmodulesrARGVstemrrrris_pytest_runningsrcCsdtjvodtjvodtjvS)z Determine if the current environment is a GitHub Actions runner. Returns: (bool): True if the current environment is a GitHub Actions runner, False otherwise. ZGITHUB_ACTIONSZGITHUB_WORKFLOWZ RUNNER_OSrrrrris_github_action_runningsrcCs(ttjD]}|dr |Sq dS)a Determines whether the current file is part of a git repository and if so, returns the repository root directory. If the current file is not part of a git repository, returns None. Returns: (Path | None): Git root directory if found or None if not found. z.gitN)r__file__ris_dir)drrr get_git_dirs rcCstduS)z Determines whether the current file is part of a git repository. If the current file is not part of a git repository, returns None. Returns: (bool): True if current file is part of a git repository. N)GIT_DIRrrrr is_git_dirsrcCsNtrJttj*tgd}|WdS1s@0YdS)z Retrieves the origin URL of a git repository. Returns: (str | None): The origin URL of the git repository or None if not git directory. )gitconfigz--getzremote.origin.urlN IS_GIT_DIRrr subprocessCalledProcessError check_outputrstriprrrrget_git_origin_urlsr cCsNtrJttj*tgd}|WdS1s@0YdS)z Returns the current git branch name. If not in a git repository, returns None. Returns: (str | None): The current git branch name or None if not a git directory. )rz rev-parsez --abbrev-refHEADNrr rrrget_git_branchsrcCst|}dd|jDS)a Returns a dictionary of default arguments for a function. Args: func (callable): The function to inspect. Returns: (dict): A dictionary where each key is a parameter name, and each value is the default value of that parameter. cSs&i|]\}}|jtjjur||jqSr)r inspect Parameteremptyr\rrr rz$get_default_args..)r signature parametersrY)rjrrrrget_default_argss rc Cstr|tttZtd2}td|dWdWdS1sT0YWdn1sr0YdS)z Retrieve the Ubuntu version if the OS is Ubuntu. Returns: (str): Ubuntu version or None if not an Ubuntu OS. rzVERSION_ID="(\d+\.\d+)"r N) rrrrrRrrsearchrrrrrget_ubuntu_versions r UltralyticscCstrtdd|}nBtr4tdd|}n(trJtd|}ntdtt|j st d|dtd rtd |n t |}|j d d d |S) z Return the appropriate config directory based on the environment operating system. Args: sub_dir (str): The name of the subdirectory to create. Returns: (Path): The path to the user config directory. ZAppDataZRoamingLibraryzApplication Supportz.configzUnsupported operating system: u&WARNING ⚠️ user config directory 'z' is not writeable, defaulting to '/tmp' or CWD.Alternatively you can define a YOLO_CONFIG_DIR environment variable for this path.z/tmpTr)rrhomeMACOSLINUX ValueErrorrrrrrwarningcwdr)Zsub_dirpathrrrget_user_config_dirs   "r!ZYOLO_CONFIG_DIRz settings.jsoncsvt|dkr|n dd|df^}}ddddd d d d d ddddddddddddfdd|D|dS)am Colors a string based on the provided color and style arguments. Utilizes ANSI escape codes. See https://en.wikipedia.org/wiki/ANSI_escape_code for more details. This function can be called in two ways: - colorstr('color', 'style', 'your string') - colorstr('your string') In the second form, 'blue' and 'bold' will be applied by default. Args: *input (str | Path): A sequence of strings where the first n-1 strings are color and style arguments, and the last string is the one to be colored. Supported Colors and Styles: Basic Colors: 'black', 'red', 'green', 'yellow', 'blue', 'magenta', 'cyan', 'white' Bright Colors: 'bright_black', 'bright_red', 'bright_green', 'bright_yellow', 'bright_blue', 'bright_magenta', 'bright_cyan', 'bright_white' Misc: 'end', 'bold', 'underline' Returns: (str): The input string wrapped with ANSI escape codes for the specified color and style. Examples: >>> colorstr("blue", "bold", "hello world") >>> "\033[34m\033[1mhello world\033[0m" r bluerrzzzzzzzzzzzzzzzzzzz)rredgreenyellowr"magentacyanwhite bright_black bright_red bright_green bright_yellow bright_bluebright_magenta bright_cyan bright_whiteendr underliner c3s|]}|VqdSrrrcolorsrrrZrzcolorstr..r1)lenrG)inputr1rrr3rr(s,$rcCstd}|d|S)a\ Removes ANSI escape codes from a string, effectively un-coloring it. Args: input_string (str): The string to remove color and style from. Returns: (str): A new string with all ANSI escape codes removed. Examples: >>> remove_colorstr(colorstr("blue", "bold", "hello world")) >>> "hello world" z\x1B\[[0-9;]*[A-Za-z]r )rcompiler)Z input_stringZ ansi_escaperrrremove_colorstr]s r8c@s*eZdZdZd ddZddZdd Zd S) TryExcepta Ultralytics TryExcept class. Use as @TryExcept() decorator or 'with TryExcept():' context manager. Examples: As a decorator: >>> @TryExcept(msg="Error occurred in func", verbose=True) >>> def func(): >>> # Function logic here >>> pass As a context manager: >>> with TryExcept(msg="Error occurred in block", verbose=True): >>> # Code block here >>> pass r TcCs||_||_dS)zHInitialize TryExcept class with optional message and verbosity settings.N)msgr)r0r:rrrrr.szTryExcept.__init__cCsdS)z?Executes when entering TryExcept context, initializes instance.NrrMrrr __enter__szTryExcept.__enter__cCs2|jr.|r.tt|j|jrdnd|dS)zPDefines behavior when exiting a 'with' block, prints error message if necessary.r=r T)rrrvr:)r0exc_typevalue tracebackrrr__exit__s $zTryExcept.__exit__N)r T)r5r6r7r8r.r;r?rrrrr9os r9c@s"eZdZdZd ddZddZdS) Retrya Retry class for function execution with exponential backoff. Can be used as a decorator to retry a function on exceptions, up to a specified number of times with an exponentially increasing delay between retries. Examples: Example usage as a decorator: >>> @Retry(times=3, delay=2) >>> def test_func(): >>> # Replace with function logic that may raise exceptions >>> return True cCs||_||_d|_dS)zBInitialize Retry class with specified number of retries and delay.rN)timesdelay _attempts)r0rCrDrrrr.szRetry.__init__csfdd}|S)z.wrapped_funcr)r0rjrJrrIrrs zRetry.__call__N)rArBrrrrrr@s r@csfdd}|S)z Multi-threads a target function by default and returns the thread or function result. Use as @threaded decorator. The function runs in a separate thread unless 'threaded=False' is passed. cs<|ddr*tj||dd}||S|i|SdS)zcMulti-threads a given function based on 'threaded' kwarg and returns the thread or function result.threadedT)targetr1r2daemonN)poprThreadstart)r1r2threadrorrrls  zthreaded..wrapperrrmrrorrKs rKc Cstdrtdvrttdjdkrtstrtrtsz ddl }Wnt yRYdS0dd}|j dd d d t d |t tgd |d tdidS)a Initialize the Sentry SDK for error tracking and reporting. Only used if sentry_sdk package is installed and sync=True in settings. Run 'yolo settings' to see and update settings. Conditions required to send errors (ALL conditions must be met or no errors will be reported): - sentry_sdk package is installed - sync=True in YOLO settings - pytest is not running - running in a pip package installation - running in a non-git directory - running with rank -1 or 0 - online environment - CLI used to run package (checked with 'yolo' as the name of the main CLI command) The function also configures Sentry SDK to ignore KeyboardInterrupt and FileNotFoundError exceptions and to exclude events with 'out of memory' in their exception message. Additionally, the function sets custom tags and user information for Sentry events. syncrsrZyoloNcSsfd|vr2|d\}}}|tthvs.dt|vr2dStdttdjtrLdn trTdndtd|d <|S) a Modify the event before sending it to Sentry based on specific exception types and messages. Args: event (dict): The event dictionary containing information about the error. hint (dict): A dictionary containing additional information about the error. Returns: dict: The modified event or None if the event should not be sent to Sentry. exc_infoz out of memoryNrrpipother)Zsys_argvZ sys_argv_nameinstallrtags) KeyboardInterruptrrrrrTrIS_PIP_PACKAGE ENVIRONMENT)eventhintr< exc_valuer<rrr before_sends   zset_sentry..before_sendz_https://888e5a0778212e1d0314c37d4b9aae5d@o4504521589325824.ingest.us.sentry.io/4504521592406016Fg? production)ZdsndebugZauto_enabling_integrationsZtraces_sample_raterelease environmentr^ ignore_errorsiduuid)SETTINGSrrrrT TESTS_RUNNINGONLINErYrr ImportErrorinitrrXrZset_user)rr^rrr set_sentrys<    rkcseZdZdZdeeefdfdd ZddZdd Z e d d Z fd d Z fddZ ddZfddZfddZZS)JSONDictak A dictionary-like class that provides JSON persistence for its contents. This class extends the built-in dictionary to automatically save its contents to a JSON file whenever they are modified. It ensures thread-safe operations using a lock. Attributes: file_path (Path): The path to the JSON file used for persistence. lock (threading.Lock): A lock object to ensure thread-safe operations. Methods: _load: Loads the data from the JSON file into the dictionary. _save: Saves the current state of the dictionary to the JSON file. __setitem__: Stores a key-value pair and persists it to disk. __delitem__: Removes an item and updates the persistent storage. update: Updates the dictionary and persists changes. clear: Clears all entries and updates the persistent storage. Examples: >>> json_dict = JSONDict("data.json") >>> json_dict["key"] = "value" >>> print(json_dict["key"]) value >>> del json_dict["key"] >>> json_dict.update({"new_key": "new_value"}) >>> json_dict.clear() data.json) file_pathcs(tt||_t|_|dS)zMInitialize a JSONDict object with a specified file path for JSON persistence.N)r-r.rrnrr_load)r0rnr3rrr.0s  zJSONDict.__init__c CszH|jrFt|j }|t|Wdn1s<0YWn^tjyntd|jdYn:ty}z"td|jd|WYd}~n d}~00dS)z5Load the data from the JSON file into the dictionary.NzError decoding JSON from z$. Starting with an empty dictionary.zError reading from r=) rnrrupdatejsonloadJSONDecodeErrorrrr0rrrrrro7s  2zJSONDict._loadc CszZ|jjjdddt|jd(}tjt||d|jdWdn1sN0YWn:ty}z"t d|jd|WYd}~n d}~00dS) z:Save the current state of the dictionary to the JSON file.TrrrB)indentr NzError writing to r=) rnrrrrqrr _json_defaultrrrtrrr_saveBs :zJSONDict._savecCs,t|trt|Stdt|jddS)z*Handle JSON serialization of Path objects.zObject of type z is not JSON serializableN)rDrr TypeErrorrr5)objrrrrvKs zJSONDict._json_defaultcs@|j&t|||Wdn1s20YdS)z+Store a key-value pair and persist to disk.N)rr- __setitem__rw)r0r_r=r3rrrzRszJSONDict.__setitem__cs>|j$t||Wdn1s00YdS)z1Remove an item and update the persistent storage.N)rr- __delitem__rw)r0r_r3rrr{Xs zJSONDict.__delitem__c Cs&d|jdtjt|dd|jdS)zEReturn a pretty-printed JSON string representation of the dictionary.z JSONDict("z"): rBF)ru ensure_asciir )rnrqdumpsrrvrMrrrrL^szJSONDict.__str__csD|j*tj|i||Wdn1s60YdS)z*Update the dictionary and persist changes.N)rr-rprwr/r3rrrpbszJSONDict.updatecs<|j"t|Wdn1s.0YdS)z4Clear all entries and update the persistent storage.N)rr-clearrwrMr3rrr~hs zJSONDict.clear)rm)r5r6r7r8rrrr.rorw staticmethodrvrzr{rLrpr~r9rrr3rrls      rlcsBeZdZdZedffdd ZddZfddZd d ZZ S) SettingsManagera SettingsManager class for managing and persisting Ultralytics settings. This class extends JSONDict to provide JSON persistence for settings, ensuring thread-safe operations and default values. It validates settings on initialization and provides methods to update or reset settings. Attributes: file (Path): The path to the JSON file used for persistence. version (str): The version of the settings schema. defaults (Dict): A dictionary containing default settings. help_msg (str): A help message for users on how to view and update settings. Methods: _validate_settings: Validates the current settings and resets if necessary. update: Updates settings, validating keys and types. reset: Resets the settings to default and saves them. Examples: Initialize and update settings: >>> settings = SettingsManager() >>> settings.update(runs_dir="/new/runs/dir") >>> print(settings["runs_dir"]) /new/runs/dir z0.0.6cs&ddl}ddlm}tpt}tr2t|jr2|jn|}t||_||_ |t |dt |dt |d| t t dddddddddddddd |_d |jd |_|tTt|j|jr|std |d |j||Wdn1s0YdS)zNInitializes the SettingsManager with default settings and loads user settings.rN)torch_distributed_zero_firstZdatasetsweightsrunsTr )settings_version datasets_dir weights_dirruns_dirrerRZapi_keyZopenai_api_keyZclearmlcometZdvcZhubZmlflowZneptuneZraytuneZ tensorboardZwandb vscode_msgz7 View Ultralytics Settings with 'yolo settings' or at 'z' Update Settings with 'yolo settings key=value', i.e. 'yolo settings runs_dir=path/to/dir'. For help see https://docs.ultralytics.com/quickstart/#ultralytics-settings.z#Creating new Ultralytics Settings vu file ✅ )hashlibZultralytics.utils.torch_utilsrrrrrresolverversionrsha256regetnoder hexdigestdefaultshelp_msgrr-r.rrrreset_validate_settings)r0rrrrrootZ datasets_rootr3rrr.sB        zSettingsManager.__init__csttjk}tfddjD}ddjk}|rT|rT|sntdj  ddkrtddd dd j d S) z5Validate the current settings and reset if necessary.c3s&|]\}}t|t|VqdSr)rDr*rr\rMrrrrz5SettingsManager._validate_settings..rr uWARNING ⚠️ Ultralytics settings reset to default values. This may be due to a possible problem with your settings or a recent ultralytics package update. rru2WARNING ⚠️ Ultralytics setting 'datasets_dir: z$' must be different than 'runs_dir: z?'. Please change one to avoid possible issues during training. N) setkeysrrbrYr*rrrrr)r0Z correct_keysZ correct_typesZcorrect_versionrrMrrs$ z"SettingsManager._validate_settingsc s|D]f\}}||jvr0td|d|jt|j|}t||std|d|dt|d|jqtj|i|dS)z,Updates settings, validating keys and types.zNo Ultralytics setting 'z'. zUltralytics setting 'z' must be of type 'z', not 'N) rYrKeyErrorrrrDrxr-rp)r0r1r2r]rJtr3rrrps  (zSettingsManager.updatecCs|||jdS)z.Resets the settings to default and saves them.N)r~rprrMrrrrszSettingsManager.reset) r5r6r7r8 SETTINGS_FILEr.rrprr9rrr3rros / rcCstd|d|ddS)z_Issue a deprecation warning when a deprecated argument is used, suggesting an updated argument.uWARNING ⚠️ 'z;' is deprecated and will be removed in in the future. Use 'z ' instead.N)rr)argZnew_argrrrdeprecation_warnsrcCs*t|dd}tj|ddS)zTStrip auth from URL, i.e. https://url.com/file.txt?auth -> https://url.com/file.txt.z:/z://?r)ras_posixreplaceurllibparseunquotespliturlrrr clean_urlsrcCstt|jS)zHConvert URL to filename, i.e. https://url.com/file.txt?auth -> file.txt.)rrrTrrrrurl2filesr ultralytics.ultralytics-snippetscCsptrtjdntjdd}|d}t||doP||rL|dndv}d}|r^dStd d |S) zWDisplay a message to install Ultralytics-Snippets for VS Code if not already installed.rBr z.vscode/extensionsz .obsolete*rur z0https://docs.ultralytics.com/integrations/vscodezVS Code:u+ view Ultralytics VS Code Extension ⚡ at )rUSER_CONFIG_DIRranyglobr read_textr)extr Zobs_file installedrrrrrs .rz Ultralytics: zpersistent_cache.jsonrrrZColabZKaggleZJupyterDocker)imreadimshowimwrite torch_load torch_save)Nr`)rrT)r )rNr )rF)r)r)rimportlib.metadatarrrqlogging.configr|rrrrrrrGrrepathlibrrtypesrtypingrZcv2Zmatplotlib.pyplotZpyplotrcnumpynpZtorchrrZ tqdm_originalrrrrrr argvrrrFILErROOTZASSETSr^minmax cpu_countZ NUM_THREADSrreZ AUTOINSTALLr)r,rrrrrmachineZARM64python_versionPYTHON_VERSIONZ TORCH_VERSIONmetadatarZTORCHVISION_VERSIONrr*Z IS_VSCODEZHELP_MSGZset_printoptionsrwZ setNumThreadsr'r:rVrqrrrrrCRITICALrvrrrrrZDEFAULT_CFG_DICTrYr]rJrDrZDEFAULT_CFG_KEYSZ DEFAULT_CFGrrrrrrrrrrr5rrrrrrr rrrr!rrhZIS_COLABZ IS_DOCKERZ IS_JETSONZ IS_JUPYTERZ IS_KAGGLErYZIS_RASPBERRYPIrrrrrr8ContextDecoratorr9r@rKrkrlrrrrrPREFIXrfZPERSISTENT_CACHEZ DATASETS_DIRZ WEIGHTS_DIRZRUNS_DIRrrZrgZultralytics.utils.patchesrrrrrrrsaverrrrs           :     06< - ?  $                "5!(H\m