Metadata-Version: 2.4 Name: scikit-learn Version: 1.7.1 Summary: A set of python modules for machine learning and data mining Maintainer-Email: scikit-learn developers License-Expression: BSD-3-Clause License-File: COPYING Classifier: Intended Audience :: Science/Research Classifier: Intended Audience :: Developers Classifier: Programming Language :: C Classifier: Programming Language :: Python Classifier: Topic :: Software Development Classifier: Topic :: Scientific/Engineering Classifier: Development Status :: 5 - Production/Stable Classifier: Operating System :: Microsoft :: Windows Classifier: Operating System :: POSIX Classifier: Operating System :: Unix Classifier: Operating System :: MacOS Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: 3.11 Classifier: Programming Language :: Python :: 3.12 Classifier: Programming Language :: Python :: 3.13 Classifier: Programming Language :: Python :: Implementation :: CPython Project-URL: homepage, https://scikit-learn.org Project-URL: source, https://github.com/scikit-learn/scikit-learn Project-URL: download, https://pypi.org/project/scikit-learn/#files Project-URL: tracker, https://github.com/scikit-learn/scikit-learn/issues Project-URL: release notes, https://scikit-learn.org/stable/whats_new Requires-Python: >=3.10 Requires-Dist: numpy>=1.22.0 Requires-Dist: scipy>=1.8.0 Requires-Dist: joblib>=1.2.0 Requires-Dist: threadpoolctl>=3.1.0 Provides-Extra: build Requires-Dist: numpy>=1.22.0; extra == "build" Requires-Dist: scipy>=1.8.0; extra == "build" Requires-Dist: cython>=3.0.10; extra == "build" Requires-Dist: meson-python>=0.17.1; extra == "build" Provides-Extra: install Requires-Dist: numpy>=1.22.0; extra == "install" Requires-Dist: scipy>=1.8.0; extra == "install" Requires-Dist: joblib>=1.2.0; extra == "install" Requires-Dist: threadpoolctl>=3.1.0; extra == "install" Provides-Extra: benchmark Requires-Dist: matplotlib>=3.5.0; extra == "benchmark" Requires-Dist: pandas>=1.4.0; extra == "benchmark" Requires-Dist: memory_profiler>=0.57.0; extra == "benchmark" Provides-Extra: docs Requires-Dist: matplotlib>=3.5.0; extra == "docs" Requires-Dist: scikit-image>=0.19.0; extra == "docs" Requires-Dist: pandas>=1.4.0; extra == "docs" Requires-Dist: seaborn>=0.9.0; extra == "docs" Requires-Dist: memory_profiler>=0.57.0; extra == "docs" Requires-Dist: sphinx>=7.3.7; extra == "docs" Requires-Dist: sphinx-copybutton>=0.5.2; extra == "docs" Requires-Dist: sphinx-gallery>=0.17.1; extra == "docs" Requires-Dist: numpydoc>=1.2.0; extra == "docs" Requires-Dist: Pillow>=8.4.0; extra == "docs" Requires-Dist: pooch>=1.6.0; extra == "docs" Requires-Dist: sphinx-prompt>=1.4.0; extra == "docs" Requires-Dist: sphinxext-opengraph>=0.9.1; extra == "docs" Requires-Dist: plotly>=5.14.0; extra == "docs" Requires-Dist: polars>=0.20.30; extra == "docs" Requires-Dist: sphinx-design>=0.5.0; extra == "docs" Requires-Dist: sphinx-design>=0.6.0; extra == "docs" Requires-Dist: sphinxcontrib-sass>=0.3.4; extra == "docs" Requires-Dist: pydata-sphinx-theme>=0.15.3; extra == "docs" Requires-Dist: sphinx-remove-toctrees>=1.0.0.post1; extra == "docs" Requires-Dist: towncrier>=24.8.0; extra == "docs" Provides-Extra: examples Requires-Dist: matplotlib>=3.5.0; extra == "examples" Requires-Dist: scikit-image>=0.19.0; extra == "examples" Requires-Dist: pandas>=1.4.0; extra == "examples" Requires-Dist: seaborn>=0.9.0; extra == "examples" Requires-Dist: pooch>=1.6.0; extra == "examples" Requires-Dist: plotly>=5.14.0; extra == "examples" Provides-Extra: tests Requires-Dist: matplotlib>=3.5.0; extra == "tests" Requires-Dist: scikit-image>=0.19.0; extra == "tests" Requires-Dist: pandas>=1.4.0; extra == "tests" Requires-Dist: pytest>=7.1.2; extra == "tests" Requires-Dist: pytest-cov>=2.9.0; extra == "tests" Requires-Dist: ruff>=0.11.7; extra == "tests" Requires-Dist: mypy>=1.15; extra == "tests" Requires-Dist: pyamg>=4.2.1; extra == "tests" Requires-Dist: polars>=0.20.30; extra == "tests" Requires-Dist: pyarrow>=12.0.0; extra == "tests" Requires-Dist: numpydoc>=1.2.0; extra == "tests" Requires-Dist: pooch>=1.6.0; extra == "tests" Provides-Extra: maintenance Requires-Dist: conda-lock==3.0.1; extra == "maintenance" Description-Content-Type: text/x-rst .. -*- mode: rst -*- |Azure| |Codecov| |CircleCI| |Nightly wheels| |Ruff| |PythonVersion| |PyPi| |DOI| |Benchmark| .. |Azure| image:: https://dev.azure.com/scikit-learn/scikit-learn/_apis/build/status/scikit-learn.scikit-learn?branchName=main :target: https://dev.azure.com/scikit-learn/scikit-learn/_build/latest?definitionId=1&branchName=main .. |CircleCI| image:: https://circleci.com/gh/scikit-learn/scikit-learn/tree/main.svg?style=shield :target: https://circleci.com/gh/scikit-learn/scikit-learn .. |Codecov| image:: https://codecov.io/gh/scikit-learn/scikit-learn/branch/main/graph/badge.svg?token=Pk8G9gg3y9 :target: https://codecov.io/gh/scikit-learn/scikit-learn .. |Nightly wheels| image:: https://github.com/scikit-learn/scikit-learn/actions/workflows/wheels.yml/badge.svg?event=schedule :target: https://github.com/scikit-learn/scikit-learn/actions?query=workflow%3A%22Wheel+builder%22+event%3Aschedule .. |Ruff| image:: https://img.shields.io/badge/code%20style-ruff-000000.svg :target: https://github.com/astral-sh/ruff .. |PythonVersion| image:: https://img.shields.io/pypi/pyversions/scikit-learn.svg :target: https://pypi.org/project/scikit-learn/ .. |PyPi| image:: https://img.shields.io/pypi/v/scikit-learn :target: https://pypi.org/project/scikit-learn .. |DOI| image:: https://zenodo.org/badge/21369/scikit-learn/scikit-learn.svg :target: https://zenodo.org/badge/latestdoi/21369/scikit-learn/scikit-learn .. |Benchmark| image:: https://img.shields.io/badge/Benchmarked%20by-asv-blue :target: https://scikit-learn.org/scikit-learn-benchmarks .. |PythonMinVersion| replace:: 3.10 .. |NumPyMinVersion| replace:: 1.22.0 .. |SciPyMinVersion| replace:: 1.8.0 .. |JoblibMinVersion| replace:: 1.2.0 .. |ThreadpoolctlMinVersion| replace:: 3.1.0 .. |MatplotlibMinVersion| replace:: 3.5.0 .. |Scikit-ImageMinVersion| replace:: 0.19.0 .. |PandasMinVersion| replace:: 1.4.0 .. |SeabornMinVersion| replace:: 0.9.0 .. |PytestMinVersion| replace:: 7.1.2 .. |PlotlyMinVersion| replace:: 5.14.0 .. image:: https://raw.githubusercontent.com/scikit-learn/scikit-learn/main/doc/logos/scikit-learn-logo.png :target: https://scikit-learn.org/ **scikit-learn** is a Python module for machine learning built on top of SciPy and is distributed under the 3-Clause BSD license. The project was started in 2007 by David Cournapeau as a Google Summer of Code project, and since then many volunteers have contributed. See the `About us `__ page for a list of core contributors. It is currently maintained by a team of volunteers. Website: https://scikit-learn.org Installation ------------ Dependencies ~~~~~~~~~~~~ scikit-learn requires: - Python (>= |PythonMinVersion|) - NumPy (>= |NumPyMinVersion|) - SciPy (>= |SciPyMinVersion|) - joblib (>= |JoblibMinVersion|) - threadpoolctl (>= |ThreadpoolctlMinVersion|) ======= Scikit-learn plotting capabilities (i.e., functions start with ``plot_`` and classes end with ``Display``) require Matplotlib (>= |MatplotlibMinVersion|). For running the examples Matplotlib >= |MatplotlibMinVersion| is required. A few examples require scikit-image >= |Scikit-ImageMinVersion|, a few examples require pandas >= |PandasMinVersion|, some examples require seaborn >= |SeabornMinVersion| and plotly >= |PlotlyMinVersion|. User installation ~~~~~~~~~~~~~~~~~ If you already have a working installation of NumPy and SciPy, the easiest way to install scikit-learn is using ``pip``:: pip install -U scikit-learn or ``conda``:: conda install -c conda-forge scikit-learn The documentation includes more detailed `installation instructions `_. Changelog --------- See the `changelog `__ for a history of notable changes to scikit-learn. Development ----------- We welcome new contributors of all experience levels. The scikit-learn community goals are to be helpful, welcoming, and effective. The `Development Guide `_ has detailed information about contributing code, documentation, tests, and more. We've included some basic information in this README. Important links ~~~~~~~~~~~~~~~ - Official source code repo: https://github.com/scikit-learn/scikit-learn - Download releases: https://pypi.org/project/scikit-learn/ - Issue tracker: https://github.com/scikit-learn/scikit-learn/issues Source code ~~~~~~~~~~~ You can check the latest sources with the command:: git clone https://github.com/scikit-learn/scikit-learn.git Contributing ~~~~~~~~~~~~ To learn more about making a contribution to scikit-learn, please see our `Contributing guide `_. Testing ~~~~~~~ After installation, you can launch the test suite from outside the source directory (you will need to have ``pytest`` >= |PyTestMinVersion| installed):: pytest sklearn See the web page https://scikit-learn.org/dev/developers/contributing.html#testing-and-improving-test-coverage for more information. Random number generation can be controlled during testing by setting the ``SKLEARN_SEED`` environment variable. Submitting a Pull Request ~~~~~~~~~~~~~~~~~~~~~~~~~ Before opening a Pull Request, have a look at the full Contributing page to make sure your code complies with our guidelines: https://scikit-learn.org/stable/developers/index.html Project History --------------- The project was started in 2007 by David Cournapeau as a Google Summer of Code project, and since then many volunteers have contributed. See the `About us `__ page for a list of core contributors. The project is currently maintained by a team of volunteers. **Note**: `scikit-learn` was previously referred to as `scikits.learn`. Help and Support ---------------- Documentation ~~~~~~~~~~~~~ - HTML documentation (stable release): https://scikit-learn.org - HTML documentation (development version): https://scikit-learn.org/dev/ - FAQ: https://scikit-learn.org/stable/faq.html Communication ~~~~~~~~~~~~~ Main Channels ^^^^^^^^^^^^^ - **Website**: https://scikit-learn.org - **Blog**: https://blog.scikit-learn.org - **Mailing list**: https://mail.python.org/mailman/listinfo/scikit-learn Developer & Support ^^^^^^^^^^^^^^^^^^^^^^ - **GitHub Discussions**: https://github.com/scikit-learn/scikit-learn/discussions - **Stack Overflow**: https://stackoverflow.com/questions/tagged/scikit-learn - **Discord**: https://discord.gg/h9qyrK8Jc8 Social Media Platforms ^^^^^^^^^^^^^^^^^^^^^^ - **LinkedIn**: https://www.linkedin.com/company/scikit-learn - **YouTube**: https://www.youtube.com/channel/UCJosFjYm0ZYVUARxuOZqnnw/playlists - **Facebook**: https://www.facebook.com/scikitlearnofficial/ - **Instagram**: https://www.instagram.com/scikitlearnofficial/ - **TikTok**: https://www.tiktok.com/@scikit.learn - **Bluesky**: https://bsky.app/profile/scikit-learn.org - **Mastodon**: https://mastodon.social/@sklearn@fosstodon.org Resources ^^^^^^^^^ - **Calendar**: https://blog.scikit-learn.org/calendar/ - **Logos & Branding**: https://github.com/scikit-learn/scikit-learn/tree/main/doc/logos Citation ~~~~~~~~ If you use scikit-learn in a scientific publication, we would appreciate citations: https://scikit-learn.org/stable/about.html#citing-scikit-learn