Skip to content

Commit c5ddd0e

Browse files
author
vlad-nazarov
authored
Add GPU benchmarks support to readme (#59)
* Update readme * Update GPU readme * Add hyperlink * Fix comments * Update readme * Fix hyperlink * Update comments * Update link * Fix comments * Apply comments
1 parent 9a812bc commit c5ddd0e

File tree

3 files changed

+22
-10
lines changed

3 files changed

+22
-10
lines changed

README.md

+21-10
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,10 @@ We publish blogs on Medium, so [follow us](https://medium.com/intel-analytics-so
2626

2727
## Table of content
2828

29-
* [Prerequisites](#prerequisites)
3029
* [How to create conda environment for benchmarking](#how-to-create-conda-environment-for-benchmarking)
31-
* [How to enable daal4py patching for scikit-learn benchmarks](#how-to-enable-daal4py-patching-for-scikit-learn-benchmarks)
3230
* [Running Python benchmarks with runner script](#running-python-benchmarks-with-runner-script)
33-
* [Supported algorithms](#supported-algorithms)
31+
* [Benchmark supported algorithms](#benchmark-supported-algorithms)
32+
* [Intel(R) Extension for Scikit-learn* support](#intelr-extension-for-scikit-learn-support)
3433
* [Algorithms parameters](#algorithms-parameters)
3534

3635
## How to create conda environment for benchmarking
@@ -65,13 +64,13 @@ conda create -n bench -c conda-forge python=3.7 xgboost pandas
6564

6665
Run `python runner.py --configs configs/config_example.json [--output-file result.json --verbose INFO --report]` to launch benchmarks.
6766

68-
runner options:
69-
* ``configs`` : configuration files paths
70-
* ``no-intel-optimized`` : using Scikit-learn without Intel(R) Extension for Scikit-learn*. Now avalible for scikit-learn benchmarks. Default starts with using Intel(R) Extension for Scikit-learn*.
71-
* ``output-file``: output file name for result benchmarks. Default is `result.json`
72-
* ``report``: create an Excel report based on benchmarks results. Need library `openpyxl`.
73-
* ``dummy-run`` : run configuration parser and datasets generation without benchmarks running.
74-
* ``verbose`` : *WARNING*, *INFO*, *DEBUG*. print additional information during benchmarks running. Default is *INFO*
67+
Options:
68+
* ``--configs``: specify the path to a configuration file.
69+
* ``--no-intel-optimized``: use Scikit-learn without [Intel(R) Extension for Scikit-learn*](#intelr-extension-for-scikit-learn-support). Now available for [scikit-learn benchmarks](https://github.com/IntelPython/scikit-learn_bench/tree/master/sklearn_bench). By default, the runner uses Intel(R) Extension for Scikit-learn.
70+
* ``--output-file``: output file name for the benchmark result. The default name is `result.json`
71+
* ``--report``: create an Excel report based on benchmark results. The `openpyxl` library is required.
72+
* ``--dummy-run``: run configuration parser and dataset generation without benchmarks running.
73+
* ``--verbose``: *WARNING*, *INFO*, *DEBUG*. print additional information during benchmarks running. Default is *INFO*.
7574

7675
| Level | Description |
7776
|-----------|---------------|
@@ -108,6 +107,18 @@ The configuration of benchmarks allows you to select the frameworks to run, sele
108107
|**[GradientBoostingClassifier](https://scikit-learn.org/stable/modules/generated/sklearn.ensemble.GradientBoostingClassifier.html)**|gbt|:x:|:x:|:x:|:white_check_mark:|
109108
|**[GradientBoostingRegressor](https://scikit-learn.org/stable/modules/generated/sklearn.ensemble.GradientBoostingRegressor.html)**|gbt|:x:|:x:|:x:|:white_check_mark:|
110109

110+
## Intel(R) Extension for Scikit-learn support
111+
112+
When you run scikit-learn benchmarks on CPU, [Intel(R) Extension for Scikit-learn](https://github.com/intel/scikit-learn-intelex) is used by default. Use the ``--no-intel-optimized`` option to run the benchmarks without the extension.
113+
114+
The following benchmarks have a GPU support:
115+
* dbscan
116+
* kmeans
117+
* linear
118+
* log_reg
119+
120+
You may use the [configuration file for these benchmarks](https://github.com/IntelPython/scikit-learn_bench/blob/master/configs/skl_xpu_config.json) to run them on both CPU and GPU.
121+
111122
## Algorithms parameters
112123

113124
You can launch benchmarks for each algorithm separately.

configs/README.md

+1
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ Refer to the tables below for descriptions of all fields in the configuration fi
2727
|data-order| array[string] | **REQUIRED** input data order. Data order: *C* (row-major, default) or *F* (column-major) |
2828
|dtype| array[string] | **REQUIRED** input data type. Data type: *float64* (default) or *float32* |
2929
|check-finitness| array[] | Check finiteness in sklearn input check(disabled by default) |
30+
|device| array[string] | For scikit-learn only. The list of devices to run the benchmarks on. It can be *None* (default, run on CPU without sycl context) or one of the types of sycl devices: *cpu*, *gpu*, *host*. Refer to [SYCL specification](https://www.khronos.org/files/sycl/sycl-2020-reference-guide.pdf) for details|
3031

3132
### Case Object
3233

File renamed without changes.

0 commit comments

Comments
 (0)