§
    l¬¸j1S  ã            
      óÀ   — d dl mZ d dlZd dlmZmZmZmZ d dl	m
Z
mZmZmZmZmZ dddddgd	d
ddddœ	Zd%d„Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Z	 	 	 	 	 d&d'd$„ZdS )(é    )ÚannotationsN)Ú	TASK2DATAÚTASK2METRICÚget_cfgÚget_save_dir)ÚDEFAULT_CFGÚDEFAULT_CFG_DICTÚLOGGERÚNUM_THREADSÚchecksÚcolorstrzax-platformzbayesian-optimization==1.4.3Ú
hpbandsterÚConfigSpacezHEBO>=0.2.0ÚhyperoptÚ	nevergradÚoptunaÚzoopt)	ÚrandomÚaxÚbayesoptÚbohbÚhebor   r   r   r   ÚvalueÚdictc                óÂ  — t          | t          ¦  «        rd„ |                      ¦   «         D ¦   «         S t          | t          ¦  «        rd„ | D ¦   «         S t          | t          ¦  «        rt	          d„ | D ¦   «         ¦  «        S t          | t
          j        ¦  «        r|                      ¦   «         S t          | t
          j        ¦  «        r|  	                    ¦   «         S | S )a#  Convert NumPy-backed Tune values into native Python types for YAML serialization.

    Args:
        value (dict): The value to convert. Can be a dict, list, tuple, NumPy scalar, or NumPy array.

    Returns:
        The converted value with NumPy types replaced by native Python types.
    c                ó4   — i | ]\  }}|t          |¦  «        “ŒS © ©Ú_sanitize_tune_value)Ú.0ÚkÚvs      úg/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/ultralytics/utils/tuner.pyú
<dictcomp>z(_sanitize_tune_value.<locals>.<dictcomp>!   s'   € ÐEÐEÐE©t¨q°!�Õ'¨Ñ*Ô*ÐEÐEÐEó    c                ó,   — g | ]}t          |¦  «        ‘ŒS r   r   ©r    r"   s     r#   ú
<listcomp>z(_sanitize_tune_value.<locals>.<listcomp>#   s!   € Ð7Ð7Ð7¨AÕ$ QÑ'Ô'Ð7Ð7Ð7r%   c              3  ó4   K  — | ]}t          |¦  «        V — Œd S ©Nr   r'   s     r#   ú	<genexpr>z'_sanitize_tune_value.<locals>.<genexpr>%   s+   è è € Ð<Ð<°Õ)¨!Ñ,Ô,Ð<Ð<Ð<Ð<Ð<Ð<r%   )
Ú
isinstancer   ÚitemsÚlistÚtupleÚnpÚgenericÚitemÚndarrayÚtolist)r   s    r#   r   r      sÑ   € õ �%�ÑÔð FØEÐE°u·{²{±}´}ÐEÑEÔEÐEÝ�%�ÑÔð 8Ø7Ð7°Ð7Ñ7Ô7Ð7Ý�%�ÑÔð =ÝÐ<Ð<°eÐ<Ñ<Ô<Ñ<Ô<Ð<Ý�%�œÑ$Ô$ð Ø�zŠz‰|Œ|ÐÝ�%�œÑ$Ô$ð Ø�|Š|‰~Œ~ÐØ€Lr%   c                ód  — | €dS t          | t          ¦  «        r*|                      ¦   «                              ¦   «         }|pdS | j        }|j        |j        }}|dk    r|                     d¦  «        rdS |dk    r|                     d¦  «        rdS |dk    r|                     d	¦  «        rd
S dS )a\  Return the normalized Ray Tune search algorithm kind for known searcher objects.

    Args:
        search_alg (str | ray.tune.search.Searcher): The search algorithm to identify. Can be None, a string, or a Ray
            Tune searcher object.

    Returns:
        str | None: The normalized search algorithm name, or None if not recognized.
    NÚAxSearchzray.tune.search.axr   ÚTuneBOHBzray.tune.search.bohbr   ÚZOOptSearchzray.tune.search.zooptr   )r,   ÚstrÚstripÚlowerÚ	__class__Ú
__module__Ú__name__Ú
startswith)Ú
search_algÚ
normalizedÚclsÚmoduleÚnames        r#   Ú_get_ray_search_alg_kindrE   -   sÏ   € ð ÐØˆtÝ�*�cÑ"Ô"ð "Ø×%Ò%Ñ'Ô'×-Ò-Ñ/Ô/ˆ
ØÐ!˜TÐ!à
Ô
€CØ”> 3¤<ˆD€FØˆzÒÐ˜f×/Ò/Ð0DÑEÔEÐØˆtØˆzÒÐ˜f×/Ò/Ð0FÑGÔGÐØˆvØˆ}ÒÐ ×!2Ò!2Ð3JÑ!KÔ!KÐØˆwØˆ4r%   c                óv   — t          j        t          d         ¦  «         ddlm} |                     | ¦  «        S )a  Validate that a Tune search space can be consumed by Ax.

    Args:
        space (dict): The hyperparameter search space to validate.

    Returns:
        list: The converted Ax parameters.

    Raises:
        ImportError: If the required 'ax-platform' package is not installed.
    r   r   ©r6   )r   Úcheck_requirementsÚRAY_SEARCH_ALG_REQUIREMENTSÚray.tune.search.ax.ax_searchr6   Úconvert_search_space)Úspacer6   s     r#   Ú_validate_ax_search_spacerM   H   sA   € õ ÔÕ9¸$Ô?Ñ@Ô@Ð@à5Ð5Ð5Ð5Ð5Ð5à×(Ò(¨Ñ/Ô/Ð/r%   c                óÌ   — t          | ¦  «        }ddlm} ddlm} ddlm}  |¦   «         }|                     |t          |          |d¬¦  «        i¬¦  «          ||¬¦  «        S )	as  Create an Ax searcher with an initialized experiment.

    Args:
        space (dict): The hyperparameter search space.
        task (str): The task type (e.g., 'detect', 'segment', 'classify').

    Returns:
        AxSearch (ray.tune.search.Searcher): The configured Ax search algorithm.

    Raises:
        ImportError: If required Ax packages are not installed.
    r   )ÚAxClient)ÚObjectivePropertiesrG   F)Úminimize)Ú
parametersÚ
objectives)Ú	ax_client)	rM   Úax.service.ax_clientrO   Úax.service.utils.instantiationrP   rJ   r6   Úcreate_experimentr   )rL   ÚtaskrR   rO   rP   r6   rT   s          r#   Ú_create_ax_searchrY   [   s£   € õ +¨5Ñ1Ô1€Jà-Ð-Ð-Ð-Ð-Ð-ØBÐBÐBÐBÐBÐBØ5Ð5Ð5Ð5Ð5Ð5à�‘
”
€IØ×ÒØÝ Ô%Ð':Ð':ÀEÐ'JÑ'JÔ'JÐKð  ñ ô ð ð ˆ8˜iÐ(Ñ(Ô(Ð(r%   c                óž  — t          j        t          d         ¦  «         ddl}ddlm}m}m}m}m	}m
} ddlm} ddlm}	  |	| d¬¦  «        }
 ||
¦  «        \  }}}|rt          d	¦  «        ‚|                     ¦   «         }|D �]º\  }}d
                     d„ |D ¦   «         ¦  «        }|                     ¦   «         }t'          ||¦  «        rt)          d¦  «        ‚t'          ||¦  «        rWt'          |||f¦  «        rE|                     |                     ||j        |j        t'          ||¦  «        ¬¦  «        ¦  «         Œ¿t'          ||¦  «        r]t'          |||f¦  «        rK|j        dz
  }|                     |                     ||j        |t'          ||¦  «        ¬¦  «        ¦  «         �Œ,t'          ||¦  «        rAt'          ||¦  «        r1|                     |                     ||j        ¬¦  «        ¦  «         �Œ}t)          dt9          |¦  «        j        › dt9          |j        ¦  «        j        › d�¦  «        ‚d„ |D ¦   «         }||fS )a½  Convert a Tune search space into BOHB-compatible ConfigSpace and fixed-only Tune param_space.

    Args:
        space (dict): The hyperparameter search space.

    Returns:
        (tuple): A tuple containing the ConfigSpace object and a dict of fixed parameters.

    Raises:
        ValueError: If the search space contains grid search parameters or unsupported samplers.
        ImportError: If required BOHB packages are not installed.
    r   r   N)ÚCategoricalÚFloatÚIntegerÚ
LogUniformÚ	QuantizedÚUniform©Úparse_spec_vars©Úflatten_dictT©Úprevent_delimiterzTGrid search parameters cannot be automatically converted to a TuneBOHB search space.ú/c              3  ó4   K  — | ]}t          |¦  «        V — Œd S r*   ©r9   ©r    Úps     r#   r+   z-_convert_bohb_search_space.<locals>.<genexpr>‘   s(   è è € Ð,Ð, !•s˜1‘v”vÐ,Ð,Ð,Ð,Ð,Ð,r%   zWTuneBOHB does not support quantized search spaces with the current ConfigSpace version.)r;   ÚupperÚlogé   )Úchoicesz-TuneBOHB does not support parameters of type z with sampler type ú.c                óT   — i | ]%\  }}d                       d„ |D ¦   «         ¦  «        |“Œ&S )rg   c              3  ó4   K  — | ]}t          |¦  «        V — Œd S r*   ri   rj   s     r#   r+   z8_convert_bohb_search_space.<locals>.<dictcomp>.<genexpr>«   ó(   è è € Ð!7Ð!7¨Q¥# a¡&¤&Ð!7Ð!7Ð!7Ð!7Ð!7Ð!7r%   ©Újoin©r    Úpathr   s      r#   r$   z._convert_bohb_search_space.<locals>.<dictcomp>«   ó9   € Ð`Ð`Ð`Á;À4È˜ŸšÐ!7Ð!7°$Ð!7Ñ!7Ô!7Ñ7Ô7¸Ð`Ð`Ð`r%   )r   rH   rI   r   Úray.tune.search.sampler[   r\   r]   r^   r_   r`   Ú!ray.tune.search.variant_generatorrb   Úray.tune.utilsrd   Ú
ValueErrorÚConfigurationSpaceru   Úget_samplerr,   Ú	TypeErrorÚaddÚUniformFloatHyperparameterr;   rl   ÚUniformIntegerHyperparameterÚCategoricalHyperparameterÚ
categoriesÚtyper>   Úsampler)rL   r   r[   r\   r]   r^   r_   r`   rb   rd   Úresolved_spaceÚresolved_varsÚdomain_varsÚ	grid_varsÚcsrw   ÚdomainÚparr†   rl   Úfixed_param_spaces                        r#   Ú_convert_bohb_search_spacer�   v   sì  € õ ÔÕ9¸&ÔAÑBÔBÐBàÐÐÐØbÐbÐbÐbÐbÐbÐbÐbÐbÐbÐbÐbÐbÐbÐbÐbØAÐAÐAÐAÐAÐAØ+Ð+Ð+Ð+Ð+Ð+à!�\ %¸4Ð@Ñ@Ô@€NØ,;¨O¸NÑ,KÔ,KÑ)€M�; 	Øð qÝÐoÑpÔpÐpà	×	'Ò	'Ñ	)Ô	)€BØ#ð ñ ‰ˆˆfØ�hŠhÐ,Ð, tÐ,Ñ,Ô,Ñ,Ô,ˆØ×$Ò$Ñ&Ô&ˆÝ�g˜yÑ)Ô)ð 	wÝÐuÑvÔvÐvå�f˜eÑ$Ô$ð 	­°G¸gÀzÐ=RÑ)SÔ)Sð 	Ø�FŠFØ×6Ò6Ø˜vœ|°6´<ÅZÐPWÐYcÑEdÔEdð 7ñ ô ñô ð ð õ
 ˜ Ñ(Ô(ð 	­Z¸À'È:ÐAVÑ-WÔ-Wð 	Ø”L 1Ñ$ˆEØ�FŠFØ×8Ò8Ø˜vœ|°5½jÈÐR\Ñ>]Ô>]ð 9ñ ô ñô ð ñ õ
 ˜ Ñ,Ô,ð 	µ¸GÀWÑ1MÔ1Mð 	Ø�FŠF�;×8Ò8¸ÀfÔFWÐ8ÑXÔXÑYÔYÐYÑYåðFÅÀVÁÄÔ@Uð Fð FÝ%)¨&¬.Ñ%9Ô%9Ô%BðFð Fð Fñô ð ð
 aÐ`ÐR_Ð`Ñ`Ô`ÐØÐ Ð Ð r%   c                óh   — t          | ¦  «        \  }}ddlm}  ||t          |         d¬¦  «        |fS )a¬  Create a BOHB searcher using a ConfigSpace definition compatible with current ConfigSpace versions.

    Args:
        space (dict): The hyperparameter search space.
        task (str): The task type (e.g., 'detect', 'segment', 'classify').

    Returns:
        (tuple): A tuple containing the TuneBOHB searcher and fixed parameter space dict.

    Raises:
        ImportError: If required BOHB packages are not installed.
    r   )r7   Úmax)rL   ÚmetricÚmode)r�   Ú ray.tune.search.bohb.bohb_searchr7   r   )rL   rX   r‹   rŽ   r7   s        r#   Ú_create_bohb_searchr•   ¯   sK   € õ 7°uÑ=Ô=Ñ€BÐà9Ð9Ð9Ð9Ð9Ð9àˆ8˜"¥[°Ô%6¸UÐCÑCÔCÐEVÐVÐVr%   c                óš   — t          j        t          d         ¦  «         ddl}ddlm}  ||j        j        t          |          d¬¦  «        S )a3  Create a Nevergrad searcher with a default optimizer.

    Args:
        task (str): The task type (e.g., 'detect', 'segment', 'classify').

    Returns:
        (NevergradSearch): The configured Nevergrad search algorithm.

    Raises:
        ImportError: If the 'nevergrad' package is not installed.
    r   r   N)ÚNevergradSearchr‘   )Ú	optimizerr’   r“   )	r   rH   rI   r   Úray.tune.search.nevergradr—   Ú
optimizersÚ
OnePlusOner   )rX   Úngr—   s      r#   Ú_create_nevergrad_searchr�   Ã   s\   € õ ÔÕ9¸+ÔFÑGÔGÐGàÐÐÐØ9Ð9Ð9Ð9Ð9Ð9àˆ? R¤]Ô%=ÅkÐRVÔFWÐ^cÐdÑdÔdÐdr%   c                óæ   — t          j        t          d         ¦  «         ddlm} ddlm} ddlm}  || d¬¦  «        } ||¦  «        \  }}}d„ |D ¦   «         }| 	                    | ¦  «        }||fS )	aZ  Convert a Tune search space into ZOOpt-compatible dimensions and fixed-only Tune param_space.

    Args:
        space (dict): The hyperparameter search space.

    Returns:
        (tuple): A tuple containing the ZOOpt dimension dict and fixed parameter space dict.

    Raises:
        ImportError: If the 'zoopt' package is not installed.
    r   r   ra   ©r8   rc   Tre   c                óT   — i | ]%\  }}d                       d„ |D ¦   «         ¦  «        |“Œ&S )rg   c              3  ó4   K  — | ]}t          |¦  «        V — Œd S r*   ri   rj   s     r#   r+   z9_convert_zoopt_search_space.<locals>.<dictcomp>.<genexpr>ë   rs   r%   rt   rv   s      r#   r$   z/_convert_zoopt_search_space.<locals>.<dictcomp>ë   rx   r%   )
r   rH   rI   rz   rb   Úray.tune.search.zooptr8   r{   rd   rK   )	rL   rb   r8   rd   r‡   rˆ   Ú_rŽ   Údim_dicts	            r#   Ú_convert_zoopt_search_spacer¥   ×   s¯   € õ ÔÕ9¸'ÔBÑCÔCÐCàAÐAÐAÐAÐAÐAØ1Ð1Ð1Ð1Ð1Ð1Ø+Ð+Ð+Ð+Ð+Ð+à!�\ %¸4Ð@Ñ@Ô@€NØ)˜/¨.Ñ9Ô9Ñ€M�1�aØ`Ð`ÐR_Ð`Ñ`Ô`ÐØ×/Ò/°Ñ6Ô6€HØÐ&Ð&Ð&r%   c                ól   — t          | ¦  «        \  }}ddlm}  |d||t          |         d¬¦  «        |fS )aÛ  Create a ZOOpt searcher with required budget and converted search space.

    Args:
        space (dict): The hyperparameter search space.
        task (str): The task type (e.g., 'detect', 'segment', 'classify').
        iterations (int): The maximum number of trials (budget) for ZOOpt.

    Returns:
        (tuple): A tuple containing the ZOOptSearch searcher and fixed parameter space dict.

    Raises:
        ImportError: If the 'zoopt' package is not installed.
    r   rŸ   Úasracosr‘   )ÚalgoÚbudgetr¤   r’   r“   )r¥   r¢   r8   r   )rL   rX   Ú
iterationsr¤   rŽ   r8   s         r#   Ú_create_zoopt_searchr«   ð   s\   € õ #>¸eÑ"DÔ"DÑ€HÐà1Ð1Ð1Ð1Ð1Ð1àˆ;Ø˜z°HÅ[ÐQUÔEVÐ]bðñ ô àðð r%   c                ón  — | €d|dfS t          | ¦  «        }t          | t          ¦  «        rX|sd|dfS |t          vr=d                     t          t          ¦  «        ¦  «        }t          d| › d|› d�¦  «        ‚|dk    rd||fS 	 |dk    r<t          | t          ¦  «        rt          ||¦  «        i |fS t          |¦  «         | i |fS |dk    rBt          | t          ¦  «        rt          ||¦  «        \  }}nt          |¦  «        \  }}| }|||fS |d	k    rt          |¦  «        ||fS |d
k    rCt          | t          ¦  «        rt          |||¦  «        \  }}nt          |¦  «        \  }}| }|||fS t          | t          ¦  «        s| |dfS t          |         }	|	rt          j        |	¦  «         |dk    r3ddlm}
 ddlm}  | |
dd¬¦  «        t(          |         d¬¦  «        ||fS ddlm}  ||t(          |         d¬¦  «        ||fS # t.          t0          f$ r}t1          d| › d|› �¦  «        |‚d}~ww xY w)aç  Resolve search algorithms and normalize Tune param_space for known Ray Tune searchers.

    Args:
        search_alg (str | object | None): The search algorithm to use. Can be a string name, a pre-instantiated Ray Tune
            searcher object, or None for default behavior.
        task (str): The task type (e.g., 'detect', 'segment', 'classify').
        space (dict): The hyperparameter search space.
        iterations (int): The maximum number of trials to run.

    Returns:
        (tuple): A tuple containing (resolved_search_alg, tuner_param_space, resolved_search_alg_kind).
            - resolved_search_alg: The configured searcher or None.
            - tuner_param_space: The normalized parameter space for the tuner.
            - resolved_search_alg_kind: The normalized algorithm name or None.

    Raises:
        ValueError: If an unsupported search_alg string is provided.
        ModuleNotFoundError: If required dependencies for the chosen algorithm are not installed.
    Nz, z!Unsupported Ray Tune search_alg 'z'. Supported values: rp   r   r   r   r   r   r   r   )Ú
TPESampler)ÚOptunaSearchT)ÚmultivariateÚconstant_liarr‘   )r†   r’   r“   )Úcreate_searcher)r’   r“   zRay Tune search_alg 'z4' requires additional dependencies. Original error: )rE   r,   r9   rI   ru   Úsortedr|   rY   rM   r•   r�   r�   r«   r¥   r   rH   Úoptuna.samplersr­   Úray.tune.search.optunar®   r   Úray.tune.searchr±   ÚImportErrorÚModuleNotFoundError)r@   rX   rL   rª   rA   Ú	supportedÚresolved_search_algÚtuner_param_spacer£   Úrequirementsr­   r®   r±   Úes                 r#   Ú_resolve_ray_search_algr½     s  € ð( ÐØ�U˜DÐ Ð å)¨*Ñ5Ô5€JÝ�*�cÑ"Ô"ð +Øð 	%Ø˜ Ð$Ð$ØÕ8Ð8Ð8ØŸ	š	¥&Õ)DÑ"EÔ"EÑFÔFˆIÝÐnÀÐnÐnÐbkÐnÐnÐnÑoÔoÐoØ˜Ò!Ð!Ø˜ 
Ð*Ð*ð1Ø˜ÒÐÝ˜*¥cÑ*Ô*ð FÝ(¨°Ñ5Ô5°r¸:ÐEÐEÝ% eÑ,Ô,Ð,Ø˜r :Ð-Ð-Ø˜ÒÐÝ˜*¥cÑ*Ô*ð 1Ý9LÈUÐTXÑ9YÔ9YÑ6Ð#Ð%6Ð%6å'AÀ%Ñ'HÔ'HÑ$�Ð$Ø&0Ð#Ø&Ð(9¸:ÐEÐEØ˜Ò$Ð$Ý+¨DÑ1Ô1°5¸*ÐDÐDØ˜Ò Ð Ý˜*¥cÑ*Ô*ð 1Ý9MÈeÐUYÐ[eÑ9fÔ9fÑ6Ð#Ð%6Ð%6å'BÀ5Ñ'IÔ'IÑ$�Ð$Ø&0Ð#Ø&Ð(9¸:ÐEÐEÝ˜*¥cÑ*Ô*ð 	+Ø˜u dÐ*Ð*å2°:Ô>ˆØð 	4ÝÔ% lÑ3Ô3Ð3à˜Ò!Ð!Ø2Ð2Ð2Ð2Ð2Ð2Ø;Ð;Ð;Ð;Ð;Ð;ð �Ø&˜J°DÈÐMÑMÔMÝ& tÔ,Øðñ ô ð
 Øðð ð 	4Ð3Ð3Ð3Ð3Ð3àˆ˜zµ+¸dÔ2CÈ%ÐPÑPÔPÐRWÐYcÐcÐcøÝÕ,Ð-ð ð ð Ý!Øg JÐgÐgÐdeÐgÐgñ
ô 
àð	øøøøðøøøsE   Â-H Â3H ÃAH ÄH Ä'AH Å0H Æ
AH Ç&!H ÈH4ÈH/È/H4é
   é,  rL   údict | NoneÚgrace_periodÚintÚgpu_per_trialú
int | Nonerª   c                ó¾
  ‡‡‡‡‡‡— t          j        d¦  «         	 t          j        ddgdg¬¦  «         ddlŠddlmŠ dd	lm} dd
lm	}m
}	 n# t          $ r t          d¦  «        ‚w xY wi d‰                     dd¦  «        “d‰                     dd¦  «        “d‰                     dd¦  «        “d‰                     dd¦  «        “d‰                     dd¦  «        “d‰                     dd¦  «        “d‰                     dd¦  «        “d‰                     dd¦  «        “d ‰                     dd¦  «        “d!‰                     d"d#¦  «        “d$‰                     dd¦  «        “d%‰                     dd&¦  «        “d'‰                     dd&¦  «        “d(‰                     dd)¦  «        “d*‰                     dd&¦  «        “d+‰                     dd¦  «        “d,‰                     dd-¦  «        “‰                     dd¦  «        ‰                     dd¦  «        ‰                     dd¦  «        ‰                     dd¦  «        ‰                     dd¦  «        ‰                     dd¦  «        ‰                     dd¦  «        ‰                     dd¦  «        ‰                     dd.¦  «        d/œ	¥}
| j        Š‰                     | ¦  «        Š‰                     d0d1¦  «        Šˆˆˆˆˆˆfd2„}|s+|
}‰                     d3¦  «        st          j        d4¦  «         ‰                     d5t&          ‰         ¦  «        }||d5<   d5‰vrt          j        d6|› d7�¦  «         t)          |‰||¦  «        \  }}}‰                     |t,          |pdd8œ¦  «        }‰                     d9¦  «        pt.          d9         pd:} |d;t0          ‰         d<|t3          ||¦  «        d=¬>¦  «        }|d?k    r |	d;t0          ‰         d<|d=¬@¦  «        }t5          t7          t8          i ‰¥dA‰                     d3dB¦  «        i¥¦  «        ‰                     d0d1¦  «        ¬C¦  «        }|                     dDdD¬E¦  «         ‰j                              |¦  «        rRt          j        tC          dF¦  «        › dG|› dH�¦  «         ‰j         "                    tG          |¦  «        |dD¬I¦  «        }nH‰                     ||‰ $                    |||dJ„ dK„ ¬L¦  «         ||j%        |j&        ¬M¦  «        ¬N¦  «        }| '                    ¦   «          | (                    ¦   «         }‰ )                    ¦   «          |S )Oa  Run hyperparameter tuning using Ray Tune.

    Args:
        model (YOLO): Model to run the tuner on.
        space (dict, optional): The hyperparameter search space. If not provided, uses default space.
        grace_period (int, optional): The grace period in epochs of the ASHA scheduler.
        gpu_per_trial (int, optional): The number of GPUs to allocate per trial.
        iterations (int, optional): The maximum number of trials to run.
        search_alg (str | ray.tune.search.Searcher | ray.tune.search.SearchAlgorithm, optional): Search algorithm to
            use. Defaults to Optuna multivariate TPE. Strings are resolved to supported Ray Tune searchers,
            pre-instantiated objects are reused, and known searchers with special Tune param_space requirements are
            normalized automatically.
        **train_args (Any): Additional arguments to pass to the `train()` method.

    Returns:
        (ray.tune.ResultGrid): A ResultGrid containing the results of the hyperparameter search.

    Examples:
        >>> from ultralytics import YOLO
        >>> model = YOLO("yolo26n.pt")  # Load a YOLO26n model

        Start tuning hyperparameters for YOLO26n training on the COCO8 dataset
        >>> result_grid = model.tune(data="coco8.yaml", use_ray=True)
    uN   ðŸ’¡ Learn about RayTune at https://docs.ultralytics.com/integrations/ray-tunezray>=2.41.0z	ray[tune]zpydantic>=2.0,<2.12)Ú	constrainr   N)Útune)Ú	RunConfig)ÚASHASchedulerÚHyperBandForBOHBzHRay Tune required but not found. To install run: pip install "ray[tune]"Úlr0gñhãˆµøä>g{®Gáz„?Úlrfg      ð?Úmomentumgffffffæ?g\�Âõ(\ï?Úweight_decayç        gü©ñÒMbP?Úwarmup_epochsg      @Úwarmup_momentumgffffffî?Úboxg      4@rB   gš™™™™™¹?g      @Úcls_pwÚdflgš™™™™™Ù?g      (@Úhsv_hÚhsv_sgÍÌÌÌÌÌì?Úhsv_vÚdegreesg     €F@Ú	translateÚscaleÚshearg      $@é   )	ÚperspectiveÚflipudÚfliplrÚbgrÚmosaicÚmixupÚcutmixÚ
copy_pasteÚclose_mosaicrD   rÇ   c                óú  •‡— ‰                      ‰¦  «        }d|_        |                     ¦   «          t          t	          | ¦  «        ¦  «        } |                      ‰
¦  «         	 ‰                     ¦   «                              ¦   «         }d|v r|                     d¦  «        d         n|}‰› d|› �| d<   n# t          $ r ‰| d<   Y nw xY w |j
        d	i | ¤Ž}t          |                       d¦  «        t          t          f¦  «        rnt          ‰	         Š‰t          ˆfd„|                     ¦   «         D ¦   «         ¦  «        t#          |¦  «        z  d|                       d¦  «        pt$          d         iS |j        S )
zKTrain the YOLO model with the specified hyperparameters and return results.Nr£   éÿÿÿÿrD   Údatac              3  óH   •K  — | ]}|pi                       ‰d ¦  «        V — ŒdS )rÏ   N)Úget)r    Úmetricsr’   s     €r#   r+   z.run_ray_tune.<locals>._tune.<locals>.<genexpr>À  s7   øè è € Ð]Ð]À˜W˜]¨×/Ò/°¸Ñ<Ô<Ð]Ð]Ð]Ð]Ð]Ð]r%   ÚepochÚepochsr   )rê   ÚtrainerÚreset_callbacksr   r   ÚupdateÚget_contextÚget_trial_idÚsplitÚ	ExceptionÚtrainr,   r.   r/   r   ÚsumÚvaluesÚlenr	   Úresults_dict)ÚconfigÚmodel_to_trainÚtrial_idÚtrial_suffixÚresultsr’   Ú	base_nameÚmodel_in_storeÚrayrX   Ú
train_argsrÇ   s        @€€€€€€r#   Ú_tunezrun_ray_tune.<locals>._tune«  sŒ  øø€ àŸš Ñ0Ô0ˆØ!%ˆÔØ×&Ò&Ñ(Ô(Ð(Ý%¥d¨6¡l¤lÑ3Ô3ˆØ�Š�jÑ!Ô!Ð!ð	'Ø×'Ò'Ñ)Ô)×6Ò6Ñ8Ô8ˆHØ69¸X°o°o˜8Ÿ>š>¨#Ñ.Ô.¨rÔ2Ð2È8ˆLØ )Ð:Ð:¨LÐ:Ð:ˆF�6‰NˆNøÝð 	'ð 	'ð 	'à&ˆF�6‰NˆNˆNð	'øøøð '�.Ô&Ð0Ð0¨Ð0Ð0ˆÝ�f—j’j Ñ(Ô(­4µ¨-Ñ8Ô8ð 	Ý  Ô&ˆFà�Ð]Ð]Ð]Ð]ÈGÏNÊNÑL\ÔL\Ð]Ñ]Ô]Ñ]Ô]Õ`cÐdkÑ`lÔ`lÑlØ˜Ÿš HÑ-Ô-ÐKÕ1AÀ(Ô1Kðð ð Ô#Ð#s   Á%AB7 Â7C	ÃC	Úresumez6Search space not provided, using default search space.rè   z'Data not provided, using default "data=z".)ÚcpuÚgpurí   éd   rì   r‘   é   )Ú	time_attrr’   r“   Úmax_trÁ   Úreduction_factorr   )r	  r’   r“   r
  r  Úexist_okF)rD   T)Úparentsr  zTuner: z Resuming tuning run z...)Ú	trainableÚresume_erroredc                ó$   — | j         › d| j        › �S ©Nr£   ©Útrainable_namerü   ©Útrials    r#   ú<lambda>zrun_ray_tune.<locals>.<lambda>ÿ  s   € °EÔ4HÐ1[Ð1[È5Ì>Ð1[Ð1[€ r%   c                ó$   — | j         › d| j        › �S r  r  r  s    r#   r  zrun_ray_tune.<locals>.<lambda>   s   € °uÔ7KÐ4^Ð4^ÈeÌnÐ4^Ð4^€ r%   )r@   Ú	schedulerÚnum_samplesÚtrial_name_creatorÚtrial_dirname_creator)Ústorage_pathrD   )Úparam_spaceÚtune_configÚ
run_config)*r
   Úinfor   rH   r  rÇ   Úray.tunerÈ   Úray.tune.schedulersrÉ   rÊ   r¶   r·   ÚuniformÚrandintrX   Úputrê   Úwarningr   r½   Úwith_resourcesr   r	   r   Úminr   r   r   ÚpopÚmkdirÚTunerÚcan_restorer   Úrestorer9   Ú
TuneConfigÚparentrD   ÚfitÚget_resultsÚshutdown)ÚmodelrL   rÁ   rÃ   rª   r@   r  rÈ   rÉ   rÊ   Údefault_spacer  rè   r¹   rº   Úresolved_search_alg_kindÚtrainable_with_resourcesr
  r  Útune_dirÚtunerrþ   rÿ   r   r  rX   rÇ   s         `               @@@@@r#   Úrun_ray_tuner9  \  sH  øøøøøø€ õB „KÐ`ÑaÔaÐaðnÝÔ! =°+Ð">ÐK`ÐJaÐbÑbÔbÐbàˆ
ˆ
ˆ
ØÐÐÐÐÐØ&Ð&Ð&Ð&Ð&Ð&ØGÐGÐGÐGÐGÐGÐGÐGÐGøÝð nð nð nÝ!Ð"lÑmÔmÐmðnøøøðàˆt�|Š|˜D $Ñ'Ô'ðð 	ˆt�|Š|˜D #Ñ&Ô&ðð 	�D—L’L  dÑ+Ô+ð	ð
 	˜Ÿš S¨%Ñ0Ô0ðð 	˜Ÿš c¨3Ñ/Ô/ðð 	˜4Ÿ<š<¨¨TÑ2Ô2ðð 	ˆt�|Š|˜C Ñ&Ô&ðð 	ˆt�|Š|˜C Ñ%Ô%ðð 	�$—,’,˜s CÑ(Ô(ðð 	ˆt�|Š|˜C Ñ&Ô&ðð 	�—’˜c 3Ñ'Ô'ðð 	�—’˜c 3Ñ'Ô'ðð 	�—’˜c 3Ñ'Ô'ðð 	�4—<’<  TÑ*Ô*ðð  	�T—\’\ # sÑ+Ô+ð!ð" 	�—’˜c 4Ñ(Ô(ð#ð$ 	�—’˜c 4Ñ(Ô(ð%ð& —|’| C¨Ñ/Ô/Ø—,’,˜s CÑ(Ô(Ø—,’,˜s CÑ(Ô(Ø�|Š|˜C Ñ%Ô%Ø—,’,˜s CÑ(Ô(Ø—’˜c 3Ñ'Ô'Ø—,’,˜s CÑ(Ô(Ø—l’l 3¨Ñ,Ô,ØŸš Q¨Ñ+Ô+ð7ð ð €Mð> Œ:€DØ—W’W˜U‘^”^€NØ—’˜v vÑ.Ô.€Ið$ð $ð $ð $ð $ð $ð $ð $ð $ð $ð6 ð UØˆØ�~Š~˜hÑ'Ô'ð 	UÝŒNÐSÑTÔTÐTð �>Š>˜&¥)¨D¤/Ñ2Ô2€DØ€Eˆ&�MØ�ZÐÐÝŒÐIÀÐIÐIÐIÑJÔJÐJåG^Ø�D˜% ñHô HÑDÐÐ*Ð,Dð
  $×2Ò2°5Å+ÐVcÐVhÐghÐ:iÐ:iÑjÔjÐð �NŠN˜8Ñ$Ô$ÐIÕ(8¸Ô(BÐIÀc€EØ�ØÝ˜4Ô ØØÝ˜ uÑ-Ô-Øðñ ô €Ið   6Ò)Ð)Ø$Ð$ØÝ˜tÔ$ØØØð
ñ 
ô 
ˆ	õ ÝÝØGˆzÐG˜: z§~¢~°hÀÑ'FÔ'FÐGÐGñ	
ô 	
ð �^Š^˜F FÑ+Ô+ðñ ô €Hð ‡N‚N˜4¨$€NÑ/Ô/Ð/Ø„z×Ò˜hÑ'Ô'ð 
ÝŒ•x 	Ñ*Ô*ÐNÐNÀÐNÐNÐNÑOÔOÐOØ”
×"Ò"¥3 x¡=¤=Ð<TÐeiÐ"ÑjÔjˆˆà—
’
Ø$Ø)ØŸšØ.Ø#Ø&Ø#[Ð#[Ø&^Ð&^ð (ñ ô ð !�y¨h¬oÀHÄMÐRÑRÔRð ñ 
ô 
ˆð 
‡I‚I�K„K€Kð ×ÒÑ!Ô!€Gð ‡L‚L�N„N€Nà€Ns   œ1A ÁA()r   r   )Nr¾   Nr¿   r   )rL   rÀ   rÁ   rÂ   rÃ   rÄ   rª   rÂ   )Ú
__future__r   Únumpyr0   Úultralytics.cfgr   r   r   r   Úultralytics.utilsr   r	   r
   r   r   r   rI   r   rE   rM   rY   r�   r•   r�   r¥   r«   r½   r9  r   r%   r#   ú<module>r>     s‰  ðð #Ð "Ð "Ð "Ð "Ð "à Ð Ð Ð à IÐ IÐ IÐ IÐ IÐ IÐ IÐ IÐ IÐ IÐ IÐ IØ bÐ bÐ bÐ bÐ bÐ bÐ bÐ bÐ bÐ bÐ bÐ bÐ bÐ bÐ bÐ bð Ø
Ø.Ø˜=Ð)ØØØØØð
ð 
Ð ðð ð ð ð,ð ð ð60ð 0ð 0ð&)ð )ð )ð66!ð 6!ð 6!ðrWð Wð Wð(eð eð eð('ð 'ð 'ð2ð ð ð.Rð Rð Rðn ØØ $ØØðrð rð rð rð rð rð rr%   