diff --git a/README.md b/README.md index ed06607..04c52cd 100644 --- a/README.md +++ b/README.md @@ -7,4 +7,8 @@ [![ColPrac: Contributor's Guide on Collaborative Practices for Community Packages](https://img.shields.io/badge/ColPrac-Contributor%27s%20Guide-blueviolet)](https://github.com/SciML/ColPrac) [![Aqua](https://raw.githubusercontent.com/JuliaTesting/Aqua.jl/master/badge.svg)](https://github.com/JuliaTesting/Aqua.jl) -## Build UDEs with ModelingToolkit +ModelingToolkitNeuralNets.jl is a package to create neural network blocks defined similar to MTKStandardLibrary components, to use them for solving Universal Differential Equations. It can be plugged to any part of the equations in an ODESystem using `RealInputArray` and `RealOutputArray` components which gives a lot of flexibility to add the missing physics only to a part of the model. + +## Tutorials and Documentation + +For information on using the package, [see the stable documentation](https://docs.sciml.ai/ModelingToolkitNeuralNets/stable/). Use the [in-development documentation](https://docs.sciml.ai/ModelingToolkitNeuralNets/dev/) for the version of the documentation, which contains the unreleased features. diff --git a/docs/make.jl b/docs/make.jl index 8575c56..5aa376a 100644 --- a/docs/make.jl +++ b/docs/make.jl @@ -29,5 +29,6 @@ makedocs(; deploydocs(; repo = "github.com/SciML/ModelingToolkitNeuralNets.jl", - devbranch = "main" + devbranch = "main", + push_preview = true ) diff --git a/docs/src/friction.md b/docs/src/friction.md index 842d6b7..e9a6f21 100644 --- a/docs/src/friction.md +++ b/docs/src/friction.md @@ -152,6 +152,7 @@ res_prob = remake(prob, p = res_p) res_sol = solve(res_prob, Rodas4(), saveat = sol_ref.t) @test first.(sol_ref.u)≈first.(res_sol.u) rtol=1e-3 #hide @test friction.(first.(sol_ref.u))≈(Fu .- first.(res_sol(res_sol.t, Val{1}).u)) rtol=1e-1 #hide +nothing #hide ``` Also, it would be interesting to check the simulation before the training to get an idea of the starting point of the network. diff --git a/docs/src/index.md b/docs/src/index.md index a9ed1cf..7a1acf2 100644 --- a/docs/src/index.md +++ b/docs/src/index.md @@ -2,17 +2,35 @@ CurrentModule = ModelingToolkitNeuralNets ``` -# ModelingToolkitNeuralNets +# ModelingToolkitNeuralNets.jl -Documentation for [ModelingToolkitNeuralNets](https://github.com/SciML/ModelingToolkitNeuralNets.jl). +ModelingToolkitNeuralNets.jl is a package to create neural network components defined similar to MTKStandardLibrary components, to use them for solving Universal Differential Equations. It can be plugged to any part of the equations in an ODESystem using `RealInputArray` and `RealOutputArray` components which gives a lot of flexibility to add missing physics only to the relevant parts of the model. -```@index -``` +## Installation + +To install ModelingToolkitNeuralNets.jl, use the Julia package manager: -```@autodocs -Modules = [ModelingToolkitNeuralNets] +```julia +using Pkg +Pkg.add("ModelingToolkitNeuralNets") ``` +## Contributing + + - Please refer to the + [SciML ColPrac: Contributor's Guide on Collaborative Practices for Community Packages](https://github.com/SciML/ColPrac/blob/master/README.md) + for guidance on PRs, issues, and other matters relating to contributing to SciML. + + - See the [SciML Style Guide](https://github.com/SciML/SciMLStyle) for common coding practices and other style decisions. + - There are a few community forums: + + + The #diffeq-bridged and #sciml-bridged channels in the + [Julia Slack](https://julialang.org/slack/) + + The #diffeq-bridged and #sciml-bridged channels in the + [Julia Zulip](https://julialang.zulipchat.com/#narrow/stream/279055-sciml-bridged) + + On the [Julia Discourse forums](https://discourse.julialang.org) + + See also [SciML Community page](https://sciml.ai/community/) + ## Reproducibility ```@raw html