From a303cc6b483d3cd958c399621e22e40574bcbbc8 Mon Sep 17 00:00:00 2001 From: RĂ©mi Flamary Date: Tue, 21 Apr 2020 17:48:37 +0200 Subject: [MRG] Actually run sphinx-gallery (#146) * generate gallery * remove mock * add sklearn to requirermnt?txt for example * remove latex from fgw example * add networks for graph example * remove all * add requirement.txt rtd * rtd debug * update readme * eradthedoc with redirection * add conf rtd --- docs/source/readme.rst | 61 +++++++++++++++++++++++++++++--------------------- 1 file changed, 35 insertions(+), 26 deletions(-) (limited to 'docs/source/readme.rst') diff --git a/docs/source/readme.rst b/docs/source/readme.rst index 4f6af01..279e5da 100644 --- a/docs/source/readme.rst +++ b/docs/source/readme.rst @@ -1,14 +1,16 @@ POT: Python Optimal Transport ============================= -|PyPI version| |Anaconda Cloud| |Build Status| |Documentation Status| +|PyPI version| |Anaconda Cloud| |Build Status| |Codecov Status| |Downloads| |Anaconda downloads| |License| This open source Python library provide several solvers for optimization problems related to Optimal Transport for signal, image processing and machine learning. -It provides the following solvers: +Website and documentation: https://PythonOT.github.io/ + +POT provides the following solvers: - OT Network Flow solver for the linear program/ Earth Movers Distance [1]. @@ -24,7 +26,7 @@ It provides the following solvers: - Bregman projections for Wasserstein barycenter [3], convolutional barycenter [21] and unmixing [4]. - Optimal transport for domain adaptation with group lasso - regularization [5] + regularization and Laplacian regularization [5][30] - Conditional gradient [6] and Generalized conditional gradient for regularized OT [7]. - Linear OT [14] and Joint OT matrix and mapping estimation [8]. @@ -180,45 +182,45 @@ Examples and Notebooks The examples folder contain several examples and use case for the library. The full documentation is available on -`Readthedocs `__. +https://PythonOT.github.io/. Here is a list of the Python notebooks available -`here `__ if you +`here `__ if you want a quick look: - `1D optimal - transport `__ + transport `__ - `OT Ground - Loss `__ + Loss `__ - `Multiple EMD - computation `__ + computation `__ - `2D optimal transport on empirical - distributions `__ + distributions `__ - `1D Wasserstein - barycenter `__ + barycenter `__ - `OT with user provided - regularization `__ + regularization `__ - `Domain adaptation with optimal - transport `__ + transport `__ - `Color transfer in - images `__ + images `__ - `OT mapping estimation for domain - adaptation `__ + adaptation `__ - `OT mapping estimation for color transfer in - images `__ + images `__ - `Wasserstein Discriminant - Analysis `__ + Analysis `__ - `Gromov - Wasserstein `__ + Wasserstein `__ - `Gromov Wasserstein - Barycenter `__ + Barycenter `__ - `Fused Gromov - Wasserstein `__ + Wasserstein `__ - `Fused Gromov Wasserstein - Barycenter `__ + Barycenter `__ You can also see the notebooks with `Jupyter -nbviewer `__. +nbviewer `__. Acknowledgements ---------------- @@ -247,6 +249,7 @@ The contributors to this library are - `Hicham Janati `__ (Unbalanced OT) - `Romain Tavenard `__ (1d Wasserstein) - `Mokhtar Z. Alaya `__ (Screenkhorn) +- `Ievgen Redko `__ This toolbox benefit a lot from open source research and we would like to thank the following persons for providing some code (in various @@ -422,17 +425,23 @@ Gromov-Wasserstein with Applications on Positive-Unlabeled Learning `__, arXiv preprint arXiv:2002.08276. +[30] Flamary R., Courty N., Tuia D., Rakotomamonjy A. (2014). `Optimal +transport with Laplacian regularization: Applications to domain +adaptation and shape +matching `__, +NIPS Workshop on Optimal Transport and Machine Learning OTML, 2014. + .. |PyPI version| image:: https://badge.fury.io/py/POT.svg :target: https://badge.fury.io/py/POT .. |Anaconda Cloud| image:: https://anaconda.org/conda-forge/pot/badges/version.svg :target: https://anaconda.org/conda-forge/pot -.. |Build Status| image:: https://travis-ci.org/rflamary/POT.svg?branch=master - :target: https://travis-ci.org/rflamary/POT -.. |Documentation Status| image:: https://readthedocs.org/projects/pot/badge/?version=latest - :target: http://pot.readthedocs.io/en/latest/?badge=latest +.. |Build Status| image:: https://travis-ci.org/PythonOT/POT.svg?branch=master + :target: https://travis-ci.org/PythonOT/POT +.. |Codecov Status| image:: https://codecov.io/gh/PythonOT/POT/branch/master/graph/badge.svg + :target: https://codecov.io/gh/PythonOT/POT .. |Downloads| image:: https://pepy.tech/badge/pot :target: https://pepy.tech/project/pot .. |Anaconda downloads| image:: https://anaconda.org/conda-forge/pot/badges/downloads.svg :target: https://anaconda.org/conda-forge/pot .. |License| image:: https://anaconda.org/conda-forge/pot/badges/license.svg - :target: https://github.com/rflamary/POT/blob/master/LICENSE + :target: https://github.com/PythonOT/POT/blob/master/LICENSE -- cgit v1.2.3