DiffEq Developer Documentation
This is the developer documentation and Contributor's Guide for the DiffEq ecosystem. It explains the common interface and some the package internals to help developers contribute.
If you have any questions, or just want to chat about solvers/using the package, please feel free to use the Gitter channel. For bug reports, feature requests, etc., please submit an issue.
The DiffEq ecosystem is built around the common interface. The common interface is a type-based interface where users define problems as a type, and solvers plug into the ecosystem by defining an algorithm to give a new dispatch to
There is then an ecosystem of add-on components which use the common solver interface to add analysis tools for differential equations.
This package suite is still under heavy development. If you are a power user and would like to try out the latest features, it is recommended you use the MetaDiffEq metapackage. To do so, use the following commands:
Pkg.clone("https://github.com/tbreloff/MetaPkg.jl") # Install MetaPkg using MetaPkg meta_add("MetaDiffEq") # Adds all of the packages, even those unregistered meta_checkout("MetaDiffEq") # Checks out the master branch on all of the packages
Note that this is for power users who are familiar with Julia. If you are having issues, please contact Chris Rackauckas in the Gitter channel.
Contributing to the Ecosystem
There are many ways to help the ecosystem. One way you can contribute is to give pull requests (PRs) to existing packages. Another way to contribute is to add your own package to the ecosystem. Adding your own package to the ecosystem allows you to keep executive control and licensing over your methods, but allows users of DifferentialEquations.jl to use your methods via the common interface, and makes your package compatible with the add-on tools (sensitivity analysis, parameter estimation, etc). Note that one is required to move their package to the JuliaDiffEq organization so that way common maintenance (such as fixing deprication warnings, updating tests to newer versions, and emergency fixes / disabling) can be allowed by JuliaDiffEq members. However, the lead developer of the package maintains administrative control, and thus any change to the core algorithms by other JuliaDiffEq members will only be given through PRs.
Even if you don't have the time to contribute new solver algorithms or add-on tools, there's always ways to help! Improved plot recipes and new series recipes are always nice to add more default plots. It is always helpful to have benchmarks between different algorithms to see "which is best". Adding examples IJulia notebooks to DiffEqTutorials.jl is a good way to share knowledge about DifferentialEquations.jl. Also, please feel free to comb through the solvers and look for ways to make them more efficient. Lastly, the documentation could always use improvements. If you have any questions on how to help, just ask them in the Gitter!
- Ecosystem Overview
- Adding a new package to the common interface
- Adding Algorithms
- Developing A New Problem
- The DiffEq Internals
- The Parameters Interface
- Type Traits
Algorithm Development Tools
The following algorithm development tools are provided by DiffEqDevTools.jl
- Test Problems
- Convergence Simulations
- Benchmark Suite