o ^Ti@svdZddlmZmZddlZddlZddlm Z ddl m Z ddl m Z ddlmZddlmZGd d 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 @seZdZdZ    ddedeedeedeedeef dd Zd e e j e j fd e j fd d Zd e e j e j fd e j fddZdS) 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_optionscCs.tj||tj||dt||_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 r N)r__init__r REGRESSIONrrr )selfr r r r rrQ/home/air/sos-pdf/back/venv/lib/python3.10/site-packages/mysql/ai/ml/regressor.pyrFs zMyRegressor.__init__XreturncCs|jj||jd}|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)rrresultrrrrhs zMyRegressor.predictcCs|jj||jddS)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 )rrrrrrszMyRegressor.explain_predictions)NNNN)__name__ __module__ __qualname____doc__rrstrdictrrpd DataFramenpndarrayrrrrrrr .s6 " r )r!typingrrnumpyr&pandasr$ sklearn.basermysql.ai.ml.basermysql.ai.ml.modelrmysql.ai.utilsrmysql.connector.abstractsrr rrrrs