416 lines
18 KiB
Plaintext
416 lines
18 KiB
Plaintext
Metadata-Version: 2.1
|
|
Name: scikit-learn
|
|
Version: 1.6.1
|
|
Summary: A set of python modules for machine learning and data mining
|
|
Maintainer-Email: scikit-learn developers <scikit-learn@python.org>
|
|
License: BSD 3-Clause License
|
|
|
|
Copyright (c) 2007-2024 The scikit-learn developers.
|
|
All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are met:
|
|
|
|
* Redistributions of source code must retain the above copyright notice, this
|
|
list of conditions and the following disclaimer.
|
|
|
|
* Redistributions in binary form must reproduce the above copyright notice,
|
|
this list of conditions and the following disclaimer in the documentation
|
|
and/or other materials provided with the distribution.
|
|
|
|
* Neither the name of the copyright holder nor the names of its
|
|
contributors may be used to endorse or promote products derived from
|
|
this software without specific prior written permission.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
|
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
----
|
|
|
|
This binary distribution of scikit-learn also bundles the following software:
|
|
|
|
----
|
|
|
|
Name: GCC runtime library
|
|
Files: scikit_learn.libs/libgomp*.so*
|
|
Availability: https://gcc.gnu.org/git/?p=gcc.git;a=tree;f=libgomp
|
|
|
|
GCC RUNTIME LIBRARY EXCEPTION
|
|
|
|
Version 3.1, 31 March 2009
|
|
|
|
Copyright (C) 2009 Free Software Foundation, Inc. <http://fsf.org/>
|
|
|
|
Everyone is permitted to copy and distribute verbatim copies of this
|
|
license document, but changing it is not allowed.
|
|
|
|
This GCC Runtime Library Exception ("Exception") is an additional
|
|
permission under section 7 of the GNU General Public License, version
|
|
3 ("GPLv3"). It applies to a given file (the "Runtime Library") that
|
|
bears a notice placed by the copyright holder of the file stating that
|
|
the file is governed by GPLv3 along with this Exception.
|
|
|
|
When you use GCC to compile a program, GCC may combine portions of
|
|
certain GCC header files and runtime libraries with the compiled
|
|
program. The purpose of this Exception is to allow compilation of
|
|
non-GPL (including proprietary) programs to use, in this way, the
|
|
header files and runtime libraries covered by this Exception.
|
|
|
|
0. Definitions.
|
|
|
|
A file is an "Independent Module" if it either requires the Runtime
|
|
Library for execution after a Compilation Process, or makes use of an
|
|
interface provided by the Runtime Library, but is not otherwise based
|
|
on the Runtime Library.
|
|
|
|
"GCC" means a version of the GNU Compiler Collection, with or without
|
|
modifications, governed by version 3 (or a specified later version) of
|
|
the GNU General Public License (GPL) with the option of using any
|
|
subsequent versions published by the FSF.
|
|
|
|
"GPL-compatible Software" is software whose conditions of propagation,
|
|
modification and use would permit combination with GCC in accord with
|
|
the license of GCC.
|
|
|
|
"Target Code" refers to output from any compiler for a real or virtual
|
|
target processor architecture, in executable form or suitable for
|
|
input to an assembler, loader, linker and/or execution
|
|
phase. Notwithstanding that, Target Code does not include data in any
|
|
format that is used as a compiler intermediate representation, or used
|
|
for producing a compiler intermediate representation.
|
|
|
|
The "Compilation Process" transforms code entirely represented in
|
|
non-intermediate languages designed for human-written code, and/or in
|
|
Java Virtual Machine byte code, into Target Code. Thus, for example,
|
|
use of source code generators and preprocessors need not be considered
|
|
part of the Compilation Process, since the Compilation Process can be
|
|
understood as starting with the output of the generators or
|
|
preprocessors.
|
|
|
|
A Compilation Process is "Eligible" if it is done using GCC, alone or
|
|
with other GPL-compatible software, or if it is done without using any
|
|
work based on GCC. For example, using non-GPL-compatible Software to
|
|
optimize any GCC intermediate representations would not qualify as an
|
|
Eligible Compilation Process.
|
|
|
|
1. Grant of Additional Permission.
|
|
|
|
You have permission to propagate a work of Target Code formed by
|
|
combining the Runtime Library with Independent Modules, even if such
|
|
propagation would otherwise violate the terms of GPLv3, provided that
|
|
all Target Code was generated by Eligible Compilation Processes. You
|
|
may then convey such a combination under terms of your choice,
|
|
consistent with the licensing of the Independent Modules.
|
|
|
|
2. No Weakening of GCC Copyleft.
|
|
|
|
The availability of this Exception does not imply any general
|
|
presumption that third-party software is unaffected by the copyleft
|
|
requirements of the license of GCC.
|
|
|
|
Classifier: Intended Audience :: Science/Research
|
|
Classifier: Intended Audience :: Developers
|
|
Classifier: License :: OSI Approved :: BSD License
|
|
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.9
|
|
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.9
|
|
Requires-Dist: numpy>=1.19.5
|
|
Requires-Dist: scipy>=1.6.0
|
|
Requires-Dist: joblib>=1.2.0
|
|
Requires-Dist: threadpoolctl>=3.1.0
|
|
Provides-Extra: build
|
|
Requires-Dist: numpy>=1.19.5; extra == "build"
|
|
Requires-Dist: scipy>=1.6.0; extra == "build"
|
|
Requires-Dist: cython>=3.0.10; extra == "build"
|
|
Requires-Dist: meson-python>=0.16.0; extra == "build"
|
|
Provides-Extra: install
|
|
Requires-Dist: numpy>=1.19.5; extra == "install"
|
|
Requires-Dist: scipy>=1.6.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.3.4; extra == "benchmark"
|
|
Requires-Dist: pandas>=1.1.5; extra == "benchmark"
|
|
Requires-Dist: memory_profiler>=0.57.0; extra == "benchmark"
|
|
Provides-Extra: docs
|
|
Requires-Dist: matplotlib>=3.3.4; extra == "docs"
|
|
Requires-Dist: scikit-image>=0.17.2; extra == "docs"
|
|
Requires-Dist: pandas>=1.1.5; 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>=7.1.2; 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.3.4; extra == "examples"
|
|
Requires-Dist: scikit-image>=0.17.2; extra == "examples"
|
|
Requires-Dist: pandas>=1.1.5; 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.3.4; extra == "tests"
|
|
Requires-Dist: scikit-image>=0.17.2; extra == "tests"
|
|
Requires-Dist: pandas>=1.1.5; extra == "tests"
|
|
Requires-Dist: pytest>=7.1.2; extra == "tests"
|
|
Requires-Dist: pytest-cov>=2.9.0; extra == "tests"
|
|
Requires-Dist: ruff>=0.5.1; extra == "tests"
|
|
Requires-Dist: black>=24.3.0; extra == "tests"
|
|
Requires-Dist: mypy>=1.9; extra == "tests"
|
|
Requires-Dist: pyamg>=4.0.0; 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==2.5.6; extra == "maintenance"
|
|
Description-Content-Type: text/x-rst
|
|
|
|
.. -*- mode: rst -*-
|
|
|
|
|Azure| |CirrusCI| |Codecov| |CircleCI| |Nightly wheels| |Black| |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
|
|
|
|
.. |CirrusCI| image:: https://img.shields.io/cirrus/github/scikit-learn/scikit-learn/main?label=Cirrus%20CI
|
|
:target: https://cirrus-ci.com/github/scikit-learn/scikit-learn/main
|
|
|
|
.. |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/workflows/Wheel%20builder/badge.svg?event=schedule
|
|
:target: https://github.com/scikit-learn/scikit-learn/actions?query=workflow%3A%22Wheel+builder%22+event%3Aschedule
|
|
|
|
.. |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
|
|
|
|
.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
|
|
:target: https://github.com/psf/black
|
|
|
|
.. |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.9
|
|
.. |NumPyMinVersion| replace:: 1.19.5
|
|
.. |SciPyMinVersion| replace:: 1.6.0
|
|
.. |JoblibMinVersion| replace:: 1.2.0
|
|
.. |ThreadpoolctlMinVersion| replace:: 3.1.0
|
|
.. |MatplotlibMinVersion| replace:: 3.3.4
|
|
.. |Scikit-ImageMinVersion| replace:: 0.17.2
|
|
.. |PandasMinVersion| replace:: 1.1.5
|
|
.. |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 <https://scikit-learn.org/dev/about.html#authors>`__ 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 0.20 was the last version to support Python 2.7 and Python 3.4.**
|
|
scikit-learn 1.0 and later require Python 3.7 or newer.
|
|
scikit-learn 1.1 and later require Python 3.8 or newer.
|
|
|
|
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 <https://scikit-learn.org/stable/install.html>`_.
|
|
|
|
|
|
Changelog
|
|
---------
|
|
|
|
See the `changelog <https://scikit-learn.org/dev/whats_new.html>`__
|
|
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 <https://scikit-learn.org/stable/developers/index.html>`_
|
|
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
|
|
<https://scikit-learn.org/dev/developers/contributing.html>`_.
|
|
|
|
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 <https://scikit-learn.org/dev/about.html#authors>`__ 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
|
|
~~~~~~~~~~~~~
|
|
|
|
- Mailing list: https://mail.python.org/mailman/listinfo/scikit-learn
|
|
- Logos & Branding: https://github.com/scikit-learn/scikit-learn/tree/main/doc/logos
|
|
- Blog: https://blog.scikit-learn.org
|
|
- Calendar: https://blog.scikit-learn.org/calendar/
|
|
- Twitter: https://twitter.com/scikit_learn
|
|
- Stack Overflow: https://stackoverflow.com/questions/tagged/scikit-learn
|
|
- GitHub Discussions: https://github.com/scikit-learn/scikit-learn/discussions
|
|
- Website: https://scikit-learn.org
|
|
- LinkedIn: https://www.linkedin.com/company/scikit-learn
|
|
- Bluesky: https://bsky.app/profile/scikit-learn.org
|
|
- 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
|
|
- Mastodon: https://mastodon.social/@sklearn@fosstodon.org
|
|
- Discord: https://discord.gg/h9qyrK8Jc8
|
|
|
|
|
|
Citation
|
|
~~~~~~~~
|
|
|
|
If you use scikit-learn in a scientific publication, we would appreciate citations: https://scikit-learn.org/stable/about.html#citing-scikit-learn
|