annotate +time/Rungekutta.m @ 984:0585a2ee7ee7 feature/timesteppers

Inline the rk.rungekutta_4 function.
author Jonatan Werpers <jonatan@werpers.com>
date Tue, 08 Jan 2019 12:19:33 +0100
parents 34b3d092a4d0
children a32856fc2ad2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
888
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
1 classdef Rungekutta < time.Timestepper
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
2 properties
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
3 F % RHS of the ODE
918
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
4 dt % Time step
888
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
5 t % Time point
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
6 v % Solution vector
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
7 n % Time level
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
8 scheme % The scheme used for the time stepping, e.g rk4, rk6 etc.
918
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
9 coeffs % Butcher tableau coefficients
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
10 V % All stage approximations in most recent time step
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
11 K % All stage rates in most recent time step
888
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
12 end
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
13
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
14
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
15 methods
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
16 % Timesteps v_t = F(v,t), using the specified RK method from t = t0 with
918
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
17 % timestep dt and initial conditions v = v0
931
384ca2331a12 Make Rungekutta class allow for discrete data.
Martin Almquist <malmquist@stanford.edu>
parents: 918
diff changeset
18 function obj = Rungekutta(F, dt, t0, v0, method, discreteData)
888
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
19 default_arg('method',"rk4");
931
384ca2331a12 Make Rungekutta class allow for discrete data.
Martin Almquist <malmquist@stanford.edu>
parents: 918
diff changeset
20 default_arg('discreteData', []);
888
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
21 obj.F = F;
918
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
22 obj.dt = dt;
888
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
23 obj.t = t0;
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
24 obj.v = v0;
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
25 obj.n = 0;
918
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
26
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
27 % Extract the coefficients for the specified method
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
28 % used for the RK updates from the Butcher tableua.
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
29 [s,a,b,c] = time.rk.butcherTableau(method);
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
30 obj.coeffs = struct('s',s,'a',a,'b',b,'c',c);
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
31
931
384ca2331a12 Make Rungekutta class allow for discrete data.
Martin Almquist <malmquist@stanford.edu>
parents: 918
diff changeset
32 if isempty(discreteData)
984
0585a2ee7ee7 Inline the rk.rungekutta_4 function.
Jonatan Werpers <jonatan@werpers.com>
parents: 933
diff changeset
33 obj.scheme = @(v,t,n) time.rk.rungekutta(v, t, dt, F, obj.coeffs);
888
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
34 else
932
3860dad28239 Remove unnecessary(?) arguments in Rungekutta.scheme.
Martin Almquist <malmquist@stanford.edu>
parents: 931
diff changeset
35 obj.scheme = @(v,t,n) time.rk.rungekuttaDiscreteData(v, t, dt, F, obj.coeffs, discreteData, n);
888
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
36 end
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
37 end
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
38
918
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
39 % v: Current solution
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
40 % t: Current time
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
41 % V: All stage approximations in most recent time step
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
42 % K: All stage rates in most recent time step
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
43 % T: Time points (corresponding to V and K) in most recent time step
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
44 function [v,t,V,T,K] = getV(obj)
888
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
45 v = obj.v;
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
46 t = obj.t;
918
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
47 V = obj.V;
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
48 K = obj.K;
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
49 T = obj.t + obj.dt*obj.coeffs.b;
888
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
50 end
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
51
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
52 function obj = step(obj)
932
3860dad28239 Remove unnecessary(?) arguments in Rungekutta.scheme.
Martin Almquist <malmquist@stanford.edu>
parents: 931
diff changeset
53 [obj.v, obj.V, obj.K] = obj.scheme(obj.v, obj.t, obj.n);
918
679f4ddd982f Add properties for stage approximations and stage rates in the Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 888
diff changeset
54 obj.t = obj.t + obj.dt;
888
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
55 obj.n = obj.n + 1;
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
56 end
933
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
57
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
58 % Returns a vector of time points, including substage points,
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
59 % in the time interval [t0, tEnd].
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
60 % The time-step obj.dt is assumed to be aligned with [t0, tEnd] already.
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
61 function tvec = timePoints(obj, t0, tEnd)
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
62 N = round( (tEnd-t0)/obj.dt );
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
63 tvec = zeros(N*obj.s, 1);
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
64 s = obj.coeffs.s;
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
65 c = obj.coeffs.c;
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
66 for i = 1:N
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
67 ind = (i-1)*s+1 : i*s;
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
68 tvec(ind) = ((i-1) + c')*obj.dt;
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
69 end
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
70 end
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
71
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
72 % Returns a vector of quadrature weights corresponding to grid points
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
73 % in time interval [t0, tEnd], substage points included.
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
74 % The time-step obj.dt is assumed to be aligned with [t0, tEnd] already.
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
75 function weights = quadWeights(obj, t0, tEnd)
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
76 N = round( (tEnd-t0)/obj.dt );
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
77 b = obj.coeffs.b;
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
78 weights = repmat(b', N, 1);
34b3d092a4d0 Add methods timePoints and quadWeights to Rungekutta class.
Martin Almquist <malmquist@stanford.edu>
parents: 932
diff changeset
79 end
888
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
80 end
8732d6bd9890 Add general Runge-Kutta class
Vidar Stiernström <vidar.stiernstrom@it.uu.se>
parents:
diff changeset
81 end