```{toctree}
---
caption: Contents
hidden:
---
   Introduction <self>
   Examples <examples>
   Formulation <formulation>
   API reference <api>
   Change log <changelog>
   Implementation notes <notes>
```


```{include} ../README.md
```