-ji.SSKJr SSKrSSKJr SSKrSSKJr SSKJ r SSKJ r SSKJ r "SS 5r S S jr SS jrSS jrg)) annotationsN)Any)BaseDistribution)CategoricalDistribution)FloatDistribution)IntDistributionc\rSrSrSrS S Sjjr\S Sj5r\SSj5r\S Sj5r SSjr SSjr S r g )_SearchSpaceTransformaTransform a search space and parameter configurations to continuous space. The search space bounds and parameter configurations are represented as ``numpy.ndarray``s and transformed into continuous space. Bounds and parameters associated with categorical distributions are one-hot encoded. Parameter configurations in this space can additionally be untransformed, or mapped back to the original space. This type of transformation/untransformation is useful for e.g. implementing samplers without having to condition on distribution types before sampling parameter values. Args: search_space: The search space. If any transformations are to be applied, parameter configurations are assumed to hold parameter values for all of the distributions defined in this search space. Otherwise, assertion failures will be raised. transform_log: If :obj:`True`, apply log/exp operations to the bounds and parameters with corresponding distributions in log space during transformation/untransformation. Should always be :obj:`True` if any parameters are going to be sampled from the transformed space. transform_step: If :obj:`True`, offset the lower and higher bounds by a half step each, increasing the space by one step. This allows fair sampling for values close to the bounds. Should always be :obj:`True` if any parameters are going to be sampled from the transformed space. transform_0_1: If :obj:`True`, apply a linear transformation to the bounds and parameters so that they are in the unit cube. Attributes: bounds: Constructed bounds from the given search space. column_to_encoded_columns: Constructed mapping from original parameter column index to encoded column indices. encoded_column_to_column: Constructed mapping from encoded column index to original parameter column index. Note: Parameter values are not scaled to the unit cube. Note: ``transform_log`` and ``transform_step`` are useful for constructing bounds and parameters without any actual transformations by setting those arguments to :obj:`False`. This is needed for e.g. the hyperparameter importance assessments. cj[XU5upVnXPlX`lXplXlX lX@lgN)_transform_search_space _raw_bounds_column_to_encoded_columns_encoded_column_to_column _search_space_transform_log_transform_0_1)self search_space transform_logtransform_step transform_0_1boundscolumn_to_encoded_columnsencoded_column_to_columns K/home/james-whalen/.local/lib/python3.13/site-packages/optuna/_transform.py__init___SearchSpaceTransform.__init__=sBG^ G C+C"*C')A&)++cUR(a3[R"SS//URRS-5$UR$)Ng?r)rnparrayrshapers rr_SearchSpaceTransform.boundsNsB   88c3ZL4+;+;+A+A!+DDE E## #r cUR$r )rr&s rr/_SearchSpaceTransform.column_to_encoded_columnsUs...r cUR$r )rr&s rr._SearchSpaceTransform.encoded_column_to_columnYs---r c[R"URRS[RS9nSnUR R 5HupEXA;dS5eXn[U[5(a;[URU55nSX#U-'U[UR5- nMe[XeUR5X#'US- nM UR(alURSS2S4URSS2S4:HnSX('X()URU)S4- URU)S4URU)S4- - X()'U$)zTransform a parameter configuration from actual values to continuous space. Args: params: A parameter configuration to transform. Returns: A 1-dimensional ``numpy.ndarray`` holding the transformed parameters in the configuration. rdtypez7Parameter configuration must contain all distributions.N?)r#zerosrr%float64ritems isinstancerintto_internal_reprlenchoices_transform_numerical_paramrr) rparams trans_params bound_idxname distributionparam choice_idx single_masks r transform_SearchSpaceTransform.transform]sbxx 0 0 6 6q 9L  "&"4"4":":"< D> \#\ \>LE,(?@@ !>!>u!EF 78 34S!5!566 *D)<)<+ 'Q #=   **1a40D4D4DQT4JJK(+L %\*T-=-={lAo-NN!!;,/2T5E5E{lTUo5VV*XL &r c2URURRS4:XdeUR(a>URSS2S4UURSS2S4URSS2S4- --n0n[URR 5UR 5Hiuup4nXn[U[5(a URUR55nO$[UR5X@R5nXrU'Mk U$)apUntransform a parameter configuration from continuous space to actual values. Args: trans_params: A 1-dimensional ``numpy.ndarray`` in the transformed space corresponding to a parameter configuration. Returns: A dictionary of an untransformed parameter configuration. Keys are parameter names. Values are untransformed parameter values. rNr/)r%rrziprr3rr4rto_external_reprargmax_untransform_numerical_paramitemr)rr;r:r=r>encoded_columns trans_paramr?s r untransform!_SearchSpaceTransform.untransforms!!d&6&6&<&*_transform_search_space..s1&A%Q(?@@AIIaG&s9;r-)rr/r0r"*Should not reach. Unexpected distribution.r/)r7sumvaluesr#emptyr2int64r4rr8arangeappendrrstepr9lowhighlog atleast_1d)rrrn_boundsrrrr<r>r_ n_choicesrJ half_stepbdsencoded_columns rrrs{ | q S"SS $$&H XXxm2:: 6F24!xxAI$++-  a0 1 1AIII8>Fy4 5 ii y3HIO8;aff CI2155!KiW21661LyXC 3155!K21661LCA//,:C!&&L 55215593DaW2166I3EqXC 3155!KiW21661LyXC KJJu #9 ]]95N7:;T7U $ 4 % , ,^ < NI FF F5c.f   .F FFr cUn[U[5(aS5e[U[5(aIUR(a*U(a[R"U5O [ U5nU$[ U5nU$[U[ 5(aIUR(a*U(a[R"U5O [ U5nU$[ U5nU$S5e)N,Should not reach. Should be one-hot encoded.rc)r4rrrmmathfloatr)r?r>rr_rKs rr9r9s A!,--DDDu A( ) ) 55-:$((5/e K  ,K  A ' ' 55-:$((5/e K   ,K  CBBur c pUn[U[5(aS5e[U[5(GabUR(arU(a[R "U5OUnUR 5(aU$[U[R"URURS- 55nU$URb~[[R"[R"XR- UR- 5UR-UR-URUR55nU$UR 5(aUnU$[U[R"URURS- 55nU$[U[ 5(GaUR(atU(a_[#[R"[R"[R "U55URUR55nU$[#U5nU$[#[R"[R"XR- UR- 5UR-UR-URUR55nU$S5e)Nrur/rc)r4rrrmrvexpsingleminr# nextafterrlrjrwcliproundrkrr5)rKr>rr_r?s rrHrH s A!,--DDDu A( ) ) 55-:DHH[) Exxzz2 L/E2<< #CD. L-VV +"5!?@166IAEEQSTSXSXZ[Z`Z`aE* L#xxzz# LKaffaffqj)IJ L A ' ' 55BGGBHHTXXk-B$CQUUAFFST LK( L +"5!?@166IAEEQSTSXSXZ[Z`Z`aE L CBBur )rrNrrOrrOrPz/tuple[np.ndarray, list[np.ndarray], np.ndarray])r? int | floatr>rrrOrPrw)rKrwr>rrrOrPr) __future__rrvtypingrnumpyr#optuna.distributionsrrrrr rr9rHr[r rrs" 1820ZZzDG-DG>BDGTXDG4DGN &6GK .$$&6$GK$$r