README.md

Documentation	Source	Citation

Package Manifolds.jl aims to provide both a unified interface to define and use manifolds as well as a library of manifolds to use for your projects. This package is mostly stable, see #438 for planned upcoming changes.

Getting started

To install the package just type

using Pkg; Pkg.add("Manifolds")

Then you can directly start, for example to stop half way from the north pole on the Sphere to a point on the equator, you can generate the shortest_geodesic. It internally employs exp and log.

using Manifolds
M = Sphere(2)
γ = shortest_geodesic(M, [0., 0., 1.], [0., 1., 0.])
γ(0.5)

Ecosystem highlights

• A wide selection of Riemannian manifolds like spheres, hyperbolic spaces, Stiefel and Grassmann manifolds.
• Support for optimization on manifolds using Manopt.jl.
• Support for many operations used in optimization and manifold-valued statistics with a focus on performance and ease of use.
• Connection manifolds.
• Lie groups.
• Atlases, charts and custom metrics (work in progress).
• A lightweight interface package: ManifoldsBase.jl.
• Differential equations on manifolds: ManifoldDiffEq.jl.
• Finite differences and automatic differentiation on manifolds using ManifoldDiff.jl (work in progress).
• Integration and measures on manifolds: ManifoldMeasures.jl (work in progress).
• Functional manifolds: FunManifolds.jl (work in progress).

Support

If you have any questions regarding the Manifolds.jl ecosystem feel free to reach us using Github discussion forums, Julia Slack, Julia Zulip or Julia discourse forums. We are interested in new applications and methods on manifolds -- sharing your work is welcome!

Citation

If you use Manifolds.jl in your work, please cite the following open access article

@article{AxenBaranBergmannRzecki:2023,
    AUTHOR    = {Axen, Seth D. and Baran, Mateusz and Bergmann, Ronny and Rzecki, Krzysztof},
    ARTICLENO = {33},
    DOI       = {10.1145/3618296},
    JOURNAL   = {ACM Transactions on Mathematical Software},
    MONTH     = {dec},
    NUMBER    = {4},
    TITLE     = {Manifolds.Jl: An Extensible Julia Framework for Data Analysis on Manifolds},
    VOLUME    = {49},
    YEAR      = {2023}
}

To refer to a certain version we recommend to also cite for example

@software{manifoldsjl-zenodo-mostrecent,
  Author = {Seth D. Axen and Mateusz Baran and Ronny Bergmann},
  Title = {Manifolds.jl},
  Doi = {10.5281/ZENODO.4292129},
  Url = {https://zenodo.org/record/4292129},
  Publisher = {Zenodo},
  Year = {2021},
  Copyright = {MIT License}
}

for the most recent version or a corresponding version specific DOI, see the list of all versions. Note that both citations are in BibLaTeX format.