Skip to content

Commit a5a8f1e

Browse files
committed
Update README
1 parent 9d1cf78 commit a5a8f1e

File tree

1 file changed

+44
-14
lines changed

1 file changed

+44
-14
lines changed

README.md

Lines changed: 44 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,25 @@
1-
<h1 align="center">
2-
<img src="docs/imgs/trainax_logo.png" width="400">
3-
<br>
4-
Trainax
5-
<br>
6-
</h1>
7-
81
<p align="center">
92
<b>Learning Methodologies for Autoregressive Neural Emulators.</b>
103
</p>
114

5+
<p align="center">
6+
<a href="https://pypi.org/project/trainax/">
7+
<img src="https://img.shields.io/pypi/v/trainax.svg" alt="PyPI">
8+
</a>
9+
<a href="https://github.com/ceyron/trainax/actions/workflows/test.yml">
10+
<img src="https://github.com/ceyron/trainax/actions/workflows/test.yml/badge.svg" alt="Tests">
11+
</a>
12+
<a href="https://fkoehler.site/trainax/">
13+
<img src="https://img.shields.io/badge/docs-latest-green" alt="docs-latest">
14+
</a>
15+
<a href="https://github.com/ceyron/trainax/releases">
16+
<img src="https://img.shields.io/github/v/release/ceyron/trainax?include_prereleases&label=changelog" alt="Changelog">
17+
</a>
18+
<a href="https://github.com/ceyron/trainax/blob/main/LICENSE.txt">
19+
<img src="https://img.shields.io/badge/license-MIT-blue" alt="License">
20+
</a>
21+
</p>
22+
1223
<p align="center">
1324
<a href="#installation">Installation</a> •
1425
<a href="#quickstart">Quickstart</a> •
@@ -22,15 +33,24 @@
2233
<img src="docs/imgs/sample_two_step_supervised.svg" width="400">
2334
</p>
2435

36+
Convenience abstractions using `optax` to train neural networks to
37+
autoregressively emulate time-dependent problems taking care of trajectory
38+
subsampling and offering a wide range of training methodologies (regarding
39+
unrolling length and including differentiable physics).
40+
2541
## Installation
2642

2743
Clone the repository, navigate to the folder and install the package with pip:
2844
```bash
29-
pip install .
45+
pip install trainax
3046
```
3147

3248
Requires Python 3.10+ and JAX 0.4.13+. 👉 [JAX install guide](https://jax.readthedocs.io/en/latest/installation.html).
3349

50+
## Documentation
51+
52+
The documentation is available at [fkoehler.site/trainax](https://fkoehler.site/trainax/).
53+
3454
## Quickstart
3555

3656
Train a kernel size 2 linear convolution (no bias) to become an emulator for the
@@ -136,7 +156,7 @@ and modify the gradient flow, etc.
136156
* Composability
137157

138158

139-
## A Taxonomy of Training Methodologies
159+
<!-- ## A Taxonomy of Training Methodologies
140160
141161
The major axes that need to be chosen are:
142162
@@ -192,15 +212,25 @@ There are three levels of hierarchy:
192212
trajectory substacker.
193213
194214
You can find an overview of predictor learning setups
195-
[here](https://fkoehler.site/predictor-learning-setups/).
215+
[here](https://fkoehler.site/predictor-learning-setups/). -->
196216

197-
## License
217+
## Acknowledgements
198218

199-
MIT, see [here](LICENSE.txt)
219+
### Citation
220+
221+
This package was developed as part of the `APEBench paper` (accepted at Neurips 2024), we will soon add the citation here.
222+
223+
### Funding
224+
225+
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/).
226+
227+
### License
228+
229+
MIT, see [here](https://github.com/Ceyron/trainax/blob/main/LICENSE.txt)
200230

201231
---
202232

203233
> [fkoehler.site](https://fkoehler.site/) &nbsp;&middot;&nbsp;
204234
> GitHub [@ceyron](https://github.com/ceyron) &nbsp;&middot;&nbsp;
205-
> X [@felix_m_koehler](https://twitter.com/felix_m_koehler)
206-
235+
> X [@felix_m_koehler](https://twitter.com/felix_m_koehler) &nbsp;&middot;&nbsp;
236+
> LinkedIn [Felix Köhler](www.linkedin.com/in/felix-koehler)

0 commit comments

Comments
 (0)