Skip to content

Commit

Permalink
Clean up docs a bit
Browse files Browse the repository at this point in the history
  • Loading branch information
avik-pal committed Jan 15, 2024
1 parent 59cd7f3 commit d710b69
Show file tree
Hide file tree
Showing 3 changed files with 23 additions and 23 deletions.
2 changes: 1 addition & 1 deletion Project.toml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
name = "SciMLBase"
uuid = "0bca4576-84f4-4d90-8ffe-ffa030f20462"
authors = ["Chris Rackauckas <[email protected]> and contributors"]
version = "2.19.0"
version = "2.19.1"

[deps]
ADTypes = "47edcb42-4c32-4615-8424-f2b9edc5f35b"
Expand Down
28 changes: 14 additions & 14 deletions src/problems/basic_problems.jl
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ struct StandardNonlinearProblem end
@doc doc"""
Defines an interval nonlinear system problem.
Documentation Page: https://docs.sciml.ai/NonlinearSolve/stable/basics/NonlinearProblem/
Documentation Page: [https://docs.sciml.ai/NonlinearSolve/stable/basics/NonlinearProblem/](https://docs.sciml.ai/NonlinearSolve/stable/basics/NonlinearProblem/)
## Mathematical Specification of an Interval Nonlinear Problem
Expand All @@ -98,7 +98,7 @@ which defines the nonlinear system:
f(t,p) = u = 0
```
along with an interval `tspan`, ``t \\in [t_0,t_f]``, within which the root should be found.
along with an interval `tspan`, ``t \in [t_0,t_f]``, within which the root should be found.
`f` should be specified as `f(t,p)` (or in-place as `f(u,t,p)`), and `tspan` should be a
`Tuple{T,T} where T <: Number`.
Expand All @@ -114,8 +114,8 @@ along with an interval `tspan`, ``t \\in [t_0,t_f]``, within which the root shou
### Constructors
```julia
IntervalNonlinearProblem(f::NonlinearFunction,tspan,p=NullParameters();kwargs...)
IntervalNonlinearProblem{isinplace}(f,tspan,p=NullParameters();kwargs...)
IntervalNonlinearProblem(f::NonlinearFunction, tspan, p = NullParameters(); kwargs...)
IntervalNonlinearProblem{isinplace}(f, tspan, p = NullParameters(); kwargs...)
```
`isinplace` optionally sets whether the function is in-place or not. This is
Expand Down Expand Up @@ -188,7 +188,7 @@ end
@doc doc"""
Defines a nonlinear system problem.
Documentation Page: https://docs.sciml.ai/NonlinearSolve/stable/basics/NonlinearProblem/
Documentation Page: [https://docs.sciml.ai/NonlinearSolve/stable/basics/NonlinearProblem/](https://docs.sciml.ai/NonlinearSolve/stable/basics/NonlinearProblem/)
## Mathematical Specification of a Nonlinear Problem
Expand All @@ -199,8 +199,8 @@ which defines the nonlinear system:
f(u,p) = 0
```
and an initial guess ``u₀`` of where `f(u,p)=0`. `f` should be specified as `f(u,p)`
(or in-place as `f(du,u,p)`), and `u₀` should be an AbstractArray (or number)
and an initial guess ``u₀`` of where `f(u, p) = 0`. `f` should be specified as `f(u, p)`
(or in-place as `f(du, u, p)`), and `u₀` should be an AbstractArray (or number)
whose geometry matches the desired geometry of `u`. Note that we are not limited
to numbers or vectors for `u₀`; one is allowed to provide `u₀` as arbitrary
matrices / higher-dimension tensors as well.
Expand All @@ -210,8 +210,8 @@ matrices / higher-dimension tensors as well.
### Constructors
```julia
NonlinearProblem(f::NonlinearFunction,u0,p=NullParameters();kwargs...)
NonlinearProblem{isinplace}(f,u0,p=NullParameters();kwargs...)
NonlinearProblem(f::NonlinearFunction, u0, p = NullParameters(); kwargs...)
NonlinearProblem{isinplace}(f, u0, p = NullParameters(); kwargs...)
```
`isinplace` optionally sets whether the function is in-place or not. This is
Expand All @@ -223,8 +223,8 @@ parameters. Any extra keyword arguments are passed on to the solvers. For exampl
if you set a `callback` in the problem, then that `callback` will be added in
every solve call.
For specifying Jacobians and mass matrices, see the [NonlinearFunctions](@ref nonlinearfunctions)
page.
For specifying Jacobians and mass matrices, see the
[NonlinearFunctions](@ref nonlinearfunctions) page.
### Fields
Expand Down Expand Up @@ -328,7 +328,7 @@ nonlinear system:
```
and an initial guess ``u_0`` for the minimization problem. ``f`` should be specified as
``f(u, p)`` (or in-place as ``f(du, u, p)``), and ``u_0``` should be an AbstractArray (or
``f(u, p)`` (or in-place as ``f(du, u, p)``), and ``u_0`` should be an AbstractArray (or
number) whose geometry matches the desired geometry of ``u``. Note that we are not limited
to numbers or vectors for ``u_0``; one is allowed to provide ``u_0`` as arbitrary
matrices / higher-dimension tensors as well.
Expand All @@ -338,8 +338,8 @@ matrices / higher-dimension tensors as well.
### Constructors
```julia
NonlinearLeastSquaresProblem(f::NonlinearFunction, u0, p=NullParameters(); kwargs...)
NonlinearLeastSquaresProblem{isinplace}(f, u0, p=NullParameters(); kwargs...)
NonlinearLeastSquaresProblem(f::NonlinearFunction, u0, p = NullParameters(); kwargs...)
NonlinearLeastSquaresProblem{isinplace}(f, u0, p = NullParameters(); kwargs...)
```
`isinplace` optionally sets whether the function is in-place or not. This is
Expand Down
16 changes: 8 additions & 8 deletions src/problems/steady_state_problems.jl
Original file line number Diff line number Diff line change
@@ -1,35 +1,35 @@
@doc doc"""
Defines a steady state ODE problem.
Documentation Page: https://docs.sciml.ai/DiffEqDocs/stable/types/steady_state_types/
Documentation Page: [https://docs.sciml.ai/DiffEqDocs/stable/types/steady_state_types/](https://docs.sciml.ai/DiffEqDocs/stable/types/steady_state_types/)
## Mathematical Specification of a Steady State Problem
To define a Steady State Problem, you simply need to give the function ``f``
which defines the ODE:
```math
\frac{du}{dt} = f(u,p,t)
\frac{du}{dt} = f(u, p, t)
```
and an initial guess ``u_0`` of where `f(u,p,t)=0`. `f` should be specified as `f(u,p,t)`
(or in-place as `f(du,u,p,t)`), and `u₀` should be an AbstractArray (or number)
whose geometry matches the desired geometry of `u`. Note that we are not limited
and an initial guess ``u_0`` of where `f(u, p, t) = 0`. `f` should be specified as
`f(u, p, t)` (or in-place as `f(du, u, p, t)`), and `u₀` should be an AbstractArray
(or number) whose geometry matches the desired geometry of `u`. Note that we are not limited
to numbers or vectors for `u₀`; one is allowed to provide `u₀` as arbitrary
matrices / higher dimension tensors as well.
Note that for the steady-state to be defined, we must have that `f` is autonomous,
that is `f` is independent of `t`. But the form which matches the standard ODE
solver should still be used. The steady state solvers interpret the `f` by
fixing ``t=\\infty``.
fixing ``t = \infty``.
## Problem Type
### Constructors
```julia
SteadyStateProblem(f::ODEFunction,u0,p=NullParameters();kwargs...)
SteadyStateProblem{isinplace,specialize}(f,u0,p=NullParameters();kwargs...)
SteadyStateProblem(f::ODEFunction, u0, p = NullParameters(); kwargs...)
SteadyStateProblem{isinplace, specialize}(f, u0, p = NullParameters(); kwargs...)
```
`isinplace` optionally sets whether the function is inplace or not. This is
Expand Down

0 comments on commit d710b69

Please sign in to comment.