From 3cb90d30f2039fb70d619b23648d10f67e17d909 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Felix=20K=C3=B6hler?= <27728103+Ceyron@users.noreply.github.com> Date: Fri, 18 Oct 2024 11:03:53 +0200 Subject: [PATCH] Rework readme --- README.md | 38 ++++++++++++++++++-------------------- 1 file changed, 18 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 599d703..92ecd80 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,5 @@ ⚠️ ⚠️ ⚠️ This is a pre-release version of the package to test the PyPI workflow. Proper release **with breaking API changes** will be by end of October. ⚠️ ⚠️ ⚠️ -

- -
- Exponax -
-

-

Efficient Differentiable PDE solvers built on top of JAX & Equinox.

@@ -16,7 +9,7 @@ DocumentationBackgroundRelated • - License + Acknowledgements

@@ -26,10 +19,10 @@ ## Installation ```bash -pip install git+ssh://git@github.com/Ceyron/exponax@main +pip install exponax ``` -Requires Python 3.10+ and JAX 0.4.13+ (and Equinox & Matplotlib). 👉 [JAX install guide](https://jax.readthedocs.io/en/latest/installation.html). +Requires Python 3.10+ and JAX 0.4.13+. 👉 [JAX install guide](https://jax.readthedocs.io/en/latest/installation.html). ## Quickstart @@ -91,13 +84,7 @@ For a next step, check out the [simple_advection_example_1d.ipynb](examples/simp ## Documentation -The following Jupyter notebooks showcase the usage of the package: - -1. [Simple Advection Example in 1d](docs/examples/simple_advection_example_1d.ipynb) -2. ... - -The documentation is still in progress. For now, the best way to get started is -to look at the examples and the docstrings in the code. +Documentation is available at [fkoehler.site/exponax](https://fkoehler.site/exponax/). ## Background @@ -169,12 +156,23 @@ This package also took much inspiration from the integral method of [2] and how to handle (de)aliasing. -## License +## Acknowledgements + +### Citation + +This package was developed as part of the `APEBench paper` (accepted at Neurips 2024), we will soon add the citation here. + +### Funding + +The main author (Felix Koehler) is a PhD student in the group of [Prof. Thuerey at TUM](https://ge.in.tum.de/) and his research is funded by the [Munich Center for Machine Learning](https://mcml.ai/). + +### License -MIT, see [here](LICENSE.txt) +MIT, see [here](https://github.com/Ceyron/exponax/blob/main/LICENSE.txt) --- > [fkoehler.site](https://fkoehler.site/)  ·  > GitHub [@ceyron](https://github.com/ceyron)  ·  -> X [@felix_m_koehler](https://twitter.com/felix_m_koehler) +> X [@felix_m_koehler](https://twitter.com/felix_m_koehler)  ·  +> LinkedIn [Felix Köhler](www.linkedin.com/in/felix-koehler)