Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DOC: Update quick-start instructions #2282

Conversation

david-cortes-intel
Copy link
Contributor

@david-cortes-intel david-cortes-intel commented Jan 27, 2025

Description

Add a comprehensive description of proposed changes

List associated issue number(s) if exist(s): #6 (for example)

Documentation PR (if needed): #1340 (for example)

Benchmarks PR (if needed): IntelPython/scikit-learn_bench#155 (for example)


The current installation instructions suggest installing sklearnex from the conda-forge channel as the recommended way, but this channel does not come with GPU support per the table. It also mentions that the package can be installed from the main anaconda channel as a third option.

This PR changes the docs so that the conda intel channel would be recommended over the conda-forge one, and removes the instructions for the main anaconda channel, as they do not distribute recent versions of sklearnex (last release there is 2023.1.1)

It also updates the list of supported sklearn versions to include the latest releases (which are now supported), as well as the list of supported python versions to include 3.13, for which there hopefully will be wheels available by the next sklearnex release.

Since right now there is no differentiation of features by OS or python version, it also changes the format of the support tables to something simpler and easier to read.

Besides the support for CPU/GPU, the PR also adds info about other supported devices (FPGAs, which are covered by DPC) and about SPMD mode, which is currently not available in all distribution channels.

Checklist to comply with before moving PR from draft:

PR completeness and readability

  • I have reviewed my changes thoroughly before submitting this pull request.
  • I have updated the documentation to reflect the changes or created a separate PR with update and provided its number in the description, if necessary.
  • Git commit message contains an appropriate signed-off-by string (see CONTRIBUTING.md for details).
  • I have added a respective label(s) to PR if I have a permission for that.
  • I have resolved any merge conflicts that might occur with the base branch.

Testing

  • I have run it locally and tested the changes extensively.
  • All CI jobs are green or I have provided justification why they aren't.

Performance

Not applicable.

Copy link

codecov bot commented Jan 27, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Flag Coverage Δ
azure ?
github 71.00% <ø> (-0.02%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

see 66 files with indirect coverage changes

@david-cortes-intel
Copy link
Contributor Author

david-cortes-intel commented Jan 28, 2025

Screenshow of how it'd look like after the PR:
image

Copy link
Contributor

@icfaust icfaust left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd like for some others to weigh in, as it has an impact on our support burden.

@@ -370,12 +310,15 @@ Software Requirements

If you use accelerators, refer to `oneAPI DPC++/C++ Compiler System Requirements <https://www.intel.com/content/www/us/en/developer/articles/system-requirements/intel-oneapi-dpcpp-system-requirements.html>`_.

Intel(R) Extension for Scikit-learn is compatible with the last four versions of scikit-learn:
Intel(R) Extension for Scikit-learn is compatible with the last stable releases of scikit-learn:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@napetrov @syakov-intel please review this, I'd prefer something a little more ambiguous. "compatible with four major releases of scikit-learn.

@david-cortes-intel
Copy link
Contributor Author

Closing in favor of a larger PR where these changes were merged: #2282

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants