xref: /petsc/src/ts/impls/multirate/mprk.c (revision ebd5ed4e78f373b846868cc2e56d029d80ff41a0)
14b84eec9SHong Zhang /*
24b84eec9SHong Zhang   Code for time stepping with the Partitioned Runge-Kutta method
34b84eec9SHong Zhang 
44b84eec9SHong Zhang   Notes:
54b84eec9SHong Zhang   1) The general system is written as
64b84eec9SHong Zhang      Udot = F(t,U) for nonsplit RHS multi-rate RK,
74b84eec9SHong Zhang      user should give the indexes for both slow and fast components;
84b84eec9SHong Zhang   2) The general system is written as
94b84eec9SHong Zhang      Usdot = Fs(t,Us,Uf)
104b84eec9SHong Zhang      Ufdot = Ff(t,Us,Uf) for split RHS multi-rate RK,
114b84eec9SHong Zhang      user should partioned RHS by themselves and also provide the indexes for both slow and fast components.
1219c2959aSHong Zhang   3) To correct The confusing terminology in the paper, we use 'slow method', 'slow buffer method' and 'fast method' to denote the methods applied to 'slow region', 'slow buffer region' and 'fast region' respectively. The 'slow method' in the original paper actually means the 'slow buffer method'.
1319c2959aSHong Zhang   4) Why does the buffer region have to be inside the slow region? The buffer region is treated with a slow method essentially. Applying the slow method to a region with a fast characteristic time scale is apparently not a good choice.
1419c2959aSHong Zhang 
1519c2959aSHong Zhang   Reference:
1619c2959aSHong Zhang   Emil M. Constantinescu, Adrian Sandu, Multirate Timestepping Methods for Hyperbolic Conservation Laws, Journal of Scientific Computing 2007
1719c2959aSHong Zhang 
184b84eec9SHong Zhang */
194b84eec9SHong Zhang 
204b84eec9SHong Zhang #include <petsc/private/tsimpl.h>                /*I   "petscts.h"   I*/
214b84eec9SHong Zhang #include <petscdm.h>
224b84eec9SHong Zhang 
2319c2959aSHong Zhang static TSMPRKType TSMPRKDefault = TSMPRK2A22;
244b84eec9SHong Zhang static PetscBool TSMPRKRegisterAllCalled;
254b84eec9SHong Zhang static PetscBool TSMPRKPackageInitialized;
264b84eec9SHong Zhang 
274b84eec9SHong Zhang typedef struct _MPRKTableau *MPRKTableau;
284b84eec9SHong Zhang struct _MPRKTableau {
294b84eec9SHong Zhang   char      *name;
304b84eec9SHong Zhang   PetscInt  order;                          /* Classical approximation order of the method i */
3179bc8a77SHong Zhang   PetscInt  sbase;                          /* Number of stages in the base method*/
324b84eec9SHong Zhang   PetscInt  s;                              /* Number of stages */
3319c2959aSHong Zhang   PetscInt  np;                             /* Number of partitions */
344b84eec9SHong Zhang   PetscReal *Af,*bf,*cf;                    /* Tableau for fast components */
3519c2959aSHong Zhang   PetscReal *Amb,*bmb,*cmb;                 /* Tableau for medium components */
3619c2959aSHong Zhang   PetscInt  *rmb;                           /* Array of flags for repeated stages in medium method */
3719c2959aSHong Zhang   PetscReal *Asb,*bsb,*csb;                 /* Tableau for slow components */
3819c2959aSHong Zhang   PetscInt  *rsb;                           /* Array of flags for repeated staged in slow method*/
394b84eec9SHong Zhang };
404b84eec9SHong Zhang typedef struct _MPRKTableauLink *MPRKTableauLink;
414b84eec9SHong Zhang struct _MPRKTableauLink {
424b84eec9SHong Zhang   struct _MPRKTableau tab;
434b84eec9SHong Zhang   MPRKTableauLink     next;
444b84eec9SHong Zhang };
454b84eec9SHong Zhang static MPRKTableauLink MPRKTableauList;
464b84eec9SHong Zhang 
474b84eec9SHong Zhang typedef struct {
484b84eec9SHong Zhang   MPRKTableau         tableau;
494b84eec9SHong Zhang   TSMPRKMultirateType mprkmtype;
504b84eec9SHong Zhang   Vec                 *Y;                          /* States computed during the step                           */
517c0df07dSHong Zhang   Vec                 *YdotRHS;
524b84eec9SHong Zhang   Vec                 *YdotRHS_slow;               /* Function evaluations by slow tableau for slow components  */
5319c2959aSHong Zhang   Vec                 *YdotRHS_slowbuffer;         /* Function evaluations by slow tableau for slow components  */
5419c2959aSHong Zhang   Vec                 *YdotRHS_medium;             /* Function evaluations by slow tableau for slow components  */
5519c2959aSHong Zhang   Vec                 *YdotRHS_mediumbuffer;       /* Function evaluations by slow tableau for slow components  */
5619c2959aSHong Zhang   Vec                 *YdotRHS_fast;               /* Function evaluations by fast tableau for fast components  */
574b84eec9SHong Zhang   PetscScalar         *work_slow;                  /* Scalar work_slow by slow tableau                          */
5819c2959aSHong Zhang   PetscScalar         *work_slowbuffer;            /* Scalar work_slow by slow tableau                          */
5919c2959aSHong Zhang   PetscScalar         *work_medium;                /* Scalar work_slow by medium tableau                        */
6019c2959aSHong Zhang   PetscScalar         *work_mediumbuffer;          /* Scalar work_slow by medium tableau                        */
6119c2959aSHong Zhang   PetscScalar         *work_fast;                  /* Scalar work_fast by fast tableau                          */
624b84eec9SHong Zhang   PetscReal           stage_time;
634b84eec9SHong Zhang   TSStepStatus        status;
644b84eec9SHong Zhang   PetscReal           ptime;
654b84eec9SHong Zhang   PetscReal           time_step;
6619c2959aSHong Zhang   IS                  is_slow,is_slowbuffer,is_medium,is_mediumbuffer,is_fast;
6719c2959aSHong Zhang   TS                  subts_slow,subts_slowbuffer,subts_medium,subts_mediumbuffer,subts_fast;
684b84eec9SHong Zhang } TS_MPRK;
694b84eec9SHong Zhang 
7019c2959aSHong Zhang static PetscErrorCode TSMPRKGenerateTableau2(PetscInt ratio,PetscInt s,const PetscReal Abase[],const PetscReal bbase[],PetscReal A1[],PetscReal b1[],PetscReal A2[],PetscReal b2[])
7119c2959aSHong Zhang {
7219c2959aSHong Zhang   PetscInt i,j,k,l;
7319c2959aSHong Zhang 
7419c2959aSHong Zhang   PetscFunctionBegin;
7519c2959aSHong Zhang   for (k=0; k<ratio; k++) {
7619c2959aSHong Zhang     /* diagonal blocks */
7719c2959aSHong Zhang     for (i=0; i<s; i++)
7819c2959aSHong Zhang       for (j=0; j<s; j++) {
7919c2959aSHong Zhang         A1[(k*s+i)*ratio*s+k*s+j] = Abase[i*s+j];
8019c2959aSHong Zhang         A2[(k*s+i)*ratio*s+k*s+j] = Abase[i*s+j]/ratio;
8119c2959aSHong Zhang       }
8219c2959aSHong Zhang     /* off diagonal blocks */
8319c2959aSHong Zhang     for (l=0; l<k; l++)
8419c2959aSHong Zhang       for (i=0; i<s; i++)
8519c2959aSHong Zhang         for (j=0; j<s; j++)
8619c2959aSHong Zhang           A2[(k*s+i)*ratio*s+l*s+j] = bbase[j]/ratio;
8719c2959aSHong Zhang     for (j=0; j<s; j++) {
8819c2959aSHong Zhang       b1[k*s+j] = bbase[j]/ratio;
8919c2959aSHong Zhang       b2[k*s+j] = bbase[j]/ratio;
9019c2959aSHong Zhang     }
9119c2959aSHong Zhang   }
9219c2959aSHong Zhang   PetscFunctionReturn(0);
9319c2959aSHong Zhang }
9419c2959aSHong Zhang 
9519c2959aSHong Zhang static PetscErrorCode TSMPRKGenerateTableau3(PetscInt ratio,PetscInt s,const PetscReal Abase[],const PetscReal bbase[],PetscReal A1[],PetscReal b1[],PetscReal A2[],PetscReal b2[],PetscReal A3[],PetscReal b3[])
9619c2959aSHong Zhang {
9719c2959aSHong Zhang   PetscInt i,j,k,l,m,n;
9819c2959aSHong Zhang 
9919c2959aSHong Zhang   PetscFunctionBegin;
10019c2959aSHong Zhang   for (k=0; k<ratio; k++) { /* diagonal blocks of size ratio*s by ratio*s */
10119c2959aSHong Zhang     for (l=0; l<ratio; l++) /* diagonal sub-blocks of size s by s */
10219c2959aSHong Zhang       for (i=0; i<s; i++)
10319c2959aSHong Zhang         for (j=0; j<s; j++) {
10419c2959aSHong Zhang           A1[((k*ratio+l)*s+i)*ratio*ratio*s+(k*ratio+l)*s+j] = Abase[i*s+j];
10519c2959aSHong Zhang           A2[((k*ratio+l)*s+i)*ratio*ratio*s+(k*ratio+l)*s+j] = Abase[i*s+j]/ratio;
10619c2959aSHong Zhang           A3[((k*ratio+l)*s+i)*ratio*ratio*s+(k*ratio+l)*s+j] = Abase[i*s+j]/ratio/ratio;
10719c2959aSHong Zhang         }
10819c2959aSHong Zhang     for (l=0; l<k; l++) /* off-diagonal blocks of size ratio*s by ratio*s */
10919c2959aSHong Zhang       for (m=0; m<ratio; m++)
11019c2959aSHong Zhang         for (n=0; n<ratio; n++)
11119c2959aSHong Zhang           for (i=0; i<s; i++)
11219c2959aSHong Zhang             for (j=0; j<s; j++) {
11319c2959aSHong Zhang                A2[((k*ratio+m)*s+i)*ratio*ratio*s+(l*ratio+n)*s+j] = bbase[j]/ratio/ratio;
11419c2959aSHong Zhang                A3[((k*ratio+m)*s+i)*ratio*ratio*s+(l*ratio+n)*s+j] = bbase[j]/ratio/ratio;
11519c2959aSHong Zhang             }
11619c2959aSHong Zhang     for (m=0; m<ratio; m++)
11719c2959aSHong Zhang       for (n=0; n<m; n++) /* off-diagonal sub-blocks of size s by s in the diagonal blocks */
11819c2959aSHong Zhang           for (i=0; i<s; i++)
11919c2959aSHong Zhang             for (j=0; j<s; j++)
12019c2959aSHong Zhang                A3[((k*ratio+m)*s+i)*ratio*ratio*s+(k*ratio+n)*s+j] = bbase[j]/ratio/ratio;
12119c2959aSHong Zhang     for (n=0; n<ratio; n++)
12219c2959aSHong Zhang       for (j=0; j<s; j++) {
12319c2959aSHong Zhang         b1[(k*ratio+n)*s+j] = bbase[j]/ratio/ratio;
12419c2959aSHong Zhang         b2[(k*ratio+n)*s+j] = bbase[j]/ratio/ratio;
12519c2959aSHong Zhang         b3[(k*ratio+n)*s+j] = bbase[j]/ratio/ratio;
12619c2959aSHong Zhang       }
12719c2959aSHong Zhang   }
12819c2959aSHong Zhang   PetscFunctionReturn(0);
12919c2959aSHong Zhang }
13019c2959aSHong Zhang 
1314b84eec9SHong Zhang /*MC
13219c2959aSHong Zhang      TSMPRK2A22 - Second Order Partitioned Runge Kutta scheme based on RK2A.
1334b84eec9SHong Zhang 
13419c2959aSHong Zhang      This method has four stages for slow and fast parts. The refinement factor of the stepsize is 2.
13519c2959aSHong Zhang      r = 2, np = 2
1364b84eec9SHong Zhang      Options database:
13719c2959aSHong Zhang .     -ts_mprk_type 2a22
1384b84eec9SHong Zhang 
1394b84eec9SHong Zhang      Level: advanced
1404b84eec9SHong Zhang 
1414b84eec9SHong Zhang .seealso: TSMPRK, TSMPRKType, TSMPRKSetType()
1424b84eec9SHong Zhang M*/
1434b84eec9SHong Zhang /*MC
14419c2959aSHong Zhang      TSMPRK2A23 - Second Order Partitioned Runge Kutta scheme based on RK2A.
14519c2959aSHong Zhang 
14619c2959aSHong Zhang      This method has eight stages for slow and medium and fast parts. The refinement factor of the stepsize is 2.
14719c2959aSHong Zhang      r = 2, np = 3
14819c2959aSHong Zhang      Options database:
14919c2959aSHong Zhang .     -ts_mprk_type 2a23
15019c2959aSHong Zhang 
15119c2959aSHong Zhang      Level: advanced
15219c2959aSHong Zhang 
15319c2959aSHong Zhang .seealso: TSMPRK, TSMPRKType, TSMPRKSetType()
15419c2959aSHong Zhang M*/
15519c2959aSHong Zhang /*MC
15619c2959aSHong Zhang      TSMPRK2A32 - Second Order Partitioned Runge Kutta scheme based on RK2A.
15719c2959aSHong Zhang 
15819c2959aSHong Zhang      This method has four stages for slow and fast parts. The refinement factor of the stepsize is 3.
15919c2959aSHong Zhang      r = 3, np = 2
16019c2959aSHong Zhang      Options database:
16119c2959aSHong Zhang .     -ts_mprk_type 2a32
16219c2959aSHong Zhang 
16319c2959aSHong Zhang      Level: advanced
16419c2959aSHong Zhang 
16519c2959aSHong Zhang .seealso: TSMPRK, TSMPRKType, TSMPRKSetType()
16619c2959aSHong Zhang M*/
16719c2959aSHong Zhang /*MC
16819c2959aSHong Zhang      TSMPRK2A33 - Second Order Partitioned Runge Kutta scheme based on RK2A.
16919c2959aSHong Zhang 
17019c2959aSHong Zhang      This method has eight stages for slow and medium and fast parts. The refinement factor of the stepsize is 3.
17119c2959aSHong Zhang      r = 3, np = 3
17219c2959aSHong Zhang      Options database:
17319c2959aSHong Zhang .     -ts_mprk_type 2a33
17419c2959aSHong Zhang 
17519c2959aSHong Zhang      Level: advanced
17619c2959aSHong Zhang 
17719c2959aSHong Zhang .seealso: TSMPRK, TSMPRKType, TSMPRKSetType()
17819c2959aSHong Zhang M*/
17919c2959aSHong Zhang /*MC
18019c2959aSHong Zhang      TSMPRK3P2M - Third Order Partitioned Runge Kutta scheme.
1814b84eec9SHong Zhang 
1824b84eec9SHong Zhang      This method has eight stages for both slow and fast parts.
1834b84eec9SHong Zhang 
1844b84eec9SHong Zhang      Options database:
1854b84eec9SHong Zhang .     -ts_mprk_type pm3  (put here temporarily)
1864b84eec9SHong Zhang 
1874b84eec9SHong Zhang      Level: advanced
1884b84eec9SHong Zhang 
1894b84eec9SHong Zhang .seealso: TSMPRK, TSMPRKType, TSMPRKSetType()
1904b84eec9SHong Zhang M*/
1914b84eec9SHong Zhang /*MC
1924b84eec9SHong Zhang      TSMPRKP2 - Second Order Partitioned Runge Kutta scheme.
1934b84eec9SHong Zhang 
1944b84eec9SHong Zhang      This method has five stages for both slow and fast parts.
1954b84eec9SHong Zhang 
1964b84eec9SHong Zhang      Options database:
1974b84eec9SHong Zhang .     -ts_mprk_type p2
1984b84eec9SHong Zhang 
1994b84eec9SHong Zhang      Level: advanced
2004b84eec9SHong Zhang 
2014b84eec9SHong Zhang .seealso: TSMPRK, TSMPRKType, TSMPRKSetType()
2024b84eec9SHong Zhang M*/
2034b84eec9SHong Zhang /*MC
2044b84eec9SHong Zhang      TSMPRKP3 - Third Order Partitioned Runge Kutta scheme.
2054b84eec9SHong Zhang 
2064b84eec9SHong Zhang      This method has ten stages for both slow and fast parts.
2074b84eec9SHong Zhang 
2084b84eec9SHong Zhang      Options database:
2094b84eec9SHong Zhang .     -ts_mprk_type p3
2104b84eec9SHong Zhang 
2114b84eec9SHong Zhang      Level: advanced
2124b84eec9SHong Zhang 
2134b84eec9SHong Zhang .seealso: TSMPRK, TSMPRKType, TSMPRKSetType()
2144b84eec9SHong Zhang M*/
2154b84eec9SHong Zhang 
2164b84eec9SHong Zhang /*@C
2174b84eec9SHong Zhang   TSMPRKRegisterAll - Registers all of the Partirioned Runge-Kutta explicit methods in TSMPRK
2184b84eec9SHong Zhang 
2194b84eec9SHong Zhang   Not Collective, but should be called by all processes which will need the schemes to be registered
2204b84eec9SHong Zhang 
2214b84eec9SHong Zhang   Level: advanced
2224b84eec9SHong Zhang 
2234b84eec9SHong Zhang .keywords: TS, TSMPRK, register, all
2244b84eec9SHong Zhang 
2254b84eec9SHong Zhang .seealso:  TSMPRKRegisterDestroy()
2264b84eec9SHong Zhang @*/
2274b84eec9SHong Zhang PetscErrorCode TSMPRKRegisterAll(void)
2284b84eec9SHong Zhang {
2294b84eec9SHong Zhang   PetscErrorCode ierr;
2304b84eec9SHong Zhang 
2314b84eec9SHong Zhang   PetscFunctionBegin;
2324b84eec9SHong Zhang   if (TSMPRKRegisterAllCalled) PetscFunctionReturn(0);
2334b84eec9SHong Zhang   TSMPRKRegisterAllCalled = PETSC_TRUE;
2344b84eec9SHong Zhang 
2354b84eec9SHong Zhang #define RC PetscRealConstant
2364b84eec9SHong Zhang   {
2374b84eec9SHong Zhang     const PetscReal
23819c2959aSHong Zhang       Abase[2][2] = {{0,0},
23919c2959aSHong Zhang                      {RC(1.0),0}},
24019c2959aSHong Zhang       bbase[2] = {RC(0.5),RC(0.5)};
24119c2959aSHong Zhang     PetscReal
24219c2959aSHong Zhang       Asb[4][4] = {{0}},Af[4][4] = {{0}},bsb[4] = {0},bf[4] = {0};
24319c2959aSHong Zhang     PetscInt
24419c2959aSHong Zhang       rsb[4] = {0,0,1,2};
24519c2959aSHong Zhang     ierr = TSMPRKGenerateTableau2(2,2,&Abase[0][0],bbase,&Asb[0][0],bsb,&Af[0][0],bf);CHKERRQ(ierr);
24679bc8a77SHong Zhang     ierr = TSMPRKRegister(TSMPRK2A22,2,2,2,1,&Asb[0][0],bsb,NULL,rsb,NULL,NULL,NULL,NULL,&Af[0][0],bf,NULL);CHKERRQ(ierr);
2474b84eec9SHong Zhang   }
24819c2959aSHong Zhang   {
24919c2959aSHong Zhang     const PetscReal
25019c2959aSHong Zhang       Abase[2][2] = {{0,0},
25119c2959aSHong Zhang                      {RC(1.0),0}},
25219c2959aSHong Zhang       bbase[2]    = {RC(0.5),RC(0.5)};
25319c2959aSHong Zhang     PetscReal
25419c2959aSHong Zhang       Asb[8][8] = {{0}},Amb[8][8] = {{0}},Af[8][8] = {{0}},bsb[8] ={0},bmb[8] = {0},bf[8] = {0};
25519c2959aSHong Zhang     PetscInt
25619c2959aSHong Zhang       rsb[8] = {0,0,1,2,1,2,1,2},rmb[8] = {0,0,1,2,0,0,5,6};
25719c2959aSHong Zhang     ierr = TSMPRKGenerateTableau3(2,2,&Abase[0][0],bbase,&Asb[0][0],bsb,&Amb[0][0],bmb,&Af[0][0],bf);CHKERRQ(ierr);
25879bc8a77SHong Zhang     ierr = TSMPRKRegister(TSMPRK2A23,2,2,2,2,&Asb[0][0],bsb,NULL,rsb,&Amb[0][0],bmb,NULL,rmb,&Af[0][0],bf,NULL);CHKERRQ(ierr);
25919c2959aSHong Zhang   }
26019c2959aSHong Zhang   {
26119c2959aSHong Zhang     const PetscReal
26219c2959aSHong Zhang       Abase[2][2] = {{0,0},
26319c2959aSHong Zhang                      {RC(1.0),0}},
26419c2959aSHong Zhang       bbase[2]    = {RC(0.5),RC(0.5)};
26519c2959aSHong Zhang     PetscReal
26619c2959aSHong Zhang       Asb[6][6] = {{0}},Af[6][6] = {{0}},bsb[6] = {0},bf[6] = {0};
26719c2959aSHong Zhang     PetscInt
26819c2959aSHong Zhang       rsb[6] = {0,0,1,2,1,2};
26919c2959aSHong Zhang     ierr = TSMPRKGenerateTableau2(3,2,&Abase[0][0],bbase,&Asb[0][0],bsb,&Af[0][0],bf);CHKERRQ(ierr);
27079bc8a77SHong Zhang     ierr = TSMPRKRegister(TSMPRK2A32,2,2,3,1,&Asb[0][0],bsb,NULL,rsb,NULL,NULL,NULL,NULL,&Af[0][0],bf,NULL);CHKERRQ(ierr);
27119c2959aSHong Zhang   }
27219c2959aSHong Zhang   {
27319c2959aSHong Zhang     const PetscReal
27419c2959aSHong Zhang       Abase[2][2] = {{0,0},
27519c2959aSHong Zhang                      {RC(1.0),0}},
27619c2959aSHong Zhang       bbase[2]    = {RC(0.5),RC(0.5)};
27719c2959aSHong Zhang     PetscReal
27819c2959aSHong Zhang       Asb[18][18] = {{0}},Amb[18][18] = {{0}},Af[18][18] = {{0}},bsb[18] ={0},bmb[18] = {0},bf[18] = {0};
27919c2959aSHong Zhang     PetscInt
28019c2959aSHong Zhang       rsb[18] = {0,0,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,2},rmb[18] = {0,0,1,2,1,2,0,0,7,8,7,8,0,0,13,14,13,14};
28119c2959aSHong Zhang     ierr = TSMPRKGenerateTableau3(3,2,&Abase[0][0],bbase,&Asb[0][0],bsb,&Amb[0][0],bmb,&Af[0][0],bf);CHKERRQ(ierr);
28279bc8a77SHong Zhang     ierr = TSMPRKRegister(TSMPRK2A33,2,2,3,3,&Asb[0][0],bsb,NULL,rsb,&Amb[0][0],bmb,NULL,rmb,&Af[0][0],bf,NULL);CHKERRQ(ierr);
28319c2959aSHong Zhang   }
28419c2959aSHong Zhang /*
28519c2959aSHong Zhang     PetscReal
28619c2959aSHong Zhang       Asb[8][8] = {{Abase[0][0],Abase[0][1],0,0,0,0,0,0},
28719c2959aSHong Zhang                    {Abase[1][0],Abase[1][1],0,0,0,0,0,0},
28819c2959aSHong Zhang                    {0,0,Abase[0][0],Abase[0][1],0,0,0,0},
28919c2959aSHong Zhang                    {0,0,Abase[1][0],Abase[1][1],0,0,0,0},
29019c2959aSHong Zhang                    {0,0,0,0,Abase[0][0],Abase[0][1],0,0},
29119c2959aSHong Zhang                    {0,0,0,0,Abase[1][0],Abase[1][1],0,0},
29219c2959aSHong Zhang                    {0,0,0,0,0,0,Abase[0][0],Abase[0][1]},
29319c2959aSHong Zhang                    {0,0,0,0,0,0,Abase[1][0],Abase[1][1]}},
29419c2959aSHong Zhang       Amb[8][8] = {{Abase[0][0]/m,Abase[0][1]/m,0,0,0,0,0,0},
29519c2959aSHong Zhang                    {Abase[1][0]/m,Abase[1][1]/m,0,0,0,0,0,0},
29619c2959aSHong Zhang                    {0,0,Abase[0][0]/m,Abase[0][1]/m,0,0,0,0},
29719c2959aSHong Zhang                    {0,0,Abase[1][0]/m,Abase[1][1]/m,0,0,0,0},
29819c2959aSHong Zhang                    {bbase[0]/m,bbase[1]/m,bbase[0]/m,bbase[1]/m,Abase[0][0]/m,Abase[0][1]/m,0,0},
29919c2959aSHong Zhang                    {bbase[0]/m,bbase[1]/m,bbase[0]/m,bbase[1]/m,Abase[1][0]/m,Abase[1][1]/m,0,0},
30019c2959aSHong Zhang                    {bbase[0]/m,bbase[1]/m,bbase[0]/m,bbase[1]/m,0,0,Abase[0][0]/m,Abase[0][1]/m},
30119c2959aSHong Zhang                    {bbase[0]/m,bbase[1]/m,bbase[0]/m,bbase[1]/m,0,0,Abase[1][0]/m,Abase[1][1]/m}},
30219c2959aSHong Zhang       Af[8][8] = {{Abase[0][0]/m/m,Abase[0][1]/m/m,0,0,0,0,0,0},
30319c2959aSHong Zhang                    {Abase[1][0]/m/m,Abase[1][1]/m/m,0,0,0,0,0,0},
30419c2959aSHong Zhang                    {0,0,Abase[0][0]/m/m,Abase[0][1]/m/m,0,0,0,0},
30519c2959aSHong Zhang                    {0,0,Abase[1][0]/m/m,Abase[1][1]/m/m,0,0,0,0},
30619c2959aSHong Zhang                    {bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m/m,Abase[0][0]/m/m,Abase[0][1]/m/m,0,0},
30719c2959aSHong Zhang                    {bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m/m,Abase[1][0]/m/m,Abase[1][1]/m/m,0,0},
30819c2959aSHong Zhang                    {bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m/m,Abase[0][0]/m,Abase[0][1]/m},
30919c2959aSHong Zhang                    {bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m/m,Abase[1][0]/m,Abase[1][1]/m}},
31019c2959aSHong Zhang       bsb[8]    = {bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m/m},
31119c2959aSHong Zhang       bmb[8]    = {bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m,bbase[1]/m/m},
31219c2959aSHong Zhang       bf[8]     = {bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m/m,bbase[0]/m/m,bbase[1]/m,bbase[0]/m/m,bbase[1]/m/m},
31319c2959aSHong Zhang */
3144b84eec9SHong Zhang   /*{
3154b84eec9SHong Zhang       const PetscReal
3164b84eec9SHong Zhang         As[8][8] = {{0,0,0,0,0,0,0,0},
3174b84eec9SHong Zhang                     {RC(1.0)/RC(2.0),0,0,0,0,0,0,0},
3184b84eec9SHong Zhang                     {RC(-1.0)/RC(6.0),RC(2.0)/RC(3.0),0,0,0,0,0,0},
3194b84eec9SHong Zhang                     {RC(1.0)/RC(3.0),RC(-1.0)/RC(3.0),RC(1.0),0,0,0,0,0},
3204b84eec9SHong Zhang                     {0,0,0,0,0,0,0,0},
3214b84eec9SHong Zhang                     {0,0,0,0,RC(1.0)/RC(2.0),0,0,0},
3224b84eec9SHong Zhang                     {0,0,0,0,RC(-1.0)/RC(6.0),RC(2.0)/RC(3.0),0,0},
3234b84eec9SHong Zhang                     {0,0,0,0,RC(1.0)/RC(3.0),RC(-1.0)/RC(3.0),RC(1.0),0}},
3244b84eec9SHong Zhang          A[8][8] = {{0,0,0,0,0,0,0,0},
3254b84eec9SHong Zhang                     {RC(1.0)/RC(4.0),0,0,0,0,0,0,0},
3264b84eec9SHong Zhang                     {RC(-1.0)/RC(12.0),RC(1.0)/RC(3.0),0,0,0,0,0,0},
3274b84eec9SHong Zhang                     {RC(1.0)/RC(6.0),RC(-1.0)/RC(6.0),RC(1.0)/RC(2.0),0,0,0,0,0},
3284b84eec9SHong Zhang                     {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),0,0,0,0},
3294b84eec9SHong Zhang                     {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),RC(1.0)/RC(4.0),0,0,0},
3304b84eec9SHong Zhang                     {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),RC(-1.0)/RC(12.0),RC(1.0)/RC(3.0),0,0},
3314b84eec9SHong Zhang                     {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(-1.0)/RC(6.0),RC(1.0)/RC(2.0),0}},
3324b84eec9SHong Zhang           bs[8] = {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0)},
3334b84eec9SHong Zhang            b[8] = {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0)};
3344b84eec9SHong Zhang            ierr = TSMPRKRegister(TSMPRKPM3,3,8,&As[0][0],bs,NULL,&A[0][0],b,NULL);CHKERRQ(ierr);
3354b84eec9SHong Zhang   }*/
3364b84eec9SHong Zhang 
3374b84eec9SHong Zhang   {
3384b84eec9SHong Zhang     const PetscReal
33919c2959aSHong Zhang       Asb[5][5] = {{0,0,0,0,0},
3404b84eec9SHong Zhang                    {RC(1.0)/RC(2.0),0,0,0,0},
3414b84eec9SHong Zhang                    {RC(1.0)/RC(2.0),0,0,0,0},
3424b84eec9SHong Zhang                    {RC(1.0),0,0,0,0},
3434b84eec9SHong Zhang                    {RC(1.0),0,0,0,0}},
34419c2959aSHong Zhang       Af[5][5]  = {{0,0,0,0,0},
3454b84eec9SHong Zhang                    {RC(1.0)/RC(2.0),0,0,0,0},
3464b84eec9SHong Zhang                    {RC(1.0)/RC(4.0),RC(1.0)/RC(4.0),0,0,0},
3474b84eec9SHong Zhang                    {RC(1.0)/RC(4.0),RC(1.0)/RC(4.0),RC(1.0)/RC(2.0),0,0},
3484b84eec9SHong Zhang                    {RC(1.0)/RC(4.0),RC(1.0)/RC(4.0),RC(1.0)/RC(4.0),RC(1.0)/RC(4.0),0}},
34919c2959aSHong Zhang       bsb[5]    = {RC(1.0)/RC(2.0),0,0,0,RC(1.0)/RC(2.0)},
35019c2959aSHong Zhang       bf[5]     = {RC(1.0)/RC(4.0),RC(1.0)/RC(4.0),RC(1.0)/RC(4.0),RC(1.0)/RC(4.0),0};
35119c2959aSHong Zhang     const PetscInt
35219c2959aSHong Zhang       rsb[5]    = {0,0,2,0,4};
35379bc8a77SHong Zhang     ierr = TSMPRKRegister(TSMPRKP2,2,5,1,1,&Asb[0][0],bsb,NULL,rsb,NULL,NULL,NULL,NULL,&Af[0][0],bf,NULL);CHKERRQ(ierr);
3544b84eec9SHong Zhang   }
3554b84eec9SHong Zhang 
3564b84eec9SHong Zhang   {
3574b84eec9SHong Zhang     const PetscReal
35819c2959aSHong Zhang       Asb[10][10] = {{0,0,0,0,0,0,0,0,0,0},
3594b84eec9SHong Zhang                      {RC(1.0)/RC(4.0),0,0,0,0,0,0,0,0,0},
3604b84eec9SHong Zhang                      {RC(1.0)/RC(4.0),0,0,0,0,0,0,0,0,0},
3614b84eec9SHong Zhang                      {RC(1.0)/RC(2.0),0,0,0,0,0,0,0,0,0},
3624b84eec9SHong Zhang                      {RC(1.0)/RC(2.0),0,0,0,0,0,0,0,0,0},
3634b84eec9SHong Zhang                      {RC(-1.0)/RC(6.0),0,0,0,RC(2.0)/RC(3.0),0,0,0,0,0},
3644b84eec9SHong Zhang                      {RC(1.0)/RC(12.0),0,0,0,RC(1.0)/RC(6.0),RC(1.0)/RC(2.0),0,0,0,0},
3654b84eec9SHong Zhang                      {RC(1.0)/RC(12.0),0,0,0,RC(1.0)/RC(6.0),RC(1.0)/RC(2.0),0,0,0,0},
3664b84eec9SHong Zhang                      {RC(1.0)/RC(3.0),0,0,0,RC(-1.0)/RC(3.0),RC(1.0),0,0,0,0},
3674b84eec9SHong Zhang                      {RC(1.0)/RC(3.0),0,0,0,RC(-1.0)/RC(3.0),RC(1.0),0,0,0,0}},
36819c2959aSHong Zhang       Af[10][10]  = {{0,0,0,0,0,0,0,0,0,0},
3694b84eec9SHong Zhang                      {RC(1.0)/RC(4.0),0,0,0,0,0,0,0,0,0},
3704b84eec9SHong Zhang                      {RC(-1.0)/RC(12.0),RC(1.0)/RC(3.0),0,0,0,0,0,0,0,0},
3714b84eec9SHong Zhang                      {RC(1.0)/RC(6.0),RC(-1.0)/RC(6.0),RC(1.0)/RC(2.0),0,0,0,0,0,0,0},
3724b84eec9SHong Zhang                      {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),0,0,0,0,0,0},
3734b84eec9SHong Zhang                      {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),0,0,0,0,0,0},
3744b84eec9SHong Zhang                      {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),0,RC(1.0)/RC(4.0),0,0,0,0},
3754b84eec9SHong Zhang                      {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),0,RC(-1.0)/RC(12.0),RC(1.0)/RC(3.0),0,0,0},
3764b84eec9SHong Zhang                      {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),0,RC(1.0)/RC(6.0),RC(-1.0)/RC(6.0),RC(1.0)/RC(2.0),0,0},
3774b84eec9SHong Zhang                      {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),0,RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),0}},
37819c2959aSHong Zhang       bsb[10]     = {RC(1.0)/RC(6.0),0,0,0,RC(1.0)/RC(3.0),RC(1.0)/RC(3.0),0,0,0,RC(1.0)/RC(6.0)},
37919c2959aSHong Zhang       bf[10]      = {RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),0,RC(1.0)/RC(12.0),RC(1.0)/RC(6.0),RC(1.0)/RC(6.0),RC(1.0)/RC(12.0),0};
38019c2959aSHong Zhang     const PetscInt
38119c2959aSHong Zhang       rsb[10]     = {0,0,2,0,4,0,0,7,0,9};
38279bc8a77SHong Zhang     ierr = TSMPRKRegister(TSMPRKP3,3,5,2,1,&Asb[0][0],bsb,NULL,rsb,NULL,NULL,NULL,NULL,&Af[0][0],bf,NULL);CHKERRQ(ierr);
3834b84eec9SHong Zhang   }
3844b84eec9SHong Zhang #undef RC
3854b84eec9SHong Zhang   PetscFunctionReturn(0);
3864b84eec9SHong Zhang }
3874b84eec9SHong Zhang 
3884b84eec9SHong Zhang /*@C
3894b84eec9SHong Zhang    TSMPRKRegisterDestroy - Frees the list of schemes that were registered by TSMPRKRegister().
3904b84eec9SHong Zhang 
3914b84eec9SHong Zhang    Not Collective
3924b84eec9SHong Zhang 
3934b84eec9SHong Zhang    Level: advanced
3944b84eec9SHong Zhang 
3954b84eec9SHong Zhang .keywords: TSMPRK, register, destroy
3964b84eec9SHong Zhang .seealso: TSMPRKRegister(), TSMPRKRegisterAll()
3974b84eec9SHong Zhang @*/
3984b84eec9SHong Zhang PetscErrorCode TSMPRKRegisterDestroy(void)
3994b84eec9SHong Zhang {
4004b84eec9SHong Zhang   PetscErrorCode ierr;
4014b84eec9SHong Zhang   MPRKTableauLink link;
4024b84eec9SHong Zhang 
4034b84eec9SHong Zhang   PetscFunctionBegin;
4044b84eec9SHong Zhang   while ((link = MPRKTableauList)) {
4054b84eec9SHong Zhang     MPRKTableau t = &link->tab;
4064b84eec9SHong Zhang     MPRKTableauList = link->next;
40719c2959aSHong Zhang     ierr = PetscFree3(t->Asb,t->bsb,t->csb);CHKERRQ(ierr);
40819c2959aSHong Zhang     ierr = PetscFree3(t->Amb,t->bmb,t->cmb);CHKERRQ(ierr);
4094b84eec9SHong Zhang     ierr = PetscFree3(t->Af,t->bf,t->cf);CHKERRQ(ierr);
41019c2959aSHong Zhang     ierr = PetscFree2(t->rsb,t->rmb);CHKERRQ(ierr);
4114b84eec9SHong Zhang     ierr = PetscFree (t->name);CHKERRQ(ierr);
4124b84eec9SHong Zhang     ierr = PetscFree (link);CHKERRQ(ierr);
4134b84eec9SHong Zhang   }
4144b84eec9SHong Zhang   TSMPRKRegisterAllCalled = PETSC_FALSE;
4154b84eec9SHong Zhang   PetscFunctionReturn(0);
4164b84eec9SHong Zhang }
4174b84eec9SHong Zhang 
4184b84eec9SHong Zhang /*@C
4194b84eec9SHong Zhang   TSMPRKInitializePackage - This function initializes everything in the TSMPRK package. It is called
4204b84eec9SHong Zhang   from PetscDLLibraryRegister() when using dynamic libraries, and on the first call to TSCreate_MPRK()
4214b84eec9SHong Zhang   when using static libraries.
4224b84eec9SHong Zhang 
4234b84eec9SHong Zhang   Level: developer
4244b84eec9SHong Zhang 
4254b84eec9SHong Zhang .keywords: TS, TSMPRK, initialize, package
4264b84eec9SHong Zhang .seealso: PetscInitialize()
4274b84eec9SHong Zhang @*/
4284b84eec9SHong Zhang PetscErrorCode TSMPRKInitializePackage(void)
4294b84eec9SHong Zhang {
4304b84eec9SHong Zhang   PetscErrorCode ierr;
4314b84eec9SHong Zhang 
4324b84eec9SHong Zhang   PetscFunctionBegin;
4334b84eec9SHong Zhang   if (TSMPRKPackageInitialized) PetscFunctionReturn(0);
4344b84eec9SHong Zhang   TSMPRKPackageInitialized = PETSC_TRUE;
4354b84eec9SHong Zhang   ierr = TSMPRKRegisterAll();CHKERRQ(ierr);
4364b84eec9SHong Zhang   ierr = PetscRegisterFinalize(TSMPRKFinalizePackage);CHKERRQ(ierr);
4374b84eec9SHong Zhang   PetscFunctionReturn(0);
4384b84eec9SHong Zhang }
4394b84eec9SHong Zhang 
4404b84eec9SHong Zhang /*@C
4414b84eec9SHong Zhang   TSRKFinalizePackage - This function destroys everything in the TSMPRK package. It is
4424b84eec9SHong Zhang   called from PetscFinalize().
4434b84eec9SHong Zhang 
4444b84eec9SHong Zhang   Level: developer
4454b84eec9SHong Zhang 
4464b84eec9SHong Zhang .keywords: Petsc, destroy, package
4474b84eec9SHong Zhang .seealso: PetscFinalize()
4484b84eec9SHong Zhang @*/
4494b84eec9SHong Zhang PetscErrorCode TSMPRKFinalizePackage(void)
4504b84eec9SHong Zhang {
4514b84eec9SHong Zhang   PetscErrorCode ierr;
4524b84eec9SHong Zhang 
4534b84eec9SHong Zhang   PetscFunctionBegin;
4544b84eec9SHong Zhang   TSMPRKPackageInitialized = PETSC_FALSE;
4554b84eec9SHong Zhang   ierr = TSMPRKRegisterDestroy();CHKERRQ(ierr);
4564b84eec9SHong Zhang   PetscFunctionReturn(0);
4574b84eec9SHong Zhang }
4584b84eec9SHong Zhang 
4594b84eec9SHong Zhang /*@C
4604b84eec9SHong Zhang    TSMPRKRegister - register a MPRK scheme by providing the entries in the Butcher tableau
4614b84eec9SHong Zhang 
4624b84eec9SHong Zhang    Not Collective, but the same schemes should be registered on all processes on which they will be used
4634b84eec9SHong Zhang 
4644b84eec9SHong Zhang    Input Parameters:
4654b84eec9SHong Zhang +  name - identifier for method
4664b84eec9SHong Zhang .  order - approximation order of method
46779bc8a77SHong Zhang .  s  - number of stages in the base methods
46879bc8a77SHong Zhang .  ratio1 - stepsize ratio at 1st level (e.g. slow/medium)
46979bc8a77SHong Zhang .  ratio2 - stepsize ratio at 2nd level (e.g. medium/fast)
4704b84eec9SHong Zhang .  Af - stage coefficients for fast components(dimension s*s, row-major)
4714b84eec9SHong Zhang .  bf - step completion table for fast components(dimension s)
4724b84eec9SHong Zhang .  cf - abscissa for fast components(dimension s)
4734b84eec9SHong Zhang .  As - stage coefficients for slow components(dimension s*s, row-major)
4744b84eec9SHong Zhang .  bs - step completion table for slow components(dimension s)
4754b84eec9SHong Zhang -  cs - abscissa for slow components(dimension s)
4764b84eec9SHong Zhang 
4774b84eec9SHong Zhang    Notes:
4784b84eec9SHong Zhang    Several MPRK methods are provided, this function is only needed to create new methods.
4794b84eec9SHong Zhang 
4804b84eec9SHong Zhang    Level: advanced
4814b84eec9SHong Zhang 
4824b84eec9SHong Zhang .keywords: TS, register
4834b84eec9SHong Zhang 
4844b84eec9SHong Zhang .seealso: TSMPRK
4854b84eec9SHong Zhang @*/
48679bc8a77SHong Zhang PetscErrorCode TSMPRKRegister(TSMPRKType name,PetscInt order,
48779bc8a77SHong Zhang                               PetscInt sbase,PetscInt ratio1,PetscInt ratio2,
48819c2959aSHong Zhang                               const PetscReal Asb[],const PetscReal bsb[],const PetscReal csb[],const PetscInt rsb[],
48919c2959aSHong Zhang                               const PetscReal Amb[],const PetscReal bmb[],const PetscReal cmb[],const PetscInt rmb[],
4904b84eec9SHong Zhang                               const PetscReal Af[],const PetscReal bf[],const PetscReal cf[])
4914b84eec9SHong Zhang {
4924b84eec9SHong Zhang   MPRKTableauLink link;
4934b84eec9SHong Zhang   MPRKTableau     t;
49479bc8a77SHong Zhang   PetscInt        s,i,j;
4954b84eec9SHong Zhang   PetscErrorCode  ierr;
4964b84eec9SHong Zhang 
4974b84eec9SHong Zhang   PetscFunctionBegin;
4984b84eec9SHong Zhang   PetscValidCharPointer(name,1);
49919c2959aSHong Zhang   PetscValidRealPointer(Asb,4);
50079bc8a77SHong Zhang   if (bsb) PetscValidRealPointer(bsb,7);
50179bc8a77SHong Zhang   if (csb) PetscValidRealPointer(csb,8);
50279bc8a77SHong Zhang   if (rsb) PetscValidRealPointer(rsb,9);
50379bc8a77SHong Zhang   if (Amb) PetscValidRealPointer(Amb,10);
50479bc8a77SHong Zhang   if (bmb) PetscValidRealPointer(bmb,11);
50579bc8a77SHong Zhang   if (cmb) PetscValidRealPointer(cmb,12);
50679bc8a77SHong Zhang   if (rmb) PetscValidRealPointer(rmb,13);
50779bc8a77SHong Zhang   PetscValidRealPointer(Af,14);
50879bc8a77SHong Zhang   if (bf) PetscValidRealPointer(bf,15);
50979bc8a77SHong Zhang   if (cf) PetscValidRealPointer(cf,16);
5104b84eec9SHong Zhang 
5114b84eec9SHong Zhang   ierr = PetscNew(&link);CHKERRQ(ierr);
5124b84eec9SHong Zhang   t = &link->tab;
5134b84eec9SHong Zhang 
5144b84eec9SHong Zhang   ierr = PetscStrallocpy(name,&t->name);CHKERRQ(ierr);
51579bc8a77SHong Zhang   s = sbase*ratio1*ratio2; /*  this is the dimension of the matrices below */
5164b84eec9SHong Zhang   t->order = order;
51779bc8a77SHong Zhang   t->sbase = sbase;
5184b84eec9SHong Zhang   t->s  = s;
51919c2959aSHong Zhang   t->np = 2;
52079bc8a77SHong Zhang 
5214b84eec9SHong Zhang   ierr = PetscMalloc3(s*s,&t->Af,s,&t->bf,s,&t->cf);CHKERRQ(ierr);
5224b84eec9SHong Zhang   ierr = PetscMemcpy(t->Af,Af,s*s*sizeof(Af[0]));CHKERRQ(ierr);
5234b84eec9SHong Zhang   if (bf) {
5244b84eec9SHong Zhang     ierr = PetscMemcpy(t->bf,bf,s*sizeof(bf[0]));CHKERRQ(ierr);
52519c2959aSHong Zhang   } else
5264b84eec9SHong Zhang     for (i=0; i<s; i++) t->bf[i] = Af[(s-1)*s+i];
5274b84eec9SHong Zhang   if (cf) {
5284b84eec9SHong Zhang     ierr = PetscMemcpy(t->cf,cf,s*sizeof(cf[0]));CHKERRQ(ierr);
52919c2959aSHong Zhang   } else {
5304b84eec9SHong Zhang     for (i=0; i<s; i++)
5314b84eec9SHong Zhang       for (j=0,t->cf[i]=0; j<s; j++)
5324b84eec9SHong Zhang         t->cf[i] += Af[i*s+j];
5334b84eec9SHong Zhang   }
53419c2959aSHong Zhang 
53519c2959aSHong Zhang   if (Amb) {
53619c2959aSHong Zhang     t->np = 3;
53719c2959aSHong Zhang     ierr = PetscMalloc3(s*s,&t->Amb,s,&t->bmb,s,&t->cmb);CHKERRQ(ierr);
53819c2959aSHong Zhang     ierr = PetscCalloc1(s,&t->rmb);CHKERRQ(ierr);
53919c2959aSHong Zhang     ierr = PetscMemcpy(t->Amb,Amb,s*s*sizeof(Amb[0]));CHKERRQ(ierr);
54019c2959aSHong Zhang     if (bmb) {
54119c2959aSHong Zhang       ierr = PetscMemcpy(t->bmb,bmb,s*sizeof(bmb[0]));CHKERRQ(ierr);
54219c2959aSHong Zhang     } else {
54319c2959aSHong Zhang       for (i=0; i<s; i++) t->bmb[i] = Amb[(s-1)*s+i];
5444b84eec9SHong Zhang     }
54519c2959aSHong Zhang     if (cmb) {
54619c2959aSHong Zhang       ierr = PetscMemcpy(t->cmb,cmb,s*sizeof(cmb[0]));CHKERRQ(ierr);
54719c2959aSHong Zhang     } else {
5484b84eec9SHong Zhang       for (i=0; i<s; i++)
54919c2959aSHong Zhang         for (j=0,t->cmb[i]=0; j<s; j++)
55019c2959aSHong Zhang           t->cmb[i] += Amb[i*s+j];
55119c2959aSHong Zhang     }
55219c2959aSHong Zhang     if (rmb) {
55319c2959aSHong Zhang       ierr = PetscMemcpy(t->rmb,rmb,s*sizeof(rmb[0]));CHKERRQ(ierr);
55419c2959aSHong Zhang     }
55519c2959aSHong Zhang   }
55619c2959aSHong Zhang 
55719c2959aSHong Zhang   ierr = PetscMalloc3(s*s,&t->Asb,s,&t->bsb,s,&t->csb);CHKERRQ(ierr);
55819c2959aSHong Zhang   ierr = PetscMemcpy(t->Asb,Asb,s*s*sizeof(Asb[0]));CHKERRQ(ierr);
55919c2959aSHong Zhang   ierr = PetscCalloc1(s,&t->rsb);CHKERRQ(ierr);
56019c2959aSHong Zhang   if (bsb) {
56119c2959aSHong Zhang     ierr = PetscMemcpy(t->bsb,bsb,s*sizeof(bsb[0]));CHKERRQ(ierr);
56219c2959aSHong Zhang   } else
56319c2959aSHong Zhang     for (i=0; i<s; i++) t->bsb[i] = Asb[(s-1)*s+i];
56419c2959aSHong Zhang   if (csb) {
56519c2959aSHong Zhang     ierr = PetscMemcpy(t->csb,csb,s*sizeof(csb[0]));CHKERRQ(ierr);
56619c2959aSHong Zhang   } else {
56719c2959aSHong Zhang     for (i=0; i<s; i++)
56819c2959aSHong Zhang       for (j=0,t->csb[i]=0; j<s; j++)
56919c2959aSHong Zhang         t->csb[i] += Asb[i*s+j];
57019c2959aSHong Zhang   }
57119c2959aSHong Zhang   if (rsb) {
57219c2959aSHong Zhang     ierr = PetscMemcpy(t->rsb,rsb,s*sizeof(rsb[0]));CHKERRQ(ierr);
5734b84eec9SHong Zhang   }
5744b84eec9SHong Zhang   link->next = MPRKTableauList;
5754b84eec9SHong Zhang   MPRKTableauList = link;
5764b84eec9SHong Zhang   PetscFunctionReturn(0);
5774b84eec9SHong Zhang }
5784b84eec9SHong Zhang 
5794b84eec9SHong Zhang static PetscErrorCode TSMPRKSetSplits(TS ts)
5804b84eec9SHong Zhang {
5814b84eec9SHong Zhang   TS_MPRK        *mprk = (TS_MPRK*)ts->data;
58219c2959aSHong Zhang   MPRKTableau    tab = mprk->tableau;
5834b84eec9SHong Zhang   DM             dm,subdm,newdm;
5844b84eec9SHong Zhang   PetscErrorCode ierr;
5854b84eec9SHong Zhang 
5864b84eec9SHong Zhang   PetscFunctionBegin;
5874b84eec9SHong Zhang   ierr = TSRHSSplitGetSubTS(ts,"slow",&mprk->subts_slow);CHKERRQ(ierr);
5884b84eec9SHong Zhang   ierr = TSRHSSplitGetSubTS(ts,"fast",&mprk->subts_fast);CHKERRQ(ierr);
5894b84eec9SHong Zhang   if (!mprk->subts_slow || !mprk->subts_fast) SETERRQ(PetscObjectComm((PetscObject)ts),PETSC_ERR_USER,"Must set up the RHSFunctions for 'slow' and 'fast' components using TSRHSSplitSetRHSFunction() or calling TSSetRHSFunction() for each sub-TS");
5904b84eec9SHong Zhang 
59119c2959aSHong Zhang   /* Only copy the DM */
5924b84eec9SHong Zhang   ierr = TSGetDM(ts,&dm);CHKERRQ(ierr);
59319c2959aSHong Zhang 
59419c2959aSHong Zhang   ierr = TSRHSSplitGetSubTS(ts,"slowbuffer",&mprk->subts_slowbuffer);CHKERRQ(ierr);
59519c2959aSHong Zhang   if (!mprk->subts_slowbuffer) {
59619c2959aSHong Zhang     mprk->subts_slowbuffer = mprk->subts_slow;
59719c2959aSHong Zhang     mprk->subts_slow       = NULL;
59819c2959aSHong Zhang   }
59919c2959aSHong Zhang   if (mprk->subts_slow) {
6004b84eec9SHong Zhang     ierr = DMClone(dm,&newdm);CHKERRQ(ierr);
6014b84eec9SHong Zhang     ierr = TSGetDM(mprk->subts_slow,&subdm);CHKERRQ(ierr);
6024b84eec9SHong Zhang     ierr = DMCopyDMTS(subdm,newdm);CHKERRQ(ierr);
6034b84eec9SHong Zhang     ierr = DMCopyDMSNES(subdm,newdm);CHKERRQ(ierr);
6044b84eec9SHong Zhang     ierr = TSSetDM(mprk->subts_slow,newdm);CHKERRQ(ierr);
6054b84eec9SHong Zhang     ierr = DMDestroy(&newdm);CHKERRQ(ierr);
60619c2959aSHong Zhang   }
60719c2959aSHong Zhang   ierr = DMClone(dm,&newdm);CHKERRQ(ierr);
60819c2959aSHong Zhang   ierr = TSGetDM(mprk->subts_slowbuffer,&subdm);CHKERRQ(ierr);
60919c2959aSHong Zhang   ierr = DMCopyDMTS(subdm,newdm);CHKERRQ(ierr);
61019c2959aSHong Zhang   ierr = DMCopyDMSNES(subdm,newdm);CHKERRQ(ierr);
61119c2959aSHong Zhang   ierr = TSSetDM(mprk->subts_slowbuffer,newdm);CHKERRQ(ierr);
61219c2959aSHong Zhang   ierr = DMDestroy(&newdm);CHKERRQ(ierr);
61319c2959aSHong Zhang 
61419c2959aSHong Zhang   ierr = DMClone(dm,&newdm);CHKERRQ(ierr);
61519c2959aSHong Zhang   ierr = TSGetDM(mprk->subts_fast,&subdm);CHKERRQ(ierr);
61619c2959aSHong Zhang   ierr = DMCopyDMTS(subdm,newdm);CHKERRQ(ierr);
61719c2959aSHong Zhang   ierr = DMCopyDMSNES(subdm,newdm);CHKERRQ(ierr);
61819c2959aSHong Zhang   ierr = TSSetDM(mprk->subts_fast,newdm);CHKERRQ(ierr);
61919c2959aSHong Zhang   ierr = DMDestroy(&newdm);CHKERRQ(ierr);
62019c2959aSHong Zhang 
62119c2959aSHong Zhang   if (tab->np == 3) {
62219c2959aSHong Zhang     ierr = TSRHSSplitGetSubTS(ts,"medium",&mprk->subts_medium);CHKERRQ(ierr);
62319c2959aSHong Zhang     ierr = TSRHSSplitGetSubTS(ts,"mediumbuffer",&mprk->subts_mediumbuffer);CHKERRQ(ierr);
62419c2959aSHong Zhang     if (mprk->subts_medium && !mprk->subts_mediumbuffer) {
62519c2959aSHong Zhang       mprk->subts_mediumbuffer = mprk->subts_medium;
62619c2959aSHong Zhang       mprk->subts_medium       = NULL;
62719c2959aSHong Zhang     }
62819c2959aSHong Zhang     if (mprk->subts_medium) {
62919c2959aSHong Zhang       ierr = DMClone(dm,&newdm);CHKERRQ(ierr);
63019c2959aSHong Zhang       ierr = TSGetDM(mprk->subts_medium,&subdm);CHKERRQ(ierr);
63119c2959aSHong Zhang       ierr = DMCopyDMTS(subdm,newdm);CHKERRQ(ierr);
63219c2959aSHong Zhang       ierr = DMCopyDMSNES(subdm,newdm);CHKERRQ(ierr);
63319c2959aSHong Zhang       ierr = TSSetDM(mprk->subts_medium,newdm);CHKERRQ(ierr);
63419c2959aSHong Zhang       ierr = DMDestroy(&newdm);CHKERRQ(ierr);
63519c2959aSHong Zhang     }
63619c2959aSHong Zhang     ierr = DMClone(dm,&newdm);CHKERRQ(ierr);
63719c2959aSHong Zhang     ierr = TSGetDM(mprk->subts_mediumbuffer,&subdm);CHKERRQ(ierr);
63819c2959aSHong Zhang     ierr = DMCopyDMTS(subdm,newdm);CHKERRQ(ierr);
63919c2959aSHong Zhang     ierr = DMCopyDMSNES(subdm,newdm);CHKERRQ(ierr);
64019c2959aSHong Zhang     ierr = TSSetDM(mprk->subts_mediumbuffer,newdm);CHKERRQ(ierr);
64119c2959aSHong Zhang     ierr = DMDestroy(&newdm);CHKERRQ(ierr);
64219c2959aSHong Zhang   }
6434b84eec9SHong Zhang   PetscFunctionReturn(0);
6444b84eec9SHong Zhang }
6454b84eec9SHong Zhang 
6464b84eec9SHong Zhang /*
6474b84eec9SHong Zhang  This if for nonsplit RHS MPRK
6484b84eec9SHong Zhang  The step completion formula is
6494b84eec9SHong Zhang 
6504b84eec9SHong Zhang  x1 = x0 + h b^T YdotRHS
6514b84eec9SHong Zhang 
6524b84eec9SHong Zhang */
6534b84eec9SHong Zhang static PetscErrorCode TSEvaluateStep_MPRK(TS ts,PetscInt order,Vec X,PetscBool *done)
6544b84eec9SHong Zhang {
6554b84eec9SHong Zhang   TS_MPRK        *mprk = (TS_MPRK*)ts->data;
6564b84eec9SHong Zhang   MPRKTableau    tab = mprk->tableau;
6577c0df07dSHong Zhang   PetscScalar    *wf = mprk->work_fast;
6584b84eec9SHong Zhang   PetscReal      h = ts->time_step;
6594b84eec9SHong Zhang   PetscInt       s = tab->s,j;
6604b84eec9SHong Zhang   PetscErrorCode ierr;
6614b84eec9SHong Zhang 
6624b84eec9SHong Zhang   PetscFunctionBegin;
6634b84eec9SHong Zhang   for (j=0; j<s; j++) wf[j] = h*tab->bf[j];
6647c0df07dSHong Zhang   ierr = VecCopy(ts->vec_sol,X);CHKERRQ(ierr);
6657c0df07dSHong Zhang   ierr = VecMAXPY(X,s,wf,mprk->YdotRHS);CHKERRQ(ierr);
6664b84eec9SHong Zhang   PetscFunctionReturn(0);
6674b84eec9SHong Zhang }
6684b84eec9SHong Zhang 
6694b84eec9SHong Zhang static PetscErrorCode TSStep_MPRK(TS ts)
6704b84eec9SHong Zhang {
6714b84eec9SHong Zhang   TS_MPRK         *mprk = (TS_MPRK*)ts->data;
6727c0df07dSHong Zhang   Vec             *Y = mprk->Y,*YdotRHS = mprk->YdotRHS,*YdotRHS_fast = mprk->YdotRHS_fast,*YdotRHS_slow = mprk->YdotRHS_slow,*YdotRHS_slowbuffer = mprk->YdotRHS_slowbuffer;
6737c0df07dSHong Zhang   Vec             Yslow,Yslowbuffer,Yfast;
6744b84eec9SHong Zhang   MPRKTableau     tab = mprk->tableau;
6754b84eec9SHong Zhang   const PetscInt  s = tab->s;
67619c2959aSHong Zhang   const PetscReal *Af = tab->Af,*cf = tab->cf,*Asb = tab->Asb,*csb = tab->csb;
677*ebd5ed4eSHong Zhang   PetscScalar     *wf = mprk->work_fast,*wsb = mprk->work_slowbuffer;
678*ebd5ed4eSHong Zhang   PetscInt        i,j;
6794b84eec9SHong Zhang   PetscReal       next_time_step = ts->time_step,t = ts->ptime,h = ts->time_step;
6804b84eec9SHong Zhang   PetscErrorCode  ierr;
6814b84eec9SHong Zhang 
6824b84eec9SHong Zhang   PetscFunctionBegin;
6834b84eec9SHong Zhang   for (i=0; i<s; i++) {
6844b84eec9SHong Zhang     mprk->stage_time = t + h*cf[i];
6854b84eec9SHong Zhang     ierr = TSPreStage(ts,mprk->stage_time);CHKERRQ(ierr);
6867c0df07dSHong Zhang     ierr = VecCopy(ts->vec_sol,Y[i]);CHKERRQ(ierr);
6874b84eec9SHong Zhang 
6887c0df07dSHong Zhang     /* slow buffer region */
68919c2959aSHong Zhang     for (j=0; j<i; j++) wsb[j] = h*Asb[i*s+j];
6909849be05SHong Zhang     for (j=0; j<i; j++) {
6917c0df07dSHong Zhang       ierr = VecGetSubVector(YdotRHS[j],mprk->is_slowbuffer,&YdotRHS_slowbuffer[j]);CHKERRQ(ierr);
6927c0df07dSHong Zhang     }
6937c0df07dSHong Zhang     ierr = VecGetSubVector(Y[i],mprk->is_slowbuffer,&Yslowbuffer);CHKERRQ(ierr);
6947c0df07dSHong Zhang     ierr = VecMAXPY(Yslowbuffer,i,wsb,mprk->YdotRHS_slowbuffer);CHKERRQ(ierr);
6957c0df07dSHong Zhang     ierr = VecRestoreSubVector(Y[i],mprk->is_slowbuffer,&Yslowbuffer);CHKERRQ(ierr);
6969849be05SHong Zhang     for (j=0; j<i; j++) {
6977c0df07dSHong Zhang       ierr = VecRestoreSubVector(YdotRHS[j],mprk->is_slowbuffer,&YdotRHS_slowbuffer[j]);CHKERRQ(ierr);
6987c0df07dSHong Zhang     }
6997c0df07dSHong Zhang     /* slow region */
7007c0df07dSHong Zhang     if (mprk->is_slow) {
7019849be05SHong Zhang       for (j=0; j<i; j++) {
7027c0df07dSHong Zhang         ierr = VecGetSubVector(YdotRHS[j],mprk->is_slow,&YdotRHS_slow[j]);CHKERRQ(ierr);
7037c0df07dSHong Zhang       }
7047c0df07dSHong Zhang       ierr = VecGetSubVector(Y[i],mprk->is_slow,&Yslow);CHKERRQ(ierr);
705*ebd5ed4eSHong Zhang       ierr = VecMAXPY(Yslow,i,wsb,mprk->YdotRHS_slow);CHKERRQ(ierr);
7067c0df07dSHong Zhang       ierr = VecRestoreSubVector(Y[i],mprk->is_slow,&Yslow);CHKERRQ(ierr);
707*ebd5ed4eSHong Zhang       for (j=0; j<i; j++) {
7087c0df07dSHong Zhang         ierr = VecRestoreSubVector(YdotRHS[j],mprk->is_slow,&YdotRHS_slow[j]);CHKERRQ(ierr);
7097c0df07dSHong Zhang       }
7107c0df07dSHong Zhang     }
7114b84eec9SHong Zhang 
7127c0df07dSHong Zhang     /* fast region */
7134b84eec9SHong Zhang     for (j=0; j<i; j++) wf[j] = h*Af[i*s+j];
7149849be05SHong Zhang     for (j=0; j<i; j++) {
7157c0df07dSHong Zhang       ierr = VecGetSubVector(YdotRHS[j],mprk->is_fast,&YdotRHS_fast[j]);CHKERRQ(ierr);
7167c0df07dSHong Zhang     }
7177c0df07dSHong Zhang     ierr = VecGetSubVector(Y[i],mprk->is_fast,&Yfast);CHKERRQ(ierr);
7187c0df07dSHong Zhang     ierr = VecMAXPY(Yfast,i,wf,mprk->YdotRHS_fast);CHKERRQ(ierr);
7197c0df07dSHong Zhang     ierr = VecRestoreSubVector(Y[i],mprk->is_fast,&Yfast);CHKERRQ(ierr);
7209849be05SHong Zhang     for (j=0; j<i; j++) {
7217c0df07dSHong Zhang       ierr = VecRestoreSubVector(YdotRHS[j],mprk->is_fast,&YdotRHS_fast[j]);CHKERRQ(ierr);
7227c0df07dSHong Zhang     }
7237c0df07dSHong Zhang     if (tab->np == 3) {
7247c0df07dSHong Zhang       Vec         *YdotRHS_medium = mprk->YdotRHS_medium,*YdotRHS_mediumbuffer = mprk->YdotRHS_mediumbuffer;
7257c0df07dSHong Zhang       Vec         Ymedium,Ymediumbuffer;
726*ebd5ed4eSHong Zhang       PetscScalar *wmb = mprk->work_mediumbuffer;
727*ebd5ed4eSHong Zhang 
728*ebd5ed4eSHong Zhang       for (j=0; j<i; j++) wmb[j] = h*tab->Amb[i*s+j];
7297c0df07dSHong Zhang       /* medium region */
7307c0df07dSHong Zhang       if (mprk->is_medium) {
7317c0df07dSHong Zhang         for (j=0; j<i; j++) {
7327c0df07dSHong Zhang           ierr = VecGetSubVector(YdotRHS[j],mprk->is_medium,&YdotRHS_medium[j]);CHKERRQ(ierr);
7337c0df07dSHong Zhang         }
7347c0df07dSHong Zhang         ierr = VecGetSubVector(Y[i],mprk->is_medium,&Ymedium);CHKERRQ(ierr);
735*ebd5ed4eSHong Zhang         ierr = VecMAXPY(Ymedium,i,wmb,mprk->YdotRHS_medium);CHKERRQ(ierr);
7367c0df07dSHong Zhang         ierr = VecRestoreSubVector(Y[i],mprk->is_medium,&Ymedium);CHKERRQ(ierr);
737*ebd5ed4eSHong Zhang         for (j=0; j<i; j++) {
7387c0df07dSHong Zhang           ierr = VecRestoreSubVector(YdotRHS[j],mprk->is_medium,&YdotRHS_medium[j]);CHKERRQ(ierr);
7397c0df07dSHong Zhang         }
7407c0df07dSHong Zhang       }
7417c0df07dSHong Zhang       /* medium buffer region */
7429849be05SHong Zhang       for (j=0; j<i; j++) {
7437c0df07dSHong Zhang         ierr = VecGetSubVector(YdotRHS[j],mprk->is_mediumbuffer,&YdotRHS_mediumbuffer[j]);CHKERRQ(ierr);
7447c0df07dSHong Zhang       }
7457c0df07dSHong Zhang       ierr = VecGetSubVector(Y[i],mprk->is_mediumbuffer,&Ymediumbuffer);CHKERRQ(ierr);
7467c0df07dSHong Zhang       ierr = VecMAXPY(Ymediumbuffer,i,wmb,mprk->YdotRHS_mediumbuffer);CHKERRQ(ierr);
7477c0df07dSHong Zhang       ierr = VecRestoreSubVector(Y[i],mprk->is_mediumbuffer,&Ymediumbuffer);CHKERRQ(ierr);
7489849be05SHong Zhang       for (j=0; j<i; j++) {
7497c0df07dSHong Zhang         ierr = VecRestoreSubVector(YdotRHS[j],mprk->is_mediumbuffer,&YdotRHS_mediumbuffer[j]);CHKERRQ(ierr);
7507c0df07dSHong Zhang       }
7517c0df07dSHong Zhang     }
7524b84eec9SHong Zhang     ierr = TSPostStage(ts,mprk->stage_time,i,Y); CHKERRQ(ierr);
7534b84eec9SHong Zhang     /* compute the stage RHS by fast and slow tableau respectively */
7547c0df07dSHong Zhang     ierr = TSComputeRHSFunction(ts,t+h*csb[i],Y[i],YdotRHS[i]);CHKERRQ(ierr);
7554b84eec9SHong Zhang   }
7564b84eec9SHong Zhang   ierr = TSEvaluateStep(ts,tab->order,ts->vec_sol,NULL);CHKERRQ(ierr);
7574b84eec9SHong Zhang   ts->ptime += ts->time_step;
7584b84eec9SHong Zhang   ts->time_step = next_time_step;
7594b84eec9SHong Zhang   PetscFunctionReturn(0);
7604b84eec9SHong Zhang }
7614b84eec9SHong Zhang 
7624b84eec9SHong Zhang /*
7634b84eec9SHong Zhang  This if for partitioned RHS MPRK
7644b84eec9SHong Zhang  The step completion formula is
7654b84eec9SHong Zhang 
7664b84eec9SHong Zhang  x1 = x0 + h b^T YdotRHS
7674b84eec9SHong Zhang 
7684b84eec9SHong Zhang */
7694b84eec9SHong Zhang static PetscErrorCode TSEvaluateStep_MPRKSPLIT(TS ts,PetscInt order,Vec X,PetscBool *done)
7704b84eec9SHong Zhang {
7714b84eec9SHong Zhang   TS_MPRK        *mprk = (TS_MPRK*)ts->data;
7724b84eec9SHong Zhang   MPRKTableau    tab  = mprk->tableau;
77319c2959aSHong Zhang   Vec            Xslow,Xfast,Xslowbuffer; /* subvectors for slow and fast componets in X respectively */
77419c2959aSHong Zhang   PetscScalar    *wf = mprk->work_fast,*ws = mprk->work_slow,*wsb = mprk->work_slowbuffer;
7754b84eec9SHong Zhang   PetscReal      h = ts->time_step;
77679bc8a77SHong Zhang   PetscInt       s = tab->s,j,computedstages;
7774b84eec9SHong Zhang   PetscErrorCode ierr;
7784b84eec9SHong Zhang 
7794b84eec9SHong Zhang   PetscFunctionBegin;
7804b84eec9SHong Zhang   ierr = VecCopy(ts->vec_sol,X);CHKERRQ(ierr);
78119c2959aSHong Zhang 
78219c2959aSHong Zhang   /* slow region */
78319c2959aSHong Zhang   if (mprk->is_slow) {
78479bc8a77SHong Zhang     computedstages = 0;
78519c2959aSHong Zhang     for (j=0; j<s; j++) {
7869849be05SHong Zhang       if (tab->rsb[j]) ws[tab->rsb[j]-1] += h*tab->bsb[j];
78779bc8a77SHong Zhang       else ws[computedstages++] = h*tab->bsb[j];
78819c2959aSHong Zhang     }
7894b84eec9SHong Zhang     ierr = VecGetSubVector(X,mprk->is_slow,&Xslow);CHKERRQ(ierr);
79079bc8a77SHong Zhang     ierr = VecMAXPY(Xslow,computedstages,ws,mprk->YdotRHS_slow);CHKERRQ(ierr);
79119c2959aSHong Zhang     ierr = VecRestoreSubVector(X,mprk->is_slow,&Xslow);CHKERRQ(ierr);
79219c2959aSHong Zhang   }
79319c2959aSHong Zhang 
7949d6e09e9SHong Zhang   if (tab->np == 3 && mprk->is_medium) {
7959d6e09e9SHong Zhang     computedstages = 0;
7969d6e09e9SHong Zhang     for (j=0; j<s; j++) {
7979d6e09e9SHong Zhang       if (tab->rmb[j]) wsb[computedstages-tab->sbase+(tab->rmb[j]-1)%tab->sbase] += h*tab->bsb[j];
7989d6e09e9SHong Zhang       else wsb[computedstages++] = h*tab->bsb[j];
7999d6e09e9SHong Zhang     }
8009d6e09e9SHong Zhang     ierr = VecGetSubVector(X,mprk->is_slowbuffer,&Xslowbuffer);CHKERRQ(ierr);
8019d6e09e9SHong Zhang     ierr = VecMAXPY(Xslowbuffer,computedstages,wsb,mprk->YdotRHS_slowbuffer);CHKERRQ(ierr);
8029d6e09e9SHong Zhang     ierr = VecRestoreSubVector(X,mprk->is_slowbuffer,&Xslowbuffer);CHKERRQ(ierr);
8039d6e09e9SHong Zhang   } else {
80419c2959aSHong Zhang     /* slow buffer region */
80519c2959aSHong Zhang     for (j=0; j<s; j++) wsb[j] = h*tab->bsb[j];
80619c2959aSHong Zhang     ierr = VecGetSubVector(X,mprk->is_slowbuffer,&Xslowbuffer);CHKERRQ(ierr);
80719c2959aSHong Zhang     ierr = VecMAXPY(Xslowbuffer,s,wsb,mprk->YdotRHS_slowbuffer);CHKERRQ(ierr);
80819c2959aSHong Zhang     ierr = VecRestoreSubVector(X,mprk->is_slowbuffer,&Xslowbuffer);CHKERRQ(ierr);
8099d6e09e9SHong Zhang   }
81019c2959aSHong Zhang   if (tab->np == 3) {
81119c2959aSHong Zhang     Vec         Xmedium,Xmediumbuffer;
81219c2959aSHong Zhang     PetscScalar *wm = mprk->work_medium,*wmb = mprk->work_mediumbuffer;
8139d6e09e9SHong Zhang     /* medium region and slow buffer region */
81419c2959aSHong Zhang     if (mprk->is_medium) {
81579bc8a77SHong Zhang       computedstages = 0;
81619c2959aSHong Zhang       for (j=0; j<s; j++) {
81779bc8a77SHong Zhang         if (tab->rmb[j]) wm[computedstages-tab->sbase+(tab->rmb[j]-1)%tab->sbase] += h*tab->bmb[j];
81879bc8a77SHong Zhang         else wm[computedstages++] = h*tab->bmb[j];
81919c2959aSHong Zhang       }
82019c2959aSHong Zhang       ierr = VecGetSubVector(X,mprk->is_medium,&Xmedium);CHKERRQ(ierr);
82179bc8a77SHong Zhang       ierr = VecMAXPY(Xmedium,computedstages,wm,mprk->YdotRHS_medium);CHKERRQ(ierr);
82219c2959aSHong Zhang       ierr = VecRestoreSubVector(X,mprk->is_medium,&Xmedium);CHKERRQ(ierr);
82319c2959aSHong Zhang     }
82419c2959aSHong Zhang     /* medium buffer region */
82519c2959aSHong Zhang     for (j=0; j<s; j++) wmb[j] = h*tab->bmb[j];
82619c2959aSHong Zhang     ierr = VecGetSubVector(X,mprk->is_mediumbuffer,&Xmediumbuffer);CHKERRQ(ierr);
82719c2959aSHong Zhang     ierr = VecMAXPY(Xmediumbuffer,s,wmb,mprk->YdotRHS_mediumbuffer);CHKERRQ(ierr);
82819c2959aSHong Zhang     ierr = VecRestoreSubVector(X,mprk->is_mediumbuffer,&Xmediumbuffer);CHKERRQ(ierr);
82919c2959aSHong Zhang   }
83019c2959aSHong Zhang   /* fast region */
83119c2959aSHong Zhang   for (j=0; j<s; j++) wf[j] = h*tab->bf[j];
8324b84eec9SHong Zhang   ierr = VecGetSubVector(X,mprk->is_fast,&Xfast);CHKERRQ(ierr);
8334b84eec9SHong Zhang   ierr = VecMAXPY(Xfast,s,wf,mprk->YdotRHS_fast);CHKERRQ(ierr);
83419c2959aSHong Zhang   ierr = VecRestoreSubVector(X,mprk->is_fast,&Xfast);CHKERRQ(ierr);
8354b84eec9SHong Zhang   PetscFunctionReturn(0);
8364b84eec9SHong Zhang }
8374b84eec9SHong Zhang 
8384b84eec9SHong Zhang static PetscErrorCode TSStep_MPRKSPLIT(TS ts)
8394b84eec9SHong Zhang {
8404b84eec9SHong Zhang   TS_MPRK         *mprk = (TS_MPRK*)ts->data;
8414b84eec9SHong Zhang   MPRKTableau     tab = mprk->tableau;
84219c2959aSHong Zhang   Vec             *Y = mprk->Y,*YdotRHS_fast = mprk->YdotRHS_fast,*YdotRHS_slow = mprk->YdotRHS_slow,*YdotRHS_slowbuffer = mprk->YdotRHS_slowbuffer;
84319c2959aSHong Zhang   Vec             Yslow,Yslowbuffer,Yfast; /* subvectors for slow and fast components in Y[i] respectively */
84419c2959aSHong Zhang   PetscInt        s = tab->s;
84519c2959aSHong Zhang   const PetscReal *Af = tab->Af,*cf = tab->cf,*Asb = tab->Asb,*csb = tab->csb;
84619c2959aSHong Zhang   PetscScalar     *wf = mprk->work_fast,*ws = mprk->work_slow,*wsb = mprk->work_slowbuffer;
84779bc8a77SHong Zhang   PetscInt        i,j,computedstages;
8484b84eec9SHong Zhang   PetscReal       next_time_step = ts->time_step,t = ts->ptime,h = ts->time_step;
8494b84eec9SHong Zhang   PetscErrorCode  ierr;
8504b84eec9SHong Zhang 
8514b84eec9SHong Zhang   PetscFunctionBegin;
8524b84eec9SHong Zhang   for (i=0; i<s; i++) {
8534b84eec9SHong Zhang     mprk->stage_time = t + h*cf[i];
8544b84eec9SHong Zhang     ierr = TSPreStage(ts,mprk->stage_time);CHKERRQ(ierr);
8554b84eec9SHong Zhang     /* calculate the stage value for fast and slow components respectively */
8564b84eec9SHong Zhang     ierr = VecCopy(ts->vec_sol,Y[i]);CHKERRQ(ierr);
85719c2959aSHong Zhang     for (j=0; j<i; j++) wsb[j] = h*Asb[i*s+j];
85819c2959aSHong Zhang 
85919c2959aSHong Zhang     /* slow buffer region */
8609d6e09e9SHong Zhang     if (tab->np == 3 && mprk->is_medium) {
8619d6e09e9SHong Zhang       if (tab->rmb[i]) {
8629d6e09e9SHong Zhang         ierr = VecGetSubVector(Y[i],mprk->is_slowbuffer,&Yslowbuffer);CHKERRQ(ierr);
8639d6e09e9SHong Zhang         ierr = VecISCopy(Y[tab->rmb[i]-1],mprk->is_slowbuffer,SCATTER_REVERSE,Yslowbuffer);CHKERRQ(ierr);
8649d6e09e9SHong Zhang         ierr = VecRestoreSubVector(Y[i],mprk->is_slowbuffer,&Yslowbuffer);CHKERRQ(ierr);
8659d6e09e9SHong Zhang       } else {
8669d6e09e9SHong Zhang         PetscScalar *wm = mprk->work_medium;
8679d6e09e9SHong Zhang         computedstages = 0;
8689d6e09e9SHong Zhang         for (j=0; j<i; j++) {
8699d6e09e9SHong Zhang           if (tab->rmb[j]) wm[computedstages-tab->sbase+(tab->rmb[j]-1)%tab->sbase] += wsb[j];
8709d6e09e9SHong Zhang           else wm[computedstages++] = wsb[j];
8719d6e09e9SHong Zhang         }
8729d6e09e9SHong Zhang         ierr = VecGetSubVector(Y[i],mprk->is_slowbuffer,&Yslowbuffer);CHKERRQ(ierr);
8739d6e09e9SHong Zhang         ierr = VecMAXPY(Yslowbuffer,computedstages,wm,YdotRHS_slowbuffer);CHKERRQ(ierr);
8749d6e09e9SHong Zhang         ierr = VecRestoreSubVector(Y[i],mprk->is_slowbuffer,&Yslowbuffer);CHKERRQ(ierr);
8759d6e09e9SHong Zhang       }
8769d6e09e9SHong Zhang     } else {
87719c2959aSHong Zhang       ierr = VecGetSubVector(Y[i],mprk->is_slowbuffer,&Yslowbuffer);CHKERRQ(ierr);
87819c2959aSHong Zhang       ierr = VecMAXPY(Yslowbuffer,i,wsb,YdotRHS_slowbuffer);CHKERRQ(ierr);
87919c2959aSHong Zhang       ierr = VecRestoreSubVector(Y[i],mprk->is_slowbuffer,&Yslowbuffer);CHKERRQ(ierr);
8809d6e09e9SHong Zhang     }
8819849be05SHong Zhang 
88219c2959aSHong Zhang     /* slow region */
8839849be05SHong Zhang     if (mprk->is_slow) {
8849849be05SHong Zhang       if (tab->rsb[i]) { /* repeat previous stage */
8859849be05SHong Zhang         ierr = VecGetSubVector(Y[i],mprk->is_slow,&Yslow);CHKERRQ(ierr);
8869849be05SHong Zhang         ierr = VecISCopy(Y[tab->rsb[i]-1],mprk->is_slow,SCATTER_REVERSE,Yslow);CHKERRQ(ierr);
8879849be05SHong Zhang         ierr = VecRestoreSubVector(Y[i],mprk->is_slow,&Yslow);CHKERRQ(ierr);
8889849be05SHong Zhang       } else {
88979bc8a77SHong Zhang         computedstages = 0;
89019c2959aSHong Zhang         for (j=0; j<i; j++) {
89179bc8a77SHong Zhang           if (tab->rsb[j]) ws[tab->rsb[j]-1] += wsb[j];
89279bc8a77SHong Zhang           else ws[computedstages++] = wsb[j];
89319c2959aSHong Zhang         }
8944b84eec9SHong Zhang         ierr = VecGetSubVector(Y[i],mprk->is_slow,&Yslow);CHKERRQ(ierr);
89579bc8a77SHong Zhang         ierr = VecMAXPY(Yslow,computedstages,ws,YdotRHS_slow);CHKERRQ(ierr);
8964b84eec9SHong Zhang         ierr = VecRestoreSubVector(Y[i],mprk->is_slow,&Yslow);CHKERRQ(ierr);
89719c2959aSHong Zhang         /* only depends on the slow buffer region */
89879bc8a77SHong Zhang         ierr = TSComputeRHSFunction(mprk->subts_slow,t+h*csb[i],Y[i],YdotRHS_slow[computedstages]);CHKERRQ(ierr);
89919c2959aSHong Zhang       }
9009849be05SHong Zhang     }
90119c2959aSHong Zhang 
90219c2959aSHong Zhang     /* fast region */
90319c2959aSHong Zhang     for (j=0; j<i; j++) wf[j] = h*Af[i*s+j];
90419c2959aSHong Zhang     ierr = VecGetSubVector(Y[i],mprk->is_fast,&Yfast);CHKERRQ(ierr);
90519c2959aSHong Zhang     ierr = VecMAXPY(Yfast,i,wf,YdotRHS_fast);CHKERRQ(ierr);
9064b84eec9SHong Zhang     ierr = VecRestoreSubVector(Y[i],mprk->is_fast,&Yfast);CHKERRQ(ierr);
90719c2959aSHong Zhang 
90819c2959aSHong Zhang     if (tab->np == 3) {
90919c2959aSHong Zhang       Vec *YdotRHS_medium = mprk->YdotRHS_medium,*YdotRHS_mediumbuffer = mprk->YdotRHS_mediumbuffer;
91019c2959aSHong Zhang       Vec Ymedium,Ymediumbuffer;
91119c2959aSHong Zhang       const PetscReal *Amb = tab->Amb,*cmb = tab->cmb;
91219c2959aSHong Zhang       PetscScalar *wm = mprk->work_medium,*wmb = mprk->work_mediumbuffer;
91319c2959aSHong Zhang 
91419c2959aSHong Zhang       for (j=0; j<i; j++) wmb[j] = h*Amb[i*s+j];
91519c2959aSHong Zhang       /* medium buffer region */
91619c2959aSHong Zhang       ierr = VecGetSubVector(Y[i],mprk->is_mediumbuffer,&Ymediumbuffer);CHKERRQ(ierr);
91719c2959aSHong Zhang       ierr = VecMAXPY(Ymediumbuffer,i,wmb,YdotRHS_mediumbuffer);CHKERRQ(ierr);
91819c2959aSHong Zhang       ierr = VecRestoreSubVector(Y[i],mprk->is_mediumbuffer,&Ymediumbuffer);CHKERRQ(ierr);
91919c2959aSHong Zhang       /* medium region */
92079bc8a77SHong Zhang       if (mprk->is_medium) {
92179bc8a77SHong Zhang         if (tab->rmb[i]) { /* repeat previous stage */
92279bc8a77SHong Zhang           ierr = VecGetSubVector(Y[i],mprk->is_medium,&Ymedium);CHKERRQ(ierr);
92379bc8a77SHong Zhang           ierr = VecISCopy(Y[tab->rmb[i]-1],mprk->is_medium,SCATTER_REVERSE,Ymedium);CHKERRQ(ierr);
92419c2959aSHong Zhang           ierr = VecRestoreSubVector(Y[i],mprk->is_medium,&Ymedium);CHKERRQ(ierr);
92579bc8a77SHong Zhang         } else {
92679bc8a77SHong Zhang           computedstages = 0;
92779bc8a77SHong Zhang           for (j=0; j<i; j++) {
92879bc8a77SHong Zhang             if (tab->rmb[j]) wm[computedstages-tab->sbase+(tab->rmb[j]-1)%tab->sbase] += wmb[j];
92979bc8a77SHong Zhang             else wm[computedstages++] = wmb[j];
93079bc8a77SHong Zhang 
93179bc8a77SHong Zhang           }
93279bc8a77SHong Zhang           ierr = VecGetSubVector(Y[i],mprk->is_medium,&Ymedium);CHKERRQ(ierr);
93379bc8a77SHong Zhang           ierr = VecMAXPY(Ymedium,computedstages,wm,YdotRHS_medium);CHKERRQ(ierr);
93479bc8a77SHong Zhang           ierr = VecRestoreSubVector(Y[i],mprk->is_medium,&Ymedium);CHKERRQ(ierr);
93579bc8a77SHong Zhang           /* only depends on the medium buffer region */
93679bc8a77SHong Zhang           ierr = TSComputeRHSFunction(mprk->subts_medium,t+h*cmb[i],Y[i],YdotRHS_medium[computedstages]);CHKERRQ(ierr);
9379d6e09e9SHong Zhang           /* must be computed after all regions are updated in Y */
9389d6e09e9SHong Zhang           ierr = TSComputeRHSFunction(mprk->subts_slowbuffer,t+h*csb[i],Y[i],YdotRHS_slowbuffer[computedstages]);CHKERRQ(ierr);
93979bc8a77SHong Zhang         }
94019c2959aSHong Zhang       }
94119c2959aSHong Zhang       /* must be computed after fast region and slow region are updated in Y */
94219c2959aSHong Zhang       ierr = TSComputeRHSFunction(mprk->subts_mediumbuffer,t+h*cmb[i],Y[i],YdotRHS_mediumbuffer[i]);CHKERRQ(ierr);
94319c2959aSHong Zhang     }
9449d6e09e9SHong Zhang     if (!(tab->np == 3 && mprk->is_medium)) {
94519c2959aSHong Zhang       ierr = TSComputeRHSFunction(mprk->subts_slowbuffer,t+h*csb[i],Y[i],YdotRHS_slowbuffer[i]);CHKERRQ(ierr);
9469d6e09e9SHong Zhang     }
9477c0df07dSHong Zhang     ierr = TSComputeRHSFunction(mprk->subts_fast,t+h*cf[i],Y[i],YdotRHS_fast[i]);
9484b84eec9SHong Zhang   }
94979bc8a77SHong Zhang 
9504b84eec9SHong Zhang   ierr = TSEvaluateStep(ts,tab->order,ts->vec_sol,NULL);CHKERRQ(ierr);
9514b84eec9SHong Zhang   ts->ptime += ts->time_step;
9524b84eec9SHong Zhang   ts->time_step = next_time_step;
9534b84eec9SHong Zhang   PetscFunctionReturn(0);
9544b84eec9SHong Zhang }
9554b84eec9SHong Zhang 
9564b84eec9SHong Zhang static PetscErrorCode TSMPRKTableauReset(TS ts)
9574b84eec9SHong Zhang {
9584b84eec9SHong Zhang   TS_MPRK        *mprk = (TS_MPRK*)ts->data;
9594b84eec9SHong Zhang   MPRKTableau    tab = mprk->tableau;
9604b84eec9SHong Zhang   PetscErrorCode ierr;
9614b84eec9SHong Zhang 
9624b84eec9SHong Zhang   PetscFunctionBegin;
9634b84eec9SHong Zhang   if (!tab) PetscFunctionReturn(0);
9644b84eec9SHong Zhang   ierr = PetscFree(mprk->work_fast);CHKERRQ(ierr);
9654b84eec9SHong Zhang   ierr = PetscFree(mprk->work_slow);CHKERRQ(ierr);
9667c0df07dSHong Zhang   ierr = PetscFree(mprk->work_slowbuffer);CHKERRQ(ierr);
9677c0df07dSHong Zhang   ierr = PetscFree(mprk->work_medium);CHKERRQ(ierr);
9687c0df07dSHong Zhang   ierr = PetscFree(mprk->work_mediumbuffer);CHKERRQ(ierr);
9694b84eec9SHong Zhang   ierr = VecDestroyVecs(tab->s,&mprk->Y);CHKERRQ(ierr);
9704b84eec9SHong Zhang   if (mprk->mprkmtype == TSMPRKNONSPLIT) {
9717c0df07dSHong Zhang     ierr = VecDestroyVecs(tab->s,&mprk->YdotRHS);CHKERRQ(ierr);
9727c0df07dSHong Zhang     if (mprk->is_slow) {
9737c0df07dSHong Zhang       ierr = PetscFree(mprk->YdotRHS_slow);CHKERRQ(ierr);
9744b84eec9SHong Zhang     }
9757c0df07dSHong Zhang     ierr = PetscFree(mprk->YdotRHS_slowbuffer);CHKERRQ(ierr);
9767c0df07dSHong Zhang     if (tab->np == 3) {
9777c0df07dSHong Zhang       if (mprk->is_medium) {
9787c0df07dSHong Zhang         ierr = PetscFree(mprk->YdotRHS_medium);CHKERRQ(ierr);
9797c0df07dSHong Zhang       }
9807c0df07dSHong Zhang       ierr = PetscFree(mprk->YdotRHS_mediumbuffer);CHKERRQ(ierr);
9817c0df07dSHong Zhang     }
9827c0df07dSHong Zhang     ierr = PetscFree(mprk->YdotRHS_fast);CHKERRQ(ierr);
9837c0df07dSHong Zhang 
9847c0df07dSHong Zhang   } else {
9854b84eec9SHong Zhang     ierr = VecDestroyVecs(tab->s,&mprk->YdotRHS_fast);CHKERRQ(ierr);
9864b84eec9SHong Zhang     ierr = VecDestroyVecs(tab->s,&mprk->YdotRHS_slow);CHKERRQ(ierr);
9877c0df07dSHong Zhang     ierr = VecDestroyVecs(tab->s,&mprk->YdotRHS_slowbuffer);CHKERRQ(ierr);
9887c0df07dSHong Zhang     ierr = VecDestroyVecs(tab->s,&mprk->YdotRHS_medium);CHKERRQ(ierr);
9897c0df07dSHong Zhang     ierr = VecDestroyVecs(tab->s,&mprk->YdotRHS_mediumbuffer);CHKERRQ(ierr);
9907c0df07dSHong Zhang   }
9914b84eec9SHong Zhang   PetscFunctionReturn(0);
9924b84eec9SHong Zhang }
9934b84eec9SHong Zhang 
9944b84eec9SHong Zhang static PetscErrorCode TSReset_MPRK(TS ts)
9954b84eec9SHong Zhang {
9964b84eec9SHong Zhang   PetscErrorCode ierr;
9974b84eec9SHong Zhang 
9984b84eec9SHong Zhang   PetscFunctionBegin;
9994b84eec9SHong Zhang   ierr = TSMPRKTableauReset(ts);CHKERRQ(ierr);
10004b84eec9SHong Zhang   PetscFunctionReturn(0);
10014b84eec9SHong Zhang }
10024b84eec9SHong Zhang 
10034b84eec9SHong Zhang static PetscErrorCode DMCoarsenHook_TSMPRK(DM fine,DM coarse,void *ctx)
10044b84eec9SHong Zhang {
10054b84eec9SHong Zhang   PetscFunctionBegin;
10064b84eec9SHong Zhang   PetscFunctionReturn(0);
10074b84eec9SHong Zhang }
10084b84eec9SHong Zhang 
10094b84eec9SHong Zhang static PetscErrorCode DMRestrictHook_TSMPRK(DM fine,Mat restrct,Vec rscale,Mat inject,DM coarse,void *ctx)
10104b84eec9SHong Zhang {
10114b84eec9SHong Zhang   PetscFunctionBegin;
10124b84eec9SHong Zhang   PetscFunctionReturn(0);
10134b84eec9SHong Zhang }
10144b84eec9SHong Zhang 
10154b84eec9SHong Zhang static PetscErrorCode DMSubDomainHook_TSMPRK(DM dm,DM subdm,void *ctx)
10164b84eec9SHong Zhang {
10174b84eec9SHong Zhang   PetscFunctionBegin;
10184b84eec9SHong Zhang   PetscFunctionReturn(0);
10194b84eec9SHong Zhang }
10204b84eec9SHong Zhang 
10214b84eec9SHong Zhang static PetscErrorCode DMSubDomainRestrictHook_TSMPRK(DM dm,VecScatter gscat,VecScatter lscat,DM subdm,void *ctx)
10224b84eec9SHong Zhang {
10234b84eec9SHong Zhang   PetscFunctionBegin;
10244b84eec9SHong Zhang   PetscFunctionReturn(0);
10254b84eec9SHong Zhang }
10264b84eec9SHong Zhang 
10274b84eec9SHong Zhang static PetscErrorCode TSMPRKTableauSetUp(TS ts)
10284b84eec9SHong Zhang {
10294b84eec9SHong Zhang   TS_MPRK        *mprk  = (TS_MPRK*)ts->data;
10304b84eec9SHong Zhang   MPRKTableau    tab = mprk->tableau;
103119c2959aSHong Zhang   Vec            YdotRHS_slow,YdotRHS_slowbuffer,YdotRHS_medium,YdotRHS_mediumbuffer,YdotRHS_fast;
10324b84eec9SHong Zhang   PetscErrorCode ierr;
10334b84eec9SHong Zhang 
10344b84eec9SHong Zhang   PetscFunctionBegin;
10354b84eec9SHong Zhang   ierr = VecDuplicateVecs(ts->vec_sol,tab->s,&mprk->Y);CHKERRQ(ierr);
10367c0df07dSHong Zhang   if (mprk->is_slow) {
103719c2959aSHong Zhang     ierr = PetscMalloc1(tab->s,&mprk->work_slow);CHKERRQ(ierr);
10384b84eec9SHong Zhang   }
10397c0df07dSHong Zhang   ierr = PetscMalloc1(tab->s,&mprk->work_slowbuffer);CHKERRQ(ierr);
10407c0df07dSHong Zhang   if (tab->np == 3) {
10417c0df07dSHong Zhang     if (mprk->is_medium) {
10427c0df07dSHong Zhang       ierr = PetscMalloc1(tab->s,&mprk->work_medium);CHKERRQ(ierr);
10437c0df07dSHong Zhang     }
10447c0df07dSHong Zhang     ierr = PetscMalloc1(tab->s,&mprk->work_mediumbuffer);CHKERRQ(ierr);
10457c0df07dSHong Zhang   }
10467c0df07dSHong Zhang   ierr = PetscMalloc1(tab->s,&mprk->work_fast);CHKERRQ(ierr);
10477c0df07dSHong Zhang 
10487c0df07dSHong Zhang   if (mprk->mprkmtype == TSMPRKNONSPLIT) {
10497c0df07dSHong Zhang     ierr = VecDuplicateVecs(ts->vec_sol,tab->s,&mprk->YdotRHS);CHKERRQ(ierr);
10507c0df07dSHong Zhang     if (mprk->is_slow) {
10517c0df07dSHong Zhang       ierr = PetscMalloc1(tab->s,&mprk->YdotRHS_slow);CHKERRQ(ierr);
10527c0df07dSHong Zhang     }
10537c0df07dSHong Zhang     ierr = PetscMalloc1(tab->s,&mprk->YdotRHS_slowbuffer);CHKERRQ(ierr);
10547c0df07dSHong Zhang     if (tab->np == 3) {
10557c0df07dSHong Zhang       if (mprk->is_medium) {
10567c0df07dSHong Zhang         ierr = PetscMalloc1(tab->s,&mprk->YdotRHS_medium);CHKERRQ(ierr);
10577c0df07dSHong Zhang       }
10587c0df07dSHong Zhang       ierr = PetscMalloc1(tab->s,&mprk->YdotRHS_mediumbuffer);CHKERRQ(ierr);
10597c0df07dSHong Zhang     }
10607c0df07dSHong Zhang     ierr = PetscMalloc1(tab->s,&mprk->YdotRHS_fast);CHKERRQ(ierr);
10617c0df07dSHong Zhang   } else {
106219c2959aSHong Zhang     if (mprk->is_slow) {
10634b84eec9SHong Zhang       ierr = VecGetSubVector(ts->vec_sol,mprk->is_slow,&YdotRHS_slow);CHKERRQ(ierr);
10644b84eec9SHong Zhang       ierr = VecDuplicateVecs(YdotRHS_slow,tab->s,&mprk->YdotRHS_slow);CHKERRQ(ierr);
10654b84eec9SHong Zhang       ierr = VecRestoreSubVector(ts->vec_sol,mprk->is_slow,&YdotRHS_slow);CHKERRQ(ierr);
106619c2959aSHong Zhang     }
106719c2959aSHong Zhang     ierr = VecGetSubVector(ts->vec_sol,mprk->is_slowbuffer,&YdotRHS_slowbuffer);CHKERRQ(ierr);
106819c2959aSHong Zhang     ierr = VecDuplicateVecs(YdotRHS_slowbuffer,tab->s,&mprk->YdotRHS_slowbuffer);CHKERRQ(ierr);
106919c2959aSHong Zhang     ierr = VecRestoreSubVector(ts->vec_sol,mprk->is_slowbuffer,&YdotRHS_slowbuffer);CHKERRQ(ierr);
107019c2959aSHong Zhang     if (tab->np == 3) {
107119c2959aSHong Zhang       if (mprk->is_medium) {
107219c2959aSHong Zhang         ierr = VecGetSubVector(ts->vec_sol,mprk->is_medium,&YdotRHS_medium);CHKERRQ(ierr);
107319c2959aSHong Zhang         ierr = VecDuplicateVecs(YdotRHS_medium,tab->s,&mprk->YdotRHS_medium);CHKERRQ(ierr);
107419c2959aSHong Zhang         ierr = VecRestoreSubVector(ts->vec_sol,mprk->is_medium,&YdotRHS_medium);CHKERRQ(ierr);
107519c2959aSHong Zhang       }
107619c2959aSHong Zhang       ierr = VecGetSubVector(ts->vec_sol,mprk->is_mediumbuffer,&YdotRHS_mediumbuffer);CHKERRQ(ierr);
107719c2959aSHong Zhang       ierr = VecDuplicateVecs(YdotRHS_mediumbuffer,tab->s,&mprk->YdotRHS_mediumbuffer);CHKERRQ(ierr);
107819c2959aSHong Zhang       ierr = VecRestoreSubVector(ts->vec_sol,mprk->is_mediumbuffer,&YdotRHS_mediumbuffer);CHKERRQ(ierr);
107919c2959aSHong Zhang     }
108019c2959aSHong Zhang     ierr = VecGetSubVector(ts->vec_sol,mprk->is_fast,&YdotRHS_fast);CHKERRQ(ierr);
108119c2959aSHong Zhang     ierr = VecDuplicateVecs(YdotRHS_fast,tab->s,&mprk->YdotRHS_fast);CHKERRQ(ierr);
10824b84eec9SHong Zhang     ierr = VecRestoreSubVector(ts->vec_sol,mprk->is_fast,&YdotRHS_fast);CHKERRQ(ierr);
10834b84eec9SHong Zhang   }
10844b84eec9SHong Zhang   PetscFunctionReturn(0);
10854b84eec9SHong Zhang }
10864b84eec9SHong Zhang 
10874b84eec9SHong Zhang static PetscErrorCode TSSetUp_MPRK(TS ts)
10884b84eec9SHong Zhang {
10894b84eec9SHong Zhang   TS_MPRK        *mprk = (TS_MPRK*)ts->data;
109019c2959aSHong Zhang   MPRKTableau    tab = mprk->tableau;
10914b84eec9SHong Zhang   DM             dm;
10924b84eec9SHong Zhang   PetscErrorCode ierr;
10934b84eec9SHong Zhang 
10944b84eec9SHong Zhang   PetscFunctionBegin;
10954b84eec9SHong Zhang   ierr = TSRHSSplitGetIS(ts,"slow",&mprk->is_slow);CHKERRQ(ierr);
10964b84eec9SHong Zhang   ierr = TSRHSSplitGetIS(ts,"fast",&mprk->is_fast);CHKERRQ(ierr);
109719c2959aSHong Zhang   if (!mprk->is_slow || !mprk->is_fast) SETERRQ1(PetscObjectComm((PetscObject)ts),PETSC_ERR_USER,"Must set up RHSSplits with TSRHSSplitSetIS() using split names 'slow' and 'fast' respectively in order to use the method '%s'",tab->name);
109819c2959aSHong Zhang 
109919c2959aSHong Zhang   if (tab->np == 3) {
110019c2959aSHong Zhang     ierr = TSRHSSplitGetIS(ts,"medium",&mprk->is_medium);CHKERRQ(ierr);
110119c2959aSHong Zhang     if (!mprk->is_medium) SETERRQ1(PetscObjectComm((PetscObject)ts),PETSC_ERR_USER,"Must set up RHSSplits with TSRHSSplitSetIS() using split names 'slow' and 'medium' and 'fast' respectively in order to use the method '%s'",tab->name);
110219c2959aSHong Zhang     ierr = TSRHSSplitGetIS(ts,"mediumbuffer",&mprk->is_mediumbuffer);CHKERRQ(ierr);
110319c2959aSHong Zhang     if (!mprk->is_mediumbuffer) { /* let medium buffer cover whole medium region */
110419c2959aSHong Zhang       mprk->is_mediumbuffer = mprk->is_medium;
110519c2959aSHong Zhang       mprk->is_medium = NULL;
110619c2959aSHong Zhang     }
110719c2959aSHong Zhang   }
110819c2959aSHong Zhang 
110919c2959aSHong Zhang   /* If users do not provide buffer region settings, the solver will do them automatically, but with a performance penalty */
111019c2959aSHong Zhang   ierr = TSRHSSplitGetIS(ts,"slowbuffer",&mprk->is_slowbuffer);CHKERRQ(ierr);
111119c2959aSHong Zhang   if (!mprk->is_slowbuffer) { /* let slow buffer cover whole slow region */
111219c2959aSHong Zhang     mprk->is_slowbuffer = mprk->is_slow;
111319c2959aSHong Zhang     mprk->is_slow = NULL;
111419c2959aSHong Zhang   }
111519c2959aSHong Zhang /*
111619c2959aSHong Zhang   if (!mprk->is_medium) {
111719c2959aSHong Zhang     mprk->is_medium = mprk->is_fast;
111819c2959aSHong Zhang     mprk->is_fast = NULL;
111919c2959aSHong Zhang   } else {
112019c2959aSHong Zhang     ierr = TSRHSSplitGetIS(ts,"mediumbuffer",&mprk->is_mediumbuffer);CHKERRQ(ierr);
112119c2959aSHong Zhang   }
112219c2959aSHong Zhang */
11234b84eec9SHong Zhang   ierr = TSCheckImplicitTerm(ts);CHKERRQ(ierr);
11244b84eec9SHong Zhang   ierr = TSMPRKTableauSetUp(ts);CHKERRQ(ierr);
11254b84eec9SHong Zhang   ierr = TSGetDM(ts,&dm);CHKERRQ(ierr);
11264b84eec9SHong Zhang   ierr = DMCoarsenHookAdd(dm,DMCoarsenHook_TSMPRK,DMRestrictHook_TSMPRK,ts);CHKERRQ(ierr);
11274b84eec9SHong Zhang   ierr = DMSubDomainHookAdd(dm,DMSubDomainHook_TSMPRK,DMSubDomainRestrictHook_TSMPRK,ts);CHKERRQ(ierr);
11284b84eec9SHong Zhang   ierr = PetscTryMethod(ts,"TSMPRKSetSplits_C",(TS),(ts));CHKERRQ(ierr);
11294b84eec9SHong Zhang   PetscFunctionReturn(0);
11304b84eec9SHong Zhang }
11314b84eec9SHong Zhang 
11324b84eec9SHong Zhang /* construct a database to chose nonsplit RHS mutirate mprk method or split RHS MPRK method */
11334b84eec9SHong Zhang const char *const TSMPRKMultirateTypes[] = {"NONSPLIT","SPLIT","TSMPRKMultirateType","TSMPRK",0};
11344b84eec9SHong Zhang 
11354b84eec9SHong Zhang static PetscErrorCode TSSetFromOptions_MPRK(PetscOptionItems *PetscOptionsObject,TS ts)
11364b84eec9SHong Zhang {
11374b84eec9SHong Zhang   TS_MPRK        *mprk = (TS_MPRK*)ts->data;
11384b84eec9SHong Zhang   PetscErrorCode ierr;
11394b84eec9SHong Zhang 
11404b84eec9SHong Zhang   PetscFunctionBegin;
11414b84eec9SHong Zhang   ierr = PetscOptionsHead(PetscOptionsObject,"PRK ODE solver options");CHKERRQ(ierr);
11424b84eec9SHong Zhang   {
11434b84eec9SHong Zhang     MPRKTableauLink link;
11444b84eec9SHong Zhang     PetscInt        count,choice;
11454b84eec9SHong Zhang     PetscBool       flg;
11464b84eec9SHong Zhang     const char      **namelist;
11474b84eec9SHong Zhang     PetscInt        mprkmtype = 0;
11484b84eec9SHong Zhang     for (link=MPRKTableauList,count=0; link; link=link->next,count++) ;
11494b84eec9SHong Zhang     ierr = PetscMalloc1(count,(char***)&namelist);CHKERRQ(ierr);
11504b84eec9SHong Zhang     for (link=MPRKTableauList,count=0; link; link=link->next,count++) namelist[count] = link->tab.name;
11514b84eec9SHong Zhang     ierr = PetscOptionsEList("-ts_mprk_type","Family of MPRK method","TSMPRKSetType",(const char*const*)namelist,count,mprk->tableau->name,&choice,&flg);CHKERRQ(ierr);
11524b84eec9SHong Zhang     if (flg) {ierr = TSMPRKSetType(ts,namelist[choice]);CHKERRQ(ierr);}
11534b84eec9SHong Zhang     ierr = PetscFree(namelist);CHKERRQ(ierr);
11544b84eec9SHong Zhang     ierr = PetscOptionsEList("-ts_mprk_multirate_type","Use Combined RHS Multirate or Partioned RHS Multirat MPRK method","TSMPRKSetMultirateType",TSMPRKMultirateTypes,2,TSMPRKMultirateTypes[0],&mprkmtype,&flg);CHKERRQ(ierr);
11554b84eec9SHong Zhang      if (flg) {ierr = TSMPRKSetMultirateType(ts,mprkmtype);CHKERRQ(ierr);}
11564b84eec9SHong Zhang   }
11574b84eec9SHong Zhang   ierr = PetscOptionsTail();CHKERRQ(ierr);
11584b84eec9SHong Zhang   PetscFunctionReturn(0);
11594b84eec9SHong Zhang }
11604b84eec9SHong Zhang 
11614b84eec9SHong Zhang static PetscErrorCode TSView_MPRK(TS ts,PetscViewer viewer)
11624b84eec9SHong Zhang {
11634b84eec9SHong Zhang   TS_MPRK        *mprk = (TS_MPRK*)ts->data;
11644b84eec9SHong Zhang   PetscBool      iascii;
11654b84eec9SHong Zhang   PetscErrorCode ierr;
11664b84eec9SHong Zhang 
11674b84eec9SHong Zhang   PetscFunctionBegin;
11684b84eec9SHong Zhang   ierr = PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERASCII,&iascii);CHKERRQ(ierr);
11694b84eec9SHong Zhang   if (iascii) {
11704b84eec9SHong Zhang     MPRKTableau tab  = mprk->tableau;
11714b84eec9SHong Zhang     TSMPRKType  mprktype;
11724b84eec9SHong Zhang     char        fbuf[512];
11734b84eec9SHong Zhang     char        sbuf[512];
117419c2959aSHong Zhang     PetscInt    i;
11754b84eec9SHong Zhang     ierr = TSMPRKGetType(ts,&mprktype);CHKERRQ(ierr);
11764b84eec9SHong Zhang     ierr = PetscViewerASCIIPrintf(viewer,"  MPRK type %s\n",mprktype);CHKERRQ(ierr);
11774b84eec9SHong Zhang     ierr = PetscViewerASCIIPrintf(viewer,"  Order: %D\n",tab->order);CHKERRQ(ierr);
117819c2959aSHong Zhang 
11794b84eec9SHong Zhang     ierr = PetscFormatRealArray(fbuf,sizeof(fbuf),"% 8.6f",tab->s,tab->cf);CHKERRQ(ierr);
11804b84eec9SHong Zhang     ierr = PetscViewerASCIIPrintf(viewer,"  Abscissa cf = %s\n",fbuf);CHKERRQ(ierr);
118119c2959aSHong Zhang     ierr = PetscViewerASCIIPrintf(viewer,"  Af = \n");CHKERRQ(ierr);
118219c2959aSHong Zhang     for (i=0; i<tab->s; i++) {
118319c2959aSHong Zhang       ierr = PetscFormatRealArray(fbuf,sizeof(fbuf),"% 8.6f",tab->s,&tab->Af[i*tab->s]);CHKERRQ(ierr);
118419c2959aSHong Zhang       ierr = PetscViewerASCIIPrintf(viewer,"    %s\n",fbuf);CHKERRQ(ierr);
118519c2959aSHong Zhang     }
118619c2959aSHong Zhang     ierr = PetscFormatRealArray(fbuf,sizeof(fbuf),"% 8.6f",tab->s,tab->bf);CHKERRQ(ierr);
118719c2959aSHong Zhang     ierr = PetscViewerASCIIPrintf(viewer,"  bf = %s\n",fbuf);CHKERRQ(ierr);
118819c2959aSHong Zhang 
118919c2959aSHong Zhang     ierr = PetscFormatRealArray(sbuf,sizeof(sbuf),"% 8.6f",tab->s,tab->csb);CHKERRQ(ierr);
119019c2959aSHong Zhang     ierr = PetscViewerASCIIPrintf(viewer,"  Abscissa csb = %s\n",sbuf);CHKERRQ(ierr);
119119c2959aSHong Zhang     ierr = PetscViewerASCIIPrintf(viewer,"  Asb = \n");CHKERRQ(ierr);
119219c2959aSHong Zhang     for (i=0; i<tab->s; i++) {
119319c2959aSHong Zhang       ierr = PetscFormatRealArray(sbuf,sizeof(sbuf),"% 8.6f",tab->s,&tab->Asb[i*tab->s]);CHKERRQ(ierr);
119419c2959aSHong Zhang       ierr = PetscViewerASCIIPrintf(viewer,"    %s\n",sbuf);CHKERRQ(ierr);
119519c2959aSHong Zhang     }
119619c2959aSHong Zhang     ierr = PetscFormatRealArray(sbuf,sizeof(sbuf),"% 8.6f",tab->s,tab->bsb);CHKERRQ(ierr);
119719c2959aSHong Zhang     ierr = PetscViewerASCIIPrintf(viewer,"  bsb = %s\n",sbuf);CHKERRQ(ierr);
119819c2959aSHong Zhang 
119919c2959aSHong Zhang     if (tab->np == 3) {
120019c2959aSHong Zhang       char mbuf[512];
120119c2959aSHong Zhang       ierr = PetscFormatRealArray(mbuf,sizeof(mbuf),"% 8.6f",tab->s,tab->cmb);CHKERRQ(ierr);
120219c2959aSHong Zhang       ierr = PetscViewerASCIIPrintf(viewer,"  Abscissa cmb = %s\n",mbuf);CHKERRQ(ierr);
120319c2959aSHong Zhang       ierr = PetscViewerASCIIPrintf(viewer,"  Amb = \n");CHKERRQ(ierr);
120419c2959aSHong Zhang       for (i=0; i<tab->s; i++) {
120519c2959aSHong Zhang         ierr = PetscFormatRealArray(mbuf,sizeof(mbuf),"% 8.6f",tab->s,&tab->Amb[i*tab->s]);CHKERRQ(ierr);
120619c2959aSHong Zhang         ierr = PetscViewerASCIIPrintf(viewer,"    %s\n",mbuf);CHKERRQ(ierr);
120719c2959aSHong Zhang       }
120819c2959aSHong Zhang       ierr = PetscFormatRealArray(mbuf,sizeof(mbuf),"% 8.6f",tab->s,tab->bmb);CHKERRQ(ierr);
120919c2959aSHong Zhang       ierr = PetscViewerASCIIPrintf(viewer,"  bmb = %s\n",mbuf);CHKERRQ(ierr);
121019c2959aSHong Zhang     }
12114b84eec9SHong Zhang   }
12124b84eec9SHong Zhang   PetscFunctionReturn(0);
12134b84eec9SHong Zhang }
12144b84eec9SHong Zhang 
12154b84eec9SHong Zhang static PetscErrorCode TSLoad_MPRK(TS ts,PetscViewer viewer)
12164b84eec9SHong Zhang {
12174b84eec9SHong Zhang   PetscErrorCode ierr;
12184b84eec9SHong Zhang   TSAdapt        adapt;
12194b84eec9SHong Zhang 
12204b84eec9SHong Zhang   PetscFunctionBegin;
12214b84eec9SHong Zhang   ierr = TSGetAdapt(ts,&adapt);CHKERRQ(ierr);
12224b84eec9SHong Zhang   ierr = TSAdaptLoad(adapt,viewer);CHKERRQ(ierr);
12234b84eec9SHong Zhang   PetscFunctionReturn(0);
12244b84eec9SHong Zhang }
12254b84eec9SHong Zhang 
12264b84eec9SHong Zhang /*@C
12274b84eec9SHong Zhang   TSMPRKSetType - Set the type of MPRK scheme
12284b84eec9SHong Zhang 
12294b84eec9SHong Zhang   Logically collective
12304b84eec9SHong Zhang 
12314b84eec9SHong Zhang   Input Parameter:
12324b84eec9SHong Zhang +  ts - timestepping context
12334b84eec9SHong Zhang -  mprktype - type of MPRK-scheme
12344b84eec9SHong Zhang 
12354b84eec9SHong Zhang   Options Database:
12364b84eec9SHong Zhang .   -ts_mprk_type - <pm2,p2,p3>
12374b84eec9SHong Zhang 
12384b84eec9SHong Zhang   Level: intermediate
12394b84eec9SHong Zhang 
12404b84eec9SHong Zhang .seealso: TSMPRKGetType(), TSMPRK, TSMPRKType
12414b84eec9SHong Zhang @*/
12424b84eec9SHong Zhang PetscErrorCode TSMPRKSetType(TS ts,TSMPRKType mprktype)
12434b84eec9SHong Zhang {
12444b84eec9SHong Zhang   PetscErrorCode ierr;
12454b84eec9SHong Zhang 
12464b84eec9SHong Zhang   PetscFunctionBegin;
12474b84eec9SHong Zhang   PetscValidHeaderSpecific(ts,TS_CLASSID,1);
12484b84eec9SHong Zhang   PetscValidCharPointer(mprktype,2);
12494b84eec9SHong Zhang   ierr = PetscTryMethod(ts,"TSMPRKSetType_C",(TS,TSMPRKType),(ts,mprktype));CHKERRQ(ierr);
12504b84eec9SHong Zhang   PetscFunctionReturn(0);
12514b84eec9SHong Zhang }
12524b84eec9SHong Zhang 
12534b84eec9SHong Zhang /*@C
12544b84eec9SHong Zhang   TSMPRKGetType - Get the type of MPRK scheme
12554b84eec9SHong Zhang 
12564b84eec9SHong Zhang   Logically collective
12574b84eec9SHong Zhang 
12584b84eec9SHong Zhang   Input Parameter:
12594b84eec9SHong Zhang .  ts - timestepping context
12604b84eec9SHong Zhang 
12614b84eec9SHong Zhang   Output Parameter:
12624b84eec9SHong Zhang .  mprktype - type of MPRK-scheme
12634b84eec9SHong Zhang 
12644b84eec9SHong Zhang   Level: intermediate
12654b84eec9SHong Zhang 
12664b84eec9SHong Zhang .seealso: TSMPRKGetType()
12674b84eec9SHong Zhang @*/
12684b84eec9SHong Zhang PetscErrorCode TSMPRKGetType(TS ts,TSMPRKType *mprktype)
12694b84eec9SHong Zhang {
12704b84eec9SHong Zhang   PetscErrorCode ierr;
12714b84eec9SHong Zhang 
12724b84eec9SHong Zhang   PetscFunctionBegin;
12734b84eec9SHong Zhang   PetscValidHeaderSpecific(ts,TS_CLASSID,1);
12744b84eec9SHong Zhang   ierr = PetscUseMethod(ts,"TSMPRKGetType_C",(TS,TSMPRKType*),(ts,mprktype));CHKERRQ(ierr);
12754b84eec9SHong Zhang   PetscFunctionReturn(0);
12764b84eec9SHong Zhang }
12774b84eec9SHong Zhang 
12784b84eec9SHong Zhang /*@C
12794b84eec9SHong Zhang   TSMPRKSetMultirateType - Set the type of MPRK multirate scheme
12804b84eec9SHong Zhang 
12814b84eec9SHong Zhang   Logically collective
12824b84eec9SHong Zhang 
12834b84eec9SHong Zhang   Input Parameter:
12844b84eec9SHong Zhang +  ts - timestepping context
12854b84eec9SHong Zhang -  mprkmtype - type of the multirate configuration
12864b84eec9SHong Zhang 
12874b84eec9SHong Zhang   Options Database:
12884b84eec9SHong Zhang .   -ts_mprk_multirate_type - <nonsplit,split>
12894b84eec9SHong Zhang 
12904b84eec9SHong Zhang   Level: intermediate
12914b84eec9SHong Zhang @*/
12924b84eec9SHong Zhang PetscErrorCode TSMPRKSetMultirateType(TS ts, TSMPRKMultirateType mprkmtype)
12934b84eec9SHong Zhang {
12944b84eec9SHong Zhang   TS_MPRK        *mprk = (TS_MPRK*)ts->data;
12954b84eec9SHong Zhang   PetscErrorCode ierr;
12964b84eec9SHong Zhang 
12974b84eec9SHong Zhang   PetscFunctionBegin;
12984b84eec9SHong Zhang   PetscValidHeaderSpecific(ts,TS_CLASSID,1);
12994b84eec9SHong Zhang   switch(mprkmtype){
13004b84eec9SHong Zhang     case TSMPRKNONSPLIT:
13014b84eec9SHong Zhang       ts->ops->step         = TSStep_MPRK;
13024b84eec9SHong Zhang       ts->ops->evaluatestep = TSEvaluateStep_MPRK;
13034b84eec9SHong Zhang       break;
13044b84eec9SHong Zhang     case TSMPRKSPLIT:
13054b84eec9SHong Zhang       ts->ops->step         = TSStep_MPRKSPLIT;
13064b84eec9SHong Zhang       ts->ops->evaluatestep = TSEvaluateStep_MPRKSPLIT;
13074b84eec9SHong Zhang       ierr = PetscObjectComposeFunction((PetscObject)ts,"TSMPRKSetSplits_C",TSMPRKSetSplits);CHKERRQ(ierr);
13084b84eec9SHong Zhang       break;
13094b84eec9SHong Zhang     default :
13104b84eec9SHong Zhang       SETERRQ1(PetscObjectComm((PetscObject)ts),PETSC_ERR_ARG_UNKNOWN_TYPE,"Unknown type '%s'",mprkmtype);
13114b84eec9SHong Zhang   }
13124b84eec9SHong Zhang   mprk->mprkmtype = mprkmtype;
13134b84eec9SHong Zhang   PetscFunctionReturn(0);
13144b84eec9SHong Zhang }
13154b84eec9SHong Zhang 
13164b84eec9SHong Zhang static PetscErrorCode TSMPRKGetType_MPRK(TS ts,TSMPRKType *mprktype)
13174b84eec9SHong Zhang {
13184b84eec9SHong Zhang   TS_MPRK *mprk = (TS_MPRK*)ts->data;
13194b84eec9SHong Zhang 
13204b84eec9SHong Zhang   PetscFunctionBegin;
13214b84eec9SHong Zhang   *mprktype = mprk->tableau->name;
13224b84eec9SHong Zhang   PetscFunctionReturn(0);
13234b84eec9SHong Zhang }
13244b84eec9SHong Zhang 
13254b84eec9SHong Zhang static PetscErrorCode TSMPRKSetType_MPRK(TS ts,TSMPRKType mprktype)
13264b84eec9SHong Zhang {
13274b84eec9SHong Zhang   TS_MPRK         *mprk = (TS_MPRK*)ts->data;
13284b84eec9SHong Zhang   PetscBool       match;
13294b84eec9SHong Zhang   MPRKTableauLink link;
13304b84eec9SHong Zhang   PetscErrorCode  ierr;
13314b84eec9SHong Zhang 
13324b84eec9SHong Zhang   PetscFunctionBegin;
13334b84eec9SHong Zhang   if (mprk->tableau) {
13344b84eec9SHong Zhang     ierr = PetscStrcmp(mprk->tableau->name,mprktype,&match);CHKERRQ(ierr);
13354b84eec9SHong Zhang     if (match) PetscFunctionReturn(0);
13364b84eec9SHong Zhang   }
13374b84eec9SHong Zhang   for (link = MPRKTableauList; link; link=link->next) {
13384b84eec9SHong Zhang     ierr = PetscStrcmp(link->tab.name,mprktype,&match);CHKERRQ(ierr);
13394b84eec9SHong Zhang     if (match) {
13404b84eec9SHong Zhang       if (ts->setupcalled) {ierr = TSMPRKTableauReset(ts);CHKERRQ(ierr);}
13414b84eec9SHong Zhang       mprk->tableau = &link->tab;
13424b84eec9SHong Zhang       if (ts->setupcalled) {ierr = TSMPRKTableauSetUp(ts);CHKERRQ(ierr);}
13434b84eec9SHong Zhang       PetscFunctionReturn(0);
13444b84eec9SHong Zhang     }
13454b84eec9SHong Zhang   }
13464b84eec9SHong Zhang   SETERRQ1(PetscObjectComm((PetscObject)ts),PETSC_ERR_ARG_UNKNOWN_TYPE,"Could not find '%s'",mprktype);
13474b84eec9SHong Zhang   PetscFunctionReturn(0);
13484b84eec9SHong Zhang }
13494b84eec9SHong Zhang 
13504b84eec9SHong Zhang static PetscErrorCode TSGetStages_MPRK(TS ts,PetscInt *ns,Vec **Y)
13514b84eec9SHong Zhang {
13524b84eec9SHong Zhang   TS_MPRK *mprk = (TS_MPRK*)ts->data;
13534b84eec9SHong Zhang 
13544b84eec9SHong Zhang   PetscFunctionBegin;
13554b84eec9SHong Zhang   *ns = mprk->tableau->s;
13564b84eec9SHong Zhang   if (Y) *Y = mprk->Y;
13574b84eec9SHong Zhang   PetscFunctionReturn(0);
13584b84eec9SHong Zhang }
13594b84eec9SHong Zhang 
13604b84eec9SHong Zhang static PetscErrorCode TSDestroy_MPRK(TS ts)
13614b84eec9SHong Zhang {
13624b84eec9SHong Zhang   PetscErrorCode ierr;
13634b84eec9SHong Zhang 
13644b84eec9SHong Zhang   PetscFunctionBegin;
13654b84eec9SHong Zhang   ierr = TSReset_MPRK(ts);CHKERRQ(ierr);
13664b84eec9SHong Zhang   if (ts->dm) {
13674b84eec9SHong Zhang     ierr = DMCoarsenHookRemove(ts->dm,DMCoarsenHook_TSMPRK,DMRestrictHook_TSMPRK,ts);CHKERRQ(ierr);
13684b84eec9SHong Zhang     ierr = DMSubDomainHookRemove(ts->dm,DMSubDomainHook_TSMPRK,DMSubDomainRestrictHook_TSMPRK,ts);CHKERRQ(ierr);
13694b84eec9SHong Zhang   }
13704b84eec9SHong Zhang   ierr = PetscFree(ts->data);CHKERRQ(ierr);
13714b84eec9SHong Zhang   ierr = PetscObjectComposeFunction((PetscObject)ts,"TSMPRKGetType_C",NULL);CHKERRQ(ierr);
13724b84eec9SHong Zhang   ierr = PetscObjectComposeFunction((PetscObject)ts,"TSMPRKSetType_C",NULL);CHKERRQ(ierr);
13734b84eec9SHong Zhang   ierr = PetscObjectComposeFunction((PetscObject)ts,"TSMPRKSetMultirateType_C",NULL);CHKERRQ(ierr);
13744b84eec9SHong Zhang   PetscFunctionReturn(0);
13754b84eec9SHong Zhang }
13764b84eec9SHong Zhang 
13774b84eec9SHong Zhang /*MC
13784b84eec9SHong Zhang       TSMPRK - ODE solver using Partitioned Runge-Kutta schemes
13794b84eec9SHong Zhang 
13804b84eec9SHong Zhang   The user should provide the right hand side of the equation
13814b84eec9SHong Zhang   using TSSetRHSFunction().
13824b84eec9SHong Zhang 
13834b84eec9SHong Zhang   Notes:
13844b84eec9SHong Zhang   The default is TSMPRKPM2, it can be changed with TSRKSetType() or -ts_mprk_type
13854b84eec9SHong Zhang 
13864b84eec9SHong Zhang   Level: beginner
13874b84eec9SHong Zhang 
13884b84eec9SHong Zhang .seealso:  TSCreate(), TS, TSSetType(), TSMPRKSetType(), TSMPRKGetType(), TSMPRKType, TSMPRKRegister(), TSMPRKSetMultirateType()
13894b84eec9SHong Zhang            TSMPRKM2, TSMPRKM3, TSMPRKRFSMR3, TSMPRKRFSMR2
13904b84eec9SHong Zhang 
13914b84eec9SHong Zhang M*/
13924b84eec9SHong Zhang PETSC_EXTERN PetscErrorCode TSCreate_MPRK(TS ts)
13934b84eec9SHong Zhang {
13944b84eec9SHong Zhang   TS_MPRK        *mprk;
13954b84eec9SHong Zhang   PetscErrorCode ierr;
13964b84eec9SHong Zhang 
13974b84eec9SHong Zhang   PetscFunctionBegin;
13984b84eec9SHong Zhang   ierr = TSMPRKInitializePackage();CHKERRQ(ierr);
13994b84eec9SHong Zhang 
14004b84eec9SHong Zhang   ts->ops->reset          = TSReset_MPRK;
14014b84eec9SHong Zhang   ts->ops->destroy        = TSDestroy_MPRK;
14024b84eec9SHong Zhang   ts->ops->view           = TSView_MPRK;
14034b84eec9SHong Zhang   ts->ops->load           = TSLoad_MPRK;
14044b84eec9SHong Zhang   ts->ops->setup          = TSSetUp_MPRK;
14054b84eec9SHong Zhang   ts->ops->step           = TSStep_MPRK;
14064b84eec9SHong Zhang   ts->ops->evaluatestep   = TSEvaluateStep_MPRK;
14074b84eec9SHong Zhang   ts->ops->setfromoptions = TSSetFromOptions_MPRK;
14084b84eec9SHong Zhang   ts->ops->getstages      = TSGetStages_MPRK;
14094b84eec9SHong Zhang 
14104b84eec9SHong Zhang   ierr = PetscNewLog(ts,&mprk);CHKERRQ(ierr);
14114b84eec9SHong Zhang   ts->data = (void*)mprk;
14124b84eec9SHong Zhang 
14134b84eec9SHong Zhang   ierr = PetscObjectComposeFunction((PetscObject)ts,"TSMPRKGetType_C",TSMPRKGetType_MPRK);CHKERRQ(ierr);
14144b84eec9SHong Zhang   ierr = PetscObjectComposeFunction((PetscObject)ts,"TSMPRKSetType_C",TSMPRKSetType_MPRK);CHKERRQ(ierr);
14154b84eec9SHong Zhang   ierr = PetscObjectComposeFunction((PetscObject)ts,"TSMPRKSetMultirateType_C",TSMPRKSetMultirateType);CHKERRQ(ierr);
14164b84eec9SHong Zhang 
14174b84eec9SHong Zhang   ierr = TSMPRKSetType(ts,TSMPRKDefault);CHKERRQ(ierr);
14184b84eec9SHong Zhang   PetscFunctionReturn(0);
14194b84eec9SHong Zhang }
1420