ENH: Fix doc link in HTML representation of estimators (#2131)

* add doc link in interactive mode

* Update sklearnex/_utils.py

Co-authored-by: Ian Faust <icfaust@gmail.com>

* rename base class

* reword

* Update sklearnex/_utils.py

Co-authored-by: Ian Faust <icfaust@gmail.com>

* linter

---------

Co-authored-by: Ian Faust <icfaust@gmail.com>

Author: david-cortes-intel

sklearnex/_utils.py

@@ -18,6 +18,7 @@
 import os
 import sys
 import warnings
+from abc import ABC
 
 from daal4py.sklearn._utils import (
     PatchingConditionsChain as daal4py_PatchingConditionsChain,
@@ -113,3 +114,19 @@ def get_hyperparameters(self, op):
         return estimator_class
 
     return wrap_class
+
+
+# This abstract class is meant to generate a clickable doc link for classses
+# in sklearnex that are not part of base scikit-learn. It should be inherited
+# before inheriting from a scikit-learn estimator, otherwise will get overriden
+# by the estimator's original.
+class IntelEstimator(ABC):
+    @property
+    def _doc_link_module(self) -> str:
+        return "sklearnex"
+
+    @property
+    def _doc_link_template(self) -> str:
+        module_path, _ = self.__class__.__module__.rsplit(".", 1)
+        class_name = self.__class__.__name__
+        return f"https://intel.github.io/scikit-learn-intelex/latest/non-scikit-algorithms.html#{module_path}.{class_name}"

sklearnex/basic_statistics/basic_statistics.py

@@ -26,7 +26,7 @@
 from onedal.basic_statistics import BasicStatistics as onedal_BasicStatistics
 
 from .._device_offload import dispatch
-from .._utils import PatchingConditionsChain
+from .._utils import IntelEstimator, PatchingConditionsChain
 
 if sklearn_check_version("1.6"):
     from sklearn.utils.validation import validate_data
@@ -38,7 +38,7 @@
 
 
 @control_n_jobs(decorated_methods=["fit"])
-class BasicStatistics(BaseEstimator):
+class BasicStatistics(IntelEstimator, BaseEstimator):
     """
     Estimator for basic statistics.
     Allows to compute basic statistics for provided data.

sklearnex/basic_statistics/incremental_basic_statistics.py

@@ -26,7 +26,7 @@
 )
 
 from .._device_offload import dispatch
-from .._utils import PatchingConditionsChain
+from .._utils import IntelEstimator, PatchingConditionsChain
 
 if sklearn_check_version("1.2"):
     from sklearn.utils._param_validation import Interval, StrOptions
@@ -41,7 +41,7 @@
 
 
 @control_n_jobs(decorated_methods=["partial_fit", "_onedal_finalize_fit"])
-class IncrementalBasicStatistics(BaseEstimator):
+class IncrementalBasicStatistics(IntelEstimator, BaseEstimator):
     """
     Calculates basic statistics on the given data, allows for computation when the data are split into
     batches. The user can use ``partial_fit`` method to provide a single batch of data or use the ``fit`` method to provide

sklearnex/covariance/incremental_covariance.py

@@ -33,7 +33,7 @@
 from sklearnex import config_context
 
 from .._device_offload import dispatch, wrap_output_data
-from .._utils import PatchingConditionsChain, register_hyperparameters
+from .._utils import IntelEstimator, PatchingConditionsChain, register_hyperparameters
 from ..metrics import pairwise_distances
 from ..utils._array_api import get_namespace
 
@@ -47,7 +47,7 @@
 
 
 @control_n_jobs(decorated_methods=["partial_fit", "fit", "_onedal_finalize_fit"])
-class IncrementalEmpiricalCovariance(BaseEstimator):
+class IncrementalEmpiricalCovariance(IntelEstimator, BaseEstimator):
     """
     Maximum likelihood covariance estimator that allows for the estimation when the data are split into
     batches. The user can use the ``partial_fit`` method to provide a single batch of data or use the ``fit`` method to provide

sklearnex/linear_model/incremental_linear.py

@@ -40,7 +40,7 @@
 from onedal.common.hyperparameters import get_hyperparameters
 
 from .._device_offload import dispatch, wrap_output_data
-from .._utils import PatchingConditionsChain, register_hyperparameters
+from .._utils import IntelEstimator, PatchingConditionsChain, register_hyperparameters
 
 
 @register_hyperparameters(
@@ -52,7 +52,9 @@
 @control_n_jobs(
     decorated_methods=["fit", "partial_fit", "predict", "score", "_onedal_finalize_fit"]
 )
-class IncrementalLinearRegression(MultiOutputMixin, RegressorMixin, BaseEstimator):
+class IncrementalLinearRegression(
+    IntelEstimator, MultiOutputMixin, RegressorMixin, BaseEstimator
+):
     """
     Trains a linear regression model, allows for computation if the data are split into
     batches. The user can use the ``partial_fit`` method to provide a single batch of data or use the ``fit`` method to provide