KidZddlmZmZddlZddlZddlm Z ddl m Z ddl m Z ddlmZddlmZGd d e e ZdS) zuRegressor utilities for MySQL Connector/Python. Provides a scikit-learn compatible regressor backed by HeatWave ML. )OptionalUnionN)RegressorMixin) MyBaseMLModel)ML_TASK) copy_dict)MySQLConnectionAbstractc eZdZdZ d dedeedeedeedeef dZd e e j e j fd e j fd Zd e e j e j fd e j fd ZdS) MyRegressora MySQL HeatWave scikit-learn compatible regressor estimator. Provides prediction output from a regression model deployed in MySQL, and manages fit, explain, and prediction options as per HeatWave ML interface. Attributes: predict_extra_options (dict): Optional parameter dict passed to the backend for prediction. _model (MyModel): Underlying interface for database model operations. fit_extra_options (dict): See MyBaseMLModel. explain_extra_options (dict): See MyBaseMLModel. Args: db_connection (MySQLConnectionAbstract): Active MySQL connector DB connection. model_name (str, optional): Custom name for the model. fit_extra_options (dict, optional): Extra options for fitting. explain_extra_options (dict, optional): Extra options for explanations. predict_extra_options (dict, optional): Extra options for predictions. Methods: predict(X): Predict regression target. N db_connection model_namefit_extra_optionsexplain_extra_optionspredict_extra_optionsctj||tj||t ||_t ||_dS)a  Initialize a MyRegressor. Args: db_connection: Active MySQL connector database connection. model_name: Optional, custom model name. fit_extra_options: Optional fit options. explain_extra_options: Optional explain options. predict_extra_options: Optional prediction options. Raises: DatabaseError: If a database connection issue occurs. If an operational error occurs during execution. )r rN)r__init__r REGRESSIONrrr)selfr r rrrs Q/var/www/html/analyses/venv/lib/python3.11/site-packages/mysql/ai/ml/regressor.pyrzMyRegressor.__init__FsZ.     !/     &//D%E%E"%./D%E%E"""Xreturncx|j||j}|dS)aZ Predict a continuous target for the input features using the MySQL model. Args: X: Input samples as a numpy array or pandas DataFrame. Returns: ndarray: Array of predicted target values, shape (n_samples,). Raises: DatabaseError: If provided options are invalid or unsupported, or if the model is not initialized, i.e., fit or import has not been called If a database connection issue occurs. If an operational error occurs during execution. options Prediction)_modelpredictrto_numpy)rrresults rrzMyRegressor.predicths8($$Q0J$KKl#,,...rcH|j||jdS)ai Explain model predictions using provided data. References: https://dev.mysql.com/doc/heatwave/en/mys-hwaml-ml-explain-table.html A full list of supported options can be found under "ML_EXPLAIN_TABLE Options" Args: X: DataFrame for which predictions should be explained. Returns: DataFrame containing explanation details (feature attributions, etc.) Raises: DatabaseError: If provided options are invalid or unsupported, or if the model is not initialized, i.e., fit or import has not been called If a database connection issue occurs. If an operational error occurs during execution. Notes: Temporary input/output tables are cleaned up after explanation. rN)rexplain_predictionsr)rrs rr"zMyRegressor.explain_predictionss(6 ''43M'NNNNNr)NNNN)__name__ __module__ __qualname____doc__r rstrdictrrpd DataFramenpndarrayrr"rrr r .s4%),00404 F F. FSM F$D> F (~ F (~ F F F FD/r|RZ/0/ ////.Or|RZ/0O OOOOOOrr )r&typingrrnumpyr+pandasr) sklearn.basermysql.ai.ml.basermysql.ai.ml.modelrmysql.ai.utilsrmysql.connector.abstractsr r r-rrr6s:#"""""""''''''******%%%%%%$$$$$$======lOlOlOlOlO-lOlOlOlOlOr