find numerical solution of ordinary differential equations
dsolve(odesys, numeric, method=rkf45, vars, options)
dsolve(numeric, method=rkf45, procopts, options)
set or list; ordinary differential equation(s) and initial conditions
literal name; instruct dsolve to find a numerical solution
literal equation; numerical method to use
(optional) any indeterminate function of one variable, or a set or list of them, representing the unknowns of the ODE problem
(optional) equations of the form keyword = value
options used to specify the ODE system using a procedure (procedure, initial, start, number, and procvars). For more information, see dsolve/numeric/IVP.
The dsolve command with the options numeric and method=rkf45 finds a numerical solution using a Fehlberg fourth-fifth order Runge-Kutta method with degree four interpolant. This is the default method of the type=numeric solution for initial value problems when the stiff argument is not used. The other non-stiff method is a Runge-Kutta method with the Cash-Karp coefficients, ck45.
Modes of Operation
The rkf45 method has two distinct modes of operation (for procedure-type outputs).
With the range option
When used with the range option, the method computes the solution for the IVP over the specified range, storing the solution information internally, and uses that information to rapidly interpolate the desired solution value for any call to the returned procedure(s).
Though possible, it is not recommended that the returned procedure be called for points outside the specified range.
This method can be used in combination with the refine option of odeplot to produce an adaptive plot (that is, odeplot uses the precomputed points to produce the plot when refine is specified.)
It is not recommended that this method be used for problems in which the solution can become singular, as each step is stored, and many steps may be taken when near a singularity, so memory usage can become a significant issue.
The storage of the interpolant in use by this method can be disabled by using the interpolation=false option described below. This is recommended for high accuracy solutions where storage of the interpolant (in addition to the discrete solution) requires too much memory. Disabling the interpolant is not generally recommended because the solution values are obtained from an interpolation of the 5 closest points, and does not necessarily provide an interpolant with order 4 error.
Without the range option
When used without the range option, the IVP solution values are not stored, but rather computed when requested.
Because not all solution values are stored, computation must restart at the initial values whenever a point is requested between the initial point and the most recently computed point (to avoid reversal of the integration direction), so it is advisable to collect solution values moving away from the initial value.
The following options are available for the rkf45 method.
keyword or array
name or list of names
boolean or auto
Specifies the desired output from dsolve. The keywords procedurelist, listprocedure, or operator provide procedure-type output, the keyword piecewise provides output in the form of piecewise functions over a specified range of independent variable values, and a 1-D array or Array provide output at fixed values of the independent variable. For more information, see dsolve/numeric.
Specifies user-defined known functions. For more information, see dsolve/numeric.
abserr, relerr, and initstep
Specify the desired accuracy of the solution, and the starting step size for the method. For more information, see dsolve/Error_Control. The default values for rkf45 are abserr=1e-7 and relerr=1e-6. The value for initstep, if not specified, is determined by the method, taking into account the local behavior of the ODE system.
By default this is set to true, and controls whether the solution interpolant error (including the interpolant on index-1 variables for DAE problems) is integrated into the error control. When set to false, areas where the solutions is varying rapidly (e.g. a discontinuity in a derivative due to a piecewise) may have a much larger solution error than dictated by the specified error tolerances. When set to true, the step size is reduced to minimize error in these regions, but for problems where there is a jump discontinuity in the variables, the integration may fail with an error indicating that a singularity is present. In the latter case where an error is thrown, it may be advantageous to model the discontinuities using events (see dsolve/Events).
Specifies a maximum on the number of evaluations of the right-hand side of the first order ODE system. This option is disabled by specifying maxfun=0. The default value for rkf45 is 30000.
number, procedure, start, initial, and procvars
These options are used to specify the IVP using procedures. For more information, see dsolve/numeric/IVP.
startinit, implicit, and optimize
These options control the method and behavior of the computation. For more information on startinit and implicit, see dsolve/numeric/IVP. For more information on optimize, see dsolve/numeric.
This option specifies that the internally generated procedures that are used to compute the numeric solution be compiled for efficiency. Note that this option will only work if Digits is set within the hardware precision range, and the input function contains only evalhf capable functions (e.g. only elementary mathematical functions like exp, sin, and ln). See dsolve/Efficiency. By default this value is set to false. If set to true and a compile is not possible, an error will be thrown. If set to auto and a compile is not possible, the uncompiled procedures will be used directly.
Determines the range of values of the independent variable for which solution values are required. Use of this option significantly changes the behavior of the method for the procedure-style output types discussed in dsolve/numeric (see description of with/without range in Modes of Operation section of this help page).
events, event_pre, event_maxiter, event_iterate, event_initial
These options are used to specify and control the behavior of events for the numerical solution. These options are discussed in detail in dsolve/Events.
Accepts a boolean value indicating if the problem is (or will become) complex valued. By default this is detected based on the input system and initial data, but in cases where the input system is procedure defined, or the system is initially real, it may be necessary to specify complex=true to obtain the solution. It is assumed that for an initially real system that becomes complex, the point at which this transition occurs is considered to be a singularity, so if complex=true is not specified, the integration will halt at that point.
By setting infolevel[dsolve] to 2, information on the last mesh point evaluation is provided in the event of an error.
The rkf45 method is capable of computing high-accuracy solutions for IVPs because the precision of the computation can be increased by changing the Digits environment variable. However, it is recommended that the higher order dverk78 or gear methods be used instead.
Results can be plotted by using the function odeplot in the plots package.
Solution with a range - solution over 0..1 is stored:
Solution without a range - each point is computed when requested:
Piecewise output for complex-valued problem:
Enright, W.H.; Jackson, K.R.; Norsett, S.P.; and Thomsen, P.G. "Interpolants for Runge-Kutta Formulas." ACM TOMS, Vol. 12, (1986): 193-218.
Fehlberg, E. "Klassische Runge-Kutta-Formeln vierter und niedrigerer Ordnung mit Schrittweiten-Kontrolle und ihre Anwendung auf Waermeleitungsprobleme". Computing, Vol. 6, (1970): 61-71.
Forsythe, G.E.; Malcolm, M.A.; and Moler, C.B. Computer Methods for Mathematical Computations. New Jersey: Prentice Hall, 1977.
Shampine, L.F. and Corless, R.M. "Initial Value Problems for ODEs in Problem Solving Environments". J. Comp. Appl. Math, Vol. 125(1-2), (2000): 31-40.
Download Help Document
What kind of issue would you like to report? (Optional)