-ioSSKrSSKrSSKrSSKrSSKJrJr SSKJr SSK J r SSK J r J r SSKrSSKJrJr SSKJrJr S S KJr "S S \\5rS rSrSr"SS\ 5r\R?\ 5 Sr!"SS\5r""SS\"5r#"SS\"5r$"SS\"5r%"SS\"5r&"SS\"5r'"SS \'5r("S!S"\"5r)"S#S$\"5r*"S%S&\"5r+"S'S(\"5r,"S)S*\"5r-"S+S,\"5r."S-S.\"5r/"S/S0\"5r0"S1S2\"5r1"S3S4\"5r2"S5S6\"5r3"S7S85r4S9r5S:r6g);N)ABCabstractmethod)Iterable) signature)IntegralReal) csr_matrixissparse)config_context get_config_is_arraylike_not_scalarc\rSrSrSrSrg)InvalidParameterErrorzqCustom exception to be raised when the parameter of a class/method/function does not have a valid type or value. N__name__ __module__ __qualname____firstlineno____doc____static_attributes__rR/var/www/html/venv/lib/python3.13/site-packages/sklearn/utils/_param_validation.pyrrsrrc UR5Hup4X0;aM XnUS:XaMUVs/sHn[U5PM nnUHnURU5(dM MS UVs/sHofR(aMUPM nn[ U5S:XaUSnO6SR USSVs/sHn[ U5PM sn5SUS3n[SU<S US US U<S 3 5e gs snfs snfs snf) aLValidate types and values of given parameters. Parameters ---------- parameter_constraints : dict or {"no_validation"} If "no_validation", validation is skipped for this parameter. If a dict, it must be a dictionary `param_name: list of constraints`. A parameter is valid if it satisfies one of the constraints from the list. Constraints can be: - an Interval object, representing a continuous or discrete range of numbers - the string "array-like" - the string "sparse matrix" - the string "random_state" - callable - None, meaning that None is a valid value for the parameter - any type, meaning that any instance of this type is valid - an Options object, representing a set of elements of a given type - a StrOptions object, representing a set of strings - the string "boolean" - the string "verbose" - the string "cv_object" - the string "nan" - a MissingValues object representing markers for missing values - a HasMethods object, representing method(s) an object must have - a Hidden object, representing a constraint not meant to be exposed to the user params : dict A dictionary `param_name: param_value`. The parameters to validate against the constraints. caller_name : str The name of the estimator or function or method that called this function. no_validationrr, N or zThe z parameter of z must be z. Got instead.)itemsmake_constraintis_satisfied_byhiddenlenjoinstrr) parameter_constraintsparams caller_name param_name param_val constraints constraintconstraints_strcs rvalidate_parameter_constraintsr4s;F"(   2 +7 / ) EPQ[zz2[ Q%J)))44&.9-8z@Q@Q [ ;1$%0^$4yy+cr2B!C2BQ#a&2B!CDEF#B(* (znN;-@#$F9-yB G"0R"DsC3*C8C82C= c[U[5(aUS:Xa [5$[U[5(aUS:Xa [5$[U[5(aUS:Xa [ 5$U[ La [ 5$Uc [5$[U[5(a [U5$[U[[[[[45(aU$[U[5(aUS:Xa [5$[U[5(aUS:Xa [!5$[U[5(aUS:Xa [#5$[U[$5(a['UR(5nSUlU$[U[5(aUS:Xd0[U[,5(a%[.R0"U5(a [35$[5S U35e) zConvert the constraint into the appropriate Constraint object. Parameters ---------- constraint : object The constraint to convert. Returns ------- constraint : instance of _Constraint The converted constraint. z array-likez sparse matrix random_statebooleanverbose cv_objectTnanUnknown constraint type: ) isinstancer* _ArrayLikes_SparseMatrices _RandomStatescallable _Callables_NoneConstrainttype _InstancesOfInterval StrOptionsOptions HasMethods MissingValues _Booleans_VerboseHelper _CVObjectsHiddenr%r1r'floatnpisnan_NanConstraint ValueErrorr1s rr%r%hs*c""z\'A}*c""z_'D  *c""z^'CX|  *d##J''Xz7J N*c""zY'>{*c""zY'>*c""z['@|*f%%$Z%:%:;  :s## e(;:u%%"((:*>*> 0 = >>rc^^UU4SjnU$)avDecorator to validate types and values of functions and methods. Parameters ---------- parameter_constraints : dict A dictionary `param_name: list of constraints`. See the docstring of `validate_parameter_constraints` for a description of the accepted constraints. Note that the *args and **kwargs parameters are not validated and must not be present in the parameter_constraints dictionary. prefer_skip_nested_validation : bool If True, the validation of parameters of inner estimators or functions called by the decorated function will be skipped. This is useful to avoid validating many times the parameters passed by the user from the public facing API. It's also useful to avoid validating parameters that we pass internally to inner functions that are guaranteed to be valid by the test suite. It should be set to True for most functions, except for those that receive non-validated objects as parameters or that are just wrappers around classes because they only perform a partial validation. Returns ------- decorated_function : function or method The decorated function. cf>^[TST5 [R"T5UUU4Sj5nU$)N_skl_parameter_constraintsc >[5SnU(aT "U0UD6$[T 5nUR"U0UD6nUR5 URR 5Vs/sH7nUR URUR4;dM+URPM9 nnUSS/- nURR5VVs0sHupxXv;dM Xx_M nnn[T UT RS9 [T =(d US9 T "U0UD6sSSS5 $s snfs snnf!,(df  g=f![a@n [ R""SST RS3[%U 55n [U 5U eSn A ff=f) Nskip_parameter_validationselfcls)r-)rXzparameter of \w+ must bez parameter of z must be)r rbindapply_defaults parametersvalueskindVAR_POSITIONAL VAR_KEYWORDname argumentsr$r4rr rresubr*)argskwargsglobal_skip_validationfunc_sigr,p to_ignorekvemsgfuncr+prefer_skip_nested_validations rwrapper3validate_params..decorator..wrappers%/\2M%N "%T,V,, H]]D3F3F  ! ! # ",,3355A66a.. >>5  &% (I'-'7'7'='='?V'?tq1CUdad'?FV *%v4;L;L  8#5O9O  00  W ) 8 ff/#D$5$5#6h?F ,C0a7 8sN'*DD D"D"9D9 D( D9( D62D96D99 F;E>>F)setattr functoolswraps)rprrr+rqs` r decorator"validate_params..decorators6 24IJ  ) 8 ) 8Vrr)r+rqrws`` rvalidate_paramsrys>2h rc\rSrSrSrSrg) RealNotIntzA type that represents reals that are not instances of int. Behaves like float, but also works with values extracted from numpy arrays. isintance(1, RealNotInt) -> False isinstance(1.0, RealNotInt) -> True rNrrrrr{r{srr{c|URnURnUS:XaU$U[:XagU[:XagUSU3$)z(Convert type into human readable string.builtinsrNint.)rrrr)tmodulequalnames r _type_namersF \\F~~H  d hXQxj !!rc>\rSrSrSrSr\S5r\S5rSr g) _Constraintiz&Base class for the constraint objects.cSUlgNFr'rYs r__init___Constraint.__init__s  rcg)zWhether or not a value satisfies the constraint. Parameters ---------- val : object The value to check. Returns ------- is_satisfied : bool Whether or not the constraint is satisfied by this value. NrrYvals rr&_Constraint.is_satisfied_by rcg)z;A human readable representational string of the constraint.Nrrs r__str___Constraint.__str__rrrN) rrrrrrrr&rrrrrrrs40    JJrrc8^\rSrSrSrU4SjrSrSrSrU=r $)rDizjConstraint representing instances of a given type. Parameters ---------- type : type The valid type. c.>[TU]5 XlgN)superrrC)rYrC __class__s rr_InstancesOf.__init__(s  rc,[XR5$rr<rCrs rr&_InstancesOf.is_satisfied_by,s#yy))rc4S[UR5<3$)Nzan instance of )rrCrs rr_InstancesOf.__str__/s DII!6 9::r)rC rrrrrrr&rr __classcell__rs@rrDrDs*;;rrDc$\rSrSrSrSrSrSrg)rBi3z+Constraint representing the None singleton.c USL$rrrs rr&_NoneConstraint.is_satisfied_by6s d{rcg)NNonerrs rr_NoneConstraint.__str__9srrNrrrrrr&rrrrrrBrB3s5rrBc$\rSrSrSrSrSrSrg)rQi=z/Constraint representing the indicator `np.nan`.c[U[5(+=(a- [U[5=(a [R"U5$r)r<rrmathrPrs rr&_NanConstraint.is_satisfied_by@s.3) ) Wjd.C W SV rcg)Nz numpy.nanrrs rr_NanConstraint.__str__ErrNrrrrrQrQ=s9 rrQc$\rSrSrSrSrSrSrg)_PandasNAConstraintiIz.Constraint representing the indicator `pd.NA`.cSSKn[U[UR55=(a UR U5$![ a gf=f)NrF)pandasr<rCNAisna ImportError)rYrpds rr&#_PandasNAConstraint.is_satisfied_byLs>  c4;/@BGGCL @  s:= A  A cg)Nz pandas.NArrs rr_PandasNAConstraint.__str__TrrrNrrrrrrIs8rrcF^\rSrSrSrSS.U4SjjrSrSrSrS r U=r $) rGiXa#Constraint representing a finite set of instances of a given type. Parameters ---------- type : type options : set The set of valid scalars. deprecated : set or None, default=None A subset of the `options` to mark as deprecated in the string representation of the constraint. N deprecatedc>[TU]5 XlX lU=(d [ 5UlUR UR- (a [ S5eg)Nz7The deprecated options must be a subset of the options.)rrrCoptionssetrrR)rYrCrrrs rrOptions.__init__gsG   $- ??T\\ )VW W *rcV[XR5=(a XR;$r)r<rCrrs rr&Options.is_satisfied_byps#yy)Ac\\.AArc6U<nXR;aUS3nU$)z-Add a deprecated mark to an option if needed.z (deprecated)r)rYoption option_strs r_mark_if_deprecatedOptions._mark_if_deprecatedss%z __ $&<}5JrcSRURVs/sHoRU5PM sn5nS[UR5SUS3$s snf)Nr za z among {})r)rrrrC)rYo options_strs rrOptions.__str__zsYyyt||L|!2215|LMN Jtyy)*)K=CCMsA)rrrC) rrrrrrr&rrrrrs@rrGrGXs0 59XXBDDrrGc4^\rSrSrSrSS.U4SjjrSrU=r$)rFiaConstraint representing a finite set of strings. Parameters ---------- options : set of str The set of valid strings. deprecated : set of str or None, default=None A subset of the `options` to mark as deprecated in the string representation of the constraint. Nrc*>[TU][XS9 g)N)rCrr)rrr*)rYrrrs rrStrOptions.__init__s c7Jrr)rrrrrrrrrs@rrFrFs /3KKrrFcD^\rSrSrSrU4SjrSrSrSrSr Sr U=r $) rEiuConstraint representing a typed interval. Parameters ---------- type : {numbers.Integral, numbers.Real, RealNotInt} The set of numbers in which to set the interval. If RealNotInt, only reals that don't have the integer type are allowed. For example 1.0 is allowed but 1 is not. left : float or int or None The left bound of the interval. None means left bound is -∞. right : float, int or None The right bound of the interval. None means right bound is +∞. closed : {"left", "right", "both", "neither"} Whether the interval is open or closed. Possible choices are: - `"left"`: the interval is closed on the left and open on the right. It is equivalent to the interval `[ left, right )`. - `"right"`: the interval is closed on the right and open on the left. It is equivalent to the interval `( left, right ]`. - `"both"`: the interval is closed. It is equivalent to the interval `[ left, right ]`. - `"neither"`: the interval is open. It is equivalent to the interval `( left, right )`. Notes ----- Setting a bound to `None` and setting the interval closed is valid. For instance, strictly speaking, `Interval(Real, 0, None, closed="both")` corresponds to `[0, +∞) U {+∞}`. cr>[TU]5 XlX lX0lX@lUR 5 gr)rrrCleftrightclosed _check_params)rYrCrrrrs rrInterval.__init__s.      rcLUR[[[4;a[ SURS35eUR S;a[ SUR S35eUR[LaSnUR b-[UR [5(d[SU35eURb-[UR[5(d[SU35eUR c+UR S;a[ S UR S U35eURc+UR S ;a[ S UR S U35eOnUR b*[UR [5(d [S 5eURb*[UR[5(d [S5eURbNUR b@URUR ::a%[ SUR SUR35eggg)NzFtype must be either numbers.Integral, numbers.Real or RealNotInt. Got r#)rrbothneitherz@closed must be either 'left', 'right', 'both' or 'neither'. Got z"for an interval over the integers.zExpecting left to be an int zExpecting right to be an int rrz"left can't be None when closed ==  rrz#right can't be None when closed == z#Expecting left to be a real number.z$Expecting right to be a real number.z(right can't be less than left. Got left=z and right=) rCrrr{rRrrr< TypeErrorr)rYsuffixs rrInterval._check_paramss 99XtZ8 8 {)-  ;;B B{{m9.  99 9Fyy$Z 8-L-L">vh GHHzz%jX.N.N"?x HIIyy T[[4D%D 8 QvhOzz!dkk5F&F 9$++axPyy$Z 4-H-H EFFzz%jT.J.J FGG :: !dii&; dii@W:499+F & AX&; !rc[U[5(d[R"U5(agURS;a[ R O[ RnURS;a[ RO[ RnURc[R*O URnURc[RO URnU"X5(agU"X5(agg)NFrrT) r<rrOrProperatorltlegtgerinfr)rYrleft_cmp right_cmprrs r __contains__Interval.__contains__s#x((RXXc]]"&++1A"A8;;x{{#';;2C#CHKK ))+w**,$** C   S rc@[XR5(dgX;$rrrs rr&Interval.is_satisfied_bys#yy)){rcUR[LaSOSnURS;aSOSnURcSO URnURcSO URnURS;aS OS nUR[:Xd*[ UR[ 5(a [U5nUR[:Xd*[ UR[ 5(a [U5nUS UUS UU3$) Nzan intza floatr[(z-infrr])z in the range r )rCrrrrr<rrN)rYtype_str left_bracket left_bound right_bound right_brackets rrInterval.__str__s#yyH48)"kk-==s3 #yy0Vdii #zz1etzz #{{.??S yyH$DIIt)D)Dz*JyyH$DJJ)E)E ,KjnZL;-  H r)rrrrC) rrrrrrrrr&rrrrs@rrErEs(!F%N    rrEc$\rSrSrSrSrSrSrg)r=iz#Constraint representing array-likesc[U5$rrrs rr&_ArrayLikes.is_satisfied_bys ',,rcg)Nz an array-likerrs rr_ArrayLikes.__str__srrNrrrrr=r=s--rr=c$\rSrSrSrSrSrSrg)r>iz(Constraint representing sparse matrices.c[U5$r)r rs rr&_SparseMatrices.is_satisfied_by }rcg)Nza sparse matrixrrs rr_SparseMatrices.__str__s rrNrrrrr>r>s2!rr>c$\rSrSrSrSrSrSrg)rAi#z"Constraint representing callables.c[U5$r)r@rs rr&_Callables.is_satisfied_by&rrcg)Nz a callablerrs rr_Callables.__str__)srrNrrrrrArA#s,rrAc8^\rSrSrSrU4SjrSrSrSrU=r $)r?i-zConstraint representing random states. Convenience class for [Interval(Integral, 0, 2**32 - 1, closed="both"), np.random.RandomState, None] c>[TU]5 [[SSSS9[ [ R R5[5/Ul g)Nrlrr) rrrErrDrOrandom RandomStaterB _constraintsrYrs rr_RandomStates.__init__4s>  Xq)F ; .. /   rcB^[U4SjUR55$)Nc3D># UHoRT5v M g7frr&.0r3rs r 0_RandomStates.is_satisfied_by..=E3Da$$S))3D anyrrs `rr&_RandomStates.is_satisfied_by<E43D3DEEErcSRURSSVs/sHn[U5PM sn5SURS3$s snfNr r!r"r)rr*rYr3s rr_RandomStates.__str__?Wyy$*;*;CR*@A*@Q#a&*@ABCD!!"%& ( AA rrrs@rr?r?-  F  rr?c8^\rSrSrSrU4SjrSrSrSrU=r $)rJiFzOConstraint representing boolean likes. Convenience class for [bool, np.bool_] c|>[TU]5 [[5[[R 5/Ulgr)rrrDboolrObool_rrs rr_Booleans.__init__Ms,     " rcB^[U4SjUR55$)Nc3D># UHoRT5v M g7frrrs rr,_Booleans.is_satisfied_by..Urrrrs `rr&_Booleans.is_satisfied_byTrrcSRURSSVs/sHn[U5PM sn5SURS3$s snfr r!r"s rr_Booleans.__str__Wr$r%r&rrs@rrJrJFs  F  rrJc8^\rSrSrSrU4SjrSrSrSrU=r $)rKi^zHelper constraint for the verbose parameter. Convenience class for [Interval(Integral, 0, None, closed="left"), bool, numpy.bool_] c>[TU]5 [[SSSS9[ [ 5[ [ R5/Ulg)Nrrr ) rrrErrDr*rOr+rrs rr_VerboseHelper.__init__es:  Xq$v 6    " rcB^[U4SjUR55$)Nc3D># UHoRT5v M g7frrrs rr1_VerboseHelper.is_satisfied_by..nrrrrs `rr&_VerboseHelper.is_satisfied_bymrrcSRURSSVs/sHn[U5PM sn5SURS3$s snfr r!r"s rr_VerboseHelper.__str__pr$r%r&rrs@rrKrK^r'rrKc<^\rSrSrSrSU4SjjrSrSrSrU=r $)rIiwaHelper constraint for the `missing_values` parameters. Convenience for [ Integral, Interval(Real, None, None, closed="both"), str, # when numeric_only is False None, # when numeric_only is False _NanConstraint(), _PandasNAConstraint(), ] Parameters ---------- numeric_only : bool, default=False Whether to consider only numeric missing value markers. c">[TU]5 Xl[[5[ [ SSSS9[5[5/Ul UR(d3URR[[5[5/5 gg)Nrr ) rr numeric_onlyrDrrErrQrrextendr*rB)rYr>rs rrMissingValues.__init__ss (  " T4f 5    !       $ $l3&79J%K L!rcB^[U4SjUR55$)Nc3D># UHoRT5v M g7frrrs rr0MissingValues.is_satisfied_by..rrrrs `rr&MissingValues.is_satisfied_byrrcSRURSSVs/sHn[U5PM sn5SURS3$s snfr r!r"s rrMissingValues.__str__r$r%)rr>)Frrs@rrIrIws& MF  rrIcT^\rSrSrSr\"S\\/0SS9U4Sj5rSr Sr S r U=r $) rHia-Constraint representing objects that expose specific methods. It is useful for parameters following a protocol and where we don't want to impose an affiliation to a specific module or class. Parameters ---------- methods : str or list of str The method(s) that the object is expected to expose. methodsT)rqc^>[TU]5 [U[5(aU/nXlgr)rrr<r*rH)rYrHrs rrHasMethods.__init__s)  gs # #iG rcB^[U4SjUR55$)Nc3P># UHn[[TUS55v M g7fr)r@getattr)rmethodrs rr-HasMethods.is_satisfied_by..s"SlF8GC677ls#&)allrHrs `rr&HasMethods.is_satisfied_bysSdllSSSrc[UR5S:XaURS<nOKSRURSSVs/sHn[U5PM sn5SURS<3nSU3$s snf)Nrrr r!z and zan object implementing )r(rHr)repr)rYrHms rrHasMethods.__str__s t||  !a+G99t||CR/@A/@!d1g/@ABCDLL$') ) 22BsA<)rH) rrrrrryr*listrr&rrrrs@rrHrHs@  S$K &*  T33rrHc$\rSrSrSrSrSrSrg)_IterablesNotStringiz7Constraint representing iterables that are not strings.cZ[U[5=(a [U[5(+$r)r<rr*rs rr&#_IterablesNotString.is_satisfied_bys#x(EC1E-EErcg)Nz an iterablerrs rr_IterablesNotString.__str__srrNrrrrrXrXsAFrrXc8^\rSrSrSrU4SjrSrSrSrU=r $)rLizConstraint representing cv objects. Convenient class for [ Interval(Integral, 2, None, closed="left"), HasMethods(["split", "get_n_splits"]), _IterablesNotString(), None, ] c>[TU]5 [[SSSS9[ SS/5[ 5[ 5/Ulg)Nr rr split get_n_splits)rrrErrHrXrBrrs rr_CVObjects.__init__s?  Xq$v 6 0 1  !    rcB^[U4SjUR55$)Nc3D># UHoRT5v M g7frrrs rr-_CVObjects.is_satisfied_by..rrrrs `rr&_CVObjects.is_satisfied_byrrcSRURSSVs/sHn[U5PM sn5SURS3$s snfr r!r"s rr_CVObjects.__str__r$r%r&rrs@rrLrLs  F  rrLc\rSrSrSrSrSrg)rMizClass encapsulating a constraint not meant to be exposed to the user. Parameters ---------- constraint : str or _Constraint instance The constraint to be used internally. cXlgrrS)rYr1s rrHidden.__init__s$rrSN)rrrrrrrrrrrMrMs %rrMc[U[5(aSSRUR53$[U[5(a[ R "/SQ5$[U[5(ag[U[5(a[SS05"5$[U[5(ag[U[5(ag[U[5(aQUR[La>URbURS - $URbURS -$[ e[U[5(aUR["[$4;aURbURS - $URbURS -$UR&S ;a[ R(*$UR&S ;a[ R($[ R*$[ e) ahReturn a value that does not satisfy the constraint. Raises a NotImplementedError if there exists no invalid value for this constraint. This is only useful for testing purpose. Parameters ---------- constraint : _Constraint instance The constraint to generate a value for. Returns ------- val : object A value that does not satisfy the constraint. znot r"rr r! HasNotMethodsrza stringznot a cv objectrgư>)rr)rr)r<rFr)rrIrOarrayrKrHrCrXrLrErrrNotImplementedErrorrr{rrr:rSs rgenerate_invalid_param_valrqs"*j))fkk*"4"45677*m,,xx ""*n--*j))OR,..*122*j)) *h''JOOx,G ?? &??Q& &    '##a' '"!*h''JOOj?Q,Q ?? &??T) )    '##d* *    4 4FF7N    3 366Mvv rc [U[5(a[R"/SQ5$[U[5(a[ SS/SS//5$[U[ 5(a[RRS5$[U[5(aS$[U[5(ag[U[5(a`UR[RLa[R"/SQ5$UR[[4;agUR5$[U[ 5(ag[U["5(ag[U[$5(a!UR&(a[R($[U[$5(aUR&(dg[U[*5(a.[S S UR,Vs0sHoS _M sn5"5$[U[.5(a/SQ$[U[05(ag [U[25(aUR4HnUs $ [U[65(aUnUR8cUR:cgUR8cUR:S- $UR:cUR8S-$UR[LaUR8UR:-S - $UR8S-$[=SU35es snf)a Return a value that does satisfy a constraint. This is only useful for testing purpose. Parameters ---------- constraint : Constraint instance The constraint to generate a value for. Returns ------- val : object A value that does satisfy the constraint. rlrr*cU$rr)xs r&generate_valid_param..UsrNTmissingValidHasMethodsrcgrrrs rrvrwssDrr r;)r<r=rOror>r r?r rrArBrDrCndarrayrrrJrKrIr>r:rHrHrXrLrGrrErrrR)r1rTrintervals rgenerate_valid_paramr~<s^*k**xx ""*o..Aq6Aq6*++*m,,yy$$R((*j))*o..*l++ ??bjj (88I& & ??x. .  *i((*n--*m,,1H1Hvv *m,,Z5L5L*j)) r*BTBT#UBTQ'8$8BT#U   *122*j))*g&& ((FM)*h'' == X^^%; ]] ">>A% % ^^ #==1$ $}}$ 6!;;}}q(( 0 = >>7$Vs L )7rurrrdabcrrcollections.abcrinspectrnumbersrrnumpyrO scipy.sparser r _configr r validationrrRrrr4r%ryr{registerrNrrrDrBrQrrGrFrEr=r>rAr?rJrKrIrHrXrLrMrqr~rrrrsh  #$"-00J IX+?\Sl E "J#J4;;;(k [  + &Dk&DRKK"z {z z+!k! K 2  0 [ 2* K* Z!3!3H+  > % %;|R?r