Skip to content

Commit

Permalink
add readme
Browse files Browse the repository at this point in the history
  • Loading branch information
nrummel committed Feb 6, 2025
1 parent 430addc commit 2aa442a
Show file tree
Hide file tree
Showing 4 changed files with 39 additions and 2 deletions.
32 changes: 32 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# WENDy.jl

*Weak form Estimation of Nonlinear Dynamics in Julia.*

| **Documentation** | **Build Status** |
|:-------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------:|
| [![][docs-stable-img]][docs-stable-url] [![][docs-dev-img]][docs-dev-url] | [![][GHA-img]][GHA-url] [![][codecov-img]][codecov-url] [![PkgEval][pkgeval-img]][pkgeval-url] |


## Installation

The package can be installed with the Julia package manager.
From the Julia REPL, type `]` to enter the Pkg REPL mode and run:

```
pkg> add WENDy
```

Or, equivalently, via the `Pkg` API:

```julia
julia> import Pkg; Pkg.add("Documenter")
```

## Documentation

- [**STABLE**][docs-stable-url] — **documentation of the most recently tagged version.**
- [**DEVEL**][docs-dev-url] — *documentation of the in-development version.*

## Publication
The work comes from the the MathBio Group at University of Colorado Boulder. For further reading find our paper at [arxiv link](https://arxiv.org/).

Empty file added docs/src/examples.md
Empty file.
4 changes: 2 additions & 2 deletions docs/src/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
This is the documentation of [WENDy.jl](https://github.com/nrummel/WENDy.jl). The work comes from the the MathBio Group at University of Colorado Boulder. For further reading find our paper at [arxiv link](https://arxiv.org/).

## Problem Statement
WENDy is an algorithm that can estimate unknown parameters for ordinary differential equations given noisey data.
WENDy is an algorithm that can estimate unknown parameters for ordinary differential equations given noisy data.

The set up for this algorithm is to assume that a physical system with state variable, $\boldsymbol{u} \in \mathbb{R}^D$, is governed by a system of ordinary differential equation with true parameters, $\mathbf{p}^* \in \mathbb{R}^J$:
```math
Expand All @@ -24,7 +24,7 @@ The user has observed data of this system on a uniform grid, $$\{t_m \mathbf{u}_
\log(\eta) &\stackrel{iid}{\sim} \mathcal{N}(\mathbf{0}, \mathbb{I}_D)\\
\end{align*}
```
*Note*: The Hammard product $$\circ$$ is the element-wise multiplication on the two vectors.
*Note*: The Hadamard product $$\circ$$ is the element-wise multiplication on the two vectors.

The goal of the algorithm is that recover unknown parameters $\mathbf{p}$. In other words, we hope that if the one were to solve the system of differential equations with the estimated parameters then it would match the true state, then
```math
Expand Down
5 changes: 5 additions & 0 deletions docs/src/reference.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
```@autodocs
Modules = [WENDy]
Private = false
Order=[:function, :type]
```

0 comments on commit 2aa442a

Please sign in to comment.