Skip to content

Commit ae4a1ca

Browse files
outoftardisnapetrovvlad-nazarov
authored
Update Readme (#824)
* Restructure readme * Change link order * Update readme * Update readme * Update readme * Update readme * Update README.md * Update README.md * Address comments * Addressed most comments * Apply suggestions from code review * update GPU example * Address comments Co-authored-by: Nikolay Petrov <[email protected]> Co-authored-by: vlad-nazarov <[email protected]>
1 parent 1d85db2 commit ae4a1ca

File tree

2 files changed

+204
-160
lines changed

2 files changed

+204
-160
lines changed

INSTALL.md

Lines changed: 104 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,110 @@
1-
# Building from sources
2-
Intel(R) Extension for Scikit-learn is easily built from sources with the majority of the necessary prerequisites available on conda or pip. The instructions below detail how to gather the prerequisites, and finally build and install the completed package. The package can be built for all three major platforms (Windows, Linux, macOS).
1+
# Installation <!-- omit in toc -->
32

4-
### Prerequisites
5-
* Python version >= 3.6
3+
Intel(R) Extension for Scikit-learn is available at the [Python Package Index](https://pypi.org/project/scikit-learn-intelex/),
4+
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). You can also build the extension from sources.
65

7-
### Configuring the build with environment variables
8-
* SKLEARNEX_VERSION: sets package version
6+
The extension 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). If you already have AI Kit installed, you do not need to separately install the extension.
97

10-
### Building Intel(R) Extension for Scikit-learn
11-
To install the package:
8+
## Installation scenarios <!-- omit in toc -->
129

13-
```bash
14-
cd <checkout-dir>
15-
python setup_sklearnex.py install
16-
```
10+
- [Install via pip or conda](#install-via-pip-or-conda)
11+
- [Install from PyPI channel (recommended by default)](#install-from-pypi-channel-recommended-by-default)
12+
- [Install from Anaconda Cloud](#install-from-anaconda-cloud)
13+
- [Install via Anaconda Cloud from Conda-Forge channel](#install-via-anaconda-cloud-from-conda-forge-channel)
14+
- [Install via Anaconda Cloud from Intel channel](#install-via-anaconda-cloud-from-intel-channel)
15+
- [Build from sources](#build-from-sources)
16+
- [Prerequisites](#prerequisites)
17+
- [Configure the build with environment variables](#configure-the-build-with-environment-variables)
18+
- [Build Intel(R) Extension for Scikit-learn](#build-intelr-extension-for-scikit-learn)
19+
- [Build documentation for Intel(R) Extension for Scikit-learn](#build-documentation-for-intelr-extension-for-scikit-learn)
20+
- [Prerequisites for creating documentation](#prerequisites-for-creating-documentation)
21+
- [Build documentation](#build-documentation)
1722

18-
To install the package in the development mode:
23+
## Install via pip or conda
24+
25+
### Install from PyPI channel (recommended by default)
1926

2027
```bash
21-
cd <checkout-dir>
22-
python setup_sklearnex.py develop
28+
pip install scikit-learn-intelex
2329
```
2430

25-
To install scikit-learn-intelex without downloading daal4py:
31+
#### 📦 Supported configurations for PyPI <!-- omit in toc -->
32+
33+
| OS / Python version | **Python 3.6** | **Python 3.7** | **Python 3.8** | **Python 3.9** |
34+
| :------------------ | :------------: | :------------: | :------------: | :------------: |
35+
| **Linux** | [CPU, GPU] | [CPU, GPU] | [CPU, GPU] | [CPU, GPU] |
36+
| **Windows** | [CPU, GPU] | [CPU, GPU] | [CPU, GPU] | [CPU, GPU] |
37+
| **OsX** | [CPU] | [CPU] | [CPU] | [CPU] |
38+
39+
40+
### Install from Anaconda Cloud
41+
42+
#### Install via Anaconda Cloud from Conda-Forge channel
2643

2744
```bash
28-
cd <checkout-dir>
29-
python setup_sklearnex.py install --single-version-externally-managed --record=record.txt
45+
conda install scikit-learn-intelex -c conda-forge
3046
```
47+
48+
##### 📦 Supported configurations for Anaconda Cloud from Conda-Forge channel <!-- omit in toc -->
49+
50+
| OS / Python version | **Python 3.6** | **Python 3.7** | **Python 3.8**| **Python 3.9**|
51+
| :-----------------------| :------------: | :------------: | :------------:| :------------:|
52+
| **Linux** | [CPU] | [CPU] | [CPU] | [CPU] |
53+
| **Windows** | [CPU] | [CPU] | [CPU] | [CPU] |
54+
| **OsX** | [CPU] | [CPU] | [CPU] | [CPU] |
55+
56+
#### Install via Anaconda Cloud from Intel channel
57+
58+
We recommend this installation for the users of Intel® Distribution for Python.
59+
3160
```bash
32-
cd <checkout-dir>
33-
python setup_sklearnex.py develop --no-deps
61+
conda install scikit-learn-intelex -c intel
3462
```
3563

64+
##### 📦 Supported configurations for Anaconda Cloud from Intel channel <!-- omit in toc -->
65+
66+
| OS / Python version | **Python 3.6** | **Python 3.7** | **Python 3.8** | **Python 3.9** |
67+
| :------------------ | :------------: | :------------: | :------------: | :------------: |
68+
| **Linux** | [CPU, GPU] | [CPU, GPU] | [CPU, GPU] | [CPU, GPU] |
69+
| **Windows** | [CPU, GPU] | [CPU, GPU] | [CPU, GPU] | [CPU, GPU] |
70+
| **OsX** | [CPU] | [CPU] | [CPU] | [CPU] |
71+
72+
73+
## Build from sources
74+
Intel(R) Extension for Scikit-learn is easily built from sources with the majority of the necessary prerequisites available on conda or pip. The instructions below detail how to gather the prerequisites and build and install the completed package. The package can be built for all three major platforms (Windows, Linux, macOS).
75+
76+
### Prerequisites
77+
* Python version >= 3.6
78+
79+
### Configure the build with environment variables
80+
* SKLEARNEX_VERSION: sets package version
81+
82+
### Build Intel(R) Extension for Scikit-learn
83+
- To install the package:
84+
85+
```bash
86+
cd <checkout-dir>
87+
python setup_sklearnex.py install
88+
```
89+
90+
- To install the package in the development mode:
91+
92+
```bash
93+
cd <checkout-dir>
94+
python setup_sklearnex.py develop
95+
```
96+
97+
- To install scikit-learn-intelex without downloading daal4py:
98+
99+
```bash
100+
cd <checkout-dir>
101+
python setup_sklearnex.py install --single-version-externally-managed --record=record.txt
102+
```
103+
```bash
104+
cd <checkout-dir>
105+
python setup_sklearnex.py develop --no-deps
106+
```
107+
36108
⚠️ Keys `--single-version-externally-managed` and `--no-deps` are required so that daal4py is not downloaded after installation of Intel(R) Extension for Scikit-learn
37109

38110
⚠️ The `develop` mode will not install the package but it will create a `.egg-link` in the deployment directory
@@ -42,11 +114,17 @@ without having to reinstall package every time you make a small change.
42114
⚠️ `--single-version-externally-managed` is an option used for Python packages instructing the setuptools module
43115
to create a Python package that can be easily managed by the package manager on the host.
44116

45-
## Building documentation for Intel(R) Extension for Scikit-learn
117+
## Build documentation for Intel(R) Extension for Scikit-learn
46118
### Prerequisites for creating documentation
47-
* sphinx
48-
* sphinx_rtd_theme
49119

50-
### Building documentation
51-
1. ```cd doc && make html```
52-
2. The documentation will be in ```doc/_build/html```
120+
See [requirements-doc.txt](requirements-doc.txt).
121+
122+
### Build documentation
123+
124+
Run:
125+
126+
```
127+
cd doc && make html
128+
```
129+
130+
The documentation will be in ```doc/_build/html```.

0 commit comments

Comments
 (0)