Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,16 @@
# CHANGELOG

## v1.0.0 - 10.03.2026
Stable release!

The package is now deemed stable which is supported by the [publication](https://jmlr.org/papers/v26/24-1185.html) of our paper in JMLR!
Please consider citing us if you use the library.

Besides, there are some maintenance updates:
* Constrain versions of dependendencies due to external incompatibilities by
@stoprightthere in
https://github.com/geometric-kernels/GeometricKernels/pull/174 and https://github.com/geometric-kernels/GeometricKernels/pull/175

## v0.4.2 - 11.02.2026
Maintance release (https://github.com/geometric-kernels/GeometricKernels/pull/173).
* Fix compatibility with modern `plum-dispatch`/`numpy`.
Expand Down
14 changes: 9 additions & 5 deletions CITATION.bib
Original file line number Diff line number Diff line change
@@ -1,6 +1,10 @@
@article{mostowsky2024,
title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},
author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},
year = {2024},
journal = {arXiv:2407.08086},
@article{JMLR:v26:24-1185,
author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},
title = {The GeometricKernels Package: Heat and Mat{\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},
journal = {Journal of Machine Learning Research},
year = {2025},
volume = {26},
number = {276},
pages = {1--14},
url = {http://jmlr.org/papers/v26/24-1185.html}
}
9 changes: 7 additions & 2 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -25,5 +25,10 @@ preferred-citation:
given-names: "Alexander"
- family-names: "Borovitskiy"
given-names: "Viacheslav"
year: "2024"
journal: "arXiv:2407.08086"
year: "2025"
journal: "Journal of Machine Learning Research"
volume: "26"
issue: "276"
start: 1
end: 14
url: "http://jmlr.org/papers/v26/24-1185.html"
16 changes: 10 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -198,13 +198,17 @@ This [link](https://github.com/geometric-kernels/GeometricKernels/issues/new?ass

## Citation

If you are using GeometricKernels, please cite the following [paper](https://arxiv.org/pdf/2407.08086):
If you are using GeometricKernels, please cite the following [paper](https://jmlr.org/papers/volume26/24-1185/24-1185.pdf):
```
@article{mostowsky2024,
title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},
author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},
year = {2024},
journal = {arXiv:2407.08086},
@article{JMLR:v26:24-1185,
author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},
title = {The GeometricKernels Package: Heat and Mat{\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},
journal = {Journal of Machine Learning Research},
year = {2025},
volume = {26},
number = {276},
pages = {1--14},
url = {http://jmlr.org/papers/v26/24-1185.html}
}
```

Expand Down
14 changes: 9 additions & 5 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -418,11 +418,15 @@ If you are using GeometricKernels, please cite the `library paper <https://arxiv

.. code-block:: latex

@article{mostowsky2024,
title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},
author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},
year = {2024},
journal = {arXiv:2407.08086},
@article{JMLR:v26:24-1185,
author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},
title = {The GeometricKernels Package: Heat and Mat{\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},
journal = {Journal of Machine Learning Research},
year = {2025},
volume = {26},
number = {276},
pages = {1--14},
url = {http://jmlr.org/papers/v26/24-1185.html}
}

Please also consider citing the theoretical papers the library is based on. You can find the relevant references for any space in
Expand Down
14 changes: 9 additions & 5 deletions notebooks/Graph.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -821,11 +821,15 @@
"If you are using graphs and GeometricKernels, please consider citing\n",
"\n",
"```\n",
"@article{mostowsky2024,\n",
" title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" year = {2024},\n",
" journal = {arXiv:2407.08086},\n",
"@article{JMLR:v26:24-1185,\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" title = {The GeometricKernels Package: Heat and Mat{\\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" journal = {Journal of Machine Learning Research},\n",
" year = {2025},\n",
" volume = {26},\n",
" number = {276},\n",
" pages = {1--14},\n",
" url = {http://jmlr.org/papers/v26/24-1185.html}\n",
"}\n",
"```\n",
"\n",
Expand Down
14 changes: 9 additions & 5 deletions notebooks/GraphEdges.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -1074,11 +1074,15 @@
"If you are using graphs and GeometricKernels, please consider citing\n",
"\n",
"```\n",
"@article{mostowsky2024,\n",
" title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" year = {2024},\n",
" journal = {arXiv:2407.08086},\n",
"@article{JMLR:v26:24-1185,\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" title = {The GeometricKernels Package: Heat and Mat{\\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" journal = {Journal of Machine Learning Research},\n",
" year = {2025},\n",
" volume = {26},\n",
" number = {276},\n",
" pages = {1--14},\n",
" url = {http://jmlr.org/papers/v26/24-1185.html}\n",
"}\n",
"```\n",
"\n",
Expand Down
14 changes: 9 additions & 5 deletions notebooks/HammingGraph.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -694,11 +694,15 @@
"If you are using the HammingGraph space and GeometricKernels, please consider citing\n",
"\n",
"```\n",
"@article{mostowsky2024,\n",
" title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" year = {2024},\n",
" journal = {arXiv:2407.08086},\n",
"@article{JMLR:v26:24-1185,\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" title = {The GeometricKernels Package: Heat and Mat{\\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" journal = {Journal of Machine Learning Research},\n",
" year = {2025},\n",
" volume = {26},\n",
" number = {276},\n",
" pages = {1--14},\n",
" url = {http://jmlr.org/papers/v26/24-1185.html}\n",
"}\n",
"```\n",
"\n",
Expand Down
14 changes: 9 additions & 5 deletions notebooks/Hyperbolic.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -763,11 +763,15 @@
"If you are using hyperbolic spaces and GeometricKernels, please consider citing\n",
"\n",
"```\n",
"@article{mostowsky2024,\n",
" title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" year = {2024},\n",
" journal = {arXiv:2407.08086},\n",
"@article{JMLR:v26:24-1185,\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" title = {The GeometricKernels Package: Heat and Mat{\\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" journal = {Journal of Machine Learning Research},\n",
" year = {2025},\n",
" volume = {26},\n",
" number = {276},\n",
" pages = {1--14},\n",
" url = {http://jmlr.org/papers/v26/24-1185.html}\n",
"}\n",
"```\n",
"\n",
Expand Down
14 changes: 9 additions & 5 deletions notebooks/HypercubeGraph.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -709,11 +709,15 @@
"If you are using the HypercubeGraph space and GeometricKernels, please consider citing\n",
"\n",
"```\n",
"@article{mostowsky2024,\n",
" title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" year = {2024},\n",
" journal = {arXiv:2407.08086},\n",
"@article{JMLR:v26:24-1185,\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" title = {The GeometricKernels Package: Heat and Mat{\\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" journal = {Journal of Machine Learning Research},\n",
" year = {2025},\n",
" volume = {26},\n",
" number = {276},\n",
" pages = {1--14},\n",
" url = {http://jmlr.org/papers/v26/24-1185.html}\n",
"}\n",
"```\n",
"\n",
Expand Down
14 changes: 9 additions & 5 deletions notebooks/Hypersphere.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -732,11 +732,15 @@
"If you are using (hyper)spheres and GeometricKernels, please consider citing\n",
"\n",
"```\n",
"@article{mostowsky2024,\n",
" title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" year = {2024},\n",
" journal = {arXiv:2407.08086},\n",
"@article{JMLR:v26:24-1185,\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" title = {The GeometricKernels Package: Heat and Mat{\\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" journal = {Journal of Machine Learning Research},\n",
" year = {2025},\n",
" volume = {26},\n",
" number = {276},\n",
" pages = {1--14},\n",
" url = {http://jmlr.org/papers/v26/24-1185.html}\n",
"}\n",
"```\n",
"\n",
Expand Down
14 changes: 9 additions & 5 deletions notebooks/Mesh.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -806,11 +806,15 @@
"If you are using meshes and GeometricKernels, please consider citing\n",
"\n",
"```\n",
"@article{mostowsky2024,\n",
" title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" year = {2024},\n",
" journal = {arXiv:2407.08086},\n",
"@article{JMLR:v26:24-1185,\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" title = {The GeometricKernels Package: Heat and Mat{\\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" journal = {Journal of Machine Learning Research},\n",
" year = {2025},\n",
" volume = {26},\n",
" number = {276},\n",
" pages = {1--14},\n",
" url = {http://jmlr.org/papers/v26/24-1185.html}\n",
"}\n",
"```\n",
"\n",
Expand Down
14 changes: 9 additions & 5 deletions notebooks/SPD.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -595,11 +595,15 @@
"If you are using manifolds of symmetric positive definite matrices and GeometricKernels, please consider citing\n",
"\n",
"```\n",
"@article{mostowsky2024,\n",
" title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" year = {2024},\n",
" journal = {arXiv:2407.08086},\n",
"@article{JMLR:v26:24-1185,\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" title = {The GeometricKernels Package: Heat and Mat{\\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" journal = {Journal of Machine Learning Research},\n",
" year = {2025},\n",
" volume = {26},\n",
" number = {276},\n",
" pages = {1--14},\n",
" url = {http://jmlr.org/papers/v26/24-1185.html}\n",
"}\n",
"```\n",
"\n",
Expand Down
14 changes: 9 additions & 5 deletions notebooks/SpecialOrthogonal.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -815,11 +815,15 @@
"If you are using Lie groups and GeometricKernels, please consider citing\n",
"\n",
"```\n",
"@article{mostowsky2024,\n",
" title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" year = {2024},\n",
" journal = {arXiv:2407.08086},\n",
"@article{JMLR:v26:24-1185,\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" title = {The GeometricKernels Package: Heat and Mat{\\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" journal = {Journal of Machine Learning Research},\n",
" year = {2025},\n",
" volume = {26},\n",
" number = {276},\n",
" pages = {1--14},\n",
" url = {http://jmlr.org/papers/v26/24-1185.html}\n",
"}\n",
"```\n",
"\n",
Expand Down
14 changes: 9 additions & 5 deletions notebooks/SpecialUnitary.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -873,11 +873,15 @@
"If you are using Lie groups and GeometricKernels, please consider citing\n",
"\n",
"```\n",
"@article{mostowsky2024,\n",
" title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" year = {2024},\n",
" journal = {arXiv:2407.08086},\n",
"@article{JMLR:v26:24-1185,\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" title = {The GeometricKernels Package: Heat and Mat{\\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" journal = {Journal of Machine Learning Research},\n",
" year = {2025},\n",
" volume = {26},\n",
" number = {276},\n",
" pages = {1--14},\n",
" url = {http://jmlr.org/papers/v26/24-1185.html}\n",
"}\n",
"```\n",
"\n",
Expand Down
14 changes: 9 additions & 5 deletions notebooks/Torus.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -1155,11 +1155,15 @@
"If you are using (hyper)tori and GeometricKernels, please consider citing\n",
"\n",
"```\n",
"@article{mostowsky2024,\n",
" title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" year = {2024},\n",
" journal = {arXiv:2407.08086},\n",
"@article{JMLR:v26:24-1185,\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" title = {The GeometricKernels Package: Heat and Mat{\\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" journal = {Journal of Machine Learning Research},\n",
" year = {2025},\n",
" volume = {26},\n",
" number = {276},\n",
" pages = {1--14},\n",
" url = {http://jmlr.org/papers/v26/24-1185.html}\n",
"}\n",
"```\n",
"\n",
Expand Down
14 changes: 9 additions & 5 deletions notebooks/backends/JAX_Graph.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -858,11 +858,15 @@
"If you are using graphs and GeometricKernels, please consider citing\n",
"\n",
"```\n",
"@article{mostowsky2024,\n",
" title = {The GeometricKernels Package: Heat and Matérn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and Noémie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" year = {2024},\n",
" journal = {arXiv:2407.08086},\n",
"@article{JMLR:v26:24-1185,\n",
" author = {Peter Mostowsky and Vincent Dutordoir and Iskander Azangulov and No{\\'e}mie Jaquier and Michael John Hutchinson and Aditya Ravuri and Leonel Rozo and Alexander Terenin and Viacheslav Borovitskiy},\n",
" title = {The GeometricKernels Package: Heat and Mat{\\'e}rn Kernels for Geometric Learning on Manifolds, Meshes, and Graphs},\n",
" journal = {Journal of Machine Learning Research},\n",
" year = {2025},\n",
" volume = {26},\n",
" number = {276},\n",
" pages = {1--14},\n",
" url = {http://jmlr.org/papers/v26/24-1185.html}\n",
"}\n",
"```\n",
"\n",
Expand Down
Loading