FPhbe xddlZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl mZddlmZddlZddlZddlZddlZddlmZddlmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-ej\dz dfd Z/d+d e0fd Z1d e2fd Z3d,d Z4 d-de5de5de5de2de2d e2f dZ6d.dZ7dZ8e!d/dZ9d0de5d e2fdZ:e"ej\dz dddfdZ;dZd3d Z?d4d!Z@d5d"ZAd6d#ZBd$ZCd%ZDefd&ZEd7d'eeFfd(ZGd eHfd)ZId e2fd*ZJy)8N)metadata)Path)Optional) font_manager)ASSETS AUTOINSTALLLINUXLOGGERONLINEROOTUSER_CONFIG_DIRSimpleNamespaceThreadingLocked TryExcept clean_urlcolorstr downloadsemojisis_colab is_docker is_jupyter is_kaggle is_onlineis_pip_packageurl2filezrequirements.txtc|r2tj|jDcgc] }d|vs| }}n't|j j }g}|D]}|j }|s|jdr(|jddj }tjd|}|sc|jt|d|dr|dj nd|Scc}w) a; Parse a requirements.txt file, ignoring lines that start with '#' and any text after '#'. Args: file_path (Path): Path to the requirements.txt file. package (str, optional): Python package to use instead of requirements.txt file, i.e. package='ultralytics'. Returns: (List[Dict[str, str]]): List of parsed requirements as dictionaries with `name` and `specifier` keys. Example: ```python from ultralytics.utils.checks import parse_requirements parse_requirements(package='ultralytics') ``` z extra == #rz ([a-zA-Z0-9-_]+)\s*([<>!=~]+.*)?r)name specifier) r distributionrequiresr read_text splitlinesstrip startswithsplitrematchappendr) file_pathpackagexr$ requirementsliner+s cC:\Users\daisl\Desktop\realtime-object-detection\venv\Lib\site-packages\ultralytics/utils/checks.pyparse_requirementsr3s&'44W=FF_F!+]^J^AF_ ?,,.99;Lzz| ,::c?1%++-DHH@$GE##OqafghaiUSTX^^M]oq$rs  `s C>C>returnc  ttttjd|ddS#t $r%}t jd|d|Yd}~yd}~wwxYw)a Convert a version string to a tuple of integers, ignoring any extra non-numeric string attached to the version. This function replaces deprecated 'pkg_resources.parse_version(v)'. Args: version (str): Version string, i.e. '2.0.1+cpu' Returns: (tuple): Tuple of integers representing the numeric part of the version and the extra string, i.e. (2, 0, 1) z\d+Nu)WARNING ⚠️ failure for parse_version(z), returning (0, 0, 0): )rrr)tuplemapintr*findall Exceptionr warning)versiones r2 parse_versionr?As[Sbjj9"1=>?? B7)Kcdecfghs/2 A AA c<t|}td|DS)z Check if a string is composed of only ASCII characters. Args: s (str): String to be checked. Returns: bool: True if the string is composed only of ASCII characters, False otherwise. c38K|]}t|dkyw)N)ord).0cs r2 zis_ascii..as'Qs1v|Qs)strall)ss r2is_asciirJSs  AA 'Q' ''c tt|tjr|j n|}t|tr|g}nGt|t t fr t |}n%td|dt|jdt||kDrHd}|dk7rtd|d|tjdt |d |t |g}|Dcgc]'}t tj||z |z|)}}||k7rtjd |d |d ||d k(rt|dk(r |d|dg}|S|dk(rt|dk(r|d}|S|}|Scc}w)a( Verify image size is a multiple of the given stride in each dimension. If the image size is not a multiple of the stride, update it to the nearest multiple of the stride that is greater than or equal to the given floor value. Args: imgsz (int | cList[int]): Image size. stride (int): Stride value. min_dim (int): Minimum number of dimensions. max_dim (int): Maximum number of dimensions. floor (int): Minimum allowed value for image size. Returns: (List[int]): Updated image size. z'imgsz=z' is of invalid type zK. Valid imgsz types are int i.e. 'imgsz=640' or list i.e. 'imgsz=[640,640]'z'train' and 'val' imgsz must be an integer, while 'predict' and 'export' imgsz may be a [h, w] list or an integer, i.e. 'yolo export imgsz=640,480' or 'yolo export imgsz=640'rzimgsz=z is not a valid image size. u"WARNING ⚠️ updating to 'imgsz=z'. uWARNING ⚠️ imgsz=z must be multiple of max stride z, updating to r r)r9 isinstancetorchTensormaxlistr7 TypeErrortype__name__len ValueErrorr r<mathceil)imgszstridemin_dimmax_dimfloormsgr/szs r2 check_imgszr`ds FELL!Av NF% ED%= )U '%(=d5k>R>R=STdef f 5zG[ a<veW,HNO O;CJC De#diiF #f,e 4eB D U{.ug5UV\U]]klnkopq#a=' inequality if none passed # Check if current version is less than or equal to 22.04 check_version(current='22.04', required='<=22.04') # Check if current version is between 20.04 (inclusive) and 22.04 (exclusive) check_version(current='21.10', required='>20.04,<22.04') ``` u%WARNING ⚠️ invalid check_version(, z!) requested, please check values.TruWARNING ⚠️ z& package is required but not installedF,z([^0-9]*)([\d.]+)z==z!=)z>=rz<=>wir(Stuv QZ   ! D&&w/G  FgA ^^C & &s +-q188:A !  :!q&F 4ZAFF : qAvF 4ZaF 3YAF 3YAF, +D6"hZ?QRVQWWYZaYbbyz %f_&=> >  NN? + MA,, )&?7)Kq1r*stt  sE-E10E1cDtjt5tjj j tjd|dd}|jdk(r|jddcdddS dddy#1swYyxYw) a Returns the latest version of a PyPI package without downloading or installing it. Parameters: package_name (str): The name of the package to find the latest version for. Returns: (str): The latest version of the package. zhttps://pypi.org/pypi/z/jsonr6)timeoutinfor=N) contextlibsuppressr;requestspackagesurllib3disable_warningsget status_codejson) package_nameresponses r2check_latest_pypi_versionrs   Y '!!224<<"8e LVWX   3 &==?6*95 ( ' ' ( ' 's A(BBctrptrftjt5ddlm}t}t|d|r#tjd|d dddy dddyy#1swYyxYw) z Checks if a new version of the ultralytics package is available on PyPI. Returns: (bool): True if an update is available, False otherwise. r) __version__riz)New https://pypi.org/project/ultralytics/u8 available 😃 Update with 'pip install -U ultralytics'NTF) r rrxryr; ultralyticsrrrsr rw)rlatests r2check_pip_update_availablers{."   + /.0F[AfX,7 GxPGHI , +8, , s :A88Bc@t|j}t|z }|jr|St j Dcgc] }||vs| }}t |r|dSd|}tj|rtj|||Sycc}w)z Find font locally or download to user's configuration directory if it does not already exist. Args: font (str): Path or name of font. Returns: file (Path): Resolved font file path. rzhttps://ultralytics.com/assets/)urlfileN) rr!r existsrfindSystemFontsanyris_url safe_download)fontr!rrImatchesrs r2 check_fontrs :??D T !D {{} '668F8QDAIq8GF 7|qz ,D6 2CCd3  Gs  BBminimumcDttj|ddS)z Check current python version against the required minimum version. Args: minimum (str): Required minimum version of python. Returns: None zPython T)r!rc)rsplatformpython_version)rs r2 check_pythonr s 002G)RV WWrKTcLtddd}ttt|trm|j }|j s J|d|dt|Dcgc]+}|j|vs|j|j-}}nt|tr|g}g}|D]}}|jddjdd } tjd | } | d | d r| d jnd } } t!t#j$| | sJdj-d |D} | r|rt.rt1|}t3j4|dd|d kDzd|d t7j6}t9sJdt3j4t;j<d| d|dj?t7j6|z }t3j4|d|dd|dd|d kDzd|d|dtdddyyycc}w#t&t"j(f$r|j+|YwxYw#t@$r$}t3jB|d|Yd}~yd}~wwxYw) a Check if installed dependencies meet YOLOv8 requirements and attempt to auto-update if needed. Args: requirements (Union[Path, str, List[str]]): Path to a requirements.txt file, a single package requirement as a string, or a list of package requirements as strings. exclude (Tuple[str]): Tuple of package names to exclude from checking. install (bool): If True, attempt to auto-update packages that don't meet requirements. cmds (str): Additional commands to pass to the pip install command when auto-updating. Example: ```python from ultralytics.utils.checks import check_requirements # Check a requirements.txt file check_requirements('path/to/requirements.txt') # Check a single package check_requirements('ultralytics>=8.0.0') # Check multiple packages check_requirements(['numpy', 'ultralytics>=8.0.0']) ``` redboldz requirements: z not found, check failed./z.gitrz([a-zA-Z0-9-_]+)([<>!=~]+.*)?rr c3(K|] }d|d yw)"Nr)rDr/s r2rFz%check_requirements..\s(4a1QCq4sz Ultralytics requirementrIz$ not found, attempting AutoUpdate...zAutoUpdate skipped (offline)zpip install --no-cache Tshellu AutoUpdate success ✅ .1fz s, installed z package:  u ⚠️ z;Restart runtime or rerun command for updates to take effectu ❌ NF)"rrcheck_torchvisionrMrresolverr3r!r"rGr)replacer*r+r'rsrr=AssertionErrorrkr,joinrrUr rwtimer subprocess check_outputdecoder;r<)r0excludeinstallcmdsprefixrr/pkgsro r_strippedr+r!rbrIntdtr>s r2check_requirementsr-s6eV_ 5FN,%##%{{}I$/HII}:LT:Rl:RQVWV\V\dkVk166(1;;-0:R l L# &$~ D WWS\"%--fb9 9:FquQx58>>#3Rh  !1!1$!7B BB  (4((A {D A KK6(":3!a%=/4&Ptu v IIK {B$BB{ J336MaSPQRVQW4X`dellnoYY[1_ h6r#hmA3hWZ^_bc^cWdVeeghlgmmohhx8u'v&wwy{|  Cm = =>  KKN   &qc23 s7,II!IB5I6*I32I36 J#?JJ#c ddl}dgdgdgd}djtjj ddj ddd }dj|jj ddj ddd ||vr3||}t fd |Drt d d |d |ddyyy)a Checks the installed versions of PyTorch and Torchvision to ensure they're compatible. This function checks the installed versions of PyTorch and Torchvision, and warns if they're incompatible according to the provided compatibility table based on: https://github.com/pytorch/vision#installation. The compatibility table is a dictionary where the keys are PyTorch versions and the values are lists of compatible Torchvision versions. rNz0.15z0.14z0.13)z2.0z1.13z1.12.+r c3(K|] }|k7 yw)Nr)rDrq v_torchvisions r2rFz$check_torchvision..s?+>a}!+>suWARNING ⚠️ torchvision==z is incompatible with torch==z . Run 'pip install torchvision==z' to fix torchvision or 'pip install -U torch torchvision' to update both. For a full compatibility table see https://github.com/pytorch/vision#installation) torchvisionrrNrr)rHprint)rcompatibility_tablev_torchcompatible_versionsrs @r2rrrs$*(VHvhOhhu((..s3A6<? ? 0?\]d\ef33Fq3I2JKff g @&rKc|r|rt|tr|f}t|ttfr|n|gD]T}t |j j j}t|s@||vrEJ||d|d|yyy)z$Check file(s) for acceptable suffix.z acceptable suffix is z, not N) rMrGrQr7rsuffixlowerr'rU)rrr^frIs r2 check_suffixrs  fc "ZF#D4-8tfDAQ$$&,,.A1vF{VseA3.DVHFSTRU$VV{EtrKrc*d|vsd|vrd|vr|jdd}|Sd|vrnd|vrj|}tjdd|}tjd d|}tjd d|}||k7r|rtjd |d |d |S)z?Replace legacy YOLOv5 filenames with updated YOLOv5u filenames.yolov3yolov5zu.yaml.yaml.ptuz(.*yolov5([nsmlx]))\.ptz\1u.ptz(.*yolov5([nsmlx])6)\.ptz(.*yolov3(|-tiny|-spp))\.ptuPRO TIP 💡 Replace 'model=z' with new 'model=z'. YOLOv5 'u' models are trained with https://github.com/ultralytics/ultralytics and feature improved performance vs standard YOLOv5 models trained with https://github.com/ultralytics/yolov5. )rr*subr rw)rrd original_files r2check_yolov5u_filenamers48t+ t <<'2D Kd]s$ M664iFD665y$GD668)TJD}$ 2=/ASTXSYZcde KrKct||t|j}t|}|rd|vrt |j r|S|r|j jdrf|}t|}t |j r&tjdt|d||Stj||d|Stjttdz dz |z d }|s|rt!d |d t#|d kDr|rt!d|d|t#|r|dSgS)z4Search/download file (if necessary) and return path.z://)zhttps://zhttp://zrtsp://zrtmp://ztcp://zFound z locally at F)rrunzipcfgz**T) recursive'z' does not existrzMultiple files match 'z', specify exact path: r)rrGr'rrrrr(rr rwrrrglobr FileNotFoundErrorrU)rrdownloadrcrfiless r2 check_filers2v t9?? D !$ 'D E%$t**;*;*= djjl--.ef~ :    KK&3 0 TFC D   # #$e D  #dUlT1D89TJ#av-=$>? ? Z!^#&s r2 check_imshowrs   *9;xzZcZe ee 6288IRXX>? A  A   NNklmkno psB/B22 C;CCc Rddl}ddlm}trCt ddrt j dtrtjdd |rd }|jj}tjd \}}}d t jd||z dd||z |z dd ||z dd } tjt 5ddlm} | j'dddnd} ||dt)j*d| y#1swY,xYw)z;Return a human-readable YOLO software and hardware summary.rN) select_devicewandbF)rzpip uninstall -y wandb sample_dataT) ignore_errors@r(z CPUs, rz GB RAM, z GB disk))displayr)devicenewlineuSetup complete ✅ )psutilultralytics.utils.torch_utilsrrrrsystemrshutilrmtreevirtual_memorytotal disk_usage cpu_countrxryr;IPythonr clear_outputr rw) rdrrrgibramrusedfreerIrs r2 check_yolors;| gu 5 II. / : MM-t <##%++"--c2tT wsSyoY PS?STW>XXYZ_beZefiYjjs t   + '  ", + / KK%aS)*, +s DD&cTddl}ddlm}m}ddlm}|j jdz }ttjdddtjdd d|dd dtjjddd d|rd n trd ndddd|dddd|dddt r8t j"j%rt jj"nddt'dD]y} t)j|j*}t-|t/|j0drdnd}tj|j*d|||j0{y#t(j2$rd}d}YNwxYw)zWCollect and print relevant system information including OS, Python, RAM, CPU, and CUDA.rN) ENVIRONMENT is_git_dir) get_cpu_inforrOSz<20 EnvironmentPythonInstallgitpipotherRAMz.2fz GB CPUCUDAr)r.Tru✅ u❌ z(not installed))rultralytics.utilsr r rr rrrr rwrsysr=r)rrNcuda is_availabler3rr!rsrGr"rk)rr r r ram_infororais_mets r2collect_system_infors}9:$$&,, :HL KK"T#Jx00232 %k]"C.!2!2!4Q!7 8S/:<%nFVU\c!ddf+hs^5+ln-R#,Uuzz?V?V?Xu}}11^bcce gh 6 &&qvv.G,Wc!++6FTRVX^F  qvvcl6(7)AKK=AB7,, 'GF sAF  F'&F'ct|jjjdvryfd}tdz }t d}t j|dd} dd lm }||d |sJt j|d y#t$rt j|d |Yyttf$rt j|d |Yyt$rt j|dYywxYw)a This function checks the PyTorch Automatic Mixed Precision (AMP) functionality of a YOLOv8 model. If the checks fail, it means there are anomalies with AMP on the system that may cause NaN losses or zero-mAP results, so AMP will be disabled during training. Args: model (nn.Module): A YOLOv8 model instance. Example: ```python from ultralytics import YOLO from ultralytics.utils.checks import check_amp model = YOLO('yolov8n.pt').model.cuda() check_amp(model) ``` Returns: (bool): Returns True if the AMP functionality works correctly with YOLOv8 model, else False. )cpumpsFc||ddjj}tjjj d5||ddjj}ddd~|j j k(xr&tj||jdS#1swYKxYw)zAll close FP32 vs AMP results.F)rrdrTNg?)atol) boxesdatarNrampautocastshapeallclosefloat)mimabrs r2 amp_allclosezcheck_amp..amp_allclose+s b / 2 8 8 = = ZZ^^ $ $T *"VU3A6<<AAA+ ww!''!LennQ &LL+ *s #B::Czbus.jpgzAMP: z>running Automatic Mixed Precision (AMP) checks with YOLOv8n...z`Setting 'amp=True'. If you experience zero-mAP or NaN losses you can disable AMP with amp=False.r)YOLO yolov8n.ptuchecks passed ✅u?checks skipped ⚠️, offline and unable to download YOLOv8n. uachecks skipped ⚠️. Unable to load YOLOv8n due to possible Ultralytics package modifications. uchecks failed ❌. Anomalies were detected with AMP on your system that may lead to NaN losses or zero-mAP results, so AMP will be disabled during training.T)next parametersrrSrrr rwrr/ConnectionErrorr<AttributeErrorrlr)modelr.r+r warning_msgr/rs @r2 check_ampr7s,*%""$ % , ,F {{n$M ) B g F KK6(XYZtK $D.333 vh/01  p&!`al`mno  / 0s&"ddocpr s  &"bc ds(/B#D =(D ' D  D ctjt5tjd|ddj ddcdddS#1swYyxYw)zbReturn human-readable git description, i.e. v5.0-5-g3e25f1e https://git-scm.com/docs/git-describe.zgit -C z describe --tags --long --alwaysTrNrr)rxryr;rrr)paths r2 git_describer:GsL   Y '&&6V'W_cdkkmnqoqr ( ' ' s ,AAargsc d tjj}tj|\}}}}}|Btj|\}}}}|j D cic] \}} ||vs || }}} t |jjtjd}|r|dnd|r|dndz} tjt| dj! fd|j Dzycc} }w#t$rt |j}YwxYw)z.Print function arguments (optional args dict).czt|tr*|jdrt|dkDr t |S|S)zTClean longer Ultralytics HUB URLs by stripping potential authentication information.httpd)rMrGr(rUr)rqs r2 strip_authzprint_args..strip_authQs5 *1c 2q||F7KPSTUPVY\P\y|dcddrKNrrrfc3>K|]\}}|d|yw)=Nr)rDkrqr@s r2rFzprint_args.._s%'X<41a1#Qz!}o(>res      #[[[[[[ "&/A!A2!He$(4("-`")")'$"' H3HHHH H-1 HV6"$: X# XD X $(KK2D$DbZ^egA AHg<Wt$.0/  +8C82jZXd^Z(3*#4#rK