scikit-learn-intelex 2024.0.1__py312-none-win_amd64.whl → 2025.1.0__py312-none-win_amd64.whl

scikit_learn_intelex-2025.1.0.data/data/Lib/site-packages/sklearnex/utils/tests/test_finite.py

@@ -0,0 +1,89 @@
+# ==============================================================================
+# Copyright 2024 Intel Corporation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+
+import time
+
+import numpy as np
+import numpy.random as rand
+import pytest
+from numpy.testing import assert_raises
+
+from sklearnex.utils import _assert_all_finite
+
+
+@pytest.mark.parametrize("dtype", [np.float32, np.float64])
+@pytest.mark.parametrize(
+    "shape",
+    [
+        [16, 2048],
+        [
+            2**16 + 3,
+        ],
+        [1000, 1000],
+    ],
+)
+@pytest.mark.parametrize("allow_nan", [False, True])
+def test_sum_infinite_actually_finite(dtype, shape, allow_nan):
+    X = np.array(shape, dtype=dtype)
+    X.fill(np.finfo(dtype).max)
+    _assert_all_finite(X, allow_nan=allow_nan)
+
+
+@pytest.mark.parametrize("dtype", [np.float32, np.float64])
+@pytest.mark.parametrize(
+    "shape",
+    [
+        [16, 2048],
+        [
+            2**16 + 3,
+        ],
+        [1000, 1000],
+    ],
+)
+@pytest.mark.parametrize("allow_nan", [False, True])
+@pytest.mark.parametrize("check", ["inf", "NaN", None])
+@pytest.mark.parametrize("seed", [0, int(time.time())])
+def test_assert_finite_random_location(dtype, shape, allow_nan, check, seed):
+    rand.seed(seed)
+    X = rand.uniform(high=np.finfo(dtype).max, size=shape).astype(dtype)
+
+    if check:
+        loc = rand.randint(0, X.size - 1)
+        X.reshape((-1,))[loc] = float(check)
+
+    if check is None or (allow_nan and check == "NaN"):
+        _assert_all_finite(X, allow_nan=allow_nan)
+    else:
+        assert_raises(ValueError, _assert_all_finite, X, allow_nan=allow_nan)
+
+
+@pytest.mark.parametrize("dtype", [np.float32, np.float64])
+@pytest.mark.parametrize("allow_nan", [False, True])
+@pytest.mark.parametrize("check", ["inf", "NaN", None])
+@pytest.mark.parametrize("seed", [0, int(time.time())])
+def test_assert_finite_random_shape_and_location(dtype, allow_nan, check, seed):
+    lb, ub = 32768, 1048576  # lb is a patching condition, ub 2^20
+    rand.seed(seed)
+    X = rand.uniform(high=np.finfo(dtype).max, size=rand.randint(lb, ub)).astype(dtype)
+
+    if check:
+        loc = rand.randint(0, X.size - 1)
+        X[loc] = float(check)
+
+    if check is None or (allow_nan and check == "NaN"):
+        _assert_all_finite(X, allow_nan=allow_nan)
+    else:
+        assert_raises(ValueError, _assert_all_finite, X, allow_nan=allow_nan)

{scikit_learn_intelex-2024.0.1.data → scikit_learn_intelex-2025.1.0.data}/data/Lib/site-packages/sklearnex/utils/validation.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python
 # ===============================================================================
 # Copyright 2022 Intel Corporation
 #

{scikit_learn_intelex-2024.0.1.dist-info → scikit_learn_intelex-2025.1.0.dist-info}/METADATA

@@ -1,230 +1,231 @@
-Metadata-Version: 2.1
-Name: scikit-learn-intelex
-Version: 2024.0.1
-Summary: Intel(R) Extension for Scikit-learn is a seamless way to speed up your Scikit-learn application.
-Home-page: https://github.com/intel/scikit-learn-intelex
-Author: Intel Corporation
-Author-email: onedal.maintainers@intel.com
-Maintainer-email: onedal.maintainers@intel.com
-License: Apache-2.0
-Project-URL: Bug Tracker, https://github.com/intel/scikit-learn-intelex/issues
-Project-URL: Documentation, https://intel.github.io/scikit-learn-intelex/
-Project-URL: Source Code, https://github.com/intel/scikit-learn-intelex
-Keywords: machine learning,scikit-learn,data science,data analytics
-Platform: UNKNOWN
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Other Audience
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering
-Classifier: Topic :: System
-Classifier: Topic :: Software Development
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-Requires-Dist: daal4py (==2024.0.1)
-Requires-Dist: scikit-learn (>=0.22)
-
-
-# Intel(R) Extension for Scikit-learn*
-
-[![Build Status](https://dev.azure.com/daal/daal4py/_apis/build/status/CI?branchName=master)](https://dev.azure.com/daal/daal4py/_build/latest?definitionId=9&branchName=master)
-[![Coverity Scan Build Status](https://scan.coverity.com/projects/21716/badge.svg)](https://scan.coverity.com/projects/daal4py)
-[![Join the community on GitHub Discussions](https://badgen.net/badge/join%20the%20discussion/on%20github/black?icon=github)](https://github.com/intel/scikit-learn-intelex/discussions)
-[![PyPI Version](https://img.shields.io/pypi/v/scikit-learn-intelex)](https://pypi.org/project/scikit-learn-intelex/)
-[![Conda Version](https://img.shields.io/conda/vn/conda-forge/scikit-learn-intelex)](https://anaconda.org/conda-forge/scikit-learn-intelex)
-
-With Intel(R) Extension for Scikit-learn you can accelerate your Scikit-learn applications and still have full conformance with all Scikit-Learn APIs and algorithms. This is a free software AI accelerator that brings over 10-100X acceleration across a variety of applications. And you do not even need to change the existing code!
-
-The acceleration is achieved through the use of the Intel(R) oneAPI Data Analytics Library ([oneDAL](https://github.com/oneapi-src/oneDAL)). Patching scikit-learn makes it a well-suited machine learning framework for dealing with real-life problems.
-
-⚠️Intel(R) Extension for Scikit-learn contains scikit-learn patching functionality that was originally available in [**daal4py**](https://github.com/intel/scikit-learn-intelex/tree/master/daal4py) package. All future updates for the patches will be available only in Intel(R) Extension for Scikit-learn. We recommend you to use scikit-learn-intelex package instead of daal4py.
-You can learn more about daal4py in [daal4py documentation](https://intelpython.github.io/daal4py).
-
-## 👀 Follow us on Medium
-
-We publish blogs on Medium, so [follow us](https://medium.com/intel-analytics-software/tagged/machine-learning) to learn tips and tricks for more efficient data analysis with the help of Intel(R) Extension for Scikit-learn. Here are our latest blogs:
-
-- [Save Time and Money with Intel Extension for Scikit-learn](https://medium.com/intel-analytics-software/save-time-and-money-with-intel-extension-for-scikit-learn-33627425ae4)
-- [Superior Machine Learning Performance on the Latest Intel Xeon Scalable Processors](https://medium.com/intel-analytics-software/superior-machine-learning-performance-on-the-latest-intel-xeon-scalable-processor-efdec279f5a3)
-- [Leverage Intel Optimizations in Scikit-Learn](https://medium.com/intel-analytics-software/leverage-intel-optimizations-in-scikit-learn-f562cb9d5544)
-- [Intel Gives Scikit-Learn the Performance Boost Data Scientists Need](https://medium.com/intel-analytics-software/intel-gives-scikit-learn-the-performance-boost-data-scientists-need-42eb47c80b18)
-- [From Hours to Minutes: 600x Faster SVM](https://medium.com/intel-analytics-software/from-hours-to-minutes-600x-faster-svm-647f904c31ae)
-- [Improve the Performance of XGBoost and LightGBM Inference](https://medium.com/intel-analytics-software/improving-the-performance-of-xgboost-and-lightgbm-inference-3b542c03447e)
-- [Accelerate Kaggle Challenges Using Intel AI Analytics Toolkit](https://medium.com/intel-analytics-software/accelerate-kaggle-challenges-using-intel-ai-analytics-toolkit-beb148f66d5a)
-- [Accelerate Your scikit-learn Applications](https://medium.com/intel-analytics-software/improving-the-performance-of-xgboost-and-lightgbm-inference-3b542c03447e)
-- [Accelerate Linear Models for Machine Learning](https://medium.com/intel-analytics-software/accelerating-linear-models-for-machine-learning-5a75ff50a0fe)
-- [Accelerate K-Means Clustering](https://medium.com/intel-analytics-software/accelerate-k-means-clustering-6385088788a1)
-
-## 🔗 Important links
-- [Notebook examples](https://github.com/intel/scikit-learn-intelex/tree/master/examples/notebooks)
-- [Documentation](https://intel.github.io/scikit-learn-intelex/)
-- [scikit-learn API and patching](https://intel.github.io/scikit-learn-intelex/)
-- [Benchmark code](https://github.com/IntelPython/scikit-learn_bench)
-- [Building from Sources](https://github.com/intel/scikit-learn-intelex/blob/master/INSTALL.md)
-- [About Intel(R) oneAPI Data Analytics Library](https://github.com/oneapi-src/oneDAL)
-- [About Intel(R) daal4py](https://github.com/intel/scikit-learn-intelex/tree/master/daal4py)
-
-## 💬 Support
-
-Report issues, ask questions, and provide suggestions using:
-
-- [GitHub Issues](https://github.com/intel/scikit-learn-intelex/issues)
-- [GitHub Discussions](https://github.com/intel/scikit-learn-intelex/discussions)
-- [Forum](https://community.intel.com/t5/Intel-Distribution-for-Python/bd-p/distribution-python)
-
-You may reach out to project maintainers privately at onedal.maintainers@intel.com
-
-# 🛠 Installation
-Intel(R) Extension for Scikit-learn is available at the [Python Package Index](https://pypi.org/project/scikit-learn-intelex/),
-on Anaconda Cloud in [Conda-Forge channel](https://anaconda.org/conda-forge/scikit-learn-intelex) and in [Intel channel](https://anaconda.org/intel/scikit-learn-intelex).
-Intel(R) Extension for Scikit-learn is also available as a part of [Intel® oneAPI AI Analytics Toolkit](https://software.intel.com/content/www/us/en/develop/tools/oneapi/ai-analytics-toolkit.html) (AI Kit).
-
-- PyPi (recommended by default)
-
-```bash
-pip install scikit-learn-intelex
-```
-
-- Anaconda Cloud from Conda-Forge channel (recommended for conda users by default)
-
-```bash
-  conda config --add channels conda-forge
-  conda config --set channel_priority strict
-  conda install scikit-learn-intelex
-```
-
-- Anaconda Cloud from Intel channel (recommended for Intel® Distribution for Python users)
-
-```bash
-  conda config --add channels intel
-  conda config --set channel_priority strict
-  conda install scikit-learn-intelex
-```
-
-<details><summary>[Click to expand] ℹ️ Supported configurations </summary>
-
-#### 📦 PyPi channel
-
-| OS / Python version     | **Python 3.8** | **Python 3.9** | **Python 3.10**| **Python 3.11**| **Python 3.12**|
-| :-----------------------| :------------: | :-------------:| :------------: | :------------: | :------------: |
-|    **Linux**            |    [CPU, GPU]  |  [CPU, GPU]    |   [CPU, GPU]   |   [CPU, GPU]   |   [CPU, GPU]   |
-|    **Windows**          |    [CPU, GPU]  |  [CPU, GPU]    |   [CPU, GPU]   |   [CPU, GPU]   |   [CPU, GPU]   |
-
-#### 📦 Anaconda Cloud: Conda-Forge channel
-
-| OS / Python version     | **Python 3.8** | **Python 3.9** | **Python 3.10**| **Python 3.11**| **Python 3.12**|
-| :-----------------------| :------------: | :------------: | :------------: | :------------: | :------------: |
-|    **Linux**            |     [CPU]      |     [CPU]      |     [CPU]      |     [CPU]      |     [CPU]      |
-|    **Windows**          |     [CPU]      |     [CPU]      |     [CPU]      |     [CPU]      |     [CPU]      |
-
-#### 📦 Anaconda Cloud: Intel channel
-
-| OS / Python version     | **Python 3.8** | **Python 3.9** | **Python 3.10**| **Python 3.11**| **Python 3.12**|
-| :-----------------------| :------------: | :-------------:| :------------: | :------------: | :------------: |
-|    **Linux**            |    [CPU, GPU]  |  [CPU, GPU]    |   [CPU, GPU]   |   [CPU, GPU]   |   [CPU, GPU]   |
-|    **Windows**          |    [CPU, GPU]  |  [CPU, GPU]    |   [CPU, GPU]   |   [CPU, GPU]   |   [CPU, GPU]   |
-
-</details>
-
-⚠️ Note: *GPU support is an optional dependency. Required dependencies for GPU support
-will not be downloaded. You need to manually install ***dpcpp_cpp_rt*** package.*
-
-<details><summary>[Click to expand] ℹ️ How to install dpcpp_cpp_rt package </summary>
-
-- PyPi
-
-```bash
-pip install --upgrade dpcpp_cpp_rt
-```
-
-- Anaconda Cloud
-
-```bash
-conda install dpcpp_cpp_rt -c intel
-```
-
-</details>
-
-You can [build the package from sources](https://github.com/intel/scikit-learn-intelex/blob/master/INSTALL.md) as well.
-
-# ⚡️ Get Started
-
-Intel CPU optimizations patching
-```py
-import numpy as np
-from sklearnex import patch_sklearn
-patch_sklearn()
-
-from sklearn.cluster import DBSCAN
-
-X = np.array([[1., 2.], [2., 2.], [2., 3.],
-              [8., 7.], [8., 8.], [25., 80.]], dtype=np.float32)
-clustering = DBSCAN(eps=3, min_samples=2).fit(X)
-```
-
-Intel GPU optimizations patching
-```py
-import numpy as np
-import dpctl
-from sklearnex import patch_sklearn, config_context
-patch_sklearn()
-
-from sklearn.cluster import DBSCAN
-
-X = np.array([[1., 2.], [2., 2.], [2., 3.],
-              [8., 7.], [8., 8.], [25., 80.]], dtype=np.float32)
-with config_context(target_offload="gpu:0"):
-    clustering = DBSCAN(eps=3, min_samples=2).fit(X)
-```
-
-# 🚀 Scikit-learn patching
-
-![](https://raw.githubusercontent.com/intel/scikit-learn-intelex/master/doc/sources/_static/scikit-learn-acceleration-2021.2.3.PNG)
-Configurations:
-- HW: c5.24xlarge AWS EC2 Instance using an Intel Xeon Platinum 8275CL with 2 sockets and 24 cores per socket
-- SW: scikit-learn version 0.24.2, scikit-learn-intelex version 2021.2.3, Python 3.8
-
-[Benchmarks code](https://github.com/IntelPython/scikit-learn_bench)
-
-<details><summary>[Click to expand] ℹ️ Reproduce results </summary>
-
-- With Intel® Extension for Scikit-learn enabled:
-
-```bash
-python runner.py --configs configs/blogs/skl_conda_config.json -–report
-```
-
-- With the original Scikit-learn:
-
-```bash
-python runner.py --configs configs/blogs/skl_conda_config.json -–report --no-intel-optimized
-```
-</details>
-
-Intel(R) Extension for Scikit-learn patching affects performance of specific Scikit-learn functionality. Refer to the [list of supported algorithms and parameters](https://intel.github.io/scikit-learn-intelex/algorithms.html) for details. In cases when unsupported parameters are used, the package fallbacks into original Scikit-learn. If the patching does not cover your scenarios, [submit an issue on GitHub](https://github.com/intel/scikit-learn-intelex/issues).
-
-⚠️ We support optimizations for the last four versions of scikit-learn. The latest release of scikit-learn-intelex-2024.0.X supports scikit-learn 1.0.X, 1.1.X, 1.2.X and 1.3.X.
-
-## 📜 Intel(R) Extension for Scikit-learn verbose
-
-To find out which implementation of the algorithm is currently used (Intel(R) Extension for Scikit-learn or original Scikit-learn), set the environment variable:
-- On Linux: `export SKLEARNEX_VERBOSE=INFO`
-- On Windows: `set SKLEARNEX_VERBOSE=INFO`
-
-For example, for DBSCAN you get one of these print statements depending on which implementation is used:
-- `SKLEARNEX INFO: sklearn.cluster.DBSCAN.fit: running accelerated version on CPU`
-- `SKLEARNEX INFO: sklearn.cluster.DBSCAN.fit: fallback to original Scikit-learn`
-
-[Read more in the documentation](https://intel.github.io/scikit-learn-intelex/).
-
-
+Metadata-Version: 2.1
+Name: scikit-learn-intelex
+Version: 2025.1.0
+Summary: Intel(R) Extension for Scikit-learn is a seamless way to speed up your Scikit-learn application.
+Home-page: https://github.com/intel/scikit-learn-intelex
+Author: Intel Corporation
+Author-email: onedal.maintainers@intel.com
+Maintainer-email: onedal.maintainers@intel.com
+License: Apache-2.0
+Project-URL: Bug Tracker, https://github.com/intel/scikit-learn-intelex/issues
+Project-URL: Documentation, https://intel.github.io/scikit-learn-intelex/
+Project-URL: Source Code, https://github.com/intel/scikit-learn-intelex
+Keywords: machine learning,scikit-learn,data science,data analytics
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Other Audience
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: System
+Classifier: Topic :: Software Development
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: daal ==2025.1.0
+Requires-Dist: numpy >=1.19
+Requires-Dist: scikit-learn >=0.22
+
+
+# Intel(R) Extension for Scikit-learn*
+
+[![Build Status](https://dev.azure.com/daal/daal4py/_apis/build/status/CI?branchName=master)](https://dev.azure.com/daal/daal4py/_build/latest?definitionId=9&branchName=master)
+[![Coverity Scan Build Status](https://scan.coverity.com/projects/21716/badge.svg)](https://scan.coverity.com/projects/daal4py)
+[![Join the community on GitHub Discussions](https://badgen.net/badge/join%20the%20discussion/on%20github/black?icon=github)](https://github.com/intel/scikit-learn-intelex/discussions)
+[![PyPI Version](https://img.shields.io/pypi/v/scikit-learn-intelex)](https://pypi.org/project/scikit-learn-intelex/)
+[![Conda Version](https://img.shields.io/conda/vn/conda-forge/scikit-learn-intelex)](https://anaconda.org/conda-forge/scikit-learn-intelex)
+
+With Intel(R) Extension for Scikit-learn you can accelerate your Scikit-learn applications and still have full conformance with all Scikit-Learn APIs and algorithms. This is a free software AI accelerator that brings over 10-100X acceleration across a variety of applications. And you do not even need to change the existing code!
+
+The acceleration is achieved through the use of the Intel(R) oneAPI Data Analytics Library ([oneDAL](https://github.com/oneapi-src/oneDAL)). Patching scikit-learn makes it a well-suited machine learning framework for dealing with real-life problems.
+
+⚠️Intel(R) Extension for Scikit-learn contains scikit-learn patching functionality that was originally available in [**daal4py**](https://github.com/intel/scikit-learn-intelex/tree/master/daal4py) package. All future updates for the patches will be available only in Intel(R) Extension for Scikit-learn. We recommend you to use scikit-learn-intelex package instead of daal4py.
+You can learn more about daal4py in [daal4py documentation](https://intelpython.github.io/daal4py).
+
+## 👀 Follow us on Medium
+
+We publish blogs on Medium, so [follow us](https://medium.com/intel-analytics-software/tagged/machine-learning) to learn tips and tricks for more efficient data analysis with the help of Intel(R) Extension for Scikit-learn. Here are our latest blogs:
+
+- [Save Time and Money with Intel Extension for Scikit-learn](https://medium.com/intel-analytics-software/save-time-and-money-with-intel-extension-for-scikit-learn-33627425ae4)
+- [Superior Machine Learning Performance on the Latest Intel Xeon Scalable Processors](https://medium.com/intel-analytics-software/superior-machine-learning-performance-on-the-latest-intel-xeon-scalable-processor-efdec279f5a3)
+- [Leverage Intel Optimizations in Scikit-Learn](https://medium.com/intel-analytics-software/leverage-intel-optimizations-in-scikit-learn-f562cb9d5544)
+- [Intel Gives Scikit-Learn the Performance Boost Data Scientists Need](https://medium.com/intel-analytics-software/intel-gives-scikit-learn-the-performance-boost-data-scientists-need-42eb47c80b18)
+- [From Hours to Minutes: 600x Faster SVM](https://medium.com/intel-analytics-software/from-hours-to-minutes-600x-faster-svm-647f904c31ae)
+- [Improve the Performance of XGBoost and LightGBM Inference](https://medium.com/intel-analytics-software/improving-the-performance-of-xgboost-and-lightgbm-inference-3b542c03447e)
+- [Accelerate Kaggle Challenges Using Intel AI Analytics Toolkit](https://medium.com/intel-analytics-software/accelerate-kaggle-challenges-using-intel-ai-analytics-toolkit-beb148f66d5a)
+- [Accelerate Your scikit-learn Applications](https://medium.com/intel-analytics-software/improving-the-performance-of-xgboost-and-lightgbm-inference-3b542c03447e)
+- [Accelerate Linear Models for Machine Learning](https://medium.com/intel-analytics-software/accelerating-linear-models-for-machine-learning-5a75ff50a0fe)
+- [Accelerate K-Means Clustering](https://medium.com/intel-analytics-software/accelerate-k-means-clustering-6385088788a1)
+
+## 🔗 Important links
+- [Notebook examples](https://github.com/intel/scikit-learn-intelex/tree/master/examples/notebooks)
+- [Documentation](https://intel.github.io/scikit-learn-intelex/)
+- [scikit-learn API and patching](https://intel.github.io/scikit-learn-intelex/)
+- [Benchmark code](https://github.com/IntelPython/scikit-learn_bench)
+- [Building from Sources](https://github.com/intel/scikit-learn-intelex/blob/master/INSTALL.md)
+- [About Intel(R) oneAPI Data Analytics Library](https://github.com/oneapi-src/oneDAL)
+- [About Intel(R) daal4py](https://github.com/intel/scikit-learn-intelex/tree/master/daal4py)
+
+## 💬 Support
+
+Report issues, ask questions, and provide suggestions using:
+
+- [GitHub Issues](https://github.com/intel/scikit-learn-intelex/issues)
+- [GitHub Discussions](https://github.com/intel/scikit-learn-intelex/discussions)
+- [Forum](https://community.intel.com/t5/Intel-Distribution-for-Python/bd-p/distribution-python)
+
+You may reach out to project maintainers privately at onedal.maintainers@intel.com
+
+# 🛠 Installation
+Intel(R) Extension for Scikit-learn is available at the [Python Package Index](https://pypi.org/project/scikit-learn-intelex/),
+on Anaconda Cloud in [Conda-Forge channel](https://anaconda.org/conda-forge/scikit-learn-intelex) and in [Intel channel](https://anaconda.org/intel/scikit-learn-intelex).
+Intel(R) Extension for Scikit-learn is also available as a part of [Intel® oneAPI AI Analytics Toolkit](https://software.intel.com/content/www/us/en/develop/tools/oneapi/ai-analytics-toolkit.html) (AI Kit).
+
+- PyPi (recommended by default)
+
+```bash
+pip install scikit-learn-intelex
+```
+
+- Anaconda Cloud from Conda-Forge channel (recommended for conda users by default)
+
+```bash
+  conda config --add channels conda-forge
+  conda config --set channel_priority strict
+  conda install scikit-learn-intelex
+```
+
+- Anaconda Cloud from Intel channel (recommended for Intel® Distribution for Python users)
+
+```bash
+  conda config --add channels intel
+  conda config --set channel_priority strict
+  conda install scikit-learn-intelex
+```
+
+<details><summary>[Click to expand] ℹ️ Supported configurations </summary>
+
+#### 📦 PyPi channel
+
+| OS / Python version     | **Python 3.8** | **Python 3.9** | **Python 3.10**| **Python 3.11**| **Python 3.12**|
+| :-----------------------| :------------: | :-------------:| :------------: | :------------: | :------------: |
+|    **Linux**            |    [CPU, GPU]  |  [CPU, GPU]    |   [CPU, GPU]   |   [CPU, GPU]   |   [CPU, GPU]   |
+|    **Windows**          |    [CPU, GPU]  |  [CPU, GPU]    |   [CPU, GPU]   |   [CPU, GPU]   |   [CPU, GPU]   |
+
+#### 📦 Anaconda Cloud: Conda-Forge channel
+
+| OS / Python version     | **Python 3.8** | **Python 3.9** | **Python 3.10**| **Python 3.11**| **Python 3.12**|
+| :-----------------------| :------------: | :------------: | :------------: | :------------: | :------------: |
+|    **Linux**            |     [CPU]      |     [CPU]      |     [CPU]      |     [CPU]      |     [CPU]      |
+|    **Windows**          |     [CPU]      |     [CPU]      |     [CPU]      |     [CPU]      |     [CPU]      |
+
+#### 📦 Anaconda Cloud: Intel channel
+
+| OS / Python version     | **Python 3.8** | **Python 3.9** | **Python 3.10**| **Python 3.11**| **Python 3.12**|
+| :-----------------------| :------------: | :-------------:| :------------: | :------------: | :------------: |
+|    **Linux**            |    [CPU, GPU]  |  [CPU, GPU]    |   [CPU, GPU]   |   [CPU, GPU]   |   [CPU, GPU]   |
+|    **Windows**          |    [CPU, GPU]  |  [CPU, GPU]    |   [CPU, GPU]   |   [CPU, GPU]   |   [CPU, GPU]   |
+
+</details>
+
+⚠️ Note: *GPU support is an optional dependency. Required dependencies for GPU support
+will not be downloaded. You need to manually install ***dpcpp_cpp_rt*** package.*
+
+<details><summary>[Click to expand] ℹ️ How to install dpcpp_cpp_rt package </summary>
+
+- PyPi
+
+```bash
+pip install --upgrade dpcpp_cpp_rt
+```
+
+- Anaconda Cloud
+
+```bash
+conda install dpcpp_cpp_rt -c intel
+```
+
+</details>
+
+You can [build the package from sources](https://github.com/intel/scikit-learn-intelex/blob/master/INSTALL.md) as well.
+
+# ⚡️ Get Started
+
+Intel CPU optimizations patching
+```py
+import numpy as np
+from sklearnex import patch_sklearn
+patch_sklearn()
+
+from sklearn.cluster import DBSCAN
+
+X = np.array([[1., 2.], [2., 2.], [2., 3.],
+              [8., 7.], [8., 8.], [25., 80.]], dtype=np.float32)
+clustering = DBSCAN(eps=3, min_samples=2).fit(X)
+```
+
+Intel GPU optimizations patching
+```py
+import numpy as np
+import dpctl
+from sklearnex import patch_sklearn, config_context
+patch_sklearn()
+
+from sklearn.cluster import DBSCAN
+
+X = np.array([[1., 2.], [2., 2.], [2., 3.],
+              [8., 7.], [8., 8.], [25., 80.]], dtype=np.float32)
+with config_context(target_offload="gpu:0"):
+    clustering = DBSCAN(eps=3, min_samples=2).fit(X)
+```
+
+# 🚀 Scikit-learn patching
+
+![](https://raw.githubusercontent.com/intel/scikit-learn-intelex/master/doc/sources/_static/scikit-learn-acceleration-2021.2.3.PNG)
+Configurations:
+- HW: c5.24xlarge AWS EC2 Instance using an Intel Xeon Platinum 8275CL with 2 sockets and 24 cores per socket
+- SW: scikit-learn version 0.24.2, scikit-learn-intelex version 2021.2.3, Python 3.8
+
+[Benchmarks code](https://github.com/IntelPython/scikit-learn_bench)
+
+<details><summary>[Click to expand] ℹ️ Reproduce results </summary>
+
+- With Intel® Extension for Scikit-learn enabled:
+
+```bash
+python runner.py --configs configs/blogs/skl_conda_config.json -–report
+```
+
+- With the original Scikit-learn:
+
+```bash
+python runner.py --configs configs/blogs/skl_conda_config.json -–report --no-intel-optimized
+```
+</details>
+
+Intel(R) Extension for Scikit-learn patching affects performance of specific Scikit-learn functionality. Refer to the [list of supported algorithms and parameters](https://intel.github.io/scikit-learn-intelex/algorithms.html) for details. In cases when unsupported parameters are used, the package fallbacks into original Scikit-learn. If the patching does not cover your scenarios, [submit an issue on GitHub](https://github.com/intel/scikit-learn-intelex/issues).
+
+⚠️ We support optimizations for the last four versions of scikit-learn. The latest release of scikit-learn-intelex-2024.0.X supports scikit-learn 1.0.X, 1.1.X, 1.2.X and 1.3.X.
+
+## 📜 Intel(R) Extension for Scikit-learn verbose
+
+To find out which implementation of the algorithm is currently used (Intel(R) Extension for Scikit-learn or original Scikit-learn), set the environment variable:
+- On Linux: `export SKLEARNEX_VERBOSE=INFO`
+- On Windows: `set SKLEARNEX_VERBOSE=INFO`
+
+For example, for DBSCAN you get one of these print statements depending on which implementation is used:
+- `SKLEARNEX INFO: sklearn.cluster.DBSCAN.fit: running accelerated version on CPU`
+- `SKLEARNEX INFO: sklearn.cluster.DBSCAN.fit: fallback to original Scikit-learn`
+
+[Read more in the documentation](https://intel.github.io/scikit-learn-intelex/).
+
+