U 9%e7=@sddlZddlZddlmZddlZddlmZddlm Z ddl m Z m Z ddl mZmZmZmZddlmZmZdd lmZmZdd lmZmZd d d gZdd Zddddddd ZGdd d eeeZdS)N)Real) interpolate) spearmanr)'_inplace_contiguous_isotonic_regression _make_unique) BaseEstimatorRegressorMixinTransformerMixin _fit_context) check_arraycheck_consistent_length)Interval StrOptions)_check_sample_weightcheck_is_fittedcheck_increasingisotonic_regressionIsotonicRegressionc Cst||\}}|dk}|dkrt|dkrdtd|d|}dtt|d}t|d|}t|d|}t|t|krt d|S) aGDetermine whether y is monotonically correlated with x. y is found increasing or decreasing with respect to x based on a Spearman correlation test. Parameters ---------- x : array-like of shape (n_samples,) Training data. y : array-like of shape (n_samples,) Training target. Returns ------- increasing_bool : boolean Whether the relationship is increasing or decreasing. Notes ----- The Spearman correlation coefficient is estimated from the data, and the sign of the resulting estimate is used as the result. In the event that the 95% confidence interval based on Fisher transform spans zero, a warning is raised. References ---------- Fisher transformation. Wikipedia. https://en.wikipedia.org/wiki/Fisher_transformation r)g?g?rrg\(\?zwConfidence interval of the Spearman correlation coefficient spans zero. Determination of ``increasing`` may be suspect.) rlenmathlogsqrttanhnpsignwarningswarn) xyrho_Zincreasing_boolFZF_seZrho_0Zrho_1r%O/var/www/html/Darija-Ai-API/env/lib/python3.8/site-packages/sklearn/isotonic.pyrs"T sample_weighty_miny_max increasingcCs|rtjddntjddd}t|ddtjtjgd}tj|||jd}t|||jdd}t||}t |||dk s|dk r|dkrtj }|dkrtj }t ||||||S) a.Solve the isotonic regression model. Read more in the :ref:`User Guide `. Parameters ---------- y : array-like of shape (n_samples,) The data. sample_weight : array-like of shape (n_samples,), default=None Weights on each point of the regression. If None, weight is set to 1 (equal weights). y_min : float, default=None Lower bound on the lowest predicted value (the minimum value may still be higher). If not set, defaults to -inf. y_max : float, default=None Upper bound on the highest predicted value (the maximum may still be lower). If not set, defaults to +inf. increasing : bool, default=True Whether to compute ``y_`` is increasing (if set to True) or decreasing (if set to False). Returns ------- y_ : ndarray of shape (n_samples,) Isotonic fit of y. References ---------- "Active set algorithms for isotonic regression; A unifying framework" by Michael J. Best and Nilotpal Chakravarti, section 3. NFr!) ensure_2d input_namedtyper/T)r/copy) rZs_r float64float32arrayr/rZascontiguousarrayrinfclip)r!r(r)r*r+orderr%r%r&rRs&" cseZdZUdZeedddddgeedddddgdedhgeddd hgd Zee d <ddd dd d dZ ddZ ddZ d&ddZ ed dd'ddZddZddZddZd(ddZfd d!Zfd"d#Zd$d%ZZS))ra Isotonic regression model. Read more in the :ref:`User Guide `. .. versionadded:: 0.13 Parameters ---------- y_min : float, default=None Lower bound on the lowest predicted value (the minimum value may still be higher). If not set, defaults to -inf. y_max : float, default=None Upper bound on the highest predicted value (the maximum may still be lower). If not set, defaults to +inf. increasing : bool or 'auto', default=True Determines whether the predictions should be constrained to increase or decrease with `X`. 'auto' will decide based on the Spearman correlation estimate's sign. out_of_bounds : {'nan', 'clip', 'raise'}, default='nan' Handles how `X` values outside of the training domain are handled during prediction. - 'nan', predictions will be NaN. - 'clip', predictions will be set to the value corresponding to the nearest train interval endpoint. - 'raise', a `ValueError` is raised. Attributes ---------- X_min_ : float Minimum value of input array `X_` for left bound. X_max_ : float Maximum value of input array `X_` for right bound. X_thresholds_ : ndarray of shape (n_thresholds,) Unique ascending `X` values used to interpolate the y = f(X) monotonic function. .. versionadded:: 0.24 y_thresholds_ : ndarray of shape (n_thresholds,) De-duplicated `y` values suitable to interpolate the y = f(X) monotonic function. .. versionadded:: 0.24 f_ : function The stepwise interpolating function that covers the input domain ``X``. increasing_ : bool Inferred value for ``increasing``. See Also -------- sklearn.linear_model.LinearRegression : Ordinary least squares Linear Regression. sklearn.ensemble.HistGradientBoostingRegressor : Gradient boosting that is a non-parametric model accepting monotonicity constraints. isotonic_regression : Function to solve the isotonic regression model. Notes ----- Ties are broken using the secondary method from de Leeuw, 1977. References ---------- Isotonic Median Regression: A Linear Programming Approach Nilotpal Chakravarti Mathematics of Operations Research Vol. 14, No. 2 (May, 1989), pp. 303-308 Isotone Optimization in R : Pool-Adjacent-Violators Algorithm (PAVA) and Active Set Methods de Leeuw, Hornik, Mair Journal of Statistical Software 2009 Correctness of Kruskal's algorithms for monotone regression with ties de Leeuw, Psychometrica, 1977 Examples -------- >>> from sklearn.datasets import make_regression >>> from sklearn.isotonic import IsotonicRegression >>> X, y = make_regression(n_samples=10, n_features=1, random_state=41) >>> iso_reg = IsotonicRegression().fit(X, y) >>> iso_reg.predict([.1, .2]) array([1.8628..., 3.7256...]) NZboth)closedbooleanautonanr6raiser)r*r+ out_of_bounds_parameter_constraintsTcCs||_||_||_||_dSNr=)selfr)r*r+r>r%r%r&__init__szIsotonicRegression.__init__cCs2|jdks.|jdkr"|jddks.d}t|dS)NrzKIsotonic regression input X should be a 1d array or 2d array with 1 feature)ndimshape ValueError)rAXmsgr%r%r&_check_input_data_shapes"z*IsotonicRegression._check_input_data_shapecs>|jdk}tdkr&fdd|_ntj|d|d|_dS)zBuild the f_ interp1d function.r<rcs |jSr@)repeatrE)r r!r%r&z-IsotonicRegression._build_f..Zlinear)kind bounds_errorN)r>rf_rZinterp1d)rArGr!rOr%rKr&_build_fs  zIsotonicRegression._build_fc sV|||d}|jdkr,t|||_n|j|_t|||jd}|dk}||||||}}}t||ffdd|||fD\}}}t |||\}}}|}t |||j |j |jd}t |t||_|_|rJtjt|ftd} tt|dd|d d t|dd|d d | dd<|| || fS||fSd S) z Build the y_ IsotonicRegression.r,r:r0rcsg|] }|qSr%r%).0r4r7r%r& sz/IsotonicRegression._build_y..r'rNrC)rIreshaper+rZ increasing_rr/rZlexsortrrr)r*minmaxX_min_X_max_Zonesrbool logical_or not_equal) rArGr!r(Ztrim_duplicatesmaskZunique_XZunique_yZunique_sample_weightZ keep_datar%rSr&_build_ys8     zIsotonicRegression._build_y)Zprefer_skip_nested_validationcCs~tddd}t|fdtjtjgd|}t|fd|jd|}t|||||||\}}|||_|_ | |||S)aFit the model using X, y as training data. Parameters ---------- X : array-like of shape (n_samples,) or (n_samples, 1) Training data. .. versionchanged:: 0.24 Also accepts 2d array with 1 feature. y : array-like of shape (n_samples,) Training target. sample_weight : array-like of shape (n_samples,), default=None Weights. If set to None, all weights will be set to 1 (equal weights). Returns ------- self : object Returns an instance of self. Notes ----- X is stored for future use, as :meth:`transform` needs X to interpolate new input data. F)Z accept_sparser-rG)r.r/r!) dictr rr2r3r/r r_ X_thresholds_ y_thresholds_rQ)rArGr!r(Z check_paramsr%r%r&fit9s    zIsotonicRegression.fitcCsrt|dr|jj}ntj}t||dd}|||d}|jdkrXt ||j |j }| |}| |j}|S)a`_transform` is called by both `transform` and `predict` methods. Since `transform` is wrapped to output arrays of specific types (e.g. NumPy arrays, pandas DataFrame), we cannot make `predict` call `transform` directly. The above behaviour could be changed in the future, if we decide to output other type of arrays when calling `predict`. raF)r/r-r,r6)hasattrrar/rr2r rIrVr>r6rYrZrPZastype)rATr/resr%r%r& _transformks       zIsotonicRegression._transformcCs ||S)aTransform new data by linear interpolation. Parameters ---------- T : array-like of shape (n_samples,) or (n_samples, 1) Data to transform. .. versionchanged:: 0.24 Also accepts 2d array with 1 feature. Returns ------- y_pred : ndarray of shape (n_samples,) The transformed data. rgrArer%r%r& transformszIsotonicRegression.transformcCs ||S)a%Predict new data by linear interpolation. Parameters ---------- T : array-like of shape (n_samples,) or (n_samples, 1) Data to transform. Returns ------- y_pred : ndarray of shape (n_samples,) Transformed data. rhrir%r%r&predicts zIsotonicRegression.predictcCs,t|d|jj}tj|dgtdS)aKGet output feature names for transformation. Parameters ---------- input_features : array-like of str or None, default=None Ignored. Returns ------- feature_names_out : ndarray of str objects An ndarray with one string i.e. ["isotonicregression0"]. rP0r0)r __class____name__lowerrZasarrayobject)rAZinput_features class_namer%r%r&get_feature_names_outs  z(IsotonicRegression.get_feature_names_outcst}|dd|S)z0Pickle-protocol - return state of the estimator.rPN)super __getstate__poprAstatermr%r&rts  zIsotonicRegression.__getstate__cs4t|t|dr0t|dr0||j|jdS)znPickle-protocol - set state of the estimator. We need to rebuild the interpolation function. rarbN)rs __setstate__rdrQrarbrvrxr%r&rys zIsotonicRegression.__setstate__cCs ddgiS)NZX_typesZ1darrayr%)rAr%r%r& _more_tagsszIsotonicRegression._more_tags)T)N)N)rn __module__ __qualname____doc__rrrr?r`__annotations__rBrIrQr_r rcrgrjrkrrrtryrz __classcell__r%r%rxr&rs& ^  1 1   )rrnumbersrnumpyrZscipyrZ scipy.statsrZ _isotonicrrbaserr r r utilsr r Zutils._param_validationrrZutils.validationrr__all__rrrr%r%r%r&s$    < 7