introduce `sinkdiv` simplified API, expand glossary with sinkhorn divergence and LR sinkhorn

[marcocuturi]

This PR introduces a few enhancements:

• introduces a sinkdiv convenience wrapper to compute the Sinkhorn divergence between two point clouds. Using the sinkhorn_divergence method was a bit clumsy in that case, since it required passing first the PointCloud geometry type, clearly overkill for most usages.

• introduces the possiblity to store the reg_ot_cost between the second point cloud (in a sinkhorn divergence) and itself and use it as an offset. This is useful when one wants to track the true Sinkhorn divergence between two point clouds but do not want to recompute that term at every iteration, say, of a Gradient descent. that quantity is calledoffset_static_b

• corrects a bug in the plot class, whereby titles were ignored when the show_lines flag was False

• expands glossary.rst

[review-notebook-app[bot]]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[codecov[bot]]

Codecov Report

Attention: Patch coverage is 85.71429% with 1 line in your changes missing coverage. Please review.

Project coverage is 88.17%. Comparing base (828acca) to head (b7f8624). Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/ott/tools/plot.py	75.00%	0 Missing and 1 partial :warning:

Additional details and impacted files

[](https://app.codecov.io/gh/ott-jax/ott/pull/596?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ott-jax) ```diff @@ Coverage Diff @@ ## main #596 +/- ## ========================================== + Coverage 88.13% 88.17% +0.04% ========================================== Files 73 73 Lines 7768 7770 +2 Branches 556 556 ========================================== + Hits 6846 6851 +5 + Misses 779 778 -1 + Partials 143 141 -2 ``` | [Files with missing lines](https://app.codecov.io/gh/ott-jax/ott/pull/596?dropdown=coverage&src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ott-jax) | Coverage Δ | | |---|---|---| | [src/ott/solvers/linear/sinkhorn\_lr.py](https://app.codecov.io/gh/ott-jax/ott/pull/596?src=pr&el=tree&filepath=src%2Fott%2Fsolvers%2Flinear%2Fsinkhorn_lr.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ott-jax#diff-c3JjL290dC9zb2x2ZXJzL2xpbmVhci9zaW5raG9ybl9sci5weQ==) | `98.98% <ø> (ø)` | | | [src/ott/tools/sinkhorn\_divergence.py](https://app.codecov.io/gh/ott-jax/ott/pull/596?src=pr&el=tree&filepath=src%2Fott%2Ftools%2Fsinkhorn_divergence.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ott-jax#diff-c3JjL290dC90b29scy9zaW5raG9ybl9kaXZlcmdlbmNlLnB5) | `94.31% <100.00%> (+2.45%)` | :arrow_up: | | [src/ott/tools/plot.py](https://app.codecov.io/gh/ott-jax/ott/pull/596?src=pr&el=tree&filepath=src%2Fott%2Ftools%2Fplot.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ott-jax#diff-c3JjL290dC90b29scy9wbG90LnB5) | `54.09% <75.00%> (ø)` | | ... and [1 file with indirect coverage changes](https://app.codecov.io/gh/ott-jax/ott/pull/596/indirect-changes?src=pr&el=tree-more&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=ott-jax)