[WIP] quantized gromov wasserstein solver

[cedricvincentcuaz]

Types of changes

Implementation of first solvers for the quantized Fused Gromov-Wasserstein (qFGW) distance.

• creation of new files ot/gromov/_quantized.py and test/gromov/test_quantized.py .
• quantized_fused_gromov_wasserstein_partitioned : main function to compute the OT between two partitioned joint spaces with minimal inputs to compute global and local alignments, so that the user can perform any partitioning and representant selection as pre-processing. A boolean option build_OT allows the user to construct the OT matrix between non-partitioned spaces which might require a lot of memory. Other inputs mainly relate to inner fused_gromov_wasserstein, gromov_wasserstein and emd_1d solvers.

remark 1 : i) only the (F)GW conditional gradient solver is considered here. Note that authors also made use of the entropic projected gradient solver. ii) only the square loss is considered for both types of OT problems.

• quantized_fused_gromov_wasserstein: main function to compute the OT between two joint spaces with axioms used by authors to partition both spaces. Taking as inputs structure matrices C1 and C2 treated as graphs, optionally as feature matrices F1 and F2, optionally other structure matrices C1_aux and C2_aux used for partitioning and representant selection implemented in get_graph_partition and get_graph_representants.

• quantized_fused_gromov_wasserstein_samples: main function to compute the OT between two distributions in different spaces potentially endowed with features, with axioms used by authors to partition both spaces. Taking as inputs samples X1 and X2 endowed with an euclidean geometry on their respective space, optionally with feature matrices F1 and F2, where both can be considered for partitioning and representant selection (e.g kmeans) implemented in get_partition_and_representants_samples.

Motivation and context / Related issue

How has this been tested (if it applies)

• tests for all configurations in test.test_gromov.py::test_quantized_gromov

PR checklist

• I have read the CONTRIBUTING document.
• The documentation is up-to-date with the changes I made (check build artifacts).
• All tests passed, and additional code has been covered with new tests.
• I have added the PR and Issue fix to the RELEASES.md file.

[codecov]

Codecov Report

Attention: Patch coverage is 93.47826% with 36 lines in your changes are missing coverage. Please review.

Project coverage is 96.67%. Comparing base (2472dd4) to head (096955a).

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #603      +/-   ##
==========================================
- Coverage   96.78%   96.67%   -0.11%     
==========================================
  Files          83       85       +2     
  Lines       16284    16836     +552     
==========================================
+ Hits        15760    16276     +516     
- Misses        524      560      +36     

[rflamary]

This is nice, I have a few comments below, contact me on slack if you want to discuss them