Metadata-Version: 2.1
Name: giotto-learn
Version: 0.1.0
Summary: Toolbox for Machine Learning using Topological Data Analysis.
Home-page: https://github.com/giotto-learn/giotto-learn
Maintainer: Guillaume Tauzin
Maintainer-email: maintainers@giotto.ai
License: Apache 2.0
Download-URL: https://github.com/giotto-learn/giotto-learn/tarball/v0.1.0
Keywords: machine learning topological data analysis persistent homology,persistence diagrams
Platform: UNKNOWN
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved
Classifier: Programming Language :: C
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development
Classifier: Topic :: Scientific/Engineering
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/x-rst
Provides-Extra: tests
Provides-Extra: doc
Provides-Extra: examples
Requires-Dist: numpy (>=1.17.0)
Requires-Dist: scipy (>=0.17.0)
Requires-Dist: scikit-learn (>=0.21.3)
Requires-Dist: joblib (>=0.11)
Provides-Extra: doc
Requires-Dist: sphinx; extra == 'doc'
Requires-Dist: sphinx-gallery; extra == 'doc'
Requires-Dist: sphinx-issues; extra == 'doc'
Requires-Dist: sphinx-rtd-theme; extra == 'doc'
Requires-Dist: numpydoc; extra == 'doc'
Provides-Extra: examples
Requires-Dist: jupyter; extra == 'examples'
Requires-Dist: matplotlib; extra == 'examples'
Requires-Dist: plotly; extra == 'examples'
Provides-Extra: tests
Requires-Dist: pytest; extra == 'tests'
Requires-Dist: pytest-cov; extra == 'tests'
Requires-Dist: pytest-azurepipelines; extra == 'tests'
Requires-Dist: pytest-benchmark; extra == 'tests'
Requires-Dist: jupyter-contrib-nbextensions; extra == 'tests'
Requires-Dist: flake8; extra == 'tests'


|Azure|_ |Azure-cov|_ |Azure-test|_ |binder|_

.. |Azure| image:: https://dev.azure.com/giotto-learn/giotto-learn/_apis/build/status/giotto-learn.giotto-learn?branchName=master
.. _Azure: https://dev.azure.com/giotto-learn/giotto-learn/

.. |Azure-cov| image:: https://img.shields.io/badge/Coverage-93%25-passed
.. _Azure-cov: https://dev.azure.com/giotto-learn/giotto-learn/_build/results?buildId=342&view=codecoverage-tab

.. |Azure-test| image:: https://img.shields.io/badge/Testing-Passed-brightgreen
.. _Azure-test: https://dev.azure.com/giotto-learn/giotto-learn/_build/results?buildId=342&view=ms.vss-test-web.build-test-results-tab

.. |binder| image:: https://mybinder.org/badge_logo.svg
.. _binder: https://mybinder.org/v2/gh/giotto-learn/giotto-learn/master?filepath=examples

giotto-learn
============


giotto-learn is a high performance topological toolbox for machine learning in Python built on top of
scikit-learn and is distributed under the Apache 2.0 license. It is part of the Giotto open-source project.


Project Governance
------------------

The project was started jointly by `Learn To Forecast - L2F <http://www.l2f.ch>`_, `EPFL Laboratory for topology and neuroscience <https://www.epfl.ch/labs/hessbellwald-lab/>`_ and the `Reconfigurable and Embedded Digital Systems <http://reds.heig-vd.ch/en>`_ at heig-vd.

The code is under active development and is maintained and developed by members of those three institutions. See the `GOVERNANCE.rst <https://github.com/giotto-learn/giotto-learn/blob/master/GOVERNANCE.rst>`_ file for a list of the Giotto team members.

Website: http://www.giotto.ai


Installation
------------

Dependencies
~~~~~~~~~~~~

giotto-learn requires:

- Python (>= 3.5)
- scikit-learn (>= 0.21.3)
- NumPy (>= 1.11.0)
- SciPy (>= 0.17.0)
- joblib (>= 0.11)

For running the examples jupyter, matplotlib and plotly are required.

User installation
~~~~~~~~~~~~~~~~~

If you already have a working installation of numpy and scipy,
the easiest way to install giotto-learn is using ``pip``   ::

    pip install -U giotto-learn

Documentation
-------------

- HTML documentation (stable release): http://www.giotto.ai/docs/

Contributing
------------

We welcome new contributors of all experience levels. The Giotto
community goals are to be helpful, welcoming, and effective. To learn more about
making a contribution to giotto-learn, please see the `CONTRIBUTING.rst
<https://github.com/giotto-learn/giotto-learn/blob/master/CONTRIBUTING.rst>`_ file.

Developer installation
~~~~~~~~~~~~~~~~~~~~~~~

C++ dependencies:
'''''''''''''''''

-  C++14 compatible compiler
-  CMake >= 3.9
-  Boost >= 1.56

Source code
'''''''''''

You can check the latest sources with the command::

    git clone https://github.com/giotto-learn/giotto-learn.git


To install:
'''''''''''

.. code-block:: bash

   cd giotto-learn
   pip install -e .

From there any change in the library files will be immediately available on your machine.

Testing
~~~~~~~

After installation, you can launch the test suite from outside the
source directory::

    pytest giotto


Changelog
---------

See the `RELEASE.rst <https://github.com/giotto-learn/giotto-learn/blob/master/RELEASE.rst>`__ file
for a history of notable changes to giotto-learn.

Important links
~~~~~~~~~~~~~~~

- Official source code repo: https://github.com/giotto-learn/giotto-learn
- Download releases: https://pypi.org/project/giotto-learn/
- Issue tracker: https://github.com/giotto-learn/giotto-learn/issues





Contacts:
---------

maintainers@giotto.ai


